2.1.1 • Published 9 years ago

sandal-sass v2.1.1

Weekly downloads
8
License
-
Repository
github
Last release
9 years ago

Sandal

sandal2.1不再提供css3前缀文件,在这推荐使用autoprefixer来智能生成前缀(有grunt和gulp版本,有些客户端编译软件也集成了这个功能),之前的css3文件已经独立到css3 scss

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

更新说明

  • 优化了变量,详见_variables.scss文件
  • _base.scss改成_core.scss文件

如何使用

sandal和sassCore一样,分核心文件和扩展文件两种。其中核心文件提供一些基础的样式和@mixin,%等方便调用;而扩展文件则提供一些模块的样式。

核心文件调用

第一种除提供基础功能外,会产生一份reset样式:

@import "d:/sandal/core";

第二种不产生任何样式,只提供功能的调用:

@import "d:/sandal/function";

扩展文件调用

根据需要调用,以font-face为例:

@import "d:/sandal/ext/font-face/font-face";

注:因为sass不能导入在线sass文件,而sandal也没有提供安装版的使用,所以默认统一放在D盘进行调用。如使用的是mac,可放在用户目录中,通过根目录路径/users/username/sandal/core调用,其中username为你的用户名

文件简述

sandal包括两个集合文件(core,function)和三个文件夹(core,ext,components)。其中core文件夹中为核心基础文件,包括variables,media-queries,mixin,animation,reset;ext文件夹中是一些扩展文件,目前只包括font-face 和 svg 两种icons;components文件夹为组件,这里暂不介绍。

两个集合文件(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, up-in/out, down-in/out。默认不产生样式,通过include调用

reset

normalize的基础上,根据目前我们大家的使用习惯进行了一些归零行动,及设置文字字体颜色。严格来说这并不是专门针对移动端的重置,而是ie8+的重置,因为考虑到有些是专门做移动端,而有些则是移动为先,再则重置的东西也比较少,所以就没有进一步砍掉。当然有代码洁癖的可以进一步优化。

ext文件

icons

icomoon提取了几个常用的图标,分为字体图标和svg图标,可根据自己需求选择哪种图标

default icon svg

font-face

默认输出所有的icon class,可根据实际需求输出其中的某些icon。使用可参考sassCore 字体图标的使用

svg

icomoon提取了几个常用的svg图标,使用方法可参考demo中的demo.html,这里以home图标为例:

先在html顶部定义svg icon,

<svg display="none" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
	<defs>
		<symbol id="icon-home" viewBox="0 0 1024 1024">
			<title>home</title>
			<path class="path1" d="M1024 590.444l-512-397.426-512 397.428v-162.038l512-397.426 512 397.428zM896 576v384h-256v-256h-256v256h-256v-384l384-288z"></path>
		</symbol>
		...
	</defs>
</svg>

然后在需要使用该icon时,调用

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

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

.icon-home{
	fill:#f00;
}

最后可根据实际需求定义需要的icon, 然后使用。