样式库设计指南

前言

1、分析 Class

Class 类似于简单的 js 对象，由键值对组成（property & value）。

层叠样式表（ Cascading Stylesheet ，简称CSS ），其基本目标是让浏览器以指定的特性去绘制页面元素，比如颜色，定位，装饰。CSS的语法反映了这个目标，由下面两个部分构建：

属性（ property）是一个标识符，用可读的名称来表示其特性。

值（value）则描述了浏览器引擎如何处理该特性。每个属性都包含一个有效值的集合，它有正式的语法和语义定义，被浏览器引擎实现。

一个 Class 所拥有的 property，表明了该 Class 所拥有的样式属性， value 则代表了该 Class 所拥有的样式属性的具体表现。

.Class {
    property: value;
}

CSS 样式有一个覆盖的规则，默认遵循的是后来者居上。

.Class1 {
    width: 100px;
    width: 50px;
}

.Class2 {
    width: 100px;
}

.Class2 {
    width: 50px;
}

此时， Class1 和 Class2 实际表现出来的样式都是width: 50px;。

不过，凡事总会有特殊情况，

.Class1 {
    width: 100px !important;
    width: 50px;
}

.Class2 {
    width: 100px !important;
}

.Class2 {
    width: 50px;
}

在这种情况下， Class1 和 Class2 实际表现出来的样式都是width: 100px;。

由于!important的压倒性实力，以及对 CSS 样式表现的破坏性，不可随意使用!important ，需要严格注意使用的场景以及使用的方式。

Never 永远不要在全站范围的 css 上使用 !important
Only 只在需要覆盖全站或外部 css（例如引用的 ExtJs 或者 YUI ）的特定页面中使用 !important
Never 永远不要在你的插件中使用 !important
Always 要优化考虑使用样式规则的优先级来解决问题而不是 !important

2、分析 property & value

首先，需要明确几个概念：初始值，继承，计算值，应用值。

参照 MDN

Property

TODO

Value

在 js 中，有多种数据类型，比如：String 类型，Object 类型，Number 类型。

在 CSS 中，同样也有数据类型，通常称之为数据格式，即 Data types 。

常用的 CSS 数据格式，有如下几种。

<number> 表示数字，整数或小数。

10, 0.5, -1

<length> 表示距离尺寸。

100vw, 100vh, 16px, 1em, 1rem

<color> 表示颜色。

#f03, #F03, #f03f03, #F03F03

rgb(255,0,0), rgba(255,0,0,1)

hsl(0,100%,50%), hsla(0,100%,50%,1)

其他的就不列举了，可参照 MDN

组件样式库的设计

1、如何解构组件，如何规划组件，如何分析组件）

从 HTML 标签的角度来考量，组件是可以分成两种的，分别是： 多标签组件 和 单标签组件。

对于单标签组件来说，结构实际上更多指的是，组件的样式构成。
对于多标签组件来说，结构则更多指的是 HTML 标签结构。

单标签组件

<!-- 单标签组件 -->
<button class="btn btn-primary">I am primary button</button>
<button class="btn btn-outline-primary">I am outline primary button</button>

/* 基本样式 .block */
.btn {
    /* ... */
    color: black;
    /* ... */
}

/* 修饰样式 .block-modifier */
.btn-primary {
    /* ... */
    color: blue;
    /* ... */
}

/* 修饰样式 .block-modifier */
.btn-outline-primary {
    /* ... */
    color: blue;
    background-color: transparent;
    /* ... */
}

多标签组件

<!-- 多标签组件 -->
<ul class="sidenav">
    <li class="sidenav-item">
        <a href="/nav1">nav1</a>
    </li>
    <li class="sidenav-item">
        <a href="/nav2">nav2</a>
    </li>
    <li class="sidenav-item">
        <a href="/nav3">nav3</a>
    </li>
    <li class="sidenav-item">
        <a href="/nav4">nav4</a>
    </li>
</ul>

从组件的直观表现上来看，组件则可以按照四个部分来解构，分别是：结构、配色、尺寸、状态。

a) 结构

结构是组件的根基，是组件的骨架。但单标签组件与多标签组件在结构的表现上，是有一些不同的。

* 对于单标签组件来说，结构实际上更多指的是，组件的样式的构成。
* 对于多标签组件来说，结构则更多指的是 HTML 标签的结构。

b) 配色

组件可以拥有不同的的配色，配色可以理解成是组件的样貌。

<button class="btn btn-style1">style1 is my style</button>

<button class="btn btn-style2">style2 is my style too</button>

<button class="btn btn-style3">style3 is my style too</button>

