HarmonyOS从简单页面开始

这篇具有很好参考价值的文章主要介绍了HarmonyOS从简单页面开始。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

常用基础组件

1 组件介绍

组件(Component)是界面搭建与显示的最小单位,HarmonyOS ArkUI声明式开发范式为开发者提供了丰富多样的UI组件,我们可以使用这些组件轻松的编写出更加丰富、漂亮的界面。

组件根据功能可以分为以下五大类:基础组件、容器组件、媒体组件、绘制组件、画布组件。其中基础组件是视图层的基本组成单元,包括Text、Image、TextInput、Button、LoadingProgress等,例如下面这个常用的登录界面就是由这些基础组件组合而成。

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

下面我们将分别介绍这些常用基础组件的使用。

2 Text

Text组件用于在界面上展示一段文本信息,可以包含子组件Span。

文本样式

针对包含文本元素的组件,例如Text、Span、Button、TextInput等,可使用fontColor、fontSize、fontStyle、 fontWeight、fontFamily这些文本样式,分别设置文本的颜色、大小、样式、粗细以及字体,文本样式的属性如下表:

名称 参数类型 描述
fontColor ResourceColor 设置文本颜色。
fontSize Length | Resource 设置文本尺寸,Length为number类型时,使用fp单位。
fontStyle FontStyle 设置文本的字体样式。默认值:FontStyle.Normal。
fontWeight number | FontWeight | string 设置文本的字体粗细,number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。string类型仅支持number类型取值的字符串形式,例如“400”,以及“bold”、“bolder”、“lighter”、“regular”、“medium”,分别对应FontWeight中相应的枚举值。默认值:FontWeight.Normal。
fontFamily string | Resource 设置文本的字体列表。使用多个字体,使用“,”进行分割,优先级按顺序生效。例如:“Arial,sans-serif”。

下面示例代码中包含两个Text组件,第一个使用的是默认样式,第二个给文本设置了一些文本样式。

@Entry
@Component
struct TextDemo {
  build() {
    Row() {
      Column() {
        Text('HarmonyOS')
        Text('HarmonyOS')
          .fontColor(Color.Blue)
          .fontSize(20)
          .fontStyle(FontStyle.Italic)
          .fontWeight(FontWeight.Bold)
          .fontFamily('Arial')
      }
      .width('100%')
    }
    .backgroundColor(0xF1F3F5)
    .height('100%')
  }
}

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

除了通用属性和文本样式设置,下面列举了一些Text组件的常用属性的使用。

设置文本对齐方式

使用textAlign属性可以设置文本的对齐方式,示例代码如下:

Text('HarmonyOS')
  .width(200)
  .textAlign(TextAlign.Start)
  .backgroundColor(0xE6F2FD)

textAlign参数类型为TextAlign,定义了以下几种类型:

  • Start(默认值):水平对齐首部。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Center:水平居中对齐。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • End:水平对齐尾部。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

设置文本超长显示

当文本内容较多超出了Text组件范围的时候,您可以使用textOverflow设置文本截取方式,需配合maxLines使用,单独设置不生效,maxLines用于设置文本显示最大行数。下面的示例代码将textOverflow设置为Ellipsis ,它将显示不下的文本用 “…” 表示:

Text('This is the text content of Text Component This is the text content of Text Component')
  .fontSize(16)
  .maxLines(1)
  .textOverflow({overflow:TextOverflow.Ellipsis})
  .backgroundColor(0xE6F2FD) 

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

设置文本装饰线

使用decoration设置文本装饰线样式及其颜色,大家在浏览网页的时候经常可以看到装饰线,例如带有下划线超链接文本。decoration包含type和color两个参数,其中type用于设置装饰线样式,参数类型为TextDecorationTyp,color为可选参数。

下面的示例代码给文本设置了下划线,下划线颜色为黑色:

Text('HarmonyOS')
  .fontSize(20)
  .decoration({ type: TextDecorationType.Underline, color: Color.Black })
  .backgroundColor(0xE6F2FD)

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

TextDecorationTyp包含以下几种类型:

  • None:不使用文本装饰线。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Overline:文字上划线修饰。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • LineThrough:穿过文本的修饰线。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Underline:文字下划线修饰。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

3 Image

Image组件用来渲染展示图片,它可以让界面变得更加丰富多彩。只需要给Image组件设置图片地址、宽和高,图片就能加载出来,示例如下:

Image($r("app.media.icon"))
  .width(100)
  .height(100)

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

设置缩放类型

为了使图片在页面中有更好的显示效果,有时候需要对图片进行缩放处理。您可以使用objectFit属性设置图片的缩放类型,objectFit的参数类型为ImageFit。

