Source on Github

Compass Background Clip

Provides a mixin for background-clip. See CSS3 spec: background-clip.

This file can be imported using: @import "compass/css3/background-clip"

Examples

Background Clip
See background-clip in action.

Imports

  1. Shared Utilities

Configurable Variables help

padding-box

The default value is padding-box -- the box model used by modern browsers.

If you wish to do so, you can override the default constant with border-box

To override to the default border-box model, use this code:

$default-background-clip: border-box

Mixins

view source

=background-clip($clip: $default-background-clip)
  // webkit and mozilla use the deprecated short [border | padding]
  $clip: unquote($clip)
  $deprecated: $clip
  @if $clip == padding-box
    $deprecated: padding
  @if $clip == border-box
    $deprecated: border
  // Support for webkit and mozilla's use of the deprecated short form
  +experimental(background-clip, $deprecated, -moz, -webkit, not -o, not -ms, not -khtml, not official)
  +experimental(background-clip, $clip, not -moz, not -webkit, not -o, not -ms, -khtml, official)
@mixin background-clip($clip: $default-background-clip) {
  // webkit and mozilla use the deprecated short [border | padding]
  $clip: unquote($clip);
  $deprecated: $clip;
  @if $clip == padding-box {
    $deprecated: padding;
  }
  @if $clip == border-box {
    $deprecated: border;
  }
  // Support for webkit and mozilla's use of the deprecated short form
  @include experimental(background-clip, $deprecated, -moz, -webkit, not -o, not -ms, not -khtml, not official);
  @include experimental(background-clip, $clip, not -moz, not -webkit, not -o, not -ms, -khtml, official);
}

Clip the background (image and color) at the edge of the padding or border.

Legal Values: