Skip to content

基础使用

vue
<hi-list>
    <view class="item" v-for="i in 6" :key="i" :length="6">列表项</view>
</hi-list>

设置列表

默认 2 列,通过 columns 属性设置列数。

vue
<hi-list columns="4">
    <view class="item" v-for="i in 6" :key="i" :length="6">列表项</view>
</hi-list>

设置间距

默认间距 20rpx 列,通过 gap 属性设置间距。

vue
<hi-list columns="3" gap="20rpx">
    <view class="item" v-for="i in 6" :key="i" :length="6">列表项</view>
</hi-list>

数据状态

通过 loadmoreStatus 属性设置数据状态。

vue
<hi-list columns="3" loadmoreStatus="loading" :length="6">
    <view class="item" v-for="i in 6" :key="i">列表项</view>
</hi-list>

显示空内容

hi-list 组件会自动判断是否显示空内容,当 length0 并且 loadmoreStatus 不为空时,会显示空内容。
可以通过 showEmpty="false" 来关闭自动显示空内容的功能。

vue
<hi-list columns="3" loadmoreStatus="loading" :length="0">
    <view class="item" v-for="i in 6" :key="i">列表项</view>
</hi-list>

Props

参数说明类型默认值可选值
length数据长度Number0-
columns列数String2-
gap行/列间距String--
showEmpty是否显示空内容Booleantrue-
emptyOpts空内容组件 hi-empty 配置Object--
showLoadmore是否显示加载更多Booleantrue-
loadmoreStatus加载更多状态String--
loadmoreOpts加载更多组件 hi-loadmore 配置Object--

Slots

名称说明
#default列表内容插槽