鸿蒙(HarmonyOS)应用开发——基础组件

组件

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

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

组件是界面搭建与显示的最小单位；
根据功能分类基础组件容器组件媒体组件绘制组件画布组件 Text Image TextInput Button LoadingProgress ....

Image 组件

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

语法

javascript 复制代码

Image(src: string|PixelMap|Resourece)

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

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

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

属性

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

Text组件

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

语法

javascript 复制代码

Text(content?:string|resouce)

属性

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

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

javascript 复制代码

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

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

名称	描述
Start	水平对齐首部。
Center	水平居中对齐。
End	水平对齐尾部。

javascript 复制代码

Text('HarmonyOS')
  .width(200)
  .textAlign(TextAlign.Start)

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

javascript 复制代码

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})

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

javascript 复制代码

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

TextDecorationType类型	描述
None	不使用文本装饰线
Overline	文字上划线修饰。
LineThrough	穿过文本的修饰线。
Underline	文字下划线修饰。

TextInput

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

属性

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

javascript 复制代码

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

设置最大输入字符数

javascript 复制代码

maxLength()

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

javascript 复制代码

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

InputType类型	描述
Normal	基本输入模式。支持输入数字、字母、下划线、空格、特殊字符。
Password	密码输入模式。
Email	e-mail地址输入模式
Number	纯数字输入模式。
PhoneNumber9+	电话号码输入模式。

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

javascript 复制代码

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

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

javascript 复制代码

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

Button

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

属性

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

ButtonType类型	描述
Capsule	胶囊型按钮（圆角默认为高度的一半）
Circle	圆形按钮。
Normal	普通按钮（默认不带圆角

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

javascript 复制代码

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

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