From a10b4f9edfebbe25c03a3d1505636c1f71da37ed Mon Sep 17 00:00:00 2001 From: JasonLamv-t Date: Tue, 15 Aug 2023 09:39:31 +0800 Subject: [PATCH 1/2] [zh-cn]: Update translation of String.CaseConvert() --- .../string/tolocalelowercase/index.md | 41 +++++++++---------- .../string/tolocaleuppercase/index.md | 31 +++++++------- .../string/tolowercase/index.md | 16 ++++---- .../string/touppercase/index.md | 13 ++---- 4 files changed, 45 insertions(+), 56 deletions(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/tolocalelowercase/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/tolocalelowercase/index.md index 9d13ba2c0bd27d..a995f1ff453806 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/tolocalelowercase/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/tolocalelowercase/index.md @@ -5,46 +5,45 @@ slug: Web/JavaScript/Reference/Global_Objects/String/toLocaleLowerCase {{JSRef}} -**`toLocaleLowerCase()`**方法根据任何指定区域语言环境设置的大小写映射，返回调用字符串被转换为小写的格式。 +{{jsxref("String")}} 的 **`toLocaleLowerCase()`** 方法会根据特定区域设置的大小写映射规则，将字符串转换为小写形式并返回。 + +{{EmbedInteractiveExample("pages/js/string-tolocalelowercase.html")}} ## 语法 -```plain -str.toLocaleLowerCase() -str.toLocaleLowerCase(locale) -str.toLocaleLowerCase([locale, locale, ...]) +```js-nolint +toLocaleLowerCase() +toLocaleLowerCase(locales) ``` ### 参数 -- `locale` {{optional_inline}} - - : 参数 `locale` 指明要转换成小写格式的特定语言区域。如果以一个数组 {{jsxref("Array")}} 形式给出多个 locales, 最合适的地区将被选出来应用（参见[best available locale](https://tc39.github.io/ecma402/#sec-bestavailablelocale)）。默认的 locale 是主机环境的当前区域 (locale) 设置。 +- `locales` {{optional_inline}} -### 返回值 + - : 一个带有 BCP 47 语言标签的字符串，或者是这种字符串的数组。指示要根据特定区域设置的大小写映射规则进行转换的区域设置。有关 `locales` 参数的一般形式和解释，请参阅 [`Intl` 主页上的参数描述](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl#locales_参数)。 -根据任何特定于语言环境的案例映射规则将被调用字串转换成小写格式的一个新字符串。 + 与使用 `locales` 参数的其他方法不同，`toLocaleLowerCase()` 不允许进行区域设置匹配。因此，在检查 `locales` 参数的有效性之后，`toLocaleLowerCase()` 始终使用列表中的第一个区域设置（如果列表为空，则使用默认区域设置），即使该区域设置在实现中不受支持。 -### Exceptions +### 返回值 -- A {{jsxref("RangeError")}} ("invalid language tag: xx_yy") is thrown if a `locale` argument isn't a valid language tag. -- A {{jsxref("TypeError")}} ("invalid element in locales argument") is thrown if an array element isn't of type string. +一个新的字符串，表示调用字符串根据特定区域设置的大小写映射规则转换为小写形式。 ## 描述 -`toLocaleLowerCase()` 方法返回根据任意区域语言大小写映射集而转换成小写格式的字符串。`toLocaleLowerCase()` 并不会影响字符串原本的值。在大多数情况下，该方法和调用 {{jsxref("String.prototype.toLowerCase()", "toLowerCase()")}}的结果相同，但是在某些区域环境中，比如土耳其语，它的大小写映射并不遵循在 Unicode 中的默认的大小写映射，因此会有一个不同的结果。 +`toLocaleLowerCase()` 方法返回根据特定区域设置的大小写映射规则将字符串转换为小写形式的值。`toLocaleLowerCase()` 不会影响字符串本身的值。在大多数情况下，这将产生与 {{jsxref("String.prototype.toLowerCase()", "toLowerCase()")}} 相同的结果，但对于某些区域设置（例如土耳其语），它们的大小写映射与 Unicode 的默认映射不同，可能会得到不同的结果。 ## 示例 -### 使用 `toLocaleLowerCase()` +### 使用 toLocaleLowerCase() -```plain -'ALPHABET'.toLocaleLowerCase(); // 'alphabet' +```js +"ALPHABET".toLocaleLowerCase(); // 'alphabet' -'\u0130'.toLocaleLowerCase('tr') === 'i'; // true -'\u0130'.toLocaleLowerCase('en-US') === 'i'; // false +"\u0130".toLocaleLowerCase("tr") === "i"; // true +"\u0130".toLocaleLowerCase("en-US") === "i"; // false -let locales = ['tr', 'TR', 'tr-TR', 'tr-u-co-search', 'tr-x-turkish']; -'\u0130'.toLocaleLowerCase(locales) === 'i'; // true +const locales = ["tr", "TR", "tr-TR", "tr-u-co-search", "tr-x-turkish"]; +"\u0130".toLocaleLowerCase(locales) === "i"; // true ``` ## 规范 @@ -55,7 +54,7 @@ let locales = ['tr', 'TR', 'tr-TR', 'tr-u-co-search', 'tr-x-turkish']; {{Compat}} -## 参阅 +## 参见 - {{jsxref("String.prototype.toLocaleUpperCase()")}} - {{jsxref("String.prototype.toLowerCase()")}} diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/tolocaleuppercase/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/tolocaleuppercase/index.md index df31e19f6f84f4..14570ba6dc06d2 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/tolocaleuppercase/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/tolocaleuppercase/index.md @@ -5,42 +5,39 @@ slug: Web/JavaScript/Reference/Global_Objects/String/toLocaleUpperCase {{JSRef}} -**`toLocaleUpperCase()`** 方法根据本地主机语言环境把字符串转换为大写格式，并返回转换后的字符串。 +{{jsxref("String")}} 的 **`toLocaleUpperCase()`** 方法会根据特定区域设置的大小写映射规则，将字符串转换为大写形式并返回。 {{EmbedInteractiveExample("pages/js/string-tolocaleuppercase.html")}} ## 语法 -```plain -str.toLocaleUpperCase() -str.toLocaleUpperCase(locale) -str.toLocaleUpperCase([locale, locale, ...]) +```js-nolint +toLocaleUpperCase() +toLocaleUpperCase(locales) ``` ### 参数 -- `locale` {{optional_inline}} - - : The `locale` parameter indicates the locale to be used to convert to upper case according to any locale-specific case mappings. If multiple locales are given in an {{jsxref("Array")}}, the [best available locale](https://tc39.github.io/ecma402/#sec-bestavailablelocale) is used. The default locale is the host environment's current locale. +- `locales` {{optional_inline}} -### 返回值 + - : 一个带有 BCP 47 语言标签的字符串，或者是这种字符串的数组。指示要根据特定区域设置的大小写映射规则进行转换的区域设置。有关 `locales` 参数的一般形式和解释，请参阅 [`Intl` 主页上的参数描述](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl#locales_参数)。 -A new string representing the calling string converted to upper case, according to any locale-specific case mappings. + 与使用 `locales` 参数的其他方法不同，`toLocaleUpperCase()` 不允许进行区域设置匹配。因此，在检查 `locales` 参数的有效性之后，`toLocaleUpperCase()` 始终使用列表中的第一个区域设置（如果列表为空，则使用默认区域设置），即使该区域设置在实现中不受支持。 -### Exceptions +### 返回值 -- A {{jsxref("RangeError")}} ("invalid language tag: xx_yy") is thrown if a `locale` argument isn't a valid language tag. -- A {{jsxref("TypeError")}} ("invalid element in locales argument") is thrown if an array element isn't of type string. +一个新的字符串，表示调用字符串根据特定区域设置的大小写映射规则转换为大写形式。 ## 描述 -The `toLocaleUpperCase()` method returns the value of the string converted to upper case according to any locale-specific case mappings. `toLocaleUpperCase()` does not affect the value of the string itself. In most cases, this will produce the same result as {{jsxref("String.prototype.toUpperCase()", "toUpperCase()")}}, but for some locales, such as Turkish, whose case mappings do not follow the default case mappings in Unicode, there may be a different result. +`toLocaleUpperCase()` 方法返回根据特定区域设置的大小写映射规则将字符串转换为小写形式的值。`toLocaleUpperCase()` 不会影响字符串本身的值。在大多数情况下，这将产生与 {{jsxref("String.prototype.toUpperCase()", "toUpperCase()")}} 相同的结果，但对于某些区域设置（例如土耳其语），它们的大小写映射与 Unicode 的默认映射不同，可能会得到不同的结果。 -Also notice that conversion is not necessarily a 1:1 character mapping, as some characters might result in two (or even more) characters when transformed to upper-case. Therefore the length of the result string can differ from the input length. This also implies that the conversion is not stable, so i.E. the following can return `false`: +还要注意，转换不一定是一对一的字符映射，因为某些字符在转换为小写形式时可能会产生两个（甚至更多）字符。因此，结果字符串的长度可能与输入长度不同。这也意味着转换是不稳定的，因此下面的例子可能返回 `false`： `x.toLocaleLowerCase() === x.toLocaleUpperCase().toLocaleLowerCase()` ## 示例 -### 使用 `toLocaleUpperCase()` +### 使用 toLocaleUpperCase() ```js "alphabet".toLocaleUpperCase(); // 'ALPHABET' @@ -49,7 +46,7 @@ Also notice that conversion is not necessarily a 1:1 character mapping, as some "i\u0307".toLocaleUpperCase("lt-LT"); // 'I' -let locales = ["lt", "LT", "lt-LT", "lt-u-co-phonebk", "lt-x-lietuva"]; +const locales = ["lt", "LT", "lt-LT", "lt-u-co-phonebk", "lt-x-lietuva"]; "i\u0307".toLocaleUpperCase(locales); // 'I' ``` @@ -61,7 +58,7 @@ let locales = ["lt", "LT", "lt-LT", "lt-u-co-phonebk", "lt-x-lietuva"]; {{Compat}} -## 相关链接 +## 参见 - {{jsxref("String.prototype.toLocaleLowerCase()")}} - {{jsxref("String.prototype.toLowerCase()")}} diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/tolowercase/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/tolowercase/index.md index 5df0ee779d430d..fb13e29a2f0bd0 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/tolowercase/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/tolowercase/index.md @@ -5,7 +5,9 @@ slug: Web/JavaScript/Reference/Global_Objects/String/toLowerCase {{JSRef}} -**`toLowerCase()`** 会将调用该方法的字符串值转为小写形式，并返回。 +{{jsxref("String")}} 的 **`toLowerCase()`** 方法将该字符串转换为小写形式。 + +{{EmbedInteractiveExample("pages/js/string-tolowercase.html","shorter")}} ## 语法 @@ -19,18 +21,14 @@ toLowerCase() ## 描述 -`toLowerCase` 会将调用该方法的字符串值转为小写形式，并返回。`toLowerCase` 不会影响字符串本身的值。 +`toLowerCase()` 方法返回将字符串转换为小写形式后的值。`toLowerCase()` 不会影响字符串 `str` 本身的值。 ## 示例 -### 示例：使用 `toLowerCase()` +### 使用 `toLowerCase()` ```js -console.log("中文简体 zh-CN || zh-Hans".toLowerCase()); -// 中文简体 zh-cn || zh-hans - -console.log("ALPHABET".toLowerCase()); -// "alphabet" +console.log("ALPHABET".toLowerCase()); // 'alphabet' ``` ## 规范 @@ -41,7 +39,7 @@ console.log("ALPHABET".toLowerCase()); {{Compat}} -## 相关链接 +## 参见 - {{jsxref("String.prototype.toLocaleLowerCase()")}} - {{jsxref("String.prototype.toLocaleUpperCase()")}} diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/touppercase/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/touppercase/index.md index df1c77318a2d11..c72ff212f755b3 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/touppercase/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/touppercase/index.md @@ -5,28 +5,23 @@ slug: Web/JavaScript/Reference/Global_Objects/String/toUpperCase {{JSRef}} -**`toUpperCase()`** 方法将调用该方法的字符串转为大写形式并返回（如果调用该方法的值不是字符串类型会被强制转换）。 +{{jsxref("String")}} 的 **`toUpperCase()`** 方法将该字符串转换为大写形式。 {{EmbedInteractiveExample("pages/js/string-touppercase.html","shorter")}} ## 语法 -```plain -str.toUpperCase() +```js-nolint +toUpperCase() ``` ### 返回值 一个新的字符串，表示转换为大写的调用字符串。 -### 错误处理 - -- {{jsxref("TypeError(类型错误)")}} - - : 在 {{jsxref("null")}} 或 {{jsxref("undefined")}}类型上调用，例如：`String.prototype.toUpperCase.call(undefined)`. - ## 描述 -`toUpperCase()` 返回转为大写形式的字符串。此方法不会影响原字符串本身的值，因为 JavaScript 中字符串的值是不可改变的。 +`toUpperCase()` 方法返回将字符串转换为大写形式后的值。由于 JavaScript 中的字符串是不可变的，因此此方法不会影响字符串本身的值。 ## 示例 From 2b0567bde00a7b5b71199f8b3f395d3f246aaf6f Mon Sep 17 00:00:00 2001 From: Jason Lam Date: Tue, 15 Aug 2023 14:01:07 +0800 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: A1lo --- .../reference/global_objects/string/tolocalelowercase/index.md | 2 +- .../reference/global_objects/string/tolocaleuppercase/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/tolocalelowercase/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/tolocalelowercase/index.md index a995f1ff453806..63aafd64b5ddb3 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/tolocalelowercase/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/tolocalelowercase/index.md @@ -26,7 +26,7 @@ toLocaleLowerCase(locales) ### 返回值 -一个新的字符串，表示调用字符串根据特定区域设置的大小写映射规则转换为小写形式。 +一个新的字符串，表示调用字符串根据特定区域设置的大小写映射规则转换得到的小写形式。 ## 描述 diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/tolocaleuppercase/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/tolocaleuppercase/index.md index 14570ba6dc06d2..f4076e63bf96fe 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/tolocaleuppercase/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/tolocaleuppercase/index.md @@ -26,7 +26,7 @@ toLocaleUpperCase(locales) ### 返回值 -一个新的字符串，表示调用字符串根据特定区域设置的大小写映射规则转换为大写形式。 +一个新的字符串，表示调用字符串根据特定区域设置的大小写映射规则转换得到的大写形式。 ## 描述