From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/attr/index.html | 211 ++++++++++++++++++++++++++ files/ja/web/api/attr/localname/index.html | 135 ++++++++++++++++ files/ja/web/api/attr/namespaceuri/index.html | 126 +++++++++++++++ files/ja/web/api/attr/prefix/index.html | 72 +++++++++ 4 files changed, 544 insertions(+) create mode 100644 files/ja/web/api/attr/index.html create mode 100644 files/ja/web/api/attr/localname/index.html create mode 100644 files/ja/web/api/attr/namespaceuri/index.html create mode 100644 files/ja/web/api/attr/prefix/index.html (limited to 'files/ja/web/api/attr') diff --git a/files/ja/web/api/attr/index.html b/files/ja/web/api/attr/index.html new file mode 100644 index 0000000000..52582355e8 --- /dev/null +++ b/files/ja/web/api/attr/index.html @@ -0,0 +1,211 @@ +--- +title: Attr +slug: Web/API/Attr +tags: + - API + - DOM +translation_of: Web/API/Attr +--- +
{{APIRef("DOM")}}
+ +

この型は、DOM 要素の属性をオブジェクトとして提供します。ほとんどの DOM メソッドは、この属性を文字列として直接取得するでしょう (例: {{domxref("Element.getAttribute()")}})。しかし、特定の関数 (例: {{domxref("Element.getAttributeNode()")}}) やイテレーションを表すものには Attr 型を付与します。

+ +

{{InheritanceDiagram}}

+ +
警告: DOM Core 1、2、および 3 仕様において、Attr は {{domxref("Node")}} から継承されますが、DOM4 仕様では異なります。Attr の実装を仕様に昇華する目的で、これを {{domxref("Node")}} から継承されないものに変更する作業が進められています。そのため、Attr オブジェクト上の {{domxref("Node")}} プロパティやメソッドを使用すべきではありません。
+Gecko 7.0 {{geckoRelease("7.0")}} 以降、これが削除されるという警告メッセージがコンソールに出力されています。これに従って、コードを変更してください。非推奨のプロパティとメソッド の完全なリストも参照してください。
+ +

プロパティ

+ +
+
{{domxref("Attr.name", "name")}} {{readOnlyInline}}
+
属性の名前です。
+
{{domxref("Attr.namespaceURI", "namespaceURI")}} {{readOnlyInline}}
+
属性の名前空間 URI を表す {{domxref("DOMString")}} 文字列です。名前空間がない場合、null になります。
+
{{domxref("Attr.localName", "localname")}} {{readOnlyInline}}
+
属性の限定名のローカル部分を表す {{domxref("DOMString")}} 文字列です。
+
{{domxref("Attr.prefix", "prefix")}} {{readOnlyInline}}
+
属性の名前空間の接頭辞を表す {{domxref("DOMString")}} 文字列です。接頭辞が指定されていない場合、null になります。
+
{{domxref("Attr.ownerElement", "ownerElement")}} {{readOnlyInline}}
+
+

属性を持った要素です。

+ +
+

注意: DOM レベル 4 からこのプロパティは削除されました。 {{domxref("Element")}} から Attr オブジェクトを取得でき、関連した要素を知っているという前提からでした。
+ {{domxref("Document.evaluate")}} により返される Attr オブジェクトのように前提が真とはならない事例があるので、 DOM Living Standard は、プロパティを再び導入しました。

+ +

Gecko は、Gecko 7.0 {{geckoRelease("7.0")}} から非推奨注意を出力します。非推奨注意は、Gecko 49.0 {{geckoRelease("49.0")}} で再び削除されました。

+
+
+
{{domxref("Attr.specified", "specified")}} {{readOnlyInline}}
+
このプロパティは常に true を返します。かつては、ソースコードやスクリプトで明示的に指定された場合に true を返し、ドキュメントの DTD で定義されたデフォルト値である場合に false を返しました。
+
{{domxref("Attr.value", "value")}}
+
属性の値です。
+
+ +
+

