更新记录
1.0.2(2024-03-19) 下载此版本
- 修复优化可能发生的问题
1.0.1(2023-08-31) 下载此版本
1.0.0(2023-08-22) 下载此版本
- 第一滴血~
平台兼容性
uni-app
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | - | - | - |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | - | √ | √ | √ | √ |
其他
| 多语言 | 暗黑模式 | 宽屏模式 |
|---|---|---|
| × | × | √ |
下拉框选择器
组件名:sx-select
基于原生内置组件picker进行了封装,使用原生组件渲染快、性能好,由于原生组件使用比较繁琐
故稍微做了下改造封装,没有任何修改,纯官方原汁原味原生picker
安装方式
本组件符合easycom规范,HBuilderX 2.5.5起,只需将本组件导入项目,在页面template中即可直接使用,无需在页面中import和注册components。
基本用法
- 设置
title属性,可以设置默认选择名称 - 设置
value属性,为默认选择项,可使用v-model进行双向绑定 - 设置
items属性,为选项列表,格式为json数组 - 设置
itemText属性,设置items属性的文本值 - 设置
itemVlue属性,设置items属性的属性 - 设置
className属性,为默认标题设置自定义class名称
<sx-select v-model="model" :items="[{title:'男',value:1},{title:'女',value:2}]" />
自定义插槽
- 自定义插槽基本上可以在页面任意地方进行使用
- 示例1使用了官方的uni-ui组件中的uni-list和uni-list-item进行组合
示例1
<uni-list>
<sx-select v-model="model" :items="sexItems">
<template slot-scope="{title}">
<uni-list-item title="性别" show-arrow :right-text="title" />
</template>
</sx-select>
<sx-select v-model="job" :items="jobItems" title="">
<template slot-scope="{title}">
<uni-list-item title="职业" show-arrow :right-text="title" />
</template>
</sx-select>
</uni-list>
示例2
- 结合了官方UI库uni-icon使用
<sx-select v-model="model" :items="cityItems" title="选择城市">
<template slot-scope="{title}">
<text style="font-size: 14px;">{{title}}</text>
<uni-icons type="bottom"></uni-icons>
</template>
</sx-select>
API
Props
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| value | Any | - | 默认值 |
| items | Array | [] | 对象数组格式,选项列表值 |
| itemText | String | text | 设置items属性的文本值 |
| itemValue | String | text | 设置items属性的属性值 |
| title | String | 请选择 | 默认标题显示内容 |
| className | String | - | 为标题设置默认class名称设置样式 |
Events
| 事件称名 | 说明 | 返回参数 |
|---|---|---|
| change | 当点击完成选择时发出 | - |
名人语录
人的心只容得下一定程度的绝望,海绵已经吸够了水,即使大海从它上面流过,也不能再给它增添一滴水了。——雨果(法国)

收藏人数:
https://github.com/yuxianwen/sx-select
下载插件并导入HBuilderX
下载示例项目ZIP
赞赏(0)
下载 655
赞赏 0
下载 11032301
赞赏 1800
赞赏
京公网安备:11010802035340号