annotate default/assets/scss/vendors/bourbon/library/_size.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 /// Sets the `width` and `height` of the element in one statement.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 /// @argument {number (with unit) | string} $width
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7 /// @argument {number (with unit) | string} $height [$width]
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9 /// @example scss
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
10 /// .first-element {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
11 /// @include size(2em);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
12 /// }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
13 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14 /// // CSS Output
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 /// .first-element {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 /// width: 2em;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17 /// height: 2em;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 /// }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 /// @example scss
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
21 /// .second-element {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
22 /// @include size(auto, 10em);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
23 /// }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 /// // CSS Output
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26 /// .second-element {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27 /// width: auto;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28 /// height: 10em;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29 /// }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31 /// @require {function} _is-size
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33 @mixin size(
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34 $width,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35 $height: $width
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38 @if _is-size($height) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39 height: $height;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
40 } @else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
41 @error "`#{$height}` is not a valid length for the `$height` argument " +
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
42 "in the `size` mixin.";
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
43 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
44
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
45 @if _is-size($width) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46 width: $width;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47 } @else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 @error "`#{$width}` is not a valid length for the `$width` argument " +
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
49 "in the `size` mixin.";
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
50 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
51 }