Internationalisation
Langue de l’interface
locale sélectionne le paquet de langues utilisé pour les menus, les tooltips, les dialogues et autres textes traduits de l'interface utilisateur. locales enregistre les paquets de langues sans en sélectionner un. Le paramètre est partagé par les unités de l'instance Univer. Utilisez les valeurs LocaleType, telles que LocaleType.EN_US .
- Tous les produits: UI:
localemodifie la langue des menus, tooltips, dialogues et étiquettes de plugins. Il ne traduit pas le contenu utilisateur ou ne renomme pas les unités existantes. - Feuilles: formats et formules de cellules: Le rendu des nombres et des dates dans une cellule résout en premier lieu par la commande locale number-format, puis l'instantané du cahier de travail
locale, et enfin l'instancelocale.regionne remplace aucun d'entre eux. Le comportement de la formule commeDOLLARet les formats de devises dans les résultats financiers utilise toujourslocale; et la normalisation des entrées de CJK utilise égalementlocale. - Docs: statistiques:
localedétermine la segmentation et le comptage des mots.
Changer la langue à l’exécution
Chargez les paquets de langue de chaque plugin installé et préréglagez avant de changer de langue. loadLocales() fusionne les traductions sans changer de langue; setLocale() sélectionne une langue mais ne télécharge rien. Une clé de traduction manquante est affichée comme la clé elle-même. L'exemple ci-dessous charge le pack d'interface utilisateur partagé; les paquets de langage cible d'autres plugins installés doivent être fusionné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 combine les packs de langues de plusieurs plugins ou presets en un seul objet complet :
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. Assemblez 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 stockés dans <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 propose actuellement les packs linguistiques 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 open source, et nous accueillons les développeurs du monde entier pour ajouter ou améliorer des locaux.
Paramètres régionaux
region sélectionne les conventions régionales que suivent les fonctions régionales. Le réglage est partagé par les unités de l'instance Univer.
Les deux paramètres prennent une valeur LocaleType. Par exemple, LocaleType.EN_US est enUS, tandis que en-US est le nom de fichier de paquet de langue et l'étiquette BCP 47. Ne pas passer un code de pays comme US ou SG comme region. Une région n'a pas besoin de son propre paquet de langue lorsque l'interface utilisateur utilise une autre localité.
Sans region explicite, il suit locale, y compris les appels setLocale() ultérieurs. La configuration de region pendant l'initialisation, ou l'appel setRegion() stoppe cette suite automatique. Après cela, les changements de langue laissent la région inchangée. Aucune API publique ne restaure le comportement suivant, donc mettez à jour les deux valeurs quand elles doivent changer ensemble.
Pour conserver la langue de l'interface utilisateur en utilisant des conventions régionales allemandes, ajoutez region: LocaleType.DE_DE à côté de locale dans createUniver() ou new Univer().
import { LocaleType } from '@univerjs/core'univerAPI.setRegion(LocaleType.DE_DE)univerAPI.setLocale(LocaleType.EN_US)console.log(univerAPI.getCurrentRegion()) // deDEIci, l'interface utilisateur est en anglais tandis que le formatage régional reste allemand. getCurrentLocale() et getCurrentRegion() retournent les identifiants en vigueur. Pour changer les deux à la fois, appelez les deux setters avec la même valeur LocaleType.
- Feuilles : contrôles des devises:
regioncontrôle l'icône de la monnaie dans la barre d'outils, les choix de monnaie et de comptabilité et leurs prévisualisations, et le modèle que la commande de monnaie s'applique. - Docs: statistiques:
regionformate les nombres affichés dans la boîte de dialogue statistique et la barre d'état, y compris 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 la date et de l'heure qui commente l'affichage, avec 24 heures et des chiffres latins.localecontrôle le texte de l'interface utilisateur de commentaire. Ni les changements stockés horodatage, etregionn'est pas un réglage de fuseau horaire. - Planches, diapositives, bases, PDFs:
localecontrôle l'interface utilisateur traduite.regionest disponible pour les fonctionnalités partagées qui la consomment, comme les commentaires de thread une fois intégré, mais il ne reformate pas le tableau ou le texte de diapositive, les champs de base ou le contenu PDF.
Disposition de droite à gauche
Attention
RTL couvre actuellement la couche UI seulement. La couche de rendu ne la supporte pas encore.
Attention
Tous les plugins ne comprennent pas un paquet de langues. La documentation pour chaque fonctionnalité indique si elle le fait.
univerAPI.setDirection('rtl')Que pensez-vous de ce guide ?