更新记录

0.1.1（2026-07-31） 下载此版本

• 新增下拉刷新：enableRefresh / refreshing / refresherThreshold / refresherBackground / refresherDefaultStyle
• 事件：refresh、update:refreshing（可 v-model:refreshing）
• 刷新中暂停触底 load；基于 scroll-view 原生 refresher（仅内部滚动模式）

平台兼容性

uni-app x(4.25)

其他

nax-list

滚动列表壳。负责内部滚动触底加载、下拉刷新与空 / 加载 / 结束 / 错误状态；行内容由业务在默认插槽自行 v-for（可配合 nax-cell）。

虚拟长列表请用独立组件 nax-virtual-list（固定行高窗口裁剪）。

用法

分页加载

<nax-list
  height="400px"
  :loading="loading"
  :finished="finished"
  :error="error"
  :empty="list.length == 0 && !loading && loaded"
  @load="onLoad"
>
  <nax-cell
    v-for="item in list"
    :key="item.id"
    :title="item.title"
    is-link
  ></nax-cell>
</nax-list>

下拉刷新 + 加载更多

<nax-list
  height="400px"
  :enable-refresh="true"
  :refreshing="refreshing"
  :loading="loading"
  :finished="finished"
  @refresh="onRefresh"
  @update:refreshing="(v: boolean) => { refreshing = v }"
  @load="onLoad"
>
  <!-- items -->
</nax-list>

function onRefresh() {
  refreshing.value = true
  // 重拉第 1 页，重置 finished
  fetchPage(1).then((rows) => {
    list.value = rows
    finished.value = rows.length < pageSize
  }).finally(() => {
    refreshing.value = false
  })
}

Props

Events

Methods（defineExpose）

Slots

依赖

• nax-empty
• nax-loading
• nax-ui-theme（可选）

说明

1. 内部滚动模式必须有明确高度：height 或父级 flex 高度链。
2. empty == true 时不会继续自动 load；首屏请先请求再决定是否 empty。
3. 下拉刷新只在 usePageScroll=false 时生效；页面滚动请用页面 onPullDownRefresh + uni.stopPullDownRefresh。
4. 刷新中会暂停触底 load，避免并发；业务在 @refresh 里重置数据与 finished。
5. 虚拟长列表请使用 nax-virtual-list，勿与本壳混为 virtual 开关。