跳到主要内容
输入关键词开始搜索,↑ ↓ 选择,Enter 打开
没有找到匹配的文档

圆角

使用圆角工具控制元素的边框半径。

类名样式
.rounded-0--bs-rounded-size: 0;
border-radius: var(--bs-rounded-size);
.圆角-1--bs-rounded-size: 0.125rem;
border-radius: var(--bs-rounded-size);
.圆角-2--bs-rounded-size: 0.1875rem;
border-radius: var(--bs-rounded-size);
.rounded-3--bs-rounded-size: 0.25rem;
border-radius: var(--bs-rounded-size);
.rounded-4--bs-rounded-size: 0.375rem;
border-radius: var(--bs-rounded-size);
.rounded-5--bs-rounded-size: 0.5rem;
border-radius: var(--bs-rounded-size);
.rounded-6--bs-rounded-size: 0.625rem;
border-radius: var(--bs-rounded-size);
.rounded-7--bs-rounded-size: 0.75rem;
border-radius: var(--bs-rounded-size);
.圆角-8--bs-rounded-size: 0.875rem;
border-radius: var(--bs-rounded-size);
.rounded-9--bs-rounded-size: 1rem;
border-radius: var(--bs-rounded-size);
.圆角--bs-rounded-size: 0.5rem;
border-radius: var(--bs-rounded-size);
.圆形--bs-rounded-size: 50%;
border-radius: var(--bs-rounded-size);
.圆形-pill--bs-rounded-size: var(--bs-radius-pill);
border-radius: var(--bs-rounded-size);
.圆角-顶部-0border-start-start-radius: 0;
border-start-end-radius: 0;
.圆角顶部-1border-start-start-radius: 0.125rem;
border-start-end-radius: 0.125rem;
.圆角顶部-2border-start-start-radius: 0.1875rem;
border-start-end-radius: 0.1875rem;
.圆角顶部-3border-start-start-radius: 0.25rem;
border-start-end-radius: 0.25rem;
.圆角顶部-4border-start-start-radius: 0.375rem;
border-start-end-radius: 0.375rem;
.圆角顶部-5border-start-start-radius: 0.5rem;
border-start-end-radius: 0.5rem;
.圆角顶部-6border-start-start-radius: 0.625rem;
border-start-end-radius: 0.625rem;
.圆角顶部-7border-start-start-radius: 0.75rem;
border-start-end-radius: 0.75rem;
.圆角顶部-8border-start-start-radius: 0.875rem;
border-start-end-radius: 0.875rem;
.圆角顶部-9border-start-start-radius: 1rem;
border-start-end-radius: 1rem;
.圆角顶部border-start-start-radius: var(--bs-rounded-size, var(--bs-radius-5));
border-start-end-radius: var(--bs-rounded-size, var(--bs-radius-5));
.圆形顶部border-start-start-radius: 50%;
border-start-end-radius: 50%;
.圆角顶部药丸border-start-start-radius: var(--bs-radius-pill);
border-start-end-radius: var(--bs-radius-pill);
.圆角-末端-0border-start-end-radius: 0;
border-end-end-radius: 0;
.圆角-结束-1border-start-end-radius: 0.125rem;
border-end-end-radius: 0.125rem;
.圆角-末端-2border-start-end-radius: 0.1875rem;
border-end-end-radius: 0.1875rem;
.圆角-末端-3border-start-end-radius: 0.25rem;
border-end-end-radius: 0.25rem;
.圆角-末端-4border-start-end-radius: 0.375rem;
border-end-end-radius: 0.375rem;
.圆角末端-5border-start-end-radius: 0.5rem;
border-end-end-radius: 0.5rem;
.圆角-6border-start-end-radius: 0.625rem;
border-end-end-radius: 0.625rem;
.圆角-7border-start-end-radius: 0.75rem;
border-end-end-radius: 0.75rem;
.圆角-8border-start-end-radius: 0.875rem;
border-end-end-radius: 0.875rem;
.圆角-9border-start-end-radius: 1rem;
border-end-end-radius: 1rem;
.圆角末端border-start-end-radius: var(--bs-rounded-size, var(--bs-radius-5));
border-end-end-radius: var(--bs-rounded-size, var(--bs-radius-5));
.圆形结束border-start-end-radius: 50%;
border-end-end-radius: 50%;
.圆形结束药丸border-start-end-radius: var(--bs-radius-pill);
border-end-end-radius: var(--bs-radius-pill);
.圆角底部-0border-end-start-radius: 0;
border-end-end-radius: 0;
.圆角底部-1border-end-start-radius: 0.125rem;
border-end-end-radius: 0.125rem;
.圆角底部-2border-end-start-radius: 0.1875rem;
border-end-end-radius: 0.1875rem;
.圆角底部-3border-end-start-radius: 0.25rem;
border-end-end-radius: 0.25rem;
.圆角底部-4border-end-start-radius: 0.375rem;
border-end-end-radius: 0.375rem;
.圆角底部-5border-end-start-radius: 0.5rem;
border-end-end-radius: 0.5rem;
.圆角底部-6border-end-start-radius: 0.625rem;
border-end-end-radius: 0.625rem;
.圆角底部-7border-end-start-radius: 0.75rem;
border-end-end-radius: 0.75rem;
.圆角底部-8border-end-start-radius: 0.875rem;
border-end-end-radius: 0.875rem;
.圆角底部-9border-end-start-radius: 1rem;
border-end-end-radius: 1rem;
.圆角底部border-end-start-radius: var(--bs-rounded-size, var(--bs-radius-5));
border-end-end-radius: var(--bs-rounded-size, var(--bs-radius-5));
.圆形底部border-end-start-radius: 50%;
border-end-end-radius: 50%;
.圆形底部药丸border-end-start-radius: var(--bs-radius-pill);
border-end-end-radius: var(--bs-radius-pill);
.rounded-start-0border-start-start-radius: 0;
border-end-start-radius: 0;
.rounded-start-1border-start-start-radius: 0.125rem;
border-end-start-radius: 0.125rem;
.rounded-start-2border-start-start-radius: 0.1875rem;
border-end-start-radius: 0.1875rem;
.rounded-start-3border-start-start-radius: 0.25rem;
border-end-start-radius: 0.25rem;
.圆角起始-4border-start-start-radius: 0.375rem;
border-end-start-radius: 0.375rem;
.rounded-start-5border-start-start-radius: 0.5rem;
border-end-start-radius: 0.5rem;
.rounded-start-6border-start-start-radius: 0.625rem;
border-end-start-radius: 0.625rem;
.rounded-start-7border-start-start-radius: 0.75rem;
border-end-start-radius: 0.75rem;
.rounded-start-8border-start-start-radius: 0.875rem;
border-end-start-radius: 0.875rem;
.rounded-start-9border-start-start-radius: 1rem;
border-end-start-radius: 1rem;
.rounded-startborder-start-start-radius: var(--bs-rounded-size, var(--bs-radius-5));
border-end-start-radius: var(--bs-rounded-size, var(--bs-radius-5));
.圆形起始border-start-start-radius: 50%;
border-end-start-radius: 50%;
.圆角起始胶囊border-start-start-radius: var(--bs-radius-pill);
border-end-start-radius: var(--bs-radius-pill);

