filter-css

filter-css

Filter CSS rules

Install

$ npm install --save filter-css

Usage

var filterCss = require('filter-css');

var filtered = filterCss('test.css',{
    types: ['<type>'],
    selectors: ['.my-selector > p', /(some)|(regexp)/],
    declarations: ['url(myImage.png)', /url/],
});

When only filtering types and seletors you can use a shorthand. Types are identified by a leading @. Everything else (RegExp, String) is used for selector matching.

var filterCss = require('filter-css');

var filtered = filterCss('test.css',['@<type>','.my > complete-selector',/complete/]);

You can also pass in a filter function. The function receives the type as first and the AST Element / String as second argument. When the function returns true, the element will be discarded.

var filterCss = require('filter-css');

var filtered = filterCss('test.css',function(type, data){
	return type === 'type' && data === 'font-face' ||
		   type === 'selector' && data.match(/test/) ||
    	   type === 'declaration' && /background/.test(data.property) && /url/.test(data.value);
});

body {
	margin: 0;
	padding: 0;
}

@font-face {
	font-family: 'Glyphicons Halflings';
}

Match @type

var filterCss = require('filter-css');

filterCss('test/fixtures/test.css',['@font-face']);
//=> 

body {
	margin: 0;
	padding: 0;
}

Match RegExp

var filterCss = require('filter-css');

filterCss('test/fixtures/test.css',[/bod/]);
//=> 

@font-face {
	font-family: 'Glyphicons Halflings';
}

Filter Declaration

.bigBackground {
	width: 100%;
	height: 100%;
	background-image: url('some/big/image.png');
}

var filterCss = require('filter-css');

filterCss('test/fixtures/test.css',[/url\(/]);
//=> 

.bigBackground {
	width: 100%;
	height: 100%;
}

CLI

filter-css works well with standard input.

$ cat test/fixture/test.css | filtercss --ignore @font-face

You can also pass in the file as an option.

$ filtercss test/fixture/test.css --ignore @font-face

API

filterCss(input, [ignores])

input

Required
Type: string

CSS filepath or raw css string.

ignores

Type: array

List of RegExp, @type or selectors to remove

License

MIT © Ben Zörb