HarmonyOS学习路之开发篇——Java UI框架(基础组件说明「一」)
zhezhongyun 2025-07-23 19:22 23 浏览
一、基础组件分类
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最窄边一致,并居中显示 |
未完待续…
相关推荐
- Opinion丨Struggle Against U.S. Mind colonization in the Global South
-
Editor'snote:Thismonth,XinhuaNewsAgency'sThinkTankreleasedareporttitled"Colonizationof...
- 爱可可AI论文推介(2020.11.4)_爱可可女装旗舰店
-
LG-机器学习CV-计算机视觉CL-计算与语言AS-音频与语音RO-机器人(*表示值得重点关注)1、[LG]*CombiningLabelPropagationan...
- 何新:罗马伪史考英文版序言_罗马史学
-
2019-10-2514:48:27何新:罗马伪史考序言(英文译本)HeXin:PreambleofResearchonPseudo-historyofRome1Afewyear...
- XPeng Stock Rises Over 4% after Q2 Revenue and EV Margin Set Records
-
TMTPOST--TheAmericandepositaryreceipts(ADRs)ofXPengInc.rosearound4.2%onTuesdayaftert...
- 英汉世界语部首(八)_英文部首字典
-
本节讲八个部首,分别是:弓gōng【ECWLrad】bow廾gǒng【ECWLrad】twen广guǎng【ECWLrad】vast己jǐ【ECWLrad】self已yǐ...
- 一课译词:划水_划水是什么地方的方言
-
[Photo/SIPA]懒惰是人类的天性,因此才总有人会在工作时“划水”。“划水【huáshuǐ】”,本意是指“用胳膊划的动作(makestrokeswithone’sarms)”,延伸为“...
- 首测!GPT-4o做Code Review可行吗?
-
编辑|言征出品|51CTO技术栈(微信号:blog51cto)近日,OpenAI一记重拳,推出了GPT-4o(“o”表示“omni”),将语音识别和对话方面的优势展示的淋漓尽致。几乎可以肯定,...
- C++|漫谈STL细节及内部原理_c++ stl详解
-
1988年,AlexanderStepanov开始进入惠普的PaloAlto实验室工作,在随后的4年中,他从事的是有关磁盘驱动器方面的工作。直到1992年,由于参加并主持了实验室主任BillWo...
- C++ inline关键字深度解析:不止于优化的头文件定义许可
-
在C++开发中,几乎每个程序员都用过inline关键字,但多数人只停留在“内联优化”的表层理解。事实上,inline的真正威力在于它打破了C++的单一定义规则(ODR)限制,成为头文件中安全定义函数的...
- 实用 | 10分钟教你搭建一个嵌入式web服务器
-
之前分享的文章中提到了几种可以在嵌入式中使用的web服务器。嵌入式web服务器就是把web服务器移植到嵌入式系统的服务器。它仍然是基于http文本协议进行通信的,具有标准的接口形式,对客户端...
- 中间语言格式_中间格式文本是什么
-
在通常情况下,编译器会将目标语言转换成某种中间语言格式,而不是直接将源代码转换成二进制机器指令,不少c语言编译器,都会将代码编译成汇编语言,然后再通过汇编语言编译器将汇编代码转换成目标机器可执行的二进...
- 一线开发大牛带你深度解析探讨模板解释器,解释器的生成
-
解释器生成解释器的机器代码片段都是在TemplateInterpreterGenerator::generate_all()中生成的,下面将分小节详细展示该函数的具体细节,以及解释器某个组件的机器代码...
- 干货,Web开发和前端开发逆天工具大全
-
微信ID:WEB_wysj(点击关注)◎◎◎◎◎◎◎◎◎一┳═┻︻▄(点击页底“阅读原文”前往下载)●●●逆天工具CDN资源库国内Bootstrap中文网开源项目免费CDN服务36...
- 移动端rem+vw适配_移动端web页面适配方案
-
rem:rem是相对单位,设置根元素html的font-size,比如给html设置字体大小为100px,1rem=100px;rem缺点:1.和根元素font-size值强耦合,系统字...
- 从零搭建 React 开发 H5 模板_react html5
-
项目创建创建项目文件夹mkdir react-democd react-demonpm init -y依赖安装yarn add rea...
- 一周热门
- 最近发表
-
- Opinion丨Struggle Against U.S. Mind colonization in the Global South
- 爱可可AI论文推介(2020.11.4)_爱可可女装旗舰店
- 何新:罗马伪史考英文版序言_罗马史学
- XPeng Stock Rises Over 4% after Q2 Revenue and EV Margin Set Records
- 英汉世界语部首(八)_英文部首字典
- 一课译词:划水_划水是什么地方的方言
- 首测!GPT-4o做Code Review可行吗?
- C++|漫谈STL细节及内部原理_c++ stl详解
- C++ inline关键字深度解析:不止于优化的头文件定义许可
- 实用 | 10分钟教你搭建一个嵌入式web服务器
- 标签列表
-
- 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)
- opacity 属性 (32)
- transition 属性 (33)