Compass Sprite Image

Example 1 Simple mixins:

a.twitter
  +sprite-img("icons-32.png", 1)
a.facebook
  +sprite-img("icons-32png", 2)

Example 2 Sharing a common base:

a
  +sprite-background("icons-32.png")
  a.twitter
    +sprite-column(1)
  a.facebook
    +sprite-row(2)

This file can be imported using: @import "compass/utilities/sprites/sprite-img"

View the Source for this module on Github.

Configurable Variables help

Value
32px

Value
0px

Value
$sprite-default-size

Value
$sprite-default-size

Mixins

View Source: Sass | SCSS 

=sprite-img($img, $col, $row: 1, $width: $sprite-image-default-width, $height: $sprite-image-default-height, $margin: $sprite-default-margin)
  +sprite-background($img, $width, $height)
  +sprite-position($col, $row, $width, $height, $margin)

@mixin sprite-img($img, $col, $row: 1, $width: $sprite-image-default-width, $height: $sprite-image-default-height, $margin: $sprite-default-margin) {
  @include sprite-background($img, $width, $height);
  @include sprite-position($col, $row, $width, $height, $margin); }

Sets all the rules for a sprite from a given sprite image to show just one of the sprites. To reduce duplication use a sprite-bg mixin for common properties and a sprite-select mixin for positioning.

View Source: Sass | SCSS 

=sprite-background($img, $width: $sprite-default-size, $height: $width)
  +sprite-background-rectangle($img, $width, $height)

@mixin sprite-background($img, $width: $sprite-default-size, $height: $width) {
  @include sprite-background-rectangle($img, $width, $height); }

Sets rules common for all sprites, assumes you want a square, but allows a rectangular region.

View Source: Sass | SCSS 

=sprite-background-rectangle($img, $width: $sprite-image-default-width, $height: $sprite-image-default-height)
  background: image-url($img) no-repeat
  width: $width
  height: $height
  overflow: hidden

@mixin sprite-background-rectangle($img, $width: $sprite-image-default-width, $height: $sprite-image-default-height) {
  background: image-url($img) no-repeat;
  width: $width;
  height: $height;
  overflow: hidden; }

Sets rules common for all sprites, assumes a rectangular region.

View Source: Sass | SCSS 

=sprite-column($col, $width: $sprite-image-default-width, $margin: $sprite-default-margin)
  +sprite-position($col, 1, $width, 0px, $margin)

@mixin sprite-column($col, $width: $sprite-image-default-width, $margin: $sprite-default-margin) {
  @include sprite-position($col, 1, $width, 0px, $margin); }

Allows horizontal sprite positioning optimized for a single row of sprites.

View Source: Sass | SCSS 

=sprite-row($row, $height: $sprite-image-default-height, $margin: $sprite-default-margin)
  +sprite-position(1, $row, 0px, $height, $margin)

@mixin sprite-row($row, $height: $sprite-image-default-height, $margin: $sprite-default-margin) {
  @include sprite-position(1, $row, 0px, $height, $margin); }

Allows vertical sprite positioning optimized for a single column of sprites.

View Source: Sass | SCSS 

=sprite-position($col, $row: 1, $width: $sprite-image-default-width, $height: $sprite-image-default-height, $margin: $sprite-default-margin)
  $x: ($col - 1) * -$width - ($col - 1) * $margin
  $y: ($row - 1) * -$height - ($row - 1) * $margin
  background-position: $x $y

@mixin sprite-position($col, $row: 1, $width: $sprite-image-default-width, $height: $sprite-image-default-height, $margin: $sprite-default-margin) {
  $x: ($col - 1) * -$width - ($col - 1) * $margin;
  $y: ($row - 1) * -$height - ($row - 1) * $margin;
  background-position: $x $y; }

Allows vertical and horizontal sprite positioning from a grid of equal dimensioned sprites.