css-clean-fork v1.6.1

(forked from SeanJM's css-clean. All credits go to them.)

Css Clean 1.5.0

License: MIT

✅ All 24 tests pass

css-clean package

We all write code a little quickly sometimes. This is a package which offers a helping hand to sort, align and clean your CSS and SASS.

Configuration

example settings

cleanCss({
  css : String
  lineBreak : Number, // Optional
  tabSize : 2,  // Optional, default is 2
  tabChar : ' ',  // Optional, default is ' '
})

Sorting properties

Before

.comment-module {
  font-size: 16px;
  color: red;
  position: 'relative';
  z-index: 0;
  font-family: 'sans-serif';
}

After

.comment-module {
  z-index     : 0;
  position    : 'relative';
  color       : red;
  font-family : 'sans-serif';
  font-size   : 16px;
}

Clearly format your @media queries

Before

@media only screen and (min-device-width: 320px) and (device-width: 320px) and (max-device-width: 736px),
       tv and (min-width: 320px) and (device-width: 320px) and (width: 736px) {
  .comment-module {
   font-size: 18px;
  }
}

After

@media only screen
       and (min-device-width : 320px)
       and (device-width     : 320px)
       and (max-device-width : 736px),
       tv
       and (min-width        : 320px)
       and (device-width     : 320px)
       and (width            : 736px) {
  .comment-module {
    font-size : 18px;
  }
}

Sort multiple selector names and automatic placement to one line per selector

Before

input[type="text"], [class*="btn-grey"], input[type="date"], input[type="number"], textarea {
  color : $grey6;
}

After

[class*="btn-grey"],
input[type="date"],
input[type="number"],
input[type="text"],
textarea {
  color : $grey6;
}

SASS

Grouping of variables which are pushed to the top of the file

Before

$box-style2 : (bStyle: dotted, bColor: blue, bWidth: medium);
$i : 6;

@mixin does-parent-exist { @if & { &:hover { color : red; } } @else { a { color : red; } } }

$gutter-width : 10px;

After

$box-style2   : (bStyle: dotted, bColor: blue, bWidth: medium);
$i            : 6;
$gutter-width : 10px;

@mixin does-parent-exist {
  @if & {
    &:hover {
      color : red;
    }
  } @else {
    a {
      color : red;
    }
  }
}

Merging of multiple imports

Before

@import "buttons.scss";
@import "forms.scss";
@import "variables.scss";

After

@import
  "variables.scss",
  "buttons.scss",
  "forms.scss";

Make your @each statements easier to read

Before

@each $animal, $color, $cursor in (puma, black, default), (sea-slug, blue, pointer), (egret, white, move) {
  .#{$animal}-icon {
    background-image : url('/images/#{$animal}.png');
    border : 2px solid $color;
    cursor : $cursor;
  }
}

After

@each $animal,
      $color,
      $cursor in (puma, black, default),
      (sea-slug, blue, pointer),
      (egret, white, move) {
  .#{$animal}-icon {
    border           : 2px solid $color;
    background-image : url('/images/#{$animal}.png');
    cursor           : $cursor;
  }
}

Gradients

Before

  .class {
    background : linear-gradient(rgba(33, 34, 30, 0.1), rgba(33, 34, 30, 0.1));
  }

After

  .class {
    background : linear-gradient(
                   rgba(33, 34, 30, 0.1),
                   rgba(33, 34, 30, 0.1)
                 );
  }

Feel free to contribute.

Tests

   1. Background......................................................... ✅
   2. basic test......................................................... ✅
   3. acid test.......................................................... ✅
   4. Block Comment...................................................... ✅
   5. bug report......................................................... ✅
   6. CSS Grid........................................................... ✅
   7. CSS variables...................................................... ✅
   8. Empty selector..................................................... ✅
   9. SASS Each (basic).................................................. ✅
  10. SASS for........................................................... ✅
  11. SASS function...................................................... ✅
  12. SASS Import (basic)................................................ ✅
  13. SASS @mixin........................................................ ✅
  14. SASS nested (basic)................................................ ✅
  15. SASS Placeholders (basic).......................................... ✅
  16. SASS while......................................................... ✅
  17. Section title...................................................... ✅
  18. Sorted Selectors (basic)........................................... ✅
  19. Special comment.................................................... ✅
  20. test 10............................................................ ✅
  21. Nested multiple selectors.......................................... ✅
  22. SASS Import (nested)............................................... ✅
  23. SASS @mixin (arguments)............................................ ✅
  24. SASS Selector Eval (basic)......................................... ✅