## List 列表
> **组件名:uni-list**
> 代码块: `uList`、`uListItem`
> 关联组件:`uni-list-item`、`uni-badge`、`uni-icons`、`uni-list-chat`、`uni-list-ad`
List 列表组件,包含基本列表样式、可扩展插槽机制、长列表性能优化、多端兼容。
在vue页面里,它默认使用页面级滚动。在app-nvue页面里,它默认使用原生list组件滚动。这样的长列表,在滚动出屏幕外后,系统会回收不可见区域的渲染内存资源,不会造成滚动越长手机越卡的问题。
uni-list组件是父容器,里面的核心是uni-list-item子组件,它代表列表中的一个可重复行,子组件可以无限循环。
uni-list-item有很多风格,uni-list-item组件通过内置的属性,满足一些常用的场景。当内置属性不满足需求时,可以通过扩展插槽来自定义列表内容。
内置属性可以覆盖的场景包括:导航列表、设置列表、小图标列表、通信录列表、聊天记录列表。
涉及很多大图或丰富内容的列表,比如类今日头条的新闻列表、类淘宝的电商列表,需要通过扩展插槽实现。
下文均有样例给出。
uni-list不包含下拉刷新和上拉翻页。上拉翻页另见组件:[uni-load-more](https://ext.dcloud.net.cn/plugin?id=29)
### 安装方式
本组件符合[easycom](https://uniapp.dcloud.io/collocation/pages?id=easycom)规范,`HBuilderX 2.5.5`起,只需将本组件导入项目,在页面`template`中即可直接使用,无需在页面中`import`和注册`components`。
如需通过`npm`方式使用`uni-ui`组件,另见文档:[https://ext.dcloud.net.cn/plugin?id=55](https://ext.dcloud.net.cn/plugin?id=55)
> **注意事项**
> 为了避免错误使用,给大家带来不好的开发体验,请在使用组件前仔细阅读下面的注意事项,可以帮你避免一些错误。
> - 组件需要依赖 `sass` 插件 ,请自行手动安装
> - 组件内部依赖 `'uni-icons'` 、`uni-badge` 组件
> - `uni-list` 和 `uni-list-item` 需要配套使用,暂不支持单独使用 `uni-list-item`
> - 只有开启点击反馈后,会有点击选中效果
> - 使用插槽时,可以完全自定义内容
> - note 、rightText 属性暂时没做限制,不支持文字溢出隐藏,使用时应该控制长度显示或通过默认插槽自行扩展
> - 支付宝小程序平台需要在支付宝小程序开发者工具里开启 component2 编译模式,开启方式: 详情 --> 项目配置 --> 启用 component2 编译
> - 如果需要修改 `switch`、`badge` 样式,请使用插槽自定义
> - 在 `HBuilderX` 低版本中,可能会出现组件显示 `undefined` 的问题,请升级最新的 `HBuilderX` 或者 `cli`
> - 如使用过程中有任何问题,或者您对uni-ui有一些好的建议,欢迎加入 uni-ui 交流群:871950839
### 基本用法
- 设置 `title` 属性,可以显示列表标题
- 设置 `disabled` 属性,可以禁用当前项
```html
<uni-list>
<uni-list-item title="列表文字" ></uni-list-item>
<uni-list-item :disabled="true" title="列表禁用状态" ></uni-list-item>
</uni-list>
```
### 多行内容显示
- 设置 `note` 属性 ,可以在第二行显示描述文本信息
```html
<uni-list>
<uni-list-item title="列表文字" note="列表描述信息"></uni-list-item>
<uni-list-item :disabled="true" title="列表文字" note="列表禁用状态"></uni-list-item>
</uni-list>
```
### 右侧显示角标、switch
- 设置 `show-badge` 属性 ,可以显示角标内容
- 设置 `show-switch` 属性,可以显示 switch 开关
```html
<uni-list>
<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>
</uni-list>
```
### 左侧显示略缩图、图标
- 设置 `thumb` 属性 ,可以在列表左侧显示略缩图
- 设置 `show-extra-icon` 属性,并指定 `extra-icon` 可以在左侧显示图标
```html
<uni-list>
<uni-list-item title="列表左侧带略缩图" note="列表描述信息" thumb="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png"
thumb-size="lg" rightText="右侧文字"></uni-list-item>
<uni-list-item :show-extra-icon="true" :extra-icon="extraIcon1" title="列表左侧带扩展图标" ></uni-list-item>
</uni-list>
```
### 开启点击反馈和右侧箭头
- 设置 `clickable` 为 `true` ,则表示这是一个可点击的列表,会默认给一个点击效果,并可以监听 `click` 事件
- 设置 `link` 属性,会自动开启点击反馈,并给列表右侧添加一个箭头
- 设置 `to` 属性,可以跳转页面,`link` 的值表示跳转方式,如果不指定,默认为 `navigateTo`
```html
<uni-list>
<uni-list-item title="开启点击反馈" clickable @click="onClick" ></uni-list-item>
<uni-list-item title="默认 navigateTo 方式跳转页面" link to="/pages/vue/index/index" @click="onClick($event,1)" ></uni-list-item>
<uni-list-item title="reLaunch 方式跳转页面" link="reLaunch" to="/pages/vue/index/index" @click="onClick($event,1)" ></uni-list-item>
</uni-list>
```
### 聊天列表示例
- 设置 `clickable` 为 `true` ,则表示这是一个可点击的列表,会默认给一个点击效果,并可以监听 `click` 事件
- 设置 `link` 属性,会自动开启点击反馈,`link` 的值表示跳转方式,如果不指定,默认为 `navigateTo`
- 设置 `to` 属性,可以跳转页面
- `time` 属性,通常会设置成时间显示,但是这个属性不仅仅可以设置时间,你可以传入任何文本,注意文本长度可能会影响显示
- `avatar` 和 `avatarList` 属性同时只会有一个生效,同时设置的话,`avatarList` 属性的长度大于1 ,`avatar` 属性将失效
- 可以通过默认插槽自定义列表右侧内容
```html
<uni-list>
<uni-list :border="true">
<!-- 显示圆形头像 -->
<uni-list-chat :avatar-circle="true" title="uni-app" avatar="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png" note="您收到一条新的消息" time="2020-02-02 20:20" ></uni-list-chat>
<!-- 右侧带角标 -->
<uni-list-chat title="uni-app" avatar="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png" note="您收到一条新的消息" time="2020-02-02 20:20" badge-text="12" :badge-style="{backgroundColor:'#FF80AB'}"></uni-list-chat>
<!-- 头像显示圆点 -->
<uni-list-chat title="uni-app" avatar="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png" note="您收到一条新的消息" time="2020-02-02 20:20" badge-positon="left" badge-text="dot"></uni-list-chat>
<!-- 头像显示角标 -->
<uni-list-chat title="uni-app" avatar="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png" note="您收到一条新的消息" time="2020-02-02 20:20" badge-positon="left" badge-text="99"></uni-list-chat>
<!-- 显示多头像 -->
<uni-list-chat title="uni-app" :avatar-list="avatarList" note="您收到一条新的消息" time="2020-02-02 20:20" badge-positon="left" badge-text="dot"></uni-list-chat>
<!-- 自定义右侧内容 -->
<uni-list-chat title="uni-app" :avatar-list="avatarList" note="您收到一条新的消息" time="2020-02-02 20:20" badge-positon="left" badge-text="dot">
<view class="chat-custom-right">
<text class="chat-custom-text">刚刚</text>
<!-- 需要使用 uni-icons 请自行引入 -->
<uni-icons type="star-filled" color="#999" size="18"></uni-icons>
</view>
</uni-list-chat>
</uni-list>
</uni-list>
```
```javascript
export default {
components: {},
data() {
return {
avatarList: [{
url: 'https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png'
},
没有合适的资源?快使用搜索试试~ 我知道了~
温馨提示
RuoYi-Vue 全新 Pro 版本,优化重构所有功能。基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 微信小程序,支持 RBAC 动态权限、数据权限、SaaS 多租户、Flowable 工作流、三方登录、支付、短信、商城等功能。
资源推荐
资源详情
资源评论
收起资源包目录
基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 微信小程序 (3760个子文件)
package.bat 153B
build.bat 109B
run-web.bat 99B
com.xingyuv.captcha.service.CaptchaCacheService 72B
lombok.config 126B
editor.main.css 68KB
colorui.css 63KB
uniicons.css 8KB
iconfont.css 1KB
w-picker.css 381B
area.csv 96KB
.env.dev 447B
Dockerfile 696B
.editorconfig 514B
.editorconfig 514B
.eslintignore 299B
spring.factories 131B
.env.front 462B
401.gif 5KB
.gitattributes 29B
.gitignore 702B
.gitignore 272B
.gitignore 246B
.gitignore 106B
ie.html 23KB
index.html 5KB
index.html 5KB
index.html 4KB
pay_wx_pub.html 4KB
login.html 2KB
callback.html 2KB
index.html 935B
index.html 672B
OAuth2OpenController.http 2KB
MpDraftController.http 2KB
AppAddressController.http 1KB
FileConfigController.http 1KB
AppAuthController.http 1KB
TradeCartController.http 1KB
AppTradeOrderController.http 1KB
MpMenuController.http 1KB
MpTagController.http 966B
RoleController.http 939B
MpMessageController.http 931B
AuthController.http 798B
OAuth2ClientController.http 655B
TenantController.http 557B
MpFreePublishController.http 486B
AppUserController.http 486B
MpUserController.http 435B
TestDemoController.http 422B
OAuth2UserController.http 422B
MailTemplateController.http 335B
SmsTemplateController.http 323B
RedisController.http 321B
TradeOrderController.http 300B
BpmOALeaveController.http 275B
AppProductSpuController.http 251B
ErrorCodeController.http 227B
SensitiveWordController.http 211B
AppPayOrderController.http 208B
MpMaterialController.http 207B
MpAutoReplyController.http 205B
UserController.http 167B
UserProfileController.http 160B
TradeAfterSaleController.http 159B
OperateLogController.http 154B
DictDataController.http 149B
ProductSpuController.http 133B
MenuController.http 133B
AreaController.http 115B
AppWxMpController.http 80B
favicon.ico 17KB
favicon.ico 6KB
org.springframework.boot.autoconfigure.AutoConfiguration.imports 416B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 175B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 150B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 149B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 140B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 139B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 138B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 135B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 77B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 75B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 71B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 69B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 69B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 69B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 69B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 67B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 65B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 65B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 63B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 63B
org.springframework.boot.autoconfigure.AutoConfiguration.imports 61B
PriceServiceTest.java 30KB
AdminUserServiceImplTest.java 29KB
PriceServiceImpl.java 28KB
DataPermissionDatabaseInterceptorTest2.java 25KB
DataPermissionDatabaseInterceptor.java 24KB
共 3760 条
- 1
- 2
- 3
- 4
- 5
- 6
- 38
资源评论
- ywywcy20122023-10-02感谢资源主分享的资源解决了我当下的问题,非常有用的资源。
- Sunshine0208292024-04-07总算找到了想要的资源,搞定遇到的大问题,赞赞赞!
- m0_729442052023-05-15资源内容总结的很到位,内容详实,很受用,学到了~
- jmpt88882023-05-15非常有用的资源,可以直接使用,对我很有用,果断支持!
- esunny2023-10-07这个资源值得下载,资源内容详细全面,与描述一致,受益匪浅。
Java程序员-张凯
- 粉丝: 1w+
- 资源: 6650
下载权益
C知道特权
VIP文章
课程特权
开通VIP
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功