diff --git a/docs/use-weex.md b/docs/use-weex.md
index 7aa4350b2d390ba0f3008730aab92aac1555a043..43dff683e7c5068c3bd67b623a1f2b4acc42b801 100644
--- a/docs/use-weex.md
+++ b/docs/use-weex.md
@@ -681,3 +681,25 @@ Android平台weex对阴影样式(`box-shadow`)支持不完善，如设置圆角
 - 使用`elevation`需要阴影元素的父元素大于阴影范围，否则会对阴影进行裁剪
 - IOS不支持`elevation`属性，请使用`box-shadow`设置阴影
 
+## iOS平台下拉组件refresh组件注意问题
+
+iOS平台默认情况下可滚动容器组件（如list、waterfall组件）内容不足时，由于内容没有撑满容器的可视区域导致无法上下滚动，此时无法操作下拉刷新功能，无法触发refresh组件的@refresh、@pullingdown事件。
+此时可在容器组件中配置alwaysScrollableVertical属性值为true来设置支持上下滚动，从而支持下拉刷新操作。
+
+**用法**
+```
+<list class="scroll-v list" enableBackToTop="true" scroll-y alwaysScrollableVertical="true">
+  <refresh class="refresh" @refresh="onrefresh()" @pullingdown="onpullingdown">
+    //refresh content
+  </refresh>
+  <cell v-for="(newsitem,index) in list" :key="newsitem.id">
+    //cell content
+  </cell>
+</list>
+```
+
+**注意**
+- Android平台不存在此问题
+
+
+