modernizr-mixin 2.0.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9f946ac711102f5abe64c440ef41d7426b47db0a
-  data.tar.gz: 79b99ea7dcbaed4911bd28bf01f29bdc232cd450
+  metadata.gz: 2826bb0962442c50c1ace1a520a0978c2ae0afc3
+  data.tar.gz: def3e9363494f188d3cd8f41a9a1367de56e62d4
 SHA512:
-  metadata.gz: 42b0f6f4a19777e8f4e9fd721453e11475468a8d55d83028165c7368e50be0312456bb6d46a196eb2a1414b6f0a6d427d3e20491d490c7a2189910f5860cdf8a
-  data.tar.gz: 5ffd4f797553dd00a99fb220918c9252feb33355142106bd7bd884f8a307c94a6871b9358d7e0695d484c2bafa6eeabea2cb1c0ddad5f53ae18106043e9f6852
+  metadata.gz: 6873c4b0533efacf2f51ea111aa84540e4726d8bf11f42e76b610e5e11018d29de8582de933d427f706c2acb85e2cdb92595d00dae3a06020bd9edb9e2e1659f
+  data.tar.gz: b2ac07b634166d3c7d0be06d36bd1d429271700c15eba0ab967c4d6a815abe02af2f0e812de5489470356b8d8dab37417f7789ac9f04ace07112be77b3c51c01

data/README.md

@@ -2,32 +2,28 @@
 
 A simple way for DRYier, faster and cleaner Modernizr tests in Sass.
 
+[![Build Status](https://travis-ci.org/danielguillan/modernizr-mixin.svg?branch=master)](https://travis-ci.org/danielguillan/modernizr-mixin)
 
 ## Install
 
-Requires Sass 3.3
+Requires Sass 3.4
 
 There are 3 ways of installing the Modernizr mixin:
 
 ### Download
 
-Download `_modernizr.scss` which is located in the `stylesheets` folder and place it in your Sass directory.
+Download [_modernizr.scss](/stylesheets/_modernizr.scss) and place it in your Sass directory.
 
 ### Bower
 
-To install the package using Bower simply run the following command:
+Run the following command:
 
 	bower install --save-dev modernizr-mixin
 
 ### Compass extension
 
-Modernizr is also available as a Compass extension:
-
-	gem install modernizr-mixin
-
-Then add the following line to your `config.rb`:
-
-	require 'modernizr-mixin'
+1. `gem install modernizr-mixin`
+2. Add `require 'modernizr-mixin'` to your `config.rb`
 
 ## Usage
 
@@ -82,6 +78,6 @@ CSS output:
 }
 ```
 
-## Acknowledgements
+## Credits
 
-Thanks to [Hugo Giraudel](https://github.com/hugogiraudel) for reviewing and tweaking the original code.
+Thanks [Hugo Giraudel](https://github.com/hugogiraudel) for the code review and tweaks.

data/lib/modernizr-mixin.rb

@@ -3,6 +3,6 @@ extension_path = File.expand_path(File.join(File.dirname(__FILE__), ".."))
 Compass::Frameworks.register('modernizr-mixin', :path => extension_path)
 
 module ModernizrMixin
-  VERSION = "2.0.0"
-  DATE = "2014-05-06"
+  VERSION = "3.0.0"
+  DATE = "2014-08-31"
 end

data/stylesheets/_modernizr.scss

@@ -1,30 +1,23 @@
-// =============================================================================
+// -----------------------------------------------------------------------------
 // Modernizr mixin
-//
-// Table of contents:
-// 1. Modernizr mixin
-//   1.1 Generate placeholder name and selectors
-//   1.2 Define placeholder and print @content
-//   1.3 Define feature selector and extend the placeholder
-// 2. Aliases
-//   2.1 Yep alias
-//   2.2 Nope alias
-//
-// Usage:
-// .my-selector {
-//   @include yep($features...) { ... }
-//   @include nope($features...) { ... {
-// }
-//
-// =============================================================================
-
-// =============================================================================
-// 1. Modernizr mixin
-// =============================================================================
-
-@mixin modernizr($features, $supports) {
-
-  $everything-okay: true;
+// -----------------------------------------------------------------------------
+
+// -----------------------------------------------------------------------------
+// Modernizr
+// -----------------------------------------------------------------------------
+
+/**
+* Prints classes for supported or unsupported features
+* ---
+* @access private
+* ---
+* @param {Bool}      $supports   - Whether to check for supported features or not
+* @param {ArgList}   $features   - List of features
+* ---
+* @throws `$feature` is not a `string` for `modernizr`
+*/
+
+@mixin modernizr($supports, $features...) {
 
   // Use the 'no-' prefix if checking for unsuported features (e.g. `.no-translate3d`)
   $prefix: if($supports, '', 'no-');
@@ -32,28 +25,23 @@
   // Features selector
   // a) create a string if checking for supported features. We'll concatenate class names later on (e.g. `.translate3d.opacity selector`)
   // b) create a list if checking for unsuported features. We'll append the class names later on (e.g. `.no-js selector, .no-translate3d selector`)
-  $selector: if($supports, '', (unquote('.no-js')));
+  $selector: if($supports, '', unquote('.no-js'));
 
-  // The placeholder (e.g. `%yep-translate3d` or `%nope-opacity`)
-  $placeholder: if($supports, '%yep', '%nope');
-
-
-  // 1.1 Generate placeholder and selectors
-  // =====================================
+  // Make sure the mixin has been called within a selector
+  @if not & {
+    @error 'Modernizr mixin should be called within a selector.';
+  }
 
+  // Generate placeholder and selectors
   @each $feature in $features {
 
     // Making sure $feature is a string
     @if type-of($feature) != string {
 
-      $everything-okay: false;
-      @warn '`#{$feature} is not a string for `modernizr`';
+      @error '`#{$feature} is not a string for `modernizr`';
 
     } @else {
 
-      // Add feature name to the placeholder string (e.g. '%yep' + '-' + 'translate3d' or '%nope' + '-' + 'translate3d')
-      $placeholder: $placeholder + '-' + $feature;
-
       // Define the new selector string (e.g. `.translate3d` or `.no-translate3d`)
       $new-selector: #{'.' + $prefix + $feature};
 
@@ -65,45 +53,60 @@
     }
   }
 
