二、分类说明
④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中展示哪个界面。
未完待续...
