Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

TranslationDomain

Успадковує: RefCounted < Object

Окрема колекція ресурсів Translation.

Опис

TranslationDomain — це самостійна колекція ресурсів Translation. Переклади можна додати або видалити з нього.

Якщо ви працюєте з основним доменом перекладу, зручніше використовувати методи обтікання на TranslationServer.

Властивості

bool	enabled	`true`
bool	pseudolocalization_accents_enabled	`true`
bool	pseudolocalization_double_vowels_enabled	`false`
bool	pseudolocalization_enabled	`false`
float	pseudolocalization_expansion_ratio	`0.0`
bool	pseudolocalization_fake_bidi_enabled	`false`
bool	pseudolocalization_override_enabled	`false`
String	pseudolocalization_prefix	`"["`
bool	pseudolocalization_skip_placeholders_enabled	`true`
String	pseudolocalization_suffix	`"]"`

Методи

void	add_translation(translation: Translation)
void	clear()
Array[Translation]	find_translations(locale: String, exact: bool) const
String	get_locale_override() const
Translation	get_translation_object(locale: String) const
Array[Translation]	get_translations() const
bool	has_translation(translation: Translation) const
bool	has_translation_for_locale(locale: String, exact: bool) const
StringName	pseudolocalize(message: StringName) const
void	remove_translation(translation: Translation)
void	set_locale_override(locale: String)
StringName	translate(message: StringName, context: StringName = &"") const
StringName	translate_plural(message: StringName, message_plural: StringName, n: int, context: StringName = &"") const

Описи властивостей

bool enabled = true 🔗

void set_enabled(value: bool)
bool is_enabled()

Якщо true, переклад увімкнено. В іншому випадку, translate() та translate_plural() повернуть вхідне повідомлення без змін незалежно від поточної локалізації.

bool pseudolocalization_accents_enabled = true 🔗

void set_pseudolocalization_accents_enabled(value: bool)
bool is_pseudolocalization_accents_enabled()

Під час псевдолокалізації замінити всі символи їх акцентованими варіантами.

Примітка: Оновлення цієї властивості не оновлює автоматично тексти в дереві сцени. Будь ласка, поширте сповіщення MainLoop.NOTIFICATION_TRANSLATION_CHANGED вручну після того, як ви закінчите змінювати параметри, пов’язані з псевдолокалізацією.

bool pseudolocalization_double_vowels_enabled = false 🔗

void set_pseudolocalization_double_vowels_enabled(value: bool)
bool is_pseudolocalization_double_vowels_enabled()

Подвійні голосні в рядках під час псевдолокалізації для імітації подовження тексту через локалізацію.

Примітка: Оновлення цієї властивості не оновлює автоматично тексти в дереві сцени. Будь ласка, поширте сповіщення MainLoop.NOTIFICATION_TRANSLATION_CHANGED вручну після того, як ви закінчите змінювати параметри, пов’язані з псевдолокалізацією.

bool pseudolocalization_enabled = false 🔗

void set_pseudolocalization_enabled(value: bool)
bool is_pseudolocalization_enabled()

Якщо true, вмикає псевдолокалізацію для проекту. Це можна використовувати для виявлення неперекладних рядків або проблем з макетом, які можуть виникнути після локалізації проекту на мови, які мають довші рядки, ніж вихідна мова.

Примітка: Оновлення цієї властивості не оновлює автоматично тексти в дереві сцени. Будь ласка, поширте сповіщення MainLoop.NOTIFICATION_TRANSLATION_CHANGED вручну після того, як ви закінчите змінювати параметри, пов’язані з псевдолокалізацією.

float pseudolocalization_expansion_ratio = 0.0 🔗

void set_pseudolocalization_expansion_ratio(value: float)
float get_pseudolocalization_expansion_ratio()

Коефіцієнт розширення для використання під час псевдолокалізації. Значення 0,3 є достатнім для більшості практичних цілей і збільшить довжину кожного рядка на 30%.

Примітка: Оновлення цієї властивості не оновлює автоматично тексти в дереві сцени. Будь ласка, поширте сповіщення MainLoop.NOTIFICATION_TRANSLATION_CHANGED вручну після того, як ви закінчите змінювати параметри, пов’язані з псевдолокалізацією.

bool pseudolocalization_fake_bidi_enabled = false 🔗

void set_pseudolocalization_fake_bidi_enabled(value: bool)
bool is_pseudolocalization_fake_bidi_enabled()

Якщо true, емулювати двонаправлений текст (справа наліво), коли ввімкнено псевдолокалізацію. Це можна використовувати для виявлення проблем із макетом RTL і віддзеркаленням інтерфейсу користувача, які виникнуть, якщо проект локалізовано на такі мови RTL, як арабська чи іврит.

