# <refresh>

# 简介

<refresh> 为容器提供下拉刷新功能。

注意

<refresh> 是 <scroller>、<list>、<waterfall> 的子组件，只能在被它们包含时才能被正确渲染。

<scroller>
  <refresh>
    <text>Refreshing...</text>
  </refresh>
  <div v-for="num in lists">
    <text>{{num}}</text>
  </div>
</scroller>

# 子组件

诸如 <text>、<image> 之类的任何组件，都可以放到 <loading> 进行渲染。
特殊子组件 <loading-indicator>: 只能作为 <refresh> 和 <loading> 的子组件使用，拥有默认的动画效果实现。

<refresh>
  <text>Refreshing</text>
  <loading-indicator></loading-indicator>
</refresh>

# 属性

display
控制 <refresh> 组件显示、隐藏。display 的设置必须成对出现，即设置 display="show",必须有对应的 display="hide"。可选值为 show / hide，默认值为 show。

# 事件

refresh 事件：当 <scroller>、<list>、<waterfall> 被下拉完成时触发。
pullingdown 事件：当 <scroller>、<list>、<waterfall> 被下拉时触发。可以从 event 参数对象中获取以下数据：
- dy: 前后两次回调滑动距离的差值
- pullingDistance: 下拉的距离
- viewHeight: refresh 组件高度
- type: “pullingdown” 常数字符串

<refresh @refresh="onrefresh" @pullingdown="onpullingdown" :display="refreshing ? 'show' : 'hide'">
  <text>Refreshing ...</text>
  <loading-indicator></loading-indicator>
</refresh>

# Vue 示例

基本用法

# Rax 示例

rax-refreshcontrol 是 <refresh> 组件的上层封装，提供了 Weex 下拉刷新能力

import { createElement, Component, render } from 'rax';
import View from 'rax-view';
import Text from 'rax-text';
import Driver from 'driver-universal';
import RecyclerView from 'rax-recyclerview';
import RefreshControl from 'rax-refreshcontrol';

class RefreshControlDemo extends Component {
  state = {
    isRefreshing: false,
    loaded: 0,
    refreshText: '↓ Pull To Refresh'
  };

  handleRefresh = (e) => {
    this.setState({
      isRefreshing: true,
      refreshText: 'Refreshing',
    });
    setTimeout(() => {
      // update Data
      this.setState({
        isRefreshing: false,
        refreshText: '↓ Pull To Refresh',
      });
    }, 1000);
  };

  render() {
    return (
      <View>
        <RecyclerView
          refreshControl={null}>
          <RefreshControl
            refreshing={this.state.isRefreshing}
            onRefresh={this.handleRefresh}
          >
            <Text>{this.state.refreshText}</Text>
          </RefreshControl>
          <RecyclerView.Cell>
            <View>
              <Text>this is list</Text>
            </View>
          </RecyclerView.Cell>
        </RecyclerView>
      </View>
   );
  }
}

render(<RefreshControlDemo/>, document.body, { driver: Driver });

rax-refreshcontrol 文档