SYNCERのロゴ
アイキャッチ画像

HTMLAnchorElement.download - a要素のdownload属性

downloadは、HTMLAnchorElementのプロパティです。HTMLのa要素のコンテンツ属性であるdownload属性を反映します。

概要

名前
download
所属
HTMLAnchorElement
IDL
[CEReactions] attribute DOMString download;
仕様書
https://html.spec.whatwg.org/multipage/text-level-semantics.html#dom-a-download

説明

このプロパティはHTMLを反映しています。値についての説明はdownload属性の項目をご参考下さい。属性が存在しない場合、または、属性を指定しただけで値がない場合は空の文字列を返します。

チュートリアル

取得、代入、どちらもできます。

HTML

<a href="./image.png" download="mascot.png">リンク</a>

JavaScript

// HTMLAnchorElementを取得
var element = document.getElementById( "hoge" ) ;

取得

値を取得すると、要素の属性値を調べられます。

var value = element.download ;	// "mascot.png"

属性はあるけど値がない場合、属性自体が存在しない場合、どちらも空の文字列を返すため、細かい確認はできません。

<!-- どちらも空の文字列が返る -->
<a href="./image.png" download>リンク</a>
<a href="./image.png">リンク</a>

細かい確認が必要な場合はElement.getAttribute()を利用するといいでしょう。これなら前者の場合は空の文字列、後者の場合はnullを返してくれます。

var value = element.getAttribute( "download" ) ;

代入

値を代入すると、要素の属性を更新できます。

element.download = "syncer.png" ;	// <a href="./image.png" download="syncer.png">リンク</a>

デモ

HTMLAnchorElement.downloadを取得するデモです。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<html>
<body>
<a href="./image.png" id="hoge" download="mascot.png">リンク</a>
<hr>

<script>
var element = document.getElementById( "hoge" ) ;

console.log( element.download ) ;
document.body.appendChild( new Text( element.download ) ) ;
</script>
</body>
</html>

サポート状況

ChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
20+ 10+× 15+× 4.4+
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年2月27日 (月)
コンテンツを公開しました。