【HarmonyOS NEXT开发】鸿蒙界面开发起步，ArkUI(方舟开发框架)介绍，知识点详解

news2024/11/15 4:19:25

【HarmonyOS NEXT开发】鸿蒙界面开发起步，ArkUI(方舟开发框架)介绍，知识点详解

大纲

主题：鸿蒙界面开发起步，ArkUI(方舟开发框架)介绍，知识点详解。、

内容摘要：带领直播课的观众一步步熟悉ArkUI的基本框架，引导观众实现鸿蒙界面开发的起步，

介绍布局思路，组件属性方法，图片组件…

界面开发起步

从console.log()过渡到struct Index部分的代码，先聚焦于build(){}部分的代码，build()部分是核心，起构建界面的作用。

在ArkTS中，组件是UI的基本构建块。每个组件都是一个可重用的UI单元，可以有自己的状态、样式和行为。ArkTS的组件就类似于其他框架中组件的概念(如React、Vue)。

build() {
  RelativeContainer() {
    Text(this.message)
      .id('HelloWorld')
      .fontSize(50)
      .fontWeight(FontWeight.Bold)
      .alignRules({
      center: { anchor: '__container__', align: VerticalAlign.Center },
      middle: { anchor: '__container__', align: HorizontalAlign.Center }
    })
  }
  .height('100%')
  .width('100%')
}

