#<FeedList>

#基本用法

当页面既需要虚拟列表渲染，又需要下拉刷新、加载更多等 feed 行为时，使用 FeedList。每一行都应作为直接的 list-item 子节点，并提供稳定的 item-key；同时设置 listId 和 listType，让底层列表能正确管理身份和布局。

#如何管理底部状态

用 loadMoreFooter 表示加载中状态，用 noMoreDataFooter 表示没有更多数据。通过 changeHasMoreStatus 在两种状态之间切换；这个底部状态独立于刷新状态和列表 diff 结果。

#如何主动触发刷新

当刷新由命令触发，而不是由下拉手势触发时，使用 startRefresh，例如重试按钮或外部筛选条件变化。数据请求结束后，调用 finishRefresh 释放刷新头。

#FeedListProps

#Properties

#Events

#headerReleased

#refreshOffsetEvent

#FeedListRef

#RefreshEvent

#RefreshStateChange

#如何使用 refreshOptions

useRefresh hook 是 useBounces hook 的扩展，它使用了 useBounces 的基础能力，并扩展了几个能力：

1. 支持与 upperBounceItem 相对的 refreshHeader 节点。
2. 支持回弹过程中停留在 refreshHeader 上，模拟上拉加载效果

我们让 useBounce 的回弹曲线能够在 refreshHeader，也即刷新区域的边缘处停止，直到 finishRefresh 方法在刷新结束后被主动调用，再回弹至边缘。

一次完整的刷新分为四个阶段，下面的事件分别对应这些阶段的切换时机。

#事件

这四个阶段有各自的事件触发时机：

• onStartRefresh：最重要的事件，在阶段三的状态触发，此事件中可以进行数据的更新；
• onRefreshOffsetChange：RefreshHeader 露出、处于刷新区域的时候会连续触发，发送当前的 refreshHeader 露出位置；
• onHeaderReleased：从阶段二结束拖拽时触发，开始回弹至 refreshHeader；
• onRefreshStateChange：不同阶段转移时触发，提供在一个单一事件中掌握所有状态的能力：
  • IDLE：refreshHeader 未露出，处于正常滚动区域的状态；
  • OVER_DRAG_RELEASE：与 onHeaderReleased 时机相同，阶段二结束拖拽时的状态；
  • REFRESHING：与 onStartRefresh 时机相同；
  • DRAGGING：拖拽并露出 refreshHeader 的状态下持续触发；