列表 List
列表右侧内容
列表右侧内容可设置的有文本和跳转的图标,分别通过下面的属性设置:
is-link
设置是否显示跳转的图标,默认为true
,可选值true
和false
;link-type
设置跳转类型,默认为navigateTo
,可选值为navigateTo
、redirectTo
、reLaunch
、switchTab
;url
设置跳转的路径除此之外,还可以监听lintap
事件,自定义点击后的事件处理逻辑。
带图标或图片的列表
通过 icon
和 image
属性设置显示的图标或图片的内容,当同时设置 icon
和 image
时,优先展示 image
。
通过外部样式类 l-class-icon
覆盖默认 icon
的样式,外部样式类 l-class-image
覆盖默认 image
的样式。
注意事项
- 使用本地图片时,最好使用绝对路径。
<l-list title="购物车" icon="cart" is-link="{{false}}"/>
<l-list title="消息" icon="notification" />
<l-list title="客厅" image="/pages/layout/images/badroom-active.png" />
通过 icon
和 image
属性设置显示的图标或图片的内容,当同时设置 icon
和 image
时,优先展示 image
。
通过外部样式类 l-class-icon
覆盖默认 icon
的样式,外部样式类 l-class-image
覆盖默认 image
的样式。
注意事项
- 需要保证自定义的字体图标的文件存在于项目中;具体操作方式可看icon-自定义图标
带标签的列表
通过tag-content
设置显示的标签的内容,不设置的内容时标签不显示,默认显示位置为列表左边。
标签相关的属性有,作用分别如下:
- 设置显示的标签的内容;
tag-position
设置标签显示的位置,可选值为right
、left
,默认为left
;tag-color
设置标签的颜色,接收表示颜色的值;tag-shape
设置标签的形状,可选值为circle
、square
,默认为square
;tag-plain
设置标签是否镂空, 可选值为false
、true
,默认为false
,当设置为true
时,tag-color
修改的是字体的颜色。
<l-list title="购物车" icon="cart" tag-content="购物车" />
<l-list title="消息" icon="notification" tag-content="消息" tag-position="right"/>
<l-list title="消息" icon="notification" tag-content="消息" tagShape="circle" tag-position="right"/>
带徽标的列表
通过badge-count
设置徽标的数值,不设置的内容时徽标不显示,或者设置dotBadge=true
时显示圆点徽标,默认显示位置为列表左边。
徽标相关的属性有,作用分别如下:
badge-position
设置徽标显示的位置,可选值为right
、left
,默认为left
;badge-max-count
设置徽标数字最大值,超过最大值时显示${max-count}+;badge-count-type
数字的显示方式, 可选值为overflow
、limit
、custom
,默认值为overflow
。
可以通过 slot
的方式自定义左右两半部分的内容,slot="left-section"
时自定义的是左半部分的内容,slot="right-section"
时自定义的是右半部分的内容
<l-list right-desc="生成我的海报">
<view slot="left-section">
</view>
</l-list>
<l-list title="允许陌生人查看十条朋友圈">
<view slot="right-section">
<switch />
</view>
列表属性(List Attributes)
列表事件(List Events)
事件名称 | 说明 | 返回值 | 备注 |
---|---|---|---|
bind:lintap | 当点击列表时触发 | ————- | ———— |