HarmonyOS ArkTS 组件速查表【是不是感觉好多没用过】:2026年9月之前的
HarmonyOS ArkTS 组件速查表
共 20 个分类、185 个条目。数据来源:华为开发者文档 ArkTS 组件参考。
目录
- 行列与堆叠(7)
- 栅格与分栏(5)
- 滚动与滑动(20)
- 导航与切换(7)
- 按钮与选择(16)
- 文本与输入(16)
- 图片与视频(6)
- 信息展示(14)
- 空白与分隔(2)
- 画布绘制(13)
- 图形绘制(9)
- 渲染绘制(3)
- 菜单(4)
- 卡片(1)
- 安全(3)
- 主题(1)
- AtomicService(7)
- 自定义占位组件(2)
- 已停止维护的组件与接口(8)
- 系统预置UI组件库(41)
- Chip
- ChipV2
- ChipGroup
- ChipGroupV2
- ComposeListItem
- ComposeListItemV2
- ComposeTitleBar
- ComposeTitleBarV2
- DownloadFileButton
- DialogV2
- EditableTitleBar
- EditableTitleBarV2
- ExceptionPrompt
- ExceptionPromptV2
- Filter
- FolderStack
- FoldSplitContainer
- FormMenu
- FullScreenLaunchComponent
- GridObjectSortComponent
- Popup
- PopupV2
- ProgressButton
- ProgressButtonV2
- SegmentButton
- SegmentButtonV2
- SelectTitleBar
- SelectionMenu
- SplitLayout
- SubHeader
- SubHeaderV2
- SwipeRefresher
- SwipeRefresherV2
- TabTitleBar
- ToolBar
- ToolBarV2
- TreeView
- TreeViewV2
- advanced.Counter
- CounterV2
- DatePickerComponent
行列与堆叠
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/rows-columns-and-stacking
| 组件 | 说明 | 支持设备 |
|---|---|---|
| Flex | Flex是以弹性方式布局子组件的容器组件,能够高效地排列、对齐子元素并分配剩余空间。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Column | 沿垂直方向布局的容器。适用于需要将多个子组件按垂直方向依次排列的场景,如列表项、表单项、卡片内容等。支持设置子组件间距、对齐方式等属性,能够快速实现垂直方向的线性布局。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Row | 沿水平方向布局的容器,支持设置子组件间距、对齐方式,适用于需要横向排列多个子组件的场景,如工具栏、标签栏、按钮组等。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Stack | 堆叠容器,子组件按照顺序依次入栈,后一个子组件覆盖前一个子组件。适用于需要层叠布局的场景,如页面上的悬浮按钮或提示信息、图片或视频上覆盖文字标签、多层叠加的弹窗或对话框等。相比使用多个容器嵌套实现层叠效果,Stack提供了更简洁高效的解决方案。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| RelativeContainer | 相对布局组件,用于复杂场景中元素对齐的布局。子组件通过设置alignRules指定相对于容器或其他子组件的对齐规则,适用于需要灵活布局、减少嵌套层级的复杂界面。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| DynamicLayout | 动态布局容器组件,支持在运行时动态切换不同的布局算法,不改变子组件的状态。适用于响应式布局(适配不同屏幕尺寸)、多视图模式切换(如列表/网格/瀑布流切换)、用户自定义布局等场景。仅可在Stage模型下使用。 | Phone24+,PC/2in124+,Tablet24+,TV24+,Wearable24+ |
| ContainerReader | ContainerReader是容器断点组件,用于在动态场景下根据容器尺寸获取断点信息并进行响应式布局。通过双向绑定实时返回容器的尺寸和断点,使开发者能够基于容器大小进行差异化的组件创建和布局。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+,Wearable26.0.0+ |
栅格与分栏
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/grid-and-column-layout
| 组件 | 说明 | 支持设备 |
|---|---|---|
| GridRow | 栅格容器组件,为布局提供规律性的结构,解决多尺寸多设备的动态布局问题,保证不同设备上各个模块的布局一致性。仅可以和栅格子组件GridCol在栅格布局场景中使用,支持根据设备尺寸和断点动态调整列数与间距,实现响应式布局。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| GridCol | 栅格布局系统中的列组件,必须作为栅格容器组件GridRow的子组件使用。适用于响应式布局、多设备适配等需要动态调整列宽的场景,支持响应式断点配置、跨列布局、偏移和排序功能。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ColumnSplit | 将子组件纵向布局,并在每个子组件之间插入横向分割线。适用于需要垂直方向上多区域布局且支持动态调整区域大小的场景,如仪表盘界面、可调节高度的上下分区布局等。通过可拖拽的分割线,用户可以灵活调整各区域高度。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| RowSplit | 将子组件横向布局,并在每个子组件之间插入纵向分割线。适用于需要横向多区域布局且支持动态调整子组件宽度的场景,如文件管理器的左右分栏、设置页面的双栏布局等。通过可拖拽的分割线,用户可以灵活调整各区域宽度。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| SideBarContainer | 提供侧边栏可以显示和隐藏的容器,通过子组件定义侧边栏和内容区,第一个子组件表示侧边栏,第二个子组件表示内容区。支持侧边栏导航布局场景,通过控制按钮或手势切换侧边栏显隐,可提升应用导航效率。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
滚动与滑动
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scroll-and-swipe
| 组件 | 说明 | 支持设备 |
|---|---|---|
| List | ArkUI中的列表容器组件,用于呈现连续、多行或多列的同类数据,支持垂直或水平滚动。配合LazyForEach或Repeat可实现懒加载,提升长列表场景下的启动速度并减少内存消耗;支持预加载、单列/多列布局、分组列表、吸顶吸底等能力,适用于消息列表、商品列表、设置页面等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ListItem | 用于展示列表中的具体列表项,支持设置划出菜单、选中状态、鼠标框选和卡片样式等能力,必须配合List组件使用,适用于需要在列表中展示内容并对单个列表项进行交互操作(如滑动删除、选中标记)的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ListItemGroup | 用来展示列表项分组,支持自定义分组头部和尾部区域、卡片样式、分割线、懒加载与预加载等能力,适用于需要对列表项进行逻辑分组展示的场景。宽度默认充满List组件,必须配合List组件使用。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ArcList | 弧形列表,由沿弧形排列的一系列列表项组成,适用于圆形屏幕设备。适合连续、多行呈现同类数据,例如图片和文本。 | Phone18+,PC/2in118+,Tablet18+,TV19+,Wearable18+ |
| ArcListItem | 用于展示弧形列表的子组件,必须配合ArcList使用。 | Phone18+,PC/2in118+,Tablet18+,TV19+,Wearable18+ |
| Grid | 网格容器,由"行"和"列"分割的单元格所组成,通过指定"项目"所在的单元格做出各种各样的布局。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| GridItem | 网格容器中单项内容容器。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Scroll | 可滚动的容器组件,当子组件的布局尺寸超过父组件的尺寸时,内容可以滚动。支持设置滚动方向、滚动条、边缘效果、嵌套滚动以及自由滚动缩放等能力,适用于内容超出显示区域或需要复杂滚动交互的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Swiper | 滑块视图容器,提供子组件滑动轮播显示的能力。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ArcSwiper | 弧形滑块视图容器,提供子组件滑动轮播显示的能力,适用于圆形屏幕设备。 | Phone18+,PC/2in118+,Tablet18+,TV19+,Wearable18+ |
| WaterFlow | 瀑布流容器,由"行"和"列"分割的单元格所组成,通过容器自身的排列规则,将不同大小的"项目"自上而下如瀑布般紧密布局。支持多列布局、分组混合布局、懒加载、自动计算列数和边缘渐隐等功能,适用于图片画廊、商品展示、内容信息流等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| FlowItem | 瀑布流组件WaterFlow的子组件,用于展示瀑布流中的具体项。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| LazyVGridLayout | 用于实现支持懒加载的网格布局,适用于在滚动容器中按需渲染大量网格项的场景,可减少首帧渲染时间和内存开销。 | Phone19+,PC/2in119+,Tablet19+,TV19+,Wearable19+ |
| LazyVWaterFlowLayout | 用于实现支持懒加载的瀑布流布局,适用于展示大量高度不一的列表项场景,如图片墙、商品列表等。仅加载可视区域及附近内容,减少内存占用和渲染开销,提升滚动流畅度。需位于竖直方向的List、Scroll或WaterFlow内。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+,Wearable26.0.0+ |
| LazyColumnLayout | 用于实现支持懒加载的垂直线性布局,其父组件仅限于List、Scroll、WaterFlow或FlowItem,适用于在滚动容器中按需渲染大量子组件的场景。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+,Wearable26.0.0+ |
| LazyDynamicLayout | 用于实现支持懒加载的动态布局容器,支持开发者自定义布局算法。适用于在可滚动组件中展示大量子组件的场景,通过按需加载和布局可视区域内的子组件,减少首帧渲染时间和内存开销。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+,Wearable26.0.0+ |
| ScrollBar | 滚动条组件,用于配合可滚动组件使用,如ArcList、List、Grid、Scroll、WaterFlow等,可自定义滚动条样式与位置。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Refresh | 提供下拉刷新交互的容器组件,适用于列表数据刷新、页面内容更新等需要用户触发数据更新的场景。支持自定义刷新区域显示内容和文本、设置下拉偏移量和跟手系数、控制最大下拉距离等。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ArcScrollBar | 弧形滚动条组件,适用于圆形屏幕等需要弧形滚动条的场景,用于配合ArcList、List、Grid、Scroll等可滚动组件使用。 | Phone18+,PC/2in118+,Tablet18+,TV19+,Wearable18+ |
| 滚动组件通用接口 | 滚动类组件的通用接口,目前支持List、Grid、Scroll和WaterFlow组件,提供统一的滚动控制与状态查询能力。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
导航与切换
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/navigation-and-switching
| 组件 | 说明 | 支持设备 |
|---|---|---|
| Indicator | 导航点组件,提供圆点导航点以及数字导航点两种导航点样式。将原Swiper组件中indicator已有的能力作为一个单独组件提供,可以不依赖Swiper单独显示导航点,也可以通过IndicatorComponentController与Swiper绑定使用。 | Phone15+,PC/2in115+,Tablet15+,TV19+,Wearable18+ |
| Navigation | 路由导航的根视图容器,一般作为Page页面的根容器使用,内部默认包含标题栏、内容区和工具栏。内容区默认首页显示导航内容(Navigation的子组件),非首页显示NavDestination的子组件,首页与非首页通过路由进行切换。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| NavDestination | 作为子页面的根容器,用于显示Navigation的内容区。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| MultiNavigation | 用于在大尺寸设备上分栏显示、进行路由跳转。 | Phone14+,PC/2in114+,Tablet14+,TV19+,Wearable18+ |
| Tabs | 通过页签进行内容视图切换的容器组件,每个页签对应一个内容视图。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| TabContent | 用于在Tabs中定义每个页签的内容视图,支持单个子组件渲染、内容裁切控制、页签样式自定义等特性。适用于需要多页签切换的场景,如分类导航、功能模块切换等。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ToolBarItem | 通过toolbar通用属性为窗口标题栏添加工具栏项。 | Phone20+,PC/2in120+,Tablet20+,TV20+,Wearable20+ |
按钮与选择
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/buttons-and-selections
| 组件 | 说明 | 支持设备 |
|---|---|---|
| Button | 按钮组件,可快速创建不同样式的按钮。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Toggle | 提供勾选框样式、状态按钮样式和开关样式,适用于需要快速切换状态或进行单选确认的场景,能够有效提升交互体验与界面的直观性。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Checkbox | 提供多选框组件,用于在多个选项中进行选择。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| CheckboxGroup | 多选框群组,用于控制多选框全选或取消全选状态。适用于需要批量管理多个Checkbox选择状态的场景,如列表项批量选择、表单全选等。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| UIPickerComponent | 用于实现用户选择操作的容器组件,支持从一组有限的选项中单选,采用立体滚轮样式提供直观的视觉反馈和流畅的滑动体验。支持选项按需定制,包括文本类型、图片类型和图文组合类型,可应用于时间选择、日期选择、地区选择、状态选择等场景。 | Phone22+,PC/2in122+,Tablet22+,TV22+,Wearable22+ |
| CalendarPicker | 日历选择器组件,提供下拉日历弹窗,用户可快速选择日期。适用于需要用户选择具体日期的场景,如预订系统、日程安排、日期筛选等。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| DatePicker | 滑动选择日期的组件,支持公历和农历切换,可配置日期范围、选择模式和文本样式,用于需要用户选择日期的应用场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| TextPicker | 滑动选择文本、图片或图文混排内容的组件,可创建单列数据选择器、多列非联动和多列联动数据选择器。支持循环滚动、自定义文本样式、分割线样式、渐隐效果、选择项高度调整、触控反馈、表冠灵敏度设置等特性。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| TimePicker | 用于滑动选择时间的组件,支持12/24小时制、多种时间格式(小时/分钟/秒)、循环滚动、样式定制和时间范围限制等功能。适用于日程安排、时间预约、任务管理等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Radio | 单选框,提供单选类型的用户交互选择项。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Rating | 提供在给定范围内选择评分的组件,通常用于商品评价、内容打分等应用场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Select | 提供下拉选择菜单,让用户在多个选项间选择。支持设置选项图标、自定义样式、分割线等,适用于需要在有限空间内展示多个选项供用户选择的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Slider | 滑动条组件,通常用于快速调节设置值,如音量调节、亮度调节等应用场景。支持样式定制、方向配置、交互方式和无障碍功能。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ArcButton | 弧形按钮组件,提供强调、常规、自定义等样式按钮,推荐用于圆形屏幕的设备。 | Phone18+,PC/2in118+,Tablet18+,TV19+,Wearable18+ |
| ArcSlider | 弧形滑动条组件,通常用于在圆形屏幕的穿戴设备中快速调节设置值,如音量调节、亮度调节等应用场景。 | Phone18+,PC/2in118+,Tablet18+,TV19+,Wearable18+ |
| 选择器(Picker)公共接口 | 选择器组件公共接口。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
文本与输入
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/text-and-input
| 组件 | 说明 | 支持设备 |
|---|---|---|
| Text | 用于显示文本内容,支持设置字体样式、文本对齐、行高、装饰线等属性,支持图文混排、文本选择、文本识别等功能,适用于需要展示文本信息的各类应用场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| TextArea | 多行文本输入框组件,当输入的文本内容超过组件宽度时会自动换行显示,适用于评论输入、反馈表单、内容编辑等需要多行文本输入的场景。高度未设置时自适应内容高度,宽度未设置时默认撑满最大宽度。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| TextInput | 单行文本输入框组件,用于接收用户的单行文本输入。支持多种输入类型(文本、密码、邮箱、数字等)、自定义样式、输入过滤、密码输入模式、自动填充等功能,适用于登录注册、搜索、表单填写等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| RichEditor | 支持图文混排和文本交互式编辑的组件。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Search | 搜索框组件,支持搜索图标、清除按钮、搜索按钮、placeholder提示文本、自定义键盘等功能配置,适用于浏览器的搜索内容输入框、应用内搜索等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Span | 作为Text、ContainerSpan组件的子组件,用于显示行内文本,支持对文本的字体、颜色、大小等样式进行细粒度设置。适用于在同一行文本中混合显示不同样式的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ImageSpan | Text、ContainerSpan组件的子组件,用于在文本中显示行内图片,支持设置图片对齐方式、缩放类型、加载占位图和颜色滤镜等,适用于需要在文本段落中嵌入图片实现图文混排的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ContainerSpan | Text组件的子组件,用于统一管理多个Span、ImageSpan的背景色及圆角弧度,适用于需要为文本片段和图片组合设置统一背景样式的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| SelectionContainer | 为多个文本节点提供跨节点文本选中、复制及菜单扩展能力,支持统一配置选中文本的手柄颜色和高亮颜色、灵活的文本拼接策略、自定义选择菜单和扩展菜单选项。适用于需要跨多个Text组件实现文本连续选中与统一复制的场景。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+,Wearable26.0.0+ |
| SymbolSpan | 作为Text组件的子组件,用于在文本中显示系统预置的图标小符号(Symbol图标)。支持设置颜色、大小、粗细、渲染策略和动效策略等属性,适用于状态指示、功能标识等场景。仅支持系统预置的symbol资源。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| SymbolGlyph | 用于显示系统预置的图标小符号,支持设置颜色、大小、粗细、渲染策略、动效策略等样式属性,适用于导航栏图标、按钮图标、状态指示图标等场景。相比图片资源具有体积小、可动态着色、支持动效等优势。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Hyperlink | 超链接组件,支持文本和图片两种展示形式,在组件宽高范围内点击可实现跳转到指定网页。适用于应用内打开外部网页链接的场景,仅支持与系统浏览器配合使用。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| RichText | 富文本组件,解析并显示HTML格式文本。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| 属性字符串 | 将文本样式与文本内容关联管理的对象,样式通过start和length指定文本区间,多种样式可叠加应用于同一区间。支持设置字体样式、装饰线、阴影、行高、段落样式等,还支持插入图片和自定义绘制内容,可与Text、RichEditor绑定使用。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| 输入框类组件通用接口 | 为TextInput、TextArea组件提供获取文本和光标信息、插入和删除文本、设置计数器以及文本装饰线的能力,适用于需要通过程序化方式控制输入框文本内容和光标位置的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| 文本组件公共接口 | 文本类组件的公共接口,首批接口从API version 10开始支持,仅可在Stage模型下使用。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
图片与视频
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/images-and-videos
| 组件 | 说明 | 支持设备 |
|---|---|---|
| Image | 图片组件,常用于在应用中显示图片。支持加载PixelMap、ResourceStr和DrawableDescriptor类型的数据源,支持png、jpg、jpeg、bmp、svg、webp、gif、heif和tiff类型的图片格式,不支持apng和svga格式。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ImageAnimator | 提供帧动画组件来实现逐帧播放图片的能力,可以配置需要播放的图片列表,每张图片可以配置时长。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Video | 用于播放视频文件并控制其播放状态,支持播放、暂停、进度控制、倍速播放、全屏切换等功能。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| 图像类型定义 | 图像相关类型定义,如PixelMap(图像像素类),用于读取或写入图像数据以及获取图像信息。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| SVG标签说明 | SVG是基于XML的可缩放矢量图形格式,用于描述二维图形和图像。说明Image组件支持的SVG范围(SVG1.1规范的部分功能)及支持的标签与属性。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+,Lite Wearable12+ |
| SVG标签解析能力增强 | 从API version 21开始,当Image组件的supportSvg2属性设置为true时,将启用SVG标签解析能力增强功能,主要包含SVG1.1规范中的更多功能。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+,Lite Wearable12+ |
信息展示
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/information-display
| 组件 | 说明 | 支持设备 |
|---|---|---|
| AlphabetIndexer | 可以与容器组件联动,用于按逻辑结构快速定位容器显示区域的组件(字母索引条)。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ArcAlphabetIndexer | 弧形索引条,是一种弧形的、可按字母顺序排序进行快速定位的组件,可以与容器组件联动,按逻辑结构快速定位至容器显示区域。 | Phone18+,PC/2in118+,Tablet18+,TV19+,Wearable18+ |
| Badge | 信息标记容器组件,可附加在单个组件上用于信息提醒。支持数字、字符串和圆点三种标记形式,可自定义标记样式和显示位置,适用于未读消息计数、新功能提示等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Counter | 计数器组件,提供增加或减少的计数操作。适用于商品数量选择、参数调整等需要频繁修改数值的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| DataPanel | 数据面板组件,用于将多个数据占比情况使用占比图进行展示,支持环形和线性两种展示类型,可自定义颜色、阴影、底板等视觉效果,适用于存储容量、任务进度、资源占比等数据可视化场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Gauge | 数据量规图表组件,用于将数据展示为环形图表。适用于展示任务完成进度、性能指标、数据占比等场景,支持自定义颜色、起止角度、指针样式、阴影效果等视觉配置。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| LoadingProgress | 用于显示加载进度条的组件,在数据加载过程中为用户提供视觉反馈。支持设置前景色、控制动画显示状态等特性,适用于需要在应用内展示加载进度的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Marquee | 跑马灯组件,用于滚动展示一段单行文本,支持自定义滚动速度、方向、循环次数等。仅当文本内容宽度大于等于组件宽度时滚动。适用于新闻标题滚动、通知公告、广告轮播等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| PatternLock | 图案密码锁组件,以九宫格图案的方式输入密码,用于密码验证场景。支持自定义九宫格尺寸、圆点及连线样式、选中/激活状态颜色等外观属性,支持输入过程实时反馈及密码验证结果状态设置。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Progress | 进度条组件,用于显示内容加载或操作处理等进度。支持线性、环形、圆形、胶囊等多种样式,可自定义颜色、渐变效果和动效,适用于文件下载、数据加载、任务处理等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| QRCode | 用于显示单个二维码,支持自定义二维码颜色、背景颜色及内容不透明度,适用于需要展示二维码以供扫描获取字符串信息的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| TextClock | 通过文本将当前系统时间显示在设备上,支持不同时区的时间显示和时间格式自定义,最高精度到秒级。适用于需要实时展示系统时间、支持多时区显示的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| TextTimer | 通过文本显示计时信息并控制其计时器状态的组件,支持正向计时与倒计时两种模式,可自定义显示格式,适用于秒表、考试倒计时、限时活动、运动计时等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| 信息展示公共接口 | 用于修饰组件,为Gauge和DataPanel组件提供投影等视觉信息展示能力的公共接口,支持统一配置投影模糊半径、偏移量等参数。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
空白与分隔
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/blank-and-divider
| 组件 | 说明 | 支持设备 |
|---|---|---|
| Blank | 空白填充组件,在容器主轴方向上具有自动填充容器空余部分的能力。仅当父组件为Row/Column/Flex时生效。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Divider | 提供分割线组件,用于分割不同内容块/内容元素。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
画布绘制
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/canvas-drawing
| 组件 | 说明 | 支持设备 |
|---|---|---|
| Canvas | 提供画布组件,用于自定义绘制图形。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| CanvasGradient | 渐变对象,可通过addColorStop方法设置多个颜色断点,实现平滑的颜色过渡,适用于Canvas填充和描边等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| CanvasPattern | 使用createPattern方法创建的图案对象,通过指定图像和重复方式生成图片填充的模板,适用于在Canvas中实现图案填充或背景纹理的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| CanvasRenderingContext2D | Canvas组件的2D绘图上下文对象,用于在Canvas上进行自定义绘图。支持绘制形状(矩形、圆形、椭圆、路径等)、文本、图片、渐变、阴影等,适用于数据可视化、游戏开发、图像编辑、自定义UI绘制等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| DrawingRenderingContext | 与Canvas组件绑定后可在Canvas上进行绘制,绘制对象可以是形状、文本、图片等。通过canvas属性获取DrawingCanvas对象,调用drawing模块接口绘制,最后调用invalidate()触发重新渲染。相比CanvasRenderingContext2D提供更灵活的绘制接口。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ImageBitmap | 可以存储canvas渲染的像素数据。从API version 11开始,应用创建Worker线程时支持使用postMessage将ImageBitmap实例传到Worker中绘制,并通过onmessage接收绘制结果进行显示。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ImageData | 用于存储Canvas渲染的像素数据,支持对像素进行读取、修改和操作,适用于图像处理、像素级编辑、特效滤镜等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Matrix2D | 用于CanvasRenderingContext2D、OffscreenCanvasRenderingContext2D、CanvasPattern和Path2D图形变换的矩阵对象,可以对矩阵进行缩放、旋转和平移等变换。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| OffscreenCanvas | 用于绘制自定义图形的离屏画布。提供可以在屏幕外渲染的画布,可在单独的线程中运行绘制任务,避免影响应用程序主线程性能。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| OffscreenCanvasRenderingContext2D | 用于在Canvas上进行离屏绘制,绘制对象可以是形状、文本、图片等。离屏绘制先将内容绘制在缓冲区,再转换成图片一次性绘制到Canvas上。使用CPU绘制,速度较慢,对绘制速度有要求的场景应避免使用。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Path2D | 路径对象,支持通过对象的接口进行路径的描述和组合,并通过Canvas的stroke或fill接口绘制。支持复用路径、组合多个路径、基于SVG路径字符串创建路径等功能。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| 画布绘制通用属性 | 画布绘制组件CanvasRenderingContext2D和OffscreenCanvasRenderingContext2D的通用属性。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| 画布绘制通用方法 | 为画布绘制组件CanvasRenderingContext2D和OffscreenCanvasRenderingContext2D提供绘制能力的通用方法。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
图形绘制
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/graphic-drawing
| 组件 | 说明 | 支持设备 |
|---|---|---|
| Circle | 用于绘制圆形的组件。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Ellipse | 椭圆绘制组件,通过设置宽度和高度属性绘制椭圆形状,在给定的矩形区域内渲染椭圆轮廓和填充区域。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Line | 用于在应用界面中绘制直线,支持自定义起点、终点、颜色、宽度、透明度、虚线样式、端点样式等属性。适用于绘制分隔线、装饰性线条、图表坐标轴或连接线等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Polyline | 折线绘制组件。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Polygon | 多边形绘制组件,通过设置顶点坐标列表定义多边形形状,支持填充颜色、边框样式等属性配置。适用于绘制三角形、四边形、五边形等自定义多边形形状。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Path | 路径绘制组件,根据绘制路径生成封闭的自定义形状,支持通过SVG路径描述规范定义复杂的几何形状。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Rect | 矩形绘制组件,用于在界面中绘制矩形图形,支持设置填充颜色、边框样式、圆角等属性。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Shape | 绘制组件的父组件,描述所有绘制组件均支持的通用属性。通过定义视口、填充、边框等属性支持矢量图形的绘制和组合,可包含Rect、Circle、Path等绘制子组件。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| 图形绘制通用属性 | 图形绘制组件的通用属性。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
渲染绘制
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/rendering-drawing
| 组件 | 说明 | 支持设备 |
|---|---|---|
| XComponent | 提供用于图形绘制和媒体数据写入的Surface并嵌入到视图中,支持自定义Surface位置和大小。同时支持AI图像分析、HDR视频亮度调节、防截屏录屏隐私保护、画布自绘制等能力,适用于视频播放、相机预览、游戏渲染等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Component3D | 3D渲染组件,用于将ArkGraphics 3D场景或glTF(.gltf/.glb文件)模型渲染到ArkUI界面中,支持自定义场景模式与自动场景模式,并提供自定义渲染管线能力。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| EmbeddedComponent | 用于在当前页面嵌入本应用内或满足跨应用权限条件的其他EmbeddedUIExtensionAbility提供的UI。EmbeddedUIExtensionAbility在独立进程中运行,完成页面布局和渲染。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
菜单
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/menus
| 组件 | 说明 | 支持设备 |
|---|---|---|
| Menu | 以垂直列表形式显示的菜单,支持配置菜单项、子菜单、图标、分隔线等内容,可用于展示操作选项、功能入口等场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| MenuItem | 用来展示菜单中具体的菜单选项。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| MenuItemGroup | 用于展示MenuItem的分组,支持设置分组的标题和尾部信息,适用于需要在菜单中按类别组织多个菜单项的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ContextMenu | 在页面范围内关闭通过bindContextMenu属性绑定的菜单。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
卡片
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/service-widgets
| 组件 | 说明 | 支持设备 |
|---|---|---|
| FormLink | 提供静态卡片交互组件,用于静态卡片内部和卡片提供方应用间的交互,当前支持router、message和call三种类型的事件。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
安全
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkui-security
| 组件 | 说明 | 支持设备 |
|---|---|---|
| 安全控件通用属性 | 安全控件通用属性模块,提供安全控件的布局、尺寸、文字、图标、颜色、边框和交互等通用属性的统一配置能力。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| PasteButton | 安全控件的粘贴控件。用户点击粘贴控件,应用可以临时获取读取剪贴板权限。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| SaveButton | 安全控件的保存控件,适用于应用需要临时获取媒体库访问权限以保存图片或视频的场景。用户首次使用时展示弹窗供确认,允许后应用获得访问媒体库接口的临时授权。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
主题
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/themes
| 组件 | 说明 | 支持设备 |
|---|---|---|
| WithTheme | 用于设置应用局部页面自定义主题风格,可设置子组件深浅色模式和自定义配色。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
AtomicService
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/atomic-services
| 组件 | 说明 | 支持设备 |
|---|---|---|
| AtomicServiceNavigation | 作为Page页面的根容器使用,内部默认包含标题栏、内容区。内容区在首页默认显示导航内容,在非首页显示NavDestination的子组件,首页和非首页通过路由进行切换。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| AtomicServiceSearch | 为开发者提供满足定制化需求的搜索组件,内容包括默认显示的搜索区、可自定义的选择区和功能区(最多两个)。 | Phone18+,PC/2in118+,Tablet18+,TV19+,Wearable18+ |
| AtomicServiceTabs | 高级页签组件,对Tabs组件中不需要暴露给用户自定义的属性进行简化,限制最多显示5个页签,固定页签的样式、位置和大小。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| AtomicServiceWeb | 为开发者提供满足定制化诉求的Web高阶组件,屏蔽原生Web组件中无需关注的接口,并提供JS扩展能力。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| InterstitialDialogAction | 在元服务中用于保持当前上下文环境时,临时展示用户需关注的信息或待处理的操作,用户点击弹框的不同区域可触发对应的回调动作。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| HalfScreenLaunchComponent | 半屏嵌入式启动元服务组件,当被拉起方未授权嵌入式运行元服务时,宿主将使用跳出式拉起元服务。 | Phone18+,PC/2in118+,Tablet18+,TV19+,Wearable18+ |
| NavPushPathHelper | 当跳转的目标NavDestination在不同的hsp分包且未被主包依赖时,用于先下载安装相应hsp分包,再将指定的NavDestination页面信息入栈或替换当前栈顶页面,使Navigation支持动态加载hsp分包后再跳转。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
自定义占位组件
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/custom-placeholder-comp
| 组件 | 说明 | 支持设备 |
|---|---|---|
| NodeContainer | 基础组件,用于挂载自定义节点(如FrameNode或BuilderNode中获取的根节点),并通过NodeController动态控制节点的上树和下树,适用于需要动态插入、移除自定义节点以实现UI按需加载与节点复用的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| ContentSlot | 用于渲染Native侧使用C-API创建的组件,并通过Content管理器管理这些组件。支持混合模式开发,当容器是ArkTS组件、子组件在Native侧创建时推荐使用。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
已停止维护的组件与接口
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkui-declarative-comp-dep
| 组件 | 说明 | 支持设备 |
|---|---|---|
| GridContainer | 纵向排布栅格布局容器,仅在栅格布局场景中使用。通过将容器宽度划分为指定列数实现响应式布局,子组件可占用不同的列数和偏移量。(已停止维护) | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Panel | 可滑动面板,提供一种轻量的内容展示窗口,方便在不同尺寸中切换。(已停止维护) | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| NavRouter | 导航组件,默认提供点击响应处理,不需要开发者自定义点击事件逻辑。(已停止维护) | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| Navigator | 路由容器组件,提供路由跳转能力。(已停止维护) | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| 点击控制 | 用于根据交互需求设置组件是否可以响应点击事件、触摸事件等手指交互事件。(已停止维护) | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| 栅格设置 | 栅格设置可以为布局提供规律性的结构,解决多尺寸多设备的动态布局问题,保证不同设备上各个模块的布局一致性。(已停止维护) | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+,Lite Wearable12+ |
| Stepper | 步骤导航器组件,适用于引导用户按照步骤完成任务的导航场景。(已停止维护) | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| StepperItem | 用作Stepper组件的页面子组件。(已停止维护) | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
系统预置UI组件库
分类文档:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/system-preset-ui-component-library
| 组件 | 说明 | 支持设备 |
|---|---|---|
| Chip | 用于标签展示和交互场景,支持自定义样式、图标、激活态等功能,适用于搜索框历史记录、邮件发送列表等场景,可快速实现标签的创建、删除和交互能力。仅可在Stage模型下使用,不建议设置通用属性和通用事件。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| ChipV2 | ChipV2是提供丰富样式和交互能力的操作块组件,支持前缀图标、后缀图标、激活状态、关闭按钮等特性,支持Symbol和Image两种图标类型,并提供完善的无障碍访问能力。该组件适用于搜索历史记录、邮件发送列表、标签选择、过滤器、联系人展示等场景。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+ |
| ChipGroup | ChipGroup组件提供操作块群组能力,支持单选或多选模式,可自定义样式、图标和间距,支持选中状态管理和事件回调。适用于文件分类、资源筛选、标签选择、内容分组等多种场景,帮助开发者快速实现选择功能,提供统一的视觉和交互体验。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| ChipGroupV2 | ChipGroupV2组件提供操作块群组容器,支持单选或多选、自定义样式和间距、以及尾部自定义内容。该组件适用于文件或资源内容的分类、标签选择、筛选等场景,可帮助开发者快速构建美观且交互丰富的标签组界面。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+ |
| ComposeListItem | 该组件用于展示一系列宽度相同的列表项,适用于展示连续、多行的同类数据组合(如图片与文本)。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| ComposeListItemV2 | 该组件用于展示一系列宽度相同的列表项,适用于展示连续、多行的同类数据组合(如图片与文本)。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+ |
| ComposeTitleBar | 一种普通标题栏,支持设置标题、头像(可选)和副标题(可选),可用于一级页面、二级及其以上界面配置返回键。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| ComposeTitleBarV2 | ComposeTitleBarV2组件是一种标题栏,支持设置标题、头像(可选)和副标题(可选),可用于一级页面、二级及其以上界面配置返回键。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+ |
| DownloadFileButton | 下载文件按钮,在下载文件场景中提供统一样式的下载按钮。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| DialogV2 | 弹出框是一种模态窗口,用于在保持当前上下文环境时,临时展示用户需关注的信息或待处理的操作,用户在弹出框内完成交互。模态弹出框需要用户进行交互才能够退出模态模式。DialogV2提供了提示、选择、确认、警告、加载等多种类型的弹出框,适用于确认删除、显示加载进度、用户选择项、重要提示等场景,帮助开发者简化模态对话框的实现,提供一致的用户交互体验。 | Phone18+,PC/2in118+,Tablet18+,TV19+,Wearable18+ |
| EditableTitleBar | 编辑型标题栏,适用于多选界面或者内容的编辑界面,一般采取左叉右勾的形式。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| EditableTitleBarV2 | 编辑型标题栏,适用于多选界面或内容编辑界面,一般采取左叉右勾的形式。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+ |
| ExceptionPrompt | 异常提示,适用于有异常需要提示异常内容的情况。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| ExceptionPromptV2 | 异常提示V2组件,适用于有异常需要提示异常内容的情况。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+ |
| Filter | 多条件筛选,帮助用户在大量信息中找到所需内容,应结合具体场景选择合适筛选方式。多条件筛选控件由筛选器与悬浮条构成,悬浮条可下拉展示悬浮筛选器。筛选器样式可分为多行可折叠类型与多行列表类型,并可以在筛选器最后一行附加快捷筛选器。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| FolderStack | FolderStack继承自Stack(层叠布局)控件,新增了折叠屏悬停能力,通过在FolderStack的配置项FolderStackOptions的upperItems数组上设置子组件id,使相应子组件自动避让折叠屏折痕区后移到上半屏。FolderStack适用于双折叠设备的悬停态场景,如视频播放、视频会议等应用,实现视频画面自动移至上半屏、控制面板保留在下半屏的布局。该组件能解决双折叠设备适配问题,带来提升用户体验、简化开发者布局适配工作的收益。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| FoldSplitContainer | FoldSplitContainer分栏布局,实现折叠屏二分栏、三分栏在展开态(设备完全展开状态)、悬停态(设备半折叠状态)以及折叠态(设备完全折叠状态)的区域控制。适用于折叠屏应用的响应式布局适配场景,可帮助开发者实现多屏状态下的智能分栏布局,提升用户体验。折叠状态详情可参考display.FoldStatus。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| FormMenu | 本组件封装了一个"添加至桌面"菜单,用于实现应用内长按组件生成"添加至桌面"菜单,点击该菜单,触发卡片添加至桌面操作。通过桌面访问该应用快捷卡片,可以直接访问该组件功能。在应用使用过程中,该组件作为留存和复访入口,可吸引用户将功能快捷添加到桌面。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| FullScreenLaunchComponent | 全屏启动元服务组件,当提供方授权使用方嵌入式运行元服务时,使用方全屏嵌入式运行元服务;未授权时,使用方跳出式拉起元服务。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| GridObjectSortComponent | 网格对象排序组件,用于网格对象的编辑、拖动排序、新增和删除。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| Popup | Popup是用于显示特定样式气泡的组件,支持图标、文本和按钮的灵活组合,适用于通知提示、信息确认、警告提示等场景。通过可定制的样式选项,能够快速实现一致的气泡交互体验。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| PopupV2 | PopupV2用于显示特定样式的气泡,适用于提示信息、操作确认或信息通知等需要用户关注或响应的场景。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+,Wearable26.0.0+ |
| ProgressButton | 文本下载按钮,可显示具体下载进度。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| ProgressButtonV2 | 文本下载按钮,可显示具体的下载进度。 | Phone18+,PC/2in118+,Tablet18+,TV19+ |
| SegmentButton | 分段按钮组件包含页签类分段按钮和胶囊类分段按钮。页签类分段按钮适用于页面或内容区域的切换场景;胶囊类分段按钮适用于单选或多选的选择场景,包含胶囊类单选分段按钮和胶囊类多选分段按钮。该组件支持自定义文本颜色、字体大小、字体粗细、背景色、图片尺寸、内边距、背景模糊材质等外观属性,支持仅文本、仅图标和图标+文本三种按钮样式,并提供无障碍朗读、布局方向镜像、自定义圆角、属性动画等能力,适用于需要快速构建符合设计规范的分段选择界面的场景。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| SegmentButtonV2 | 分段按钮组件用于创建页签型、单选或多选的胶囊型分段按钮,支持文本、图标、Symbol等多种选项类型及图文混合配置,可自定义字体、颜色、圆角等样式。页签型分段按钮适用于页签切换场景,单选胶囊型分段按钮适用于单选切换场景,多选胶囊型分段按钮适用于多选筛选场景。 | Phone18+,PC/2in118+,Tablet18+,TV19+ |
| SelectTitleBar | 下拉菜单标题栏包含一个下拉菜单,可用于页面之间的切换;可用于一级页面、二级及其以上界面(配置返回键)。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| SelectionMenu | 文本选择菜单,适用于RichEditor组件通过bindSelectionMenu或Text组件通过bindSelectionMenu绑定自定义文本选择菜单,支持编辑菜单和扩展下拉菜单两种类型,可通过配置实现复制、粘贴、剪切、全选等内置功能,也可通过自定义菜单项和事件回调实现扩展功能。建议绑定鼠标右键或鼠标选中方式弹出,不支持作为普通组件单独使用。适用于富文本编辑场景,可为用户提供便捷的文本操作入口,提升文本编辑效率。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| SplitLayout | SplitLayout组件提供了常用的页面布局样式,主要用于展示图片、标题和内容容器的组合布局,适用于需要自适应不同屏幕尺寸的分栏展示场景(如详情页、设置页等)。支持自适应不同屏幕宽度(小于等于600vp、大于600vp且小于等于840vp、大于840vp三种布局),解决了在不同尺寸设备上需要展示不同布局样式的需求,提升页面适配性和用户体验。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| SubHeader | 子标题,用于列表项或内容项顶部,将该列表或内容划分为一个区块,子标题名称用来概括该区块内容。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| SubHeaderV2 | 子标题,用于列表项或内容项顶部,将该列表或内容划分为一个区块,子标题名称用来概括该区块内容。 | Phone18+,PC/2in118+,Tablet18+,TV19+ |
| SwipeRefresher | 内容加载指获取内容并加载出来,常用于衔接展示下拉加载的内容。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| SwipeRefresherV2 | SwipeRefresherV2组件用于内容加载,内容加载指获取内容并加载出来,常用于衔接展示下拉加载的内容。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+ |
| TabTitleBar | 页签型标题栏,用于页面之间的切换。仅一级页面适用。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| ToolBar | 工具栏组件,用于展示针对当前界面内容的操作选项,在界面底部显示。底部最多显示5个入口,超过则收纳入"更多"子项中,在最右侧显示。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| ToolBarV2 | 工具栏用于展示针对当前界面内容的操作选项,在界面底部显示。底部最多显示5个入口,超过则收纳入"更多"子项中,在最右侧显示。 | Phone18+,PC/2in118+,Tablet18+,TV19+ |
| TreeView | 树视图作为一种分层显示的列表,适合显示嵌套结构。拥有父列表项和子列表项,可展开或折叠。 | Phone12+,PC/2in113+,Tablet12+,TV19+ |
| TreeViewV2 | 树视图V2组件。树视图作为一种分层显示的列表,适合显示嵌套结构。拥有父列表项和子列表项,可展开或折叠。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+ |
| advanced.Counter | Counter组件用于精确调节数值,支持列表型、紧凑型、数值内联型和日期内联型四种样式,适用于购物数量调节、参数设置、日期选择等场景,具有灵活的样式配置和事件回调能力。 | Phone12+,PC/2in113+,Tablet12+,TV19+,Wearable18+ |
| CounterV2 | CounterV2组件用于精确调节数值,包含列表型、紧凑型、数值内联型和日期内联型四种类型,适用于购物车数量调节、日期选择等场景。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+,Wearable26.0.0+ |
| DatePickerComponent | DatePickerComponent组件用于选择日期(年月日)和时间(时分秒)。 | Phone26.0.0+,PC/2in126.0.0+,Tablet26.0.0+,TV26.0.0+,Wearable26.0.0+ |
更多推荐



所有评论(0)