鸿蒙(HarmonyOS)应用开发——基础组件_鸿蒙开发有哪些组件

组件

组件化是一种将复杂的前端应用程序分解成小的、独立的部分的方法。这些部分被称为组件，它们可以重复使用，可以与其他组件组合使用以创建更复杂的组件，并且它们有自己的生命周期和状态。

组件化的目的是提高开发效率和代码重用率，使开发人员更专注于组件自身的实现，而不是整个应用程序。这样可以提高代码的可维护性和可扩展性，并且减少了程序出错的机会。

组件是界面搭建与显示的最小单位；

Image 组件

Image 用来渲染展示图片的组件，支持加载本地和网络图片

语法

Image(src: string|PixelMap|Resourece)
1

• string
  访问网络图片、本地图片

访问网络图片时，需要在module.json5文件中添加网络访问权限
‘module’:{ 'reqPermissinos':[ {"name":"ohos.permission.INTERNET"} ] }

• PixelMap
  PixelMap 为图像像素类，用于读取或写入图像数据以及获取图像信息。
• Resource 类型
  使用时，需要先将图片放在resource 的 media或 rawfile目录下

属性

width()| height()支持number、string和resource

Text组件

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

语法

Text(content?:string|resouce)
1

属性

• 文本样式
  可使用fontColor、fontSize、fontStyle、fontWeight、fontFamily文本样式

 Text('HarmonyOS')
          .fontColor(Color.Blue)
          .fontSize(20)
          .fontStyle(FontStyle.Italic)
          .fontWeight(FontWeight.Bold)
          .fontFamily('Arial')
1
2
3
4
5
6

• 文本对其方式
  可以使用textAlign属性设置文本的对齐方式

Text('HarmonyOS')
  .width(200)
  .textAlign(TextAlign.Start)
1
2
3

• 设置文本超长显示
  当文本内容较多超出了Text组件范围的时候，您可以使用textOverflow设置文本截取方式，需配合maxLines使用，单独设置不生效，maxLines用于设置文本显示最大行数

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})
1
2
3
4

• 设置文本装饰线
  使用decoration设置文本装饰线样式及其颜色

decoration({ type: TextDecorationType.Underline, color: Color.Black })
1

TextInput

用来输入但行文本并支持响应输入事件

属性

• 设置提示文本
  当我们平时使用输入框的时候，往往会有一些提示文字

TextInput({ placeholder: '请输入帐号' })
1

• 设置最大输入字符数

maxLength()
1

• 设置文本框输入类型
  可以使用type属性来设置输入框类型

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

• 设置光标位置
  可以使用TextInputController动态设置光位置

 controller: TextInputController = new TextInputController()
  this.controller.caretPosition(2)
1
2

• 获取输入文本
  可以给TextInput 设置onChange 获取文本信息

 @State text: string = ''
 TextInput({ placeholder: '请输入账号' })
        .caretColor(Color.Blue)
        .onChange((value: string) => {
          this.text = value
        })
1
2
3
4
5
6

Button

主要用来响应点击事件，可以包含子组件。

属性

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

• 设置按钮点击事件
  可以给Button绑定onClick事件，每当用户点击Button的时候，就会回调执行onClick方法

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

• 包含子组件
  Button组件可以包含子组件，让您可以开发出更丰富多样的Button