• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Hyperlink
2
3超链接组件,组件宽高范围内点击实现跳转。
4
5>  **说明:**
6>
7>  - 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
8>  - 该组件仅支持与系统浏览器配合使用。
9
10## 需要权限
11
12跳转的目标应用使用网络时,需要申请权限ohos.permission.INTERNET。具体申请方式请参考[声明权限](../../../security/AccessToken/declare-permissions.md)。
13
14## 子组件
15
16可以包含[Image](ts-basic-components-image.md)子组件。
17
18## 接口
19
20Hyperlink(address: string | Resource, content?: string | Resource)
21
22**参数:**
23
24| 参数名 | 参数类型 | 必填 | 参数描述 |
25| -------- | -------- | -------- | -------- |
26| address | string \| [Resource](ts-types.md#resource) | 是 | Hyperlink组件跳转的网页。 |
27| content | string&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 否 | Hyperlink组件中超链接显示文本。<br/>**说明:** <br/>组件内有子组件时,不显示超链接文本。 |
28
29## 属性
30
31除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
32
33| 名称 | 参数类型 | 描述 |
34| -------- | -------- | -------- |
35| color | [ResourceColor](ts-types.md#resourcecolor) | 设置超链接文本的颜色。<br />默认值:'#ff007dff' |
36
37## 示例
38
39```ts
40@Entry
41@Component
42struct HyperlinkExample {
43  build() {
44    Column() {
45      Column() {
46        Hyperlink('https://example.com/') {
47          Image($r('app.media.bg'))
48            .width(200)
49            .height(100)
50        }
51      }
52
53      Column() {
54        Hyperlink('https://example.com/', 'Go to the developer website') {
55        }
56        .color(Color.Blue)
57      }
58    }.width('100%').height('100%').justifyContent(FlexAlign.Center)
59  }
60}
61```
62
63![hyperlink](figures/hyperlink.PNG)
64