diff --git a/docs/api/ui/locale.md b/docs/api/ui/locale.md
index a0ecda32ca5417bac6a47c3186cc83e5ebd43c26..15427762722b6b6070fd862f9f59d1690e7eff54 100644
--- a/docs/api/ui/locale.md
+++ b/docs/api/ui/locale.md
@@ -26,6 +26,22 @@
 |:-|:-|:-|
 |locale|String|是|
 
+### uni.onLocaleChange(callback)
+
+设置当前语言
+
+**平台差异说明**
+
+|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|QQ小程序|快手小程序|华为快应用|360小程序|
+|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
+|3.2.7+|3.2.7+|x|x|x|x|x|x|x|x|
+
+**callback返回参数说明**
+
+|参数名|类型|说明|
+|:-|:-|:-|
+|locale|String|当前语言|
+
 #### 提示
 
 * 组件和接口显示会根据设置的语言环境自动切换，未支持的系统语言环境会显示为英文。