Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[zh-cn]: Update translation of String.CaseConvert() #15117

Merged
merged 2 commits into from
Aug 15, 2023
Merged

[zh-cn]: Update translation of String.CaseConvert() #15117

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a10b4f9
[zh-cn]: Update translation of String.CaseConvert()
JasonLamv-t Aug 15, 2023
2b0567b
Apply suggestions from code review
JasonLamv-t Aug 15, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 20 additions & 21 deletions ...zh-cn/web/javascript/reference/global_objects/string/tolocalelowercase/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
一个新的字符串，表示调用字符串根据特定区域设置的大小写映射规则转换为小写形式。
JasonLamv-t marked this conversation as resolved.
Show resolved Hide resolved

## 描述

`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
```

## 规范
Expand All @@ -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()")}}
Expand Down
31 changes: 14 additions & 17 deletions ...zh-cn/web/javascript/reference/global_objects/string/tolocaleuppercase/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
一个新的字符串，表示调用字符串根据特定区域设置的大小写映射规则转换为大写形式。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same

JasonLamv-t marked this conversation as resolved.
Show resolved Hide resolved

## 描述

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'
Expand All @@ -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'
```

Expand All @@ -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()")}}
Expand Down
16 changes: 7 additions & 9 deletions files/zh-cn/web/javascript/reference/global_objects/string/tolowercase/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,9 @@ slug: Web/JavaScript/Reference/Global_Objects/String/toLowerCase

{{JSRef}}

**`toLowerCase()`** 会将调用该方法的字符串值转为小写形式，并返回。
{{jsxref("String")}} 的 **`toLowerCase()`** 方法将该字符串转换为小写形式。

{{EmbedInteractiveExample("pages/js/string-tolowercase.html","shorter")}}

## 语法

Expand All @@ -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'
```

## 规范
Expand All @@ -41,7 +39,7 @@ console.log("ALPHABET".toLowerCase());

{{Compat}}

## 相关链接
## 参见

- {{jsxref("String.prototype.toLocaleLowerCase()")}}
- {{jsxref("String.prototype.toLocaleUpperCase()")}}
Expand Down
13 changes: 4 additions & 9 deletions files/zh-cn/web/javascript/reference/global_objects/string/touppercase/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 中的字符串是不可变的，因此此方法不会影响字符串本身的值。

## 示例

Expand Down