一、组件简介

组件（Component）是界面搭建与显示的最小单位，HarmonyOS ArkUI申明式开发范式为开发者提供了丰盛多样的UI组件，咱们能够应用这些组件轻松的编写出更加丰盛、丑陋的界面。

组件依据性能能够分为以下五大类：根底组件、容器组件、媒体组件、绘制组件、画布组件。其中根底组件是视图层的根本组成单元，包含Text、Image、TextInput、Button、LoadingProgress等，例如上面这个罕用的登录界面就是由这些根底组件组合而成。 

上面咱们将别离介绍这些罕用根底组件的应用。

二、Text

Text组件用于在界面上展现一段文本信息，能够蕴含子组件Span。

文本款式

针对蕴含文本元素的组件，例如Text、Span、Button、TextInput等，可应用fontColor、fontSize、fontStyle、 fontWeight、fontFamily这些文本款式，别离设置文本的色彩、大小、款式、粗细以及字体，文本款式的属性如下表：

上面示例代码中蕴含两个Text组件，第一个应用的是默认款式，第二个给文本设置了一些文本款式。

@Entry@Componentstruct 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%')  }}

最终的成果如下：

除了通用属性和文本款式设置，上面列举了一些Text组件的罕用属性的应用。

文本对齐形式

应用textAlign属性能够设置文本的对齐形式，示例代码如下：

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

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

  • Start（默认值）：程度对齐首部。
  • Center：程度居中对齐。
  • End：程度对齐尾部。

文本超长显示

当文本内容较多超出了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)

成果如下：

文本装璜线

应用decoration设置文本装璜线款式及其色彩，大家在浏览网页的时候常常能够看到装璜线，例如带有下划线超链接文本。decoration蕴含type和color两个参数，其中type用于设置装璜线款式，参数类型为TextDecorationTyp，color为可选参数。

上面的示例代码给文本设置了下划线，下划线色彩为彩色：

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

成果如下：

TextDecorationTyp蕴含以下几种类型：

  • None：不应用文本装璜线。
  • Overline：文字上划线润饰。
  • LineThrough：穿过文本的润饰线。
  • Underline：文字下划线润饰。

三、Image

Image组件用来渲染展现图片，它能够让界面变得更加丰富多彩。只须要给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组件反对加载网络图片，将图片地址换成网络图片地址进行加载。

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

为了胜利加载网络图片，您须要在module.json5文件中申明网络拜访权限。

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

利用拜访网络须要申请ohos.permission.INTERNET权限，因为HarmonyOS提供了一种访问控制机制即利用权限，用来保障这些数据或性能不会被不当或歹意应用。

四、TextInput

TextInput组件用于输出单行文本，响应输出事件。TextInput的应用也十分宽泛，例如利用登录账号密码、发送音讯等。和Text组件一样，TextInput组件也反对文本款式设置，上面的示例代码实现了一个简略的输入框：

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

成果如下：

输出提醒文本

当咱们平时应用输入框的时候，往往会有一些提醒文字。例如登录账号的时候会有“请输出账号”这样的文本提醒，当用户输出内容之后，提醒文本就会隐没，这种提醒性能应用placeholder属性就能够轻松的实现。您还能够应用placeholderColor和placeholderFont别离设置提醒文本的色彩和款式，示例代码如下：

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

成果如下：
 

输出类型

能够应用type属性来设置输入框类型。例如明码输入框，个别输出明码的时候，为了用户明码平安，内容会显示为“......”，针对这种场景，将type属性设置为InputType.Password就能够实现。示例代码如下：

TextInput({ placeholder: '请输出明码' })  .type(InputType.Password)

成果如下：

type的参数类型为InputType，蕴含以下几种输出类型：

  • Normal：根本输出模式。反对输出数字、字母、下划线、空格、特殊字符。
  • Password：明码输出模式。
  • Email：e-mail地址输出模式。
  • Number：纯数字输出模式。

光标地位

能够应用TextInputController动静设置光地位，上面的示例代码应用TextInputController的caretPosition办法，将光标挪动到了第二个字符后。

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

成果如下：

获取输出文本

咱们能够给TextInput设置onChange事件，输出文本发生变化时触发回调，上面示例代码中的value为实时获取用户输出的文本信息。

@Entry@Componentstruct 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)  }}

成果如下：


 

五、Button

Button组件次要用来响应点击操作，能够蕴含子组件。上面的示例代码实现了一个“登录按钮”：

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

成果如下：

按钮款式

type用于定义按钮款式，示例代码中ButtonType.Capsule示意胶囊形按钮；stateEffect用于设置按钮按下时是否开启切换成果，当状态置为false时，点击成果敞开，默认值为true。咱们能够设置多种款式的Button，除了Capsule能够以设置Normal和Circle：

  • Capsule：胶囊型按钮（圆角默认为高度的一半）。
  • Circle：圆形按钮。
  • Normal：一般按钮（默认不带圆角）。

按钮点击事件

能够给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)

成果如下：


 

六、LoadingProgress

LoadingProgress组件用于显示加载停顿，比方利用的登录界面，当咱们点击登录的时候，显示的“正在登录”的进度条状态。LoadingProgress的应用非常简单，只须要设置色彩和宽高就能够了。

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

成果如下：

七、资源援用类型

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