Примітка: Оновлення цієї властивості не оновлює автоматично тексти в дереві сцени. Будь ласка, поширте сповіщення MainLoop.NOTIFICATION_TRANSLATION_CHANGED вручну після того, як ви закінчите змінювати параметри, пов’язані з псевдолокалізацією.

bool pseudolocalization_override_enabled = false 🔗

void set_pseudolocalization_override_enabled(value: bool)
bool is_pseudolocalization_override_enabled()

Замініть усі символи в рядку на *. Корисно для пошуку нелокалізованих рядків.

Примітка: Оновлення цієї властивості не оновлює автоматично тексти в дереві сцени. Будь ласка, поширте сповіщення MainLoop.NOTIFICATION_TRANSLATION_CHANGED вручну після того, як ви закінчите змінювати параметри, пов’язані з псевдолокалізацією.

String pseudolocalization_prefix = "[" 🔗

void set_pseudolocalization_prefix(value: String)
String get_pseudolocalization_prefix()

Префікс, який буде додано до псевдолокалізованого рядка.

Примітка: Оновлення цієї властивості не оновлює автоматично тексти в дереві сцени. Будь ласка, поширте сповіщення MainLoop.NOTIFICATION_TRANSLATION_CHANGED вручну після того, як ви закінчите змінювати параметри, пов’язані з псевдолокалізацією.

bool pseudolocalization_skip_placeholders_enabled = true 🔗

void set_pseudolocalization_skip_placeholders_enabled(value: bool)
bool is_pseudolocalization_skip_placeholders_enabled()

Пропустіть заповнювачі для форматування рядків, наприклад %s або %f під час псевдолокалізації. Корисно для визначення рядків, які потребують додаткових контрольних символів для правильного відображення.

Примітка: Оновлення цієї властивості не оновлює автоматично тексти в дереві сцени. Будь ласка, поширте сповіщення MainLoop.NOTIFICATION_TRANSLATION_CHANGED вручну після того, як ви закінчите змінювати параметри, пов’язані з псевдолокалізацією.

String pseudolocalization_suffix = "]" 🔗

void set_pseudolocalization_suffix(value: String)
String get_pseudolocalization_suffix()

Суфікс, який буде додано до псевдолокалізованого рядка.

Примітка: Оновлення цієї властивості не оновлює автоматично тексти в дереві сцени. Будь ласка, поширте сповіщення MainLoop.NOTIFICATION_TRANSLATION_CHANGED вручну після того, як ви закінчите змінювати параметри, пов’язані з псевдолокалізацією.

Описи методів

void add_translation(translation: Translation) 🔗

Додає переклад.

void clear() 🔗

Видаляє всі переклади.

Array[Translation] find_translations(locale: String, exact: bool) const 🔗

Повертає екземпляри Translation, що відповідають locale (див. TranslationServer.compare_locales()). Якщо exact має значення true, будуть повернуті лише екземпляри, локаль яких точно дорівнює locale.

String get_locale_override() const 🔗

Повертає зміну локалі для домену. Повертає порожній рядок, якщо зміну локалі вимкнено.

Translation get_translation_object(locale: String) const 🔗

Застаріло: Use find_translations() instead.

Повертає екземпляр Translation, який найкраще відповідає locale. Повертає null, якщо немає збігів.

Array[Translation] get_translations() const 🔗

Повертає всі доступні екземпляри Translation, додані методом add_translation().

bool has_translation(translation: Translation) const 🔗

Повертає true, якщо цей домен перекладу містить задане translation.

bool has_translation_for_locale(locale: String, exact: bool) const 🔗

Повертає true, якщо є будь-які екземпляри Translation, що відповідають locale (див. TranslationServer.compare_locales()). Якщо exact має значення true, розглядаються лише екземпляри, локаль яких точно дорівнює locale.

StringName pseudolocalize(message: StringName) const 🔗

Повертає псевдокальизований рядок на основі message.

void remove_translation(translation: Translation) 🔗

Видаляє поданий переклад.

void set_locale_override(locale: String) 🔗

Встановлює перевизначення локалі для домену.

Якщо locale – порожній рядок, перевизначення локалі вимкнено. В іншому випадку, locale буде стандартизовано для відповідності відомим локалям (наприклад, en-US буде відповідати en_US).

Примітка: Виклик цього методу не оновлює тексти в дереві сцени автоматично. Будь ласка, поширте сигнал MainLoop.NOTIFICATION_TRANSLATION_CHANGED вручну.

StringName translate(message: StringName, context: StringName = &"") const 🔗

Повертає переклад поточної мови для даного повідомлення та контексту.

StringName translate_plural(message: StringName, message_plural: StringName, n: int, context: StringName = &"") const 🔗

Повертає переклад поточної мови для даного повідомлення, повідомлення у множині та контексту.

Число n — це число або кількість об’єкта множини. Він використовуватиметься, щоб керувати системою перекладу для отримання правильної форми множини для вибраної мови.