From 68b6aba0b2a1f8005e1c181c06e40eea4af9cd2f Mon Sep 17 00:00:00 2001 From: MDN Date: Sun, 4 Jul 2021 00:36:02 +0000 Subject: [CRON] sync translated content --- files/zh-tw/_redirects.txt | 3 +- files/zh-tw/_wikihistory.json | 12 +- .../api/htmlorforeignelement/dataset/index.html | 168 +++++++++++++++++++++ .../api/htmlorforeignelement/dataset/index.html | 168 --------------------- 4 files changed, 176 insertions(+), 175 deletions(-) create mode 100644 files/zh-tw/orphaned/web/api/htmlorforeignelement/dataset/index.html delete mode 100644 files/zh-tw/web/api/htmlorforeignelement/dataset/index.html (limited to 'files/zh-tw') diff --git a/files/zh-tw/_redirects.txt b/files/zh-tw/_redirects.txt index b3d83e932c..98de0ef1ac 100644 --- a/files/zh-tw/_redirects.txt +++ b/files/zh-tw/_redirects.txt @@ -575,8 +575,9 @@ /zh-TW/docs/Web/API/ElementCSSInlineStyle/style /zh-TW/docs/orphaned/Web/API/ElementCSSInlineStyle/style /zh-TW/docs/Web/API/Event/createEvent /zh-TW/docs/Web/API/Document/createEvent /zh-TW/docs/Web/API/Geolocation/Using_geolocation /zh-TW/docs/Web/API/Geolocation_API -/zh-TW/docs/Web/API/HTMLElement/dataset /zh-TW/docs/Web/API/HTMLOrForeignElement/dataset +/zh-TW/docs/Web/API/HTMLElement/dataset /zh-TW/docs/orphaned/Web/API/HTMLOrForeignElement/dataset /zh-TW/docs/Web/API/HTMLElement/style /zh-TW/docs/orphaned/Web/API/ElementCSSInlineStyle/style +/zh-TW/docs/Web/API/HTMLOrForeignElement/dataset /zh-TW/docs/orphaned/Web/API/HTMLOrForeignElement/dataset /zh-TW/docs/Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB /zh-TW/docs/orphaned/Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB /zh-TW/docs/Web/API/Node/innerText /zh-TW/docs/Web/API/HTMLElement/innerText /zh-TW/docs/Web/API/NonDocumentTypeChildNode /zh-TW/docs/conflicting/Web/API/Element diff --git a/files/zh-tw/_wikihistory.json b/files/zh-tw/_wikihistory.json index b02f83fe11..ff6f80aa98 100644 --- a/files/zh-tw/_wikihistory.json +++ b/files/zh-tw/_wikihistory.json @@ -4014,12 +4014,6 @@ "NoobTW" ] }, - "Web/API/HTMLOrForeignElement/dataset": { - "modified": "2019-03-18T21:38:45.005Z", - "contributors": [ - "willynpi" - ] - }, "Web/API/HTMLSelectElement": { "modified": "2019-03-23T22:18:47.753Z", "contributors": [ @@ -8663,6 +8657,12 @@ "jackblackevo" ] }, + "orphaned/Web/API/HTMLOrForeignElement/dataset": { + "modified": "2019-03-18T21:38:45.005Z", + "contributors": [ + "willynpi" + ] + }, "orphaned/Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB": { "modified": "2019-03-18T20:39:41.131Z", "contributors": [ diff --git a/files/zh-tw/orphaned/web/api/htmlorforeignelement/dataset/index.html b/files/zh-tw/orphaned/web/api/htmlorforeignelement/dataset/index.html new file mode 100644 index 0000000000..6500fdc512 --- /dev/null +++ b/files/zh-tw/orphaned/web/api/htmlorforeignelement/dataset/index.html @@ -0,0 +1,168 @@ +--- +title: HTMLElement.dataset +slug: orphaned/Web/API/HTMLOrForeignElement/dataset +translation_of: Web/API/HTMLOrForeignElement/dataset +original_slug: Web/API/HTMLOrForeignElement/dataset +--- +

{{ APIRef("HTML DOM") }}

+ +

HTMLElement.dataset 允許在讀取與寫入模式時使用HTML或DOM裡，所有設置在元件上的自定義資料屬性(data-*)。他是一個DOMStringMap,每個項目表示一個不同的資料屬性。須注意的是，資料集(dataset)可以被讀取，但不能直接被修改。所有修改必須經由其眾多"屬性"才行，也就是資料屬性。另外，雖然HTML data- 屬性與它相關的 DOM dataset. 名稱不同，但是他們總是有相似之處： 

+ + + +

除了以下的資訊之外，你也可以在 Using data attributes.此篇文章找到使用HTML資料屬性的用法。

+ +

名稱變換

+ +

 

+ +

dash-style 到 camelCase: 將自訂義的資料屬性名稱變換至{{ domxref("DOMStringMap") }}各項目的key值，需根據以下規則：

+ + + +

camelCase 到 dash-style: 與上述相反，將key值轉為資料屬性名稱，需根據以下規則：

+ + + +

上面所提的限制是為了確保兩個轉換方法互為相反。

+ +

舉例來說，資料屬性名稱 data-abc-def 之對應key值為abcDef。

+ +

 

+ +

存取數值

+ + + +

語法

+ + + +

範例

+ +
<div id="user" data-id="1234567890" data-user="johndoe" data-date-of-birth>John Doe</div>
+
+let el = document.querySelector('#user');
+
+// el.id == 'user'
+// el.dataset.id === '1234567890'
+// el.dataset.user === 'johndoe'
+// el.dataset.dateOfBirth === ''
+
+el.dataset.dateOfBirth = '1960-10-03'; // 設定 DOB.
+
+// 'someDataAttr' in el.dataset === false
+el.dataset.someDataAttr = 'mydata';
+// 'someDataAttr' in el.dataset === true
+
+ +

規範

+ + + + + + + + + + + + + + + + + + + + + + + + +
規範狀態備註
{{SpecName('HTML WHATWG', "dom.html#dom-dataset", "HTMLElement.dataset")}}{{Spec2('HTML WHATWG')}}No change from latest snapshot, {{SpecName('HTML5.1')}}
{{SpecName('HTML5.1', "dom.html#dom-dataset", "HTMLElement.dataset")}}{{Spec2('HTML5.1')}}Snapshot of {{SpecName('HTML WHATWG')}}, no change from {{SpecName('HTML5 W3C')}}
{{SpecName('HTML5 W3C', "dom.html#dom-dataset", "HTMLElement.dataset")}}{{Spec2('HTML5 W3C')}}Snapshot of  {{SpecName('HTML WHATWG')}}, initial definition.
+ +

瀏覽器相容性

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + +
功能ChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
基本支援8{{CompatVersionUnknown}}{{ CompatGeckoDesktop("6.0") }}1111.106
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
功能AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
基本支援{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile(6)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +

參見

+ + diff --git a/files/zh-tw/web/api/htmlorforeignelement/dataset/index.html b/files/zh-tw/web/api/htmlorforeignelement/dataset/index.html deleted file mode 100644 index 699dec949f..0000000000 --- a/files/zh-tw/web/api/htmlorforeignelement/dataset/index.html +++ /dev/null @@ -1,168 +0,0 @@ ---- -title: HTMLElement.dataset -slug: Web/API/HTMLOrForeignElement/dataset -translation_of: Web/API/HTMLOrForeignElement/dataset -original_slug: Web/API/HTMLElement/dataset ---- -

{{ APIRef("HTML DOM") }}

- -

HTMLElement.dataset 允許在讀取與寫入模式時使用HTML或DOM裡，所有設置在元件上的自定義資料屬性(data-*)。他是一個DOMStringMap,每個項目表示一個不同的資料屬性。須注意的是，資料集(dataset)可以被讀取，但不能直接被修改。所有修改必須經由其眾多"屬性"才行，也就是資料屬性。另外，雖然HTML data- 屬性與它相關的 DOM dataset. 名稱不同，但是他們總是有相似之處： 

- - - -

除了以下的資訊之外，你也可以在 Using data attributes.此篇文章找到使用HTML資料屬性的用法。

- -

名稱變換

- -

 

- -

dash-style 到 camelCase: 將自訂義的資料屬性名稱變換至{{ domxref("DOMStringMap") }}各項目的key值，需根據以下規則：

- - - -

camelCase 到 dash-style: 與上述相反，將key值轉為資料屬性名稱，需根據以下規則：

- - - -

上面所提的限制是為了確保兩個轉換方法互為相反。

- -

舉例來說，資料屬性名稱 data-abc-def 之對應key值為abcDef。

- -

 

- -

存取數值

- - - -

語法

- - - -

範例

- -
<div id="user" data-id="1234567890" data-user="johndoe" data-date-of-birth>John Doe</div>
-
-let el = document.querySelector('#user');
-
-// el.id == 'user'
-// el.dataset.id === '1234567890'
-// el.dataset.user === 'johndoe'
-// el.dataset.dateOfBirth === ''
-
-el.dataset.dateOfBirth = '1960-10-03'; // 設定 DOB.
-
-// 'someDataAttr' in el.dataset === false
-el.dataset.someDataAttr = 'mydata';
-// 'someDataAttr' in el.dataset === true
-
- -

規範

- - - - - - - - - - - - - - - - - - - - - - - - -
規範狀態備註
{{SpecName('HTML WHATWG', "dom.html#dom-dataset", "HTMLElement.dataset")}}{{Spec2('HTML WHATWG')}}No change from latest snapshot, {{SpecName('HTML5.1')}}
{{SpecName('HTML5.1', "dom.html#dom-dataset", "HTMLElement.dataset")}}{{Spec2('HTML5.1')}}Snapshot of {{SpecName('HTML WHATWG')}}, no change from {{SpecName('HTML5 W3C')}}
{{SpecName('HTML5 W3C', "dom.html#dom-dataset", "HTMLElement.dataset")}}{{Spec2('HTML5 W3C')}}Snapshot of  {{SpecName('HTML WHATWG')}}, initial definition.
- -

瀏覽器相容性

- -

{{ CompatibilityTable() }}

- -
- - - - - - - - - - - - - - - - - - - - - -
功能ChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
基本支援8{{CompatVersionUnknown}}{{ CompatGeckoDesktop("6.0") }}1111.106
-
- -
- - - - - - - - - - - - - - - - - - - - - -
功能AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
基本支援{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile(6)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

參見

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