Utility FunctionsLocales
standardizeLocale
standardizeLocale 函数的 API 参考
概览
standardizeLocale 函数用于将 BCP-47 语言代码标准化,确保格式与大小写正确,而不需要 GT class 实例。
import { standardizeLocale } from 'generaltranslation';
// 修复常见的格式问题
console.log(standardizeLocale('en_us')); // 'en-US'
console.log(standardizeLocale('zh_cn')); // 'zh-CN'
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'
// 已标准化的 locale 会直接通过
console.log(standardizeLocale('es-ES')); // 'es-ES'参考
参数
Prop
Type
返回值
string - 标准化的 BCP-47 语言代码;无效时返回空字符串
示例
处理用户输入
import { standardizeLocale, isValidLocale } from 'generaltranslation';
function processUserInput(input: string) {
const standardized = standardizeLocale(input.trim());
const isValid = isValidLocale(standardized);
return {
original: input,
standardized,
isValid
};
}
// 测试多种输入
const inputs = ['en_us', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach(input => {
console.log(processUserInput(input));
});说明
- 将下划线转换为连字符
- 统一大小写(语言小写,区域大写)
- 对无效格式返回空字符串
- 对规范化来自各类来源的 locale 输入至关重要
- 无外部依赖——纯字符串处理
后续步骤
- 使用 GT class 方法
standardizeLocale - 使用
isValidLocale进行验证
本指南如何?