现有原始图片如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

将图片加载到Image组件,设置宽高各100,设置objectFit为Cover(默认值),设置图片背景色为灰色0xCCCCCC。示例代码如下:

Image($r("app.media.image2"))
  .objectFit(ImageFit.Cover)
  .backgroundColor(0xCCCCCC)
  .width(100)
  .height(100) 

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

ImageFit包含以下几种类型:

  • Contain:保持宽高比进行缩小或者放大,使得图片完全显示在显示边界内。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Cover(默认值):保持宽高比进行缩小或者放大,使得图片两边都大于或等于显示边界。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Auto:自适应显示。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Fill:不保持宽高比进行放大缩小,使得图片充满显示边界。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • ScaleDown:保持宽高比显示,图片缩小或者保持不变。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • None:保持原有尺寸显示。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

加载网络图片

比如浏览新闻的时候,图片一般从网络加载而来,Image组件支持加载网络图片,将图片地址换成网络图片地址进行加载。

Image('https://www.example.com/xxx.png')

为了成功加载网络图片,您需要在module.json5文件中申明网络访问权限。

{
    "module" : {
        "requestPermissions":[
           {
             "name": "ohos.permission.INTERNET"
           }
        ]
    }
}

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

应用访问网络需要申请ohos.permission.INTERNET权限,因为HarmonyOS提供了一种访问控制机制即应用权限,用来保证这些数据或功能不会被不当或恶意使用。关于应用权限的的详细信息开发者可以参考:访问控制。

4 TextInput

TextInput组件用于输入单行文本,响应输入事件。TextInput的使用也非常广泛,例如应用登录账号密码、发送消息等。和Text组件一样,TextInput组件也支持文本样式设置,下面的示例代码实现了一个简单的输入框:

TextInput()
  .fontColor(Color.Blue)
  .fontSize(20)
  .fontStyle(FontStyle.Italic)
  .fontWeight(FontWeight.Bold)
  .fontFamily('Arial') 

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

设置输入提示文本

当我们平时使用输入框的时候,往往会有一些提示文字。例如登录账号的时候会有“请输入账号”这样的文本提示,当用户输入内容之后,提示文本就会消失,这种提示功能使用placeholder属性就可以轻松的实现。您还可以使用placeholderColor和placeholderFont分别设置提示文本的颜色和样式,示例代码如下:

TextInput({ placeholder: '请输入帐号' })
  .placeholderColor(0x999999)
  .placeholderFont({ size: 20, weight: FontWeight.Medium, family: 'cursive', style: FontStyle.Italic })

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

设置输入类型

可以使用type属性来设置输入框类型。例如密码输入框,一般输入密码的时候,为了用户密码安全,内容会显示为“…”,针对这种场景,将type属性设置为InputType.Password就可以实现。示例代码如下:

TextInput({ placeholder: '请输入密码' })
  .type(InputType.Password)

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

type的参数类型为InputType,包含以下几种输入类型:

  • Normal:基本输入模式。支持输入数字、字母、下划线、空格、特殊字符。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Password:密码输入模式。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Email:e-mail地址输入模式。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Number:纯数字输入模式。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

设置光标位置

可以使用TextInputController动态设置光位置,下面的示例代码使用TextInputController的caretPosition方法,将光标移动到了第二个字符后。

@Entry
@Component
struct TextInputDemo {
  controller: TextInputController = new TextInputController()
 
  build() {
    Column() {
      TextInput({ controller: this.controller })
      Button('设置光标位置')
        .onClick(() => {
          this.controller.caretPosition(2)
        })
    }
    .height('100%')
    .backgroundColor(0xE6F2FD)
  }
}

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

获取输入文本

我们可以给TextInput设置onChange事件,输入文本发生变化时触发回调,下面示例代码中的value为实时获取用户输入的文本信息。

@Entry
@Component
struct TextInputDemo {
  @State text: string = ''
 
  build() {
    Column() {
      TextInput({ placeholder: '请输入账号' })
        .caretColor(Color.Blue)
        .onChange((value: string) => {
          this.text = value
        })
      Text(this.text)
    }
    .alignItems(HorizontalAlign.Center)
    .padding(12)
    .backgroundColor(0xE6F2FD)
  }
}

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

5 Button

Button组件主要用来响应点击操作,可以包含子组件。下面的示例代码实现了一个“登录按钮”:

Button('登录', { type: ButtonType.Capsule, stateEffect: true })
  .width('90%')
  .height(40)
  .fontSize(16)
  .fontWeight(FontWeight.Medium)
  .backgroundColor('#007DFF')

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

