HarmonyOS/OpenHarmony应用开发-ArkTSAPI组件总体分类与说明（上）

一、行列与分栏

Column

沿垂直方向布局的容器组件。

ColumnSplit

垂直方向分隔布局容器组件，将子组件纵向布局，并在每个子组件之间插入一根横向的分割线。

Row

沿水平方向布局的容器组件。

RowSplit

水平方向分隔布局容器组件，将子组件横向布局，并在每个子组件之间插入一根纵向的分割线。

SideBarContainer

提供侧边栏可以显示和隐藏的侧边栏容器组件，通过子组件定义侧边栏和内容区，第一个子组件表示侧边栏，第二个子组件表示内容区。

二、堆叠Flex与栅格

Stack

堆叠容器组件，子组件按照顺序依次入栈，后一个子组件覆盖前一个子组件。

Flex

以弹性方式布局子组件的容器组件。

GridContainer

纵向排布栅格布局容器组件，仅在栅格布局场景中使用。

GridRow

栅格容器组件，仅可以和栅格子组件(GridCol)在栅格布局场景中使用。

GridCol

栅格子组件，必须作为栅格容器组件(GridRow)的子组件使用。

RelativeContainer

相对布局组件，用于复杂场景中元素对齐的布局。

三、列表与宫格

List

列表包含一系列相同宽度的列表项，适合连续、多行呈现同类数据，例如图片和文本。

ListItem

用来展示具体列表项，必须配合List来使用。

ListItemGroup

用来展示分组列表项的组件，必须配合List组件来使用。

Grid

网格容器组件，由“行”和“列”分割的单元格所组成，通过指定“项目”所在的单元格做出各种各样的布局。

GridItem

网格容器中单项内容容器。

滚动与滑动

Scroll

可滚动的容器组件，当子组件的布局尺寸超过父组件的尺寸时，内容可以滚动。

Swiper

滑块视图容器组件，提供子组件滑动轮播显示的能力。

WaterFlow

瀑布流容器组件，由“行”和“列”分割的单元格所组成，通过容器自身的排列规则，将不同大小的“项目”自上而下，如瀑布般紧密布局。

FlowItem

瀑布流组件WaterFlow的子组件，用来展示瀑布流具体item。

四、导航

Navigator

路由容器组件，提供路由跳转能力。

Navigation

一般作为Page页面的根容器，通过属性设置来展示页面的标题栏、工具栏、导航栏等。

NavRouter

导航组件，默认提供点击响应处理，不需要开发者自定义点击事件逻辑。

NavDestination

作为NavRouter组件的子组件，用于显示导航内容区。

Stepper

步骤导航器组件，适用于引导用户按照步骤完成任务的导航场景。

StepperItem

Stepper组件的子组件。

Tabs

通过页签进行内容视图切换的容器组件，每个页签对应一个内容视图。

TabContent

仅在Tabs组件中使用，对应一个切换页签的内容视图。

五、按钮与选择

Button

按钮组件，可快速创建不同样式的按钮。

Toggle

组件提供勾选框样式、状态按钮样式及开关样式。

Checkbox

提供多选框组件，通常用于某选项的打开或关闭。

CheckboxGroup

多选框群组，用于控制多选框全选或者不全选状态。

DatePicker

选择日期的滑动选择器组件。

TextPicker

滑动选择文本内容的组件。

TimePicker

滑动选择时间的组件。

Radio

单选框，提供相应的用户交互选择项。

Rating

提供在给定范围内选择评分的组件。

Select

提供下拉选择菜单，可以让用户在多个选项之间选择。

Slider

滑动条组件，通常用于快速调节设置值，如音量调节、亮度调节等应用场景。

Counter

计数器组件，提供相应的增加或者减少的计数操作。