数据表格 - 已翻译组件
数据表格允许支持来自不同语言环境的用户,包括格式化和本地化字符串。
MUI X 的默认语言环境为英语(美国)。如果您想使用其他语言环境,请按照以下说明操作。
翻译键
您可以使用 localeText
属性传入您自己的文本和翻译。您可以在 GitHub 仓库的 源代码中找到所有支持的翻译键。在以下示例中,密度选择器的标签被自定义。
按 Enter 开始编辑
本地化文本
MUI X 的默认语言环境为英语(美国)。
您可以使用主题来配置本地化文本
import { createTheme, ThemeProvider } from '@mui/material/styles';
import { DataGrid } from '@mui/x-data-grid';
import { bgBG } from '@mui/x-data-grid/locales';
// Or import { bgBG } from '@mui/x-data-grid-pro/locales';
// Or import { bgBG } from '@mui/x-data-grid-premium/locales';
const theme = createTheme(
{
palette: {
primary: { main: '#1976d2' },
},
},
bgBG,
);
<ThemeProvider theme={theme}>
<DataGrid />
</ThemeProvider>;
请注意,createTheme
接受任意数量的参数。如果您已经在使用核心组件的翻译,则可以添加 bgBG
作为新参数。相同的导入适用于 Data Grid Pro,因为它是 Data Grid 的扩展。
import { createTheme, ThemeProvider } from '@mui/material/styles';
import { DataGrid } from '@mui/x-data-grid';
import { bgBG } from '@mui/x-data-grid/locales';
import { bgBG as pickersBgBG } from '@mui/x-date-pickers/locales';
import { bgBG as coreBgBG } from '@mui/material/locale';
const theme = createTheme(
{
palette: {
primary: { main: '#1976d2' },
},
},
bgBG, // x-data-grid translations
pickersBgBG, // x-date-pickers translations
coreBgBG, // core translations
);
<ThemeProvider theme={theme}>
<DataGrid />
</ThemeProvider>;
如果您想将语言翻译直接传递给数据表格,而无需使用 createTheme
和 ThemeProvider
,则可以直接从 @mui/x-data-grid/locales
加载语言翻译。
import { DataGrid } from '@mui/x-data-grid';
import { nlNL } from '@mui/x-data-grid/locales';
<DataGrid localeText={nlNL.components.MuiDataGrid.defaultProps.localeText} />;
支持的语言环境
语言环境 | BCP 47 语言标签 | 导入名称 | 完成度 | 源文件 |
---|---|---|---|---|
阿拉伯语(苏丹) | ar-SD | arSD | 114/124 | 编辑 |
孟加拉语 | bn-BD | bnBD | 121/124 | 编辑 |
白俄罗斯语 | be-BY | beBY | 88/124 | 编辑 |
保加利亚语 | bg-BG | bgBG | 122/124 | 编辑 |
中文(香港) | zh-HK | zhHK | 完成 🎉 | 编辑 |
中文(简体) | zh-CN | zhCN | 完成 🎉 | 编辑 |
中文(台湾) | zh-TW | zhTW | 完成 🎉 | 编辑 |
克罗地亚语 | hr-HR | hrHR | 122/124 | 编辑 |
捷克语 | cs-CZ | csCZ | 完成 🎉 | 编辑 |
丹麦语 | da-DK | daDK | 122/124 | 编辑 |
荷兰语 | nl-NL | nlNL | 123/124 | 编辑 |
芬兰语 | fi-FI | fiFI | 118/124 | 编辑 |
法语 | fr-FR | frFR | 122/124 | 编辑 |
德语 | de-DE | deDE | 123/124 | 编辑 |
希腊语 | el-GR | elGR | 114/124 | 编辑 |
希伯来语 | he-IL | heIL | 118/124 | 编辑 |
匈牙利语 | hu-HU | huHU | 123/124 | 编辑 |
冰岛语 | is-IS | isIS | 114/124 | 编辑 |
意大利语 | it-IT | itIT | 122/124 | 编辑 |
日语 | ja-JP | jaJP | 122/124 | 编辑 |
韩语 | ko-KR | koKR | 123/124 | 编辑 |
挪威语(博克马尔语) | nb-NO | nbNO | 118/124 | 编辑 |
挪威语(尼诺斯克语) | nn-NO | nnNO | 118/124 | 编辑 |
波斯语 | fa-IR | faIR | 123/124 | 编辑 |
波兰语 | pl-PL | plPL | 117/124 | 编辑 |
葡萄牙语 | pt-PT | ptPT | 123/124 | 编辑 |
葡萄牙语(巴西) | pt-BR | ptBR | 123/124 | 编辑 |
罗马尼亚语 | ro-RO | roRO | 123/124 | 编辑 |
俄语 | ru-RU | ruRU | 123/124 | 编辑 |
斯洛伐克语 | sk-SK | skSK | 完成 🎉 | 编辑 |
西班牙语 | es-ES | esES | 123/124 | 编辑 |
瑞典语 | sv-SE | svSE | 122/124 | 编辑 |
土耳其语 | tr-TR | trTR | 123/124 | 编辑 |
乌克兰语 | uk-UA | ukUA | 123/124 | 编辑 |
乌尔都语(巴基斯坦) | ur-PK | urPK | 123/124 | 编辑 |
越南语 | vi-VN | viVN | 122/124 | 编辑 |
您可以在 GitHub 仓库中查找源代码。
要创建您自己的翻译或自定义英文文本,请将此文件复制到您的项目中,进行任何必要的更改,然后从那里导入语言环境。请注意,数据表格组件的这些翻译取决于整个库的 本地化策略。
RTL 支持
支持从右到左的语言,例如阿拉伯语、波斯语或希伯来语。请遵循本指南来使用它们。
以下示例演示了如何在数据表格中使用 RTL 语言(阿拉伯语)。
按 Enter 开始编辑