Skip to content

Latest commit

 

History

History
164 lines (106 loc) · 6.13 KB

readme.md

File metadata and controls

164 lines (106 loc) · 6.13 KB
Raw

Sandal

该项目为 Sass 的基础库，另有一个针对 PostCSS 的为 Sandal for PostCSS

更新说明

  • 新增 iphonex mixin，可针对 iphonex 设置样式，调用如下：
// 方法一：
@include iphonex {
	.fixed-bottom {
		padding-bottom: 15px;
	}
}

// 方法二：
.fixed-bottom {
	@include iphonex {
		padding-bottom: 15px;
	}
}
  • body 新增 iphonex 安全区域 padding，样式如下：
body {
	padding-top: env(safe-area-inset-top); //为导航栏+状态栏的高度 88px            
	padding-left: env(safe-area-inset-left); //如果未竖屏时为0                
	padding-right: env(safe-area-inset-right); //如果未竖屏时为0                
	padding-bottom: env(safe-area-inset-bottom); //为底下圆弧的高度 34px
}

概述

sandal取其“檀香”之意，针对移动端站点为前端人员提供了一些基础的重置，常用的mixin，如flex布局，等分，水平垂直居中，常用图标等，基于它你可以扩展出更多你需要的UI组件，sheral就是基于sandal的移动端UI库。

sandal的整体设计思想如下图：

sandal

_function.scss集成了所有的基础功能，并且不输出任何样式，而_core.scss则在function的基础上加入了重置样式，ext文件夹则包含了四个扩展文件，可根据个人需要自由导入，具体介绍及使用请参考sandal 文档

如何使用

sandal，分核心文件和扩展文件两种。其中核心文件包括重置样式，@mixin，%等方便调用；而扩展文件则提供基础原子类class，图标，网格系统。

核心文件提供两个集合文件以供调用，分别为_function.scss， _core.scss。两者的区别为function仅提供功能，而core除了提供function的功能，还会会生成一份重置样式

扩展文件有四个，分别为_icons.scss，_helper.scss，_grid.scss，_page-slide.scss可根据需要调用

npm 调用

安装

npm install sass-sandal --save-dev

webpack 使用

// 核心文件调用，如需要reset样式则为core
@import '~sass-sandal/_core';
// or
@import '~sass-sandal/_function';

// 扩展调用对应模块
@import '~sass-sandal/ext/icons';
@import '~sass-sandal/ext/helper';
@import '~sass-sandal/ext/grid';
@import '~sass-sandal/ext/page-slide';

一般调用

// 核心文件调用，如需要reset样式则为core
@import 'node_modules/sass-sandal/core';
// or
@import 'node_modules/sass-sandal/function';

// 扩展调用对应模块
@import 'node_modules/sass-sandal/ext/icons';
@import 'node_modules/sass-sandal/ext/helper';
@import 'node_modules/sass-sandal/ext/grid';
@import 'node_modules/sass-sandal/ext/page-slide';

普通使用

在github上下载sandal，解压拷贝到项目目录

@import 'sandal/core';

文件简述

sandal包括两个集合文件（core，function）和两个文件夹（core，ext）。其中core文件夹中为核心基础文件，包括variables，media-queries，mixin，animation，reset；ext文件夹中是一些扩展文件，目前包括svg icons，grid网格系统，helper基础class，page-slide为页面切换class。

两个集合文件（core，function）导入的都是core中的文件，区别在于core除了提供基本功能之外还会生成一份reset样式，而function则只提供基本功能。至于ext中的文件则属于额外的一些模块扩展，可根据需求导入。

core文件

variables

负责基础变量的文件，如常用的颜色，字体等变量。

media-queries

负责响应式断点判断的文件，来自paranoida的sass-mediaqueries。

mixin

负责功能方面的文件。这里我们大概分成三个部分，一个是混合部分即mixin（主要定义了一些常用的flex,translate等），一个是placeholder选择器部分即%，最后就是我们的function函数部分。常用的include及extend就是在这里定义的。

animation

提供六组简单实用动画：fade-in/out, shrink-in/out, up-in/out, down-in/out，left-in/out，right-in/out。默认不产生样式，通过include调用

reset

在normalize的基础上，根据目前我们大家的使用习惯进行了一些归零行动，及基础文字颜色，clearfix，box-sizing等。

ext文件

helper

提供常用的基础class，如clearfix, full-width等

grid

移动端的网格系统，分为row和col，具体使用参考3分钟13行代码搭建sass版移动端网格系统

icons

分为绘制的icon和svg图标两种，可参考icons文件夹中的icons.html

default icon svg

绘制icon

  • icon颜色一般使用currentColor颜色，可以方便设置标签的color颜色来改变
  • 对于不变的icon，如radio & checkbox直接设置大小，而一些可变的icon，通过标签的伪元素来绘制，标签本身没有设置大小，可根据实际情况设置大小（设置大点可扩大点击范围），伪元素绘制的会保持水平垂直居中

svg 图标调用

从icomoon提取了几个常用的svg图标，使用方法可参考ext/icons/icons.html，这里以home图标为例：

<svg class="icon icon-home"><use xlink:href="icons.svg#icon-home"></use></svg>

如需改变颜色，可以通过设置css的fill属性来定义

.icon-home{
	fill:#f00;
}

最后可根据实际需求对icons.svg进行增删改， 然后使用。

注：使用时请把icons.svg拷贝至images目录或其他目录，方便调用

page slide

用于页面切换的动画class，共四个class，分两组：右进左出（页面进入）；左进右出（后退）,具体使用可参看移动端重构实战系列4——进入离开动画