UAS2.0_DEV_TEST/ext/modern/theme-base/sass/etc/mixins/font-icon.scss

/**
 * @class Global_CSS
 */

@import 'font-icon.js';

/**
 * Applies a font icon to an element.
 *
 * @param {list/string} $glyph
 * A unicode character to use as the icon, or a list specifying the character to use
 * followed by font-size, font-family, and degrees of rotation (90, 180, or 270).
 * All parameters in the list are optional except for glyph.  For example, each of the
 * following is valid:
 *
 * Use the letter "A" as the icon, inherit the font-size from the parent element,
 * and use the default font-family specified by {@link Global_CSS#$font-icon-font-family}.
 *
 *     .my-icon {
 *         @include font-icon('\0041');
 *     }
 *
 * Use the letter "A" as the icon with a font-size of 16px, and the default font-family
 *
 *     .my-icon {
 *         @include font-icon('\0041' 16px);
 *     }
 *
 * Use the letter "A" as the icon, inherit font-size, and use FontAwesome as the font-family
 *
 *     .my-icon {
 *         @include font-icon('\0041' FontAwesome);
 *     }
 *
 * Use the letter "A" as the icon, inherit font-size, use the default font-family, and rotate
 * the icon 90 degrees clockwise.
 *
 *     .my-icon {
 *         @include font-icon('\0041' 90);
 *     }
 *
 * Use the letter "A" as the icon with a 16px font-size, and a FontAwesome as the font-family.
 *
 *     .my-icon {
 *         @include font-icon('\0041' 16px FontAwesome);
 *     }
 *
 * Use the letter "A" as the icon with a 16px font-size, default font-family, and rotate
 * the icon 90 degrees clockwise.
 *
 *     .my-icon {
 *         @include font-icon('\0041' 16px 90);
 *     }
 *
 * Use the letter "A" as the icon, inherit the font-size, use FontAwesome as the font-family,
 * and rotate the icon 90 degrees clockwise.
 *
 *     .my-icon {
 *         @include font-icon('\0041' FontAwesome 90);
 *     }
 *
 * Use the letter "A" as the icon with a font-size of 16px, use FontAwesome as the font-family,
 * and rotate the icon 90 degrees clockwise.
 *
 *     .my-icon {
 *         @include font-icon('\0041' 16px FontAwesome 90);
 *     }
 *
 * NOTE: Only numeric values with units are accepted for font-size, e.g. `16px` or `2em`.
 *
 * @param {boolean/string} [$pseudo=true]
 * By default this mixin generates a "before" pseudo element ruleset to contain the icon.
 * Set this parameter to "after" to use an after pseudo element.  Set to `false` if you are
 * invoking the font-icon() mixin from within a pseudo element ruleset.
 *
 * @param {number} [$line-height=1]
 * Optional line-height to apply to the icon.
 * Pass `null` to avoid setting line-height and inherit from parent element.
 *
 * @param {color} $color
 * Optional color for the glyph.
 *
 * @param {boolean} [$style-pseudo=false]
 * By default, font and color styles are placed on the icon-containing element, not the
 * pseudo.  This allows for easier customization of font-icons by users since many
 * font-icon generators also place the font styles on the containing element.
 * Set this to `true` to set font and color styles on the pseudo element instead.  This
 * is necessary in cases where the icon-containing element is not exclusively dedicated
 * to containing the icon and may contain other text as well, for example, grid headers
 * and grid grouping headers.
 *
 * @private
 * @deprecated 6.5.0 This mixin is deprecated.
 */
@mixin font-icon(
    $glyph,
    $pseudo: true,
    $line-height: 1,
    $color: null,
    $style-pseudo: false
) {
    $args: parseFontIconArgs($glyph);

    $char: nth($args, 1);
    $font-size: nth($args, 2);
    $font-family: nth($args, 3);
    @if $font-family == null {
        $font-family: $font-icon-font-family;
    }
    $angle: nth($args, 4);
    $rotation: null;
    $rotation-origin: 50% 50%;
    $ie-rotation: null;

    @if $angle != null {
        $rotation: rotate(#{$angle}deg);
        @if $angle == 90 {
            $ie-rotation: 1;
        } @else if $angle == 180 {
            $ie-rotation: 2;
        } @else if $angle == 270 {
            $ie-rotation: 3;
        }
    }

    @if $char != null {
        @if $pseudo == false {
            @include font-icon-pseudo-content($char, $rotation, $rotation-origin);
            @include font-icon-style($font-size, $line-height, $font-family, $color);
        } @else {
            @if not $style-pseudo {
                @include font-icon-style($font-size, $line-height, $font-family, $color);
            }

            @if $pseudo == before or $pseudo == true {
                &:before {
                    @include font-icon-pseudo-content($char, $rotation, $rotation-origin);
                    @if $style-pseudo {
                        @include font-icon-style($font-size, $line-height, $font-family, $color);
                    }
                }
            } @else if $pseudo == after {
                &:after {
                    @include font-icon-pseudo-content($char, $rotation, $rotation-origin);
                    @if $style-pseudo {
                        @include font-icon-style($font-size, $line-height, $font-family, $color);
                    }
                }
            }
        }
    }
}

@mixin font-icon-style($font-size, $line-height, $font-family, $color) {
    @if $font-size != null {
        @if $line-height != null {
            font: #{$font-size}/#{$line-height} $font-family;
        } @else {
            // use separate properties for font-size and font-family so that line-height
            // will be preserved from prior font declarations
            font-size: $font-size;
            font-family: $font-family;
        }
    } @else {
        font-family: $font-family;
        line-height: $line-height;
    }
    color: $color;
}

@mixin font-icon-pseudo-content($char, $rotation, $rotation-origin) {
    content: $char;
    font-feature-settings: 'liga';

    @if $rotation != null {
        display: inline-block;
        -webkit-transform: $rotation;
        -webkit-transform-origin: $rotation-origin;
        transform: $rotation;
        transform-origin: $rotation-origin;
    }
}