设置按钮样式

type用于定义按钮样式,示例代码中ButtonType.Capsule表示胶囊形按钮;stateEffect用于设置按钮按下时是否开启切换效果,当状态置为false时,点击效果关闭,默认值为true。

我们可以设置多种样式的Button,除了Capsule可以以设置Normal和Circle:

  • Capsule:胶囊型按钮(圆角默认为高度的一半)。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Circle:圆形按钮。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

  • Normal:普通按钮(默认不带圆角)。

    HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

设置按钮点击事件

可以给Button绑定onClick事件,每当用户点击Button的时候,就会回调执行onClick方法,调用里面的逻辑代码。

Button('登录', { type: ButtonType.Capsule, stateEffect: true })
  ...
  .onClick(() => {
  // 处理点击事件逻辑
  })

包含子组件

Button组件可以包含子组件,让您可以开发出更丰富多样的Button,下面的示例代码中Button组件包含了一个Image组件:

Button({ type: ButtonType.Circle, stateEffect: true }) {
  Image($r('app.media.icon_delete'))
    .width(30)
    .height(30)
}
.width(55)
.height(55)
.backgroundColor(0x317aff)

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

6 LoadingProgress

LoadingProgress组件用于显示加载进展,比如应用的登录界面,当我们点击登录的时候,显示的“正在登录”的进度条状态。LoadingProgress的使用非常简单,只需要设置颜色和宽高就可以了。

LoadingProgress()
  .color(Color.Blue)
  .height(60)
  .width(60)

效果图如下:

HarmonyOS从简单页面开始,harmonyos,华为,鸿蒙系统

7 使用资源引用类型

Resource是资源引用类型,用于设置组件属性的值。推荐大家优先使用Resource类型,将资源文件(字符串、图片、音频等)统一存放于resources目录下,便于开发者统一维护。同时系统可以根据当前配置加载合适的资源,例如,开发者可以根据屏幕尺寸呈现不同的布局效果,或根据语言设置提供不同的字符串。

例如下面的这段代码,直接在代码中写入了字符串和数字这样的硬编码。

Button('登录', { type: ButtonType.Capsule, stateEffect: true })
  .width(300)
  .height(40)
  .fontSize(16)
  .fontWeight(FontWeight.Medium)
  .backgroundColor('#007DFF')

我们可以将这些硬编码写到entry/src/main/resources下的资源文件中。

在string.json中定义Button显示的文本。

{
  "string": [
    {
      "name": "login_text",
      "value": "登录"
    }
  ]
} 

在float.json中定义Button的宽高和字体大小。

{
  "float": [
    {
      "name": "button_width",
      "value": "300vp"
    },
    {
      "name": "button_height",
      "value": "40vp"
    },
    {
      "name": "login_fontSize",
      "value": "18fp"
    }
  ]
}

在color.json中定义Button的背景颜色。

{
  "color": [
    {
      "name": "button_color",
      "value": "#1890ff"
    }
  ]
}

然后在Button组件通过“$r(‘app.type.name’)”的形式引用应用资源。app代表应用内resources目录中定义的资源;type代表资源类型(或资源的存放位置),可以取“color”、“float”、“string”、“plural”、“media”;name代表资源命名,由开发者定义资源时确定。

Button($r('app.string.login_text'), { type: ButtonType.Capsule })
  .width($r('app.float.button_width'))
  .height($r('app.float.button_height'))
  .fontSize($r('app.float.login_fontSize'))
  .backgroundColor($r('app.color.button_color'))

8 参考资料

常用基础的组件的更多使用方法可以参考:

  • Text
  • Image
  • TextInput
  • Button
  • LoadingProgress

引用资源类型的使用可以参考:文章来源地址https://www.toymoban.com/news/detail-756730.html

os.com/cn/docs/documentation/doc-references/ts-basic-components-image-0000001281001226)

  • TextInput
  • Button
  • LoadingProgress

引用资源类型的使用可以参考:

  • 资源访问

