assets/sass/bourbon/bourbon/library/_margin.scss

   1 @charset "UTF-8";
   2
   3 /// Provides a concise, one-line method for setting `margin` on specific edges
   4 /// of a box. Use a `null` value to “skip” edges of the box with standard
   5 /// CSS shorthand.
   6 ///
   7 /// @argument {list} $values
   8 ///   List of margin values; accepts CSS shorthand.
   9 ///
  10 /// @example scss
  11 ///   .element {
  12 ///     @include margin(null auto);
  13 ///   }
  14 ///
  15 ///   // CSS Output
  16 ///   .element {
  17 ///     margin-left: auto;
  18 ///     margin-right: auto;
  19 ///   }
  20 ///
  21 /// @example scss
  22 ///   .element {
  23 ///     @include margin(10px 3em 20vh null);
  24 ///   }
  25 ///
  26 ///   // CSS Output
  27 ///   .element {
  28 ///     margin-bottom: 20vh;
  29 ///     margin-right: 3em;
  30 ///     margin-top: 10px;
  31 ///   }
  32 ///
  33 /// @require {mixin} _directional-property
  34
  35 @mixin margin($values) {
  36   @include _directional-property(margin, null, $values);
  37 }