diff --git a/doc-src/Gemfile.lock b/doc-src/Gemfile.lock index 19d1a2b8..a3b96ca1 100644 --- a/doc-src/Gemfile.lock +++ b/doc-src/Gemfile.lock @@ -10,7 +10,7 @@ GIT PATH remote: .. specs: - compass (0.13.alpha.0.e0bb519) + compass (0.13.alpha.0.0c13d98) chunky_png (~> 1.2) fssm (>= 0.2.7) sass (~> 3.2.0.alpha.93) @@ -45,7 +45,7 @@ GEM rb-fsevent (0.9.0) rdiscount (1.6.8) ruby-prof (0.10.8) - sass (3.2.0.alpha.94) + sass (3.2.0.alpha.101) serve (1.0.0) activesupport (~> 3.0.1) i18n (~> 0.4.1) diff --git a/doc-src/content/reference/compass/css3/animation.haml b/doc-src/content/reference/compass/css3/animation.haml new file mode 100644 index 00000000..1bd4bac4 --- /dev/null +++ b/doc-src/content/reference/compass/css3/animation.haml @@ -0,0 +1,16 @@ +--- +title: Compass Animation +crumb: Animation +framework: compass +stylesheet: compass/css3/_animation.scss +meta_description: Specify the CSS3 animation property and all its sub-properties. +layout: core +classnames: + - reference + - core + - css3 +--- +- render 'reference' do + :markdown + Provides a mixin for `animation` and all its sub-properties. + See the CSS3 specification: [animation](http://www.w3.org/TR/css3-animations/). diff --git a/frameworks/compass/stylesheets/compass/_css3.scss b/frameworks/compass/stylesheets/compass/_css3.scss index 8291bd16..1607ac84 100644 --- a/frameworks/compass/stylesheets/compass/_css3.scss +++ b/frameworks/compass/stylesheets/compass/_css3.scss @@ -14,3 +14,4 @@ @import "css3/transform"; @import "css3/transition"; @import "css3/appearance"; +@import "css3/animation"; diff --git a/frameworks/compass/stylesheets/compass/css3/_animation.scss b/frameworks/compass/stylesheets/compass/css3/_animation.scss new file mode 100644 index 00000000..7be35378 --- /dev/null +++ b/frameworks/compass/stylesheets/compass/css3/_animation.scss @@ -0,0 +1,127 @@ +@import "shared"; + +// CSS Animations. + +// Apply an animation property and value with the correct browser support +@mixin animation-support($property, $value) { + @include experimental($property, $value, -moz, -webkit, -o, -ms, not -khtml, official); } + +// Name of any animation as a string. +$default-animation-name : false !default; + +// Duration of the entire animation in seconds. +$default-animation-duration : false !default; + +// Delay for start of animation in seconds. +$default-animation-delay : false !default; + +// The timing function(s) to be used between keyframes. [ease | linear | ease-in | ease-out | ease-in-out | cubic-bezier($number, $number, $number, $number)] +$default-animation-timing-function : false !default; + +// The number of times an animation cycle is played. [infinite | $number] +$default-animation-iteration-count : false !default; + +// Whether or not the animation should play in reverse on alternate cycles. [normal | alternate] +$default-animation-direction : false !default; + +// What values are applied by the animation outside the time it is executing. [none | forwards | backwards | both] +$default-animation-fill-mode : false !default; + +// Whether the animation is running or paused. [running | paused] +$default-animation-play-state : false !default; + +// Create a named animation sequence that can be applied to elements later. +// +// $name - The name of your animation. +// @content - The keyframes of the animation. +@mixin keyframes( + $name, + $moz: $experimental-support-for-mozilla, + $webkit: $experimental-support-for-webkit, + $o: $experimental-support-for-opera, + $ms: $experimental-support-for-microsoft, + $khtml: $experimental-support-for-khtml, + $official: true +) { + @if $moz { + @include with-only-support-for($moz: true) { + @-moz-keyframes #{$name} { @content; } + } + } + @if $webkit { + @include with-only-support-for($webkit: true) { + @-webkit-keyframes #{$name} { @content; } + } + } + @if $o { + @include with-only-support-for($o: true) { + @-o-keyframes #{$name} { @content; } + } + } + @if $ms { + @include with-only-support-for($ms: true) { + @-ms-keyframes #{$name} { @content; } + } + } + @if $khtml { + @include with-only-support-for($khtml: true) { + @-khtml-keyframes #{$name} { @content; } + } + } + @if $official { + @include with-only-support-for { + @keyframes #{$name} { @content; } + } + } +} + +// Apply 1-10 animation names. +@mixin animation-name($name-1: $default-animation-name, $name-2: false, $name-3: false, $name-4: false, $name-5: false, $name-6: false, $name-7: false, $name-8: false, $name-9: false, $name-10: false) { + $name: compact($name-1, $name-2, $name-3, $name-4, $name-5, $name-6, $name-7, $name-8, $name-9, $name-10); + @include animation-support(animation-name, $name); } + +// Apply 1-10 animation durations. +@mixin animation-duration($duration-1: $default-animation-duration, $duration-2: false, $duration-3: false, $duration-4: false, $duration-5: false, $duration-6: false, $duration-7: false, $duration-8: false, $duration-9: false, $duration-10: false) { + $duration: compact($duration-1, $duration-2, $duration-3, $duration-4, $duration-5, $duration-6, $duration-7, $duration-8, $duration-9, $duration-10); + @include animation-support(animation-duration, $duration); } + +// Apply 1-10 animation delays. +@mixin animation-delay($delay-1: $default-animation-delay, $delay-2: false, $delay-3: false, $delay-4: false, $delay-5: false, $delay-6: false, $delay-7: false, $delay-8: false, $delay-9: false, $delay-10: false) { + $delay: compact($delay-1, $delay-2, $delay-3, $delay-4, $delay-5, $delay-6, $delay-7, $delay-8, $delay-9, $delay-10); + @include animation-support(animation-delay, $delay); } + +// Apply 1-10 animation timing functions. +@mixin animation-timing-function($function-1: $default-animation-timing-function, $function-2: false, $function-3: false, $function-4: false, $function-5: false, $function-6: false, $function-7: false, $function-8: false, $function-9: false, $function-10: false) { + $function: compact($function-1, $function-2, $function-3, $function-4, $function-5, $function-6, $function-7, $function-8, $function-9, $function-10); + @include animation-support(animation-timing-function, $function); } + +// Apply 1-10 animation iteration counts. +@mixin animation-iteration-count($count-1: $default-animation-iteration-count, $count-2: false, $count-3: false, $count-4: false, $count-5: false, $count-6: false, $count-7: false, $count-8: false, $count-9: false, $count-10: false) { + $count: compact($count-1, $count-2, $count-3, $count-4, $count-5, $count-6, $count-7, $count-8, $count-9, $count-10); + @include animation-support(animation-iteration-count, $count); } + +// Apply 1-10 animation directions. +@mixin animation-direction($direction-1: $default-animation-direction, $direction-2: false, $direction-3: false, $direction-4: false, $direction-5: false, $direction-6: false, $direction-7: false, $direction-8: false, $direction-9: false, $direction-10: false) { + $direction: compact($direction-1, $direction-2, $direction-3, $direction-4, $direction-5, $direction-6, $direction-7, $direction-8, $direction-9, $direction-10); + @include animation-support(animation-direction, $direction); } + +// Apply 1-10 animation fill modes. +@mixin animation-fill-mode($mode-1: $default-animation-fill-mode, $mode-2: false, $mode-3: false, $mode-4: false, $mode-5: false, $mode-6: false, $mode-7: false, $mode-8: false, $mode-9: false, $mode-10: false) { + $mode: compact($mode-1, $mode-2, $mode-3, $mode-4, $mode-5, $mode-6, $mode-7, $mode-8, $mode-9, $mode-10); + @include animation-support(animation-fill-mode, $mode); } + +// Apply 1-10 animation play states. +@mixin animation-play-state($state-1: $default-animation-play-state, $state-2: false, $state-3: false, $state-4: false, $state-5: false, $state-6: false, $state-7: false, $state-8: false, $state-9: false, $state-10: false) { + $state: compact($state-1, $state-2, $state-3, $state-4, $state-5, $state-6, $state-7, $state-8, $state-9, $state-10); + @include animation-support(animation-play-state, $state); } + +// Shortcut to apply a named animation to an element, with all the settings. +// +// $animation-1 : Name and settings for the first animation. [ | default] +// ... +// $animation-10 : Name and settings for the tenth animation. +@mixin animation($animation-1: default, $animation-2: false, $animation-3: false, $animation-4: false, $animation-5: false, $animation-6: false, $animation-7: false, $animation-8: false, $animation-9: false, $animation-10: false) { + @if $animation-1 == default { + $animation-1: -compass-space-list(compact($default-animation-name, $default-animation-duration, $default-animation-timing-function, $default-animation-delay, $default-animation-iteration-count, $default-animation-direction, $default-animation-fill-mode, $default-animation-play-state)); } + $animation: compact($animation-1, $animation-2, $animation-3, $animation-4, $animation-5, $animation-6, $animation-7, $animation-8, $animation-9, $animation-10); + @include animation-support(animation, $animation); } diff --git a/frameworks/compass/stylesheets/compass/css3/_shared.scss b/frameworks/compass/stylesheets/compass/css3/_shared.scss index 1f55cb55..4076419b 100644 --- a/frameworks/compass/stylesheets/compass/css3/_shared.scss +++ b/frameworks/compass/stylesheets/compass/css3/_shared.scss @@ -36,3 +36,29 @@ @if $o and $experimental-support-for-opera { #{$property} : -o-#{$value}; } @if $official { #{$property} : #{$value}; } } + +// Change the experimental-support settings in specific contexts. +@mixin set-experimental-support($moz: false, $webkit: false, $ms: false, $o: false, $khtml: false) { + $experimental-support-for-mozilla: $moz; + $experimental-support-for-webkit: $webkit; + $experimental-support-for-microsoft: $ms; + $experimental-support-for-opera: $o; + $experimental-support-for-khtml: $khtml; +} + +// This mixin allows you to change the experimental support settings for +// child (@content) styles. +@mixin with-only-support-for($moz: false, $webkit: false, $ms: false, $o: false, $khtml: false) { + // Capture the current state + $original-moz: $experimental-support-for-mozilla; + $original-webkit: $experimental-support-for-webkit; + $original-o: $experimental-support-for-opera; + $original-ms: $experimental-support-for-microsoft; + $original-khtml: $experimental-support-for-khtml; + // Change support settings + @include set-experimental-support($moz, $webkit, $ms, $o, $khtml); + // Apply styles + @content; + // Return to original support settings + @include set-experimental-support($original-moz, $original-webkit, $original-ms, $original-o, $original-khtml); +} diff --git a/test/fixtures/stylesheets/compass/css/animation.css b/test/fixtures/stylesheets/compass/css/animation.css new file mode 100644 index 00000000..37fea120 --- /dev/null +++ b/test/fixtures/stylesheets/compass/css/animation.css @@ -0,0 +1,41 @@ +@-moz-keyframes test { + 0%, 100% { + background-color: red; } + + 50% { + background-color: blue; } } + +@-webkit-keyframes test { + 0%, 100% { + background-color: red; } + + 50% { + background-color: blue; } } + +@-o-keyframes test { + 0%, 100% { + background-color: red; } + + 50% { + background-color: blue; } } + +@-ms-keyframes test { + 0%, 100% { + background-color: red; } + + 50% { + background-color: blue; } } + +@keyframes test { + 0%, 100% { + background-color: red; } + + 50% { + background-color: blue; } } + +.animation { + -webkit-animation: test; + -moz-animation: test; + -ms-animation: test; + -o-animation: test; + animation: test; } diff --git a/test/fixtures/stylesheets/compass/sass/animation.scss b/test/fixtures/stylesheets/compass/sass/animation.scss new file mode 100644 index 00000000..8a14da25 --- /dev/null +++ b/test/fixtures/stylesheets/compass/sass/animation.scss @@ -0,0 +1,13 @@ +@import "compass/css3/animation"; + +@include keyframes(test) { + 0%, 100% { + background-color: red; } + 50% { + background-color: blue; + } +} + +.animation { + @include animation(test); +} \ No newline at end of file