annotate default/assets/scss/vendors/bourbon/library/_hide-visually.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 /// Hides an element visually while still allowing the content to be accessible
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4 /// to assistive technology, e.g. screen readers. Passing `unhide` will reverse
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 /// the affects of the hiding, which is handy for showing the element on focus,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6 /// for example.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 /// @link http://goo.gl/Vf1TGn
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
10 /// @argument {string} $toggle [hide]
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
11 /// Accepts `hide` or `unhide`. `unhide` reverses the affects of `hide`.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
12 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
13 /// @example scss
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14 /// .element {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 /// @include hide-visually;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17 /// &:active,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 /// &:focus {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 /// @include hide-visually(unhide);
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 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
23 /// // CSS Output
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24 /// .element {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 /// border: 0;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26 /// clip: rect(1px, 1px, 1px, 1px);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27 /// clip-path: circle(1% at 1% 1%);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28 /// height: 1px;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29 /// overflow: hidden;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30 /// padding: 0;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31 /// position: absolute;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32 /// width: 1px;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33 /// }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34 ///
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35 /// .hide-visually:active,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36 /// .hide-visually:focus {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37 /// clip: auto;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38 /// clip-path: none;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39 /// height: auto;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
40 /// overflow: visible;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
41 /// position: static;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
42 /// width: auto;
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 /// @since 5.0.0
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47 @mixin hide-visually($toggle: hide) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 @if $toggle == "hide" {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
49 border: 0;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
50 clip: rect(1px, 1px, 1px, 1px);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
51 clip-path: circle(1% at 1% 1%);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
52 height: 1px;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
53 overflow: hidden;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
54 padding: 0;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
55 position: absolute;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
56 width: 1px;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
57 } @else if $toggle == "unhide" {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
58 clip: auto;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
59 clip-path: none;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
60 height: auto;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
61 overflow: visible;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
62 position: static;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
63 width: auto;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
64 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
65 }