DOM系列:动态添加CSS样式规则

发布于 大漠

在上一节中学习了如何通过JavaScript来修改CSS样式。简单地说:查询CSS样式(即计算样式),设置单个样式(设置的是行内样式),设置多个样式(通过类来设置样式)。即:

  • 通过DOM Element对象的getAttribute()setAttribute()removeAttribute()等方法修改元素的style属性
  • 通过对元素节点的style来读写行内CSS样式
  • 通过style对象的cssText属性来修改全部的style属性
  • 通过style对象的setProperty()getPropertyValue()removeProperty()等方法来读写行内CSS样式
  • 通过window.getComputedStyle()方法获得浏览器最终计算的样式规则
  • 通过classNameclassList给元素添加或删除类名,配合样式文件来修改元素样式

可以说上面这些都是通过DOM元素来增、删、改、查CSS样式。事实上我们还可以通过脚本化CSS这种技术来控制样式。这种方式,可以让我们的页面更加的快速和高效。那就是直接通过JavaScript动态地添加和删除样式表中的某些样式,用来取代不断地查询DOM元素,并应用各种样式。接下来咱们就来学习脚本化样式表相关的知识。

获取样式表

你可以选择任意的样式表来添加样式规则。众所周知,引用CSS样式常见的方式主要有三种:

  • 在元素行内添加样式
  • <style>标签内部的样式
  • <link>标签引入的外部样式

在使用<style><link>添加样式时,可以在HTML标签中在对应的标签上添加ID属性,然后直接通过这个DOM元素的sheet属性就可以取得CSSStyleSheet对象。样式表也可以通过document.styleSheets遍历到:

let sheets = document.styleSheets;

CSSStyleSheet类型表示的是样式表,其也是一个对象,而且是一个类数组对象,它继承自StyleSheet

StyleSheet接口

StyleSheet接口代表网页的一张样式表,包括<link>元素加载的样式表和<style>元素内嵌的样式表。

document对象的styleSheets属性,可以返回当前页面的所有StyleSheet实例 —— 所有样式表。它是一个类似数组的对象。

let sheets = document.styleSheets;

for (let i = 0; i < sheets.length; i++) {
    console.log(sheets[i])
}

如果是<style>元素嵌入的样式表,还有另一种获取StyleSheet实例的方法,就是这个节点元素的sheet属性。

// HTML 代码为 <style id="myStyle"></style>
var myStyleSheet = document.getElementById('myStyle').sheet;
myStyleSheet instanceof StyleSheet // true

前面也提到过了document对象的styleSheets属性,可以返回当前页面的所有StyleSheet实例。StyleSheet实例有以下属性。

StyleSheet.disabled

StyleSheet.disabled返回一个布尔值,表示该样式表是否处于禁用状态。手动设置disabled属性为true,等同于在<link>元素里面,将这张样式表设为alternate stylesheet,即该样式表将不会生效

<!DOCTYPE html>
<html lang="en">

    <head>
        <title>StyleSheet</title>
        <style id="style">
            #box {
                background-color: red !important;
            }
        </style>
    </head>

    <body>

        <div id="box" style="width: 100px; height: 100px;background-color: green;"></div>
        <button id="btn">修改颜色</button>

        <script>
            let sheets = document.styleSheets
            let btn = document.getElementById('btn')
            
            btn.addEventListener('click', function(){
                sheets[0].disabled = !sheets[0].disabled
            })
        </script>
    </body>

</html>

当你单击“修改颜色”按钮时,可以看到idstyle<style>中样式并没生效;只有再次点击时才将生效。

注意,disabled是一个可读,可写的的属性,该属性只能通过JavaScript设置,不能在HTML语句中设置。

StyleSheet.href

StyleSheet.href返回样式表的网址。对于内嵌样式表,该属性返回null。该属性是一个只读属性。

let sheets = document.styleSheets;

for (let i = 0; i < sheets.length; i++) {
    console.log(sheets[i].href)
}

StyleSheet.media

StyleSheet.media属性返回一个类似数组的对象:MediaList实例,表示适用媒介的字符串。表示当前样式表是用于屏幕screen,还是打印设备print或手持设备handheld,或各种媒介适用all。该属性只读,默认值是screen

当你想在屏幕上显示的时候,你肯定不能把CSS规则加到打印样式表中。你可以仔细的看一下CSSStyleSheet对象的属性信息:

比如下面这样,咱们可以打印出一个页面中所有样式表对应的媒介:

let sheets = document.styleSheets;

for (let i = 0; i < sheets.length; i++) {
    console.log(sheets[i].media)
}

MediaList实例的appendMedium方法,用于增加媒介;deleteMedium方法用于删除媒介。

sheets[0].media.appendMedium = 'all'
sheets[1].media.appendMedium = 'screen'
sheets[2].media.appendMedium = 'print'
for (let i = 0; i < sheets.length; i++) {
    console.log(sheets[i].media)
}

sheets[2].media.deleteMedium = 'print'
for (let i = 0; i < sheets.length; i++) {
    console.log(sheets[i].media)
}

StyleSheet.title

