WxP UI 是一款提供高交互小程序插件的合集, 致力于简洁和高可用性的插件实现.
该小程序所有组件都是基于微信小程序原生api编写的, 旨在提供最简明扼要的实现思路, 所以如果用了第三方框架会增加学习成本. 当然这也造成所有组件只有微信端实现的问题, 不过聪明的你看了这些实现后肯定可以举一反三, 实现其他端的展现
- swipe-list组件
- scroll组件
- tab组件
- drag组件
- date-picker组件
- side-slip组件(基于movable-view实现)
- index-list组件
git clone https://github.com/singletouch/wx-plugin.git
将需要使用的组件代码拷至自己的小程序项目中，按照小程序官方引入组件方式引入即可
本项目自身就是一个完整的小程序项目，也可以直接使用本项目作为小程序开发目录
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| requesting | 列表数据是否处于加载中 | Boolean | -- | false |
| end | 列表数据加载完成 | Boolean | -- | false |
| listCount | 当前列表长度 | Number | -- | 0 |
| emptyUrl | 空列表的展示图片 | String | * | /assets/image/empty/empty.png |
| emptyText | 空列表的文字提示 | String | * | 未找到数据 |
| hasTop | 是否有header | Boolean | -- | false |
| refreshSize | 下拉刷新的高度 | Number | -- | 90 |
| bottomSize | 底部高度 | Number | -- | 0 |
| color | 颜色 | String | -- | "" |
| 事件名称 | 说明 | 回调参数 |
|---|---|---|
| refresh | 下拉刷新 | -- |
| more | 上拉加载 | -- |
| name | 说明 |
|---|---|
| -- | 列表组件主体 |
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| scroll | 是否可以超出滚动 | Boolean | -- | false |
| tabData | 数据源 | Array | -- | [] |
| size | tab高度 | Number | -- | 90 |
| color | 颜色 | String | -- | "" |
| 事件名称 | 说明 | 回调参数 |
|---|---|---|
| change | tab切换事件 | 当前选中tab的index |
| 方法名 | 说明 | 回调参数 |
|---|---|---|
| scrollByIndex | 让tab组件根据传入的index进行滚动 | 需要切换tab项的index |
后续更新
| 方法名 | 说明 | 回调参数 |
|---|---|---|
| delete | 点击删除按钮触发的事件 | -- |
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| listData | 数据源 | Array | -- | [] |
| color | 颜色 | String | -- | "" |
tip: 最新新增 topSize 和 bottomSize 以应对有顶部和底部有固定区域时的入参, 这两个参数可以保证数据较多时候拖拽到顶部和底部时页面能正确滚动.
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| listData | 数据源 | Array | -- | [] |
| columns | 列数 | Number | -- | 1 |
| topSize | 顶部固定区域高度 | Number | -- | 0(rpx) |
| bottomSize | 底部固定区域高度 | Number | -- | 0(rpx) |
| 事件名称 | 说明 | 回调参数 |
|---|---|---|
| change | 排序监听事件 | 排序后数据 |
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| fixed | 是否固定该项 | Boolean | -- | -- |
| ... | ... | ... | ... | ... |
如果有什么好的建议欢迎提issues
MIT