到了这里,关于HarmonyOS从简单页面开始的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 【华为鸿蒙系统学习】- HarmonyOS4.0开发|自学篇

    ​ 🌈个人主页: Aileen_0v0 🔥热门专栏: 华为鸿蒙系统学习|计算机网络|数据结构与算法 💫个人格言: \\\"没有罗马,那就自己创造罗马~\\\" 目录 HarmonyOS 4.0 技术介绍: HarmonyOS三大特征:     1.实现硬件互助,资源共享。      2. 面向开发者,实现一次开发,多端部署。  3.一套操

    2024年02月05日
    浏览(41)
  • [Linux]华为的系统 欧拉 鸿蒙 openEuler HarmonyOS OpenHarmony

    之前整理过《华为机器运行什么桌面系统?EulerOS openEuler LiteOS 鸿蒙 深度 UOS》,但差不多快两年了,今天再梳理下华为目前提供的主要系统: openEuler | open欧拉 定位是服务器操作系统 是基于CentOS的 Linux 发行版,开源、免费 其商业发行版由麒麟软件、统信软件等提供(如:统

    2024年02月09日
    浏览(60)
  • 华为Mate30报名鸿蒙 HarmonyOS 4.0.0.108 系统更新

    华为 Mate 30 系列于 2019 年 11 月 1 日上市, 包括 Mate 30 4G / 5G、Mate 30 Pro 4G / 5G、保时捷设计版 Mate30 共五款机型 。华为 Mate 30 系列 5G 版搭载麒麟 990 5G 处理器,同时支持 SA 及 NSA 5G 双模,适配三大运营商的 5G / 4G / 3G / 2G 频段。 我的Mate30 5G版当前系统为 HarmonyOS 3.0.0.305,前天

    2024年02月14日
    浏览(42)
  • 华为原生 HarmonyOS NEXT 鸿蒙操作系统星河版 发布!不依赖 Linux 内核

    发布会上,余承东宣布,HarmonyOS NEXT鸿蒙星河版面向开发者开放申请。 申请链接 鸿蒙星河版将实现原生精致、原生易用、原生流畅、原生安全、原生智能、原生互联6大极致原生体验。 从2019年HarmonyOS正式发布,到2020年余承东说“没有人能够熄灭满天星光”,每一位开发者,

    2024年01月21日
    浏览(40)
  • 【华为鸿蒙】HarmonyOS概述:技术特性

    来源:HarmnyOS 官网 https://developer.harmonyos.com/cn/docs/documentation/doc-guides/harmonyos-features-0000000000011907 多种设备之间能够实现硬件互助、资源共享,依赖的关键技术包括分布式软总线、分布式设备虚拟化、分布式数据管理、分布式任务调度等。 分布式软总线是手机、平板、智能穿戴

    2024年01月21日
    浏览(47)
  • 华为发布 HarmonyOS NEXT 鸿蒙星河版

    在 2024-01-18 下午于深圳举办的鸿蒙生态千帆启航仪式上,华为常务董事兼终端BG CEO余承东宣布了HarmonyOS NEXT(鸿蒙星河版)的开发者预览版面向开发者开放申请。这一版本旨在实现六大极致原生体验,包括原生精致、易用、流畅、安全、智能和互联。 余承东表示,首批鸿蒙原

    2024年01月24日
    浏览(41)
  • 鸿蒙(HarmonyOS)应用开发——构建页面(题目答案)

    1.在Column容器中的子组件默认是按照从上到下的垂直方向布局的,其主轴的方向是垂直方向,在Row容器中的组件默认是按照从左到右的水平方向布局的,其主轴的方向是水平方向。 正确(True) 2.List容器可以沿水平方向排列,也可以沿垂直方向排列。 正确(True) 3.当Tabs组件的参数

    2024年01月20日
    浏览(84)
  • HarmonyOS鸿蒙原生应用开发设计- 华为分享图标

    HarmonyOS设计文档中,为大家提供了独特的华为分享图标,开发者可以根据需要直接引用。 开发者直接使用官方提供的华为分享图标内容,既可以符合HarmonyOS原生应用的开发上架运营规范,又可以防止使用别人的内容产生的侵权意外情况等,减少自主创作华为分享图标的工作量

    2024年02月08日
    浏览(62)
  • 鸿蒙(HarmonyOS)应用开发——构建更加丰富的页面(题目答案)

    1.@State修饰的属性不允许在本地进行初始化。 错误(False) 解析: 2.@CustomDialog装饰器用于装饰自定义弹窗组件,使得弹窗可以自定义内容及样式。 正确(True) 3.将Video组件的controls属性设置为false时,不会显示控制视频播放的控制栏。 正确(True) 4.@Prop修饰的属性值发生变化时,此状

    2024年02月03日
    浏览(60)
  • 华为鸿蒙HarmonyOS应用开发者高级认证试题及答案

    判断 1只要使用端云一体化的云端资源就需要支付费用(错) 2所有使用@Component修饰的自定义组件都支持onPageShow,onBackPress和onPageHide生命周期函数。(错) 3 HarmonyOS应用可以兼容OpenHarmony生态(对) 4 使用端云一体化开发,无需自己搭建服务器,并进行运维了。(对) 5基于端

    2024年02月04日
    浏览(71)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包