sandal is a basic sass library for mobile sites
Switch branches/tags
Nothing to show
Clone or download
Latest commit 661f4fb May 18, 2018
Permalink
Failed to load latest commit information.
core fix: iphonex media bug Jan 9, 2018
ext Update icons.svg Jan 15, 2018
.gitignore fix bugs & optimize Apr 21, 2016
_core.scss npm version Aug 1, 2016
_function.scss npm version Aug 1, 2016
package.json 3.4.1 Jan 9, 2018
readme.md Update readme.md May 18, 2018

readme.md

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——进入离开动画