Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
64b87956
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
64b87956
编写于
7月 30, 2022
作者:
O
openharmony_ci
提交者:
Gitee
7月 30, 2022
浏览文件
操作
浏览文件
下载
差异文件
!7486 image权限说明修改+PR同步
Merge pull request !7486 from LiAn/OpenHarmony-3.1-Release
上级
fa7d243b
b346e5a5
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
56 addition
and
45 deletion
+56
-45
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md
...ation-dev/reference/arkui-ts/ts-basic-components-image.md
+47
-36
zh-cn/application-dev/ui/ts-component-based-builder.md
zh-cn/application-dev/ui/ts-component-based-builder.md
+9
-9
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md
浏览文件 @
64b87956
# Image
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> **说明:**
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
图片组件,用来渲染展示图片。
## 权限
列表
## 权限
说明
ohos.permission.INTERNET(使用网络图片)
使用网络图片时,需要在config.json文件对应的"abilities"中添加网络使用权限ohos.permission.INTERNET。
```
"abilities": [
{
...
"permissions": ["ohos.permission.INTERNET"],
...
}
]
```
## 子组件
...
...
@@ -23,14 +34,14 @@ Image(src: string | PixelMap | Resource)
-
参数
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ----
---- | -------- | -------- | -------- |
-------- |
| src
| string
\|
[PixelMap](../apis/js-apis-image.md#pixelmap7)\|
[
Resource
](
../../ui/ts-types.md#resource类型
)
| 是 | -
| 图片的数据源,支持本地图片和网络图片。
<br/>
当使用相对路径引用图片资源时,例如
`Image("common/test.jpg")`
,不支持该Image组件被跨包/跨模块调用,建议使用
`$r`
方式来管理需全局使用的图片资源。
<br/>
\-
支持的图片格式包括png、jpg、bmp、svg和gif。
<br/>
\-
支持
`Base64`
字符串。格式
`data:image/[png\|jpeg\|bmp\|webp];base64,[base64 data]`
, 其中
`[base64 data]`
为
`Base64`
字符串数据。
<br/>
\-
支持
`dataability://`
路径前缀的字符串,用于访问通过data
ability提供的图片路径。 |
| ----
| ---------------------------------------- | ---- | ---- | --------------------------------
-------- |
| src
| string
\|
[PixelMap](../apis/js-apis-image.md#pixelmap7)\|
[
Resource
](
../../ui/ts-types.md#resource类型
)
| 是 | -
| 图片的数据源,支持本地图片和网络图片。
<br/>
当使用相对路径引用图片资源时,例如
`Image("common/test.jpg")`
,不支持该Image组件被跨包/跨模块调用,建议使用
`$r`
方式来管理需全局使用的图片资源。
<br/>
\-
支持的图片格式包括png、jpg、bmp、svg和gif。
<br/>
\-
支持
`Base64`
字符串。格式
`data:image/[png\|jpeg\|bmp\|webp];base64,[base64 data]`
, 其中
`[base64 data]`
为
`Base64`
字符串数据。
<br/>
\-
支持
`dataability://`
路径前缀的字符串,用于访问通过data
ability提供的图片路径。 |
## 属性
| 名称 | 参数类型 | 默认值 | 描述 |
| --------
| -------- | -------- |
-------- |
| --------
------------- | ---------------------------------------- | -------- | --------------------------------
-------- |
| alt | string
\|
[
Resource
](
../../ui/ts-types.md#resource类型
)
| - | 加载时显示的占位图。支持本地图片和网络路径。 |
| objectFit | ImageFit | Cover | 设置图片的缩放类型。 |
| objectRepeat |
[
ImageRepeat
](
ts-appendix-enums.md#imagerepeat枚举说明
)
| NoRepeat | 设置图片的重复样式。
<br/>
>
![icon-note.gif](public_sys-resources/icon-note.gif)
**说明:**
<br/>
>
-
svg类型图源不支持该属性。 |
...
...
@@ -41,7 +52,7 @@ Image(src: string | PixelMap | Resource)
-
ImageFit枚举说明
| 名称 | 描述 |
| --------
|
-------- |
| --------
- | ------------------------
-------- |
| Cover | 保持宽高比进行缩小或者放大,使得图片两边都大于或等于显示边界。 |
| Contain | 保持宽高比进行缩小或者放大,使得图片完全显示在显示边界内。 |
| Fill | 不保持宽高比进行放大缩小,使得图片填充满显示边界。 |
...
...
@@ -50,7 +61,7 @@ Image(src: string | PixelMap | Resource)
-
ImageInterpolation枚举说明
| 名称 | 描述 |
| ------
-- |
-------- |
| ------
| ----------------
-------- |
| None | 不使用插值图片数据。 |
| High | 高度使用插值图片数据,可能会影响图片渲染的速度。 |
| Medium | 中度使用插值图片数据。 |
...
...
@@ -58,7 +69,7 @@ Image(src: string | PixelMap | Resource)
-
ImageRenderMode枚举说明
| 名称 | 描述 |
| -------- | -------- |
| -------- | --------
-------------
|
| Original | 按照原图进行渲染,包括颜色。 |
| Template | 将图像渲染为模板图像,忽略图片的颜色信息。 |
...
...
@@ -66,7 +77,7 @@ Image(src: string | PixelMap | Resource)
## 事件
| 名称 | 功能描述 |
| --------
|
-------- |
| --------
-------------------------------- | --------------------------------
-------- |
| onComplete(callback:
(event?:
{
width:
number,
height:
number,
componentWidth:
number,
<br>
componentHeight:
number,
loadingStatus:
number
})
=
>
void) | 图片成功加载时触发该回调,返回成功加载的图源尺寸。 |
| onError(callback:
(event?:
{
componentWidth:
number,
componentHeight:
number
})
=
>
void) | 图片加载出现异常时触发该回调。 |
| onFinish(callback:
()
=
>
void) | 当加载的源文件为带动效的svg图片时,当svg动效播放完成时会触发这个回调,如果动效为无限循环动效,则不会触发这个回调。 |
...
...
zh-cn/application-dev/ui/ts-component-based-builder.md
浏览文件 @
64b87956
...
...
@@ -8,12 +8,12 @@
@Entry
@Component
struct CompA {
size : number = 100;
size
1
: number = 100;
@Builder SquareText(label: string) {
Text(label)
.width(1 * this.size)
.height(1 * this.size)
.width(1 * this.size
1
)
.height(1 * this.size
1
)
}
@Builder RowOfSquareTexts(label1: string, label2: string) {
...
...
@@ -21,8 +21,8 @@ struct CompA {
this.SquareText(label1)
this.SquareText(label2)
}
.width(2 * this.size)
.height(1 * this.size)
.width(2 * this.size
1
)
.height(1 * this.size
1
)
}
build() {
...
...
@@ -32,12 +32,12 @@ struct CompA {
this.SquareText("B")
// or as long as tsc is used
}
.width(2 * this.size)
.height(1 * this.size)
.width(2 * this.size
1
)
.height(1 * this.size
1
)
this.RowOfSquareTexts("C", "D")
}
.width(2 * this.size)
.height(2 * this.size)
.width(2 * this.size
1
)
.height(2 * this.size
1
)
}
}
```
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录