Window.getComputedStyle()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

摘要

Window.getComputedStyle()方法返回一个对象,该对象在应用活动样式表并解析这些值可能包含的任何基本计算后报告元素的所有 CSS 属性的值。私有的 CSS 属性值可以通过对象提供的 API 或通过简单地使用 CSS 属性名称进行索引来访问。

语法

js
getComputedStyle(element)
getComputedStyle(element, pseudoElt)
element

用于获取计算样式的Element

pseudoElt 可选

指定一个要匹配的伪元素的字符串。必须对普通元素省略(或null)。

备注: 在 Gecko 2.0 之前版本,参数 pseudoElt 是必要的。如果为 null,则不指定其他主要浏览器必须指定此参数。Gecko 已经更改为匹配其他浏览器的行为。

返回的style是一个实时的 CSSStyleDeclaration 对象,当元素的样式更改时,它会自动更新本身。

示例

js
let elem1 = document.getElementById("elemId");
let style = window.getComputedStyle(elem1, null);

// 它等价于
// let style = document.defaultView.getComputedStyle(elem1, null);
js
<style>
 #elem-container{
   position: absolute;
   left:     100px;
   top:      200px;
   height:   100px;
 }
</style>

<div id="elem-container">dummy</div>
<div id="output"></div>

<script>
  function getTheStyle(){
    let elem = document.getElementById("elem-container");
    let theCSSprop = window.getComputedStyle(elem,null).getPropertyValue("height");
    document.getElementById("output").innerHTML = theCSSprop;
   }
  getTheStyle();
</script>
js
function dumpComputedStyles(elem, prop) {
  let cs = window.getComputedStyle(elem, null);
  if (prop) {
    dump("    " + prop + " : " + cs.getPropertyValue(prop) + "\n");
    return;
  }
  let len = cs.length;
  for (var i = 0; i < len; i++) {
    let style = cs[i];
    dump("    " + style + " : " + cs.getPropertyValue(style) + "\n");
  }
}

描述

返回的对象与从元素的 style 属性返回的对象具有相同的类型;然而,两个对象具有不同的目的。从getComputedStyle返回的对象是只读的,可以用于检查元素的样式(包括由一个<style>元素或一个外部样式表设置的那些样式)。elt.style对象应用于在特定元素上设置样式。

第一个参数必须是 Element 对象 (传递一个非节点元素,如 一个#text 节点,将会抛出一个错误). 从 Gecko 1.9.2 开始,现在返回的一个在 URL 周围有引号的 URL 值,像这样:url("http://foo.com/bar.jpg")

defaultView

在许多在线的演示代码中,getComputedStyle是通过 document.defaultView 对象来调用的。大部分情况下,这是不需要的,因为可以直接通过window对象调用。但有一种情况,你必需要使用 defaultView, 那是在 firefox3.6 上访问子框架内的样式。

与伪元素一起使用

getComputedStyle 可以从伪元素拉取样式信息 (比如,::after, ::before, ::marker, ::line-marker—查看 详情 这里).

html
<style>
  h3::after {
    content: "rocks!";
  }
</style>

<h3>generated content</h3>

<script>
  let h3 = document.querySelector("h3"),
    result = getComputedStyle(h3, "::after").content;
  alert(`the generated content is: ${result}`);
  console.log(`the generated content is: ${result}`);
  // the generated content is: "rocks!"
</script>

注意

返回的CSSStyleDeclaration对象将包含所有受支持的 CSS 属性长名称的活动值。示例名称是border-bottom-widthborder-widthborder是示例速记属性名称。仅使用像font-size这样的名字来查询值是最安全的。查询诸如font等简写名称不适用于大多数浏览器。

CSS 规范也允许使用驼峰命名,比如fontSizepaddingTop

CSS 属性值可以使用getPropertyValue(propName)API 或直接索引到对象,如cs ['z-index']cs.zIndex

getComputedStyle的返回值是 resolved values, 通常跟 CSS2.1 中的computed values是相同的值。但对于一些旧的属性,比如width, height, padding 它们的值又为 used values。最初,CSS2.0 定义的计算值 Computed values 就是属性的最终值。但是 CSS2.1 重新定义了 computed values 为布局前的值,used values 布局后的值。布局前与布局后的区别是,width 或者 height 的 百分比可以代表元素的宽度,在布局后会被像素值替换。

在某些情况下,通过浏览器会特意返回不准确的值。特别是在避免 CSS 浏览历史泄露的安全问题,比如,浏览者看过某个网站,它的链接通常会变成蓝色带下划线的链接,通过判断链接的颜色(getComputedSytle(node, null).color) 是否为蓝色,就会泄露用户的浏览历史,所以浏览器会特意返回不准确的值,保护用户隐私。可以了解更多关于 css 安全的链接http://blog.mozilla.com/security/2010/03/31/plugging-the-css-history-leak/http://hacks.mozilla.org/2010/03/privacy-related-changes-coming-to-css-vistited/

在 CSS 过渡期间,getComputedStyle返回 Firefox 中的原始属性值,但返回 WebKit 中的最终属性值。

在 Firefox 中,属性值为auto的会直接返回使用值,而不是auto。比如,你在设定了一个元素的 css 为height:30px; top: auto; bottom:0;它的父元素height:100px;,在请求top的计算样式时,Firefox 会返回'70px' = 100px - 30px;

规范

Specification
CSS Object Model (CSSOM)
# dom-window-getcomputedstyle

浏览器兼容性

BCD tables only load in the browser

参见