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

ResizeObserverEntry.contentRect

· 52CE 我爱测

ResizeObserverEntry 接口的只读属性 `contentRect` 在回调运行时,返回一个包含被监听元素大小的 DOMRectReadOnly 对象。注意,该属性比 ResizeObserverEntry.borderBoxSize 或 ResizeObserverEntry.contentBoxSize 有着更好的支持,但是它是在 Resize Observer API 早期实现遗留下来的,出于对浏览器的兼容性原因,仍然保留在规范中,并且在未来的版本中可能被弃用。

Resize Observer API

ResizeObserverEntry 接口的只读属性 contentRect 在回调运行时,返回一个包含被监听元素大小的 DOMRectReadOnly 对象。注意,该属性比 ResizeObserverEntry.borderBoxSize 或 ResizeObserverEntry.contentBoxSize 有着更好的支持,但是它是在 Resize Observer API 早期实现遗留下来的,出于对浏览器的兼容性原因,仍然保留在规范中,并且在未来的版本中可能被弃用。

值

一个 DOMRectReadOnly 对象,包含着 ResizeObserverEntry.target 属性表示的元素的新的大小。

如果 target 是一个 HTML Element,返回的 contentRect 是元素的内容盒。如果 target 是 SVGElement,返回的 contentRect 是 SVG 的边界框。

示例

以下示例取自 resize-observer-text.html(见源码)。它使用了一个简单的功能检测测试来查看浏览器是否支持较新的 ResizeObserverEntry.contentBoxSize 属性——如果支持,则使用它来获取需要的尺寸数据。如果不支持,则使用 contentRect。

const resizeObserver = new ResizeObserver((entries) => {
  for (const entry of entries) {
    if (entry.contentBoxSize) {
      h1Elem.style.fontSize = `${Math.max(
        1.5,
        entry.contentBoxSize.inlineSize / 200,
      )}rem`;
      pElem.style.fontSize = `${Math.max(
        1,
        entry.contentBoxSize.inlineSize / 600,
      )}rem`;
    } else {
      h1Elem.style.fontSize = `${Math.max(
        1.5,
        entry.contentRect.width / 200,
      )}rem`;
      pElem.style.fontSize = `${Math.max(1, entry.contentRect.width / 600)}rem`;
    }
  }
});

resizeObserver.observe(divElem);

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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