Giter VIP home page Giter VIP logo

mobile-build's Introduction

mobile-build

让移动端布局更加容易,方便后期维护

新增特性

  • 合图引用支持base64的方式,用法如下
...
@include rem-sprites(...,$line-image:true);
// or
div{
    @include rem-sprite(...,$line-image:true);
}
  • 适配手机自定义
...
$Response:true;// 此项为true,下面的配置才有效
$mediaArrays:(320 480 640 720);//默认320 360 375 400 480 540 640 720


@import "compass", "mobile-mixin";

主要功能

  1. 专为手机端定制的样式重置
  2. px轻松转rem,操作简单,维护更方便
  3. 适配各种移动终端,包括Android、iPhone、iPad,兼容更多的低端机
  4. 精灵合图,合图后的单位采用rem,并且支持base64方式引用

介绍

  • mobile-build是一个移动端布局开发解决方案。使用mobile-build可以让移动端布局开发更容易。
  • 保证不同设备下的统一视觉体验。
  • 支持任意尺寸的设计图,不局限于特定尺寸的设计图。
  • 支持单一项目,多种设计图尺寸,专为解决大型,长周期项目。
  • 提供px-to-rem转换方法,CSS布局,零成本转换,原始值不丢失。
  • 遵循视觉一致性原则。在不同大小的屏幕和不同的设备像素密度下,让你的页面看起来是一样的。
  • 不仅便捷了你的布局,同时它使用起来异常简单。可能你会说 talk is cheap,show me the code,那我现在列下mobile-build整个项目的目录结构。
├── app	//所有的源文件目录
   ├── _source //sass源文件以及封装的@mixin
        ├──_bat //window下的批处理脚本
        ├──_config //compass的ruby配置文件
        ├──_sh //Mac下的批处理脚本
        ├──_function //@mixin和@function都在这里
        └──sass //样式源文件
   ├── css //编译后css文件在这里
   ├── example //案例
   └── images //图片资源

└── dist	//文件压缩打包后的文件夹,执行grunt 或 grunt build生成
    ├── css

劣势

  • 未能解决1px的描边问题

准备

  1. 需要先安装sass和compass安装教程
  2. mac上ruby安装的教程
  3. 下载项目文件到本地zip或git执行
> git clone https://github.com/121595113/mobile-build.git

使用

方法一、 使用批处理脚本

  1. window系统可以双击_bat文件夹下的window下的批处理脚本*.bat结尾的文件,然后根据提示输入相应的指令即可。"d"表示开发模式,"p"表示生产模式,"n"表示取消;
  2. Mac系统可以终端cd到_sh的文件下,然后将*.sh结尾的文件拖到终端里回车执行。不加参数默认执行的是开发模式,如果加"-p"参数回车后执行的是生产模式。

**注:*开发模式主要执行compass watch文件监听,而生产模式主要执行compass compile样式压缩的任务,可以根据自己的项目修改.rb的配置项,里面都有相应的注释说明

方法二、 使用grunt自动化构建工具

1.首先确保您已安装了node和grunt。node的安装属于傻瓜式的安装,到node官网下载电脑对应的版本双击安装就可以了。 2.grunt使用npm安装,在安装node的时候node已经为我们安装了npm。命令行执行下面的命令将grunt安装到全局

> npm install -g grunt-cli

3.命令行cd到已下载的项目的根目录下,也就是package.json所在的目录执行下面命令安装node依赖

> npm install

4.如果你的npm是最新的版本npm3,可以执行下面的命令拉平node_modules文件夹(此步可忽略)

> npm dedupe

5.执行下面的命令开启实时监听,到此可以愉快的编码了

> grunt server

6.项目最后需要合并压缩css,并且需要为兼容不同的浏览器添加厂商前缀,执行

> grunt build

scss怎么写

一、在scss文件中引入_mobile-mixin.scss

@import "compass", "mobile-mixin";

二、可配置项如下:

$reset:true; // 是否开启样式重置,默认false
$rem-base: 720; // 用于计算rem的基数,默认值16px,依据设计稿字体大小而定。也可以根据设计搞的宽度来定,如:320 480 640 720 750,但不仅限与此。字体大小与设计稿的对应关系12:320 18:480 24:640 27:720。
$Response:true; // 是否开启自适应功能,默认为false
$mediaArrays:(320 375 480 640 720); // 可自定义适配手机数组,默认支持320 360 375 400 480 540 640 720的手机

//合图功能默认集成到mobile-mixin,不需要配置
@import "compass", "mobile-mixin";

功能模块详解

一、@function

rem-calc( $value [, $base-value] )

px转换成rem的函数,源码解读_rem-calc.scss

  • $value 必填参数,表示需要转换的值。可以是单个数字,px单位可以省略,也可以是数组。数组中可以有auto
  • $base-value 可选参数,表示用于计算rem的基准值,默认是全局的$rem-base的值。可根据字体大小设置,也可以根据设计稿大小设置

