Internationalisation
Langue de l’interface
locale sélectionne le paquet de langues utilisé pour les menus, les tooltips, les dialogues et les autres interfaces traduites. locales enregistre les paquets de langues sans en sélectionner un. Chaque unité dans le Univer l'instance partage ces paramètres. LocaleType valeurs, par exemple LocaleType.EN_US.
- Tous les produits: UI:
localemodifie les menus traduits, les tooltips, les dialogues et les étiquettes de plugins. Il ne modifie pas le contenu utilisateur ni ne renomme les unités existantes. - Feuilles: formats et formules de cellules: Les nombres et les dates rendus avec la locale du format number reververver d'abord, puis l'instantané du cahier de travail
locale, et ensuite l'instancelocale.regionne remplace aucun de ceux-ci. Le comportement de la formule, commeDOLLARet les formats de devises appliqués aux résultats financiers, suit toujourslocale, et la normalisation d'entrée CJK utilise égalementlocale. - Docs: statistiques:
localedétermine la segmentation et le comptage des mots.
Changer la langue à l’exécution
Avant de changer de langue, chargez chaque paquet de langue fourni par les plugins ou préréglages installés. loadLocales() fusionne les traductions sans changer de langue; setLocale() bascule vers les traductions chargées sans télécharger quoi que ce soit. Une clé sans traduction apparaît comme la clé elle-même. L'exemple suivant charge le paquet de langue de l'interface utilisateur partagée.
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()) // enUSEnregistrer des packs de langue en mode plugin
En mode plugin, importez le paquet de langue de chaque plugin qui fournit un, fusionnez-les dans un seul objet, et passez cet objet à l'instance Univer :
import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import DesignEnUS from '@univerjs/design/locale/en-US'import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'import UIEnUS from '@univerjs/ui/locale/en-US'const univer = new Univer({ locale: LocaleType.EN_US, locales: { [LocaleType.EN_US]: mergeLocales( DesignEnUS, UIEnUS, DocsUIEnUS, ), },})Attention
Tous les plugins ne comprennent pas un paquet de langues. La documentation de chaque fonctionnalité indique si elle le fait.
Enregistrer des packs de langue en mode prédéfini
Les paquets prédéfinis incluent déjà les paquets de langue de leurs plugins, afin qu'ils puissent être importés directement à partir du preset:
import { UniverDocsCorePreset } from '@univerjs/preset-docs-core'import UniverPresetDocsCoreEnUS from '@univerjs/preset-docs-core/locales/en-US'import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'const { univerAPI } = createUniver({ locale: LocaleType.EN_US, locales: { [LocaleType.EN_US]: mergeLocales( UniverPresetDocsCoreEnUS, ), }, presets: [ UniverDocsCorePreset(), ],})Fusion des packs de langue
mergeLocales fusionne plusieurs paquets de langages plugin ou préréglés en un seul objet complet. Utilisez-le comme suit:
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
Un paquet de langage personnalisé peut également être assemblé manuellement. Construisez l'objet requis et passez-le à l'instance Univer. Pour référence, les paquets de langage prédéfinis sont généralement stockés sous <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 comprend 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 open source, et les contributions qui ajoutent ou améliorent un paquet linguistique sont les bienvenues.
Paramètres régionaux
region détermine les conventions régionales que les caractéristiques régionales suivent. Les unités de l'instance Univer partagent ce paramètre.
Les deux paramètres prennent des valeurs de 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 passez pas les codes de pays tels que US ou SG comme region. Une région n'a pas besoin de son paquet de langue lorsque l'interface utilisateur utilise un autre locale.
Lorsque region n'est pas défini explicitement, il suit locale, y compris les appels setLocale() suivants. La configuration de region à l'initialisation ou l'appel setRegion() arrête ce suivi automatique. La langue change après cela garde la région sélectionnée. Il n'y a pas d'API publique pour restaurer le suivi automatique, donc mettez à jour les deux valeurs quand elles doivent changer ensemble.
Pour conserver la langue UI tout en appliquant les 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()) // deDEDans cet exemple, l'interface utilisateur passe au formatage anglais et régional reste allemand. getCurrentLocale() et getCurrentRegion() retournent les identifiants efficaces. Pour changer les deux ensemble, appelez les deux setters avec la même valeur LocaleType.
- Feuilles : contrôles des devises:
regiondétermine l'icône de la barre d'outils de monnaie, les options de monnaie et de comptabilité et leurs prévisualisations, et le modèle que la commande de monnaie applique. - Docs: statistiques:
regionformate les nombres affichés dans la barre de dialogue et d'état des statistiques, 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 indiqué dans les commentaires, à l'aide d'une heure de 24 heures et de chiffres latins.localene contrôle pas le texte de l'interface utilisateur. Ni la configuration des changements enregistrés horodatage, etregionn'est pas un réglage de fuseau horaire. - Planches, diapositives, bases, PDFs:
localecontrôle l'interface utilisateur traduite.regions'applique aux fonctionnalités partagées qui la consomment, comme les commentaires de thread une fois intégré; 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
RTL n'est actuellement pris en charge que dans la couche UI. La couche de rendu ne supporte pas RTL.
La direction de mise en page est un réglage séparé. Réglez direction à l'initialisation, ou appelez univerAPI.setDirection('rtl') ou setDirection('ltr'). La modification de locale et region seule ne change pas la direction de la mise en page.
univerAPI.setDirection('rtl')Que pensez-vous de ce guide ?