npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

sandal-sass

v2.1.1

Published

A sass libray for mobile

Downloads

3

Readme

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, 然后使用。