样式库设计指南

作者: zhaozhe0831 | 来源:发表于2017-03-15 20:22 被阅读0次

    前言

    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;
    }
    

    此时, Class1Class2 实际表现出来的样式都是width: 50px;

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

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

    在这种情况下, Class1Class2 实际表现出来的样式都是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 statedisabled 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>
    

    相关文章

      网友评论

        本文标题:样式库设计指南

        本文链接:https://www.haomeiwen.com/subject/bzjrnttx.html