优秀的编程知识分享平台

网站首页 > 技术文章 正文

3.10「HarmonyOS鸿蒙开发」组件DatePicker

nanyue 2024-07-26 15:45:25 技术文章 6 ℃


作者:韩茹

公司:程序咖(北京)科技有限公司

鸿蒙巴士专栏作家

DatePicker主要供用户选择日期。

一、支持的XML属性

DatePicker的共有XML属性继承自:StackLayout

DatePicker的自有XML属性见下表:

属性名称

中文描述

取值

取值说明

使用案例

date_order

显示格式,年月日

0

表示日期以日-月-年的格式显示。

ohos:date_order="0"



1

表示日期以月-日-年的格式显示。




2

表示日期以年-月-日的格式显示。




3

表示日期以年-日-月的格式显示。




4

表示日期以日-月的格式显示。




5

表示日期以月-日的格式显示。




6

表示日期以年-月的格式显示。




7

表示日期以月-年的格式显示。




8

表示只显示年份。




9

表示只显示月份。




10

表示只显示日期。


day_fixed

日期是否固定

boolean类型

可以直接设置true/false,也可以引用boolean资源。

ohos:day_fixed="true"ohos:day_fixed="$boolean:true"

month_fixed

月份是否固定

boolean类型

可以直接设置true/false,也可以引用boolean资源。

ohos:month_fixed="true"ohos:month_fixed="$boolean:true"

year_fixed

年份是否固定

boolean类型

可以直接设置true/false,也可以引用boolean资源。

ohos:year_fixed="true"ohos:year_fixed="$boolean:true"

max_date

最大日期

long类型

可以直接设置长整型值,也可以引用string资源。

ohos:time="1234567"ohos:time="$string:date"

min_date

最小日期

long类型

可以直接设置长整型值,也可以引用string资源。

ohos:time="1234567"ohos:time="$string:date"

text_size

文本大小

float类型

表示尺寸的float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp单位的浮点数值;也可以引用float资源。

ohos:text_size="30"ohos:text_size="16fp"ohos:text_size="$float:size_value"

normal_text_size

取消选中文本的大小

float类型

表示尺寸的float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp单位的浮点数值;也可以引用float资源。

ohos:normal_text_size="30"ohos:normal_text_size="16fp"ohos:normal_text_size="$float:size_value"

selected_text_size

选中文本的大小

float类型

表示尺寸的float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp单位的浮点数值;也可以引用float资源。

ohos:selected_text_size="30"ohos:selected_text_size="16fp"ohos:selected_text_size="$float:size_value"

normal_text_color

取消选中文本的颜色

color类型

可以直接设置色值,也可以引用color资源。

ohos:normal_text_color="#A8FFFFFF"ohos:normal_text_color="$color:black"

selected_text_color

选中文本的颜色

color类型

可以直接设置色值,也可以引用color资源。

ohos:selected_text_color="#A8FFFFFF"ohos:selected_text_color="$color:black"

operated_text_color

操作项的文本颜色

color类型

可以直接设置色值,也可以引用color资源。

ohos:operated_text_color="#A8FFFFFF"ohos:operated_text_color="$color:black"

selected_normal_text_margin_ratio

已选文本边距与正常文本边距的比例

float类型

可以直接设置浮点数值,也可以引用float浮点数资源。取值需>0.0f,默认值为1.0f。

ohos:selected_normal_text_margin_ratio="0.5"ohos:selected_normal_text_margin_ratio="$float:ratio"

selector_item_num

显示的项数

integer类型

可以直接设置整型数值,也可以引用integer资源。

ohos:selector_item_num="10"ohos:selector_item_num="$integer:num"

shader_color

着色器颜色

color类型

可以直接设置色值,也可以引用color资源。

ohos:shader_color="#A8FFFFFF"ohos:shader_color="$color:black"

top_line_element

选中项的顶行

Element类型

可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。

ohos:top_line_element="#FFFFFFFF"ohos:top_line_element="media:media_src"ohos:top_line_element="$graphic:graphic_src"

bottom_line_element

选中项的底线

Element类型

可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。

ohos:bottom_line_element="#FFFFFFFF"ohos:bottom_line_element="?media:media_src"ohos:bottom_line_element="$graphic:graphic_src"

wheel_mode_enabled

选择轮是否绕行

boolean类型

可以直接设置true/false,也可以引用boolean资源。

ohos:wheel_mode_enabled="true"ohos:wheel_mode_enabled="$boolean:true"

二、使用DatePicker

1、在XML中创建DatePicker

<DatePicker
        ohos:id="$+id:date_pick"
        ohos:height="match_content"
        ohos:width="300vp"
        ohos:background_element="#22AA0000"
        >

