百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

HarmonyOS学习路之开发篇——Java UI框架(基础组件说明「一」)

haoteby 2025-03-24 16:32 14 浏览

一、基础组件分类

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” 无截断
… ="ellipsis_at_start"起始处使用省略号截断
… =“ellipsis_at_middle” 中间位置使用省略号截断
… =“ellipsis_at_end” 结尾处使用省略号截断
… =“auto_scrolling” 滚动显示全部文本

text_size

文本大小

ohos:text_size="30"
ohos:text_size=“16fp”

element_padding

文本与图片的边距

bubble_width
bubble_height
bubble_left_width
bubble_left_height
bubble_right_width
bubble_right_height

文本气泡宽度
文本气泡高度
文本气泡左宽度
文本气泡左高度
文本气泡右宽度
文本气泡右高度

表示尺寸的float类型。
可以是浮点数值,其默认单位为px;
也可以是带px/vp/fp单位的浮点数值;
也可以引用float资源。

max_text_lines

文本输入类型

ohos:text_input_type=“pattern_null” 无类型
… =“pattern_text” 文本类型
… =“pattern_number” 数字
… =“pattern_password” 密码

text_input_type

输入键类型

ohos:input_enter_key_type=

enter_key_type_unspecified” 无类型

… =“enter_key_type_search” “搜索”动作
… =“enter_key_type_go” “go”动作
… =“enter_key_type_send” “发送”动作

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
element_top
element_right
element_bottom
element_start
element_end

文本左侧图标
文本上方图标
文本右侧图标
文本下方图标
文本开始方向图标
文本结束方向图标

可直接配置色值,也可引用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
text_state_off

开启时显示的文本
关闭时显示的文本

可以直接设置文本字串,也可以引用string资源

track_element
thumb_element
check_element

轨迹样式
thumb样式
状态标志样式

可直接配置色值,也可引用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
text_color_off

处于选中状态的文本颜色
处于未选中状态的文本颜色

可以直接设置色值,也可以引用color资源。

check_element

状态标志样式

可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。

③ 图片类

Image是用来显示图片的组件。

Image的共有XML属性继承自:Component,Image的自有XML属性见下表:

属性名称

属性描述

使用案例

clip_alignment

图像裁剪对齐方式

ohos:clip_alignment=“left” 左对齐裁剪
… =“right” 右对齐裁剪
… =“top” 顶部对齐裁剪
… =“bottom” 底部对齐裁剪
… =“center” 居中对齐裁剪

image_src

图像

可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。

scale_mode

图像缩放类型

ohos:scale_mode=“center” 表示原图按照比例缩放到与Image最窄边一致,并居中显示
… =“zoom_start” 表示原图按照比例缩放到与Image最窄边一致,并靠起始端显示
… =“zoom_end” 表示原图按照比例缩放到与Image最窄边一致,并靠结束端显示。
… =“stretch” 表示将原图缩放到与Image大小一致。
… =“center” 表示不缩放,按Image大小显示原图中间部分。
… =“inside” 表示将原图按比例缩放到与Image相同或更小的尺寸,并居中显示。
… =“clip_center” 表示将原图按比例缩放到与Image相同或更大的尺寸,并居中显示。

未完待续…

相关推荐

Python爬虫进阶教程(二):线程、协程

简介线程线程也叫轻量级进程,它是一个基本的CPU执行单元,也是程序执行过程中的最小单元,由线程ID、程序计数器、寄存器集合和堆栈共同组成。线程的引入减小了程序并发执行时的开销,提高了操作系统的并发性能...

A320-V2500发动机系统FADEC介绍(2)

目的全权数字发动机控制(FADEC)系统在所有飞行和运行阶段提供全范围发动机控制。...

三国志战棋版:玩家“二叔”用这套群DOT在比武中拿下31胜5负

声明:本文首发于今日头条,而后发布于“鼎叔闯三棋”的微信公众号、抖音、哔哩哔哩和小红书平台,如果在其他平台就是抄袭。...

真正的独一无二:Dot One 推出 DNA 定制系列 139英镑起

相信很多人在挑选衣物时有着这样的困扰,综合了性价比、面料等因素后好不容易找到了心仪的款式,还要担心是否会撞衫,不管是擦肩而过的陌生人还是身边的熟人,都令人尴尬。小部分人为此热衷于购买少量的古着或者限量...

崩铁:周年庆福利再升级,老角色加强时间确定,3.xdot体系反转

#埃安UT大一圈高级很多#...

Dotgo推出RBMHub,扩大了CPaaS提供商的覆盖范围和功能

据telecompaper网7月15日报道,用于商业消息传递的RichCommunicationServices(RCS)解决方案的领先提供商Dotgo宣布推出RBMHub。RBMHub的推出扩大了C...

深度解析:快照取消Dot职业的将何去何从

写在前面曾几何时,术士的出现便被冠以dot大师的名头,从远古时期的献祭腐蚀虹吸不如暗牧一个痛,到TBC上满dot=荣誉击杀+1,到wlk接近全暴击的冰晶腐蚀,再到CTM就算了吧MOP的各种变态吸x放...

星穹铁道:抽卡芙卡之前,你必须了解什么是dot!

卡妈终于上线了,可还是有很多人不明白什么是dot伤害,抽了卡妈直接玩起了直伤流,把一个持续伤害的引爆器玩成了打手,卡妈打dot伤害是远高于直伤的,有了卡妈的玩家一直了解dot,不然这卡妈就真被玩成四不...

游戏界的闪耀星辰陨落:悼念知名游戏博主″dotα牛娃″

无尽哀思!在数字时代浪潮中,游戏不仅是消遣娱乐的代名词,更是连接心灵的桥梁,构筑了无数人的青春回忆。在这片浩瀚无垠的游戏宇宙中,有这样一位博主,他以独特的风采、深邃的洞察力和无尽的热情,成为了玩家心中...

直击2017新加坡同性恋聚会Pink Dot,自由爱!

今年的“粉红点”又来啦~这个支持LGBT群体(男女同志、双性恋、跨性别等)群体的活动,从2009年起,已经在新加坡举办8年了!”这个非营利的同性恋权益活动,主要是希望大家了解到,不管一个人的性倾向或...

python-dotenv,一款超级实用处理环境变量python库

python-dotenv,一款超级实用处理环境变量python库python-dotenv概述:...

亚马逊语音助手毫无征兆发笑 诡异至极吓坏用户

来源:新华网美国电商亚马逊7日承诺,将更改名下“亚历克萨”语音系统设置,令它不会莫名发笑,免得吓坏用户。“亚历克萨”是亚马逊开发的语音助手软件,可服从用户语音指令完成对话、播放音乐等任务。依照原来设计...

2022最火英文网名男女生

精选好听英文昵称带翻译1.moveon(离开)2.Monster(怪物)3.Solo吉他手4.Finish.(散场)...

智能家具 RecycleDot 的出现给传统家具厂商带来新的挑战

从可穿戴手环、手表到智能衣服,智能硬件逐步渗透到每一个领域。最近有一对父子MikeSandru和JohnSandru在自家的车库中设计了一款智能家具RecycleDot,给日渐萧条的家具行...

欧洲通信卫星公司 OneWeb 敦促印度DoT尽早批准提供卫星宽带服务

据telecomtalk2月17日报道,欧洲通信卫星公司EutelsatOneWeb近日敦促印度电信部(DoT)尽快批准其在印度部署双地球站网关的计划,以便连接其近地轨道(LEO)全球卫星星座,并...