Intl.Locale.prototype.caseFirst

Baseline 已廣泛支援

此功能已成熟,並可在許多裝置和瀏覽器版本上使用。自 2020 年 9 月起,所有瀏覽器均已提供此功能。

Intl.Locale 例項的 caseFirst 訪問器屬性返回是否在當前區域設定的排序規則中考慮了大小寫。

描述

區域設定的排序規則用於確定字串在該區域設定中的排序方式。某些區域設定在排序過程中會使用字元的大小寫(大寫或小寫)。此附加規則可以在 Intl.Locale 物件的 caseFirst 屬性中表示。caseFirst 屬性有 3 種可能的值,在下表中概述。

描述
upper 大寫字母排在小寫字母之前。
lower 小寫字母排在大寫字母之前。
false 不考慮大小寫排序。

caseFirst 屬性的值在構造時設定,透過區域設定識別符號的 kf 鍵,或透過 Intl.Locale() 建構函式的 caseFirst 選項。如果兩者都存在,後者具有更高的優先順序;如果兩者都不存在,該屬性的值為 undefined

caseFirst 的設定訪問器為 undefined。您不能直接更改此屬性。

示例

與其他區域設定子標籤一樣,可以透過區域設定字串或建構函式的配置物件引數將 caseFirst 值新增到 Intl.Locale 物件中。

透過區域設定字串新增 caseFirst 值

Unicode 區域設定字串規範中,caseFirst 是一個“擴充套件子標籤”。這些子標籤提供有關區域設定的附加資料,並透過 -u 擴充套件鍵新增到區域設定識別符號中。要將 caseFirst 值新增到傳遞到 Intl.Locale() 建構函式的初始區域設定識別符號字串,請先新增 -u 擴充套件鍵(如果它不存在)。然後,新增 -kf 擴充套件以指示您正在為 caseFirst 新增值。最後,新增 caseFirst 值。

js
const locale = new Intl.Locale("fr-Latn-FR-u-kf-upper");
console.log(locale.caseFirst); // "upper"

透過配置物件引數新增 caseFirst 值

Intl.Locale() 建構函式有一個可選的配置物件引數,其中可以包含多種擴充套件型別,包括 caseFirst。將配置物件的 caseFirst 屬性設定為您想要的 caseFirst 值,然後將其傳遞到建構函式中。

js
const locale = new Intl.Locale("en-Latn-US", { caseFirst: "lower" });
console.log(locale.caseFirst); // "lower"

規範

規範
ECMAScript® 2026 國際化 API 規範
# sec-Intl.Locale.prototype.caseFirst

瀏覽器相容性

另見