WxP UI 是一款提供高交互小程序插件的合集, 致力于简洁和高可用性的插件实现.
使用前请认真阅读文档和示例项目
该小程序所有组件都是基于微信小程序原生api编写的, 旨在提供最简明扼要的实现思路, 所以如果用了第三方框架会增加学习成本. 当然这也造成所有组件只有微信端实现的问题, 不过聪明的你看了这些实现后肯定可以举一反三, 实现其他端的展现.
![WxP](https://camo.githubusercontent.com/ec9b0b3ca98d1ed5375dba0ef556c3f31a5ef0e80b738d56fc6bfac0bfa21138/687474703a2f2f3134382e37302e3139352e39352f646973742f7172636f64652e6a706567)
+我微信 a1003367083 拉你进群, 加的时候请备注: WxP UI. 您的 star 是我前进的动力~~.
- swipe-list组件
- scroll组件
- tab组件
- drag组件
- date-picker组件
- side-slip组件(基于movable-view实现)
- index-list组件
drag组件实现分析
swipe-list组件实现分析
date-picker组件实现分析
git clone https://github.com/singletouch/wx-plugin.git
将需要使用的组件代码拷至自己的小程序项目中,按照小程序官方引入组件方式引入即可
本项目自身就是一个完整的小程序项目,也可以直接使用本项目作为小程序开发目录
参数 |
说明 |
类型 |
可选值 |
默认值 |
requesting |
列表数据是否处于加载中 |
Boolean |
-- |
false |
end |
列表数据加载完成 |
Boolean |
-- |
false |
emptyShow |
控制空状态显示 |
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 |
-- |
"" |
enableBackToTop |
双击顶部状态栏回到顶部 |
Boolean |
-- |
false |
事件名称 |
说明 |
回调参数 |
refresh |
下拉刷新 |
-- |
more |
上拉加载 |
-- |
参数 |
说明 |
类型 |
可选值 |
默认值 |
tabData |
数据源 |
Array |
-- |
[] |
tabCur |
当前聚焦项索引 |
Number |
-- |
0 |
scroll |
是否可以超出滚动 |
Boolean |
-- |
false |
size |
tab高度 |
Number |
-- |
90 |
color |
颜色 |
String |
-- |
"" |
事件名称 |
说明 |
回调参数 |
change |
tab切换事件 |
当前选中tab的index |
方法名 |
说明 |
回调参数 |
scrollByIndex |
让tab组件根据传入的index进行滚动 |
需要切换tab项的index |
后续更新
方法名 |
说明 |
回调参数 |
delete |
点击删除按钮触发的事件 |
-- |
参数 |
说明 |
类型 |
可选值 |
默认值 |
listData |
数据源 |
Array |
-- |
[] |
topSize |
顶部固定区域高度 |
Number |
-- |
0(rpx) |
bottomSize |
底部固定区域高度 |
Number |
-- |
0(rpx) |
color |
颜色 |
String |
-- |
"" |
emptyUrl |
空列表的展示图片 |
String |
* |
/assets/image/empty/empty.png |
emptyText |
空列表的文字提示 |
String |
* |
未找到数据 |
emptyShow |
控制空状态显示 |
Boolean |
-- |
false |
参数 |
说明 |
类型 |
可选值 |
默认值 |
key |
索引值 |
String |
-- |
-- |
data |
索引值对应数据 |
Array |
... |
... |
数据结构演示, 如需更多数据结构和渲染样式, 需自行修改渲染和初始化部分代码.
[
{
key: "A",
data: [
{
name: "城市1",
code: "0001",
short: "city1"
},
{
name: "城市2",
code: "0002",
short: "city2"
},
...
]
},
{
key: "B",
data: [
{
name: "城市1",
code: "0001",
short: "city1"
},
{
name: "城市2",
code: "0002",
short: "city2"
},
...
]
},
{
key: "C",
data: [
{
name: "城市1",
code: "0001",
short: "city1"
},
{
name: "城市2",
code: "0002",
short: "city2"
},
...
]
}
...
]
事件名称 |
说明 |
回调参数 |
click |
点击item |
当前item的数据信息 |
tip: 最新新增 topSize 和 bottomSize 以应对有顶部和底部有固定区域时的入参, 这两个参数可以保证数据较多时候拖拽到顶部和底部时页面能正确滚动.
参数 |
说明 |
类型 |
可选值 |
默认值 |
listData |
数据源 |
Array |
-- |
[] |
columns |
列数 |
Number |
-- |
1 |
topSize |
顶部固定区域高度 |
Number |
-- |
0(rpx) |
bottomSize |
底部固定区域高度 |
Number |
-- |
0(rpx) |
事件名称 |
说明 |
回调参数 |
change |
排序监听事件 |
排序后数据 |
click |
点击item监听 |
item数据和排序key值 |
参数 |
说明 |
类型 |
可选值 |
默认值 |
fixed |
是否固定该项 |
Boolean |
-- |
-- |
... |
... |
... |
... |
... |
如果有什么好的建议欢迎提issues
MIT