Skip to content

List 列表

基础用法

  • List 组件用于显示列表信息、聊天信息,内置一套组件模板。
  • 子组件可为 sn-list-itemsn-list-chat
vue
<template>
	<sn-list>
		<sn-list-item title="列表文字"></sn-list-item>
		<sn-list-item title="列表文字" rightText="右侧文字"></sn-list-item>
		<sn-list-item title="列表文字" note="列表描述信息" rightText="右侧文字"></sn-list-item>
	</sn-list>
</template>

更多演示请下载 demo 查看

属性

sn-list

参数说明类型默认值可选值
showBorder是否显示列表项边框Booleantruetrue | false
bgColor列表背景颜色String$front-
customStyle自定义列表样式UTSJSONObject{}-
sn-list-item
参数说明类型默认值可选值
ellipsis文本溢出隐藏,可设置最大行数,超过则以省略号隐藏文本Number0-
disabled是否禁用列表项(只针对单个列表项)Booleanfalsetrue
title列表项标题String--
titleSize列表项标题字体大小String$2-
titleColor列表项标题颜色String$title-
note列表项副标题String--
noteSize列表项副标题字体大小String$1-
noteColor列表项副标题颜色String$textLight-
rightText列表项右侧文本String--
rightTextSize列表项右侧文本字体大小String$1-
rightTextColor列表项右侧文本颜色String$textLight-
avatarConfig列表项头像配置SnAvatarParams{}-
icon列表项图标名称String--
iconSize列表项图标大小String$4-
iconColor列表项图标颜色String$title-
showArrow是否显示列表项右侧箭头Booleanfalsetrue
bgColor列表项背景颜色String$transparent-
disabledBgColor禁用时列表项的背景颜色String$disabled-
disabledTextColor禁用时列表项的文本颜色String$disabledText-
activeBgColor激活时列表项的背景颜色String$info-
padding列表项内边距String13px 15px-
customTitleStyle自定义列表项标题样式UTSJSONObject{}-
customNoteStyle自定义列表项副标题样式UTSJSONObject{}-
customRightTextStyle自定义列表项右侧文本样式UTSJSONObject{}-
customAvatarStyle自定义列表项头像样式UTSJSONObject{}-
customIconStyle自定义列表项图标样式UTSJSONObject{}-
customBodyStyle自定义列表项主体内容样式UTSJSONObject{}-
customHeaderStyle自定义列表项头部样式UTSJSONObject{}-
customFooterStyle自定义列表项尾部样式UTSJSONObject{}-
customStyle自定义列表项整体样式UTSJSONObject{}-

sn-list-chat

参数说明类型默认值可选值
disabled是否禁用聊天列表项Booleanfalsetrue
title聊天列表项标题String--
titleSize聊天列表项标题字体大小String$3-
titleColor聊天列表项标题颜色String$title-
note聊天列表项副标题String--
noteSize聊天列表项副标题字体大小String$1-
noteColor聊天列表项副标题颜色String$textLight-
bgColor聊天列表项背景颜色String$transparent-
disabledBgColor禁用时聊天列表项的背景颜色String$disabled-
disabledTextColor禁用时聊天列表项的文本颜色String$disabledText-
activeBgColor激活时聊天列表项的背景颜色String$info-
time聊天列表项时间文本String--
timeSize聊天列表项时间文本字体大小String12px-
timeColor聊天列表项时间文本颜色String$textLight-
badgeConfig聊天列表项徽标配置SnBadgeParams{}-
avatarConfig聊天列表项头像配置SnAvatarParams{}-
padding聊天列表项内边距String8px 10px-
customTitleStyle自定义聊天列表项标题样式UTSJSONObject{}-
customNoteStyle自定义聊天列表项副标题样式UTSJSONObject{}-
customAvatarStyle自定义聊天列表项头像样式UTSJSONObject{}-
customBadgeStyle自定义聊天列表项徽标样式UTSJSONObject{}-
customBodyStyle自定义聊天列表项主体内容样式UTSJSONObject{}-
customHeaderStyle自定义聊天列表项头部样式UTSJSONObject{}-
customFooterStyle自定义聊天列表项尾部样式UTSJSONObject{}-
customTimeStyle自定义聊天列表项时间文本样式UTSJSONObject{}-
customStyle自定义聊天列表项整体样式UTSJSONObject{}-

插槽

sn-list

名称说明
default此处放置 sn-list-itemsn-list-chat

sn-list-item

名称说明
default替换列表项主体内容,可以是任意组件
header替换列表项头部内容,可以是任意组件
footer替换列表项尾部内容,可以是任意组件

sn-list-chat

名称说明
default替换聊天列表项主体内容,可以是任意组件
header替换聊天列表项头部内容,可以是任意组件
footer替换聊天列表项尾部内容,可以是任意组件

使用 MIT 协议