SHA256
Локализовать интерфейс SHiNE на русский и английский
This commit is contained in:
@@ -0,0 +1,214 @@
|
||||
// Один источник языка для всех профилей. Браузерные настройки имеют приоритет
|
||||
// над системным языком. Списки и словари живут в соседних JSON-файлах.
|
||||
const STORAGE_KEY = 'shine-ui-language-v1';
|
||||
const FALLBACK_LANGUAGE = 'en';
|
||||
const BOOT_LANGUAGES = [
|
||||
{ code: 'ru', name: 'Русский' },
|
||||
{ code: 'en', name: 'English' },
|
||||
];
|
||||
|
||||
let availableLanguages = BOOT_LANGUAGES;
|
||||
let defaultLanguage = FALLBACK_LANGUAGE;
|
||||
let activeLanguage = FALLBACK_LANGUAGE;
|
||||
let initialized = null;
|
||||
const dictionaries = new Map();
|
||||
const loadingDictionaries = new Map();
|
||||
const subscribers = new Set();
|
||||
|
||||
function normalizeCode(value) {
|
||||
const code = String(value || '').trim().toLowerCase().replace(/_/g, '-');
|
||||
return /^[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/u.test(code) ? code : '';
|
||||
}
|
||||
|
||||
function matchLanguage(value, languages = availableLanguages) {
|
||||
const code = normalizeCode(value);
|
||||
if (!code) return '';
|
||||
const codes = new Set(languages.map((item) => item.code));
|
||||
if (codes.has(code)) return code;
|
||||
// Например: ru-RU → ru, en-US → en. Неподдерживаемый язык → далее по списку.
|
||||
const base = code.split('-')[0];
|
||||
return codes.has(base) ? base : '';
|
||||
}
|
||||
|
||||
function savedLanguage(languages) {
|
||||
try {
|
||||
return matchLanguage(globalThis.localStorage?.getItem(STORAGE_KEY), languages);
|
||||
} catch {
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
export function resolvePreferredLanguage({
|
||||
saved = '',
|
||||
browserLanguages = [],
|
||||
languages = availableLanguages,
|
||||
fallback = FALLBACK_LANGUAGE,
|
||||
} = {}) {
|
||||
const selected = matchLanguage(saved, languages);
|
||||
if (selected) return selected;
|
||||
for (const locale of browserLanguages) {
|
||||
const supported = matchLanguage(locale, languages);
|
||||
if (supported) return supported;
|
||||
}
|
||||
return matchLanguage(fallback, languages) || languages[0]?.code || FALLBACK_LANGUAGE;
|
||||
}
|
||||
|
||||
function browserLanguages() {
|
||||
try {
|
||||
const list = globalThis.navigator?.languages;
|
||||
return Array.isArray(list) && list.length
|
||||
? list
|
||||
: [globalThis.navigator?.language].filter(Boolean);
|
||||
} catch {
|
||||
return [];
|
||||
}
|
||||
}
|
||||
|
||||
function preferredLanguage(languages) {
|
||||
return resolvePreferredLanguage({
|
||||
saved: savedLanguage(languages),
|
||||
browserLanguages: browserLanguages(),
|
||||
languages,
|
||||
fallback: defaultLanguage,
|
||||
});
|
||||
}
|
||||
|
||||
activeLanguage = preferredLanguage(availableLanguages);
|
||||
|
||||
function assetUrl(path) {
|
||||
const url = new URL(path, import.meta.url);
|
||||
const hash = String(globalThis.window?.__SHINE_BUILD_HASH__ || '').trim();
|
||||
if (hash) url.searchParams.set('v', hash);
|
||||
return url;
|
||||
}
|
||||
|
||||
async function readJson(path) {
|
||||
const response = await fetch(assetUrl(path), { cache: 'default' });
|
||||
if (!response.ok) throw new Error(`i18n: ${path}: HTTP ${response.status}`);
|
||||
return response.json();
|
||||
}
|
||||
|
||||
function validateManifest(raw) {
|
||||
if (!raw || !Array.isArray(raw.languages)) return null;
|
||||
const codes = new Set();
|
||||
const languages = raw.languages.flatMap((item) => {
|
||||
const code = normalizeCode(item?.code);
|
||||
if (!code || codes.has(code) || !String(item?.name || '').trim()) return [];
|
||||
codes.add(code);
|
||||
return [{ code, name: String(item.name).trim() }];
|
||||
});
|
||||
if (!languages.length) return null;
|
||||
return {
|
||||
languages,
|
||||
fallback: matchLanguage(raw.default, languages) || matchLanguage(FALLBACK_LANGUAGE, languages) || languages[0].code,
|
||||
};
|
||||
}
|
||||
|
||||
async function loadDictionary(code) {
|
||||
if (dictionaries.has(code)) return dictionaries.get(code);
|
||||
if (loadingDictionaries.has(code)) return loadingDictionaries.get(code);
|
||||
const promise = readJson(`./locales/${code}.json`)
|
||||
.then((data) => {
|
||||
if (!data || typeof data !== 'object' || Array.isArray(data)) throw new Error('Invalid locale dictionary');
|
||||
dictionaries.set(code, data);
|
||||
return data;
|
||||
})
|
||||
.catch((error) => {
|
||||
console.warn(`[i18n] Failed to load ${code}`, error);
|
||||
// Ошибка загрузки словаря не должна блокировать приложение; при следующем
|
||||
// переключении попытка может быть повторена.
|
||||
return {};
|
||||
})
|
||||
.finally(() => loadingDictionaries.delete(code));
|
||||
loadingDictionaries.set(code, promise);
|
||||
return promise;
|
||||
}
|
||||
|
||||
function updateDocumentLanguage() {
|
||||
if (globalThis.document?.documentElement) document.documentElement.lang = activeLanguage;
|
||||
}
|
||||
|
||||
export function getLanguage() {
|
||||
return activeLanguage;
|
||||
}
|
||||
|
||||
export function getLanguages() {
|
||||
return availableLanguages.map((item) => ({ ...item }));
|
||||
}
|
||||
|
||||
export function getLanguageName(code = activeLanguage) {
|
||||
return availableLanguages.find((item) => item.code === code)?.name || code;
|
||||
}
|
||||
|
||||
export async function initI18n() {
|
||||
if (initialized) return initialized;
|
||||
initialized = (async () => {
|
||||
try {
|
||||
const manifest = validateManifest(await readJson('./languages.json'));
|
||||
if (manifest) {
|
||||
availableLanguages = manifest.languages;
|
||||
defaultLanguage = manifest.fallback;
|
||||
}
|
||||
} catch (error) {
|
||||
console.warn('[i18n] Using built-in language list', error);
|
||||
}
|
||||
activeLanguage = preferredLanguage(availableLanguages);
|
||||
updateDocumentLanguage();
|
||||
// Оба стартовых языка предзагружены: переключение ru ↔ en без ожидания сети.
|
||||
const preloaded = [defaultLanguage, activeLanguage, 'ru', 'en']
|
||||
.filter((code) => availableLanguages.some((item) => item.code === code));
|
||||
await Promise.all([...new Set(preloaded)].map(loadDictionary));
|
||||
return activeLanguage;
|
||||
})();
|
||||
return initialized;
|
||||
}
|
||||
|
||||
function lookup(dictionary, key) {
|
||||
return key.split('.').reduce((value, part) => (
|
||||
value && typeof value === 'object' && Object.prototype.hasOwnProperty.call(value, part)
|
||||
? value[part] : undefined
|
||||
), dictionary);
|
||||
}
|
||||
|
||||
// t('settings.save') или t('messages.unread', { count: 3 });
|
||||
// Если перевода нет, используется английский словарь, затем сам ключ.
|
||||
export function t(key, variables = {}) {
|
||||
const path = String(key || '');
|
||||
const translated = lookup(dictionaries.get(activeLanguage), path);
|
||||
const fallback = lookup(dictionaries.get(defaultLanguage), path);
|
||||
const russian = lookup(dictionaries.get('ru'), path);
|
||||
const text = typeof translated === 'string' ? translated
|
||||
: (typeof fallback === 'string' ? fallback : (typeof russian === 'string' ? russian : path));
|
||||
return text.replace(/\{([a-zA-Z0-9_]+)\}/gu, (whole, name) => (
|
||||
Object.prototype.hasOwnProperty.call(variables, name) ? String(variables[name]) : whole
|
||||
));
|
||||
}
|
||||
|
||||
export function th(key, variables = {}) {
|
||||
return t(key, variables).replace(/[&<>"']/gu, (character) => ({
|
||||
'&': '&', '<': '<', '>': '>', '"': '"', "'": ''',
|
||||
})[character]);
|
||||
}
|
||||
|
||||
export function onLanguageChange(callback) {
|
||||
if (typeof callback !== 'function') return () => {};
|
||||
subscribers.add(callback);
|
||||
return () => subscribers.delete(callback);
|
||||
}
|
||||
|
||||
export async function setLanguage(value) {
|
||||
await initI18n();
|
||||
const code = matchLanguage(value, availableLanguages);
|
||||
if (!code) return false;
|
||||
await loadDictionary(code);
|
||||
const changed = code !== activeLanguage;
|
||||
activeLanguage = code;
|
||||
updateDocumentLanguage();
|
||||
try { globalThis.localStorage?.setItem(STORAGE_KEY, code); } catch {}
|
||||
if (changed) {
|
||||
subscribers.forEach((callback) => {
|
||||
try { callback(code); } catch (error) { console.error('[i18n] Language listener failed', error); }
|
||||
});
|
||||
}
|
||||
return true;
|
||||
}
|
||||
Reference in New Issue
Block a user