.getAttributeNS()

getAttributeNSは、指定された名前空間(namespace)と名前から、属性の文字列値を返します。 指定された名前の属性が存在しない場合、返される値はnullまはた""(空文字列)になります。 詳細は後述する注意事項を参照してください。

文法

attrVal = element.getAttributeNS(namespace, name)
引数 説明
namespace 指定された属性を探す名前空間(namespace)を指定します。
name 対象となる属性の名前を指定します。
戻り値
attrVal 指定された属性の文字列値が返ります。 その属性が存在しない場合は、nullが返ります。

DOM仕様の以前のバージョンでは、このメソッドは存在しない属性に対しては空文字列を返すとしていましたが、 一般的な実装では無いといった理由から、nullを返すように変更されました。 DOM4仕様では、存在しない属性に対してはこのメソッドはnullを返すべきと明言されています。

var div1 = document.getElementById("div1");
var a = div1.getAttributeNS("www.mozilla.org/ns/specialspace/",
                            "special-align");
alert(a); // このdivのalign値を表示します。

注意事項

getAttributeNS()は、属性だけでなく特定の名前空間の一部としてそれを指定可能である点が、 getAttribute()と異なります。 上記の例では、架空のMozilla上の"specialspace"名前空間の一部として、属性の指定を行っています。

DOM4より前の仕様では、このメソッドは存在しない属性に対してnullではなく、空文字列を返すとされていました。 ただし、ほとんどのブラウザは代わりにnullを返しており、 DOM4からは、この仕様はnullを返すように明言されています。 ただし、一部の古いブラウザでは空文字列を返します。 そのため、特定の要素上で存在しないかもしれない可能性のある属性の判定には、 getAttributeNS()では無く、 hasAttributeNS()を使用してください。

注意事項

ブラウザ互換性

デスクトップ
機能 Chrome Firefox
(Gecko)
IE Opera Safari
基本
モバイル
機能 Android Chrome for
Android
Firefox
Mobile
IE
Mobile
Opera
Mobile
Safari
Mobile
基本

仕様

関連項目

 Back to top

© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.

このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。

  • 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
  • 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
  • MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
  • "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。