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

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

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

一、基础组件分类

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相同或更大的尺寸,并居中显示。

未完待续…

相关推荐

统统都能轻松装下。_如何安装统赢

今天必须来好好聊聊迈腾甄选款的外观升级优势,简直是把经典与时尚玩明白了!迈腾甄选款巧妙地保留了迈腾的经典气场和造型,就像一位历经岁月沉淀却风采依旧的绅士。2871mm的超长轴距搭配超短前后悬设计,这就...

麒麟操作系统常见问题:打开火狐浏览器提示没有安装flash插件

关键词:火狐浏览器、flash、插件、安装问题类型:...

VS Code 新手必装插件清单_vs code 安装插件

以下是针对VSCode新手的必装插件清单,覆盖代码编辑、效率提升、美化等核心需求,适用于大多数开发场景:一、基础必备插件Chinese(Simplified)(简体中文)功能:将VSC...

开源JSON可视神器,让阅读JSON变得简单!-JSONHero

众所周知,现在有不少代码编辑器以及在线工具,都支持JSON格式化,因此这一特性,已经不能称的上是亮点。调试工具已经成为每个开发者不可或缺的“利器”。但是,你见过能直接可视化JSON数据,把整个...

在NAS上部署Barcode服务_nas basic

部署基于BWIP-JS的条形码生成APIBWIP-JS是一个优秀的JavaScript条形码生成库,它支持多种条形码类型,并且可以运行在Node.js环境下,非常适合用来构建API服务。...

详细介绍一下Python如何对JSON格式数据进行处理?

在Python中对于JSON数据的处理是在日常开发中的常见需求之一。通常情况下,对JSON数据的处理主要涉及到如下的的几个步骤对于JSON数据的解析操作对于JSON数据的处理操作对于JSON数据的格式...

golang2021数据格式(69)Go语言将结构体数据保存为JSON格式数据

JSON格式是一种对象文本格式,是当前互联网最常用的信息交换格式之一。在Go语言中,可以使用json.Marshal()函数将结构体格式的数据格式化为JSON格式。想要使用json...

一个vsCode格式化插件_vscode 格式化文档

ESlint...

自己抓取家中IPTV组播地址,不用交换机或多网卡,远程抓取更方便

通过IPTV播放应用在电视、电脑或者手机观看家中的IPTV电视直播,可以摆脱IPTV机顶盒的限制,方便在家中多台电视或者手机电脑上观看IPTV电视直播。运营商IPTV的电视直播信号稳定、高清,和互联网...

扣子免费系列教程, 如何使用扣子(coze)对接飞书多维表格?

一、说明大家都知道使用扣子(coze)把一些文本内容转为小红书风格很方便。但每次都是复制粘贴。很麻烦那能不能批量呢?今天我们就来学习下,使用扣子(coze)平台完成内容的批量转换。基本思路是读取飞书多...

1024程序员节 花了三个小时调试 集合近50种常用小工具 开源项目

开篇1024是程序员节了,本来我说看个开源项目花半个小时调试之前看的一个不错的开源项目,一个日常开发常常使用的工具集,结果花了我三个小时,开源作者的开源项目中缺少一些文件,我一个个在网上找的,好多坑...

办公人必看!3分钟搞定JSON/XML/Markdown,格式转换竟如此简单!

你是不是也遇到过这些情况:领导突然甩来一份密密麻麻的数据文件,要你半小时内整理成报表;想写技术文档,却被Markdown的语法搞得头大;或者同事发来的JSON文件,打开全是“{”“}”“,”,看得眼花...

开发者必备!zerotools.top全栈效率神器

强烈建议开发者们收藏https://zerotools.top,用它来提升日常效率。一、功能覆盖:从数据到图像的全栈支持Zerotools.top的最大亮点,是其功能维度的完整性。根据最新页面...

15 个非常好用的 JSON 工具_json tools

JSON(JavaScriptObjectNotation)是一种流行的数据交换格式,已经成为许多应用程序中常用的标准。无论您是开发Web应用程序,构建API,还是处理数据,使用JSON工具可以大...

C#.NET Newtonsoft.Json 详解_c# jsonresult

简介Newtonsoft.Json(又称...