StyleSheet.title属性返回样式表的title属性。

StyleSheet.type

StyleSheet.type属性返回样式表的type属性,通常是text/css

StyleSheet.parentStyleSheet

CSS 的@import命令允许在样式表中加载其他样式表。StyleSheet.parentStyleSheet属性返回包含了当前样式表的那张样式表。如果当前样式表是顶层样式表,则该属性返回null

StyleSheet.ownerNode

StyleSheet.ownerNode属性返回StyleSheet对象所在的 DOM 节点,通常是<link><style>。对于那些由其他样式表引用的样式表,该属性为null

for (let i = 0; i < sheets.length; i++) {
    console.log(sheets[i].ownerNode)
}

StyleSheet.cssRules

StyleSheet.cssRules属性指向一个类似数组的对象(CSSRuleList实例),里面每一个成员就是当前样式表的一条 CSS 规则。使用该规则的cssText属性,可以得到 CSS 规则对应的字符串。

for (let i = 0; i < sheets.length; i++) {
    console.log(sheets[0].cssRules[i].cssText)
}

每条 CSS 规则还有一个style属性,指向一个对象,用来读写具体的 CSS 命令。

for (let i = 0; i < sheets.length; i++) {
    console.log(sheets[0].cssRules[i].style)
}

StyleSheet.ownerRule

有些样式表是通过@import规则输入的,它的ownerRule属性会返回一个CSSRule实例,代表那行@import规则。如果当前样式表不是通过@import引入的,ownerRule属性返回null

CSSStyleSheet实例方法

CSSStyleSheet实例方法有insertRule()deleteRule()

CSSStyleSheet.insertRule方法用于在当前样式表的插入一个新的 CSS 规则。

<style id="style">
    #box {
        background-color: green;
        width: 100px;
        height: 100px;
    }
</style>

<script>
    let sheet = document.getElementById('style').sheet
    sheet.insertRule('#box{border: 2px solid orange}', 0)
    sheet.insertRule('p {color: black}', 1)
</script>

在浏览器开发者工具中,我们可以看到添加了新的<style>

CSSStyleSheet.insertRule方法可以接受两个参数,第一个参数是表示CSS规则的字符串,这里只能有一条规则,否则会报错;第二个参数是该规则在样式表的插入位置(从0开始),该参数可选,默认为0(即默认插入在样式表的头部)。注意,如查插入位置大于现在规则的数目,会报错。该方法的返回值是新插入规则的位置序号。

注意,浏览器对脚本在样式表里面插入规则有很多限制。所以,这个方法最好放在try ... catch里使用。

因为并不是所有的浏览器都支持CSSStyleSheet.insertRule方法,所以最好创建一个函数来处理规则的插入。比如下面这样的一个函数:

function addCSSRule(sheet, selector, rules, index) {
    if ('inserRule' in shhet) {
        sheet.insertRule(selector + '{' + rules + '}', index)
    } else if ('addRule' in sheet) {
        sheet.addRule(selector, rules, index)
    }
}

// 使用方式
addCSSRule(document.styleSheets[0], 'header', 'float: left')

CSSStyleSheet.deleteRule方法和CSSStyleSheet.insertRule方法刚好相反,主要用来在样式表里移除一条规则,它的参数是该条规则在cssRules对象中的位置。该方法没有返回值。

document.styleSheets[0].deleteRule(1);

CSSRuleList 接口

CSSRuleList接口是一个类似数组的对象,表示一组CSS规则,成员都是CSSRule实例。我们一般可以通过StyleSheet.cssRules属性来获取CSSRuleList实例。

let sheet = document.getElementById('style').sheet
let crl = sheet.cssRules
crl instanceof CSSRuleList // => true
console.log(crl)

CSSRuleList实例里面,每一条规则(CSSRule实例)可以通过rules.item(index)或者rules[index]拿到。CSS规则的条数通过rules.length拿到:

<style id="style">
    #box {
        background-color: green;
        width: 100px;
        height: 100px;
    }
    p {
        color: red;
    }
</style>

<script>
    let sheet = document.getElementById('style').sheet
    let crl = sheet.cssRules
    console.log(crl.length)

    for (let i = 0; i < crl.length; i++) {
        console.log(crl[i])
        console.log(crl[i] instanceof CSSRule)
    } 
</script>

注意,添加规则和删除规则不能在 CSSRuleList 实例操作,而要在它的父元素 StyleSheet 实例上,通过StyleSheet.insertRule()StyleSheet.deleteRule()操作。

虽然CSSRule对象表示样式表中的每一条规则,但实际上,CSSRule是一个供其他多种类型继承的基类型,其中最常见的就是CSSStyleRule类型,表示样式信息。其他规则还包括@import@font-face@page@charset

CSSRule

一条CSS规则包括两个部分:CSS选择器和样式声明:

JavaScript通过CSSRule接口操作CSS规则。一般通过CSSRuleList接口(StyleSheet.cssRules)获取CSSRule实例。

CSSRule实例有自己的属性:

CSSRule.cssText

CSSRule.cssText属性返回当前规则的文本,比如:

