ant-design/components/locale-provider/index.zh-CN.md

---
category: Components
subtitle: 国际化
cols: 1
type: Other
title: LocaleProvider
---

为组件内建文案提供统一的国际化支持。

## 使用

LocaleProvider 使用 React 的 [context](https://facebook.github.io/react/docs/context.html) 特性，只需在应用外围包裹一次即可全局生效。


```jsx
import enUS from 'antd/lib/locale-provider/en_US';

...

return <LocaleProvider locale={enUS}><App /></LocaleProvider>;
```

### Add a language

We supply an English locale package. Other language users can create a locale package based on [en_US](https://github.com/ant-design/ant-design/blob/26b1f37392a278285aec6c573b99c6feea09e218/components/locale-provider/en_US.js) and send us a pull request.

### 其他国际化需求

本模块仅用于组件的内建文案，若有业务文案的国际化需求，建议使用 [react-intl](https://github.com/yahoo/react-intl)，可参考示例：[Intl demo 1](http://github.com/ant-design/intl-example) 和 [Intl demo 2](http://yiminghe.me/learning-react/examples/react-intl.html?locale=en-US)。

## API

| 参数    | 说明           | 类型              | 默认值        |
|--------|----------------|------------------|--------------|
| locale | 语言包配置，语言包可到 `antd/lib/locale-provider/` 目录下寻找 | Object | - |
docs: update documentation format 2016-03-31 14:17:09 +08:00			`---`
			`category: Components`
docs: update docs details 2016-09-21 11:28:38 +08:00			`subtitle: 国际化`
docs: update documentation format 2016-03-31 14:17:09 +08:00			`cols: 1`
change LocaleProvider's component type 2016-12-02 21:06:21 +08:00			`type: Other`
docs: update docs details 2016-09-21 11:28:38 +08:00			`title: LocaleProvider`
docs: update documentation format 2016-03-31 14:17:09 +08:00			`---`
Add LocalProvider, ref #1055 2016-03-03 16:28:02 +08:00
update demo 2016-03-03 21:00:38 +08:00			`为组件内建文案提供统一的国际化支持。`
Add LocalProvider, ref #1055 2016-03-03 16:28:02 +08:00
update locale-provider docs 2016-03-07 15:18:39 +08:00			`## 使用`

			`LocaleProvider 使用 React 的 [context](https://facebook.github.io/react/docs/context.html) 特性，只需在应用外围包裹一次即可全局生效。`
Add LocalProvider, ref #1055 2016-03-03 16:28:02 +08:00

			```jsx
update locale-provider docs 2016-03-07 15:18:39 +08:00			`import enUS from 'antd/lib/locale-provider/en_US';`

			`...`

			`return <LocaleProvider locale={enUS}><App /></LocaleProvider>;`
Add LocalProvider, ref #1055 2016-03-03 16:28:02 +08:00			```

			`### Add a language`
update locale-provider docs 2016-03-07 15:18:39 +08:00
Minor English grammar improvements. 2016-03-14 12:45:06 +08:00			`We supply an English locale package. Other language users can create a locale package based on [en_US](https://github.com/ant-design/ant-design/blob/26b1f37392a278285aec6c573b99c6feea09e218/components/locale-provider/en_US.js) and send us a pull request.`
update locale-provider docs 2016-03-07 15:18:39 +08:00
			`### 其他国际化需求`

			`本模块仅用于组件的内建文案，若有业务文案的国际化需求，建议使用 [react-intl](https://github.com/yahoo/react-intl)，可参考示例：[Intl demo 1](http://github.com/ant-design/intl-example) 和 [Intl demo 2](http://yiminghe.me/learning-react/examples/react-intl.html?locale=en-US)。`

			`## API`

			`\| 参数 \| 说明 \| 类型 \| 默认值 \|`
			`\|--------\|----------------\|------------------\|--------------\|`
			\| locale \| 语言包配置，语言包可到 `antd/lib/locale-provider/` 目录下寻找 \| Object \| - \|