1.0.1 • Published 9 years ago

postcss-data-sprite v1.0.1

Weekly downloads
1
License
MIT
Repository
github
Last release
9 years ago

postcss-data-sprite

Обработчик для PostCSS, позволяющий выделять закодированные данные в отдельный файл. Может объединять селекторы правил с одинаковыми закодированными данными.

Данные могут быть значениями свойств background, background-image, border-image, src (@font-face), content (псевдоэлементы).

Для определения данных используется выражение /url\("?data/g.

Установка

npm install postcss-data-sprite

Использование

Настройки

dataFile (по умолчанию true)

У обработчика есть два режима работы: в одном (dataFile: false) он удаляет все свойства с данными, в другом (dataFile: true) оставляет только их.

pure (по умолчанию true)

Обработчик может объединять селекторы правил с одинаковыми данными, чтобы минимизировать итоговый файл.

Селекторы правил, у которых одинаковы свойства и их значения, объединяются в первом встретившимся правиле:

.a { background-image: url(/*a.png*/); }
.b { background-image: url(/*a.png*/); }
.c { background-image: url(/*a.png*/); }
.a,
.b,
.c { background-image: url(/*a.png*/); }

Эта особенность может привести к проблемам:

.a { background-image: url(/*a.png*/) }
.b { background-image: url(/*b.png*/) }
.c { background-image: url(/*a.png*/) }

```css
.a,
.c { background-image: url(/*a.png*/) }
.b { background-image: url(/*b.png*/) }

у элемента <div class="b c"></div> применится стиль .b, так как специфичность у него больше, хоть он и объявлен раньше .c в основном файле.

Замечу, что сжатие при помощи gzip вполне может заменить эту возможность, дублирующиеся строки хорошо жмутся.

Подключение

Обработчик используется так же, как любой другой для PostCSS. Например, так для сборки Галпом:

var $ = require('gulp');
var plugins = require('gulp-load-plugins');

var dataSprite = require('postcss-data-sprite');

// удаляем все закодированные данные из основного файла
$.task('processcss', function () {
    var processors = [
        dataSprite({
            dataFile: false
        })
    ];
    $.src('css/main.css')
        .pipe(plugins().postcss(processors))
        .pipe($.dest('css/'));
});

// оставляем только закодированные данные из основного файла и оставляем только уникальные данные
$.task('processcss--data', function () {
    var processors = [
        dataSprite({
            dataFile: true,
            pure: true
        })
    ];
    $.src('css/main.css')
        .pipe(plugins().postcss(processors))
        .pipe(plugins().rename('main_data.css')) // создаём новый файл
        .pipe($.dest('css/'));
});

$.task('default', function () {
    $.watch('css/main.css', ['processcss', 'processcss--data']);
});

И затем подключаем эти файлы в разметке:

<!-- До основного файла, чтобы упростить переопределение -->
<link rel="stylesheet" href="main_data.css">
<link rel="stylesheet" href="main.css">