build()是一个函数，定义了如何构建UI组件的布局和内容。
RelativeContainer()是一个布局容器，用于在相对位置放置子组件，所谓相对指的是允许子组件根据其父容器或其他子组件的相对位置进行排列。
Text(this.message)Text是一个组件，用于显示传入的变量this.message的值。
id('HelloWorld')为 Text 组件设置一个唯一的标识符 id 为 'HelloWorld'。
.fontSize(50) 设置文本的字体大小为 50 像素。
.fontWeight(FontWeight.Bold) 设置文本的字体粗细为粗体。
.alignRules({...})用于定义组件的对齐规则。
- center和middle都只是对齐规则的名称，anchor:'__container__'中__container__表示组件的父容器，在这个上下文中，它意味着组件将相对于其直接父级(即RelativeContainer)进行对齐。VerticalAlign.Center表示垂直居中对齐，HorizontalAlign.Center表示水平居中对齐。
- center: { anchor: ‘_container_’, align: VerticalAlign.Center }这意味着将文本垂直居中对齐到容器（__container__）的中心。
- middle: { anchor: ‘_container_’, align: HorizontalAlign.Center }这意味着将文本水平居中对齐到容器（__container__）的中间。
.height('100%') 和 .width('100%')
- ``.height(‘100%’)和.width(‘100%’)` 设置容器的高度和宽度为其父容器的 100%，即它会充满整个父容器。
- 这里是为RelativeContainer进行设置，会占据整个屏幕或组建的显示空间。

在这里插入图片描述

界面开发-布局思路

ArkUI(方舟开发框架)是一套构建鸿蒙应用界面的框架，构建页面的最小单位就是组件。

在这里插入图片描述

组件

基础组件：界面呈现的基础元素。

如：文字、图片、按钮等。
容器组件：控制基础组件的布局排布。

如：Row行、Column列。

在这里插入图片描述

布局思路：先排版、再放内容。(排好位置后填空即可。)

语法

容器组件：行Row、列Column

容器组件() {
  // 内容
}

基础组件：文字Text、图片

基础组件(参数)

在这里插入图片描述

build() {
  Column(){
      Text('小说简介')
      Row(){
        Text('都市')
        Text('都市生活')
        Text('情感')
        Text('男频')
      }
  }
}

组建的属性方法

需求：美化组件外观效果 -> 组件的属性方法

具体需求：

将"小说简介"进行加粗，增大字号
将标签行中的标签设置背景颜色为灰色，并且标签之间需要有间隔。
将"小说简介"和"都市"做左对齐

组件(){}
	.属性方法1(参数)
	.属性方法2(参数)
	.属性方法3(参数)
	...

.width(200) // 宽度
.height(200) // 高度
.backgroundColor(Color.Pink) // 背景色
.fontSize(24) // 字体大小
.fontWeight(FontWeight.Bold) // 字体粗细

build() {
    RelativeContainer() { // 新增RelativeContainer
      // 标题部分
      Text('小说简介')
        .fontWeight(FontWeight.Bold)
        .fontSize(18)  // 设置标题字体大小
        .id('Brief Introduction')
        .margin({ bottom: 10 }) // 设置标题与下方标签的间距
        .alignRules({
          left: { anchor: '__container__', align: HorizontalAlign.Start }, // 左对齐
          top: { anchor: '__container__', align: VerticalAlign.Top } // 顶部对齐
        })

      // 标签行部分
      Row() {
        // 都市标签
        Text('都市')
          .backgroundColor(Color.Gray)
          .padding({ left: 10, right: 10, top: 5, bottom: 5 }) // 添加内边距
          .margin({ right: 5 }) // 标签之间的间距
          .borderRadius(5) // 圆角效果

        // 都市生活标签
        Text('都市生活')
          .backgroundColor(Color.Gray)
          .padding({ left: 10, right: 10, top: 5, bottom: 5 })
          .margin({ right: 5 })
          .borderRadius(5)

        // 情感标签
        Text('情感')
          .backgroundColor(Color.Gray)
          .padding({ left: 10, right: 10, top: 5, bottom: 5 })
          .margin({ right: 5 })
          .borderRadius(5)

        // 男频标签
        Text('男频')
          .backgroundColor(Color.Gray)
          .padding({ left: 10, right: 10, top: 5, bottom: 5 })
          .borderRadius(5)
      }
      .margin({ top: 40 }) // 设置Row与标题之间的间距
      .alignRules({
        left: { anchor: '__container__', align: HorizontalAlign.Start }, // 左对齐
        top: { anchor: 'Brief Introduction', align: VerticalAlign.Bottom } // 相对标题下方对齐
      })
    }
    .height('100%')
    .width('100%')
    .padding({ top: 20, left: 15, right: 15 }) // 整体的外边距
  }

在这里插入图片描述

字体颜色

Text('小说简介')
	.fontColor('#df3c50') // # 开头的十六进制
	.fornColor(Color.Orange) // Color.颜色名

一般来说，设计图中会标注颜色的十六进制数据，直接按照数据来即可。

文字溢出省略号、行高

在这里插入图片描述

文字溢出省略(设置文本超长时的显示方式)

语法：

.textOverflow({
  overflow: TextOverflow.XXX
})

注意：需要配合.maxLines(行数)使用

build() {
  Column(){
    Text('HarmonyOS开发初体验')
      .width('100%')
      .lineHeight(50)
      .fontSize(20)
      .fontWeight(FontWeight.Bold)
    Text('方舟开发框架(简称ArkUI)为HarmonyOS应用的UI开发提供了完整的基础设施，包括简洁的UI语法，丰富的UI功能（组件、布局、动画以及交互）')
      .width('100%')
      .lineHeight(24)
      .textOverflow({
      overflow: TextOverflow.Ellipsis
    })
      .maxLines(2)
  }
  .width('100%')
}

Image 图片组件

语法：Image(图片数据源) 支持网络图片资源和本地图片资源

网络图片资源

Image('https//www.xxx.com/images/logo.png')

build() {
  Column(){
    Image('https://oss.cyzone.cn/2021/0526/a3f57e509946c68bec9c08ee2bcac5bf.jpg?x-oss-process=image/resize,w_1280,m_mfit/format,jpg/quality,q_95')
      .width('100%') // 设置图片宽度占满容器
      .height('auto') // 高度根据宽度自动调整
      .objectFit(ImageFit.Contain) // 确保图片按比例缩放以完整显示
  }
  .height('100%')
  .width('100%')
}

如果直接加载图片，图片并不能够在容器中完整显示。

本地图片资源

将本地图片存放在固定目录src/main/resources/base/media中

Image($r('app.media.文件名'))

以鸿蒙的图片做例子，

build() {
  Column(){
    Image($r('app.media.img'))
      .width('100%') // 设置图片宽度占满容器
      .height('auto') // 高度根据宽度自动调整
      .objectFit(ImageFit.Contain) // 确保图片按比例缩放以完整显示
  }
  .height('100%')
    .width('100%')
}

输入框和组件

需求：实现登录和注册的排版 -> 输入框和按钮组件

在这里插入图片描述

TextInput({
 	placeholder: '占位符文本' 
}).type(InputType.Password)

placeholder 提示文本
type
- Normal 基本输入模式，无特殊限制
- Password 密码输入模式

Button('按钮文本')

build() {
  // Column({space:15}) 在竖直方向上控制组件之间的间隔
  Column({space:15}){
    TextInput({
      placeholder:'请输入用户名'
    })
    TextInput({
      placeholder:'请输入密码'
    }).type(InputType.Password)
    Button('登录')
      .width(200)
  }
}

入模式，无特殊限制

Password 密码输入模式

Button('按钮文本')

build() {
  // Column({space:15}) 在竖直方向上控制组件之间的间隔
  Column({space:15}){
    TextInput({
      placeholder:'请输入用户名'
    })
    TextInput({
      placeholder:'请输入密码'
    }).type(InputType.Password)
    Button('登录')
      .width(200)
  }
}