Element: currentCSSZoom property
Baseline
2026
Newly available
Since March 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Thuộc tính currentCSSZoom là thuộc tính chỉ đọc of the Element interface provides the "effective" CSS zoom of an element, taking into account the zoom applied to the element and all its parent elements.
The value calculated by multiplying the CSS zoom values of the element and all of its parents.
For example, if three elements with zoom values of 2, 1.5, and 3, are nested within each other, the most deeply nested element will have a currentCSSZoom value of 9.
If the element doesn't have a CSS box, for example because display: none is set trên phần tử or one of its parents, then the currentCSSZoom được đặt là 1.
Note that some methods, such as Element.getBoundingClientRect(), return dimensions and position that are relative to the viewport, and hence include the effects of CSS zoom.
Other properties and methods return values that are relative to the element itself, and do not include the effects of zooming.
These include, for example, client* properties such as Element.clientHeight, scroll*() methods like Element.scroll(), and offset* properties such as HTMLElement.offsetHeight.
The currentCSSZoom property can be used to scale these values to adjust for the effects of zooming.
Giá trị
Một số indicating the effective CSS zoom trên phần tử, or 1 if the element is not rendered.
Ví dụ
Ví dụ này demonstrates how the currentCSSZoom is calculated.
First we define a nested structure of <div> elements where the "parent" is unzoomed and chứa a nested element "child1" that has zoom: 2 applied, which in turn chứa a nested element "child2" with zoom: 3 applied.
The "child2" element chứa two nested elements, one of which is not rendered, and neither of which have the zoom property applied.
<div id="parent">
parent
<div style="zoom: 2" id="child1">
child1 (zoom: 2)
<div style="zoom: 3" id="child2">
child2 (zoom: 3)
<div id="child3-rendered">child3-rendered</div>
<div style="display: none" id="child3-not-rendered">
child3-not-rendered
</div>
</div>
</div>
</div>
The JavaScript code logs the zoom value applied at each level along with its currentCSSZoom value.
if ("currentCSSZoom" in Element.prototype) {
const parent = document.querySelector("#parent");
log(`parent (unzoomed). currentCSSZoom: ${parent.currentCSSZoom}`);
const child1 = document.querySelector("#child1");
log(`child1 (zoom: 2). currentCSSZoom: ${child1.currentCSSZoom}`);
const child2 = document.querySelector("#child2");
log(`child2 (zoom: 2). currentCSSZoom: ${child2.currentCSSZoom}`);
const child3Rendered = document.querySelector("#child3-rendered");
log(
`child3-rendered (unzoomed). currentCSSZoom: ${child3Rendered.currentCSSZoom}`,
);
const child3NotRendered = document.querySelector("#child3-not-rendered");
log(
`child3-not-rendered (not rendered): ${child3NotRendered.currentCSSZoom}`,
);
} else {
log("Element.currentCSSZoom not supported in this browser");
}
The resulting rendered <div> structure and log are shown below.
First note that the parent, child1 and child2 have zoom levels 1, 2, and 3, respectively, and render at 1, 2 and 6 times the size of the parent text.
This is reflected by the logged currentCSSZoom values.
The <div> with id child3-rendered does not have zoom set but inherits the currentCSSZoom value of 6 as shown in the log.
The final <div> is not rendered and therefore has a currentCSSZoom value of 1.
Đặc tả kỹ thuật
| Specification |
|---|
| CSSOM View Module # dom-element-currentcsszoom |