broccoli-sass-image-compiler v0.1.4

broccoli-sass-image-compiler

MIT License

This is a broccoli library for processing image files and creating SASS variables with Data URIs in them.

NOTES:

1. file names must make good SASS variable names. Names like "my awesome image.gif" will not work because of the spaces.
2. file names don't need the $ prefix.
3. file names should be unique regardless of folder depth. This script is "dumb" and just uses the file name.
4. Do a little dance.
5. Make a little love.
6. Get down tonight.

Usage

In your Brocfile.js:

var sassImageCompiler = require('broccoli-sass-image-compiler');

var imageTree = sassImageCompiler('/some_dir', {
	inputFiles: [
		'**/*.png', // all png files
		'someFile.svg' // specific svg file
	],

	// specify the output file you want created
	outputFile: '/compiled-images.scss',

	// whether or not to output an icon class
	// defaults to true
	icon: true,

	// whether or not to output width and height variables, required for icon class.
	// defaults to true
	size: true, 

	// name for parent class of icon class output (i.e "icon" in `.icon.image_name`)
	// defaults to "icon"
	iconClass: 'icon'
});

Then in your SASS

@import 'path/to/compiled-images';

.custom-class {
	background-image: url($someFile); // derived from 'someFile.svg'
}

.other-class {
	background-image: url($icon_16x16); // if you had a file named "whatever/icon_16x16.png"
}

Output from this tool includes:

• $filename : the data URI variable with the base64 encoded image in it.
• $filename_width : the width of the image
• $filename_height : the height of the image
• .icon.filename : classes that, when applied can be used as an icon for the image file. <div class="icon filename"></div>