-  @if $everything-okay == true {
-
-    // 1.2 Define the placholder and print @content
-    // =====================================
-
-    #{$placeholder} & {
-      @content;
-    }
-
-
-    // 1.3 Define feature selector(s) and extend the placeholder
-    // =====================================
+  // Generate selector nesting features classes and the parent selector
+  $selector: selector-nest($selector, &);
 
+  // Define feature selector(s) and print @content
     @at-root #{$selector} {
-      @extend #{$placeholder};
+      @content;
     }
 
-  }
 }
 
-// =============================================================================
-// 2. Aliases
-// =============================================================================
 
-  // 2.1 Yep alias
-  // =====================================
-
-  @mixin yep($features...) {
-    @include modernizr($features, $supports: true) {
-      @content;
-    }
+// -----------------------------------------------------------------------------
+// Yep mixin
+// -----------------------------------------------------------------------------
+
+/**
+* Prints classes for supported features
+* ---
+* @requires modernizr
+* ---
+* @access public
+* ---
+* @param {ArgList} $features   - List of features
+* ---
+* @example scss
+* .my-selector { @include yep(opacity, csstransforms) { // ... } }
+*/
+
+@mixin yep($features...) {
+  @include modernizr(true, $features...) {
+    @content;
   }
+}
 
-
-  // 2.2 Nope alias
-  // =====================================
-
-  @mixin nope($features...) {
-    @include modernizr($features, $supports: false) {
-      @content;
-    }
+// -----------------------------------------------------------------------------
+// Nope mixin
+// -----------------------------------------------------------------------------
+
+/**
+* Nope “alias”
+* Prints classes for unsupported features and lack of JS
+* ---
+* @requires modernizr
+* ---
+* @access public
+* ---
+* @param {ArgList} $features - List of features
+* ---
+* @example scss
+* .my-selector { @include nope(opacity, csstransforms) { // ... } }
+*/
+
+@mixin nope($features...) {
+  @include modernizr(false, $features...) {
+    @content;
   }
+}

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: modernizr-mixin
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Daniel Guillan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-06 00:00:00.000000000 Z
+date: 2014-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sass
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '3.3'
+        version: '3.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '3.3'
+        version: '3.4'
 - !ruby/object:Gem::Dependency
   name: compass
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 1.0.0.alpha
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 1.0.0.alpha
+        version: 1.0.0
 description: A simple way for DRYier, faster and cleaner Modernizr tests in Sass.
 email:
 - daniel.guillan@gmail.com
@@ -58,17 +58,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
 rubyforge_project: modernizr-mixin
-rubygems_version: 2.2.2
+rubygems_version: 2.0.14
 signing_key: 
 specification_version: 4
 summary: Simple and comprehensive mixin for Modernizr tests in Sass