From 3bb96c83e22a7a6214e79e9b903ee1c7b5657e67 Mon Sep 17 00:00:00 2001 From: t7yang Date: Mon, 10 Jan 2022 08:38:08 +0800 Subject: adjust dl/dt/dd tags for zh-TW --- .../global_objects/array/copywithin/index.html | 9 ++-- .../global_objects/array/filter/index.html | 19 ++++----- .../reference/global_objects/array/index.html | 3 +- .../reference/global_objects/array/map/index.html | 1 - .../global_objects/array/slice/index.html | 10 +---- .../global_objects/array/splice/index.html | 4 +- .../object/defineproperties/index.html | 49 ++++++++++------------ .../reference/global_objects/promise/index.html | 6 --- 8 files changed, 37 insertions(+), 64 deletions(-) (limited to 'files/zh-tw/web/javascript/reference/global_objects') 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
target
-
要複製序列（sequence）至該位置的索引（起始為 0）。若為負數，target 將會自陣列末項開始計算。
-
假如 target 大於等於 arr.length，則沒有項目會被複製。如果 target 的索引在 start 之後，則拷貝的序列將會被修剪以符合 arr.length。
+
要複製序列（sequence）至該位置的索引（起始為 0）。若為負數，target 將會自陣列末項開始計算。假如 target 大於等於 arr.length，則沒有項目會被複製。如果 target 的索引在 start 之後，則拷貝的序列將會被修剪以符合 arr.length。
start {{optional_inline}}
-
開始拷貝的起始元素索引（起始為 0）。若為負數，start 將會自陣列末項開始計算。
-
如果省略 start，copyWithin 將會自陣列首項開始複製（預設為 0）。
+
開始拷貝的起始元素索引（起始為 0）。若為負數，start 將會自陣列末項開始計算。如果省略 start，copyWithin 將會自陣列首項開始複製（預設為 0）。
end {{optional_inline}}
-
結束拷貝的結尾元素索引（起始為 0）。copyWithin 會拷貝至此索引，但不包含 end。若為負數，end 將會自陣列末項開始計算。
-
如果省略 end，copyWithin 將會一路拷貝至陣列末項（預設至 arr.length）。
+
結束拷貝的結尾元素索引（起始為 0）。copyWithin 會拷貝至此索引，但不包含 end。若為負數，end 將會自陣列末項開始計算。如果省略 end，copyWithin 將會一路拷貝至陣列末項（預設至 arr.length）。

回傳值

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);
callback
-
此函式為一個斷言，用於測試陣列中的每個元素。回傳值為 true 時將當前的元素保留至新陣列中，若為 false 則不保留。可傳入三個參數：
-
-
-
element
-
原陣列目前所迭代處理中的元素。
-
index{{optional_inline}}
-
原陣列目前所迭代處理中的元素之索引。
-
array{{optional_inline}}
-
呼叫 filter 方法的陣列。
-
+
此函式為一個斷言，用於測試陣列中的每個元素。回傳值為 true 時將當前的元素保留至新陣列中，若為 false 則不保留。可傳入三個參數： +
+
element
+
原陣列目前所迭代處理中的元素。
+
index{{optional_inline}}
+
原陣列目前所迭代處理中的元素之索引。
+
array{{optional_inline}}
+
呼叫 filter 方法的陣列。
+
thisArg {{optional_inline}}
可選的。執行 callback 回呼函式的 this 值。
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(arrayLength)
elementN
-
除了只傳遞一個參數給 Array 構造函數，且該參數為一個數字的情況（詳見下方的 arrayLength 參數），JavaScript 陣列會以傳入的元素進行初始化。
-
請注意，這種特殊情況僅適用於以 Array 構造函數建立的 JavaScript 陣列，而不適用於以括號語法建立的陣列常值（Array Literals）。
+
除了只傳遞一個參數給 Array 構造函數，且該參數為一個數字的情況（詳見下方的 arrayLength 參數），JavaScript 陣列會以傳入的元素進行初始化。請注意，這種特殊情況僅適用於以 Array 構造函數建立的 JavaScript 陣列，而不適用於以括號語法建立的陣列常值（Array Literals）。
arrayLength
如果傳遞給 Array 構造函數的唯一參數是 0 和 2^32 - 1（含）之間的整數，將回傳一個新的 JavaScript 陣列，其長度被設定為這個數字。如果參數是任何其他數值，將拋出 {{jsxref("RangeError")}} 異常。
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

callback 函式可傳入以下三個參數：