c) 尺寸

人有高有矮，组件会有不同的尺寸。

<button class="btn">I am a button</button>

<button class="btn btn-small">I become a small button</button>

<button class="btn btn-medium">I become a medium button</button>

<button class="btn btn-large">I become large button</button>

d) 状态

状态可以理解为是用户和组件互动，使组件产生的状态。

状态可以大致分为两类：enable state和disabled state。

enable state 亦可称为 element state

.Class:active { property: value; }
.Class:focus { property: value;  }
.Class:hover { property: value;  }
.Class:visited { property: value; }

亦可用如下方式，来表示 enable state 的持久化状态

.Class.active { property: value; }
.Class.focus { property: value;  }
.Class.hover { property: value;  }
.Class.visited { property: value; }

disabled state 亦可称为 special state

.Class.disabled { property: value; }
.Class.loading { property: value; }

2、如何设计组件

组件样式的 Class 命名依据 BEM 方式命名，即 Block & Element & Modifier。

书写方式有两种，如下所示：

下文中 .block & .block-element & .block-element-modifier 皆为代指。

/* 第一种写法 */
.block {}
.block--modifier {}
.block__element {}
.block__element--modifier {}

/* 第二种写法 */
.block {}
.block-modifier {}
.block-element {}
.block-element-modifier {}

第一种写法是标准写法，第二种写法算是简洁的写法。下面按照第二种写法进行详细说明。

按照 BEM 方式书写的 Class ，在单标签组件和多标签组件中，所代表的含义大部分都是相同，小部分有差异。

BEM 之 .block

单标签组件

在单标签组件中，.block多数情况是作为 基础样式 来存在。

<!-- 单标签组件 -->
<button class="btn btn-primary">I am component</button>

多标签组件

在多标签组件中，.block更多是作为容器的存在。

