二、分类说明

④Picker

Picker提供了滑动选择器，允许用户从预定义范围中进行选择。

Picker的自有XML属性见下表：

属性名称	属性描述	使用案例
element_padding	文本和Element之间的间距Element必须通过setElementFormatter接口配置	ohos:element_padding=“10”
max_value	最大值	ohos:max_value=“10”
min_value	最小值	ohos:min_value=“10”
value	当前值	ohos:value=“10”
normal_text_color	未选中的文本颜色	ohos:normal_text_color="#A8FFFFFF"
normal_text_size	未选中的文本大小	ohos:normal_text_size=“10”
selected_text_color	选中的文本颜色	ohos:selected_text_color="#A8FFFFFF"
selected_text_size	选中的文本大小	ohos:selected_text_size=“10”
selector_item_num	显示的项目数量，条数	ohos:selector_item_num=“10”
selected_normal_text_margin_ratio	已选文本边距与常规文本边距的比例，取值需>0.0f，默认值为1.0f	ohos:selected_normal_text_margin_ratio=“0.5”
shader_color	着色器颜色	ohos:shader_color="#A8FFFFFF"
top_line_element	选中项的顶行	ohos:top_line_element="#FFFFFFFF"
bottom_line_element	选中项的底线	ohos:bottom_line_element="#FFFFFFFF"
wheel_mode_enabled	选择轮是否循环显示数据	ohos:wheel_mode_enabled=“true”

⑤DatePicker

DatePicker主要供用户选择日期。

DatePicker的自有XML属性见下表：

属性名称	属性描述	使用案例
date_order	显示格式，年月日	ohos:date_order=“day-month-year” 表示日期以日-月-年的格式显示
		ohos:date_order=“month-day-year” 表示日期以月-日-年的格式显示
		ohos:date_order=“year-month-day” 表示日期以年-月-日的格式显示
		ohos:date_order=“year-day-month” 表示日期以年-日-月的格式显示
		ohos:date_order=“day-month” 表示日期以日-月的格式显示
		ohos:date_order=“month-day” 表示日期以月-日的格式显示
		ohos:date_order=“year-month” 表示日期以年-月的格式显示
		ohos:date_order=“month-year” 表示日期以月-年的格式显示
		ohos:date_order=“only-year” 表示只显示年份
		ohos:date_order=“only-month” 表示只显示月份
		ohos:date_order=“only-day” 表示只显示日期
day_fixed	日期是否固定	ohos:day_fixed=“true”
month_fixed	月份是否固定	ohos:month_fixed=“true”
year_fixed	年份是否固定	ohos:year_fixed=“true”
max_date	最大日期(long类型)	ohos:max_date=“1234567”
min_date	最小日期(long类型)	ohos:min_date=“1234567”
text_size	文本大小(float类型)	ohos:text_size=“30”
normal_text_size	未选中文本的大小(float类型)	ohos:normal_text_size=“30”
selected_text_size	选中文本的大小(float类型)	ohos:selected_text_size=“30”
normal_text_color	未选中文本的颜色	ohos:normal_text_color="#A8FFFFFF"
selected_text_color	选中文本的颜色	ohos:selected_text_color="#A8FFFFFF"
operated_text_color	操作项的文本颜色	ohos:operated_text_color="#A8FFFFFF"
selected_normal_text_margin_ratio	已选文本边距与常规文本边距的比例，取值需>0.0f，默认值为1.0f	ohos:selected_normal_text_margin_ratio=“0.5”
selector_item_num	显示的项目数量	ohos:selector_item_num=“10”
shader_color	着色器颜色	ohos:shader_color="#A8FFFFFF"
top_line_element	选中项的顶行	ohos:top_line_element="#FFFFFFFF"
bottom_line_element	选中项的底线	ohos:bottom_line_element="#FFFFFFFF"
wheel_mode_enabled	选择轮是否循环显示数据	ohos:wheel_mode_enabled=“true”

⑥ProgressBar

ProgressBar用于显示内容或操作的进度。

ProgressBar的自有XML属性见下表：

