_position.scss

// Foundation for Sites
// https://get.foundation
// Licensed under MIT Open Source

////
/// @group grid
////

@use "sass:math";

/// Reposition a column.
///
/// @param {Number|Keyword} $position - It can be:
///   * A number: The column will move equal to the width of the column count
///     specified. A positive number will push the column to the right, while
///     a negative number will pull it to the left.
///   * `center`: Column will be centered
///   * `auto`: Column will be pushed to the left (or to the right for the last column).
@mixin grid-column-position($position) {
  // Auto positioning
  @if $position == auto {
    &, &:last-child:not(:first-child) {
      float: $global-left;
      clear: none;
    }

    // Last column alignment
    @if $grid-column-align-edge {
      &:last-child:not(:first-child) {
        float: $global-right;
      }
    }
  }

  // Push/pull
  @else if type-of($position) == 'number' {
    $offset: math.percentage(divide($position, $grid-column-count));

    position: relative;
    #{$global-left}: $offset;
  }

  // Center positioning
  @else if $position == center {
    margin-left: auto;
    margin-right: auto;
    &, &:last-child:not(:first-child) {
      float: none;
      clear: both;
    }
  }

  @else {
    @warn 'Wrong syntax for grid-column-position(). Enter a positive or negative number, "center" or "auto".';
  }
}

/// Reset a position definition.
@mixin grid-column-unposition {
  position: static;
  margin-right: 0;
  margin-left: 0;
  @include grid-column-position(auto);
}

/// Offsets a column to the right by `$n` columns.
/// @param {Number|List} $n - Width to offset by. You can pass in any value accepted by the `grid-column()` mixin, such as `6`, `50%`, or `1 of 2`.
@mixin grid-column-offset($n) {
  margin-#{$global-left}: grid-column($n);
}

/// Disable the default behavior of the last column in a row aligning to the opposite edge.
@mixin grid-column-end {
  // This extra specificity is required for the property to be applied
  &:last-child:last-child {
    float: $global-left;
  }
}

/// Shorthand for `grid-column-position()`.
/// @alias grid-column-position
@mixin grid-col-pos($position) {
  @include grid-column-position($position);
}

/// Shorthand for `grid-column-unposition()`.
/// @alias grid-column-unposition
@mixin grid-col-unpos {
  @include grid-column-unposition;
}

/// Shorthand for `grid-column-offset()`.
/// @alias grid-column-offset
@mixin grid-col-off($n) {
  @include grid-column-offset($n);
}

/// Shorthand for `grid-column-end()`.
/// @alias grid-column-end
@mixin grid-col-end {
  @include grid-column-end;
}