GT ClassMethodsLocales
requiresTranslation
Справка по API по методу GT requiresTranslation
Обзор
Метод requiresTranslation определяет, нужен ли перевод на основе исходной и целевой локалей.
Он проверяет, требуется ли перевод исходного контента, сравнивая коды локалей и учитывая список одобренных локалей.
Справка
Параметры
Prop
Type
Описание параметров
| Параметр | Описание |
|---|---|
sourceLocale | Код исходной локали. Если не указан, используется значение sourceLocale из экземпляра |
targetLocale | Код целевой локали. Если не указан, используется значение targetLocale из экземпляра |
approvedLocales | Массив разрешённых целевых локалей. Если не указан, используется массив locales из экземпляра |
customMapping | Необязательное пользовательское сопоставление для определения локалей |
Возвращает
boolean — true, если перевод требуется; в противном случае — false
Исключения
Error— если не указана исходная локаль и у экземпляра не настроенsourceLocaleError— если не указана целевая локаль и у экземпляра не настроенtargetLocale
Примеры
const gt = new GT({
sourceLocale: 'en-US',
targetLocale: 'es-ES',
locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});
// Для разных языков требуется перевод
console.log(gt.requiresTranslation('en-US', 'es-ES')); // true
console.log(gt.requiresTranslation('en-US', 'fr-FR')); // true
// Для одного и того же языка перевод не требуется
console.log(gt.requiresTranslation('en-US', 'en-US')); // false
console.log(gt.requiresTranslation('es-ES', 'es-ES')); // false
// Для разных диалектов одного языка перевод не требуется
console.log(gt.requiresTranslation('en-US', 'en-GB')); // false
console.log(gt.requiresTranslation('es-ES', 'es-MX')); // false
// Целевая локаль отсутствует в списке поддерживаемых
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT отсутствует в списке поддерживаемых локалей)Примечания
- Учитывает языковые семейства, а не только точные совпадения
- Соблюдает утверждённые списки локалей
- Возвращает
false, если целевая локаль не входит в список утверждённых (если он задан)
Дальнейшие шаги
- Проверьте принадлежность языку с помощью
isSameLanguage - Определите оптимальную локаль с помощью
determineLocale - Проверьте валидность локалей с помощью
isValidLocale
Насколько полезно это руководство?