<!-- 多标签组件 -->
<div class="modal">
    <div class="modal-header">
        <div class="modal-title">title</div>
    </div>
    <div class="modal-body">
        <div class="modal-text">
            <a href="#" class="modal-link">link</a>
        </div>
    </div>
    <div class="modal-footer">
        <div class="modal-text">
            ![](#)
        </div>
    </div>
</div>

BEM 之 .block-modifier

单标签组件

在单标签组件中，.block-modifier 与 .block 叠加使用，作为 .block 的修饰。

<!-- 单标签组件 配色-->
<button class="btn btn-primary">I am component</button>
<button class="btn btn-primary-ghost">I am component</button>

<!-- 单标签组件 尺寸-->
<button class="btn btn-small">I am component</button>
<button class="btn btn-large">I am component</button>

<!-- 单标签组件 状态-->
<button class="btn btn-primary btn-loading">I am component</button>
<button class="btn btn-primary btn-disabled">I am component</button>

这里的.btn-primary-ghost实际上是作为.block-modifier存在的，这是一种比较特殊的情况，也是用简洁方式书写 BEM 可能会遇到的情况。

多标签组件

在多标签组件中，.block-modifier 与 .block 叠加使用，一般只会影响组件的容器 .block。

<!-- 多标签组件 -->
<div class="modal modal-center">
    <div class="modal-header">
        <div class="modal-title">title</div>
    </div>
    <div class="modal-body">
        <div class="modal-text">
            <a href="#" class="modal-link">link</a>
        </div>
    </div>
    <div class="modal-footer">
        <div class="modal-text">
            ![](#)
        </div>
    </div>
</div>

BEM 之 .block-element

单标签组件

在单标签组件中，实际上是没有 .block-element 的。

多标签组件

在多标签组件中，.block-element 是位于 .block 之内的。

<!-- 多标签的组件，.block-element 需在 .block 之内。 -->
<div class="modal">
    <div class="modal-header"></div>
    <div class="modal-body">
        <!-- .modal-text-right 将文字右对齐 -->
        <div class="modal-text modal-text-right">
            <a href="#" class="modal-link">link</a>
        </div>
    </div>
    <div class="modal-footer"></div>
</div>

BEM 之 .block-element-modifier

单标签组件

皮之不存毛将焉附。

多标签组件

在多标签组件中，.block-element-modifier 与 .block 叠加使用，类似于 .block-modifier 与 .block 的用法。

<!-- 多标签的组件，.block-element 需在 .block 之内。 -->
<div class="modal">
    <div class="modal-header"></div>
    <div class="modal-body"></div>
    <div class="modal-footer"></div>
</div>

3、组件的父容器布局

父容器并不是必须的。

组件一般来说，都是会被其他的容器包裹的。用组件的父容器进行页面布局，组件则作为内容填充。

一般通过以下两种方式来设置父容器。

a) 用组件的 `.block` 作为父容器的 `.block`

常用的容器命名有以下几种。

.block-container { property: value; }   /* 常用于只有一个直接子元素的组件 */
.block-list { property: value; }        /* 常用于列表式的布局 */
.block-group { property: value; }       /* 常用语包裹 inline 的组件 */

以下是示例：

<!-- .modal-container -->
<div class="modal-container">
    <!-- .modal 应是 .modal-container 的直接子元素。-->
    <div class="modal">
        <div class="modal-header">
            <div class="modal-title">title</div>
        </div>
        <div class="modal-body">
            <div class="modal-text">
                <a href="#" class="modal-link">link</a>
            </div>
        </div>
        <div class="modal-footer">
            <div class="modal-text">
                ![](#)
            </div>
        </div>
    </div>
</div>

<!-- .card-list -->
<!-- .card-list 的直接子元素只可以是 .card-->
<div class="card-list">
    <!-- .card 应是 .card-list 的直接子元素。-->
    <div class="card">
        <div class="card-text"></div>
    </div>
    <div class="card">
        <div class="card-text"></div>
    </div>
    <div class="card">
        <div class="card-text"></div>
    </div>
</div>

<!-- .image-group -->
<div class="image-group">
    <!-- .image 应是 .image-group 的直接子元素。-->
    <a class="image">
        ![](#)
    </a>
    <a class="image">
        ![](#)
    </a>
    <a class="image">
        ![](#)
    </a>
</div>

其实这里避免的是 .block-item 的出现。

在一些情况下，也可以使用 .block 作为父容器， .block-item 作为内容体。

<div class="nav">
    <div class="nav-item"><a href=""></a>nav-a</div>
    <div class="nav-item"><a href=""></a>nav-b</div>
    <div class="nav-item"><a href=""></a>nav-c</div>
</div>

不过，推荐不用 .block-item。

<div class="nav">
    <div class="nav-link"><a href=""></a>nav-a</div>
    <div class="nav-link"><a href=""></a>nav-b</div>
    <div class="nav-link"><a href=""></a>nav-c</div>
</div>

b) 设置专用的布局容器，来进行布局

定义专门的布局容器，来包裹组件。

/* 以下只是进行举例 */
/* container */
.container { property: value; }

/* list */
.list { property: value; }
.list-item { property:value; }

/* group */
.group { property: value; }
.group-item { property: value; }

<!-- .container -->
<div class="container">
    <!-- .modal 应是 .container 的直接子元素-->
    <div class="modal">
        <div class="modal-header"></div>
        <div class="modal-body"></div>
        <div class="modal-footer"></div>
    </div>
</div>

<!-- .list -->
<div class="list">
    <div class="list-item">
        <!-- .card 是 .list-item 的直接子元素-->
        <div class="card">
            <div class="card-img"></div>
            <div class="card-text"></div>
        </div>
    </div>
</div>

<!-- .group -->
<div class="group">
    <!-- .image 应是 .group 的直接子元素。-->
    <div class="group-item">    
        <a class="image">
            ![](#)
        </a>
    </div>
    <div class="group-item">    
        <a class="image">
            ![](#)
        </a>
    </div>
    <div class="group-item">    
        <a class="image">
            ![](#)
        </a>
    </div>
</div>

最后编辑于：2017.12.06 03:41:43

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 203,179评论 5赞 476
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 85,229评论 2赞 380
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 150,032评论 0赞 336
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 54,533评论 1赞 273
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 63,531评论 5赞 365
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 48,539评论 1赞 281
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 37,916评论 3赞 395
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,574评论 0赞 256
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 40,813评论 1赞 296
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,568评论 2赞 320
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,654评论 1赞 329
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,354评论 4赞 318
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 38,937评论 3赞 307
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,918评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,152评论 1赞 259
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 42,852评论 2赞 349
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,378评论 2赞 342

样式库设计指南

前言

1、分析 Class

2、分析 property & value

Property

Value

组件样式库的设计

1、如何解构组件，如何规划组件，如何分析组件）

单标签组件

多标签组件

a) 结构

b) 配色

c) 尺寸

d) 状态

2、如何设计组件

BEM 之 .block

BEM 之 .block-modifier

BEM 之 .block-element

BEM 之 .block-element-modifier

3、组件的父容器布局

a) 用组件的 .block 作为父容器的 .block

b) 设置专用的布局容器，来进行布局

推荐阅读更多精彩内容

a) 用组件的 `.block` 作为父容器的 `.block`