diff options
author | t7yang <t7yang@gmail.com> | 2022-01-10 08:38:08 +0800 |
---|---|---|
committer | Irvin <irvinfly@gmail.com> | 2022-02-16 02:35:54 +0800 |
commit | 3bb96c83e22a7a6214e79e9b903ee1c7b5657e67 (patch) | |
tree | 27e65cf2e0db2cdd34ddb4467323502e4c695ee1 /files/zh-tw/web/javascript/reference/global_objects | |
parent | ded7faccb46997b20767ef9a3e6d5f5810a52cf8 (diff) | |
download | translated-content-3bb96c83e22a7a6214e79e9b903ee1c7b5657e67.tar.gz translated-content-3bb96c83e22a7a6214e79e9b903ee1c7b5657e67.tar.bz2 translated-content-3bb96c83e22a7a6214e79e9b903ee1c7b5657e67.zip |
adjust dl/dt/dd tags for zh-TW
Diffstat (limited to 'files/zh-tw/web/javascript/reference/global_objects')
8 files changed, 37 insertions, 64 deletions
diff --git a/files/zh-tw/web/javascript/reference/global_objects/array/copywithin/index.html b/files/zh-tw/web/javascript/reference/global_objects/array/copywithin/index.html index 30520215e3..3e01759e87 100644 --- a/files/zh-tw/web/javascript/reference/global_objects/array/copywithin/index.html +++ b/files/zh-tw/web/javascript/reference/global_objects/array/copywithin/index.html @@ -30,14 +30,11 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/copyWithin <dl> <dt><code>target</code></dt> - <dd>要複製序列(sequence)至該位置的索引(起始為 0)。若為負數,<code>target</code> 將會自陣列末項開始計算。</dd> - <dd>假如 <code>target</code> 大於等於 <code>arr.length</code>,則沒有項目會被複製。如果 <code>target</code> 的索引在 <code>start</code> 之後,則拷貝的序列將會被修剪以符合 <code>arr.length</code>。</dd> + <dd>要複製序列(sequence)至該位置的索引(起始為 0)。若為負數,<code>target</code> 將會自陣列末項開始計算。假如 <code>target</code> 大於等於 <code>arr.length</code>,則沒有項目會被複製。如果 <code>target</code> 的索引在 <code>start</code> 之後,則拷貝的序列將會被修剪以符合 <code>arr.length</code>。</dd> <dt><code>start</code> {{optional_inline}}</dt> - <dd>開始拷貝的起始元素索引(起始為 0)。若為負數,<code>start</code> 將會自陣列末項開始計算。</dd> - <dd>如果省略 <code>start</code>,<code>copyWithin</code> 將會自陣列首項開始複製(預設為 0)。</dd> + <dd>開始拷貝的起始元素索引(起始為 0)。若為負數,<code>start</code> 將會自陣列末項開始計算。如果省略 <code>start</code>,<code>copyWithin</code> 將會自陣列首項開始複製(預設為 0)。</dd> <dt><code>end</code> {{optional_inline}}</dt> - <dd>結束拷貝的結尾元素索引(起始為 0)。<code>copyWithin</code> 會拷貝至此索引,但不包含 <code>end</code>。若為負數,<code>end</code> 將會自陣列末項開始計算。</dd> - <dd>如果省略 <code>end</code>,<code>copyWithin</code> 將會一路拷貝至陣列末項(預設至 <code>arr.length</code>)。</dd> + <dd>結束拷貝的結尾元素索引(起始為 0)。<code>copyWithin</code> 會拷貝至此索引,但不包含 <code>end</code>。若為負數,<code>end</code> 將會自陣列末項開始計算。如果省略 <code>end</code>,<code>copyWithin</code> 將會一路拷貝至陣列末項(預設至 <code>arr.length</code>)。</dd> </dl> <h3 id="回傳值">回傳值</h3> diff --git a/files/zh-tw/web/javascript/reference/global_objects/array/filter/index.html b/files/zh-tw/web/javascript/reference/global_objects/array/filter/index.html index 49546e6505..ccaf9ad843 100644 --- a/files/zh-tw/web/javascript/reference/global_objects/array/filter/index.html +++ b/files/zh-tw/web/javascript/reference/global_objects/array/filter/index.html @@ -36,16 +36,15 @@ let longWords = words.filter(word => word.length > 6); <dl> <dt><code>callback</code></dt> - <dd>此函式為一個斷言,用於測試陣列中的每個元素。回傳值為 <code>true</code> 時將當前的元素保留至新陣列中,若為 <code>false</code> 則不保留。可傳入三個參數:</dd> - <dd> - <dl> - <dt><code>element</code></dt> - <dd>原陣列目前所迭代處理中的元素。</dd> - <dt><code>index</code>{{optional_inline}}</dt> - <dd>原陣列目前所迭代處理中的元素之索引。</dd> - <dt><code>array</code>{{optional_inline}}</dt> - <dd>呼叫 <code>filter</code> 方法的陣列。</dd> - </dl> + <dd>此函式為一個斷言,用於測試陣列中的每個元素。回傳值為 <code>true</code> 時將當前的元素保留至新陣列中,若為 <code>false</code> 則不保留。可傳入三個參數: + <dl> + <dt><code>element</code></dt> + <dd>原陣列目前所迭代處理中的元素。</dd> + <dt><code>index</code>{{optional_inline}}</dt> + <dd>原陣列目前所迭代處理中的元素之索引。</dd> + <dt><code>array</code>{{optional_inline}}</dt> + <dd>呼叫 <code>filter</code> 方法的陣列。</dd> + </dl> </dd> <dt><code>thisArg</code> {{optional_inline}}</dt> <dd>可選的。執行 <code>callback</code> 回呼函式的 <code>this</code> 值。</dd> diff --git a/files/zh-tw/web/javascript/reference/global_objects/array/index.html b/files/zh-tw/web/javascript/reference/global_objects/array/index.html index 8417855923..f6c64c360c 100644 --- a/files/zh-tw/web/javascript/reference/global_objects/array/index.html +++ b/files/zh-tw/web/javascript/reference/global_objects/array/index.html @@ -111,8 +111,7 @@ new Array(<var>arrayLength</var>)</pre> <dl> <dt><code>element<em>N</em></code></dt> - <dd>除了只傳遞一個參數給 <code>Array</code> 構造函數,且該參數為一個數字的情況(詳見下方的 arrayLength 參數),JavaScript 陣列會以傳入的元素進行初始化。</dd> - <dd>請注意,這種特殊情況僅適用於以 <code>Array </code>構造函數建立的 JavaScript 陣列,而不適用於以括號語法建立的陣列常值(Array Literals)。</dd> + <dd>除了只傳遞一個參數給 <code>Array</code> 構造函數,且該參數為一個數字的情況(詳見下方的 arrayLength 參數),JavaScript 陣列會以傳入的元素進行初始化。請注意,這種特殊情況僅適用於以 <code>Array </code>構造函數建立的 JavaScript 陣列,而不適用於以括號語法建立的陣列常值(Array Literals)。</dd> <dt><code>arrayLength</code></dt> <dd>如果傳遞給 <code>Array</code> 構造函數的唯一參數是 0 和 2^32 - 1(含)之間的整數,將回傳一個新的 JavaScript 陣列,其長度被設定為這個數字。如果參數是任何其他數值,將拋出 {{jsxref("RangeError")}} 異常。</dd> </dl> diff --git a/files/zh-tw/web/javascript/reference/global_objects/array/map/index.html b/files/zh-tw/web/javascript/reference/global_objects/array/map/index.html index c87fa95064..96d5a81599 100644 --- a/files/zh-tw/web/javascript/reference/global_objects/array/map/index.html +++ b/files/zh-tw/web/javascript/reference/global_objects/array/map/index.html @@ -38,7 +38,6 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/map <p><code><var>callback</var></code> 函式可傳入以下三個參數:</p> <dl> - <dt></dt> <dt><code>currentValue</code></dt> <dd>原陣列目前所迭代處理中的元素。</dd> <dt><code>index</code>{{optional_inline}}</dt> diff --git a/files/zh-tw/web/javascript/reference/global_objects/array/slice/index.html b/files/zh-tw/web/javascript/reference/global_objects/array/slice/index.html index 4512eecf4e..a4daba730b 100644 --- a/files/zh-tw/web/javascript/reference/global_objects/array/slice/index.html +++ b/files/zh-tw/web/javascript/reference/global_objects/array/slice/index.html @@ -24,15 +24,9 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/slice <dl> <dt><code>begin</code> {{optional_inline}}</dt> - <dd>自哪一個索引(起始為 0)開始提取拷貝。</dd> - <dd>可使用負數索引,表示由陣列的最末項開始提取。<code>slice(-2)</code> 代表拷貝陣列中的最後兩個元素。</dd> - <dd>假如 <code>begin</code> 為 undefined,則 <code>slice</code> 會從索引 <code>0</code> 開始提取。</dd> + <dd>自哪一個索引(起始為 0)開始提取拷貝。可使用負數索引,表示由陣列的最末項開始提取。<code>slice(-2)</code> 代表拷貝陣列中的最後兩個元素。假如 <code>begin</code> 為 undefined,則 <code>slice</code> 會從索引 <code>0</code> 開始提取。</dd> <dt><code>end</code> {{optional_inline}}</dt> - <dd>至哪一個索引(起始為 0)<em>之前</em>停止提取。<code>slice</code> 提取但不包含至索引 <code>end</code>。</dd> - <dd>舉例來說,<code>slice(1,4)</code> 提取了陣列中第二個元素至第四個元素前為止(元素索引 1、2 以及 3)來拷貝。</dd> - <dd>可使用負數索引,表示由陣列的最末項開始提取。<code>slice(2,-1)</code> 代表拷貝陣列中第三個元素至倒數第二個元素。</dd> - <dd>若省略了 <code>end</code>,則 <code>slice</code> 會提取至陣列的最後一個元素(<code>arr.length</code>)。</dd> - <dd>假如 <code>end</code> 大於陣列的長度,<code>slice</code> 會提取至陣列的最後一個元素(<code>arr.length</code>)。</dd> + <dd>至哪一個索引(起始為 0)<em>之前</em>停止提取。<code>slice</code> 提取但不包含至索引 <code>end</code>。舉例來說,<code>slice(1,4)</code> 提取了陣列中第二個元素至第四個元素前為止(元素索引 1、2 以及 3)來拷貝。可使用負數索引,表示由陣列的最末項開始提取。<code>slice(2,-1)</code> 代表拷貝陣列中第三個元素至倒數第二個元素。若省略了 <code>end</code>,則 <code>slice</code> 會提取至陣列的最後一個元素(<code>arr.length</code>)。假如 <code>end</code> 大於陣列的長度,<code>slice</code> 會提取至陣列的最後一個元素(<code>arr.length</code>)。</dd> </dl> <h3 id="回傳值">回傳值</h3> diff --git a/files/zh-tw/web/javascript/reference/global_objects/array/splice/index.html b/files/zh-tw/web/javascript/reference/global_objects/array/splice/index.html index 2cb76617b8..77215cc1e1 100644 --- a/files/zh-tw/web/javascript/reference/global_objects/array/splice/index.html +++ b/files/zh-tw/web/javascript/reference/global_objects/array/splice/index.html @@ -26,9 +26,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/splice <dt><code>start</code></dt> <dd>陣列中要開始改動的元素索引(起始為 0)。若索引大於陣列長度,則實際開始的索引值會被設為陣列長度。若索引為負,則會從陣列中最後一個元素開始往前改動(起始為 -1)且若其絕對值大於陣列的長度,則會被設為 0。</dd> <dt><code>deleteCount</code> {{optional_inline}}</dt> - <dd>一個表示欲刪除的原陣列元素數量的整數。</dd> - <dd>若省略了 <code>deleteCount</code>,或假如其值大於 <code>array.length - start</code>(也就是 <code>deleteCount</code> 大於 <code>start</code> 算起的剩餘元素數量),則所有從 <code>start</code> 開始到陣列中最後一個元素都會被刪除。</dd> - <dd>若 <code>deleteCount</code> 為 0 或是負數,則不會有元素被刪除。 因此,你應該給定至少一個欲加入的新元素(見下方說明)。</dd> + <dd>一個表示欲刪除的原陣列元素數量的整數。若省略了 <code>deleteCount</code>,或假如其值大於 <code>array.length - start</code>(也就是 <code>deleteCount</code> 大於 <code>start</code> 算起的剩餘元素數量),則所有從 <code>start</code> 開始到陣列中最後一個元素都會被刪除。若 <code>deleteCount</code> 為 0 或是負數,則不會有元素被刪除。 因此,你應該給定至少一個欲加入的新元素(見下方說明)。</dd> <dt><code>item1, item2, <em>...</em></code> {{optional_inline}}</dt> <dd>從 <code>start</code> 開始,要加入到陣列的元素。 如果你沒有指定任何元素,則 <code>splice()</code> 只會依照 <code>start</code> 和 <code>deleteCount</code> 刪除陣列的元素。</dd> </dl> diff --git a/files/zh-tw/web/javascript/reference/global_objects/object/defineproperties/index.html b/files/zh-tw/web/javascript/reference/global_objects/object/defineproperties/index.html index 23eb95a642..7739ab4bdd 100644 --- a/files/zh-tw/web/javascript/reference/global_objects/object/defineproperties/index.html +++ b/files/zh-tw/web/javascript/reference/global_objects/object/defineproperties/index.html @@ -17,34 +17,27 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Object/defineProperties <dt><code>obj</code></dt> <dd>The object on which to define or modify properties.</dd> <dt><code>props</code></dt> - <dd>An object whose own enumerable properties constitute descriptors for the properties to be defined or modified. Property descriptors present in objects come in two main flavors: data descriptors and accessor descriptors (see {{jsxref("Object.defineProperty()")}} for more details). Descriptors have the following keys:</dd> - <dd> - <dl> - <dt><code>configurable</code></dt> - <dd><code>true</code> if and only if the type of this property descriptor may be changed and if the property may be deleted from the corresponding object.<br> - <strong>預設為 <code>false</code>.</strong></dd> - <dt><code>enumerable</code></dt> - <dd><code>若該屬性設為 true,則該屬性可被物件所列舉。</code><br> - <strong>預設為 <code>false</code>.</strong></dd> - </dl> - - <dl> - <dt><code>value</code></dt> - <dd>The value associated with the property. Can be any valid JavaScript value (number, object, function, etc).<br> - <strong>預設為 {{jsxref("undefined")}}.</strong></dd> - <dt><code>writable</code></dt> - <dd><code>若該屬性為 true</code>,則該屬性可透過{{jsxref("Operators/Assignment_Operators", "賦予運算子", "", 1)}}所改變<br> - <strong>預設為 <code>false</code>.</strong></dd> - </dl> - - <dl> - <dt><code>get</code></dt> - <dd>A function which serves as a getter for the property, or {{jsxref("undefined")}} if there is no getter. The function return will be used as the value of property.<br> - <strong>預設為 {{jsxref("undefined")}}.</strong></dd> - <dt><code>set</code></dt> - <dd>A function which serves as a setter for the property, or {{jsxref("undefined")}} if there is no setter. The function will receive as only argument the new value being assigned to the property.<br> - <strong>預設為 {{jsxref("undefined")}}.</strong></dd> - </dl> + <dd>An object whose own enumerable properties constitute descriptors for the properties to be defined or modified. Property descriptors present in objects come in two main flavors: data descriptors and accessor descriptors (see {{jsxref("Object.defineProperty()")}} for more details). Descriptors have the following keys: + <dl> + <dt><code>configurable</code></dt> + <dd><code>true</code> if and only if the type of this property descriptor may be changed and if the property may be deleted from the corresponding object.<br> + <strong>預設為 <code>false</code>.</strong></dd> + <dt><code>enumerable</code></dt> + <dd><code>若該屬性設為 true,則該屬性可被物件所列舉。</code><br> + <strong>預設為 <code>false</code>.</strong></dd> + <dt><code>value</code></dt> + <dd>The value associated with the property. Can be any valid JavaScript value (number, object, function, etc).<br> + <strong>預設為 {{jsxref("undefined")}}.</strong></dd> + <dt><code>writable</code></dt> + <dd><code>若該屬性為 true</code>,則該屬性可透過{{jsxref("Operators/Assignment_Operators", "賦予運算子", "", 1)}}所改變<br> + <strong>預設為 <code>false</code>.</strong></dd> + <dt><code>get</code></dt> + <dd>A function which serves as a getter for the property, or {{jsxref("undefined")}} if there is no getter. The function return will be used as the value of property.<br> + <strong>預設為 {{jsxref("undefined")}}.</strong></dd> + <dt><code>set</code></dt> + <dd>A function which serves as a setter for the property, or {{jsxref("undefined")}} if there is no setter. The function will receive as only argument the new value being assigned to the property.<br> + <strong>預設為 {{jsxref("undefined")}}.</strong></dd> + </dl> </dd> </dl> diff --git a/files/zh-tw/web/javascript/reference/global_objects/promise/index.html b/files/zh-tw/web/javascript/reference/global_objects/promise/index.html index c14a429795..ec38359021 100644 --- a/files/zh-tw/web/javascript/reference/global_objects/promise/index.html +++ b/files/zh-tw/web/javascript/reference/global_objects/promise/index.html @@ -66,14 +66,8 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Promise <dd>回傳一個 promise,當在引數 iterable 中所有 promises 都被實現時被實現,或在引數 iterable 中有一個 promise 被拒絕時立刻被拒絕。若回傳的 promise 被實現,它將以一個實現值的陣列被實現,其順序與 iterable 中的 promises 相同。若回傳的 promise 被拒絕,它將以失敗訊息被拒絕,此訊息來自第一個在 iterable 中被拒絕的 promise。這個方法在聚集許多 promises 的結果時很有效。</dd> <dt>{{jsxref("Promise.race", "Promise.race(iterable)")}}</dt> <dd>回傳一個被實現或拒絕的 promise,當 iterable 中有一個 promise 被實現或拒絕時。</dd> -</dl> - -<dl> <dt>{{jsxref("Promise.reject", "Promise.reject(reason)")}}</dt> <dd>回傳一個以失敗訊息拒絕的 <code>promise</code>。</dd> -</dl> - -<dl> <dt>{{jsxref("Promise.resolve", "Promise.resolve(value)")}}</dt> <dd>回傳一個以 value 實現的 <code>promise</code>。若該值為 thenable (i.e. 具有 <code>then</code> 方法),回傳的 promise 將跟隨(follow)之,採用她的最終狀態; 在其他情形回傳的 promise 將以 value 被實現。一般來說,當您不知道 value 是否為 promise,使用 {{jsxref("Promise.resolve", "Promise.resolve(value)")}},將回傳值以 promise 作處理。</dd> </dl> |