<style id="style">
    #box {
        background-color: green;
        width: 100px;
        height: 100px;
    }
    p {
        color: red;
    }
</style>

<script>
    let sheet = document.getElementById('style').sheet
    let ruleList = sheet.cssRules
    
    for (let i = 0; i < ruleList.length; i++) {
        console.log(ruleList[i].cssText)
    }
</script>

如果规则是加载(@import)其他样式表,cssText属性返回@import 'url'。比如基于上例稍做修改:

<style id="style">
    @import url('https://www.fedev.cn/css/reset.css')
    #box {
        background-color: green;
        width: 100px;
        height: 100px;
    }
    p {
        color: red;
    }
</style>

CSSRule.parentStyleSheet

CSSRule.parentStyleSheet属性返回当前规则所在的样式表对象(StyleSheet实例),还是基于上面的示例做一点小修改:

let sheet = document.getElementById('style').sheet
let ruleList = sheet.cssRules
let rule = ruleList[0]

console.log(rule.parentStyleSheet === sheet) // => true
CSSRule.parentRule

CSSRule.parentRule属性返回包含当前规则的父规则,如果不存在父规则(即当前规则是顶层规则),则返回null

let sheet = document.getElementById('style').sheet
let ruleList = sheet.cssRules
    
for (let i = 0; i < ruleList.length; i++) {
    console.log(ruleList[i].parentRule)
}

父规则最常见的情况是,当前规则包含在@media规则代码块之中。比如下面这个示例:

<style id="style">
    @supports (display: flex) {
        @media screen and (min-width: 900px) {
            #box {
                display: flex;
            }
        }
    }
</style>

let sheet = document.getElementById('style').sheet
let ruleList = sheet.cssRules

for (let i = 0; i < ruleList.length; i++) {
    console.log(ruleList[i].parentRule)
    console.log(ruleList[i].cssText)
    console.log(ruleList[i].cssRules[i].cssText)
}

CSSRule.type

CSSRule.type属性返回一个整数值,表示当前规则的类型。

最常见的类型有以下几种。

  • 普通样式规则(CSSStyleRule 实例)
  • @import规则
  • @media规则(CSSMediaRule 实例)
  • @font-face规则

CSSStyleRule

如果一条 CSS 规则是普通的样式规则(不含特殊的 CSS 命令),那么除了 CSSRule 接口,它还部署了 CSSStyleRule 接口。

CSSStyleRule 接口有以下两个属性。

CSSStyleRule.selectorText

CSSStyleRule.selectorText属性返回当前规则的选择器。

<style id="style">
    #box {
        width: 100px;
    }
</style>

let sheet = document.getElementById('style').sheet
let ruleList = sheet.cssRules

for (let i = 0; i < ruleList.length; i++) {
    console.log(ruleList[i].selectorText)
}

注意,这个属性是可写的。

CSSStyleRule.style

CSSStyleRule.style属性返回一个对象(CSSStyleDeclaration 实例),代表当前规则的样式声明,也就是选择器后面的大括号里面的部分。

CSSStyleDeclaration 实例的cssText属性,可以返回所有样式声明,格式为字符串。

添加一个新的样式表

在Web页面中添加样式表有两种方式。一种是通过在HTML文档内部添加<style>元素,即内置样式

我们可以通过下面两种方式来动态添加新样式表。先来看方法一:

let sheet = document.createElement('style')
sheet.setAttribute('media', 'screen')
sheet.innerHTML = 'body{color:red}'
document.head.appendChild(sheet)

另外一种方式就是将其封装成一个函数:

let sheet = (function () {
    let style = document.createElement('style')
    document.head.appendChild(style)
    return style
})()

另一种是添加外部样式表,即在文档中添加一个<link>节点,然后将href属性指向外部样式表的 URL

let linkElm = document.createElement('link');
linkElm.setAttribute('rel', 'stylesheet');
linkElm.setAttribute('type', 'text/css');
linkElm.setAttribute('href', 'reset-min.css');

document.head.appendChild(linkElm);

总结

动态添加规则到样式表是高效的手段,可能比你想象的还要简单。请记住这种方案,可能在你的下一个大应用中需要使用,因为它能在代码和元素处理这两方面避免你掉进坑里。借着如何动态创建样式表的机会,文章对有关于动态创建样式表涉及到的相关API做了一些简单的描述。

由于自己是JavaScript的初学者,如果文章中有描述不对之处,还请各路大婶拍正。欢迎各位爷打个赏,鼓励我继续创作一些优质的教程。(^_^)

扩展阅读

大漠

常用昵称“大漠”,W3CPlus创始人,目前就职于手淘。对HTML5、CSS3和Sass等前端脚本语言有非常深入的认识和丰富的实践经验,尤其专注对CSS3的研究,是国内最早研究和使用CSS3技术的一批人。CSS3、Sass和Drupal中国布道者。2014年出版《图解CSS3:核心技术与案例实战》。

如需转载,烦请注明出处:https://www.fedev.cn/javascript/add-rules-stylesheets.htmlThe 13th Version UA Yeezy Boost 350 Turtle Dove, the perfect version