举个例子:

div{
    width:rem-calc(100);// 不带单位的一个数值
    height:rem-calc(100px,320);// 带单位的一个数值,并且指定设计图大小为320px
    margin:rem-calc(50 auto 100);// 传入数组,并且数组中有`auto`
    background-size:rem-calc(50px 100px,480);// 传入数组,并且带单位,同样指定了设计稿的宽度为480px
}

二、@mixin

rem-sprite($dir-name, $name [, $dimensions, $active, $rem-base, $spacing, $line-image] )

合成精灵图,并引用单个图片的混合宏。源码解析_rem-sprites.scss

  • $dir-name 必填参数,要合成图片的本地地址。例如,"a/*.png",其中a指图片目录下的a文件夹
  • $name 必填参数,要引用图片的文件名,注:不包括后缀名
  • $dimensions 可选参数,指是否输出图片的宽高,默认为true
  • $active 可选参数,表是否需要点击状态,默认为true。点击状态的图片命名是在原图片的基础上加-active,例如,a.png点击状态的命名为a-active.png
  • $rem-base 可选参数,表示用于计算rem的基准值,默认是全局的$rem-base的值。可根据字体大小设置,也可以根据设计稿大小设置
  • $spacing 合成图片之间的间距,默认:0px
  • $line-image 图片引用是否采用base64,默认:false
rem-sprites($dir-name [, $dimensions, $active, $pre-name, $separator, $rem-base, $spacing, $line-image] )

合成精灵图,并全部引用的混合宏。源码解析_rem-sprites.scss

  • $dir-name 必填参数,要合成图片的本地地址。例如,"a/*.png",其中a指图片目录下的a文件夹
  • $dimensions 可选参数,指是否输出图片的宽高,默认为true
  • $active 可选参数,表是否需要点击状态,默认为true。点击状态的图片命名是在原图片的基础上加-active,例如,a.png点击状态的命名为a-active.png
  • $pre-name 生成class前缀,如果不设置,默认是根据文件夹的命名作为前缀
  • $separator 生成class的连字符,默认-
  • $rem-base 可选参数,表示用于计算rem的基准值,默认是全局的$rem-base的值。可根据字体大小设置,也可以根据设计稿大小设置
  • $spacing 合成图片之间的间距,默认:0px
  • $line-image 图片引用是否采用base64,默认:false

举个例子:

/* 单个图片的引用 */
.test1{
	@include rem-sprite("cur/*.png", lv1);
}
.test2{
	@include rem-sprite("cur/*.png", lv2);
}

/* 多个图片的引用 */
@include rem-sprites("cur2/*.png", $pre-name:AAAA, $separator:"_", $spacing:4px, $line-image:true);

生成的css样式

/* 单个图片的引用 */
.test1, .test2 {
  background: url('../images/cur-s0b0a785aa0.png');
  background-size: 2.81481rem 26.07407rem;
  background-repeat: no-repeat;
}

.test1 {
  width: 2.81481rem;
  height: 3.25926rem;
  background-position: 0 0;
}

.test2 {
  width: 2.81481rem;
  height: 3.25926rem;
  background-position: 0 14.28571%;
}

/* 多个图片的引用 */
.AAAA_lv1, .AAAA_lv2, .AAAA_lv3, .AAAA_lv4, .AAAA_lv5, .AAAA_lv6, .AAAA_lv7 {
    background: url('data:image/png;base64,iVBO...Jggg==');
    background-size: 2.81481rem 23.7037rem;
    background-repeat: no-repeat;
}
.AAAA_lv1 {
    width: 2.81481rem;
    height: 3.25926rem;
    background-position: 0 0;
}

.AAAA_lv2 {
    width: 2.81481rem;
    height: 3.25926rem;
    background-position: 0 16.66667%;
}

.AAAA_lv3 {
    width: 2.81481rem;
    height: 3.25926rem;
    background-position: 0 33.33333%;
}

.AAAA_lv4 {
    width: 2.81481rem;
    height: 3.25926rem;
    background-position: 0 50%;
}

.AAAA_lv5 {
    width: 2.81481rem;
    height: 3.25926rem;
    background-position: 0 66.66667%;
}

.AAAA_lv6 {
    width: 2.81481rem;
    height: 3.25926rem;
    background-position: 0 83.33333%;
}

.AAAA_lv7 {
    width: 2.81481rem;
    height: 3.25926rem;
    background-position: 0 100%;
}

三、其它

  • _Response.scss(手机自适应)
  • compass flex布局二次分装,兼容低版本手机浏览器,使用方式API和compass的保持一致,因为此功能不常用需单独引入,引入方法如下
@import "compass","mixin-css3";// 在compass之后引入

谁在用?

(完)

mobile-build's People

Contributors

121595113 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.