!1543 添加refresh开发者文档

Merge pull request !1543 from Yao.inhome/qiyi_refresh_docs_0218

zh-cn/application-dev/reference/arkui-ts/ts-container-refresh.md

+# Refresh
+
+> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
+下拉刷新容器。
+
+## 权限列表
+
+无
+
+## 子组件
+
+支持单个子组件。
+
+## 接口
+
+Refresh\(value: \{refreshing: boolean, offset?: Length, friction?: number\}\)
+
+- 参数
+
+  | 参数 | 参数名 | 必填 | 默认值 | 参数描述 |
+  | -------- | -------- | -------- | -------- | -------- |
+  | refreshing | boolean | 是 | - | 当前组件是否正在刷新。 |
+  | offset | Length | 否 | 16 | 刷新组件静止时距离父组件顶部的距离。|
+  | friction | number | 否 | 62 | 下拉摩擦系数，取值范围为0到100。<br/>-&nbsp;0表示下拉刷新容器不跟随手势下拉而下拉。<br/>-&nbsp;100表示下拉刷新容器紧紧跟随手势下拉而下拉。<br/>-&nbsp;数值越大，下拉刷新容器跟随手势下拉的反应越灵敏。 |
+
+
+
+## 事件
+
+
+| 名称 | 描述 |
+| -------- | -------- |
+| onStateChange(callback: (state: RefreshStatus) => void)| 当前刷新状态变更时，触发回调。<br/>state：刷新状态。 |
+| onRefreshing(callback: () => void)| 进入刷新状态时触发回调。 |
+
+- RefreshStatus枚举说明
+
+  | 名称 | 描述 |
+  | -------- | -------- |
+  | Inactive | 默认未下拉状态。 |
+  | Drag | 下拉中，下拉距离小于刷新距离。 |
+  | OverDrag | 下拉中，下拉距离超过刷新距离。 |
+  | Refresh | 下拉结束，回弹至刷新距离，进入刷新状态。 |
+  | Done | 刷新结束，返回初始状态（顶部）。 |
+
+
+## 示例
+
+```
+@Entry
+@Component
+struct RefreshExample {
+  @State isRefreshing: boolean = false
+  @State counter: number = 0
+
+  build() {
+    Column() {
+      Refresh({refreshing: this.isRefreshing, offset: 120, friction: 100}) {
+        Text('Pull Down and refresh: ' + this.counter)
+          .fontSize(30)
+          .margin(10)
+      }
+      .onStateChange((refreshStatus: RefreshStatus) => {
+        console.info('Refresh onStatueChange state is ' + refreshStatus)
+      })
+      .onRefreshing(() => {
+        setTimeout(() => {
+          this.counter++
+          this.isRefreshing = false
+        }, 1000)
+        console.log('onRefreshing test')
+      })
+    }
+  }
+}
+```
+
+![](figures/refresh.gif)