diff --git a/docs/component/list-view.md b/docs/component/list-view.md
index de219b65d6667a704c503c45f61f33e6a979f99b..4ec85d3b01f8a9f443b02e00293628f17dc01a7d 100644
--- a/docs/component/list-view.md
+++ b/docs/component/list-view.md
@@ -103,7 +103,13 @@ list-view组件有默认的下拉刷新样式，如果想自定义，则需使
 
 #### App平台
 
-+ App平台scroll-x、scroll-y属性不支持同时设置为true, 同时设置true时仅scroll-y生效
++ App平台scroll-x、scroll-y属性不支持同时设置为true，同时设置true时仅scroll-y生效。4.0版本开始scroll-x、scroll-y已废弃，请使用direction属性。
++ App平台list-view组件默认高度取值：
+	- list-view组件的子元素高度之和未超过list-view组件的父元素高度：
+		+ list-view组件的默认高度取值为子元素高度之和
+	- list-view组件的子元素高度之和超过list-view组件的父元素高度：
+		+ 3.9版本list-view组件默认高度取值为list-view组件父元素的高度。子元素高度之和超过list-view组件的高度，list-view组件可滚动。
+		+ 4.0版本开始list-view组件的默认高度取值为子元素高度之和。高度相同list-view组件无法滚动。开发者需要设置css属性定义list-view组件高度，让list-view组件高度小于子元素高度之和，实现滚动能力。
 
 ## 示例代码
 
diff --git a/docs/component/scroll-view.md b/docs/component/scroll-view.md
index 905b7a16a8fb3a6543287039dc639d68da5e3ee5..4a94089aa88b8a890f1a0b903cc0e9f2d4a5d1ea 100644
--- a/docs/component/scroll-view.md
+++ b/docs/component/scroll-view.md
@@ -92,10 +92,16 @@ onNestedPreScroll(event: NestedPreScrollEvent) {
 
 #### App平台
 
-+ App平台scroll-x、scroll-y属性不支持同时设置为true, 同时设置true时仅scroll-y生效
++ App平台scroll-x、scroll-y属性不支持同时设置为true, 同时设置true时仅scroll-y生效，4.0版本开始scroll-x、scroll-y已废弃，请使用direction属性。
 + App平台scroll-view组件不支持动态切换横竖滚动方向
-+ App平台scroll-view组件的overflow属性不支持配置visible
-
++ App平台scroll-view组件的overflow属性不支持配置visible
++ App平台scroll-view组件默认高度取值：
+	- scroll-view组件的子元素高度之和未超过scroll-view组件的父元素高度：
+		+ scroll-view组件的默认高度取值为子元素高度之和
+	- scroll-view组件的子元素高度之和超过scroll-view组件的父元素高度：
+		+ 3.9版本scroll-view组件默认高度取值为scroll-view组件父元素的高度。子元素高度之和超过scroll-view组件的高度，scroll-view组件可滚动。
+		+ 4.0版本开始scroll-view组件的默认高度取值为子元素高度之和。高度相同scroll-view组件无法滚动。开发者需要设置css属性定义scroll-view组件高度，让scroll-view组件高度小于子元素高度之和，实现滚动能力。
+
 <!-- UTSCOMJSON.scroll-view.children -->
 
 <!-- UTSCOMJSON.scroll-view.reference -->
\ No newline at end of file