浏览器与 Web API / 系统课时
使用 getComputedStyle 获取计算样式
使用 getComputedStyle 获取计算样式
本课解决“元素明明有样式,为什么 element.style 却读不到”的问题。你将通过 getComputedStyle 获取级联后的只读结果,识别值的规范化形式,并避免在高频读取中触发不必要的样式与布局计算。
学习目标
- 获取元素经过级联、继承和默认规则处理后的样式值
- 理解计算样式只读、规范化和依赖布局的特点
- 正确读取普通元素与伪元素的样式
为什么不能只读 element.style
element.style 只对应内联声明,而元素最终显示效果还可能来自浏览器默认样式、外部样式表、选择器优先级、继承和当前布局。getComputedStyle(element) 会在这些规则处理后,返回当前可读取的样式结果。

这个返回对象用于观察结果,不能作为修改入口。需要改变样式时,仍应写入 element.style、修改 class,或更新对应的样式表规则。
返回值与读取规则
可以使用驼峰属性读取,例如 computed.fontSize;也可以使用标准 CSS 名称调用 computed.getPropertyValue('font-size')。后者尤其适合 CSS 自定义属性和动态属性名。
返回值通常会被序列化为统一格式,例如颜色可能显示为 rgb(...),许多长度会显示为像素值。它不保证保留源码中的原始写法,因此不要用字符串完全相等来判断作者是否写过某个值。
读取伪元素时传入第二个参数,例如 getComputedStyle(element, '::before')。伪元素必须由 CSS 规则生成,且读取到的是当前计算结果。
完整示例
下面的标题没有内联颜色,但会继承卡片的颜色。示例同时读取固定宽度、内边距、继承颜色和标题字号。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>getComputedStyle 示例</title>
<style>
.card {
width: 240px;
padding: 16px;
color: rgb(31, 41, 55);
}
.card strong {
font-size: 20px;
}
</style>
</head>
<body>
<div id="card" class="card">
<strong id="title">DOM 样式</strong>
</div>
<script>
const card = document.querySelector('#card');
const title = document.querySelector('#title');
// 读取级联与布局完成后的只读结果
const cardStyle = getComputedStyle(card);
const titleStyle = getComputedStyle(title);
console.log(cardStyle.width);
console.log(cardStyle.paddingLeft);
console.log(titleStyle.color);
console.log(titleStyle.fontSize);
</script>
</body>
</html>预期结果
页面:显示“DOM 样式”文字,卡片内容宽 240px,四周内边距为 16px。
控制台:
240px
16px
rgb(31, 41, 55)
20px读取时机与性能
浏览器为了返回准确结果,可能先进行样式重新计算;读取宽高、位置等依赖布局的属性时,还可能触发布局计算。循环中交替“写样式、读计算值”容易造成布局抖动,应先集中读取,再集中修改。
元素尚未插入文档、祖先处于 display: none,或尺寸由内容和视口动态决定时,某些结果可能不具备业务意义。需要尺寸与位置时,应在元素已渲染且状态稳定后读取。
常见错误
不要尝试执行 getComputedStyle(element).width = '300px',返回对象是只读视图。不要期待它返回源码中的 1rem、颜色关键字或变量表达式原文,浏览器可能已经换算并规范化。
对于动画中的元素,读取到的是调用时刻的当前值。高频动画逻辑应优先使用已知状态或缓存数据,避免每一帧无条件读取大量计算样式。