• 5.27 picker组件


    picker

    picker

    滑动选择器组件,类型支持普通选择器、日期选择器、时间选择器、时间日期选择器和多列文本选择器。

    支持设备

    手机

    平板

    智慧屏

    智能穿戴

    支持

    支持

    支持

    不支持

    子组件

    不支持。

    属性

    除支持通用属性外,还支持如下属性:↵

    名称

    类型

    默认值

    必填

    描述

    type

    string

    -

    该属性值不支持动态修改。可选择项有:

    • text:文本选择器。
    • date:日期选择器。
    • time:时间选择器。
    • datetime:日期时间选择器。
    • multi-text:多列文本选择器。

    普通选择器

    滑动选择器类型设置为text时表示普通选择器。

    名称

    类型

    默认值

    必填

    描述

    range

    Array

    -

    设置普通选择器的取值范围,如["15", "20", "25"]。

    说明

    使用时需要使用数据绑定的方式,如range = {{data}},js中声明相应变量:data:["15", "20", "25"]。

    selected

    string

    0

    设置普通选择器弹窗的默认取值,取值需要是 range 的索引值,该取值表示选择器弹窗界面的默认选择值。

    value

    string

    -

    设置普通选择器的值。

    vibrate7+

    boolean

    true

    用于设置当picker滑动时是否有振动效果。

    • true:滑动时有振动效果。
    • false:滑动时无振动效果。

    说明

    智慧屏不支持。

    日期选择器

    滑动选择器类型设置为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时,不显示农历开关。

    说明

    仅手机和平板设备支持。 当lunarswitch=true且lunar=true时,开关按钮处于被选中状态。

    vibrate7+

    boolean

    true

    用于设置当picker滑动时是否有振动效果。

    • true:滑动时有振动效果。
    • false:滑动时无振动效果。

    说明

    智慧屏不支持。

    时间选择器

    滑动选择器类型设置为time时表示时间选择器。

    名称

    类型

    默认值

    必填

    描述

    containsecond

    boolean

    false

    设置时间选择器是否包含秒。

    selected

    string

    当前时间

    设置时间选择器弹窗的默认取值,格式为 HH:mm;当包含秒时,格式为HH:mm:ss,

    该取值表示选择器弹窗界面的默认选择值。

    value

    string

    -

    设置时间选择器的值。

    hours

    number

    241-4

    -5+

    设置时间选择器采用的时间格式,可选值:

    • 12:按照12小时制显示,用上午和下午进行区分;
    • 24:按照24小时制显示。

      说明

      默认值会依据系统当前所选地区和语言选择当地习惯的小时制(12小时制或24小时制)。5+

    vibrate7+

    boolean

    true

    用于设置当picker滑动时是否有振动效果。

    • true:滑动时有振动效果。
    • false:滑动时无振动效果。

    说明

    智慧屏不支持。

    日期时间选择器

    滑动选择器类型设置为datetime时表示日期时间选择器,日期的选择范围为本年的日月。

    名称

    类型

    默认值

    必填

    描述

    selected

    string

    当前日期时间

    设置日期时间选择器弹窗的默认取值,有两种可选格式。

    • 月日时分:MM-DD-HH-mm
    • 年月日时分:YYYY-MM-DD-HH-mm

    不设置年时,默认使用当前年,该取值表示选择器弹窗界面的默认选择值。

    value

    string

    -

    设置日期时间选择器的值。

    hours

    number

    241-4

    -5+

    设置日期时间选择器采用的时间格式,可选值:

    • 12:按照12小时制显示,用上午和下午进行区分;
    • 24:按照24小时制显示。

      说明

      默认值会依据系统当前所选地区和语言选择当地习惯的小时制(12小时制或24小时制)。5+

    lunar5+

    boolean

    false

    设置日期时间选择器弹窗界面是否为农历展示。

    lunarswitch

    boolean

    false

    设置日期选择器是否显示农历开关。当值为true时,显示农历开关,点击农历开关可切换公历和农历。当值为false时,不显示农历开关。

    说明

    仅手机和平板设备支持。 当lunarswitch=true且lunar=true时,开关按钮处于被选中状态。

    vibrate7+

    boolean

    true

    用于设置当picker滑动时是否有振动效果。

    • true:滑动时有振动效果。
    • false:滑动时无振动效果。

    说明

    智慧屏不支持。

    多列文本选择器

    滑动选择器类型设置为multi-text时表示多列文本选择器。

    名称

    类型

    默认值

    必填

    描述

    columns

    number

    -

    设置多列文本选择器的列数。

    range

    二维Array

    -

    设置多列文本选择器的选择项,其中range 为二维数组。长度表示多少列,数组的每项表示每列的数据,如 [["a","b"], ["c","d"]]。

    说明

    使用时需要使用数据绑定的方式,如range = {{data}},js中声明相应变量:data:[["a","b"], ["c","d"]]。

    selected

    Array

    [0,0,0,…]

    设置多列文本选择器弹窗的默认值,每一列被选中项对应的索引构成的数组,该取值表示选择器弹窗界面的默认选择值。

    value

    Array

    -

    设置多列文本选择器的值,每一列被选中项对应的值构成的数组。

    vibrate7+

    boolean

    true

    用于设置当picker滑动时是否有振动效果。

    • true:滑动时有振动效果。
    • false:滑动时无振动效果。

    说明

    智慧屏不支持。

    样式

    除支持通用样式外,还支持如下样式:

    名称

    类型

    默认值

    必填

    描述

    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, …] }

    多列文本选择器选择值后点击弹窗中的确认按钮时触发该事件,其中:

    • newValue:被选中项对应的值构成的数组。
    • newSelected:被选中项对应的索引构成的数组,两者的长度和range的长度一致。

    columnchange

    { column: column, newValue: newValue, newSelected: newSelected }

    多列文本选择器中某一列的值改变时触发该事件,其中:

    • column:第几列修改。
    • newValue:选中的值。
    • newSelected:选中值对应的索引。

    cancel

    -

    用户点击弹窗中的取消按钮时触发该事件。

    方法

    除支持通用方法外,支持如下方法:

    名称

    参数

    描述

    show

    -

    显示 picker。

    rotation

    FocusParam

    组件请求或者取消旋转表冠焦点,该方法参数可缺省,缺省时默认请求旋转表冠焦点。

    说明

    旋转表冠为穿戴设备特有硬件,用户可以通过旋转电源键来进行页面交互。

    表1 FocusParam对象说明

    属性

    类型

    说明

    focus

    boolean

    focus为true时,表示请求焦点,focus为false时,表示取消焦点。

    示例

    hml

    1. <div class="container">
    2. <select @change="selectChange">
    3. <option value="{{ item }}" for="item in selectList">
    4. {{ item }}<!---->
    5. </option>
    6. </select>
    7. <picker id="picker0" type="text" value="{{textvalue}}" selected="{{textselect}}" range="{{rangetext}}" onchange="textonchange"
    8. oncancel="textoncancel" class="pickertext" "></picker>
    9. <!--text:文本选择器。
    10. range设置普通选择器的取值范围
    11. selected设置普通选择器弹窗的默认取值,取值需要是 range 的索引值
    12. onchange和oncancel变化的同时改变变量-->
    13. <picker id="picker1" type="date" value="{{datevalue}}" start="2002-2-5" end="2030-6-5" selected="{{dateselect}}" lunarswitch="true"
    14. onchange="dateonchange" oncancel="dateoncancel" class="pickerdate" show="false"></picker>
    15. <!--date:日期选择器。
    16. start设置日期选择器的起始时间,格式为 YYYY-MM-DD。
    17. end设置日期选择器的结束时间,格式为 YYYY-MM-DD。
    18. selected设置选择器弹窗的默认取值
    19. value设置日期选择器的值。
    20. lunar设置日期选择器弹窗界面是否为农历展示。
    21. lunarswitch设置日期选择器是否显示农历开关。当值为true时,显示农历开关,点击农历开关可切换公历和农历。
    22. vibrate设置当picker滑动时是否有振动效果
    23. -->
    24. <picker id="picker2" type="time" value="{{timevalue}}" containsecond="{{containsecond}}" selected="{{timeselect}}" hours="12"
    25. onchange="timeonchange" oncancel="timeoncancel" class="pickertime" show="false"></picker>
    26. <!--time:时间选择器
    27. containsecond设置时间选择器是否包含秒
    28. selected设置选择器弹窗的默认取值
    29. hours设置时间选择器采用的时间格式是12小时制还是24小时
    30. onchange和oncancel变化的同时改变变量
    31. -->
    32. <picker id="picker3" type="datetime" value="{{datetimevalue}}" selected="{{datetimeselect}}" hours="24" lunarswitch="true"
    33. onchange="datetimeonchange" oncancel="datetimeoncancel" class="pickerdatetime" show="false"></picker>
    34. <!--datetime:日期时间选择器。
    35. 设置日期时间选择器弹窗的默认取值,有两种可选格式。
    36. 月日时分:MM-DD-HH-mm
    37. 年月日时分:YYYY-MM-DD-HH-mm
    38. 不设置年时,默认使用当前年,该取值表示选择器弹窗界面的默认选择值。-->
    39. <picker id="picker4" type="multi-text" value="{{multitextvalue}}" columns="3" range="{{multitext}}" selected="{{multitextselect}}"
    40. onchange="multitextonchange" oncancel="multitextoncancel" class="pickermuitl" show="false"></picker>
    41. <!--multi-text:多列文本选择器。
    42. columns设置多列文本选择器的列数
    43. range设置多列文本选择器的选择项,其中range 为二维数组。
    44. 长度表示多少列,数组的每项表示每列的数据,
    45. 如 [["a","b"], ["c","d"]]。
    46. -->
    47. </div>

    css

    1. .container {
    2. flex-direction: column;
    3. justify-content: center;
    4. align-items: center;
    5. }
    6. picker{
    7. width:60%;
    8. height:80px;
    9. border-radius:20px;
    10. text-color:white;
    11. font-size:15px;
    12. background-color:#4747e3;
    13. margin-left:20%;
    14. }
    15. select{
    16. background-color: #efecec;
    17. height: 50px;
    18. width: 60%;
    19. margin-left: 20%;
    20. margin-top: 300px;
    21. margin-bottom: 50px;
    22. font-size: 22px;
    23. }

    js 

    1. import router from '@system.router';
    2. import prompt from '@system.prompt';
    3. export default {
    4. data: {//储存前端所需数据
    5. selectList:["text","data","time","datetime","multitext"],
    6. rangetext:['15', "20", "25"],
    7. multitext:[["a", "b", "c"], ["e", "f", "g"], ["h", "i"], ["k", "l", "m"]],
    8. textvalue:'default textvalue',
    9. datevalue:'default datevalue',
    10. timevalue:'default timevalue',
    11. datetimevalue:'default datetimevalue',
    12. multitextvalue:'default multitextvalue',
    13. containsecond:true,
    14. multitextselect:[1,2,0],
    15. datetimeselect:'2012-5-6-11-25',
    16. timeselect:'11:22:30',
    17. dateselect:'2021-3-2',
    18. textselect:'2'
    19. },
    20. selectChange(e){
    21. for(let i = 0;i<this.selectList.length;i++){
    22. if(e.newValue == this.selectList[i]){
    23. this.$element("picker"+i).show();//表示显示的选择器id对应的框
    24. }
    25. }
    26. },
    27. textonchange(e) {//显示的数据与格式,随着onchange可变化
    28. this.textvalue = e.newValue;
    29. prompt.showToast({ message:"text:"+e.newValue+",newSelected:"+e.newSelected })
    30. },
    31. textoncancel(e) {//显示的数据与格式,随着onchange可变化
    32. prompt.showToast({ message:"text: textoncancel" })
    33. },
    34. dateonchange(e) {//显示的数据与格式,随着onchange可变化
    35. this.datevalue = e.year + "-" + e.month + "-" + e.day;
    36. prompt.showToast({ message:"date:"+e.year+"-"+(e.month+1)+"-"+e.day })
    37. },
    38. dateoncancel() {//显示的数据与格式,随着onchange可变化
    39. prompt.showToast({ message:"date: dateoncancel" })
    40. },
    41. timeonchange(e) {//显示的数据与格式,随着onchange可变化
    42. if(this.containsecond){
    43. this.timevalue=e.hour+":"+e.minute+":"+e.second;
    44. prompt.showToast({ message:"Time:" + e.hour + ":" + e.minute + ":" + e.second })
    45. } else {//显示的数据与格式,随着onchange可变化
    46. this.timevalue=e.hour+":"+e.minute;
    47. prompt.showToast({ message:"Time:" + e.hour + ":" + e.minute })
    48. }},
    49. timeoncancel() {//显示的数据与格式,随着onchange可变化
    50. prompt.showToast({ message:"timeoncancel" })
    51. },
    52. datetimeonchange(e) {//显示的数据与格式,随着onchange可变化
    53. this.datetimevalue=e.year+"-"+e.month+"-"+e.day+" "+e.hour+":"+e.minute;
    54. prompt.showToast({ message:"Time:"+(e.month+1)+"-"+e.day+" "+e.hour+":"+e.minute })
    55. },
    56. datetimeoncancel() {//显示的数据与格式,随着onchange可变化
    57. prompt.showToast({ message:"datetimeoncancel" })
    58. },
    59. multitextonchange(e) {//显示的数据与格式,随着onchange可变化
    60. this.multitextvalue=e.newValue;
    61. prompt.showToast({ message:"Multi-column text change" + e.newValue })
    62. },
    63. multitextoncancel() {//显示的数据与格式,随着onchange可变化
    64. prompt.showToast({ message:"multitextoncancel" })
    65. },
    66. popup_picker() {//显示的数据与格式,随着onchange可变化
    67. this.$element("picker_text").show();
    68. },
    69. }

    图片

     

     

     

     

     

     

     

     

  • 相关阅读:
    【6】Spring Boot 3 集成组件:knift4j+springdoc+swagger3
    vue目录树的封装
    day47 JavaScript基础
    nodejs基于Vue前端的超市库存管理系统
    Codeforces Round 910 (Div. 2)(D~F)
    python简单使用grpc
    使用token登录提交到github
    【矩阵论】4. 矩阵运算——张量积
    【Web前端】uni-app页面跳转uni.navigateTo传递对象参数
    breakout靶机
  • 原文地址:https://blog.csdn.net/qq_63202674/article/details/124999043