diff --git a/docs/component/input.md b/docs/component/input.md
index 2cec320af661ed1785d8f23a6147b367ef7f9946..cfe5fab4cb011e71733a86039003c2c268a54384 100644
--- a/docs/component/input.md
+++ b/docs/component/input.md
@@ -14,7 +14,23 @@
 
 <!-- UTSCOMJSON.input.reference -->
 
+## 键盘上推专题@adjust-position
+
+在App平台，input和textarea组件都一个属性`adjust-position`，默认为true，即软键盘弹出时，默认上推页面以显示出输入框，避免输入框被软键盘遮挡。
+
+软键盘弹出后会挡住输入框，此时启动上推逻辑。默认的上推策略是：
+- 如果输入框在scroll-view里，会优先滚动scroll-view，以保证显示出输入框。
+- 如果没有可滚动区域，会transform上移页面，以保证显示出输入框。
+
+但是默认的上推策略无法适配所有场景，有些场景需要关闭默认上推策略，即把属性`adjust-position`设为false，然后在输入框的focus或keyboardheightchange事件中获取键盘高度，手动调整界面。
+
+默认上推策略时，如果页面使用了自定义导航栏，常见注意事项是软键盘弹出后可能把自定义导航栏推出可视范围。\
+此时注意顶部导航栏不能在滚动视图中，且需要使用css固定在顶部，然后下面放一个scroll-view，输入框放在scroll-view中，就不会把自定义导航栏顶飞。\
+如果这种方式仍然不能满足需求，那么就需要关闭默认的上推策略，手动控制。
+
+在web端平台，输入框上推逻辑是由浏览器自动完成的，属性`adjust-position`无效。
+但iOS safari软键盘弹出时，整个页面会上推而不是挤压，导致pages.json配置的导航栏会上移到屏幕之外。
+
 ## Tips
 - 从uni-app x 4.0起，App-Android平台 input 点击输入框外的屏幕会自动收起软键盘。
 - 从uni-app x 4.0起，App-Android平台 input 的 font-size 默认值统一为 16px。
-- web端iOS safari软键盘弹出时，整个页面会上推而不是挤压，从而导致导航栏可能会上移到屏幕之外。
diff --git a/docs/component/textarea.md b/docs/component/textarea.md
index f60bacfac279a208245d0ce0ccf8a288cdd30dbc..7deae043137f00f71ed4dc9f8e13fc349ce777b3 100644
--- a/docs/component/textarea.md
+++ b/docs/component/textarea.md
@@ -14,10 +14,14 @@
 
 <!-- UTSCOMJSON.textarea.reference -->
 
+## 键盘上推专题
+input和textarea组件都一个属性`adjust-position`，默认为true，即软键盘弹出时，默认上推页面以显示出输入框，避免输入框被软键盘遮挡。
+
+因为此处内容与input重复，详见[input文档](input.md#adjust-position)
+
 ## Tips
 
 - 从 uni-app x 4.0 起，App-Android平台 textarea 点击输入框外的屏幕会自动收起软键盘。
-* 从 uni-app x 4.0 起，App-Android平台 textarea 的 font-size 默认值统一为 16px，line-height 默认值为 1.2em，width 默认值为300px
+* 从 uni-app x 4.0 起，App-Android平台 textarea 的 font-size 默认值统一为 16px，line-height 默认值为 1.2em，width 默认值为300px。
 * 在Android 9以下的系统版本，样式`line-height`点击键盘换行时行间距设置无效，此问题是Android系统的的bug，后续解决。
-* 由于Android系统限制，textarea的键盘右下角按钮只能是`换行`，所以暂时不提供`confirm-type`属性。
-- web端iOS safari软键盘弹出时，整个页面会上推而不是挤压，从而导致导航栏可能会上移到屏幕之外。
\ No newline at end of file
+* 由于Android系统限制，textarea的键盘右下角按钮只能是`换行`，所以暂时不提供`confirm-type`属性。
\ No newline at end of file