국제화
인터페이스 언어
locale는 메뉴, 도구 끝, 대화 상자 및 번역 UI의 나머지에 대한 언어 팩을 선택합니다. locales는 하나를 선택하지 않고 팩을 등록합니다. 설정은 Univer 인스턴스의 단위로 공유됩니다. LocaleType.EN_US와 같은 LocaleType 값이 필요합니다.
- 모든 제품: UI:
locale는 메뉴, 툴팁, 대화 상자 및 플러그인 라벨의 언어를 변경합니다. 그것은 사용자 콘텐츠를 번역하거나 기존 단위로 이름을 변경하지 않습니다. - 장: 세포 체재 및 공식: 세포에 있는 수 그리고 날짜는 낙하 사슬을 따릅니다: 수 체재 locale override, 그 후에 workbook 스냅샷
locale, 그 후에locale.region는 그들 중 어떤 대체하지 않습니다.DOLLAR와 같은 공식적인 행동은 아직도 재정적인 결과의locale를, CJK 입력 정상화 같이 따릅니다. - Docs: 통계:
locale는 텍스트가 세분화되고 계산되는 방법을 결정합니다.
실행 중 언어 변경
모든 설치 플러그인 또는 언어를 전환하기 전에 사전 설정에 대한 언어 팩을로드하십시오. loadLocales()는 전환없이 번역을 병합합니다. setLocale()은 이미로드되고 다운로드하지 않습니다. 누락 된 번역 키는 키 자체로 표시됩니다. 공유 UI 팩을로드하는 예; 동일한 통화로 다른 설치 플러그인에 대한 대상 언어 팩을 추가하십시오.
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()) // enUS언어 팩 병합
mergeLocales는 하나의 완전한 언어 팩 객체로 여러 플러그인 또는 미리 설정의 언어 팩을 결합합니다.
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,])사용자 지정 언어 팩
사용자 지정 언어 팩을 작성할 수 있습니다: 필요한 개체를 조립하고 Univer 인스턴스에 전달할 수 있습니다. 사전 설정에 의해 제공되는 언어 팩은 일반적으로 <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: 'やり直す', }, }, }, },})번역 기여하기
Univer는 다음과 같은 내장 언어 팩을 제공합니다:
zh-CN: 중국어 간체en-US: 영어zh-TW: 중국어 번체zh-HK: 중국어 번체(홍콩)ru-RU: 러시아어vi-VN: 베트남어fa-IR: 페르시아어fr-FR: 프랑스어ja-JP: 일본어ko-KR: 한국어es-ES: 스페인어ca-ES: 카탈루냐어sk-SK: 슬로바키아어ar-SA: 아랍어de-DE: 독일어id-ID: 인도네시아어it-IT: 이탈리아어pl-PL: 폴란드어pt-BR: 포르투갈어(브라질)
Univer는 모든 내장 언어 팩입니다. 전세계의 오픈 소스 프로젝트이며, 개발자들은 이러한 현지인들을 추가하거나 개선할 수 있습니다.
지역 설정
region는 지역 기능에 따라 지역 컨벤션을 선택합니다. 설정은 Univer 인스턴스의 단위로 공유됩니다.
둘 다 조정은 LocaleType 가치를 가지고 갑니다. 예를 들면, LocaleType.EN_US는 enUS이고, en-US는 언어 팩 파일 이름과 BCP 47 꼬리표입니다. region로 US SG와 같은 국가 코드를 통과하지 마십시오. UI가 다른 Locale를 사용하는 경우에, 지역은 그것의 언어 팩을 적재하기 위하여 요구하지 않습니다.
region가 설정되지 않은 경우 나중에 setLocale() 통화를 포함한 locale를 따르십시오. 초기화에서 region을 설정하거나 setRegion()로 호출하면 다음 자동을 중지합니다. 그 후, 언어를 변경하면 선택한 지역을 유지합니다. 공개 API가 자동을 복구하지 않습니다. 두 가지가 변경되면 명시적으로 설정하십시오.
createUniver() 또는 new Univer() 중 locale 옆에 region: LocaleType.DE_DE를 추가하여 독일 지역 컨벤션이 적용된 동안 UI 언어를 유지하십시오.
import { LocaleType } from '@univerjs/core'univerAPI.setRegion(LocaleType.DE_DE)univerAPI.setLocale(LocaleType.EN_US)console.log(univerAPI.getCurrentRegion()) // deDE여기에서 UI는 영어로 전환합니다. 지역 형식은 독일어를 남깁니다. getCurrentLocale() 및 getCurrentRegion()는 실제로 영향을 미칩니다. 둘 다 바꾸기 위해 동일한 LocaleType 값을 가진 setters를 두 번 호출하십시오.
- 시트: 통화 통제:
region는 도구 모음, 통화 및 회계 선택 및 미리보기의 통화 아이콘을 결정하고 통화 명령이 적용됩니다. 기존 셀 형식을 다시 작성하지 않거나 모기 값을 변환하지 않습니다. - Docs: 통계:
region는 통계 대화 상자 및 상태 표시 줄에 표시된 수를 그룹화 분리기를 포함하여 배열합니다.region를 바꾸는 것은 계산 규칙을 바꾸지 않습니다. - 스레드 의견, 활성화시:
region는 24시간 시계와 라틴어 손가락을 사용하여 날짜와 시간을 표시하는 방법을 통제합니다.locale은 코멘트 UI 텍스트를 통제합니다. 더 적은 변화는 타임스탬프를 저장하고,region에는 시간대 조정이 아닙니다. - 보드, 슬라이드,베이스, PDF:
locale는 번역한 UI를 통제합니다.region에는 통합된 후에 실 의견과 같은 그것을 읽는 공유 특징이 유효합니다. 그것은 자동적으로 자료표 또는 활주 원본, 기본적인 분야, 또는 PDF 내용이 아닙니다.
오른쪽에서 왼쪽으로 배치
주 메뉴
RTL은 현재 UI 레이어만 지원합니다. 렌더링 레이어는 RTL을 지원하지 않습니다.
주 메뉴
모든 플러그인은 언어 팩을 발송하지 않습니다. 각 기능에 대한 문서는 포함되어 있는지 여부를 나타냅니다.
univerAPI.setDirection('rtl')이 가이드는 어떠셨나요?