更新记录

1.0.4(2019-11-12)

  • 优化 可在nvue页面中使用

1.0.1(2019-09-21)

  • 新增 示例项目
查看更多

List 列表

已经支持在nvue页面中使用

列表组件,组件名:uni-listuni-list-item,代码块: uList。

使用方式

script 中引用组件

import uniList from "@/components/uni-list/uni-list.vue"
import uniListItem from "@/components/uni-list-item/uni-list-item.vue"
export default {
    components: {uniList,uniListItem}
}

template 中使用组件

<!-- 一般用法 -->
<uni-list>
    <uni-list-item title="标题文字" :show-arrow="false"></uni-list-item>
    <uni-list-item title="标题文字"></uni-list-item>
    <uni-list-item title="标题文字" :show-badge="true" badge-text="12"></uni-list-item>
    <uni-list-item title="禁用状态" :disabled="true" :show-badge="true" badge-text="12"></uni-list-item>
</uni-list>

<!-- 带描述信息 -->
<uni-list>
    <uni-list-item title="标题文字" note="描述信息"></uni-list-item>
    <uni-list-item title="标题文字" note="描述信息" :show-badge="true" badge-text="12"></uni-list-item>
</uni-list>

<!-- 包含图片 -->
<uni-list>
    <uni-list-item title="标题文字" thumb="https://img-cdn-qiniu.dcloud.net.cn/new-page/hx.png"></uni-list-item>
</uni-list>

<!-- 包含图标 -->
<uni-list>
    <uni-list-item title="标题文字" :show-extra-icon="true" :extra-icon="{color: '#4cd964',size: '22',type: 'spinner'}"></uni-list-item>
</uni-list>

<!-- 显示Switch -->
<uni-list>
    <uni-list-item title="标题文字" :show-switch="true" :show-arrow="false"></uni-list-item>
</uni-list>

属性说明

uniListItem 属性说明:

属性名 类型 默认值 说明
title String - 标题
note String - 描述
disabled Boolean false 是否禁用
show-arrow Boolean true 是否显示箭头图标
show-badge Boolean false 是否显示数字角标
badge-text String - 数字角标内容
badge-type String - 数字角标类型,参考uni-icons
show-switch Boolean false 是否显示Switch
switch-checked Boolean false Switch是否被选中
show-extra-icon Boolean false 左侧是否显示扩展图标
extra-icon Object - 扩展图标参数,格式为 {color: '#4cd964',size: '22',type: 'spinner'},参考 uni-icons
thumb String - 左侧缩略图,若thumb有值,则不会显示扩展图标
scroll-y Boolean false 允许纵向滚动,需要显式的设置其宽高

uniListItem 事件说明:

事件称名 说明 返回参数
click 点击 uniListItem 触发事件 -
switchChange 点击切换 Switch 时触发 e={value:checked}

Tips

  • 支付宝小程序平台需要在支付宝小程序开发者工具里开启 component2 编译模式,开启方式: 详情 --> 项目配置 --> 启用 component2 编译
  • 页面纵向滚动时,Android 平台不支持区域滚动,iOS 支持
  • iOS 有Bounce效果,Android 仅可滚动时有

插件预览地址

https://uniapp.dcloud.io/h5/pages/extUI/list/list

隐私、权限及商业化声明

1. 本插件需要申请的手机端权限列表:

2. 本插件采集的手机端数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问