annotate default/assets/scss/vendors/bourbon/library/_shade.scss @ 0:1d038bc9b3d2 default tip

Up:default
author Liny <dev@neowd.com>
date Sat, 31 May 2025 09:21:51 +0800
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
1 @charset "UTF-8";
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
2
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
3 /// Mixes a color with black.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 /// @argument {color} $color
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7 /// @argument {number (percentage)} $percent
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 /// The amount of black to be mixed in.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
10 /// @return {color}
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
11 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
12 /// @example scss
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
13 /// .element {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14 /// background-color: shade(#ffbb52, 60%);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 /// }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17 /// // CSS Output
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 /// .element {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 /// background-color: #664a20;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 /// }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
21
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
22 @function shade(
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
23 $color,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24 $percent
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27 @if not _is-color($color) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28 @error "`#{$color}` is not a valid color for the `$color` argument in " +
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29 "the `shade` mixin.";
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30 } @else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31 @return mix(#000, $color, $percent);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33 }