注意: DOM レベル 3 は {{domxref("Node")}} インターフェース上にnamespaceURI, localName および prefix を定義していました。DOM4 で、それらは Attr に移動しました。

+ +

この変更は Chrome 46.0 以降、Firefox 48.0 以降で実装されています。

+
+ +

非推奨のプロパティとメソッド

+ +

以下のプロパティは非推奨とされました。利用可能な場所では、適切な代わりのプロパティが提供されます。

+ +
+
attributes
+
このプロパティは常に NULL を返します。
+
childNodes
+
このプロパティは常に NULL を返します。
+
firstChild
+
このプロパティは常に NULL を返します。
+
isId {{readOnlyInline}}
+
属性が "ID 属性" かどうかを示します。"ID 属性" は、DOM ドキュメント全体で唯一の値であることが期待されます。HTML DOM の内部で、"id" はこの ID 属性だけですが、XMLドキュメントでは他の属性を定義できます。ある属性が唯一であるかどうかは、{{Glossary("DTD")}} または他のスキーマ記述で見分けられます。
+
lastChild {{obsolete_inline(14)}}
+
このプロパティは常に NULL を返します。
+
nextSibling
+
このプロパティは常に NULL を返します。
+
nodeName
+
代わりに {{domxref("Attr.name")}} を使用してください。
+
nodeType
+
このプロパティは常に 2 (ATTRIBUTE_NODE) を返します。
+
nodeValue
+
代わりに {{domxref("Attr.value")}} を使用してください。
+
ownerDocument
+
これを最初の場所で使用すべきではありません。このプロパティが取り除かれても影響が出ないようにコードを実装してください。
+
parentNode
+
このプロパティは常に NULL を返します。
+
previousSibling
+
このプロパティは常に NULL を返します。
+
schemaTypeInfo {{obsolete_inline}} {{readOnlyInline}}
+
この属性に関連付けられた型情報です。ドキュメントが読み込まれた後または {{domxref("Document.normalizeDocument")}} が呼び出された後、この属性含まれた型情報が正しいことが保証されています。ノードが移動された場合、このプロパティは信頼できなくなるでしょう。
+
specified
+
このプロパティは常に true を返します。
+
textContent
+
代わりに {{domxref("Attr.value")}} を使用してください。
+
+ +

以下のメソッドは非推奨です:

+ +
+
appendChild()
+
代わりに {{domxref("Attr.value")}} の値を変更してください。
+
cloneNode()
+
これを最初の場所で使用すべきではありません。このプロパティが取り除かれても影響が出ないようにコードを実装してください。
+
createAttribute()
+
代わりに {{domxref("Element.setAttribute()")}} を使用してください。
+
createAttributeNS()
+
代わりに {{domxref("Element.setAttributeNS()")}} を使用してください。
+
getAttributeNode()
+
代わりに {{domxref("Element.getAttribute()")}} を使用してください。
+
getAttributeNodeNS()
+
代わりに {{domxref("Element.getAttributeNS()")}} を使用してください。
+
hasAttributes() {{obsolete_inline("21.0")}}
+
このメソッドは常に false を返します。
+
hasChildNodes()
+
このメソッドは常に false を返します。
+
insertBefore()
+
代わりに {{domxref("Attr.value")}} の値を変更してください。
+
isSupported()
+
これを最初の場所で使用すべきではありません。このプロパティが取り除かれても影響が出ないようにコードを実装してください。
+
isEqualNode()
+
これを最初の場所で使用すべきではありません。このプロパティが取り除かれても影響が出ないようにコードを実装してください。
+
normalize()
+
これを最初の場所で使用すべきではありません。このプロパティが取り除かれても影響が出ないようにコードを実装してください。
+
removeAttributeNode()
+
代わりに {{domxref("Element.removeAttribute()")}} を使用してください。
+
removeChild()
+
代わりに {{domxref("Attr.value")}} の値を変更してください。
+
replaceChild()
+
代わりに {{domxref("Attr.value")}} の値を変更してください。
+
setAttributeNode()
+
代わりに {{domxref("Element.setAttribute()")}} を使用してください。
+
setAttributeNodeNS()
+
代わりに {{domxref("Element.setAttributeNS()")}} を使用してください。
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
仕様書状況コメント
{{SpecName("DOM WHATWG", "#interface-attr", "Attr")}}{{Spec2("DOM WHATWG")}}ownerElement プロパティを追加。
{{SpecName("DOM4", "#interface-attr", "Attr")}}{{Spec2("DOM4")}}{{domxref("Node")}} から namespaceURI、prefix、localName をこの API へ移動し、ownerElement、schemaTypeInfo、isId を削除。
{{SpecName("DOM3 Core", "core.html#ID-637646024", "Attr")}}{{Spec2("DOM3 Core")}}初版
+ +

