功能描述
React UIKit 默认自带 英语、日语、韩语、中文简体/ 中文繁体 语言包,作为界面展示语言。
根据此文档指引,您可以使用默认语言包,也可使用自定义的高级国际化能力,包括新增语言、新增词条或修改现有词条翻译。
使用自带语言及词条库
如果您的 App,需要的语言仅包括英语 / 日语 / 韩语 / 中文简体/ 中文繁体 ,且不需要新增词条或修改现有词条翻译,请参考本部分。
指定语言
如果您需要指定界面的语言,需要在引入 UIKitProvider
时设置 language
。
<UIKitProvider language={'en-US'}>...</UIKitProvider>
动态切换语言
在 UIKitProvider
之外,动态切换 React UIKit 语言:
import React, { useState } from 'react';
import { UIKitProvider } from '@tencentcloud/uikit-base-component-react';
const languageList = ['en-US','zh-CN','ja-JP','ko-KR', 'zh-TW'];
export default function App() {
const [currentLanguage, setCurrentLanguage] = useState('en-US');
const changeLanguage = (language) => {
setCurrentLanguage(language);
};
return (
<UIKitProvider language={currentLanguage}>
...
</UIKitProvider>
);
}
在 UIKitProvider
之内,动态切换 React UIKit 语言:
import React from 'react';
import { UIKitProvider, useUIKit } from '@tencentcloud/uikit-base-component-react';
const languageList = ['en-US','zh-CN','ja-JP','ko-KR', 'zh-TW'];
export default function App() {
return (
<UIKitProvider language='en-US'>
<Child />
</UIKitProvider>
);
}
function Child() {
const { language, setLanguage } = useUIKit();
setLanguage('zh-CN');
return <div>current language is {language}</div>
}
使用语言词条
使用 hook useUIKit
导出翻译函数 t
,useUIKit
作为 Hook 只能在 UIKitProvider
的子组件中使用。
import React from 'react';
import { UIKitProvider, useUIKit } from '@tencentcloud/uikit-base-component-react';
export default function SampleChat() {
return (
<UIKitProvider language='en-US'>
<Child />
</UIKitProvider>
);
}
function Child() {
const { t } = useUIKit();
return <div>{t('TUIChat.No More')}</div>
}
自定义语言词条
新增或修改语言词条
import { UIKitProvider } from '@tencentcloud/uikit-base-component-react';
const additionalLanguageResource = [
{
lng: 'de',
translation: {
'TUIChat': {
'No More': 'Nicht mehr',
},
},
},
];
export default function App() {
return (
<UIKitProvider language="de" additionalLanguageResources={additionalLanguageResource}>
<Child />
</UIKitProvider>
);
}
function Child() {
const { t, language, setLanguage } = useUIKit();
return <div>current language is {language}. {t('TUIChat.No More')}</div>
}
交流与反馈
本页内容是否解决了您的问题?