半径

向元素添加类以轻松圆角其边角。

Example rounded image75x75 Example top rounded image75x75 Example right rounded image75x75 Example bottom rounded image75x75 Example left rounded image75x75
HTML
<img src="..." class="rounded" alt="...">
<img src="..." class="rounded-top" alt="...">
<img src="..." class="rounded-end" alt="...">
<img src="..." class="rounded-bottom" alt="...">
<img src="..." class="rounded-start" alt="...">

尺寸

使用缩放类来获得更大或更小的圆角。数值大小范围从 0 到 9。也可以使用 circle 和 pill 的值。修改工具 API 可以更改这些值。

Example non-rounded image75x75 Example small rounded image75x75 Example default rounded image75x75 Example large rounded image75x75 Example larger rounded image75x75 Example extra large rounded image75x75 Example rounded image, size 675x75 Example rounded image, size 775x75 Example rounded image, size 875x75 Example rounded image, size 975x75 Completely round image75x75 Rounded pill image150x75
HTML
<img src="..." class="rounded-0" alt="...">
<img src="..." class="rounded-1" alt="...">
<img src="..." class="rounded-2" alt="...">
<img src="..." class="rounded-3" alt="...">
<img src="..." class="rounded-4" alt="...">
<img src="..." class="rounded-5" alt="...">
<img src="..." class="rounded-6" alt="...">
<img src="..." class="rounded-7" alt="...">
<img src="..." class="rounded-8" alt="...">
<img src="..." class="rounded-9" alt="...">
<img src="..." class="rounded-circle" alt="...">
<img src="..." class="rounded-pill" alt="...">
Example small rounded image75x75 Example default left rounded image75x75 Example right completely round image75x75 Example left rounded pill image75x75 Example extra large bottom rounded image75x75
HTML
<img src="..." class="rounded-bottom-1" alt="...">
<img src="..." class="rounded-start-2" alt="...">
<img src="..." class="rounded-end-circle" alt="...">
<img src="..." class="rounded-start-pill" alt="...">
<img src="..." class="rounded-5 rounded-top-0" alt="...">

混合

使用 .rounded-size-{n} 来设置半径大小,而不对所有角进行圆角处理。将其与类似 .rounded-top 或 .rounded-end 的边类结合使用,可以仅按该大小对特定边进行圆角处理。由于这些使用 CSS 变量来设置大小,可能需要对嵌套元素应用额外的类以防止继承。

Top corners only, size 675x75 Top and end corners, size 675x75 Top and bottom, size 375x75 Top corners only, pill75x75
HTML
<img src="..." class="rounded-size-6 rounded-top" alt="...">
<img src="..." class="rounded-size-6 rounded-top rounded-end" alt="...">
<img src="..." class="rounded-size-3 rounded-top rounded-bottom" alt="...">
<img src="..." class="rounded-size-pill rounded-top" alt="...">