创建默认的DatePicker:

2、获取当前选择日期,日/月/年,DatePicker默认选择当前日期。

        // 获取DatePicker实例
        DatePicker datePicker = (DatePicker) findComponentById(ResourceTable.Id_date_pick);
        int day = datePicker.getDayOfMonth();
        int month = datePicker.getMonth();
        int year = datePicker.getYear();

        System.out.println("day:"+day+",month:"+month+",year:"+year);

我们是可以获取到年月日信息的:

3、响应日期改变事件:

在XML中添加Text显示选择日期:

<Text
        ohos:id="$+id:text_date"
        ohos:height="match_content"
        ohos:width="match_parent"
        ohos:hint="date"
        ohos:text_alignment="center"
        ohos:margin="10vp"
        ohos:padding="4vp"
        ohos:text_color="#AA0000"
        ohos:text_size="20fp">

在Java代码中响应日期改变事件:

Text selectedDate = (Text) findComponentById(ResourceTable.Id_text_date);
        datePicker.setValueChangedListener(
                new DatePicker.ValueChangedListener() {
                    @Override
                    public void onValueChanged(DatePicker datePicker, int year, int monthOfYear, int dayOfMonth) {
                        // 格式化显示字符串
                        selectedDate.setText(String.format("%02d/%02d/%4d", dayOfMonth, monthOfYear, year));
                    }
                }
        );

日期改变响应效果:

4、设置当前日期

datePicker.updateDate(2021, 8, 8);

设置当前日期效果:

5、设置日期的范围

如需对DatePicker的日期选择范围有要求,可以设置属性min_date和max_date。设置的值为日期对应的Unix时间戳

设置最小日期:

<DatePicker
    ...
    ohos:min_date="1623895868">
</DatePicker>

或者在代码中设置:

datePicker.setMinDate(1623895868);

设置最小日期为2021/06/17:

设置最大日期:

在XML中设置:

<DatePicker
    ...
    ohos:max_date="1630339200">
</DatePicker>

在代码中设置:

datePicker.setMaxDate(1630339200);

设置最大日期为2021/08/31:

固定年/月/日

在XML中设置:

<DatePicker
    ...
    ohos:year_fixed="true">
</DatePicker>

在代码中设置:

datePicker.setYearFixed(true);

三、样式设置

1、文本相关属性

设置待选项的字体大小和颜色

<DatePicker
    ...
    ohos:normal_text_color="#00FFFF"
    ohos:normal_text_size="20fp">
</DatePicker>

设置待选项的字体大小和颜色效果:

设置已选项的字体大小和颜色

在XML中设置:

<DatePicker
    ...
    ohos:selected_text_color="#FF00FF"
    ohos:selected_text_size="20fp">
</DatePicker>

在代码中设置:

datePicker.setSelectedTextSize(40);
datePicker.setSelectedTextColor(new Color(Color.getIntColor("#FF00FF")));

设置已选项的字体大小和颜色效果:

设置操作项的字体颜色

在XML中设置:

<DatePicker
    ...
    ohos:operated_text_color="#FFA500">
</DatePicker>

在代码中设置:

datePicker.setOperatedTextColor(new Color(Color.getIntColor("#FFA500")));

设置操作项的字体颜色效果

2、设置DatePicker中所选文本边距与普通文本边距的比例

在XML中设置:

<DatePicker
    ...
    ohos:selected_normal_text_margin_ratio="10">
</DatePicker>

在代码中设置:

datePicker.setSelectedNormalTextMarginRatio(10.0f)

已选文本边距与正常文本边距比例设置为10的效果图:

3、设置滚轮绕行

在XML中设置:

<DatePicker
    ...
    ohos:wheel_mode_enabled="true">
</DatePicker>

在代码中设置:

datePicker.setWheelModeEnabled(true);

滚轮绕行效果:

4、设置选中日期的上下边框

在XML中设置:

<DatePicker
    ...
    ohos:top_line_element="#9370DB"
    ohos:bottom_line_element="#9370DB">
</DatePicker>

在代码中设置:

ShapeElement shape = new ShapeElement();
shape.setShape(ShapeElement.RECTANGLE);
shape.setRgbColor(RgbColor.fromArgbInt(0xFF9370DB));
datePicker.setDisplayedLinesElements(shape,shape);

添加选中项上下边框效果:

5、设置着色器颜色

在XML中设置:

<DatePicker
    ...
    ohos:shader_color="gray">
</DatePicker>

在代码中设置:

datePicker.setShaderColor(new Color(Color.getIntColor("#00CED1")));

设置着色器颜色效果:

最近发表
标签列表