梅科尔工作室-李柯增-鸿蒙笔记2

组件的使用：

一、组件介绍：

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

组件根据功能可以分为以下五大类：基础组件、容器组件、媒体组件、绘制组件、画布组件。其中基础组件是视图层的基本组成单元，包括Text、Image、TextInput、Button、LoadingProgress等。

二、常用组件

1.Text组件：用于展示文本内容

相关使用：

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”。

文本对齐方式：

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

textAlign参数类型为TextAlign，定义了以下几种类型：

• Start（默认值）：水平对齐首部。

  

• Center：水平居中对齐。

  

• End：水平对齐尾部。

  

超长文本设置：

使用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})
  .backgroundColor(0xE6F2FD) 

效果图如下：

 文本装饰线：

使用decoration设置文本装饰线样式及其颜色，decoration包含type和color两个参数，其中type用于设置装饰线样式，参数类型为TextDecorationTyp，color为可选参数。

例： 

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

包括以下几个类型：

None：不使用文本装饰线。

Overline：文字上划线修饰

LineThrough：穿过文本的修饰线。

Underline：文字下划线修饰。

2.Image组件：用来渲染展示图片

示例如下：

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

效果图如下：

 设置缩放类型：

使用objectFit属性设置图片的缩放类型，objectFit的参数类型为ImageFit。

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

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

ImageFit包含以下几种类型：

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

Cover（默认值）：保持宽高比进行缩小或者放大，使得图片两边都大于或等于显示边界。

Auto：自适应显示。

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

ScaleDown：保持宽高比显示，图片缩小或者保持不变。

None：保持原有尺寸显示。

当然也可以导入网络图片：

例：

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

3.TextInput :TextInput组件用于输入单行文本，响应输入事件。

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

效果图如下：

 设置输入提示文本:

使用placeholder属性

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

设置输入类型：

使用type属性：

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

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

Password：密码输入模式。

Email：e-mail地址输入模式。

Number：纯数字输入模式。

4.Button组件：主要用来响应点击操作，可以包含子组件。

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

效果图如下：

设置样式;

type用于定义按钮样式:

Capsule：胶囊型按钮（圆角默认为高度的一半）

Circle：圆形按钮 

Normal：普通按钮（默认不带圆角）

设置按钮点击事件：

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

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