_focus-ring.scss 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142
  1. //
  2. // Copyright 2021 Google Inc.
  3. //
  4. // Permission is hereby granted, free of charge, to any person obtaining a copy
  5. // of this software and associated documentation files (the "Software"), to deal
  6. // in the Software without restriction, including without limitation the rights
  7. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  8. // copies of the Software, and to permit persons to whom the Software is
  9. // furnished to do so, subject to the following conditions:
  10. //
  11. // The above copyright notice and this permission notice shall be included in
  12. // all copies or substantial portions of the Software.
  13. //
  14. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  17. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  19. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  20. // THE SOFTWARE.
  21. //
  22. @use '@material/feature-targeting/feature-targeting';
  23. @use '@material/rtl/rtl';
  24. @use '@material/dom/dom';
  25. $ring-radius-default: 8px !default;
  26. $inner-ring-width-default: 2px !default;
  27. $inner-ring-color-default: transparent !default;
  28. $outer-ring-width-default: 2px !default;
  29. $outer-ring-color-default: transparent !default;
  30. $container-outer-padding-default: 2px !default;
  31. /// Styles applied to the component's inner focus ring element.
  32. ///
  33. /// @param $ring-radius [$ring-radius-default] - Focus ring radius.
  34. /// @param $inner-ring-width [$inner-ring-width-default] - Inner focus ring width.
  35. /// @param $inner-ring-color [$inner-ring-color-default] - Inner focus ring color.
  36. /// @param $outer-ring-width [$outer-ring-width-default] - Outer focus ring width.
  37. /// @param $outer-ring-color [$outer-ring-color-default] - Outer focus ring color.
  38. /// @param $container-outer-padding [$container-outer-padding-default] - The
  39. /// distance between the focus ring and the container.
  40. @mixin focus-ring(
  41. $query: feature-targeting.all(),
  42. $ring-radius: $ring-radius-default,
  43. $inner-ring-width: $inner-ring-width-default,
  44. $inner-ring-color: $inner-ring-color-default,
  45. $outer-ring-width: $outer-ring-width-default,
  46. $outer-ring-color: $outer-ring-color-default,
  47. $container-outer-padding-vertical: $container-outer-padding-default,
  48. $container-outer-padding-horizontal: $container-outer-padding-default
  49. ) {
  50. $feat-structure: feature-targeting.create-target($query, structure);
  51. $container-size-vertical: 100%;
  52. @if $container-outer-padding-vertical != 0 {
  53. $container-size-vertical: calc(
  54. 100% + #{$container-outer-padding-vertical * 2}
  55. );
  56. }
  57. $container-size-horizontal: 100%;
  58. @if $container-outer-padding-horizontal != 0 {
  59. $container-size-horizontal: calc(
  60. 100% + #{$container-outer-padding-horizontal * 2}
  61. );
  62. }
  63. $outer-ring-size: 100%;
  64. @if $outer-ring-width > 0 {
  65. $outer-ring-size: calc(100% + #{$outer-ring-width * 2});
  66. }
  67. @include feature-targeting.targets($feat-structure) {
  68. pointer-events: none;
  69. border: $inner-ring-width solid $inner-ring-color;
  70. border-radius: $ring-radius - $outer-ring-width;
  71. box-sizing: content-box;
  72. position: absolute;
  73. top: 50%;
  74. @include rtl.ignore-next-line();
  75. left: 50%;
  76. @include rtl.ignore-next-line();
  77. transform: translate(-50%, -50%);
  78. height: $container-size-vertical;
  79. width: $container-size-horizontal;
  80. @include dom.forced-colors-mode($exclude-ie11: true) {
  81. border-color: CanvasText;
  82. }
  83. &::after {
  84. content: '';
  85. border: $outer-ring-width solid $outer-ring-color;
  86. border-radius: $ring-radius;
  87. display: block;
  88. position: absolute;
  89. top: 50%;
  90. @include rtl.ignore-next-line();
  91. left: 50%;
  92. @include rtl.ignore-next-line();
  93. transform: translate(-50%, -50%);
  94. height: $outer-ring-size;
  95. width: $outer-ring-size;
  96. @include dom.forced-colors-mode($exclude-ie11: true) {
  97. border-color: CanvasText;
  98. }
  99. }
  100. }
  101. }
  102. /// Customizes the color of the button focus ring.
  103. ///
  104. /// @param $inner-ring-color [$inner-ring-color-default] - Inner focus ring color.
  105. /// @param $outer-ring-width [$outer-ring-width-default] - Outer focus ring width.
  106. @mixin focus-ring-color(
  107. $inner-ring-color: $inner-ring-color-default,
  108. $outer-ring-color: $outer-ring-color-default
  109. ) {
  110. border-color: $inner-ring-color;
  111. &::after {
  112. border-color: $outer-ring-color;
  113. }
  114. }
  115. /// Customizes the border radius of the button focus ring.
  116. ///
  117. /// @param {Number} $ring-radius - The border radius of the focus ring.
  118. /// @param {Number} $outer-ring-width [$outer-ring-width] - Width of the outer
  119. /// ring, required to compute the radius for the inner ring.
  120. @mixin focus-ring-radius(
  121. $ring-radius,
  122. $outer-ring-width: $outer-ring-width-default,
  123. $query: feature-targeting.all()
  124. ) {
  125. $feat-structure: feature-targeting.create-target($query, structure);
  126. @include feature-targeting.targets($feat-structure) {
  127. border-radius: $ring-radius - $outer-ring-width;
  128. &::after {
  129. border-radius: $ring-radius;
  130. }
  131. }
  132. }