当 .rounded-{n} 与一个侧类一起使用时,该数字设置侧类继承的 --rounded-size 变量。

All corners size 6, bottom corners removed75x75 All corners size 3, top corners stay size 3 via --rounded-size75x75
HTML
<img src="..." class="rounded-6 rounded-bottom-0" alt="...">
<img src="..." class="rounded-3 rounded-top" alt="...">

CSS

变量

半径令牌是从 $radii 地图在 scss/_config.scss 中生成,并作为 --radius-* 自定义属性在 scss/_root.scss 中发出。了解如何使用根令牌。

@each $key, $value in $radii {
  $root-tokens: map.set($root-tokens, --radius-#{$key}, $value);
}
// stylelint-disable-next-line scss/dollar-variable-default
$root-tokens: map.set($root-tokens, --radius-pill, 50rem);

--rounded-size 本地 CSS 变量由 .rounded-{n} 和 .rounded-size-{n} 设置,并由辅助工具(.rounded-top、.rounded-end、.rounded-bottom、.rounded-start)作为它们的默认半径使用。你也可以在自己的 CSS 中直接设置它,或者通过内联样式从一个点控制这些辅助工具。

Sass map

$radius: .5rem;
$radii: ();
// stylelint-disable-next-line scss/dollar-variable-default
$radii: defaults(
  (
    0: 0,
    1: $radius * .25,
    2: $radius * .375,
    3: $radius * .5,
    4: $radius * .75,
    5: $radius,
    6: $radius * 1.25,
    7: $radius * 1.5,
    8: $radius * 1.75,
    9: $radius * 2,
  ),
  $radii
);

Sass 混入

@mixin border-radius($radius: var(--radius-5), $fallback-border-radius: false) {
  @if $enable-rounded {
    border-radius: valid-radius($radius);
  }
  @else if $fallback-border-radius != false {
    border-radius: $fallback-border-radius;
  }
}

@mixin border-top-radius($radius: var(--radius-5)) {
  @if $enable-rounded {
    border-start-start-radius: valid-radius($radius);
    border-start-end-radius: valid-radius($radius);
  }
}

@mixin border-end-radius($radius: var(--radius-5)) {
  @if $enable-rounded {
    border-start-end-radius: valid-radius($radius);
    border-end-end-radius: valid-radius($radius);
  }
}

@mixin border-bottom-radius($radius: var(--radius-5)) {
  @if $enable-rounded {
    border-end-start-radius: valid-radius($radius);
    border-end-end-radius: valid-radius($radius);
  }
}

@mixin border-start-radius($radius: var(--radius-5)) {
  @if $enable-rounded {
    border-start-start-radius: valid-radius($radius);
    border-end-start-radius: valid-radius($radius);
  }
}

@mixin border-top-start-radius($radius: var(--radius-5)) {
  @if $enable-rounded {
    border-start-start-radius: valid-radius($radius);
  }
}

@mixin border-top-end-radius($radius: var(--radius-5)) {
  @if $enable-rounded {
    border-start-end-radius: valid-radius($radius);
  }
}

@mixin border-bottom-end-radius($radius: var(--radius-5)) {
  @if $enable-rounded {
    border-end-end-radius: valid-radius($radius);
  }
}

@mixin border-bottom-start-radius($radius: var(--radius-5)) {
  @if $enable-rounded {
    border-end-start-radius: valid-radius($radius);
  }
}

Sass 工具 API

边界工具类在我们的工具类 API scss/_utilities.scss 中声明。了解如何使用工具类 API。

"border-radius": (
  property: (
    "--rounded-size": null,
    "border-radius": var(--rounded-size)
  ),
  class: rounded,
  values: map.merge(
    $radii,
    (
      null: map.get($radii, 5),
      circle: 50%,
      pill: var(--radius-pill)
    )
  )
),
"rounded-size": (
  property: --rounded-size,
  class: rounded-size,
  values: map.merge(
    $radii,
    (
      null: map.get($radii, 5),
      circle: 50%,
      pill: var(--radius-pill)
    )
  )
),
"rounded-top": (
  property: border-start-start-radius border-start-end-radius,
  class: rounded-top,
  values: map.merge(
    $radii,
    (
      null: var(--rounded-size, var(--radius-5)),
      circle: 50%,
      pill: var(--radius-pill)
    )
  )
),
"rounded-end": (
  property: border-start-end-radius border-end-end-radius,
  class: rounded-end,
  values: map.merge(
    $radii,
    (
      null: var(--rounded-size, var(--radius-5)),
      circle: 50%,
      pill: var(--radius-pill)
    )
  )
),
"rounded-bottom": (
  property: border-end-start-radius border-end-end-radius,
  class: rounded-bottom,
  values: map.merge(
    $radii,
    (
      null: var(--rounded-size, var(--radius-5)),
      circle: 50%,
      pill: var(--radius-pill)
    )
  )
),
"rounded-start": (
  property: border-start-start-radius border-end-start-radius,
  class: rounded-start,
  values: map.merge(
    $radii,
    (
      null: var(--rounded-size, var(--radius-5)),
      circle: 50%,
      pill: var(--radius-pill)
    )
  )
),