uni-list 是 uni-app 中用于构建列表的组件,以下是具体的使用方法:

1. 基本用法

  • 导入组件:首先,你需要在你的页面或组件中导入 uni-listuni-list-item 组件。例如:

    import uniList from '@/components/uni-list/uni-list.vue';
    import uniListItem from '@/components/uni-list-item/uni-list-item.vue';

    然后在页面的 components 选项中注册这些组件:

    export default {
        components: {
            uniList,
            uniListItem
        }
    }
  • 使用组件:在页面的模板中使用 uni-listuni-list-item 来构建列表:

    <template>
      <uni-list>
        <uni-list-item title="列表项标题"></uni-list-item>
        <uni-list-item :disabled="true" title="禁用的列表项"></uni-list-item>
      </uni-list>
    </template>

2. 多行内容显示

  • 设置 note 属性:可以在 uni-list-item 中设置 note 属性来显示第二行的描述文本信息:

    <uni-list-item title="列表项标题" note="列表项描述信息"></uni-list-item>

3. 右侧显示角标、switch

  • 设置 show-badgeshow-switch 属性:可以在 uni-list-item 中设置 show-badge 属性来显示角标内容,设置 show-switch 属性来显示 switch 开关:

    <uni-list-item title="列表右侧显示角标" :show-badge="true" badge-text="12"></uni-list-item>
    <uni-list-item title="列表右侧显示 switch" :show-switch="true" @switchChange="switchChange"></uni-list-item>

4. 左侧显示略缩图、图标

  • 设置 thumbshow-extra-icon 属性:可以在 uni-list-item 中设置 thumb 属性来显示左侧略缩图,设置 show-extra-icon 属性并指定 extra-icon 来在左侧显示图标:

    <uni-list-item thumb="路径/图片.png" show-extra-icon :extra-icon="{color: '#4cd964', size: '22', type: 'spinner'}"></uni-list-item>

5. 事件和插槽

  • 事件uni-list-item 支持 clickswitchChange 事件,分别用于点击列表项和开关状态改变时触发。
  • 插槽uni-list-item 提供了 headerbodyfooter 三个插槽,用于自定义列表项的内容:

    <uni-list-item>
      <template v-slot:header>
        <!-- 自定义头部内容 -->
      </template>
      <template v-slot:body>
        <!-- 自定义主体内容 -->
      </template>
      <template v-slot:footer>
        <!-- 自定义底部内容 -->
      </template>
    </uni-list-item>

以上就是 uni-list 插件的基本使用方法,你可以根据项目需求进行相应的调整和扩展。


融云RongCloud
82 声望1.2k 粉丝

因为专注,所以专业