내용으로 건너뛰기 문서 내비게이션으로 건너뛰기
// Close button

모달이나 경고창 등의 콘텐츠를 닫기 위한 범용적인 닫기 버튼입니다.

예시

.btn-close를 사용해 컴포넌트를 닫는 옵션을 제공합니다. 기본 스타일은 제한되어 있지만, 재정의가 가능합니다. Sass 변수를 변경해, 기본 background-image를 바꿉니다. aria-label과 같은 스크린 리더용의 텍스트를 꼭 넣어 주십시오.

html
<button type="button" class="btn-close" aria-label="Close"></button>

비활성화 상태

비활성화된 닫기 버튼은 opacity를 변경합니다. 그리고 pointer-events: noneuser-select: none을 적용해, hover 상태와 active 상태가 트리거 되지 않도록 하였습니다.

html
<button type="button" class="btn-close" disabled aria-label="Close"></button>

Dark variant

v5.3.0부터 지원 중단
주의! v5.3.0부터 .btn-close-white 클래스는 더 이상 사용되지 않습니다. 대신 data-bs-theme="dark"를 사용하여 닫기 버튼의 색상 모드를 변경하세요.

.btn-close 또는 그 상위 요소에 data-bs-theme="dark"를 추가하여 닫기 버튼을 반전시킬 수 있습니다. 이렇게 하면 filter 속성을 사용하여 값을 재정의하지 않고 background-image를 반전시킵니다.

html
<div data-bs-theme="dark">
  <button type="button" class="btn-close" aria-label="Close"></button>
  <button type="button" class="btn-close" disabled aria-label="Close"></button>
</div>

CSS

변수

v5.3.0에서 추가됨

Bootstrap의 진화하는 CSS 변수 접근 방식의 일환으로, 이제 닫기 버튼은 .btn-close의 로컬 CSS 변수를 사용하여 실시간 사용자 정의 기능을 강화합니다. CSS 변수의 값은 Sass를 통해 설정되므로 Sass 사용자 정의도 계속 지원됩니다.

--#{$prefix}btn-close-color: #{$btn-close-color};
--#{$prefix}btn-close-bg: #{ escape-svg($btn-close-bg) };
--#{$prefix}btn-close-opacity: #{$btn-close-opacity};
--#{$prefix}btn-close-hover-opacity: #{$btn-close-hover-opacity};
--#{$prefix}btn-close-focus-shadow: #{$btn-close-focus-shadow};
--#{$prefix}btn-close-focus-opacity: #{$btn-close-focus-opacity};
--#{$prefix}btn-close-disabled-opacity: #{$btn-close-disabled-opacity};
--#{$prefix}btn-close-white-filter: #{$btn-close-white-filter};

Sass 변수

$btn-close-width:            1em;
$btn-close-height:           $btn-close-width;
$btn-close-padding-x:        .25em;
$btn-close-padding-y:        $btn-close-padding-x;
$btn-close-color:            $black;
$btn-close-bg:               url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='#{$btn-close-color}'><path d='M.293.293a1 1 0 0 1 1.414 0L8 6.586 14.293.293a1 1 0 1 1 1.414 1.414L9.414 8l6.293 6.293a1 1 0 0 1-1.414 1.414L8 9.414l-6.293 6.293a1 1 0 0 1-1.414-1.414L6.586 8 .293 1.707a1 1 0 0 1 0-1.414z'/></svg>");
$btn-close-focus-shadow:     $focus-ring-box-shadow;
$btn-close-opacity:          .5;
$btn-close-hover-opacity:    .75;
$btn-close-focus-opacity:    1;
$btn-close-disabled-opacity: .25;
$btn-close-white-filter:     invert(1) grayscale(100%) brightness(200%);