ブラウザの実装状況

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
機能ChromeFirefox (Gecko)Internet ExplorerOperaSafari
基本サポート{{CompatVersionUnknown}}[1]{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
機能AndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
基本サポート{{CompatVersionUnknown}}{{CompatVersionUnknown}} [1]{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}[1]
+
+ +

[1] Chrome 45 現在、このプロパティは Node を継承しません。

diff --git a/files/ja/web/api/attr/localname/index.html b/files/ja/web/api/attr/localname/index.html new file mode 100644 index 0000000000..9eed9d4be4 --- /dev/null +++ b/files/ja/web/api/attr/localname/index.html @@ -0,0 +1,135 @@ +--- +title: Attr.localName +slug: Web/API/Attr/localName +tags: + - API + - DOM + - NeedsBrowserCompatibility + - NeedsMobileBrowserCompatibility + - Property + - Reference +translation_of: Web/API/Attr/localName +--- +
{{APIRef("DOM")}}
+ +

Attr.localName読み取り専用プロパティは、要素の修飾名のローカル部分を返します。

+ +
+

以前のDOM仕様では、このAPIは{{domxref("Node")}}インターフェース内で定義されていました。

+
+ +

構文

+ +
name = attribute.localName
+
+ +

戻り値

+ +

属性の修飾名のローカル部分を表す{{domxref("DOMString")}}。

+ +

例

+ +

次の例は、警告ダイアログの"id"を示しています。

+ +

HTML Content

+ +
<button id="example">Click me</button>
+ +

JavaScript Content

+ +
const element = document.querySelector("#example");
+element.addEventListener("click", function() {
+  const attribute = element.attributes[0];
+  alert(attribute.localName);
+});
+
+ +

{{ EmbedLiveSample('例','100%',30) }}

+ +

注意

+ +

属性のローカル名は、コロンの後に続く属性の修飾名の一部です。 修飾名は、通常、特定のXML文書の名前空間の一部としてXMLで使用されます。

+ +
+

注意：{{Gecko("1.9.2")}}以前では、（XML DOMでのDOMのXHTML属性とは対照的に）HTML DOMのHTML属性のローカル名の大文字のプロパティを返します。 後のバージョンでは、HTML5に準拠して、内部DOMストレージの場合に、HTML DOMのHTML属性とXML DOMのXHTML属性の両方で小文字のプロパティが返されます。

+
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状況コメント
{{SpecName('DOM WHATWG', '#dom-attr-localname', 'Attr.localName')}}{{Spec2('DOM WHATWG')}}初版
+ +

ブラウザの実装状況

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
基本サポート46.0[1]{{CompatGeckoDesktop("48.0")}}[1]{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
基本サポート{{CompatUnknown}}{{CompatGeckoMobile("48.0")}}[1]{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

[1] このAPIは、以前は{{domxref("Node")}} APIで利用できました。

+ +

関連情報

+ + diff --git a/files/ja/web/api/attr/namespaceuri/index.html b/files/ja/web/api/attr/namespaceuri/index.html new file mode 100644 index 0000000000..c294fa3633 --- /dev/null +++ b/files/ja/web/api/attr/namespaceuri/index.html @@ -0,0 +1,126 @@ +--- +title: Attr.namespaceURI +slug: Web/API/Attr/namespaceURI +tags: + - API + - DOM + - NeedsBrowserCompatibility + - NeedsMobileBrowserCompatibility + - Property + - Reference +translation_of: Web/API/Attr/namespaceURI +--- +
{{APIRef("DOM")}}
+Attr.namespaceURI 読み取り専用プロパティは、属性の名前空間 URI を返し、要素が名前空間にない場合は null を返します。
+ +
+

DOM4 以前では、この API は {{domxref("Node")}} インターフェイス内で定義されていました。

+
+ +

構文

+ +
namespace = attribute.namespaceURI
+ +

例

+ +

このスニペットでは、{{domxref("localName")}} とその namespaceURI について属性を調べています。
+ namespaceURI がXUL名前空間を返し、localName が "browser" を返した場合、ノードは XUL <browser/> と解釈されます。

+ +
if (attribute.localName == "value" &&
+    attribute.namespaceURI == "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul") {
+  // this is a XUL value
+}
+ +

注記

+ +

これは、スコープ内の名前空間宣言の検査に基づいた名前空間探索の結果である計算値ではありません。属性の名前空間 URI は、属性作成時に固定されます。

+ +

Firefox 3.5 以前では、HTML 文書の HTML 属性の名前空間 URI は null です。
+ それ以降のバージョンでは、HTML5 に準拠して、XHTML と同様に https://www.w3.org/1999/xhtml になります。{{gecko_minversion_inline("1.9.2")}}

+ +

DOM Level 2 メソッドの {{domxref("Element.setAttributeNS")}} を使用して、指定された namespaceURI で属性を作成できます。

+ +

XML の名前空間仕様では、属性は名前空間がアタッチされている要素からその名前空間を継承しません。
+ 属性に明示的に名前空間が与えられていない場合、名前空間はありません。

+ +

DOM は、名前空間の検証自体を処理したり、実行したりしません。必要な検証を行うのは DOM アプリケーションの責任です。名前空間の接頭辞は、いったん特定のノードに関連付けられると変更できません。

+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様書ステータスコメント
{{SpecName("DOM4", "#dom-element-namespaceuri", "Element.namespaceuri")}}{{Spec2("DOM4")}}初版
+ +

ブラウザー互換性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
基本サポート46.0[1]{{CompatGeckoDesktop("48.0")}}[1]{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
基本サポート{{CompatUnknown}}{{CompatGeckoMobile("48.0")}}[1]{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

[1] この API は、以前は {{domxref("Node")}} API で利用できました。

+ +

関連情報

+ + diff --git a/files/ja/web/api/attr/prefix/index.html b/files/ja/web/api/attr/prefix/index.html new file mode 100644 index 0000000000..019fd06e0a --- /dev/null +++ b/files/ja/web/api/attr/prefix/index.html @@ -0,0 +1,72 @@ +--- +title: Attr.prefix +slug: Web/API/Attr/prefix +tags: + - API + - DOM + - Property + - Reference +translation_of: Web/API/Attr/prefix +--- +
{{APIRef("DOM")}}
+ +

Attr.prefix という読み取り専用のプロパティは特定の属性の名前空間の接頭辞、もしくは接頭辞の指定がなければ null を返します。

+ +
+

DOM4 以前は この API は {{domxref("Node")}} で定義されていました。

+
+ +

構文

+ +
string = attribute.prefix
+
+ +

例

+ +

次の例はコンソールに "x" と出力します。

+ +
<div x:id="example" onclick="console.log(this.attributes[0].prefix)"/>
+
+ +

注記

+ +

これは例えば文書が XML の MIME タイプで提供されているといった名前空間を認識するパーサーを使用した場合だけ動作します。これは HTML 文書では動作しません。

+ +

仕様

+ + + + + + + + + + + + + + + + + + + + + +
仕様ステータスコメント
{{SpecName('DOM WHATWG', '#dom-attr-prefix', 'Attr: prefix')}}{{Spec2('DOM WHATWG')}}
{{SpecName("DOM4", "#dom-attr-prefix", "Attr.prefix")}}{{Spec2("DOM4")}}
+ +

ブラウザの実装状況

+ + + +

{{Compat("api.Attr.prefix")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf