005cf56baf
Some checks failed
No response / noResponse (push) Has been cancelled
CI / Continuous releases (push) Has been cancelled
CI / test-dev (macos-latest) (push) Has been cancelled
CI / test-dev (ubuntu-latest) (push) Has been cancelled
CI / test-dev (windows-latest) (push) Has been cancelled
Maintenance / main (push) Has been cancelled
Scorecards supply-chain security / Scorecards analysis (push) Has been cancelled
CodeQL / Analyze (push) Has been cancelled
112 lines
5.5 KiB
Markdown
112 lines
5.5 KiB
Markdown
# Localization
|
||
|
||
<p class="description">Localization (also referred to as "l10n") is the process of adapting a product or content to a specific locale or market.</p>
|
||
|
||
The default locale of Material UI is English (United States). If you want to use other locales, follow the instructions below.
|
||
|
||
## Locale text
|
||
|
||
Use the theme to configure the locale text globally:
|
||
|
||
```jsx
|
||
import { createTheme, ThemeProvider } from '@mui/material/styles';
|
||
import { zhCN } from '@mui/material/locale';
|
||
|
||
const theme = createTheme(
|
||
{
|
||
palette: {
|
||
primary: { main: '#1976d2' },
|
||
},
|
||
},
|
||
zhCN,
|
||
);
|
||
|
||
<ThemeProvider theme={theme}>
|
||
<App />
|
||
</ThemeProvider>;
|
||
```
|
||
|
||
### Example
|
||
|
||
{{"demo": "Locales.js"}}
|
||
|
||
:::warning
|
||
The [Data Grid and Data Grid Pro](/x/react-data-grid/) components have their own [localization](/x/react-data-grid/localization/).
|
||
:::
|
||
|
||
### Supported locales
|
||
|
||
| Locale | BCP 47 language tag | Import name |
|
||
| :---------------------- | :------------------ | :---------- |
|
||
| Amharic | am-ET | `amET` |
|
||
| Arabic (Egypt) | ar-EG | `arEG` |
|
||
| Arabic (Saudi Arabia) | ar-SA | `arSA` |
|
||
| Arabic (Sudan) | ar-SD | `arSD` |
|
||
| Armenian | hy-AM | `hyAM` |
|
||
| Azerbaijani | az-AZ | `azAZ` |
|
||
| Bangla | bn-BD | `bnBD` |
|
||
| Bulgarian | bg-BG | `bgBG` |
|
||
| Catalan | ca-ES | `caES` |
|
||
| Chinese (Hong Kong) | zh-HK | `zhHK` |
|
||
| Chinese (Simplified) | zh-CN | `zhCN` |
|
||
| Chinese (Taiwan) | zh-TW | `zhTW` |
|
||
| Croatian | hr-HR | `hrHR` |
|
||
| Czech | cs-CZ | `csCZ` |
|
||
| Danish | da-DK | `daDK` |
|
||
| Dutch | nl-NL | `nlNL` |
|
||
| English (United States) | en-US | `enUS` |
|
||
| Estonian | et-EE | `etEE` |
|
||
| Finnish | fi-FI | `fiFI` |
|
||
| French | fr-FR | `frFR` |
|
||
| German | de-DE | `deDE` |
|
||
| Greek | el-GR | `elGR` |
|
||
| Hebrew | he-IL | `heIL` |
|
||
| Hindi | hi-IN | `hiIN` |
|
||
| Hungarian | hu-HU | `huHU` |
|
||
| Icelandic | is-IS | `isIS` |
|
||
| Indonesian | id-ID | `idID` |
|
||
| Italian | it-IT | `itIT` |
|
||
| Japanese | ja-JP | `jaJP` |
|
||
| Khmer | kh-KH | `khKH` |
|
||
| Kazakh | kk-KZ | `kkKZ` |
|
||
| Korean | ko-KR | `koKR` |
|
||
| Kurdish (Central) | ku-CKB | `kuCKB` |
|
||
| Macedonian | mk-MK | `mkMK` |
|
||
| Myanmar | my-MY | `myMY` |
|
||
| Malay | ms-MS | `msMS` |
|
||
| Nepali | ne-NP | `neNP` |
|
||
| Norwegian (bokmål) | nb-NO | `nbNO` |
|
||
| Norwegian (nynorsk) | nn-NO | `nnNO` |
|
||
| Pashto (Afghanistan) | ps-AF | `psAF` |
|
||
| Persian | fa-IR | `faIR` |
|
||
| Polish | pl-PL | `plPL` |
|
||
| Portuguese | pt-PT | `ptPT` |
|
||
| Portuguese (Brazil) | pt-BR | `ptBR` |
|
||
| Romanian | ro-RO | `roRO` |
|
||
| Russian | ru-RU | `ruRU` |
|
||
| Serbian | sr-RS | `srRS` |
|
||
| Sinhalese | si-LK | `siLK` |
|
||
| Slovak | sk-SK | `skSK` |
|
||
| Spanish | es-ES | `esES` |
|
||
| Swedish | sv-SE | `svSE` |
|
||
| Thai | th-TH | `thTH` |
|
||
| Turkish | tr-TR | `trTR` |
|
||
| Tagalog | tl-TL | `tlTL` |
|
||
| Ukrainian | uk-UA | `ukUA` |
|
||
| Urdu (Pakistan) | ur-PK | `urPK` |
|
||
| Vietnamese | vi-VN | `viVN` |
|
||
|
||
<!-- #target-branch-reference -->
|
||
|
||
You can [find the source](https://github.com/mui/material-ui/blob/master/packages/mui-material/src/locale/index.ts) in the GitHub repository.
|
||
|
||
To create your own translation, or to customize the English text, copy this file to your project, make any changes needed and import the locale from there.
|
||
|
||
Please do consider contributing new translations back to Material UI by opening a pull request.
|
||
However, Material UI aims to support the [100 most common](https://en.wikipedia.org/wiki/List_of_languages_by_number_of_native_speakers) [locales](https://www.ethnologue.com/insights/ethnologue200/), we might not accept contributions for locales that are not frequently used, for instance `gl-ES` that has "only" 2.5 million native speakers.
|
||
|
||
## RTL Support
|
||
|
||
Right-to-left languages such as Arabic, Persian, Hebrew, Kurdish, and others are supported.
|
||
Follow [this guide](/material-ui/customization/right-to-left/) to use them.
|