滑动选择器组件,类型支持普通选择器、日期选择器、时间选择器、时间日期选择器和多列文本选择器。
| 手机 | 平板 | 智慧屏 | 智能穿戴 |
|---|---|---|---|
| 支持 | 支持 | 支持 | 不支持 |
不支持。
除支持通用属性外,还支持如下属性:↵
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| type | string | - | 否 | 该属性值不支持动态修改。可选择项有:
|
滑动选择器类型设置为text时表示普通选择器。
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| range | Array | - | 否 | 设置普通选择器的取值范围,如["15", "20", "25"]。
|
| selected | string | 0 | 否 | 设置普通选择器弹窗的默认取值,取值需要是 range 的索引值,该取值表示选择器弹窗界面的默认选择值。 |
| value | string | - | 否 | 设置普通选择器的值。 |
| vibrate7+ | boolean | true | 否 | 用于设置当picker滑动时是否有振动效果。
|
滑动选择器类型设置为date时表示日期选择器。
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| start | <time> | 1970-1-1 | 否 | 设置日期选择器的起始时间,格式为 YYYY-MM-DD。 |
| end | <time> | 2100-12-31 | 否 | 设置日期选择器的结束时间,格式为 YYYY-MM-DD。 |
| selected | string | 当前日期 | 否 | 设置日期选择器弹窗的默认取值,格式为 YYYY-MM-DD,该取值表示选择器弹窗界面的默认选择值。 |
| value | string | - | 是 | 设置日期选择器的值。 |
| lunar5+ | boolean | false | 否 | 设置日期选择器弹窗界面是否为农历展示。 |
| lunarswitch | boolean | false | 否 | 设置日期选择器是否显示农历开关。当值为true时,显示农历开关,点击农历开关可切换公历和农历。当值为false时,不显示农历开关。
|
| vibrate7+ | boolean | true | 否 | 用于设置当picker滑动时是否有振动效果。
|
滑动选择器类型设置为time时表示时间选择器。
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| containsecond | boolean | false | 否 | 设置时间选择器是否包含秒。 |
| selected | string | 当前时间 | 否 | 设置时间选择器弹窗的默认取值,格式为 HH:mm;当包含秒时,格式为HH:mm:ss, 该取值表示选择器弹窗界面的默认选择值。 |
| value | string | - | 否 | 设置时间选择器的值。 |
| hours | number | 241-4 -5+ | 否 | 设置时间选择器采用的时间格式,可选值:
|
| vibrate7+ | boolean | true | 否 | 用于设置当picker滑动时是否有振动效果。
|
滑动选择器类型设置为datetime时表示日期时间选择器,日期的选择范围为本年的日月。
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| selected | string | 当前日期时间 | 否 | 设置日期时间选择器弹窗的默认取值,有两种可选格式。
不设置年时,默认使用当前年,该取值表示选择器弹窗界面的默认选择值。 |
| value | string | - | 是 | 设置日期时间选择器的值。 |
| hours | number | 241-4 -5+ | 否 | 设置日期时间选择器采用的时间格式,可选值:
|
| lunar5+ | boolean | false | 否 | 设置日期时间选择器弹窗界面是否为农历展示。 |
| lunarswitch | boolean | false | 否 | 设置日期选择器是否显示农历开关。当值为true时,显示农历开关,点击农历开关可切换公历和农历。当值为false时,不显示农历开关。
|
| vibrate7+ | boolean | true | 否 | 用于设置当picker滑动时是否有振动效果。
|
滑动选择器类型设置为multi-text时表示多列文本选择器。
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| columns | number | - | 是 | 设置多列文本选择器的列数。 |
| range | 二维Array | - | 否 | 设置多列文本选择器的选择项,其中range 为二维数组。长度表示多少列,数组的每项表示每列的数据,如 [["a","b"], ["c","d"]]。
|
| selected | Array | [0,0,0,…] | 否 | 设置多列文本选择器弹窗的默认值,每一列被选中项对应的索引构成的数组,该取值表示选择器弹窗界面的默认选择值。 |
| value | Array | - | 否 | 设置多列文本选择器的值,每一列被选中项对应的值构成的数组。 |
| vibrate7+ | boolean | true | 否 | 用于设置当picker滑动时是否有振动效果。
|
除支持通用样式外,还支持如下样式:
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| text-color | <color> | - | 否 | 选择器的文本颜色。 |
| font-size | <length> | - | 否 | 选择器的文本尺寸。 |
| allow-scale | boolean | true | 否 | 选择器的文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。 说明 如果在config描述文件中针对ability配置了fontSize的config-changes标签,则应用不会重启而直接生效。 |
| letter-spacing | <length> | 0 | 否 | 选择器的字符间距。见text组件的letter-spacing样式属性。 |
| text-decoration | string | - | 否 | 选择器的文本修饰。见text组件的text-decoration样式属性。 |
| font-style | string | normal | 否 | 选择器的字体样式。见text组件的font-style样式属性。 |
| font-weight | number | string | normal | 否 | 选择器的字体粗细。见text组件的font-weight样式属性。 |
| font-family | string | sans-serif | 否 | 选择器的字体列表,用逗号分隔,每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过自定义字体指定的字体,会被选中作为文本的字体。 |
| line-height | <length> | 0px | 否 | 选择器的文本行高。 |
| column-height5+ | <length> | - | 否 | 选择器的选择项列表高度。 说明 仅手机和平板设备支持。 |
除支持通用事件外,还支持如下事件:
| 名称 | 参数 | 描述 |
|---|---|---|
| change | { newValue: newValue, newSelected: newSelected } | 普通选择器选择值后点击弹窗中的确定按钮时触发该事件(newSelected为索引)。 |
| cancel | - | 用户点击弹窗中的取消按钮时触发该事件。 |
| 名称 | 参数 | 描述 |
|---|---|---|
| change | { year: year, month: month, day: day } | 日期选择器选择值后点击弹窗中的确认按钮时触发该事件。 说明 month值范围为: 0(1月)~11(12月)。5+ |
| cancel | - | 用户点击弹窗中的取消按钮时触发该事件。 |
| 名称 | 参数 | 描述 |
|---|---|---|
| change | { year: year, month: month, day: day, hour: hour, minute: minute} | 日期时间选择器选择值后点击弹窗中的确认按钮时触发该事件。 |
| cancel | - | 用户点击弹窗中的取消按钮时触发该事件。 |
| 名称 | 参数 | 描述 |
|---|---|---|
| change | { hour: hour, minute: minute, [second: second] } | 时间选择器选择值后点击弹窗中的确认按钮时触发该事件,当使用时分秒时,还包含秒数据。 |
| cancel | - | 用户点击弹窗中的取消按钮时触发该事件。 |
| 名称 | 参数 | 描述 |
|---|---|---|
| change | { newValue: [newValue1, newValue2, newValue3, …], newSelected:[newSelected1, newSelected2, newSelected3, …] } | 多列文本选择器选择值后点击弹窗中的确认按钮时触发该事件,其中:
|
| columnchange | { column: column, newValue: newValue, newSelected: newSelected } | 多列文本选择器中某一列的值改变时触发该事件,其中:
|
| cancel | - | 用户点击弹窗中的取消按钮时触发该事件。 |
除支持通用方法外,支持如下方法:
| 名称 | 参数 | 描述 |
|---|---|---|
| show | - | 显示 picker。 |
| rotation | 组件请求或者取消旋转表冠焦点,该方法参数可缺省,缺省时默认请求旋转表冠焦点。 说明 旋转表冠为穿戴设备特有硬件,用户可以通过旋转电源键来进行页面交互。 |
| 属性 | 类型 | 说明 |
|---|---|---|
| focus | boolean | focus为true时,表示请求焦点,focus为false时,表示取消焦点。 |
- <div class="container">
- <select @change="selectChange">
- <option value="{{ item }}" for="item in selectList">
- {{ item }}<!---->
- </option>
- </select>
- <picker id="picker0" type="text" value="{{textvalue}}" selected="{{textselect}}" range="{{rangetext}}" onchange="textonchange"
- oncancel="textoncancel" class="pickertext" "></picker>
- <!--text:文本选择器。
- range设置普通选择器的取值范围
- selected设置普通选择器弹窗的默认取值,取值需要是 range 的索引值
- onchange和oncancel变化的同时改变变量-->
- <picker id="picker1" type="date" value="{{datevalue}}" start="2002-2-5" end="2030-6-5" selected="{{dateselect}}" lunarswitch="true"
- onchange="dateonchange" oncancel="dateoncancel" class="pickerdate" show="false"></picker>
- <!--date:日期选择器。
- start设置日期选择器的起始时间,格式为 YYYY-MM-DD。
- end设置日期选择器的结束时间,格式为 YYYY-MM-DD。
- selected设置选择器弹窗的默认取值
- value设置日期选择器的值。
- lunar设置日期选择器弹窗界面是否为农历展示。
- lunarswitch设置日期选择器是否显示农历开关。当值为true时,显示农历开关,点击农历开关可切换公历和农历。
- vibrate设置当picker滑动时是否有振动效果
- -->
- <picker id="picker2" type="time" value="{{timevalue}}" containsecond="{{containsecond}}" selected="{{timeselect}}" hours="12"
- onchange="timeonchange" oncancel="timeoncancel" class="pickertime" show="false"></picker>
- <!--time:时间选择器
- containsecond设置时间选择器是否包含秒
- selected设置选择器弹窗的默认取值
- hours设置时间选择器采用的时间格式是12小时制还是24小时
- onchange和oncancel变化的同时改变变量
- -->
- <picker id="picker3" type="datetime" value="{{datetimevalue}}" selected="{{datetimeselect}}" hours="24" lunarswitch="true"
- onchange="datetimeonchange" oncancel="datetimeoncancel" class="pickerdatetime" show="false"></picker>
- <!--datetime:日期时间选择器。
- 设置日期时间选择器弹窗的默认取值,有两种可选格式。
- 月日时分:MM-DD-HH-mm
- 年月日时分:YYYY-MM-DD-HH-mm
- 不设置年时,默认使用当前年,该取值表示选择器弹窗界面的默认选择值。-->
- <picker id="picker4" type="multi-text" value="{{multitextvalue}}" columns="3" range="{{multitext}}" selected="{{multitextselect}}"
- onchange="multitextonchange" oncancel="multitextoncancel" class="pickermuitl" show="false"></picker>
- <!--multi-text:多列文本选择器。
- columns设置多列文本选择器的列数
- range设置多列文本选择器的选择项,其中range 为二维数组。
- 长度表示多少列,数组的每项表示每列的数据,
- 如 [["a","b"], ["c","d"]]。
- -->
- </div>
- .container {
- flex-direction: column;
- justify-content: center;
- align-items: center;
- }
- picker{
- width:60%;
- height:80px;
- border-radius:20px;
- text-color:white;
- font-size:15px;
- background-color:#4747e3;
- margin-left:20%;
- }
- select{
- background-color: #efecec;
- height: 50px;
- width: 60%;
- margin-left: 20%;
- margin-top: 300px;
- margin-bottom: 50px;
- font-size: 22px;
- }
- import router from '@system.router';
- import prompt from '@system.prompt';
- export default {
- data: {//储存前端所需数据
- selectList:["text","data","time","datetime","multitext"],
- rangetext:['15', "20", "25"],
- multitext:[["a", "b", "c"], ["e", "f", "g"], ["h", "i"], ["k", "l", "m"]],
- textvalue:'default textvalue',
- datevalue:'default datevalue',
- timevalue:'default timevalue',
- datetimevalue:'default datetimevalue',
- multitextvalue:'default multitextvalue',
- containsecond:true,
- multitextselect:[1,2,0],
- datetimeselect:'2012-5-6-11-25',
- timeselect:'11:22:30',
- dateselect:'2021-3-2',
- textselect:'2'
- },
- selectChange(e){
- for(let i = 0;i<this.selectList.length;i++){
- if(e.newValue == this.selectList[i]){
- this.$element("picker"+i).show();//表示显示的选择器id对应的框
- }
- }
- },
- textonchange(e) {//显示的数据与格式,随着onchange可变化
- this.textvalue = e.newValue;
- prompt.showToast({ message:"text:"+e.newValue+",newSelected:"+e.newSelected })
- },
- textoncancel(e) {//显示的数据与格式,随着onchange可变化
- prompt.showToast({ message:"text: textoncancel" })
- },
- dateonchange(e) {//显示的数据与格式,随着onchange可变化
- this.datevalue = e.year + "-" + e.month + "-" + e.day;
- prompt.showToast({ message:"date:"+e.year+"-"+(e.month+1)+"-"+e.day })
- },
- dateoncancel() {//显示的数据与格式,随着onchange可变化
- prompt.showToast({ message:"date: dateoncancel" })
- },
- timeonchange(e) {//显示的数据与格式,随着onchange可变化
- if(this.containsecond){
- this.timevalue=e.hour+":"+e.minute+":"+e.second;
- prompt.showToast({ message:"Time:" + e.hour + ":" + e.minute + ":" + e.second })
- } else {//显示的数据与格式,随着onchange可变化
- this.timevalue=e.hour+":"+e.minute;
- prompt.showToast({ message:"Time:" + e.hour + ":" + e.minute })
- }},
- timeoncancel() {//显示的数据与格式,随着onchange可变化
- prompt.showToast({ message:"timeoncancel" })
- },
- datetimeonchange(e) {//显示的数据与格式,随着onchange可变化
- this.datetimevalue=e.year+"-"+e.month+"-"+e.day+" "+e.hour+":"+e.minute;
- prompt.showToast({ message:"Time:"+(e.month+1)+"-"+e.day+" "+e.hour+":"+e.minute })
- },
- datetimeoncancel() {//显示的数据与格式,随着onchange可变化
- prompt.showToast({ message:"datetimeoncancel" })
- },
- multitextonchange(e) {//显示的数据与格式,随着onchange可变化
- this.multitextvalue=e.newValue;
- prompt.showToast({ message:"Multi-column text change" + e.newValue })
- },
- multitextoncancel() {//显示的数据与格式,随着onchange可变化
- prompt.showToast({ message:"multitextoncancel" })
- },
- popup_picker() {//显示的数据与格式,随着onchange可变化
- this.$element("picker_text").show();
- },
- }
