更新记录

1.0.9(2023-04-20)

1、修复文档错误 2、修复组件命名错误

1.0.8(2022-07-29)

1.0.8(2022-07-29)

1、修复微信小程序中w-radio-picker默认值为undefind或null时,无法选中对应空选项问题 2、修复微信小程序中w-datetime-picker点击弹出picker报错问题 3、w-radio-picker添加value和options变化监听 4、w-checkbox-picker添加value和options变化监听 5、w-datetime-picker添加value变化监听 6、w-select-ro-input添加value和options变化监听 7、w-address-picker添加value和label变化监听

1.0.7(2022-06-01)

删除@update自定义事件,添加v-model语法糖

查看更多

平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 app-vue app-nvue
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

uview-ui-plus

基于uView2.0封装的组件库

说明

uview-ui-plus是基于uView2.0封装的组件库,在uView2.0的基础上,提供更加方便的模板组件,支持H5,APP,APP-NVUE,微信小程序等应用。

组件列表

注意

使用uview-ui-plus前,你必须先安装uView2.0框架,具体安装步骤请参考uView2.0文档

快速上手

1、从插件市场导入uview-ui-plus插件

2、pages.json配置easycom规则(按需引入)

// pages.json
{
    "easycom": {
        "^w-(.*)": "@/uni_modules/uview-ui-plus/components/w-$1/w-$1.vue"
    },
    // 此为本身已有的内容
    "pages": [
        // ......
    ]
}

使用方法

配置easycom规则后,自动按需引入,无需import组件,直接引用即可。

w-radio-picker

参数名 类型 默认值 说明
value String, Number "" 绑定的id值
options Array [{id: 1, name: "选项一"}] 选项列表数据
placeholder String "请选择" placeholder提示信息
readonly Boolean false 是否只读
allowNull Boolean true 是否显示暂不选择
inputAlign String right 文本对齐方式(left,center,right)
keyName String id options对应的key字段名
labelName String name options对应的label字段名
showSearch Boolean true 是否开启搜索功能
linkData String, Number null 需要通过其它下拉关联查询时,将关联数据的value赋值给linkData
linkDataTips String "请先选择关联查询数据" 需要关联的数据未选择时提示信息
@input 自定义事件 返回选择的value值
@change 自定义事件 返回选择的value和label值
<template>
    <!-- u-radio-picker为表单组件,结合u--form表单使用 -->
    <u--form labelWidth="100" labelPosition="left" :model="form" :rules="rules" ref="form">
        <u-form-item required label="用户名" prop="userId" borderBottom>
            <w-radio-picker v-model="form.userId" placeholder="请选择用户名" :options="optionsList" inputAlign="right" />
        </u-form-item>
    </u--form>
</template>

w-checkbox-picker

参数名 类型 默认值 说明
value String "" 绑定的value值,多个值用英文逗号隔开
options Array [{id: 1, name: "选项一"}] 选项列表数据
placeholder String "请选择" placeholder提示信息
readonly Boolean false 是否只读
allowNull Boolean true 是否显示暂不选择
inputAlign String right 文本对齐方式(left,center,right)
keyName String id options对应的key字段名
labelName String name options对应的label字段名
showSearch Boolean true 是否开启搜索功能
@input 自定义事件 返回选择的value值
@change 自定义事件 返回选择的value和label值
<template>
    <!-- u-checkbox-picker为表单组件,结合u--form表单使用 -->
    <u--form labelWidth="100" labelPosition="left" :model="form" :rules="rules" ref="form">
        <u-form-item required label="用户名" prop="userId" borderBottom>
            <w-checkbox-picker v-model="form.userId" placeholder="请选择用户名" :options="optionsList" inputAlign="right" />
        </u-form-item>
    </u--form>
</template>

w-datetime-picker

参数名 类型 默认值 说明
value String "" 绑定的日期值
placeholder String "请选择日期" placeholder提示信息
readonly Boolean false 是否只读
mode String datetime 模式(data: 日期,datetime: 日期时间)
inputAlign String right 文本对齐方式(left,center,right)
@input 自定义事件 返回选择的日期时间
@change 自定义事件 返回选择的日期时间
<template>
    <!-- w-datetime-picker为表单组件,结合u--form表单使用 -->
    <u--form labelWidth="100" labelPosition="left" :model="form" :rules="rules" ref="form">
        <u-form-item required label="开始时间" prop="beginDate" borderBottom>
            <w-datetime-picker v-model="form.beginDate" placeholder="请选择开始时间" mode="date" inputAlign="right" />
        </u-form-item>
    </u--form>
</template>

w-select-or-input

参数名 类型 默认值 说明
value String "" 绑定的value值
placeholder String "请选择日期" placeholder提示信息
readonly Boolean false 是否只读
options Array ["选项一"] 选项列表数据
inputAlign String right 文本对齐方式(left,center,right)
allowNull Boolean true 是否显示暂不选择
showSearch Boolean true 是否开启搜索功能
@input 自定义事件 返回选择的value值
@change 自定义事件 返回选择的value值
<template>
    <!-- w-select-or-input为表单组件,结合u--form表单使用 -->
    <u--form labelWidth="100" labelPosition="left" :model="form" :rules="rules" ref="form">
        <u-form-item required label="所属公司" prop="orgName" borderBottom>
            <w-select-or-input v-model="form.orgName" placeholder="请选择所属公司" :options="orgList" inputAlign="right" />
        </u-form-item>
    </u--form>
</template>

w-address-picker

参数名 类型 默认值 说明
value Array [] 绑定的地址编码值,例:["330000", "330100", "330103"]
value和label同时传入时,value的优先级高于label
label Array [] 绑定的地址文本值,例:["江西省", "宜春市", "万载县"]
value和label同时传入时,value的优先级高于label
placeholder String "请选择日期" placeholder提示信息
readonly Boolean false 是否只读
inputAlign String right 文本对齐方式(left,center,right)
@input 自定义事件 返回选择的地址编码值
@update:value 自定义事件 返回选择的地址编码值
@update:label 自定义事件 返回选择的地址文本值
@change 自定义事件 返回选择的地址编码值和文本值
<template>
    <!-- w-address-picker为表单组件,结合u--form表单使用 -->
    <u--form labelWidth="100" labelPosition="left" :model="form" :rules="rules" ref="form">
        <u-form-item required label="省市区" prop="address" borderBottom>
            <!-- 注意,v-model默认是value的双向绑定,此处也可使用:value和@update:value实现双向绑定 -->
            <w-address-picker :value="form.addressCode" @update:value="form.addressCode=$event" :value="form.addressLabel" @update:value="form.addressLabel=$event" placeholder="请选择所属省市区" inputAlign="right" />
        </u-form-item>
    </u--form>
</template>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问