HarmonyOS学习路之开发篇——Java UI框架(基础组件说明「一」)
zhezhongyun 2025-07-23 19:22 5 浏览
一、基础组件分类
HarmonyOS的常用组件一般在resources/base/layout下的xml文件中声明,然后在AbilitySlice中通过super.setUIContent(ResourceTable.某layout布局的文件名)来加载布局。在AbilitySlice中通过super.findComponentById(ResourceTable.组件的id)获取组件,获取成功后就可以对该组件进行操作,如添加监听,设置内容等。当然也可以通过代码动态的使用控件。
组件之间的继承关系:
基础组件的分类如下(个人分类):
- 文本类
Text,TextField - 按钮类
Button,Switch,RadioButton,RadioContainer,Checkbox - 图片类
Image - 选择器类
Picker,DatePicker,TimePick - 进度条
ProgressBar,RoundProgressBar - 导航
TabList、Tab,PageSlider,PageSliderIndicator - Dialog弹窗
ToastDialog,PopupDialog,CommonDialog - 列表
ListContainer - 滚动条
ScrollView - 网页
WebView
二、分类说明
① 文本类
Text提供了一种文本显示。TextField提供了一种文本输入框。
Text的自有属性:
属性名称 | 属性描述 | 使用案例 |
text | 显示文本 | ohos:text=“文本内容” |
hint | 提示文本 | ohos:hint=“请输入用户名” |
text_font | 字体 | ohos:text_font=“HwChinese-medium” |
truncation_mode | 长文本截断方式 | ohos:truncation_mode=“none” 无截断 |
text_size | 文本大小 | ohos:text_size="30" |
element_padding | 文本与图片的边距 | … |
bubble_width | 文本气泡宽度 | 表示尺寸的float类型。 |
max_text_lines | 文本输入类型 | ohos:text_input_type=“pattern_null” 无类型 |
text_input_type | 输入键类型 | ohos:input_enter_key_type= |
auto_scrolling_duration | 自动滚动时长 | ohos:auto_scrolling_duration=“1000” |
multiple_lines | 多行模式设置 | ohos:multiple_lines=“true” |
auto_font_size | 是否支持文本自动调整 文本字体大小 | ohos:auto_font_size=“true” |
scrollable | 文本是否可滚动 | ohos:scrollable=“true” |
italic | 文本是否为斜体字体 | ohos:italic=“true” |
padding_for_text | 设置文本顶部与底部是否默认留白。 | ohos:padding_for_text=“true” |
additional_line_spacing | 需增加的行间距 | ohos:additional_line_spacing=“2.0” |
line_height_num | 行间距倍数 | ohos:line_height_num=“1.5” |
element_left | 文本左侧图标 | 可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。 |
TextField的共有XML属性继承自:Text
TextField的自有属性:
属性名称 | 属性描述 | 使用案例 |
basement | 输入框基线 | 可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。 |
② 按钮类
Button是一种常见的组件,点击可以触发对应的操作,通常由文本或图标组成,也可以由图标和文本共同组成。
Button无自有的XML属性,共有XML属性继承自:Text,其本身并无其他特殊属性。
Switch是切换单个设置开/关两种状态的组件。
Switch的共有XML属性继承自:Text,Switch的自有XML属性见下表:
属性名称 | 属性描述 | 使用案例 |
text_state_on | 开启时显示的文本 | 可以直接设置文本字串,也可以引用string资源 |
track_element | 轨迹样式 | 可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。 |
marked | 当前状态(选中或未选中) | 可以直接设置true/false,也可以引用boolean资源。true则当前状态为选中,false则当前状态为未选中。 |
RadioButton用于多选一的操作,需要搭配RadioContainer使用,实现单选效果。
RadioButton的共有XML属性继承自:Text,RadioButton的自有XML属性见下表:
属性名称 | 属性描述 | 使用案例 |
marked | 当前状态(选中或未选中) | 可以直接设置true/false,也可以引用boolean资源。true则当前状态为选中,false则当前状态为未选中。 |
text_color_on | 处于选中状态的文本颜色 | 可以直接设置色值,也可以引用color资源。 |
text_color_off | 处于未选中状态的文本颜色 | 可以直接设置色值,也可以引用color资源。 |
check_element | 状态标志样式 | 可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。 |
Checkbox可以实现选中和取消选中的功能。
Checkbox的共有XML属性继承自:Text,Checkbox的自有XML属性见下表:
属性名称 | 属性描述 | 使用案例 |
marked | 当前状态(选中或未选中) | ohos:marked=“true” |
text_color_on | 处于选中状态的文本颜色 | 可以直接设置色值,也可以引用color资源。 |
check_element | 状态标志样式 | 可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。 |
③ 图片类
Image是用来显示图片的组件。
Image的共有XML属性继承自:Component,Image的自有XML属性见下表:
属性名称 | 属性描述 | 使用案例 |
clip_alignment | 图像裁剪对齐方式 | ohos:clip_alignment=“left” 左对齐裁剪 |
image_src | 图像 | 可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。 |
scale_mode | 图像缩放类型 | ohos:scale_mode=“center” 表示原图按照比例缩放到与Image最窄边一致,并居中显示 |
未完待续…
相关推荐
- Trump Pushes for 15%-20% Minimum Tariffs on EU, Sticks to Auto Duties: Report
-
TMTPOST--U.S.PresidentDonaldTrumpistakingatougherstanceduringtradenegotiationswiththe...
- Note-15.使用A4988控制步进电机(dvp15mc11t控制步进电机)
-
如果需要控制一堆步进电机,那么只使用一个Arduino来控制,就会占用大量的处理时间,而无法处理其他事情,除非使用一个独立的专用步进电机驱动器:A4988。A4988只需两个引脚就可以控制双极步进电机...
- Negotiated settlement, not sanctions, the right way to end the Ukraine crisis
-
Negotiatedsettlement,notsanctions,therightwaytoendtheUkrainecrisis:ChinaDailyeditorial...
- U.S. Services May be Added to EU's Retaliatory Target List as More Members Seek Powerful Trade Tool If Talks Fail
-
TMTPOST--AmericanservicescouldbeaddedtotheEuropeanUnion’sretaliatorytargetlist,highlig...
- S7-1200伺服指令运动指令(s71200伺服位置控制实例)
-
1.MC_Halt指令名称:停止轴运行指令功能:停止所有运动并以组态的减速度停止轴。使用技巧:常用MC_Halt指令来停止通过MC_MoveVelocity指令触发的轴的运行。『注意』部分输入/输出管...
- Deepseek太强了!等了10年的Excel模糊下拉,竟然5分钟就搞定了
-
今天跟大家分享下我们如何通过Deepseek来编写VBA代码,制作模糊搜索的下拉菜单,这个等来十来年的功能,用Deepseek竟然几分钟就搞定了,不得不感叹AI工具的强大,我们以后能干的过AI吗,这真...
- 7.Unity物理关节(unity物理骨骼)
-
7.物理关节Unity的物理关节组件将刚体连接到另一个刚体或空间中的固定点。施加使刚体移动的力,关节限制可以限制移动。关节赋予刚体一定的自由度,从而使这些刚体具有不同的运动。Unity提供的物理关...
- 西门子111报文对应FB284引脚(西门子111报文详解)
-
西门子FB284是基于111报文的功能块,使用FB284比较方便,直接调用就可以控制V90伺服的定位控制。下面是整理的FB284对应的111报文。便于理解FB284功能块,更方面应用在实际项目中。11...
- 数据质量动态探查及相关前端实现(数据质量改进实践指南)
-
需求背景数据探查上线之前,数据验证都是通过写SQL方式进行查询的,从编写SQL,到解析运行出结果,不仅时间长,还会反复消耗计算资源,探查上线后,只需要一次探查,就可以得到整张表的探查报告,但后续...
- 阿里面试官:你连个排序算法都讲不明白?出门右拐吧
-
排序算法一表总览其他注意事项:计数排序中,kkk是整数的范围稳定性是指,序列中相同的数是否有可能交换顺序,例如序列中有两个8,顺序为888和8′8^{'}8′,如果在排序完之后,顺序有...
- 直流电机速度、位置双环控制简明教程
-
速度、位置的双环控制是我们在电机的控制系统中常用的方法,很实用。下面让我们来看一下内部实现的原理。1.速度闭环控制我们一般在速度闭环控制系统里面,使用增量式PI控制。而在我们的微处理器里面,因为控制器...
- 纳米机器人的精准定位与导航(纳米机器人怎么控制位置)
-
纳米机器人的精准定位与导航涉及多学科交叉技术,其“源码”(控制逻辑与算法)需结合硬件特性、环境感知和执行器设计。以下从控制原理、算法逻辑、关键技术实现等方面提供概念性思路(非实际可运行代码),供技术探...
- C语言进阶教程:多级指针的应用(c语言一级指针和二级指针)
-
在C语言中,指针可以指向变量的地址。多级指针(PointerstoPointers或MultilevelPointers)则是指向另一个指针地址的指针。这种概念可以扩展到任意级别(二级指针、...
- 被 Trac 的文件整理能力圈粉了!这 “香” 气挡不住
-
前阵子整理电脑文件夹时,我遇到了个麻烦:上千个文档和照片,要是手动一个个重命名、分类,不仅手得点到发麻,估计还得耗上一上午。于是我就琢磨着,能不能找个办法实现一键批量重命名。我先在网上搜了些批量改名软...
- Enhancer-轻量化的字节码增强组件包
-
一、问题描述当我们的业务发展到一定阶段的时候,系统的复杂度往往会非常高,不再是一个简单的单体应用所能够承载的,随之而来的是系统架构的不断升级与演变。一般对于大型的ToC的互联网企业来说,整个系统都是...
- 一周热门
- 最近发表
-
- Trump Pushes for 15%-20% Minimum Tariffs on EU, Sticks to Auto Duties: Report
- Note-15.使用A4988控制步进电机(dvp15mc11t控制步进电机)
- Negotiated settlement, not sanctions, the right way to end the Ukraine crisis
- U.S. Services May be Added to EU's Retaliatory Target List as More Members Seek Powerful Trade Tool If Talks Fail
- S7-1200伺服指令运动指令(s71200伺服位置控制实例)
- Deepseek太强了!等了10年的Excel模糊下拉,竟然5分钟就搞定了
- 7.Unity物理关节(unity物理骨骼)
- 西门子111报文对应FB284引脚(西门子111报文详解)
- 数据质量动态探查及相关前端实现(数据质量改进实践指南)
- 阿里面试官:你连个排序算法都讲不明白?出门右拐吧
- 标签列表
-
- HTML 教程 (33)
- HTML 简介 (35)
- HTML 实例/测验 (32)
- HTML 测验 (32)
- JavaScript 和 HTML DOM 参考手册 (32)
- HTML 拓展阅读 (30)
- HTML文本框样式 (31)
- HTML滚动条样式 (34)
- HTML5 浏览器支持 (33)
- HTML5 新元素 (33)
- HTML5 WebSocket (30)
- HTML5 代码规范 (32)
- HTML5 标签 (717)
- HTML5 标签 (已废弃) (75)
- HTML5电子书 (32)
- HTML5开发工具 (34)
- HTML5小游戏源码 (34)
- HTML5模板下载 (30)
- HTTP 状态消息 (33)
- HTTP 方法:GET 对比 POST (33)
- 键盘快捷键 (35)
- 标签 (226)
- HTML button formtarget 属性 (30)
- CSS 水平对齐 (Horizontal Align) (30)
- opacity 属性 (32)