-
currentValue
原陣列目前所迭代處理中的元素。
index{{optional_inline}}
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
begin {{optional_inline}}
-
自哪一個索引（起始為 0）開始提取拷貝。
-
可使用負數索引，表示由陣列的最末項開始提取。slice(-2) 代表拷貝陣列中的最後兩個元素。
-
假如 begin 為 undefined，則 slice 會從索引 0 開始提取。
+
自哪一個索引（起始為 0）開始提取拷貝。可使用負數索引，表示由陣列的最末項開始提取。slice(-2) 代表拷貝陣列中的最後兩個元素。假如 begin 為 undefined，則 slice 會從索引 0 開始提取。
end {{optional_inline}}
-
至哪一個索引（起始為 0）之前停止提取。slice 提取但不包含至索引 end。
-
舉例來說，slice(1,4) 提取了陣列中第二個元素至第四個元素前為止（元素索引 1、2 以及 3）來拷貝。
-
可使用負數索引，表示由陣列的最末項開始提取。slice(2,-1) 代表拷貝陣列中第三個元素至倒數第二個元素。
-
若省略了 end，則 slice 會提取至陣列的最後一個元素（arr.length）。
-
假如 end 大於陣列的長度，slice 會提取至陣列的最後一個元素（arr.length）。
+
至哪一個索引（起始為 0）之前停止提取。slice 提取但不包含至索引 end。舉例來說，slice(1,4) 提取了陣列中第二個元素至第四個元素前為止（元素索引 1、2 以及 3）來拷貝。可使用負數索引，表示由陣列的最末項開始提取。slice(2,-1) 代表拷貝陣列中第三個元素至倒數第二個元素。若省略了 end，則 slice 會提取至陣列的最後一個元素（arr.length）。假如 end 大於陣列的長度，slice 會提取至陣列的最後一個元素（arr.length）。

回傳值

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
start
陣列中要開始改動的元素索引（起始為 0）。若索引大於陣列長度，則實際開始的索引值會被設為陣列長度。若索引為負，則會從陣列中最後一個元素開始往前改動（起始為 -1）且若其絕對值大於陣列的長度，則會被設為 0。
deleteCount {{optional_inline}}
-
一個表示欲刪除的原陣列元素數量的整數。
-
若省略了 deleteCount，或假如其值大於 array.length - start（也就是 deleteCount 大於 start 算起的剩餘元素數量），則所有從 start 開始到陣列中最後一個元素都會被刪除。
-
若 deleteCount 為 0 或是負數，則不會有元素被刪除。 因此，你應該給定至少一個欲加入的新元素（見下方說明）。
+
一個表示欲刪除的原陣列元素數量的整數。若省略了 deleteCount，或假如其值大於 array.length - start（也就是 deleteCount 大於 start 算起的剩餘元素數量），則所有從 start 開始到陣列中最後一個元素都會被刪除。若 deleteCount 為 0 或是負數，則不會有元素被刪除。 因此，你應該給定至少一個欲加入的新元素（見下方說明）。
item1, item2, ... {{optional_inline}}
從 start 開始，要加入到陣列的元素。 如果你沒有指定任何元素，則 splice() 只會依照 start 和 deleteCount 刪除陣列的元素。
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
obj
The object on which to define or modify properties.
props
-
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:
-
-
-
configurable
-
true if and only if the type of this property descriptor may be changed and if the property may be deleted from the corresponding object.
- 預設為 false.
-
enumerable
-
若該屬性設為 true，則該屬性可被物件所列舉。
- 預設為 false.
-
- -
-
value
-
The value associated with the property. Can be any valid JavaScript value (number, object, function, etc).
- 預設為 {{jsxref("undefined")}}.
-
writable
-
若該屬性為 true，則該屬性可透過{{jsxref("Operators/Assignment_Operators", "賦予運算子", "", 1)}}所改變
- 預設為 false.
-
- -
-
get
-
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.
- 預設為 {{jsxref("undefined")}}.
-
set
-
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.
- 預設為 {{jsxref("undefined")}}.
-
+
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: +
+
configurable
+
true if and only if the type of this property descriptor may be changed and if the property may be deleted from the corresponding object.
+ 預設為 false.
+
enumerable
+
若該屬性設為 true，則該屬性可被物件所列舉。
+ 預設為 false.
+
value
+
The value associated with the property. Can be any valid JavaScript value (number, object, function, etc).
+ 預設為 {{jsxref("undefined")}}.
+
writable
+
若該屬性為 true，則該屬性可透過{{jsxref("Operators/Assignment_Operators", "賦予運算子", "", 1)}}所改變
+ 預設為 false.
+
get
+
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.
+ 預設為 {{jsxref("undefined")}}.
+
set
+
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.
+ 預設為 {{jsxref("undefined")}}.
+
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
回傳一個 promise，當在引數 iterable 中所有 promises 都被實現時被實現，或在引數 iterable 中有一個 promise 被拒絕時立刻被拒絕。若回傳的 promise 被實現，它將以一個實現值的陣列被實現，其順序與 iterable 中的 promises 相同。若回傳的 promise 被拒絕，它將以失敗訊息被拒絕，此訊息來自第一個在 iterable 中被拒絕的 promise。這個方法在聚集許多 promises 的結果時很有效。
{{jsxref("Promise.race", "Promise.race(iterable)")}}
回傳一個被實現或拒絕的 promise，當 iterable 中有一個 promise 被實現或拒絕時。
- - -
{{jsxref("Promise.reject", "Promise.reject(reason)")}}
回傳一個以失敗訊息拒絕的 promise。
-
- -
{{jsxref("Promise.resolve", "Promise.resolve(value)")}}
回傳一個以 value 實現的 promise。若該值為 thenable (i.e. 具有 then 方法)，回傳的 promise 將跟隨（follow）之，採用她的最終狀態； 在其他情形回傳的 promise 將以 value 被實現。一般來說，當您不知道 value 是否為 promise，使用 {{jsxref("Promise.resolve", "Promise.resolve(value)")}}，將回傳值以 promise 作處理。
-- cgit v1.2.3-54-g00ecf