Internationalisation
Langue de l’interface
locale sélectionne le paquet de langues utilisé pour les menus, les tooltips, les dialogues et d'autres textes d'interface traduits. locales enregistre des paquets de langues sans en sélectionner un. Toutes les unités de l'instance Univer partagent ce paramètre. Les valeurs proviennent de LocaleType, comme LocaleType.EN_US.
- Tous les produits : interface:
localechange les traductions des menus, infobulles, dialogues et libellés des plugins. Le contenu utilisateur et les noms des unités existantes restent inchangés. - Feuilles: formats et formules de cellules: Numéros de cellule et dates rendus en utilisant le number-format locale d'abord, puis l'instantané du cahier de travail
locale, puis l'instancelocale.regionne remplace aucun de ces paramètres.localegouverne toujours le comportement de la formule commeDOLLARet le format de la monnaie sur les résultats financiers. La normalisation des entrées CJK utilise égalementlocale. - Docs: statistiques:
localepermet la segmentation et le comptage des mots.
Changer la langue à l’exécution
Chargez les paquets de langue pour chaque plugin ou preset installé avant de changer de langue. loadLocales() fusionne les traductions sans changer de langue, et setLocale() sélectionne parmi les paquets chargés sans télécharger quoi que ce soit. Une clé de traduction manquante s'affiche comme la clé elle-même. L'exemple charge le paquet UI partagé; fusionne les paquets de langage cible pour d'autres plugins installés dans le même appel.
import { LocaleType, mergeLocales } from '@univerjs/core'import UIEnUS from '@univerjs/ui/locale/en-US'univerAPI.loadLocales(LocaleType.EN_US, mergeLocales(UIEnUS))univerAPI.setLocale(LocaleType.EN_US)console.log(univerAPI.getCurrentLocale()) // enUSFusion des packs de langue
mergeLocales fusionne plusieurs paquets de langages plugin ou préréglés en un seul objet complet. Les deux formulaires ci-dessous sont valides :
import { mergeLocales } from '@univerjs/core'// You can pass multiple language pack objects to mergeconst locales = mergeLocales( plugin1Locales, plugin2Locales, presetLocales,)// You can also pass an array of language pack objectsconst locales = mergeLocales([ plugin1Locales, plugin2Locales, presetLocales,])import { mergeLocales } from '@univerjs/presets'// You can pass multiple language pack objects to mergeconst locales = mergeLocales( plugin1Locales, plugin2Locales, presetLocales,)// You can also pass an array of language pack objectsconst locales = mergeLocales([ plugin1Locales, plugin2Locales, presetLocales,])Packs linguistiques personnalisés
Univer prend également en charge des paquets de langues personnalisés. Construisez un objet de paquet de langues au besoin et passez-le à l'instance Univer. Les paquets de langues prédéfinis sont généralement situés dans le répertoire <rootDir>/packages/<PLUGIN_NAME>/locale .
import { LocaleType, Univer } from '@univerjs/core'const univer = new Univer({ locale: LocaleType.JA_JP, locales: { [LocaleType.JA_JP]: { ui: { shortcut: { undo: '元に戻す', redo: 'やり直す', }, }, }, },})Contribuer aux traductions
Univer expédie actuellement les paquets de langages intégrés suivants:
zh-CN: chinois simplifiéen-US: anglaiszh-TW: chinois traditionnelzh-HK: chinois traditionnel (Hong Kong)ru-RU: russevi-VN: vietnamienfa-IR: persanfr-FR: françaisja-JP: japonaisko-KR: coréenes-ES: espagnolca-ES: catalansk-SK: slovaquear-SA: arabede-DE: allemandid-ID: indonésienit-IT: italienpl-PL: polonaispt-BR: portugais (Brésil)
Univer est un projet open source, et les contributions qui ajoutent ou améliorent des locaux sont les bienvenues.
Paramètres régionaux
region sélectionne les conventions régionales utilisées par les fonctions régionales. Toutes les unités de l'instance Univer partagent ce paramètre.
Les deux paramètres prennent LocaleType valeurs. Par exemple, LocaleType.EN_US a la valeur enUS, pendant en-US est le nom du fichier langue-pack et l'étiquette BCP 47. Ne pas passer les codes de pays tels que US ou SG comme region. Lorsque l'interface utilise une autre localité, la région n'a pas besoin d'un paquet linguistique correspondant.
Si region n'est jamais réglé, il suit locale, y compris les appels setLocale() ultérieurs. Réglage region pendant l'initialisation ou l'appel setRegion() termine cette suite automatique, et les modifications de langue ultérieures maintiennent la région sélectionnée. Aucune API publique ne restaure automatiquement la suite; appelez les deux setters lorsque les deux valeurs doivent changer ensemble.
Ajouter region: LocaleType.DE_DE à côté de locale dans createUniver() ou new Univer() pour conserver la langue de l'interface tout en appliquant les conventions régionales allemandes.
import { LocaleType } from '@univerjs/core'univerAPI.setRegion(LocaleType.DE_DE)univerAPI.setLocale(LocaleType.EN_US)console.log(univerAPI.getCurrentRegion()) // deDEDans cet exemple, l'interface est anglaise et le formatage régional reste allemand. getCurrentLocale() et getCurrentRegion() retournent les identifiants en vigueur. Pour changer les deux, appelez les deux setters avec la même valeur LocaleType.
- Feuilles : contrôles des devises:
regioncontrôle l'icône de la barre d'outils de monnaie, les choix de monnaie et de comptabilité et leurs prévisualisations, et le modèle appliqué par la commande de monnaie. - Docs: statistiques:
regionformate les nombres affichés dans la boîte de dialogue statistique et la barre d'état, par exemple les séparateurs de regroupement. La modification deregionne modifie pas les règles de comptage. - Commentaires de filetage, lorsque activé:
regioncontrôle le format de date et d'heure affiché, avec une heure de 24 heures et des chiffres latins.localecommande le texte de l'interface utilisateur. Ni les changements enregistrés horodatages;regionn'est pas un réglage de fuseau horaire. - Planches, diapositives, bases, PDFs:
localecontrôle l'interface utilisateur traduite.regionest disponible pour les fonctions partagées qui la consomment, comme les commentaires de thread lorsqu'ils sont intégrés; il ne reformate pas automatiquement le tableau ou le texte de diapositive, les champs de base ou le contenu PDF.
Disposition de droite à gauche
Attention
Le support RTL ne couvre actuellement que la couche UI. La couche de rendu ne supporte pas RTL.
Attention
Tous les plugins ne comprennent pas les packs de langage. La documentation pour chaque état de fonctionnalité que les plugins fournissent.
univerAPI.setDirection('rtl')Que pensez-vous de ce guide ?