大网数据广告活动
Web 标准与前端开发

CSSImageValue

· 52CE 我爱测

CSS 类型对象模型 API 的 **`CSSImageValue`** 接口表示取用图像的属性(例如 background-image、list-style-image 或 border-image-source)的值。

CSS Typed Object Model API

CSS 类型对象模型 API 的 CSSImageValue 接口表示取用图像的属性(例如 background-image、list-style-image 或 border-image-source)的值。

CSSImageValue 对象表示涉及 URL(如 url() 或 image(),但不包括 linear-gradient() 或 element())的 <image>。

实例属性

无。

实例方法

继承 CSSStyleValue 的方法。

示例

创建元素

<button>魔杖</button>

我们添加了一些 CSS,包括请求二进制文件的背景图片:

button {
  display: inline-block;
  min-height: 100px;
  min-width: 100px;
  background: no-repeat 5% center url(magic-wand.png) aqua;
}

我们获取元素的样式映射。然后,我们从样式映射中获取(get())背景图片(background-image),并将其字符串化:

// 获得元素
const button = document.querySelector("button");

// 使用 computedStyleMap() 读取所有已计算的样式
const allComputedStyles = button.computedStyleMap();

// 返回 CSSImageValue 示例
console.log(allComputedStyles.get("background-image"));
console.log(allComputedStyles.get("background-image").toString());

示例

规范

浏览器兼容性

参见

  • CSSKeywordValue
  • CSSNumericValue
  • CSSPositionValue
  • CSSTransformValue
  • CSSUnparsedValue

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。