npm 包 eagle-styles 使用教程

阅读时长 7 分钟读完

eagle-styles 是一个基于 Sass 的 CSS 样式库,包含了大量的通用样式,可以在前端项目中快速引入并使用。本文将介绍如何使用 eagle-styles,相关的基础知识和使用技巧。

安装

通过 npm 安装 eagle-styles:

使用

在 Sass 文件中引入 eagle-styles:

也可以通过其他方式引入,比如 webpack 或者 gulp。

在 HTML 文件中引入编译后的 CSS 文件即可使用:

文件结构

eagle-styles 的文件结构如下:

基础知识

Sass

eagle-styles 使用 Sass 语言编写样式,Sass 是一种 CSS 预处理器,可以让样式表的编写更加高效简洁。相较于纯 CSS,Sass 提供了以下功能:

  • 变量
  • 嵌套规则
  • 操作符、函数和混合宏
  • 继承
  • 导入功能

Sass 最终会被编译成普通的 CSS 文件。使用 Sass 语言编写样式需要一定的基础知识,可以参考 Sass 官方文档 进行学习。

BEM 方法论

eagle-styles 使用 BEM 方法论组织 CSS 代码。BEM 是一种命名规范和思想,全称 Block-Element-Modifier,即块、元素和修饰符。

  • block:顶级样式,代表一个独立的块,拥有自己的上下文语境,不受其他组件影响。
  • element:块内的子元素,用于描述块的组成部分,一般由块名和元素名组成,中间用双下划线连接。
  • modifier:用于描述变化或状态,例如大小、颜色、禁用等,一般由块名、元素名(可选)和修饰符名组成,中间用双连字符连接。

例如,一个按钮的 BEM 命名可以是:

其中,btn 为 block 名称,btn--primarybtn--disabled 为 modifier 名称。使用 BEM 命名规范可以使样式更易于维护和扩展。

样式模块

样式配置变量

eagle-styles 提供了一些全局配置变量,可以在 _config.scss 文件中进行修改。例如,可以修改颜色、边框宽度、圆角等样式属性:

样式重置模块

eagle-styles 提供了一个基础样式重置模块,可以在 _reset.scss 文件中引入。该文件包含了一些常见的样式重置,例如去除浏览器默认的外边距、内边距等。使用该模块可以使浏览器的样式更加一致。

排版模块

eagle-styles 提供了一个排版模块,可以在 _typography.scss 文件中引入。该模块包含了大量的排版样式,包括字号、行高、字体、颜色等。使用该模块可以快速地为页面添加排版样式。例如,可以通过以下方式应用一个标题样式:

-- -------------------- ---- -------
-- ----------------
------ -------------- -
  ------------ -----
  ---------- ------
  ------------ ----
  ----------- --
  -------------- -----
-

-------- -
  -------- -
    -------- -------------
  -
  -- ---
-

辅助类模块

eagle-styles 提供了一个辅助类模块,可以在 _utilities.scss 文件中引入。该模块包含了大量的辅助类,例如布局、尺寸、颜色、背景等。使用该模块可以快速地为页面添加样式。例如,可以通过以下方式应用一个红色背景:

示例代码

以下是一个简单的示例代码,使用了 eagle-styles 提供的样式模块:

-- -------------------- ---- -------
--------- -----
------
  ------
    ----- ----------------
    -----------------
    ----- ---------------- -------------------------------------------
  -------
  ------
    ------- ---------------
      --- ------------
        --- ------------------
          -- ----------------- ---------------
        -----
        --- ------------------
          -- ----------------- ---------------
        -----
        --- ------------------
          -- ----------------- ---------------
        -----
      -----
    ---------
    ---- ------------------
      --- -------------- -------------------------
      --------------- ------------ -----------
      ------- ---------- ---------------------------
    ------
  -------
-------
-- -------------------- ---- -------
-- ---------
------- ----------------------------------

------- -
  ----------------- -----
  ------ -----
  -------- -----
-

---- -
  -------- -----
  ----------- -----
  ------- --
  -------- --
-

---------- -
  ------------- -----
-

---------- -
  ------ -----
  ---------------- -----
-

---------- -
  ---------- ------
  ------- - -----
-

---- -
  -------- -------------
  -------- ------ -----
  ------- --- ----- ---------------
  ----------------- ------------
  ------ ---------------
  ----------- -------
  ---------------- -----
  ------- --------
  -------------- ---------------
  ----------- ---------------- ---- ---------

  ------- -
    ----------------- ---------------
    ------ -----
  -
-

通过以上示例代码,可以学习到如何使用 eagle-styles 提供的样式模块,以及如何编写 BEM 和 Sass 样式。eagle-styles 作为一个通用的样式库,可以为前端项目提供基础样式,加快项目开发速度,降低维护成本。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005573b81e8991b448d4305

纠错
反馈