Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
04bd8966
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
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看板
提交
04bd8966
编写于
4月 10, 2023
作者:
L
limeng
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
支持轻量图文混排DOC
Signed-off-by:
N
limeng
<
limeng208@huawei.com
>
上级
9dc7d3d0
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
97 addition
and
0 deletion
+97
-0
zh-cn/application-dev/reference/arkui-ts/figures/imagespan.png
.../application-dev/reference/arkui-ts/figures/imagespan.png
+0
-0
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imagespan.md
...n-dev/reference/arkui-ts/ts-basic-components-imagespan.md
+97
-0
未找到文件。
zh-cn/application-dev/reference/arkui-ts/figures/imagespan.png
0 → 100644
浏览文件 @
04bd8966
271.3 KB
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imagespan.md
0 → 100644
浏览文件 @
04bd8966
# ImageSpan
作为Text组件的子组件,用于显示行内图片的组件。
> **说明:**
>
> 该组件从API Version 10开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
无
## 接口
ImageSpan(value: ResourceStr | PixelMap)
**参数:**
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| value |
[
ResourceStr
](
ts-types.md#ResourceStr
)
\|
[PixelMap](../apis/js-apis-image.md#pixelmap7)
| 是 | 图片的数据源,支持本地图片和网络图片。
<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/>
\-
支持
`datashare://`
路径前缀的字符串,用于访问通过data
ability提供的图片路径。图片加载前需要申请
[
媒体库功能相关权限
](
../../file-management/medialibrary-overview.md#申请媒体库功能相关权限
)
<br/>
\-
支持file:///data/storage路径前缀的字符串,用于读取本应用安装目录下files文件夹下的图片资源。需要保证目录包路径下的文件有可读权限。 |
## 属性
通用属性方法仅支持
[
通用属性
](
ts-universal-attributes-size.md
)
中的宽(width)、高(height)和size属性外,还支持以下属性:。
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| verticalAlign |
[
ImageSpanAlignment
](
#imagespanalignment
)
| 图片基于文本的对齐方式。 |
| objectFit |
[
ImageFit
](
ts-appendix-enums.md#imagefit
)
| 设置图片的缩放类型。
<br/>
默认值:ImageFit.Cover |
### ImageSpanAlignment
| 名称 | 描述 |
| -------- | ------------------------------------------ |
| TOP | 图片上边沿和文本的上边沿对齐。 |
| CENTER | 图片的中间和文本的中间对齐。 |
| BOTTOM | 图片的下边沿和文本的下边沿对齐。 |
| BASELINE | 图片的下边沿和文本的BaseLine的上边线对齐。 |
## 事件
无。
## 示例
```
ts
// xxx.ets
@
Entry
@
Component
struct
SpanExample
{
build
()
{
Flex
({
direction
:
FlexDirection
.
Column
,
alignItems
:
ItemAlign
.
Start
})
{
Text
()
{
Span
(
'
This is the Span and ImageSpan component
'
).
fontSize
(
25
).
textCase
(
TextCase
.
Normal
)
.
decoration
({
type
:
TextDecorationType
.
None
,
color
:
Color
.
Pink
})
}.
width
(
'
100%
'
)
Text
()
{
ImageSpan
(
$r
(
'
app.media.icon
'
))
.
width
(
'
200px
'
)
.
height
(
'
200px
'
)
.
objectFit
(
ImageFit
.
Fill
)
.
verticalAlign
(
ImageSpanAlignment
.
CENTER
)
Span
(
'
I am LineThrough-span
'
)
.
decoration
({
type
:
TextDecorationType
.
LineThrough
,
color
:
Color
.
Red
}).
fontSize
(
25
)
ImageSpan
(
$r
(
'
app.media.icon
'
))
.
width
(
'
50px
'
)
.
height
(
'
50px
'
)
.
verticalAlign
(
ImageSpanAlignment
.
TOP
)
Span
(
'
I am Underline-span
'
)
.
decoration
({
type
:
TextDecorationType
.
Underline
,
color
:
Color
.
Red
}).
fontSize
(
25
)
ImageSpan
(
$r
(
'
app.media.icon
'
))
.
size
({
width
:
'
100px
'
,
height
:
'
100px
'
})
.
verticalAlign
(
ImageSpanAlignment
.
BASELINE
)
Span
(
'
I am Underline-span
'
)
.
decoration
({
type
:
TextDecorationType
.
Underline
,
color
:
Color
.
Red
}).
fontSize
(
25
)
ImageSpan
(
$r
(
'
app.media.icon
'
))
.
width
(
'
70px
'
)
.
height
(
'
70px
'
)
.
verticalAlign
(
ImageSpanAlignment
.
BOTTOM
)
Span
(
'
I am Underline-span
'
)
.
decoration
({
type
:
TextDecorationType
.
Underline
,
color
:
Color
.
Red
}).
fontSize
(
50
)
}
.
width
(
'
100%
'
)
.
backgroundColor
(
Color
.
Orange
)
.
textIndent
(
50
)
}.
width
(
'
100%
'
).
height
(
'
100%
'
).
padding
({
left
:
0
,
right
:
0
,
top
:
0
})
}
}
```

编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录