属性名称	属性描述	使用案例
divider_lines_enabled	是否使用分割线	ohos:divider_lines_enabled=“true”
divider_lines_number	分割线数量	ohos:divider_lines_number=“1”
infinite	是否使用不确定模式	ohos:infinite=“true”
infinite_element	不确定模式图样配置前提：infinite需设置为true	ohos:infinite_element="$media:media_src"
max	最大值	ohos:max=“1”
max_height	最大高度	ohos:max_height=“100”
max_width	最大宽度	ohos:max_width=“100”
min	最小值	ohos:min=“1”
orientation	排列方向horizontal(水平方向)，vertical(垂直方向)	ohos:orientation=“horizontal”
progress	当前进度	ohos:progress=“10”
background_instruct_element	背景	ohos:background_instruct_element="#000000"
progress_width	进度条宽度	ohos:progress_width=“100”
progress_color	进度条颜色	ohos:progress_color="#FF262626"
progress_element	进度条背景	ohos:progress_element="#000000"
progress_hint_text	进度提示文本	ohos:progress_hint_text=“test”
progress_hint_text_alignment	进度提示文本对齐方式left、top、right、bottom、horizontal_center、vertical_center、center	可以设置取值项如表中所列，也可以使用“\|”进行多项组合。ohos:progress_hint_text_alignment=“top”
progress_hint_text_color	进度提示文本颜色	ohos:progress_hint_text_color="#FFFFFFFF"
vice_progress	当前副进度	ohos:vice_progress=“1”
vice_progress_element	副进度条背景	ohos:vice_progress_element="#000000"
step	进度的步长；若step设置为10，进度值则为10的倍数。	ohos:step=“1”
progress_hint_text_size	进度提示文本大小	ohos:progress_hint_text_size=“100”

⑦RoundProgressBar

RoundProgressBar继承自ProgressBar，拥有ProgressBar的属性，在设置同样的属性时用法和ProgressBar一致，用于显示环形进度。

RoundProgressBar的自有XML属性见下表：

属性名称	属性描述	使用案例
start_angle	圆形进度条的起始角度	ohos:start_angle=“10”
max_angle	圆形进度条的最大角度	ohos:max_angle=“360.0”

⑧TabList、Tab

Tablist可以实现多个页签栏的切换，Tab为某个页签。子页签通常放在内容区上方，展示不同的分类。页签名称应该简洁明了，清晰描述分类的内容。

Tablist的自有XML属性见下表：

属性名称	属性描述	使用案例
fixed_mode	固定所有页签并同时显示	ohos:fixed_mode=“true”
orientation	页签排列方向horizontal(水平排列)，vertical(垂直排列)	ohos:orientation=“horizontal”
normal_text_color	未选中的文本颜色	ohos:normal_text_color="#FFFFFFFF"
selected_text_color	选中的文本颜色	ohos:selected_text_color="#FFFFFFFF"
selected_tab_indicator_color	选中页签的颜色	ohos:selected_tab_indicator_color="#FFFFFFFF"
selected_tab_indicator_height	选中页签的高度	ohos:selected_tab_indicator_height=“100”
tab_indicator_type	页签指示类型	ohos:tab_indicator_type=“invisible” 表示选中的页签无指示标记
		ohos:tab_indicator_type=“bottom_line” 表示选中的页签通过底部下划线标记
		ohos:tab_indicator_type=“left_line” 表示选中的页签通过左侧分割线标记
		ohos:tab_indicator_type=“oval” 表示选中的页签通过椭圆背景标记
tab_length	页签长度	ohos:tab_length=“100”
tab_margin	页签间距	ohos:tab_margin=“100”
text_alignment	文本对齐方式left、top、right、bottom、horizontal_center、vertical_center、center、start、end	可以设置取值项如表中所列，也可以使用“\|”进行多项组合 ohos:text_alignment=“center”
text_size	文本大小	ohos:text_size=“100”

TabList常用接口

方法	方法说明
getSelectedTab	返回选中的Tab
getSelectedTabIndex	返回选中的Tab的位置索引
getTabCount	获取Tab的个数
getTabAt	获取某个Tab
removeTab	移除某个位置的tab
setOrientation	设置横或竖方向

⑨PageSlider

PageSlider是用于页面之间切换的组件，它通过响应滑动事件完成页面间的切换。

常用方法表

方法	方法说明
setProvider(PageSliderProvider provider)	设置Provider，用于配置PageSlider的数据结构
addPageChangedListener(PageChangedListener listener)	响应页面切换事件
removePageChangedListener(PageChangedListener listener)	移除页面切换的响应
setOrientation(int orientation)	设置布局方向
setPageCacheSize(int count)	设置要保留当前页面两侧的页面数
setCurrentPage(int itemPos)	设置当前展示页面
setCurrentPage(int itemPos, boolean smoothScroll)	设置当前展示界面，并确定是否需要平滑滚动
setSlidingPossible(boolean enable)	是否启用页面滑动
setReboundEffect(boolean enabled)	是否启用回弹效果
setReboundEffectParams(int overscrollPercent, float overscrollRate,int remainVisiblePercent)	配置回弹效果参数
setPageSwitchTime(int durationMs)	设置页面切换时间

⑩PageSliderIndicator

PageSliderIndicator，需配合PageSlider使用，指示在PageSlider中展示哪个界面。

未完待续…

HarmonyOS学习路之开发篇—Java UI框架（基础组件说明【二】）