gerillass 1.1.3 → 1.2.3

package/CHANGELOG.md

@@ -1,17 +1,64 @@
 # Changelog
 _Change is the essence._
 
+## 1.2.3
+
+### Added
+
+- Added `__isTime` function to validate the time values.
+
+### Updated
+
+- Loadify mixin has been refactored.
+
+## 1.2.2
+
+### Changed
+
+- Improved Loadify mixin. The `init` argument is now available to initialize the mixin at the root level of stylesheet.
+
+### Removed
+
+- Removed `.travis.yml` file. Travis CI integration no longer available.
+
+## 1.2.1
+
+### Added
+
+- The `extend` directive has been added to use Loadify mixin for multiple selectors.
+
+## 1.2.0
+
+### Added
+
+- Added Loadify: A new mixin to help page elements render more natural during the time of page loads.
+
 ## 1.1.3
-* Add box-sizing property to Columnizer mixin.
+
+### Added
+
+- Added box-sizing property to Columnizer mixin.
 
 ## 1.1.2
-* Uptade for security vulnerabilities.
+
+### Updated
+
+- Uptade for security vulnerabilities.
 
 ## 1.1.1
-* Bugfix for a comment.
+
+### Fixed
+
+- Bugfix for a comment.
 
 ## 1.1.0
-* Remove all the `gls-` prefixes from the mixin files under the `library` folder and make prefix usage optional (`gls-` prefix still can ben use).
+
+### Removed
+
+- Remove all the `gls-` prefixes from the mixin files under the `library` folder and make prefix usage optional (`gls-` prefix still can ben use).
 
 ## 0.0.1
-* Changelog created!
+
+### Added
+
+- Changelog created!

package/package.json

@@ -6,7 +6,7 @@
   "author": "Halil İbrahim Çakıroğlu",
   "main": "scss/_gerillass.scss",
   "license": "Apache-2.0",
-  "version": "1.1.3",
+  "version": "1.2.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/selfishprimate/gerillass"

package/scss/_gerillass-prefix.scss

@@ -797,6 +797,47 @@
 
 
 
+@mixin gls-loadify($params...) {
+  @if not & {
+    @if length($params) == 0 or (length($params) == 1 and nth($params, 1) == "init") {
+      @keyframes loadify {
+        to {
+          opacity: 1;
+          visibility: visible;
+          backface-visibility: visible;
+        }
+      }
+      .loadify-static-rules {
+        opacity: 0;
+        visibility: hidden;
+        backface-visibility: hidden;
+        animation-name: loadify;
+        animation-fill-mode: forwards;
+      }
+    } @else if (length($params) == 1 and nth($params, 1) != "init") or (length($params) == 1 and type-of(nth($params, 1)) != "string") {
+      @error "#{nth($params, 1)} is not a valid argument. Please pass `init` as an argument to initialize the effect or do not pass any argument at all.";
+    } @else if length($params) > 1 {
+      @error "Only one argument is allowed when you call this mixin at the root of your stylesheet! Please pass `init` as an argument to initialize the effect or do not pass any argument at all.";
+    }
+  } @else if & {
+    @extend .loadify-static-rules;
+    @if length($params) == 0 {
+      animation-delay: 0.2s;
+      animation-duration: 0.5s;
+    } @else if length($params) == 1 {
+      animation-delay: #{__isTime(nth($params, 1))};
+      animation-duration: 0.5s;
+    } @else if length($params) == 2 {
+      animation-delay: #{__isTime(nth($params, 1))};
+      animation-duration: #{__isTime(nth($params, 2))};
+    } @else if length($params) > 2 {
+      @error "You cannot pass more than two arguments.";
+    }
+  }
+}
+
+
+
 @mixin gls-only($params...) {
   @if length($params) == 0 {
     @error "Please pass an argument. The argument must be either a negative or positive number or list of numbers. Or pass one of the following predefined string values: 'first', 'last', 'odd', 'even'.";

package/scss/_gerillass.scss

@@ -27,6 +27,7 @@
 @import "utilities/font-source";
 @import "utilities/is-color";
 @import "utilities/is-number";
+@import "utilities/is-time";
 @import "utilities/lighten";
 @import "utilities/map-deep-get";
 @import "utilities/null";
@@ -63,6 +64,7 @@
 @import "library/font-face";
 @import "library/hide";
 @import "library/linear-gradient";
+@import "library/loadify";
 @import "library/only";
 @import "library/placeholder-shown";
 @import "library/placeholder";

package/scss/library/_loadify.scss

@@ -0,0 +1,40 @@
+@charset "UTF-8";
+
+@mixin loadify($params...) {
+  @if not & {
+    @if length($params) == 0 or (length($params) == 1 and nth($params, 1) == "init") {
+      @keyframes loadify {
+        to {
+          opacity: 1;
+          visibility: visible;
+          backface-visibility: visible;
+        }
+      }
+      .loadify-static-rules {
+        opacity: 0;
+        visibility: hidden;
+        backface-visibility: hidden;
+        animation-name: loadify;
+        animation-fill-mode: forwards;
+      }
+    } @else if (length($params) == 1 and nth($params, 1) != "init") or (length($params) == 1 and type-of(nth($params, 1)) != "string") {
+      @error "#{nth($params, 1)} is not a valid argument. Please pass `init` as an argument to initialize the effect or do not pass any argument at all.";
+    } @else if length($params) > 1 {
+      @error "Only one argument is allowed when you call this mixin at the root of your stylesheet! Please pass `init` as an argument to initialize the effect or do not pass any argument at all.";
+    }
+  } @else if & {
+    @extend .loadify-static-rules;
+    @if length($params) == 0 {
+      animation-delay: 0.2s;
+      animation-duration: 0.5s;
+    } @else if length($params) == 1 {
+      animation-delay: #{__isTime(nth($params, 1))};
+      animation-duration: 0.5s;
+    } @else if length($params) == 2 {
+      animation-delay: #{__isTime(nth($params, 1))};
+      animation-duration: #{__isTime(nth($params, 2))};
+    } @else if length($params) > 2 {
+      @error "You cannot pass more than two arguments.";
+    }
+  }
+}

package/scss/utilities/_is-time.scss

@@ -0,0 +1,9 @@
+@function __isTime($value) {
+  @for $i from 1 through length($value) {
+    @if (type-of($value) == "number" and index("ms" "s", unit($value)) != null) or $value == 0 {
+      @return $value;
+    } @else {
+      @error "'#{$value}' is not a valid time value. Time values must be specified in either seconds (s) or milliseconds (ms). Please try one of the following forms: '1s', '0.2s', or '3ms'";
+    }
+  }
+}