spritesheet-templates/test/expected_files/less.less

Convert spritesheet data into CSS or CSS pre-processor data

/*
LESS variables are information about icon's compiled state, stored under its original file name

.icon-home {
  width: @icon-home-width;
}

The large array-like variables contain all information about a single icon
@icon-home: x y offset_x offset_y width height total_width total_height image_path name;

At the bottom of this section, we provide information about the spritesheet itself
@spritesheet: width height image @spritesheet-sprites;
*/
@sprite-dash-case-name: 'sprite-dash-case';
@sprite-dash-case-x: 0px;
@sprite-dash-case-y: 0px;
@sprite-dash-case-offset-x: 0px;
@sprite-dash-case-offset-y: 0px;
@sprite-dash-case-width: 10px;
@sprite-dash-case-height: 20px;
@sprite-dash-case-total-width: 80px;
@sprite-dash-case-total-height: 100px;
@sprite-dash-case-image: 'nested/dir/spritesheet.png';
@sprite-dash-case: 0px 0px 0px 0px 10px 20px 80px 100px 'nested/dir/spritesheet.png' 'sprite-dash-case';
@sprite-snake-case-name: 'sprite_snake_case';
@sprite-snake-case-x: 10px;
@sprite-snake-case-y: 20px;
@sprite-snake-case-offset-x: -10px;
@sprite-snake-case-offset-y: -20px;
@sprite-snake-case-width: 20px;
@sprite-snake-case-height: 30px;
@sprite-snake-case-total-width: 80px;
@sprite-snake-case-total-height: 100px;
@sprite-snake-case-image: 'nested/dir/spritesheet.png';
@sprite-snake-case: 10px 20px -10px -20px 20px 30px 80px 100px 'nested/dir/spritesheet.png' 'sprite_snake_case';
@sprite-camel-case-name: 'spriteCamelCase';
@sprite-camel-case-x: 30px;
@sprite-camel-case-y: 50px;
@sprite-camel-case-offset-x: -30px;
@sprite-camel-case-offset-y: -50px;
@sprite-camel-case-width: 50px;
@sprite-camel-case-height: 50px;
@sprite-camel-case-total-width: 80px;
@sprite-camel-case-total-height: 100px;
@sprite-camel-case-image: 'nested/dir/spritesheet.png';
@sprite-camel-case: 30px 50px -30px -50px 50px 50px 80px 100px 'nested/dir/spritesheet.png' 'spriteCamelCase';
@spritesheet-width: 80px;
@spritesheet-height: 100px;
@spritesheet-image: 'nested/dir/spritesheet.png';
@spritesheet-sprites: @sprite-dash-case @sprite-snake-case @sprite-camel-case;
@spritesheet: 80px 100px 'nested/dir/spritesheet.png' @spritesheet-sprites;

/*
The provided classes are intended to be used with the array-like variables

.icon-home {
  .sprite-width(@icon-home);
}
.icon-email {
  .sprite(@icon-email);
}

Example usage in HTML:

`display: block` sprite:
<div class="icon-home"></div>

To change `display` (e.g. `display: inline-block;`), we suggest using a common CSS class:

// CSS
.icon {
  display: inline-block;
}

// HTML
<i class="icon icon-home"></i>
*/
.sprite-width(@sprite) {
  width: extract(@sprite, 5);
}

.sprite-height(@sprite) {
  height: extract(@sprite, 6);
}

.sprite-position(@sprite) {
  @sprite-offset-x: extract(@sprite, 3);
  @sprite-offset-y: extract(@sprite, 4);
  background-position: @sprite-offset-x @sprite-offset-y;
}

.sprite-image(@sprite) {
  @sprite-image: extract(@sprite, 9);
  background-image: e(%('url(%a)', e(@sprite-image)));
}

.sprite(@sprite) {
  .sprite-image(@sprite);
  .sprite-position(@sprite);
  .sprite-width(@sprite);
  .sprite-height(@sprite);
}

/*
The `.sprites` mixin generates identical output to the CSS template
  but can be overridden inside of LESS

This must be run when you have at least 2 sprites.
  If run with a single sprite, then there will be reference errors.

.sprites(@spritesheet-sprites);
*/
.sprites(@sprites, @i: 1) when (@i <= length(@sprites)) {
  @sprite: extract(@sprites, @i);
  @sprite-name: e(extract(@sprite, 10));
  .@{sprite-name} {
    .sprite(@sprite);
  }
  .sprites(@sprites, @i + 1);
}