Skip to content

Latest commit

 

History

History
126 lines (91 loc) · 3.9 KB

sass.md

File metadata and controls

126 lines (91 loc) · 3.9 KB
Raw

Sass

This project uses Sass for creating all styles. I like Sass a lot. Imports, nesting, mixins and extends are all fundamental concepts that I really enjoy having. I do like Stylus as well, but the syntax is incompatible with the way I want to write CSS so it's a non starter.

Okay, how's it work?

site.scss serves as your master record of imports. First it imports globals...

  1. Eric Meyer's Reset CSS
  2. Some generic variables
  3. Some generic mixins
  4. Some generic extends

... then it imports your site specific stuff from the partials folder. If you want to add css libraries as well (Dan Eden's animate.css provided here as an example), do that as well.

Everything will then compile into css/site.css

I'll explain some of the global mixins and extends here....

Mixins

Here's some mixins you can use all over the place in your Sass. Fields with a default are marked with a colon (ex: $align:stretch). Fields without a colon have no default value.

@include flex-container($direction:row, $align:stretch, $wrap:wrap)

This will create a container element with display:flex and the default values you want in most flex containers. If you want to change the align-items property, do that with the $align variable.

example:

@include flex-container();

@include flex-item($basis, $grow:1, $shrink:1, $alignSelf:auto);

Meant to be used on any children of flex-container(). If you allow the item to grow, it will, where convenient. If not, it has an explicit width.

example:

@include flex-item(25%,0,1);
// 25% width, but not bigger. However, smaller is okay.

@include flex-center();

Needs no variables. Creates a flex-container() which will vertically and horizontally center its children.

example:

@include flex-center();

@include position($type, $top:null, $right:null, $bottom:null, $left:null)

This one I use constantly, just to define a shorthand to typing five different attributes. If left null, each direction will stay undefined.

example:

@include position(absolute,0,null,null,0);
// absolute box at the top left, right and bottom are undefined.

inner($width:$max-width,$padding:20px)

I usee this as an easy way to define a centered internal column that will shrink on lower resolutions (for example, a box that's 1200 pixels wide, and centered on the screen, but if your browser is smaller than that, it will be 100% of the screen with padding on the side). This doesn't need arguments. If no arguments are given, this will assume whatever is defined as $max-width in your project, and 20 pixels on the left and right side.

example:

@include inner();

respond-to($media)

Accepts either desktop or mobile as values. Any code put inside will be media queried using your site's $mobile-max and $desktop-min values.

example:

@respond-to(desktop) {
  .mobile-menu   {  display:none;  }
  .desktop-menu  {  display:block; }
}

Extends

Not quite as many of them, but still stuff I use all the time.

%clearfix

Got a float:left; or a float:right element? Then you'll want this on the container.

.container { @extend %clearfix;
  .floating-thing { float:left; }
}

... this will prevent your floating thing from screwing up your box.

%truncate

This will tell your element not to wrap, and any text that runs too long will be cut of with an ellipsis.

@extend %truncate;

%commalist

This will turn your ol or ul into a comma separated list (with the word "and" and without an oxford comma). So markup like...

<ul>
  <li>one</li>
  <li>two</li>
  <li>three</li>
  <li>four</li>
</ul>

will look like....

one, two, three and four

@extend %commalist;