fis-spriter-csssprites-group-rename/README.md

基于fis的csssprite，支持分组合并图片，@media处理，合并路径指定

# fis-spriter-csssprites

基于FIS的csssprites，由[fis-spriter-csssprites](https://github.com/fex-team/fis-spriter-csssprites) 修改而来，具体说明请访问原项目了解

### 特性
在官方基础上，添加支持图片分组合并、@media处理、合并路径指定、rem支持  

####@media处理
样式中存在的媒体查询，往往是需要做响应式兼容，大多数情况下需要跟其他图片分开处理，如retina处理。  
所以，将**@media**当作单独的一部分样式处理，生成的css也写入到@media中，完美解决原先合并处理后生成的样式混乱问题。

<table>
    <tr>
        <th>query</th>
        <th>说明</th>
    </tr>
    <tr>
        <td>?__sprite</td>
        <td>标识图片要做合并</td>
    </tr>
    <tr>
        <td>?__sprite=group</td>
        <td>标识图片合并到"group_(x|y|z).png"</td>
    </tr>
</table>

> `group`只支持“字母、数字、-、_”

### 配置

* 启用 fis-spriter-csssprites 插件

```javascript
fis.match('::package', {
    spriter: fis.plugin('csssprites-group')
});
```

* 其他设置，更多详细设置请参考[fis-spriter-csssprites](https://github.com/fex-team/fis-spriter-csssprites)

```javascript
fis.config.set('settings.spriter.csssprites-group', {
	//图片缩放比例
	scale: 1,
	//1rem像素值
	rem: 50,
    //图之间的边距
    margin: 10,
    //使用矩阵排列方式，默认为线性`linear`
    layout: 'matrix',
    //合并图片存到/img/
    to: '/img'
});

fis
.match('vue/*.css', {
	// 这里的spriteTo为最高优先匹配，会覆盖全局的to设置
	spriteTo : 'img/pkg'
})
```

> `to` 参数可以为相对路径（相对当前css路径）、绝对路径（项目根路径）

> `spriteTo` 作为文件的to设置，为最高优先匹配，与`to`一样支持相对、绝对路径

### rem自动识别
目前支持在特有情况下自动识别rem，并根据settings.rem转换单位

* 当background-size使用rem为单位时，如下：

```css
.icon {
	background: url('img/icon.png?__sprite') no-repeat;
	background-size: .5rem .5rem;
}
```

* 当background-size:contain时、且windth、height使用rem作为单位，如下：

```css
.icon {
	display: inline-block;
	width: .5rem;
	height: .5rem;
	background: url('img/icon.png?__sprite') no-repeat;
	background-size: contain;
}
```

> 以上两个例子是等价的，都会使用rem作为单位处理

对于层叠的样式，因为条件复杂，无法正确识别上下文，所以不支持组合的样式background-size:contain匹配rem，如下：

```css
.icon {
	display: inline-block;
	width: .5rem;
	height: .5rem;
}
.icon-1 {
	background: url('img/icon.png?__sprite') no-repeat;
	background-size: contain;
}
```
> 这种情况是无法识别成功的