Skip to content

fis-dev/fis-prepackager-css-scale

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CSS 缩放器

什么是css缩放器?

其实就是针对背景图片进行缩放,因为是跟样式捆绑的,所以我们叫样式缩放器。

背景

主要针对无线端,目前无线端高清屏幕越来越多,为了让网页得到更好的用户体验,我们往往需要为高清 屏幕提供2倍大小的背景图片。

但是,有时候用户所在的网络环境不理想,加载非高清版本,能够让内容更快的呈现出来, 于是我们又需要提供一份非高清版本的样式,根据用户网络情况进行切换。

于是,我们需要维护两份相似度很高的样式表,这样便带来了一定的维护成本。

解决方案

如何解决样式表针对不同的终端带来的维护成本问题?

默认只提供高清版本,普通版本自动生成如何?

Excellent, 此程序就是用来实现此方案的。

如何使用?

  • 安装npm包。

    npm install -g fis-prepackager-css-scale
  • 配置fis-conf.js,对scale.css进行条件缩放。

    // 启用此css-scale插件
    fis.config.set('modules.prepackager', fis.config.get('modules.prepackager') + ',css-scale');
    
    // 配置规则, 支持数组
    fis.config.set( 'settings.prepackager.css-scale', {
        include: /scale\.css$/i,
        condition: '$condition'
    });

配置说明

注意settings.prepackager.css-scale, 可以通过include, exclude来命中文件。 (支持正则,glob语法),插件针对命中的文件进行缩放。另外此配置项支持数组数据,对数组里面的所有规则都进行处理。

命中css类文件

如果命中的是css类文件,所有对其引用都会加上缩放并条件引用。

  • link标签
    • 源码

      ...
      <link rel="stylesheet" type="text/css" href="/static/css/scale.css">
      ...
    • 输出结果

      ...
      {%if $condition%}<link rel="stylesheet" type="text/css" href="/static/test/css/scale.css">{%else%}<link rel="stylesheet" type="text/css" href="/static/test/css/scale_0.5x.css">{%/if%}
      ...
  • @import规则
    • 源码

      ...
      <style type="text/css">
          @import url(/static/css/scale.css);
      
          /*其他样式*/
          .ruler {
              width: auto;
          }
      </style>
      ...
    • 输出结果

      ...
      <style type="text/css">
          {%if $condition%}@import url(/static/test/css/scale.css);{%else%}@import url(/static/test/css/scale_0.5x.css);{%/if%}
      
          /*其他样式*/
          .ruler {
              width: auto;
          }
      </style>
      ...
  • require smarty插件
    • 源码

      ...
      {%require name="test:static/css/scale.css"%}
      ...
    • 输出结果

      ...
      {%if $condition%}{%require name="test:static/css/scale.css"%}{%else%}{%require name="test:static/css/scale_0.5x.css"%}{%/if%}
      ...

命中html类文件(包括tpl文件)

如果命中的是html类文件,此页面里面的所有内联style样式都会进行缩放。

页面的中内联样式。(也支持{%style%}格式,这里不另外给出了。)

  • 源码

    ...
    <style type="text/css">
    .ruler {
        background: url(/static/test/images/iphone.png?xxx);
        -webkit-background-size: 508px 899px;
        -moz-background-size: 400px 500px;
    }
    
    .ruler {
        background: url(/static/test/images/iphone.png);
    }</style>
    ...
  • 输出结果

    {%if $condition%}<style type="text/css">
    .ruler {
        background: url(/static/test/images/iphone.png?xxx);
        -webkit-background-size: 508px 899px;
        -moz-background-size: 400px 500px;
    }
    
    .ruler {
        background: url(/static/test/images/iphone.png);
    }</style>{%else%}<style type="text/css">
    .ruler {
        background: url(/static/test/images/iphone_0.5x.png?xxx);
        -moz-background-size: 400px 500px;
    }
    
    .ruler {
        background: url(/static/test/images/iphone_0.5x.png);
        background-size: 1017px 1798px;
    }</style>{%/if%}

配置条件分支

默认只会有两个分支if condition rawelseraw(scale x 0.5) /if。 如果这样已经满足你的需求了,只需要修改condition里面的变量值就ok.

如果不满足,可以配置tpl, 这个时候condition配置项已经失效了。如:

fis.config.set( 'settings.prepackager.css-scale', {
    include: /scale\.css$/i,
    tpl: '#if $ios#__placeholder__#elseif $android#__placeholder__x0.75#else#__placeholder__x0.5#endif#'
});

这里__placeholder__表示原始内容,__placeholder__x0.5表示将原始内容缩小了0.5倍。这个数值可以随意配置。

如果不想条件使用,而是直接使用缩放后的资源。

其实进不进行缩放是根据tpl来的,tpl设置为__placeholder__x0.5, 这样所有的内容就使用0.5缩放版本了。

具体细节

针对高清屏幕的样式,我们往往会这么写。

.ruler {
    background: url('xxx_200x200.png');
    background-size: 100px 100px;
}

把它转成普通版本的样式,需要两步。

  1. 把图片xxx_200x200.png,通过photoshop缩小一倍, 变成xxx_100x100.png
  2. 去掉background-size一条。

最终变成。

.ruler {
    background: url('xxx_100x100.png');
}

当然还有更多细节处理,这里不列出来!

担心图片自动缩放效果不好?

完全不用担心,效果与photoshop缩放的效果非常接近。

scale 0.2倍。

系统:系统缩放 Photoshop: photoshop缩放

如果不想让某个背景图片自动缩放,怎么办?

默认样式表中所有图片,在此样式缩放的时候都会跟着缩放。如果某个图片不想被缩放,怎么办?

设置一个noScale属性就ok了。如下:

.ruler {
    background: url(xxx.png?__noscale);
}

Releases

No releases published

Packages

No packages published