Image 图片 | AIUI | Rokid

image 用于在页面中显示本地图片或网络图片。通过 mode 可以决定图片在容器中如何缩放。

Image 图片

image 用于在页面中显示本地图片或网络图片。通过 mode 可以决定图片在容器中如何缩放。

显示图片

使用 src 指定图片地址:

<image class="logo" src="/assets/logo.png"></image>

网络图片可以直接使用 http:// 或 https:// 地址:

<image
  class="cover"
  src="https://example.com/images/cover.jpg"
  mode="aspectFill"
></image>
.cover {
  width: 320px;
  height: 180px;
}

保持图片比例

如果不希望图片被拉伸,可以根据界面需要选择以下模式:

  • aspectFit:完整显示图片,容器中可能留有空白。
  • aspectFill:填满容器,超出容器的部分可能被裁剪。
  • widthFix:宽度固定,高度根据图片比例自动计算。
  • heightFix:高度固定,宽度根据图片比例自动计算。

例如,固定图片宽度并自动计算高度:

<image class="article-image" src="/assets/article.png" mode="widthFix"></image>
.article-image {
  width: 300px;
}

属性

属性类型默认值说明
srcString""本地图片路径或网络图片 URL。
modeStringscaleToFill图片缩放方式,可选值为 scaleToFill、aspectFit、aspectFill、widthFix 或 heightFix。
tint-colorString无显式着色使用源 alpha 作为遮罩的 CSS 颜色;有效的 SVG 主题着色优先。

scaleToFill 会让图片填满容器,因此图片比例可能发生变化。需要保持原始比例时,通常优先使用 aspectFit 或 aspectFill。

本地路径和网络 URL 的支持规则请查看资源(Assets)。

在插槽中绑定属性

通过自定义组件插槽或模板投影内容时,src 等绑定属性使用当前已解析的数据值。setData() 更新资源地址或显示参数后,投影内容同步更新,无需重新创建整个组件。

图片着色与动画保留

使用 tint-color 替换 RGB 并保留原图透明度:

<image src="/assets/plane.svg" tint-color="#adadad" mode="aspectFit" />

SVG 和栅格图片都支持,包括多彩图像;着色不会保留原有明暗层次。输出透明度为 源 alpha × 着色 alpha。修改或清除着色使用原始像素,不会因重复更新而累乘透明度。

有效的 --image-svg-tint CSS 颜色优先于 SVG 的显式着色;栅格图片忽略此 token。设为 none 可关闭强制 SVG 着色;要恢复原图颜色,还需移除显式着色。

.original-vector {
  --image-svg-tint: none;
}

GIF 按顺序解码并限制像素缓冲,视图重组时保留播放位置和循环次数,有限循环结束后保留最后一帧。

A2UI 图片属性与适配映射见 A2UI。