Skip to content

Bootstrap 치트시트

CSS와 JavaScript 기반의 강력하고 확장 가능하며 기능이 풍부한 프론트엔드 툴킷입니다.

01

시작하기

Bootstrap 포함하기

빠른 시작을 위해 CDN으로 Bootstrap을 포함하세요 — CSS는 <head>에, JS 번들(Popper 포함)은 </body> 직전에 넣습니다. bundle.min.js에는 툴팁/드롭다운/팝오버를 위한 Popper가 포함되어 있습니다. npm을 쓴다면 엔트리 파일에서 CSS와 JS를 임포트합니다. Bootstrap 5는 jQuery 의존성을 제거했습니다 — 모든 컴포넌트가 바닐라 JS로 동작합니다.

bootstrap
<!-- CSS only (in <head>) -->
<link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">

<!-- JS bundle (before </body>) -->
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js"></script>

<!-- or install via npm -->
<!-- npm install [email protected] -->

<!-- import in JS -->
// import 'bootstrap/dist/css/bootstrap.min.css'
// import 'bootstrap'  // imports all JS

컨테이너

컨테이너는 가장 기본적인 레이아웃 요소로, 콘텐츠를 가운데 정렬하고 좌우 패딩을 추가합니다. .container는 각 브레이크포인트에서 고정 폭(max-width가 변함)이고, .container-fluid는 항상 100% 폭입니다. 반응형 컨테이너(container-sm/md/lg/xl/xxl)는 해당 브레이크포인트까지 100% 폭이었다가 이후 고정 폭이 됩니다. 대부분의 레이아웃에는 .container를, 풀와이드 앱에는 .container-fluid를 사용하세요.

bootstrap
<!-- fixed-width container (responsive breakpoints) -->
<div class="container">
  <!-- content centered with max-width -->
</div>

<!-- full-width container -->
<div class="container-fluid">
  <!-- spans entire viewport width -->
</div>

<!-- responsive containers (max-width at breakpoint) -->
<div class="container-sm">  <!-- 100% until sm, then fixed -->
<div class="container-md">
<div class="container-xl">

<!-- 100% wide until the breakpoint, then max-width applied -->
<div class="container-xxl">

반응형 브레이크포인트

Bootstrap은 모바일 우선의 min-width 미디어 쿼리 시스템을 사용합니다. 6개의 브레이크포인트: xs(기본), sm(576px), md(768px), lg(992px), xl(1200px), xxl(1400px). col-md-6 같은 클래스는 md 이상에서 적용됩니다. 브레이크포인트에서 보이기/숨기기는 d-none(display:none)과 d-{breakpoint}-block으로 합니다. 모바일 우선 접근이므로 작은 화면용 스타일을 먼저 만들고 큰 화면용 복잡도를 더합니다.

bootstrap
/* Bootstrap 5 breakpoints (min-width, mobile-first) */
/* xs: <576px  (default, no media query needed) */
/* sm: >=576px */
/* md: >=768px */
/* lg: >=992px */
/* xl: >=1200px */
/* xxl: >=1400px */

<!-- classes apply AT and ABOVE the breakpoint -->
<div class="col-12 col-md-6 col-lg-4">
  <!-- full width on mobile, half on md, third on lg -->
</div>

<!-- hidden/visible at breakpoints -->
<div class="d-none d-md-block">  <!-- hidden below md -->
<div class="d-block d-md-none">  <!-- visible below md only -->

Reboot과 기본 스타일

Reboot은 Bootstrap의 CSS 리셋입니다 — rem 단위(루트 em, html 폰트 크기 16px 기준)로 브라우저 스타일을 정규화합니다. 모든 엘리먼트에 box-sizing: border-box가 적용됩니다. 제목, 단락, 목록, 테이블, 링크에 합리적인 기본값이 부여됩니다. Reboot은 제목과 목록의 위쪽 마진을 제거해 0으로 설정합니다. 이로써 Bootstrap 컴포넌트가 얹히기 전에 브라우저 간 일관된 기준선을 만듭니다.

bootstrap
<!-- Reboot normalizes styles: box-sizing, margins, etc. -->
<!-- body gets: font-family, font-size (1rem), line-height (1.5), color -->

<!-- headings use rem units, margin-top removed -->
<h1>Heading 1 (2.5rem)</h1>
<h2>Heading 2 (2rem)</h2>

<!-- links get color and underline on hover -->
<a href="#">Default link</a>

<!-- tables get basic styling -->
<table class="table">...</table>

<!-- <ul>/<ol> have padding-left removed -->
<ul>
  <li>Item</li>
</ul>

CSS 변수로 커스터마이징

Bootstrap 5는 --bs- 접두사가 붙은 수백 개의 CSS 커스텀 프로퍼티(변수)를 노출합니다. :root에서 오버라이드하면 사이트 전체 테마가 바뀝니다. <html> 요소에 data-bs-theme='dark'를 설정하면 다크 모드가 내장되어 변수 세트가 교체됩니다. 이전의 Sass 변수 방식보다 훨씬 쉬워졌습니다 — 빌드 단계 없이 일반 CSS만으로 색상, 폰트, 간격, radius를 바꿀 수 있습니다.

bootstrap
:root {
  /* override Bootstrap's CSS variables */
  --bs-primary: #0d6efd;
  --bs-body-bg: #ffffff;
  --bs-body-color: #212529;
  --bs-font-sans-serif: 'Inter', system-ui, sans-serif;
  --bs-border-radius: 0.375rem;
}

/* dark mode via data attribute */
[data-bs-theme="dark"] {
  --bs-body-bg: #212529;
  --bs-body-color: #f8f9fa;
}

<!-- use in HTML -->
<div style="background: var(--bs-primary); color: var(--bs-white);">
  Custom styled
</div>
02

레이아웃 기본

행과 열

.row는 열 패딩을 상쇄하는 음수 좌우 마진을 가진 flex 컨테이너(display: flex)입니다. 직계 .col 자식들은 균등하게 flex되어 행을 채웁니다. col-{1-12}는 고정 비율(12칸 중)을 지정합니다. 숫자가 없는 .col은 남은 공간을 균등하게 나눕니다. 12컬럼 그리드가 Bootstrap 레이아웃의 핵심입니다 — col-{n}과 자동 .col을 조합해 유연한 레이아웃을 만드세요.

bootstrap
<!-- .row creates a flex container with negative margins -->
<!-- .col children flex equally -->
<div class="container">
  <div class="row">
    <div class="col">Column 1</div>
    <div class="col">Column 2</div>
    <div class="col">Column 3</div>
  </div>
  <!-- 3 equal columns -->
</div>

<!-- sized columns -->
<div class="row">
  <div class="col-8">8/12 width</div>
  <div class="col-4">4/12 width</div>
</div>

<!-- auto + sized -->
<div class="row">
  <div class="col">auto width (content-based)</div>
  <div class="col-6">exactly half</div>
  <div class="col">auto width</div>
</div>

거터(열 사이 간격)

거터는 열 사이의 패딩으로 g-* 클래스(g-0부터 g-5)로 조절합니다. g-0은 모든 거터를 제거합니다(열이 딱 붙음). g-3이 기본값입니다. 거터는 가로(열 사이)와 세로(열이 줄바꿈될 때 행 사이) 모두 적용됩니다. 브레이크포인트별 간격이 다르면 반응형 변형(g-2 g-md-4)을 사용하세요. 거터 시스템은 기존의 가로 패딩 전용 방식을 대체했습니다.

bootstrap
<!-- default gutters (1.5rem padding on each side of columns) -->
<div class="row">
  <div class="col-6">A</div>
  <div class="col-6">B</div>
</div>

<!-- remove gutters -->
<div class="row g-0">
  <div class="col-6">A</div>
  <div class="col-6">B</div>
</div>

<!-- custom gutter sizes: g-0 to g-5 -->
<div class="row g-3">
  <div class="col-6">A</div>
  <div class="col-6">B</div>
</div>

<!-- responsive gutters -->
<div class="row g-2 g-md-4">
  <div class="col-6">A</div>
  <div class="col-6">B</div>
</div>

<!-- vertical gutters (row spacing) -->
<div class="row g-3">
  <div class="col-12">Row 1</div>
  <div class="col-12">Row 2 (g-3 gap above)</div>
</div>

열 줄바꿈과 정렬

열의 합이 12를 넘으면 새 줄로 감싸집니다. 행에 align-items-*(start/center/end)로 세로 정렬을, justify-content-*(start/center/end/between/around/evenly)로 가로 배분을 조절합니다. 내부적으로는 flexbox를 사용합니다. 줄바꿈은 자동이라 명시적인 행 구분이 필요 없습니다. col-* 클래스만으로 벽돌 같은 레이아웃도 쉽게 만듭니다.

bootstrap
<!-- columns wrap when they exceed 12 total -->
<div class="row">
  <div class="col-9">9 cols</div>
  <div class="col-4">4 cols → wraps to next line (9+4=13)</div>
  <div class="col-6">6 cols (new line)</div>
</div>

<!-- vertical alignment -->
<div class="row align-items-center">
  <div class="col">Vertically centered</div>
</div>

<!-- options: align-items-start, -center, -end -->
<div class="row align-items-end">...</div>

<!-- horizontal alignment -->
<div class="row justify-content-center">
  <div class="col-6">Centered horizontally</div>
</div>

<!-- options: justify-content-start, -center, -end, -between, -around, -evenly -->

열 순서 변경

order 클래스는 HTML을 바꾸지 않고 열의 시각적 순서를 바꿉니다. order-first, order-{1-5}, order-last로 7단계를 제공합니다. 반응형 변형(order-md-first)으로 브레이크포인트에서 순서를 바꿀 수 있습니다 — 중요한 콘텐츠를 HTML 앞에 두어(SEO) 모바일에서는 다르게 보여 주는 데 유용합니다. offset(offset-md-4)은 왼쪽 마진을 더해 열을 오른쪽으로 밉니다 — 가운데 정렬이나 들여쓰기에 유용합니다. 둘 다 flexbox order와 margin 유틸리티에 기반합니다.

bootstrap
<!-- order classes: order-first, order-{1-5}, order-last -->
<div class="row">
  <div class="col order-2">First in HTML, second visually</div>
  <div class="col order-1">Second in HTML, first visually</div>
  <div class="col order-3">Third in both</div>
</div>

<!-- responsive ordering -->
<div class="row">
  <div class="col order-last order-md-first">
    Last on mobile, first on desktop
  </div>
  <div class="col">Normal</div>
</div>

<!-- column offset (push right) -->
<div class="row">
  <div class="col-md-4 offset-md-4">Centered (offset 4)</div>
</div>

<!-- offset responsive -->
<div class="col-md-4 offset-md-2 offset-lg-4">...</div>

Z-Index와 쌓임

Bootstrap은 쌓임을 위한 z-index 척도를 사용합니다: z-1, z-2, z-3(및 음수 z-n0, z-n1, z-n2). 모달, 드롭다운, 툴팁 같은 컴포넌트는 더 높은 내장 z-index(1000~1080)를 갖습니다. z-index가 동작하려면 엘리먼트에 position(relative, absolute, fixed, sticky)이 필요합니다. 임의의 z-index 값은 피하고 일관성을 위해 Bootstrap의 척도를 사용하세요. 쌓임 순서는 모달이 드롭다운 위에, 드롭다운이 내비바 위에 항상 오도록 설계되어 있습니다.

bootstrap
/* Bootstrap's z-index scale */
/* z-1 to z-3, plus z-n0, z-n1, z-n2 for negatives */

<div class="z-3 position-relative">High z-index</div>
<div class="z-1 position-relative">Low z-index</div>

<!-- components have built-in z-index: -->
/* dropdown: 1000 */
/* sticky: 1020 */
/* fixed: 1030 */
/* modal-backdrop: 1050 */
/* modal: 1055 */
/* popover: 1070 */
/* tooltip: 1080 */

<!-- use position utilities for stacking context -->
<div class="position-relative z-3">
  Needs position for z-index to apply
</div>
03

그리드 시스템

기본 그리드

Bootstrap의 그리드는 12컬럼 시스템입니다. col-{1-12}는 엘리먼트가 12칸 중 몇 칸을 차지하는지 지정합니다. col-12는 전체 폭, col-6은 절반, col-4는 1/3, col-3은 1/4입니다. 행 안의 열은 합이 12(이하 — 남은 공간은 분배)가 되어야 합니다. 숫자가 없는 .col은 남은 공간을 균등하게 나눕니다. 그리드는 flexbox를 사용합니다 — 행은 flex 컨테이너, 열은 flex 아이템입니다.

bootstrap
<!-- 12-column grid -->
<div class="container">
  <div class="row">
    <div class="col-12">Full width (12/12)</div>
  </div>
  <div class="row">
    <div class="col-6">Half (6/12)</div>
    <div class="col-6">Half (6/12)</div>
  </div>
  <div class="row">
    <div class="col-4">Third (4/12)</div>
    <div class="col-4">Third (4/12)</div>
    <div class="col-4">Third (4/12)</div>
  </div>
  <div class="row">
    <div class="col-3">Quarter (3/12)</div>
    <div class="col-9">Three-quarters (9/12)</div>
  </div>
</div>

반응형 열

반응형 열 클래스(col-sm-*, col-md-*, col-lg-*, col-xl-*, col-xxl-*)는 해당 브레이크포인트 이상에서 적용됩니다(모바일 우선). 가장 작은 적용 가능 클래스가 이깁니다. col-12 col-md-6 col-lg-4는 모바일에서 전체 폭, 태블릿에서 절반, 데스크톱에서 1/3을 의미합니다. row-cols-*는 브레이크포인트에서 행당 균등 폭 열의 수를 설정합니다 — 모든 열이 같을 때 각 자식에 col-*를 지정하는 것보다 간단합니다.

bootstrap
<!-- different widths at different breakpoints -->
<div class="row">
  <!-- full on mobile, half on md, third on lg -->
  <div class="col-12 col-md-6 col-lg-4">Card 1</div>
  <div class="col-12 col-md-6 col-lg-4">Card 2</div>
  <div class="col-12 col-md-6 col-lg-4">Card 3</div>
</div>

<!-- mobile-first: base class applies to all, -->
<!-- larger breakpoints override -->
<div class="col-12 col-sm-6 col-md-4 col-lg-3 col-xl-2">
  1 per row on xs, 2 on sm, 3 on md, 4 on lg, 6 on xl
</div>

<!-- equal-width columns at breakpoint -->
<div class="row row-cols-1 row-cols-md-2 row-cols-lg-3">
  <div class="col">Auto-width card</div>
  <div class="col">Auto-width card</div>
  <div class="col">Auto-width card</div>
</div>

열 중첩

그리드를 중첩하려면 .col 안에 .row를 넣습니다 — 중첩된 행은 부모 열의 폭 안에서 새 12컬럼 컨텍스트를 만듭니다. 중첩된 열(col-4, col-8)은 전체 페이지가 아니라 부모의 폭을 나눕니다. 사이드바와 하위 섹션 같은 복잡한 레이아웃에는 중첩이 필수입니다. 지나치게 좁은 열을 피하고 가독성을 유지하려면 중첩을 얕게(최대 2~3단계) 유지하세요.

bootstrap
<!-- nest a row inside a column -->
<div class="row">
  <div class="col-6">
    <!-- outer column -->
    <h3>Left half</h3>
    <!-- nested row: new 12-column context -->
    <div class="row">
      <div class="col-4">Nested 1/3 of parent</div>
      <div class="col-8">Nested 2/3 of parent</div>
    </div>
  </div>
  <div class="col-6">
    <h3>Right half</h3>
  </div>
</div>

<!-- the nested row creates a new 12-col grid -->
<!-- within the parent column's width -->

열 오프셋과 마진

offset-{breakpoint}-{n}은 n칸의 왼쪽 마진을 추가합니다 — 가운데 정렬이나 들여쓰기에 유용합니다. col-md-4에 offset-md-4를 쓰면 가운데 정렬됩니다(4 + 4 + 4 = 12). 더 간단한 가운데 정렬은 열 개수와 무관하게 동작하는 mx-auto(margin: 0 auto)를 사용하세요. 반응형 오프셋(offset-sm-2 offset-md-0)은 모바일에서는 들여쓰고 데스크톱에서는 하지 않게 합니다. 빈 스페이서 열보다 오프셋이 더 깔끔합니다.

bootstrap
<!-- offset: add left margin (empty columns) -->
<div class="row">
  <div class="col-md-4 offset-md-4">
    Centered (4 + 4 offset each side = 12)
  </div>
</div>

<!-- offset only on one side -->
<div class="row">
  <div class="col-md-6 offset-md-3">
    Centered with more left space
  </div>
</div>

<!-- responsive offset -->
<div class="row">
  <div class="col-sm-8 offset-sm-2 offset-md-0 col-md-12">
    Offset on mobile, none on desktop
  </div>
</div>

<!-- margin utilities for auto centering -->
<div class="row">
  <div class="col-md-6 mx-auto">
    Auto-centered (margin: 0 auto)
  </div>
</div>

Row Columns와 자동 레이아웃

row-cols-{n}은 행당 균등 폭 열의 수를 설정합니다 — 모두 같은 폭일 때 각 자식에 col-*를 추가하는 것보다 훨씬 깔끔합니다. row-cols-2는 행당 2열이며 항목이 자동으로 줄바꿈됩니다. 반응형 변형(row-cols-1 row-cols-md-3)은 브레이크포인트에서 개수를 바꿉니다. 숫자 없는 .col은 열이 공간을 균등하게 나누게 합니다. 카드 그리드에는 row-cols를, 열마다 특정 비율이 필요하면 col-{n}을 사용하세요.

bootstrap
<!-- row-cols: set number of columns per row -->
<div class="row row-cols-2">
  <div class="col">Item 1</div>
  <div class="col">Item 2</div>
  <div class="col">Item 3</div>  <!-- wraps to new row -->
  <div class="col">Item 4</div>
</div>
<!-- 2 per row automatically -->

<!-- responsive row-cols -->
<div class="row row-cols-1 row-cols-sm-2 row-cols-md-3 row-cols-lg-4">
  <div class="col">Card</div>
  <div class="col">Card</div>
  <div class="col">Card</div>
  <div class="col">Card</div>
</div>

<!-- auto-fit columns: .col without number -->
<div class="row">
  <div class="col">Equal</div>
  <div class="col">Equal</div>
  <div class="col">Equal</div>
</div>
<!-- each takes 1/3, regardless of content -->
04

타이포그래피

제목과 Display

Bootstrap은 h1~h6를 rem 기반 크기로 스타일링합니다(h1 = 2.5rem, h6 = 1rem). .h1~.h6 클래스는 어떤 엘리먼트에도 제목 스타일을 적용합니다. Display 제목(display-1~display-6)은 더 크고 얇습니다 — 히어로 섹션용입니다. .lead는 단락을 약간 크고 밝게 만듭니다 — 보통 첫 단락에 사용합니다. 레이아웃 공백을 피하려고 제목에는 기본적으로 위쪽 마진이 없습니다(Reboot이 제거).

bootstrap
<!-- standard headings (h1-h6) -->
<h1>h1 heading</h1>
<h2>h2 heading</h2>
<h3>h3 heading</h3>

<!-- heading classes for matching styles -->
<p class="h1">Looks like h1</p>
<p class="h2">Looks like h2</p>

<!-- display headings (larger, thinner) -->
<h1 class="display-1">Display 1</h1>
<h1 class="display-2">Display 2</h1>
<h1 class="display-3">Display 3</h1>
<h1 class="display-4">Display 4</h1>
<h1 class="display-5">Display 5</h1>
<h1 class="display-6">Display 6</h1>

<!-- lead paragraph -->
<p class="lead">This is a lead paragraph.</p>

인라인 텍스트 요소

Bootstrap은 시맨틱 HTML 요소를 스타일링합니다: <mark>(하이라이트), <del>/<s>(취소선), <ins>/<u>(밑줄), <small>(작은 글씨). 텍스트 유틸리티: text-uppercase/lowercase/capitalize, fw-bold/light/normal, fst-italic, text-muted(회색). text-decoration-underline/line-through로 밑줄을 제어합니다. 일관성을 위해 인라인 스타일보다 이 유틸리티들이 선호됩니다.

bootstrap
<!-- text styling -->
<p>You can use <mark>highlight</mark> text.</p>
<p><del>Deleted</del> and <s>strikethrough</s> text.</p>
<p><ins>Inserted</ins> and <u>underline</u> text.</p>
<p><small>Small text</small> for fine print.</p>
<p><strong>Bold</strong> and <em>italic</em> text.</p>

<!-- text utilities -->
<p class="text-decoration-underline">Underlined</p>
<p class="text-decoration-line-through">Line through</p>
<p class="text-lowercase">lowercase text</p>
<p class="text-uppercase">UPPERCASE TEXT</p>
<p class="text-capitalize">Capitalized Text</p>
<p class="fw-bold">Font weight bold</p>
<p class="fw-light">Font weight light</p>
<p class="fst-italic">Font style italic</p>
<p class="text-muted">Muted/gray text</p>

목록

list-unstyled는 기본 목록 스타일(불릿과 왼쪽 패딩)을 제거합니다 — 내비게이션 메뉴에 유용합니다. list-inline은 목록 항목을 인라인으로 표시합니다(태그 클라우드, 브레드크럼). 설명 목록(dl/dt/dd)은 row 클래스로 가로 배치가 됩니다 — dt는 왼쪽, dd는 오른쪽에 그리드로 정렬됩니다. Bootstrap의 목록은 일관된 간격을 위해 margin-top: 0과 margin-bottom: 1rem을 가집니다.

bootstrap
<!-- unordered list -->
<ul>
  <li>Item 1</li>
  <li>Item 2</li>
</ul>

<!-- unstyled list (no bullets, no padding) -->
<ul class="list-unstyled">
  <li>No bullets</li>
  <li>No left padding</li>
</ul>

<!-- inline list -->
<ul class="list-inline">
  <li class="list-inline-item">Inline 1</li>
  <li class="list-inline-item">Inline 2</li>
  <li class="list-inline-item">Inline 3</li>
</ul>

<!-- description list -->
<dl>
  <dt>Term</dt>
  <dd>Definition</dd>
</dl>

<!-- horizontal description list -->
<dl class="row">
  <dt class="col-sm-3">Term</dt>
  <dd class="col-sm-9">Definition</dd>
</dl>

인용문과 코드

인용문은 의미론을 위해 <figure>/<blockquote>/<figcaption> 구조를 사용합니다. blockquote-footer는 출처를 스타일링합니다. 코드 스타일: 인라인 코드는 <code>, 코드 블록은 <pre><code>, 키보드 키는 <kbd>, 변수는 <var>. 코드 안의 꺾쇠괄호는 항상 HTML 이스케이프하세요(<는 &lt;). 인용문은 text-center/text-end로 정렬할 수 있습니다. kbd 스타일은 키보드처럼 보이게 합니다.

bootstrap
<!-- blockquote with source -->
<figure>
  <blockquote class="blockquote">
    <p>A well-known quote.</p>
  </blockquote>
  <figcaption class="blockquote-footer">
    Someone famous in <cite title="Source Title">Source Title</cite>
  </figcaption>
</figure>

<!-- blockquote alignment -->
<blockquote class="blockquote text-center">Centered</blockquote>
<blockquote class="blockquote text-end">Right-aligned</blockquote>

<!-- inline code -->
<p>Use <code>&lt;section&gt;</code> tag.</p>

<!-- code block -->
<pre><code>&lt;div class="container"&gt;
  Hello
&lt;/div&gt;
</code></pre>

<!-- variables -->
<var>y</var> = <var>mx</var> + <var>b</var>

<!-- keyboard input -->
<kbd>Ctrl</kbd> + <kbd>C</kbd>

텍스트 정렬과 줄바꿈

텍스트 정렬: text-start/center/end(Bootstrap 5는 RTL 지원을 위해 left/right를 start/end로 이름 바꿨습니다). 반응형 변형(text-md-start)은 브레이크포인트에서 정렬을 바꿉니다. text-nowrap은 줄바꿈을 막고, text-truncate는 넘칠 때 말줄임표를 추가합니다(max-width나 제한된 컨테이너 필요). text-break은 긴 단어를 자르고, lh-*는 line-height를 조절합니다. 커스텀 CSS 없이 텍스트 흐름을 처리합니다.

bootstrap
<!-- text alignment -->
<p class="text-start">Left aligned (default)</p>
<p class="text-center">Center aligned</p>
<p class="text-end">Right aligned</p>

<!-- responsive alignment -->
<p class="text-center text-md-start">
  Center on mobile, left on md+
</p>

<!-- text wrapping -->
<div class="text-wrap">This text wraps.</div>
<div class="text-nowrap">This text doesn't wrap.</div>

<!-- truncate with ellipsis -->
<div class="text-truncate" style="max-width: 200px;">
  This long text will be truncated with an ellipsis...
</div>

<!-- word break -->
<p class="text-break">verylongwordwithoutspaces</p>

<!-- line height -->
<p class="lh-1">Line height 1</p>
<p class="lh-sm">Line height small</p>
<p class="lh-base">Line height base (default)</p>
<p class="lh-lg">Line height large</p>
05

테이블

기본 테이블

.table 클래스는 패딩, 테두리, 가로 구분선을 추가합니다. 헤더는 <thead>, 데이터는 <tbody>를 사용하세요. 헤더의 <th>에는 scope='col', 행의 <th>에는 scope='row'를 지정하면 스크린 리더 접근성이 향상됩니다. 테이블은 옵트인입니다 — .table이 없으면 스타일 없는 HTML 테이블이 됩니다. 접근성을 위해 항상 시맨틱 테이블 요소(thead, tbody, th, tr, td)를 사용하세요.

bootstrap
<!-- basic table with styling -->
<table class="table">
  <thead>
    <tr>
      <th scope="col">#</th>
      <th scope="col">Name</th>
      <th scope="col">Email</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <th scope="row">1</th>
      <td>Alice</td>
      <td>[email protected]</td>
    </tr>
    <tr>
      <th scope="row">2</th>
      <td>Bob</td>
      <td>[email protected]</td>
    </tr>
  </tbody>
</table>

테이블 변형과 줄무늬

테이블 수식어: table-striped(행 색 교차), table-bordered(모든 테두리), table-borderless(테두리 없음), table-hover(hover 시 행 하이라이트), table-sm(좁은 패딩), table-dark(다크 테마). 조합 가능합니다: table table-striped table-hover. dark 변형은 어두운 배경을 위해 색을 반전시킵니다. table-sm은 촘촘한 데이터 표시를 위해 셀 패딩을 절반으로 줄입니다.

bootstrap
<!-- striped rows -->
<table class="table table-striped">
  <!-- alternating background colors -->
</table>

<!-- bordered table -->
<table class="table table-bordered">
  <!-- borders on all sides -->
</table>

<!-- borderless table -->
<table class="table table-borderless">
  <!-- no borders -->
</table>

<!-- hoverable rows -->
<table class="table table-hover">
  <!-- row highlights on hover -->
</table>

<!-- small table -->
<table class="table table-sm">
  <!-- condensed padding -->
</table>

<!-- dark table -->
<table class="table table-dark">
  <!-- dark background -->
</table>

테이블 색상

<tr>이나 <td>에 컨텍스트 클래스를 적용합니다: table-primary, table-success, table-danger, table-warning, table-info, table-secondary, table-light, table-dark, table-active. 상태 표시를 위한 은은한 배경색을 추가합니다. 다크 테이블에서는 같은 클래스가 더 밝은 변형을 제공합니다. 장식이 아니라 의미 있는 상태(완료는 success, 오류는 danger)에 아껴 사용하세요.

bootstrap
<!-- contextual row/cell colors -->
<table class="table">
  <thead>
    <tr class="table-primary"><th>Primary header</th></tr>
  </thead>
  <tbody>
    <tr class="table-success">
      <td>Success row (green)</td>
    </tr>
    <tr class="table-danger">
      <td>Danger row (red)</td>
    </tr>
    <tr class="table-warning">
      <td>Warning row (yellow)</td>
    </tr>
    <tr class="table-info">
      <td>Info row (cyan)</td>
    </tr>
    <!-- individual cells -->
    <tr>
      <td class="table-active">Active cell</td>
      <td>Normal cell</td>
    </tr>
  </tbody>
</table>

반응형 테이블

테이블을 .table-responsive로 감싸면 작은 화면에서 가로 스크롤이 생깁니다(레이아웃 파손 방지). table-responsive-sm/md/lg/xl/xxl은 그 브레이크포인트 미에서만 스크롤됩니다 — 더 큰 화면에서는 테이블이 정상적으로 맞습니다. 반응형 래퍼가 없으면 넓은 테이블이 컨테이너를 넘칩니다. overflow를 <table>에 직접 적용할 수 없어 래퍼 div가 필요합니다. 열이 많은 테이블에는 항상 사용하세요.

bootstrap
<!-- responsive table (horizontal scroll on small screens) -->
<div class="table-responsive">
  <table class="table">
    <!-- scrolls horizontally on small screens -->
    <thead>...</thead>
    <tbody>...</tbody>
  </table>
</div>

<!-- responsive at specific breakpoints -->
<div class="table-responsive-sm">
  <!-- scrolls below sm -->
</div>
<div class="table-responsive-md">
  <!-- scrolls below md -->
</div>
<div class="table-responsive-lg">
  <!-- scrolls below lg -->
</div>

<!-- always scrollable -->
<div class="table-responsive">...</div>

테이블 그룹과 캡션

caption-top은 캡션을 테이블 위로 이동시킵니다(기본은 아래). 캡션은 스크린 리더 접근성을 향상시킵니다. thead/tbody/tfoot은 table-light/table-dark로 따로 스타일링할 수 있습니다. 세로 정렬: 셀이나 행에 align-top, align-middle, align-bottom — 셀 콘텐츠 높이가 다를 때 유용합니다. tfoot은 기본적으로 thead처럼 스타일링되지만 커스터마이즈할 수 있습니다.

bootstrap
<!-- caption (accessibility, shown below table by default) -->
<table class="table caption-top">
  <caption>List of users</caption>
  <thead>
    <tr><th>#</th><th>Name</th></tr>
  </thead>
  <tbody>
    <tr><td>1</td><td>Alice</td></tr>
  </tbody>
</table>

<!-- table groups for styling -->
<table class="table">
  <thead class="table-light">
    <tr><th>Light header</th></tr>
  </thead>
  <tbody>
    <tr><td>Body</td></tr>
  </tbody>
  <tfoot class="table-dark">
    <tr><td>Dark footer</td></tr>
  </tfoot>
</table>

<!-- vertically aligned cells -->
<tr class="align-middle">
  <td class="align-top">Top</td>
  <td class="align-middle">Middle</td>
  <td class="align-bottom">Bottom</td>
</tr>
06

폼

폼 컨트롤

form-control는 텍스트 input, textarea, 파일 input을 스타일링합니다. form-select는 드롭다운을 스타일링합니다. 접근성을 위해 input에는 항상 <label> 요소(for/id 매칭)를 짝지으세요. form-label이 적절한 간격을 더합니다. disabled는 상호작용을 막고, readonly는 편집 없이 값을 보여 줍니다. mb-3(margin-bottom)이 폼 그룹 사이 간격을 더합니다. .form-control 클래스는 일관된 높이, 패딩, 포커스 스타일을 적용합니다.

bootstrap
<!-- text input -->
<div class="mb-3">
  <label for="email" class="form-label">Email</label>
  <input type="email" class="form-control" id="email" placeholder="Enter email">
</div>

<!-- textarea -->
<div class="mb-3">
  <label for="bio" class="form-label">Bio</label>
  <textarea class="form-control" id="bio" rows="3"></textarea>
</div>

<!-- select -->
<select class="form-select" aria-label="Default select">
  <option selected>Open this select menu</option>
  <option value="1">One</option>
  <option value="2">Two</option>
</select>

<!-- disabled -->
<input class="form-control" type="text" placeholder="Disabled" disabled>
<input class="form-control" type="text" value="Readonly" readonly>

폼 그리드와 레이아웃

폼 레이아웃에는 그리드 시스템(row/col)을 사용합니다. 가로 폼은 col-form-label과 col-*를 짝지어 레이블/input을 정렬합니다. row-cols-lg-auto는 큰 화면에서 폼 요소가 콘텐츠 크기에 맞게(인라인 폼) 됩니다. align-items-center가 레이블과 input을 세로로 맞춥니다. 그리드를 사용하면 커스텀 CSS 없이 브레이크포인트별 폼 레이아웃을 정밀하게 제어할 수 있습니다.

bootstrap
<!-- form using grid -->
<div class="row mb-3">
  <label for="name" class="col-sm-2 col-form-label">Name</label>
  <div class="col-sm-10">
    <input type="text" class="form-control" id="name">
  </div>
</div>

<!-- inline form -->
<form class="row row-cols-lg-auto g-3 align-items-center">
  <div class="col">
    <input class="form-control" placeholder="Email">
  </div>
  <div class="col">
    <input class="form-control" placeholder="Password">
  </div>
  <div class="col">
    <button type="submit" class="btn btn-primary">Sign in</button>
  </div>
</form>

<!-- horizontal form with column sizing -->
<form>
  <div class="row mb-3">
    <label class="col-2 col-form-label">Email</label>
    <div class="col-10">
      <input class="form-control" type="email">
    </div>
  </div>
</form>

인풋 그룹

input-group-text로 input에 텍스트/버튼을 앞뒤로 붙입니다. @ 사용자명, $ 통화, .00 소수, 검색 버튼에 흔히 사용합니다. input-group 래퍼가 애드온과 input을 하나의 연결된 컨트롤처럼 보이게 합니다. 여러 input이 하나의 애드온을 공유할 수 있습니다. 인풋 그룹 안의 버튼은 연결된 모양을 위해 btn-outline-*를 사용합니다. 인풋 그룹과 form-floating은 섞지 마세요.

bootstrap
<!-- prepend text -->
<div class="input-group mb-3">
  <span class="input-group-text">@</span>
  <input type="text" class="form-control" placeholder="Username">
</div>

<!-- append text -->
<div class="input-group mb-3">
  <input type="text" class="form-control" placeholder="Recipient's username">
  <span class="input-group-text">@example.com</span>
</div>

<!-- prepend + append -->
<div class="input-group mb-3">
  <span class="input-group-text">$</span>
  <input type="text" class="form-control">
  <span class="input-group-text">.00</span>
</div>

<!-- with button -->
<div class="input-group mb-3">
  <input type="text" class="form-control" placeholder="Search">
  <button class="btn btn-outline-secondary" type="button">Go</button>
</div>

<!-- multiple inputs -->
<div class="input-group">
  <span class="input-group-text">First and last name</span>
  <input type="text" class="form-control">
  <input type="text" class="form-control">
</div>

플로팅 레이블

플로팅 레이블은 필드에 포커스되거나 내용이 있을 때 레이블이 input 안에서 위로 애니메이션됩니다. HTML에서 레이블은 input 뒤에 와야 합니다. 플로팅 동작을 위해서는 placeholder 속성이 필요합니다(비어 있어도). 공간을 절약하고 모던해 보입니다. input-group과는 조합하지 마세요. 플로팅 레이블은 input, textarea, select에서 동작합니다. 콤팩트한 폼에서 전통적 레이블의 깔끔한 대안입니다.

bootstrap
<!-- floating label (label floats up when focused/filled) -->
<div class="form-floating mb-3">
  <input type="email" class="form-control" id="floatingInput" placeholder="[email protected]">
  <label for="floatingInput">Email address</label>
</div>

<!-- floating textarea -->
<div class="form-floating">
  <textarea class="form-control" id="floatingTextarea" placeholder="Leave a comment"></textarea>
  <label for="floatingTextarea">Comments</label>
</div>

<!-- floating select -->
<div class="form-floating mb-3">
  <select class="form-select" id="floatingSelect">
    <option selected>Open this select menu</option>
    <option value="1">One</option>
  </select>
  <label for="floatingSelect">Works with selects</label>
</div>

<!-- note: placeholder is REQUIRED for floating labels -->
<!-- the placeholder="..." must be present -->

유효성 검사

Bootstrap은 유효성 검사 스타일링을 위해 is-valid와 is-invalid 클래스를, 메시지를 위해 valid-feedback과 invalid-feedback을 제공합니다. 폼에 needs-validation 클래스를 주고 novalidate(브라우저 툴팁 비활성화)와 조합하면 커스텀 JS로 Bootstrap의 유효성 검사 UI를 사용할 수 있습니다. 제출 시 was-validated를 추가해 모든 유효성 상태를 표시합니다. HTML5 제약(required, pattern, type)이나 커스텀 서버 측 검증과 함께 동작합니다.

bootstrap
<!-- server-side validation classes -->
<div class="mb-3">
  <label for="username" class="form-label">Username</label>
  <input type="text" class="form-control is-valid" id="username" value="valid_user">
  <div class="valid-feedback">Looks good!</div>
</div>

<div class="mb-3">
  <label for="email" class="form-label">Email</label>
  <input type="email" class="form-control is-invalid" id="email">
  <div class="invalid-feedback">Please enter a valid email.</div>
</div>

<!-- no validate on form to disable browser validation -->
<form class="needs-validation" novalidate>
  <div class="mb-3">
    <input type="text" class="form-control" required>
    <div class="invalid-feedback">This field is required.</div>
  </div>
  <button class="btn btn-primary" type="submit">Submit</button>
</form>

<!-- JS: form.classList.add('was-validated') on submit -->
07

버튼

버튼 변형

btn이 기본 버튼 클래스이고 btn-{color}가 변형을 정합니다. 솔리드 버튼은 색 배경에 흰 텍스트입니다. 아웃라인 버튼(btn-outline-*)은 투명 배경에 색 텍스트/테두리 — 보조 동작에 좋습니다. btn-link는 버튼을 링크처럼 만듭니다. 색상은 의미 있게 고르세요: 확인은 success, 삭제는 danger, 주의는 warning. 색만으로 의미를 전달하지 말고 텍스트도 함께 넣으세요.

bootstrap
<!-- solid buttons -->
<button type="button" class="btn btn-primary">Primary</button>
<button type="button" class="btn btn-secondary">Secondary</button>
<button type="button" class="btn btn-success">Success</button>
<button type="button" class="btn btn-danger">Danger</button>
<button type="button" class="btn btn-warning">Warning</button>
<button type="button" class="btn btn-info">Info</button>
<button type="button" class="btn btn-light">Light</button>
<button type="button" class="btn btn-dark">Dark</button>

<!-- link-styled button -->
<button type="button" class="btn btn-link">Link</button>

<!-- outline buttons (transparent bg, colored border) -->
<button type="button" class="btn btn-outline-primary">Outline Primary</button>
<button type="button" class="btn btn-outline-danger">Outline Danger</button>

버튼 크기와 상태

버튼 크기: btn-lg, 기본, btn-sm. disabled 속성(<button>)이나 .disabled 클래스(<a>나 속성을 못 쓸 때)가 버튼을 회색으로 만듭니다. .active는 눌린 모양을 추가합니다. 풀와이드 버튼에는 d-grid gap-2를 사용하세요(버튼이 쌓이고 폭을 채웁니다). d-md-block은 md 브레이크포인트에서 인라인으로 되돌립니다 — 모바일 풀와이드, 데스크톱 자동 폭에 유용합니다. .disabled 클래스는 pointer-events: none도 설정합니다.

bootstrap
<!-- sizes -->
<button class="btn btn-primary btn-lg">Large</button>
<button class="btn btn-primary">Default</button>
<button class="btn btn-primary btn-sm">Small</button>

<!-- disabled state -->
<button class="btn btn-primary" disabled>Disabled</button>
<!-- or -->
<button class="btn btn-primary disabled">Disabled (aria)</button>

<!-- active/pressed state -->
<button class="btn btn-primary active" aria-pressed="true">Active</button>

<!-- full-width block button -->
<div class="d-grid gap-2">
  <button class="btn btn-primary">Block button</button>
  <button class="btn btn-secondary">Another</button>
</div>

<!-- responsive block buttons -->
<div class="d-grid gap-2 d-md-block">
  <button class="btn btn-primary">Full on mobile, auto on md+</button>
</div>

버튼 그룹

btn-group은 버튼을 가로로 연결된 모서리로 묶습니다. btn-toolbar는 여러 그룹을 간격과 함께 결합합니다. btn-group-vertical은 버튼을 세로로 쌓습니다. 접근성을 위해 항상 role='group'과 aria-label을 추가하세요. 크기 클래스(btn-group-lg/sm)는 그룹의 모든 버튼에 적용됩니다. 버튼 그룹은 툴바, 세그먼트 컨트롤, 페이지네이션 UI의 기초입니다.

bootstrap
<!-- basic button group -->
<div class="btn-group" role="group" aria-label="Basic example">
  <button type="button" class="btn btn-outline-primary">Left</button>
  <button type="button" class="btn btn-outline-primary">Middle</button>
  <button type="button" class="btn btn-outline-primary">Right</button>
</div>

<!-- button toolbar (groups of groups) -->
<div class="btn-toolbar" role="toolbar" aria-label="Toolbar">
  <div class="btn-group me-2" role="group">
    <button class="btn btn-outline-secondary">1</button>
    <button class="btn btn-outline-secondary">2</button>
  </div>
  <div class="btn-group" role="group">
    <button class="btn btn-outline-secondary">3</button>
    <button class="btn btn-outline-secondary">4</button>
  </div>
</div>

<!-- vertical button group -->
<div class="btn-group-vertical" role="group">
  <button class="btn btn-outline-primary">Top</button>
  <button class="btn btn-outline-primary">Middle</button>
  <button class="btn btn-outline-primary">Bottom</button>
</div>

<!-- sizing -->
<div class="btn-group btn-group-lg">...</div>
<div class="btn-group btn-group-sm">...</div>

토글과 체크박스 버튼

btn-check는 토글 동작을 위해 btn 레이블과 짝을 이루는 숨은 checkbox/radio입니다. input은 시각적으로 숨겨지고 레이블(버튼 스타일)이 상태를 보여 줍니다. 단일 토글에는 체크박스를, 상호 배타적인 옵션에는 같은 name의 라디오를 사용하세요. 체크되면 버튼 모양이 바뀝니다. autocomplete='off'가 브라우저 상태 복원을 막습니다. 이것이 버튼 스타일 토글의 접근성 있는 방법입니다.

bootstrap
<!-- toggle button (single) -->
<input type="checkbox" class="btn-check" id="btn-check" autocomplete="off">
<label class="btn btn-primary" for="btn-check">Toggle</label>

<!-- checked by default -->
<input type="checkbox" class="btn-check" id="btn-check-checked" checked autocomplete="off">
<label class="btn btn-primary" for="btn-check-checked">Checked</label>

<!-- radio button group -->
<div class="btn-group" role="group" aria-label="Radio toggle">
  <input type="radio" class="btn-check" name="options" id="opt1" autocomplete="off" checked>
  <label class="btn btn-outline-primary" for="opt1">Option 1</label>
  <input type="radio" class="btn-check" name="options" id="opt2" autocomplete="off">
  <label class="btn btn-outline-primary" for="opt2">Option 2</label>
</div>

<!-- outline toggle (changes when checked) -->
<input type="checkbox" class="btn-check" id="btn-check-out" autocomplete="off">
<label class="btn btn-outline-success" for="btn-check-out">Toggle</label>

드롭다운 버튼

드롭다운에는 토글 버튼에 data-bs-toggle='dropdown'이 필요합니다. 메뉴는 dropdown-item 링크를 가진 ul.dropdown-menu입니다. dropdown-divider가 그룹을 나눕니다. 스플릿 버튼(dropdown-toggle-split)은 동작 버튼과 토글 화살표가 분리되어 있습니다 — 접근성을 위해 visually-hidden 텍스트를 추가하세요. dropdown-item.active가 현재 선택을 표시하고, .disabled가 회색으로 만듭니다. 드롭다운에는 Bootstrap JS 번들(위치 지정용 Popper 포함)이 필요합니다.

bootstrap
<!-- button dropdown -->
<div class="dropdown">
  <button class="btn btn-secondary dropdown-toggle" type="button"
          data-bs-toggle="dropdown" aria-expanded="false">
    Dropdown button
  </button>
  <ul class="dropdown-menu">
    <li><a class="dropdown-item" href="#">Action</a></li>
    <li><a class="dropdown-item" href="#">Another action</a></li>
    <li><hr class="dropdown-divider"></li>
    <li><a class="dropdown-item" href="#">Separated link</a></li>
  </ul>
</div>

<!-- split dropdown -->
<div class="btn-group">
  <button type="button" class="btn btn-primary">Primary</button>
  <button type="button" class="btn btn-primary dropdown-toggle dropdown-toggle-split"
          data-bs-toggle="dropdown" aria-expanded="false">
    <span class="visually-hidden">Toggle Dropdown</span>
  </button>
  <ul class="dropdown-menu">...</ul>
</div>

<!-- dropdown with active/disabled items -->
<li><a class="dropdown-item active" href="#">Active</a></li>
<li><a class="dropdown-item disabled">Disabled</a></li>
08

카드

기본 카드

카드는 선택적 헤더, 본문, 푸터를 가진 유연한 컨테이너입니다. card-img-top은 이미지를 상단에 배치합니다. card-title, card-subtitle, card-text가 콘텐츠를 스타일링합니다. 폭은 부모 그리드나 style 속성으로 조절합니다 — 카드는 기본적으로 전체 폭입니다. card-header와 card-footer는 구조화된 콘텐츠용입니다. 카드는 Bootstrap 3의 panels, wells, thumbnails를 하나의 통합 컴포넌트로 대체했습니다.

bootstrap
<div class="card" style="width: 18rem;">
  <!-- optional image -->
  <img src="..." class="card-img-top" alt="...">

  <div class="card-body">
    <h5 class="card-title">Card title</h5>
    <h6 class="card-subtitle mb-2 text-muted">Card subtitle</h6>
    <p class="card-text">Some quick example text to build on the card title.</p>
    <a href="#" class="btn btn-primary">Go somewhere</a>
  </div>
</div>

<!-- card sections -->
<div class="card">
  <div class="card-header">Header</div>
  <div class="card-body">Body content</div>
  <div class="card-footer text-muted">Footer</div>
</div>

카드 콘텐츠 유형

카드는 다양한 콘텐츠 유형을 담을 수 있습니다: 이미지, 텍스트, 리스트 그룹(카드 가장자리에 맞추려면 list-group-flush 사용), 링크(card-link가 간격을 추가). card-body, list-group, card-header, card-footer를 조합해 필요한 카드를 만드세요. list-group-flush는 이중 테두리 없이 목록을 카드에 매끄럽게 통합합니다. 이 유연성 덕에 카드는 Bootstrap의 가장 다재다능한 컴포넌트입니다.

bootstrap
<!-- list group inside card -->
<div class="card" style="width: 18rem;">
  <div class="card-header">Featured</div>
  <ul class="list-group list-group-flush">
    <li class="list-group-item">Item 1</li>
    <li class="list-group-item">Item 2</li>
    <li class="list-group-item">Item 3</li>
  </ul>
  <div class="card-body">
    <a href="#" class="card-link">Card link</a>
    <a href="#" class="card-link">Another link</a>
  </div>
</div>

<!-- kitchen sink (all content types) -->
<div class="card">
  <img src="..." class="card-img-top">
  <div class="card-body">
    <h5 class="card-title">Title</h5>
    <p class="card-text">Text</p>
  </div>
  <ul class="list-group list-group-flush">
    <li class="list-group-item">List item</li>
  </ul>
  <div class="card-body">
    <a href="#" class="card-link">Link</a>
  </div>
</div>

카드 그리드와 그룹

card-group은 카드를 공유 테두리와 동일한 높이로 연결합니다. 반응형 카드 그리드에는 그리드 시스템을 사용하세요: row row-cols-1 row-cols-md-3 g-4는 모바일 1열, 데스크톱 3열에 gap-4 간격을 줍니다. 각 카드는 .col에 들어갑니다. 그리드 방식이 card-group보다 유연합니다 — 카드 높이가 독립적이고 줄바꿈도 제어할 수 있습니다. card-group은 연결된 동일 높이 카드가 필요할 때만 사용하세요.

bootstrap
<!-- card group (cards share border, equal height) -->
<div class="card-group">
  <div class="card">
    <img src="..." class="card-img-top">
    <div class="card-body">
      <h5 class="card-title">Card 1</h5>
    </div>
  </div>
  <div class="card">
    <div class="card-body">
      <h5 class="card-title">Card 2</h5>
    </div>
  </div>
  <div class="card">
    <div class="card-body">
      <h5 class="card-title">Card 3</h5>
    </div>
  </div>
</div>
<!-- cards have equal height, connected borders -->

<!-- using grid for responsive card layout -->
<div class="row row-cols-1 row-cols-md-3 g-4">
  <div class="col">
    <div class="card">...</div>
  </div>
  <div class="col">
    <div class="card">...</div>
  </div>
</div>

카드 내비게이션

card-header에 nav-tabs나 nav-pills를 넣어 카드에 내비게이션을 추가합니다. card-header-tabs와 card-header-pills는 내비를 헤더 가장자리에 붙입니다. 현재 탭에는 nav-link active, 비활성에는 nav-link disabled를 사용하세요. 탭이 실제로 전환되게 하려면 data-bs-toggle='tab'과 탭 팬을 추가하면 — Bootstrap JS가 전환을 처리합니다. 이 패턴은 대시보드와 다중 뷰 콘텐츠 카드에 흔합니다.

bootstrap
<!-- card with nav tabs -->
<div class="card text-center">
  <div class="card-header">
    <ul class="nav nav-tabs card-header-tabs">
      <li class="nav-item">
        <a class="nav-link active" href="#">Active</a>
      </li>
      <li class="nav-item">
        <a class="nav-link" href="#">Link</a>
      </li>
      <li class="nav-item">
        <a class="nav-link disabled">Disabled</a>
      </li>
    </ul>
  </div>
  <div class="card-body">
    <h5 class="card-title">Special title</h5>
    <p class="card-text">Content for active tab.</p>
    <a href="#" class="btn btn-primary">Go</a>
  </div>
</div>

<!-- card with pills -->
<div class="card-header">
  <ul class="nav nav-pills card-header-pills">
    <li class="nav-item"><a class="nav-link active" href="#">Active</a></li>
  </ul>
</div>

카드 변형과 오버레이

카드 색 변형: 솔리드 배경은 bg-{color}에 text-white/text-dark, 색 테두리는 border-{color}에 text-{color}. card-img-overlay는 이미지 위에 텍스트를 얹습니다(card-img가 카드를 채우고 오버레이 콘텐츠가 그 위에 위치) — 이미지 위 가독성 있는 텍스트에는 text-bg-dark를 사용하세요. text-center/text-start/text-end가 텍스트 정렬을 제어합니다. 어두운 이미지 오버레이에서는 텍스트와 이미지 사이 충분한 대비를 확보하세요.

bootstrap
<!-- colored card -->
<div class="card text-white bg-primary">
  <div class="card-header">Header</div>
  <div class="card-body">
    <h5 class="card-title">Primary card</h5>
    <p class="card-text">Text on colored background.</p>
  </div>
</div>

<!-- border colored card -->
<div class="card border-primary">
  <div class="card-header border-primary">Header</div>
  <div class="card-body text-primary">
    <h5 class="card-title">Primary border</h5>
  </div>
</div>

<!-- image overlay (text over image) -->
<div class="card text-bg-dark">
  <img src="..." class="card-img">
  <div class="card-img-overlay">
    <h5 class="card-title">Overlay title</h5>
    <p class="card-text">Text over the image.</p>
  </div>
</div>

<!-- text alignment -->
<div class="card text-center">Centered text</div>
<div class="card text-end">Right-aligned</div>
11

알림(Alerts)

기본 알림

알림은 컨텍스트 피드백 메시지를 표시합니다. alert-{variant}가 색을 정합니다(primary, success, danger, warning, info, light, dark). role='alert'는 스크린 리더 접근성용입니다. alert-link가 링크를 알림 색에 맞춥니다. 알림 용도: 폼 유효성 피드백, 동작 결과(저장됨! 삭제됨!), 중요 안내. 색은 의미에 따라: 긍정은 success, 오류는 danger, 주의는 warning, 중립 정보는 info.

bootstrap
<!-- alert variants -->
<div class="alert alert-primary" role="alert">Primary alert</div>
<div class="alert alert-secondary" role="alert">Secondary alert</div>
<div class="alert alert-success" role="alert">Success! Well done.</div>
<div class="alert alert-danger" role="alert">Danger! Something went wrong.</div>
<div class="alert alert-warning" role="alert">Warning! Check this.</div>
<div class="alert alert-info" role="alert">Info! Note this.</div>
<div class="alert alert-light" role="alert">Light alert</div>
<div class="alert alert-dark" role="alert">Dark alert</div>

<!-- with link -->
<div class="alert alert-primary" role="alert">
  This is an alert with <a href="#" class="alert-link">a link</a>.
</div>

닫을 수 있는 알림

alert-dismissible은 닫기 버튼을 위한 패딩을 추가하고, data-bs-dismiss='alert'가 있는 btn-close가 닫습니다. fade show가 페이드아웃 전환을 활성화합니다. 닫히면 알림은 DOM에서 제거됩니다(숨김 아님). JS로는 Alert 인스턴스를 만들고 close()를 호출합니다. 제거 후 closed.bs.alert 이벤트가 발생합니다. 다시 보여 주려면 DOM 요소를 재생성해야 합니다. 지속적 해제(다시 보지 않기)는 상태를 localStorage에 저장하세요.

bootstrap
<!-- dismissible alert -->
<div class="alert alert-warning alert-dismissible fade show" role="alert">
  <strong>Holy guacamole!</strong> You should check in on some of those fields.
  <button type="button" class="btn-close" data-bs-dismiss="alert"
          aria-label="Close"></button>
</div>

<!-- needs these classes:
     - alert-dismissible: adds padding for close button
     - fade show: enables transition

<!-- after dismissal, the alert is removed from DOM -->

<!-- via JavaScript -->
<script>
const alertEl = document.querySelector('.alert')
const alert = new bootstrap.Alert(alertEl)
alert.close()  // closes and removes
</script>

<!-- events -->
alertEl.addEventListener('closed.bs.alert', () => {
  console.log('alert was closed and removed')
})
</script>

아이콘과 콘텐츠가 있는 알림

알림은 풍부한 콘텐츠를 담을 수 있습니다: 제목(alert-heading), 단락, 구분선(hr), 아이콘, 동작 버튼. 아이콘은 Bootstrap Icons(bi 클래스)나 flex 정렬을 가진 SVG를 사용하세요. d-flex align-items-center가 아이콘과 텍스트를 세로 중앙 정렬합니다. 닫기 버튼과 함께 동작 버튼(세션 경고의 '연장' 등)을 넣으세요. 알림은 텍스트 전용이 아니라 중요한 닫을 수 있는 피드백을 위한 유연한 컨테이너입니다.

bootstrap
<!-- alert with icon -->
<div class="alert alert-success d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" width="24" height="24">
    <use xlink:href="#check-circle-fill"/>
  </svg>
  <div>
    Operation completed successfully!
  </div>
</div>

<!-- alert with more content -->
<div class="alert alert-danger" role="alert">
  <h4 class="alert-heading">Error!</h4>
  <p>There was a problem processing your request.</p>
  <hr>
  <p class="mb-0">Please try again or contact support.</p>
</div>

<!-- alert with action button -->
<div class="alert alert-warning alert-dismissible" role="alert">
  Your session expires in 5 minutes.
  <button type="button" class="btn btn-warning btn-sm ms-3">
    Extend
  </button>
  <button type="button" class="btn-close" data-bs-dismiss="alert"></button>
</div>

토스트 알림

토스트는 가벼운 알림입니다(Android 토스트처럼). 지연 후 자동 숨김됩니다(기본 5초). 쌓으려면 toast-container로 감싸세요. position-fixed와 top-0 end-0가 오른쪽 위에 고정합니다. aria-live='assertive'가 스크린 리더에 알립니다. toast-header에는 아이콘, 제목, 타임스탬프, 닫기 버튼이, toast-body에는 메시지가 들어갑니다. 알림과 달리 토스트는 UI를 막지 않습니다 — 비침습적입니다. '저장됨!', '새 메시지', 백그라운드 작업 완료에 사용하세요.

bootstrap
<!-- toast container (top-right by default) -->
<div class="toast-container position-fixed top-0 end-0 p-3">
  <div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
    <div class="toast-header">
      <img src="..." class="rounded me-2" width="20">
      <strong class="me-auto">Bootstrap</strong>
      <small>11 mins ago</small>
      <button type="button" class="btn-close" data-bs-dismiss="toast"></button>
    </div>
    <div class="toast-body">
      Hello, world! This is a toast message.
    </div>
  </div>
</div>

<script>
// show via JS
const toastEl = document.querySelector('.toast')
const toast = new bootstrap.Toast(toastEl, {
  delay: 5000,       // auto-hide after 5s
  autohide: true
})
toast.show()

// events
toastEl.addEventListener('shown.bs.toast', () => {
  console.log('toast visible')
})
</script>

라이브 알림 영역

동적으로 갱신되는 알림(상태 메시지, 진행 상황)에는 aria-live='polite'를 사용하세요 — 스크린 리더가 방해 없이 변경을 알립니다. aria-live='assertive'는 즉시 알립니다(치명적 오류용). aria-atomic='true'는 변경 시 전체 내용을 읽습니다(변경된 부분만이 아님). role='alert'는 암묵적으로 assertive입니다. 이 접근성 패턴은 스크린 리더 사용자가 동적 업데이트를 듣게 보장합니다. 시각 스타일은 alert 클래스와 조합하세요.

bootstrap
<!-- aria-live for dynamic alerts -->
<div class="alert alert-info" role="alert" aria-live="polite"
     aria-atomic="true" id="statusAlert">
  <!-- content updated dynamically -->
</div>

<script>
// update alert content
function showStatus(message, type = 'info') {
  const alert = document.getElementById('statusAlert')
  alert.className = 'alert alert-' + type
  alert.textContent = message
}

showStatus('Loading...', 'info')
// later:
showStatus('Data loaded!', 'success')

<!-- aria-live="polite" announces updates without interrupting -->
<!-- aria-live="assertive" interrupts immediately (urgent) -->

<!-- for form errors, use role="alert" (assertive by default) -->
<div role="alert" class="alert alert-danger" id="formError">
  Please fix the errors below.
</div>
</script>
12

배지(Badges)

기본 배지

배지는 작은 개수/레이블 표시기입니다. bg-{color}가 배경을 정하고, 밝은 배경(warning, info, light)에는 대비를 위해 text-dark를 추가하세요. 배지는 부모 요소의 폰트 크기에 비례해 커집니다 — h1 배지가 p 배지보다 큽니다. 배지 용도: 안 읽은 개수, 상태 레이블, 'New' 태그, 버전 번호. 텍스트 흐름 안에 들어가는 인라인 요소입니다.

bootstrap
<!-- inline badges -->
<h1>Heading <span class="badge bg-secondary">New</span></h1>
<h2>Heading <span class="badge bg-secondary">New</span></h2>
<h3>Heading <span class="badge bg-secondary">New</span></h3>

<!-- colored badges -->
<span class="badge bg-primary">Primary</span>
<span class="badge bg-secondary">Secondary</span>
<span class="badge bg-success">Success</span>
<span class="badge bg-danger">Danger</span>
<span class="badge bg-warning text-dark">Warning</span>
<span class="badge bg-info text-dark">Info</span>
<span class="badge bg-light text-dark">Light</span>
<span class="badge bg-dark">Dark</span>

<!-- badge sizing scales with parent -->
<h1>Big <span class="badge bg-primary">Badge</span></h1>
<p>Small <span class="badge bg-primary">Badge</span></p>

필 배지와 라운드

rounded-pill은 완전히 둥근 배지(필 모양)를 만듭니다. rounded-0부터 rounded-3까지 border-radius 척도를 조절합니다. rounded-circle에 패딩을 더하면 원형 배지가 됩니다 — 알림 개수에 유용합니다. 한 자릿수의 완벽한 원은 폭/높이를 같게 하고 d-flex align-items-center justify-content-center를 사용하세요. 필 배지는 태그와 상태 표시기에 흔합니다.

bootstrap
<!-- pill badges (more rounded) -->
<span class="badge rounded-pill bg-primary">Primary</span>
<span class="badge rounded-pill bg-success">Success</span>
<span class="badge rounded-pill bg-danger">Danger</span>

<!-- rounded variations -->
<span class="badge rounded-0 bg-primary">Not rounded</span>
<span class="badge rounded-1 bg-primary">Slightly rounded</span>
<span class="badge rounded-2 bg-primary">Default rounded</span>
<span class="badge rounded-3 bg-primary">More rounded</span>
<span class="badge rounded-pill bg-primary">Full pill</span>

<!-- circle badge (fixed size, centered text) -->
<span class="badge rounded-circle bg-primary p-2">5</span>
<!-- needs width/height for perfect circle -->

버튼과 내비의 배지

버튼의 배지: 버튼에 position-relative, 배지에 position-absolute와 top-0 start-100 translate-middle을 쓰면 오른쪽 위 모서리에 놓입니다. 배지 안의 visually-hidden 텍스트가 스크린 리더에 맥락을 줍니다. 내비 링크와 목록 항목의 배지는 개수를 표시합니다 — 오른쪽으로 밀려면 justify-content-between을 사용하세요. 개수가 표시 한계를 넘으면 '99+' 패턴이 흔합니다.

bootstrap
<!-- badge inside button -->
<button type="button" class="btn btn-primary position-relative">
  Inbox
  <span class="position-absolute top-0 start-100 translate-middle
               badge rounded-pill bg-danger">
    99+
  </span>
</button>

<!-- badge with position outside button -->
<button class="btn btn-primary position-relative">
  Messages
  <span class="position-absolute top-0 start-100 translate-middle
               badge rounded-pill bg-danger">
    9
    <span class="visually-hidden">unread messages</span>
  </span>
</button>

<!-- badge in nav link -->
<ul class="nav nav-pills">
  <li class="nav-item">
    <a class="nav-link" href="#">
      Profile
      <span class="badge bg-secondary">3</span>
    </a>
  </li>
</ul>

<!-- badge in list item -->
<li class="list-group-item d-flex justify-content-between align-items-center">
  Messages
  <span class="badge bg-primary rounded-pill">14</span>
</li>

배지 표시기 (점)

점 배지(텍스트 없이 색 원)는 개수 없이 상태를 나타냅니다 — '안 읽음'이나 '온라인'처럼. 작은 점에는 p-1과 rounded-circle을, 배경과 분리에는 border-light를 사용하세요. 위치는 같은 translate-middle 기법으로 지정합니다. 온라인 상태 점(녹색 = 온라인, 회색 = 오프라인)은 아바타 하단 모서리에 놓입니다. 배지는 아이콘(Bootstrap Icons: bi bi-star-fill)을 텍스트와 함께 감쌀 수도 있습니다 — 평점에 유용.

bootstrap
<!-- status dot badge -->
<button class="btn btn-primary position-relative">
  Notifications
  <span class="position-absolute top-0 start-100 translate-middle
               p-1 bg-danger border border-light rounded-circle">
    <span class="visually-hidden">New alerts</span>
  </span>
</button>

<!-- small dot (no text, just indicator) -->
<span class="position-absolute top-0 start-100 translate-middle
             p-1 bg-danger border border-light rounded-circle"></span>

<!-- online status indicator -->
<span class="position-relative d-inline-flex">
  <img src="avatar.jpg" class="rounded-circle" width="40">
  <span class="position-absolute bottom-0 end-0
               bg-success border border-light rounded-circle p-1">
  </span>
</span>
<!-- green dot = online -->

<!-- badge with icon -->
<span class="badge bg-primary">
  <i class="bi bi-star-fill"></i> 4.5
</span>

스피너 Border와 Grow

스피너는 로딩 상태를 나타냅니다. spinner-border는 회전하는 링이고, spinner-grow는 맥동하는 원입니다. text-*로 색을 입힙니다. spinner-border-sm/grow-sm이 더 작습니다. 커스텀 크기는 width/height CSS로 지정합니다. 접근성을 위해 role='status'와 visually-hidden 텍스트를 항상 포함하세요. 버튼에서는 spinner-border-sm과 disabled로 로딩 동작을 표시합니다. 스피너는 CSS 전용(JS 없음)이며 border와 opacity 트랜지션으로 애니메이션됩니다.

bootstrap
<!-- border spinner (rotating border) -->
<div class="spinner-border" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

<!-- colored spinner -->
<div class="spinner-border text-primary"></div>
<div class="spinner-border text-success"></div>
<div class="spinner-border text-danger"></div>

<!-- grow spinner (pulsating circle) -->
<div class="spinner-grow" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

<!-- sizes -->
<div class="spinner-border spinner-border-sm">Small</div>
<div class="spinner-grow spinner-grow-sm">Small grow</div>

<!-- custom size via CSS -->
<div class="spinner-border" style="width: 3rem; height: 3rem;"></div>

<!-- spinner in button -->
<button class="btn btn-primary" disabled>
  <span class="spinner-border spinner-border-sm"></span>
  Loading...
</button>

<!-- spinner with text -->
<div class="d-flex align-items-center">
  <strong>Loading...</strong>
  <div class="spinner-border ms-auto"></div>
</div>
13

진행 표시줄과 스피너

기본 진행 표시줄

진행 표시줄은 작업 완료도를 보여 줍니다. 폭은 인라인 스타일로 백분율을 설정합니다. 접근성을 위해 role='progressbar'와 aria-valuenow/min/max를 사용하세요. 높이는 .progress 컨테이너에 설정합니다(기본 1rem). 바의 bg-{color}가 색을 바꿉니다. 바 안의 레이블 텍스트는 선택 사항입니다 — 최소한의 바에는 생략하세요. 값은 동적이므로 폭은 항상 style로 설정합니다(클래스 아님).

bootstrap
<!-- basic progress bar -->
<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 50%"
       aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
    50%
  </div>
</div>

<!-- without label -->
<div class="progress">
  <div class="progress-bar" style="width: 75%" role="progressbar"
       aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
</div>

<!-- height (set on container) -->
<div class="progress" style="height: 1px;">
  <div class="progress-bar" style="width: 25%"></div>
</div>
<div class="progress" style="height: 20px;">
  <div class="progress-bar" style="width: 25%"></div>
</div>

<!-- background -->
<div class="progress">
  <div class="progress-bar bg-success" style="width: 25%">25%</div>
</div>

줄무늬와 애니메이션 진행

progress-bar-striped는 대각선 줄무늬를 추가합니다. progress-bar-animated는 줄무늬를 움직이게 합니다(진행 중 작업용). 애니메이션은 현재 실행 중인 작업에만 쓰고 — 완료된 것은 정적 바로. JS로 style.width와 aria-valuenow를 바꿔 진행 상황을 업데이트합니다. 애니메이션은 CSS로 처리되어 움직임에 JS가 필요 없습니다. 색 줄무늬 바는 bg-*와 striped를 조합하세요.

bootstrap
<!-- striped progress bar -->
<div class="progress">
  <div class="progress-bar progress-bar-striped" style="width: 50%">
    50%
  </div>
</div>

<!-- animated stripes (for in-progress tasks) -->
<div class="progress">
  <div class="progress-bar progress-bar-striped progress-bar-animated"
       style="width: 75%" role="progressbar">
    75%
  </div>
</div>

<!-- colored striped -->
<div class="progress">
  <div class="progress-bar progress-bar-striped bg-success" style="width: 100%">
    Complete
  </div>
</div>

<!-- update via JS -->
<div class="progress">
  <div class="progress-bar" id="myBar" style="width: 0%"></div>
</div>
<script>
const bar = document.getElementById('myBar')
bar.style.width = '60%'  // update progress
bar.setAttribute('aria-valuenow', '60')
</script>

여러 진행 표시줄

하나의 .progress 컨테이너 안의 여러 progress-bar div는 나란히 쌓입니다 — 각각 전체 폭에서 자기 백분율을 차지합니다. 구성 비율 표시에 유용합니다(예: 저장 공간: 사진 25%, 동영상 30%, 앱 20%). 바들은 같은 높이를 공유하고 틈 없이 붙어 있습니다. 합계는 이상적으로 100%(미완료면 그 이하)입니다. 각각 자체 색상과 레이블을 가질 수 있습니다.

bootstrap
<!-- stacked bars in one container -->
<div class="progress">
  <div class="progress-bar" style="width: 15%">15%</div>
  <div class="progress-bar bg-success" style="width: 30%">30%</div>
  <div class="progress-bar bg-info" style="width: 20%">20%</div>
</div>
<!-- total: 65% filled, 35% empty -->

<!-- stacked with different colors -->
<div class="progress" style="height: 30px;">
  <div class="progress-bar bg-danger" style="width: 25%">Errors</div>
  <div class="progress-bar bg-warning" style="width: 25%">Warnings</div>
  <div class="progress-bar bg-success" style="width: 50%">Success</div>
</div>

<!-- each bar takes its percentage of the full width -->
<!-- they sit side by side, not overlapping -->

플레이스홀더 로딩

플레이스홀더(스켈레톤 로딩)는 콘텐츠가 나타날 자리에 회색 블록을 보여 줍니다 — 콘텐츠가 많은 페이지에서는 스피너보다 좋습니다. placeholder-glow는 맥동하는 반짝임을, placeholder-wave는 움직이는 물결을 만듭니다. col-*가 각 블록의 폭을 정합니다. 스켈레톤 카드는 aria-hidden='true'와 함께 카드 컴포넌트 안에 placeholder를 사용하세요. 데이터 로드 전에 레이아웃을 미리 보여 주어 체감 대기 시간을 줄입니다.

bootstrap
<!-- placeholder (gray animated blocks) -->
<div class="placeholder-glow">
  <span class="placeholder col-12"></span>
  <span class="placeholder col-12"></span>
  <span class="placeholder col-8"></span>
</div>

<!-- wave animation -->
<div class="placeholder-wave">
  <span class="placeholder col-12"></span>
</div>

<!-- placeholder card (skeleton loading) -->
<div class="card" aria-hidden="true">
  <div class="card-body">
    <h5 class="card-title placeholder-glow">
      <span class="placeholder col-6"></span>
    </h5>
    <p class="card-text placeholder-glow">
      <span class="placeholder col-7"></span>
      <span class="placeholder col-4"></span>
      <span class="placeholder col-4"></span>
      <span class="placeholder col-6"></span>
    </p>
    <a class="btn btn-primary disabled placeholder col-6"></a>
  </div>
</div>

레인지 슬라이더

form-range는 네이티브 range input(슬라이더)을 스타일링합니다. 범위와 증분을 위해 min, max, step 속성을 설정하세요. 슬라이더는 기본적으로 전체 폭입니다. 값 표시에는 사용자가 드래그할 때 oninput으로 레이블을 갱신합니다. disabled는 회색으로 만듭니다. 레인지 input은 볼륨, 투명도, 정밀한 값이 필요 없는 연속 값에 적합합니다. 접근성을 위해 항상 레이블과 짝지으세요.

bootstrap
<!-- range input -->
<label for="customRange1" class="form-label">Example range</label>
<input type="range" class="form-range" id="customRange1" min="0" max="5" step="0.5">

<!-- with value display -->
<div class="d-flex">
  <input type="range" class="form-range me-2" id="range"
         min="0" max="100" oninput="document.getElementById('val').textContent = this.value">
  <span id="val" class="badge bg-primary">50</span>
</div>

<!-- disabled -->
<input type="range" class="form-range" disabled>

<!-- min, max, step -->
<input type="range" class="form-range" min="-10" max="10" step="2" value="0">
14

유틸리티 클래스

간격 (마진과 패딩)

간격 유틸리티는 {property}{sides}-{size} 형식입니다. m = margin, p = padding. 방향: t/b(위/아래), s/e(start/end — LTR에서 left/right), x(좌+우), y(위+아래), 빈칸(전체). 크기 0~5는 간격 척도에 매핑됩니다(0, 0.25rem, 0.5rem, 1rem, 1.5rem, 3rem). mx-auto가 블록 요소를 가운데 정렬합니다. 반응형: 브레이크포인트를 추가합니다(mt-md-3). Bootstrap 5는 RTL 지원을 위해 left/right를 start/end로 바꿨습니다.

bootstrap
<!-- format: {property}{sides}-{size} -->
<!-- property: m (margin), p (padding) -->
<!-- sides: t (top), b (bottom), s (start/left), e (end/right), x (both), y (both), blank (all) -->
<!-- size: 0, 1, 2, 3, 4, 5, auto -->

<div class="mt-3">margin-top: 1rem</div>
<div class="mb-4">margin-bottom: 1.5rem</div>
<div class="ms-2">margin-left: 0.5rem (start)</div>
<div class="me-2">margin-right: 0.5rem (end)</div>
<div class="mx-auto">margin: 0 auto (centered)</div>
<div class="my-5">margin top+bottom: 3rem</div>

<div class="p-3">padding: 1rem (all sides)</div>
<div class="px-4">padding left+right: 1.5rem</div>
<div class="pt-2">padding-top: 0.5rem</div>

<!-- responsive: {property}{sides}-{breakpoint}-{size} -->
<div class="mt-0 mt-md-3">No margin on mobile, 1rem on md+</div>
<div class="p-2 p-lg-4">Small padding, larger on lg+</div>

색상과 배경

text-{color}는 텍스트 색을, bg-{color}는 배경을 설정합니다. text-bg-{color}(Bootstrap 5.2+)는 배경에 맞는 대비 텍스트 색을 자동 설정합니다. bg-gradient는 은은한 그라데이션을 더합니다. 투명도: text-opacity-50 또는 bg-opacity-50(10%, 25%, 50%, 75%, 100%). text-muted는 회색(보조 텍스트)입니다. 텍스트와 배경 사이 충분한 대비를 항상 확보하세요 — 어두운 배경에는 text-white. 색은 의미를 가집니다(success=녹색, danger=빨강).

bootstrap
<!-- text colors -->
<p class="text-primary">Primary text</p>
<p class="text-success">Success text</p>
<p class="text-danger">Danger text</p>
<p class="text-muted">Muted text</p>
<p class="text-white bg-dark">White on dark</p>

<!-- background colors -->
<div class="bg-primary text-white">Primary bg</div>
<div class="bg-success text-white">Success bg</div>
<div class="bg-light">Light bg</div>
<div class="bg-dark text-white">Dark bg</div>

<!-- gradient background -->
<div class="bg-primary bg-gradient text-white p-3">
  Gradient background
</div>

<!-- opacity -->
<div class="text-primary text-opacity-50">50% opacity text</div>
<div class="bg-primary bg-opacity-50">50% opacity bg</div>

<!-- text color with background theme -->
<div class="text-bg-primary">Primary (auto text color)</div>

Display와 Flexbox

d-*는 display 프로퍼티를 설정합니다(d-none은 숨김). 반응형 d-{breakpoint}-*는 브레이크포인트에서 display를 바꿉니다 — d-none d-md-block은 모바일 숨김, 데스크톱 표시입니다. d-flex가 flexbox를 켜고, flex-direction, justify-content-*, align-items-*, flex-wrap이 flex 레이아웃을 제어합니다. 이 유틸리티들로 레이아웃 커스텀 CSS 대부분을 대체합니다. d-md-flex는 md 이상에서만 flex를 켭니다. 미디어 쿼리 없이 복잡한 반응형 레이아웃을 조합할 수 있습니다.

bootstrap
<!-- display utilities -->
<div class="d-none">display: none</div>
<div class="d-inline">display: inline</div>
<div class="d-inline-block">display: inline-block</div>
<div class="d-block">display: block</div>
<div class="d-flex">display: flex</div>
<div class="d-inline-flex">display: inline-flex</div>

<!-- responsive display -->
<div class="d-none d-md-block">Hidden on mobile, block on md+</div>
<div class="d-block d-md-none">Visible only below md</div>

<!-- flex direction -->
<div class="d-flex flex-column">Column</div>
<div class="d-flex flex-row-reverse">Reversed row</div>

<!-- justify content -->
<div class="d-flex justify-content-center">Center</div>
<div class="d-flex justify-content-between">Space between</div>
<div class="d-flex justify-content-around">Space around</div>

<!-- align items -->
<div class="d-flex align-items-center">Vertically centered</div>
<div class="d-flex align-items-end">Bottom aligned</div>

<!-- flex wrap -->
<div class="d-flex flex-wrap">Wrap</div>
<div class="d-flex flex-nowrap">No wrap</div>

Position과 float

position-*가 CSS position을 설정합니다. position-sticky와 top-0로 sticky 헤더를 만듭니다(스크롤 시 붙음). top/bottom/start/end(0 또는 50%)가 inset을 설정합니다. translate-middle이 요소를 가운데 정렬합니다(top-50 start-50과 조합하면 완벽한 중앙). float(float-start/end)은 레거시입니다 — 레이아웃에는 flexbox를 사용하세요. clearfix가 float된 자식을 정리합니다. fixed-top/fixed-bottom은 뷰포트에 고정합니다. 내비바에는 처음에 콘텐츠를 겹치지 않는 sticky가 fixed보다 선호됩니다.

bootstrap
<!-- position -->
<div class="position-static">Static (default)</div>
<div class="position-relative">Relative (offset parent)</div>
<div class="position-absolute">Absolute</div>
<div class="position-fixed">Fixed (viewport)</div>
<div class="position-sticky top-0">Sticky (sticks at top)</div>

<!-- positioning with insets -->
<div class="position-absolute top-0 start-0">Top-left</div>
<div class="position-absolute top-0 end-0">Top-right</div>
<div class="position-absolute bottom-0 start-50">Bottom-center</div>

<!-- center with translate -->
<div class="position-absolute top-50 start-50 translate-middle">
  Perfectly centered
</div>

<!-- floats (use flexbox instead when possible) -->
<div class="float-start">Float left</div>
<div class="float-end">Float right</div>
<div class="clearfix">Clear floats</div>

<!-- fixed top/bottom -->
<div class="fixed-top">Pinned to top</div>
<div class="fixed-bottom">Pinned to bottom</div>

테두리, 그림자, Radius

border는 특정 면의 테두리를 추가/제거합니다. border-{color}가 색을, border-{1-5}가 폭을 정합니다. rounded-*가 border-radius를 조절합니다: rounded-0(없음), rounded(기본), rounded-3(더 큼), rounded-pill(캡슐), rounded-circle(50%). rounded-{side}는 특정 모서리만 둥글게 합니다. shadow-*가 box-shadow를 추가합니다: none, sm, 기본, lg. 그림자는 깊이를 더합니다 — 은은한 들뜸에는 shadow-sm, 모달/플로팅 요소에는 shadow-lg. 커스텀 CSS 없이 대부분의 시각 스타일링을 처리합니다.

bootstrap
<!-- borders -->
<div class="border">All borders</div>
<div class="border-top">Top only</div>
<div class="border border-0">No borders</div>
<div class="border-top-0">Remove top</div>

<!-- border color -->
<div class="border border-primary">Primary border</div>
<div class="border border-danger">Danger border</div>

<!-- border width -->
<div class="border border-2">2px border</div>
<div class="border border-4">4px border</div>

<!-- border radius -->
<div class="rounded">Default radius</div>
<div class="rounded-0">No radius</div>
<div class="rounded-3">Larger radius</div>
<div class="rounded-pill">Pill shape</div>
<div class="rounded-circle">Circle</div>
<div class="rounded-top">Top corners only</div>

<!-- shadows -->
<div class="shadow-none">No shadow</div>
<div class="shadow-sm">Small shadow</div>
<div class="shadow">Regular shadow</div>
<div class="shadow-lg">Large shadow</div>
15

이미지와 Figure

반응형 이미지

img-fluid는 이미지를 반응형으로 만듭니다(max-width: 100%, height: auto) — 컨테이너를 넘치지 않습니다. w-100은 전체 폭을 강제합니다. figure/figure-img/figure-caption은 시맨틱한 이미지+캡션을 제공합니다(div + p보다 좋음). float-start/end가 이미지를 정렬하고, mx-auto d-block이 가운데 정렬합니다. rounded가 모서리를 둥글게 합니다. 접근성을 위해 항상 alt 텍스트를 넣으세요 — 스크린 리더용 이미지 설명입니다. 장식 이미지는 alt=''를 사용하세요.

bootstrap
<!-- responsive image (scales with parent) -->
<img src="photo.jpg" class="img-fluid" alt="Responsive image">
<!-- max-width: 100%; height: auto; -->

<!-- full-width image -->
<img src="banner.jpg" class="img-fluid w-100" alt="Banner">

<!-- image with figure -->
<figure class="figure">
  <img src="photo.jpg" class="figure-img img-fluid rounded" alt="...">
  <figcaption class="figure-caption text-end">
    A caption for the image.
  </figcaption>
</figure>

<!-- image alignment -->
<img src="..." class="rounded float-start" alt="Left">
<img src="..." class="rounded float-end" alt="Right">
<img src="..." class="rounded mx-auto d-block" alt="Centered">

<!-- center with text-center on parent -->
<div class="text-center">
  <img src="..." class="rounded" alt="Centered">
</div>

이미지 모양과 썸네일

이미지 모양: rounded(둥근 모서리), rounded-circle(원형 — 정사각형 이미지에 가장 좋음), rounded-pill(캡슐). img-thumbnail은 테두리, 패딩, 둥근 모서리를 추가합니다 — 사진 인화지 느낌입니다. 원형 썸네일은 img-thumbnail과 rounded-circle을 조합하세요. 아바타는 공간을 확보하고 레이아웃 시프트를 막으려고 명시적 width/height를 설정하세요. 모양 클래스는 이미지뿐 아니라 어떤 요소에도 동작합니다 — 동영상 썸네일이나 프로필 사진에도 유용합니다.

bootstrap
<!-- rounded corners -->
<img src="..." class="rounded" alt="Rounded">

<!-- fully rounded (circle) -->
<img src="..." class="rounded-circle" alt="Circle">

<!-- thumbnail (border + padding) -->
<img src="..." class="img-thumbnail" alt="Thumbnail">
<!-- adds padding, border, rounded corners -->

<!-- pill shape -->
<img src="..." class="rounded-pill" alt="Pill">

<!-- combination: thumbnail + circle -->
<img src="..." class="img-thumbnail rounded-circle" alt="Circle thumb">

<!-- avatar sizes (set width/height) -->
<img src="avatar.jpg" class="rounded-circle" width="40" height="40" alt="Avatar">
<img src="avatar.jpg" class="rounded-circle" width="100" height="100" alt="Large avatar">

Figure와 캡션

figure는 캡션이 있는 이미지의 시맨틱 HTML 요소입니다 — div보다 접근성이 좋습니다. figure-img는 이미지를 스타일링합니다(img-fluid와 rounded와 조합). figure-caption은 캡션 텍스트를 스타일링합니다(기본 muted). text-start/center/end가 캡션을 정렬합니다. 클릭 시 확대되게 하려면 이미지를 <a>로 감싸세요. figure는 편집 콘텐츠, 문서, 갤러리에 올바른 시맨틱 선택입니다.

bootstrap
<!-- figure with caption -->
<figure class="figure">
  <img src="photo.jpg" class="figure-img img-fluid rounded" alt="Photo">
  <figcaption class="figure-caption">
    Caption describing the image.
  </figcaption>
</figure>

<!-- right-aligned caption -->
<figure class="figure">
  <img src="photo.jpg" class="figure-img img-fluid rounded" alt="Photo">
  <figcaption class="figure-caption text-end">
    Right-aligned caption.
  </figcaption>
</figure>

<!-- centered caption -->
<figcaption class="figure-caption text-center">Centered</figcaption>

<!-- figure with link -->
<figure class="figure">
  <a href="full-size.jpg">
    <img src="thumb.jpg" class="figure-img img-fluid rounded" alt="Click to enlarge">
  </a>
  <figcaption class="figure-caption">Click to view full size</figcaption>
</figure>

배경 이미지

Bootstrap에는 배경 이미지 유틸리티가 없습니다(이미지는 콘텐츠 의존적) — 인라인 스타일을 사용하세요. background-size: cover는 왜곡 없이 컨테이너를 채우고, background-position: center는 중앙에 초점을 맞춥니다. 이미지 위 텍스트는 가독성을 위해 그라데이션 오버레이(아래쪽 어둡게)를 추가하세요. position-relative 래퍼에 position-absolute 레이어를 쌓아 이미지, 오버레이, 텍스트를 겹칩니다. 히어로 섹션과 이미지 카드의 패턴입니다.

bootstrap
<!-- background image via inline style -->
<div style="background-image: url('bg.jpg');
            background-size: cover;
            background-position: center;
            height: 400px;">
  <div class="d-flex align-items-center justify-content-center h-100">
    <h1 class="text-white">Hero text over image</h1>
  </div>
</div>

<!-- parallax-like fixed background -->
<div style="background-image: url('bg.jpg');
            background-attachment: fixed;
            background-size: cover;
            height: 300px;">
</div>

<!-- gradient overlay for text readability -->
<div class="position-relative">
  <img src="bg.jpg" class="img-fluid" alt="">
  <div class="position-absolute top-0 start-0 w-100 h-100"
       style="background: linear-gradient(to bottom, transparent, rgba(0,0,0,0.7));">
  </div>
  <div class="position-absolute bottom-0 start-0 p-4 text-white">
    <h2>Text over gradient</h2>
  </div>
</div>

이미지 그리드와 갤러리

이미지 그리드는 표준 row/col 시스템에 거터는 g-*를 사용합니다. 종횡비와 무관하게 같은 높이의 이미지는 고정 높이 컨테이너에 img에 object-fit: cover와 w-100 h-100을 적용하세요. row-cols-*는 각 항목에 col-*를 지정하지 않고 균등 폭 열을 만듭니다. 진짜 매스너리(가변 높이, 빈틈 없음)는 CSS columns나 JavaScript 라이브러리가 필요합니다 — Bootstrap 그리드는 매스너리를 기본 지원하지 않습니다. img-fluid는 이미지가 그리드 셀을 넘치지 않게 합니다.

bootstrap
<!-- responsive image grid -->
<div class="row g-2">
  <div class="col-6 col-md-4">
    <img src="1.jpg" class="img-fluid rounded" alt="">
  </div>
  <div class="col-6 col-md-4">
    <img src="2.jpg" class="img-fluid rounded" alt="">
  </div>
  <div class="col-6 col-md-4">
    <img src="3.jpg" class="img-fluid rounded" alt="">
  </div>
  <div class="col-6 col-md-4">
    <img src="4.jpg" class="img-fluid rounded" alt="">
  </div>
</div>

<!-- equal-height images with object-fit -->
<div class="row g-3">
  <div class="col-md-4">
    <div style="height: 200px;">
      <img src="tall.jpg" class="w-100 h-100"
           style="object-fit: cover;" alt="">
    </div>
  </div>
</div>

<!-- masonry-like with columns -->
<div class="row row-cols-1 row-cols-md-3 g-3">
  <div class="col"><img src="1.jpg" class="img-fluid rounded"></div>
  <div class="col"><img src="2.jpg" class="img-fluid rounded"></div>
</div>
17

Collapse와 아코디언

기본 Collapse

Collapse는 높이 애니메이션으로 요소 가시성을 토글합니다. 트리거: data-bs-toggle='collapse'와 접히는 요소의 id를 가리키는 data-bs-target(버튼)이나 href(앵커). .collapse는 숨김, .collapse.show는 표시입니다. 트리거의 aria-expanded가 상태를 반영하고, aria-controls가 트리거와 대상을 연결합니다. 동작에는 버튼, 내비게이션에는 앵커를 사용하세요. 애니메이션은 높이를 0에서 auto로 부드럽게 전환합니다.

bootstrap
<!-- collapse trigger (button) -->
<p>
  <button class="btn btn-primary" type="button"
          data-bs-toggle="collapse" data-bs-target="#collapseExample"
          aria-expanded="false" aria-controls="collapseExample">
    Toggle collapse
  </button>
</p>
<div class="collapse" id="collapseExample">
  <div class="card card-body">
    This content is hidden by default and shown when the button is clicked.
  </div>
</div>

<!-- collapse via anchor -->
<a class="btn btn-primary" data-bs-toggle="collapse"
   href="#collapseExample2" role="button" aria-expanded="false"
   aria-controls="collapseExample2">
  Link trigger
</a>
<div class="collapse" id="collapseExample2">
  <div class="card card-body">Content</div>
</div>

<!-- shown by default -->
<div class="collapse show" id="alwaysShown">
  <div class="card card-body">Shown initially</div>
</div>

아코디언

아코디언은 data-bs-parent가 한 번에 하나만 열리게 보장하는 collapse 그룹입니다(하나를 열면 다른 것이 닫힘). 구조: accordion > accordion-item > accordion-header(accordion-button 포함) + accordion-collapse(accordion-body 포함). 첫 항목에 'show' 클래스를 주면 펼쳐진 상태로 시작합니다. 버튼의 'collapsed' 클래스가 접힌 상태를 나타냅니다(화살표 회전). aria-expanded와 aria-controls는 접근성에 필수입니다. parent 속성이 단독 열림 동작을 만듭니다.

bootstrap
<div class="accordion" id="accordionExample">
  <div class="accordion-item">
    <h2 class="accordion-header" id="headingOne">
      <button class="accordion-button" type="button"
              data-bs-toggle="collapse" data-bs-target="#collapseOne"
              aria-expanded="true" aria-controls="collapseOne">
        Accordion Item #1
      </button>
    </h2>
    <div id="collapseOne" class="accordion-collapse collapse show"
         aria-labelledby="headingOne" data-bs-parent="#accordionExample">
      <div class="accordion-body">
        <strong>First item content.</strong> Shown by default.
      </div>
    </div>
  </div>

  <div class="accordion-item">
    <h2 class="accordion-header" id="headingTwo">
      <button class="accordion-button collapsed" type="button"
              data-bs-toggle="collapse" data-bs-target="#collapseTwo"
              aria-expanded="false" aria-controls="collapseTwo">
        Accordion Item #2
      </button>
    </h2>
    <div id="collapseTwo" class="accordion-collapse collapse"
         aria-labelledby="headingTwo" data-bs-parent="#accordionExample">
      <div class="accordion-body">
        <strong>Second item content.</strong>
      </div>
    </div>
  </div>
</div>

아코디언 Flush와 변형

accordion-flush는 바깥 테두리와 배경을 제거합니다 — 이중 테두리 없이 카드나 컨테이너에 통합할 때. collapse 항목에 data-bs-parent가 없으면 여러 섹션이 동시에 열려 있을 수 있습니다(항상 열림 모드). data-bs-parent가 있으면 하나를 열면 다른 것이 닫힙니다(표준 아코디언). UX에 따라 고르세요: FAQ처럼 하나씩 읽는 곳에는 단독 열림, 섹션을 비교하는 내비게이션이나 설정에는 다중 열림.

bootstrap
<!-- flush (no borders, no background) -->
<div class="accordion accordion-flush" id="accordionFlush">
  <div class="accordion-item">
    <h2 class="accordion-header">
      <button class="accordion-button collapsed" data-bs-toggle="collapse"
              data-bs-target="#flush1">
        Item #1
      </button>
    </h2>
    <div id="flush1" class="accordion-collapse collapse">
      <div class="accordion-body">Flush content</div>
    </div>
  </div>
</div>
<!-- flush removes outer borders and background -->

<!-- always-open (no exclusive behavior) -->
<div class="accordion" id="accordionAlwaysOpen">
  <div class="accordion-item">
    <h2 class="accordion-header">
      <button class="accordion-button" data-bs-toggle="collapse"
              data-bs-target="#open1">
        Item #1
      </button>
    </h2>
    <div id="open1" class="accordion-collapse collapse show">
      <!-- no data-bs-parent = stays open when others open -->
      <div class="accordion-body">Content</div>
    </div>
  </div>
</div>

JavaScript로 Collapse 제어

JS로 collapse를 제어합니다: new bootstrap.Collapse(el, options). toggle: false는 초기화 시 자동 토글을 막습니다. parent: 셀렉터는 아코디언 동작(형제 닫기)을 만듭니다. 메서드: show(), hide(), toggle(), dispose(). 이벤트: show/shown/hide/hidden.bs.collapse — input 포커스나 aria 갱신 같은 애니메이션 후 동작에는 shown/hidden(과거형)을 사용하세요. URL 해시나 폼 상태에 따라 섹션을 펼치는 등의 프로그래밍 방식 제어에 유용합니다.

bootstrap
<div class="collapse" id="jsCollapse">
  <div class="card card-body">Content</div>
</div>

<script>
const collapseEl = document.getElementById('jsCollapse')
const collapse = new bootstrap.Collapse(collapseEl, {
  toggle: false,      // don't toggle on init
  parent: null        // or selector for accordion behavior
})

// methods
collapse.show()
collapse.hide()
collapse.toggle()

// dispose (removes instance)
collapse.dispose()

// events
collapseEl.addEventListener('show.bs.collapse', () => {
  console.log('about to show')
})
collapseEl.addEventListener('shown.bs.collapse', () => {
  console.log('fully shown')
})
collapseEl.addEventListener('hide.bs.collapse', () => {
  console.log('about to hide')
})
collapseEl.addEventListener('hidden.bs.collapse', () => {
  console.log('fully hidden')
})
</script>

다중 대상 Collapse

data-bs-target은 CSS 셀렉터를 받으므로 하나의 트리거가 여러 요소를 토글할 수 있습니다 — 공유 클래스(.multi-collapse)로 모두를 대상으로 하세요. 반대로 여러 트리거가 같은 대상을 제어할 수도 있습니다(각각 data-bs-target='#shared'). 여러 섹션을 제어하는 '모두 보기' / '모두 숨기기' 버튼이나, 다른 위치의 다른 버튼이 같은 패널을 제어하는 반응형 레이아웃에 유용합니다. 셀렉터 방식은 매우 유연합니다.

bootstrap
<!-- one trigger toggles multiple targets -->
<p>
  <button class="btn btn-primary" data-bs-toggle="collapse"
          data-bs-target=".multi-collapse" aria-expanded="false">
    Toggle both
  </button>
</p>

<div class="row">
  <div class="col">
    <div class="collapse multi-collapse" id="first">
      <div class="card card-body">First block</div>
    </div>
  </div>
  <div class="col">
    <div class="collapse multi-collapse" id="second">
      <div class="card card-body">Second block</div>
    </div>
  </div>
</div>

<!-- multiple triggers control one target -->
<button class="btn btn-primary" data-bs-toggle="collapse"
        data-bs-target="#shared">Show A</button>
<button class="btn btn-secondary" data-bs-toggle="collapse"
        data-bs-target="#shared">Show B</button>
<div class="collapse" id="shared">
  <div class="card card-body">Shared content</div>
</div>
19

아이콘과 접근성

Bootstrap Icons

Bootstrap Icons는 별도 아이콘 라이브러리입니다(CSS에 포함되지 않음). CSS를 포함한 후 <i class='bi bi-{name}'></i>를 사용하세요. 아이콘 크기는 fs-*(font-size) 유틸리티로, 색은 text-* 클래스로 지정합니다. 버튼의 아이콘은 시각 단서로 UX를 개선합니다. 아이콘 전용 버튼에는 반드시 aria-label이 필요합니다 — 없으면 버튼에 접근 가능한 이름이 없습니다. icons.getbootstrap.com에서 아이콘을 탐색하세요. 아이콘은 SVG 폰트라 어떤 크기에서도 선명합니다.

bootstrap
<!-- Bootstrap Icons (separate from CSS framework) -->
<link rel="stylesheet"
      href="https://cdn.jsdelivr.net/npm/[email protected]/font/bootstrap-icons.css">

<!-- usage: <i class="bi bi-{name}"></i> -->
<i class="bi bi-alarm"></i>
<i class="bi bi-arrow-right"></i>
<i class="bi bi-check-circle"></i>
<i class="bi bi-github"></i>

<!-- sizing with utility classes -->
<i class="bi bi-star fs-1"></i>  <!-- font-size 1 -->
<i class="bi bi-star fs-3"></i>
<i class="bi bi-star fs-6"></i>

<!-- colored icons -->
<i class="bi bi-exclamation-triangle text-warning fs-3"></i>
<i class="bi bi-check-circle text-success fs-3"></i>

<!-- icon in a button -->
<button class="btn btn-primary">
  <i class="bi bi-download"></i> Download
</button>

<!-- icon-only button (needs aria-label) -->
<button class="btn btn-link" aria-label="Search">
  <i class="bi bi-search"></i>
</button>

접근성: ARIA와 role

Bootstrap 컴포넌트는 ARIA 속성을 포함하지만 커스텀 컨트롤에는 직접 추가해야 합니다. aria-label은 아이콘 전용 버튼에 이름을 줍니다. aria-labelledby는 다른 요소의 id를 레이블로 참조합니다. aria-describedby는 도움말 텍스트를 가리킵니다. aria-expanded는 토글 상태(true/false)를 반영합니다. aria-current='page'는 현재 내비 항목을 표시합니다. 암묵적 ARIA role을 가진 시맨틱 HTML(nav, main, aside, header, footer)을 사용하세요 — div에 role을 붙이는 것보다 좋습니다.

bootstrap
<!-- landmark roles (use semantic HTML) -->
<nav role="navigation">...</nav>
<main role="main">...</main>
<aside role="complementary">...</aside>
<footer role="contentinfo">...</footer>

<!-- aria-label for unlabeled controls -->
<button aria-label="Close" class="btn-close"></button>
<button aria-label="Search" class="btn"><i class="bi bi-search"></i></button>

<!-- aria-labelledby (reference another element) -->
<div role="dialog" aria-labelledby="modalTitle">
  <h2 id="modalTitle">Modal Heading</h2>
</div>

<!-- aria-describedby (descriptive text) -->
<input aria-describedby="emailHelp" id="email">
<small id="emailHelp">We'll never share your email.</small>

<!-- aria-expanded for toggles -->
<button aria-expanded="false" data-bs-toggle="collapse">
  Toggle
</button>

<!-- aria-current for current page -->
<a aria-current="page" class="nav-link active">Home</a>

visually-hidden과 스크린 리더

visually-hidden은 콘텐츠를 시각적으로 숨기지만 스크린 리더용으로 유지합니다 — 아이콘 전용 버튼의 레이블이나 추가 맥락에 사용하세요. visually-hidden-focusable은 키보드 포커스 전까지 숨겨집니다(Tab으로 이동할 때 나타나는 '본문으로 건너뛰기' 링크에 완벽). aria-hidden='true'는 반대입니다: 보이지만 알리지 않습니다(장식 요소용). 키보드 접근성을 위해 건너뛰기 링크를 첫 포커스 가능 요소로 제공하세요. WCAG 준수에 필수입니다.

bootstrap
<!-- visually hidden (hidden visually, read by screen readers) -->
<span class="visually-hidden">This text is read by screen readers</span>

<!-- for icon-only buttons -->
<button class="btn btn-primary" aria-label="Search">
  <i class="bi bi-search"></i>
  <span class="visually-hidden">Search</span>
</button>

<!-- skip link (keyboard users skip to content) -->
<a href="#main-content" class="visually-hidden-focusable">
  Skip to main content
</a>

<!-- visually-hidden-focusable: hidden until focused -->
<!-- useful for skip links that appear on Tab -->

<!-- main content target -->
<main id="main-content">
  <!-- skip link jumps here -->
</main>

<!-- hide from screen readers only (still visible) -->
<div aria-hidden="true">
  Decorative content (not announced)
</div>

모션 감소와 다크 모드

다크 모드: <html>에 data-bs-theme='dark'를 설정하세요 — Bootstrap이 CSS 변수를 교체합니다. JS로 속성을 바꿔 토글합니다. matchMedia('(prefers-color-scheme: dark)')로 시스템 선호를 존중합니다. 모션 감소의 경우 사용자가 prefers-reduced-motion: reduce를 설정하면 Bootstrap이 대부분의 애니메이션을 자동 비활성화합니다. 더 줄이려면 추가 규칙을 넣을 수 있습니다. 사용자의 테마 선호는 localStorage에 저장하세요. 이 기능들은 모든 사용자가 접근 가능하고 편안한 사이트를 만듭니다.

bootstrap
<!-- dark mode via data attribute -->
<html data-bs-theme="dark">
  <!-- entire page in dark mode -->
</html>

<!-- toggle dark mode via JS -->
<button id="themeToggle">Toggle theme</button>
<script>
const html = document.documentElement
const current = html.getAttribute('data-bs-theme')
html.setAttribute('data-bs-theme', current === 'dark' ? 'light' : 'dark')
</script>

<!-- respect system preference -->
<script>
if (window.matchMedia('(prefers-color-scheme: dark)').matches) {
  document.documentElement.setAttribute('data-bs-theme', 'dark')
}
</script>

<!-- reduced motion: Bootstrap respects this automatically -->
@media (prefers-reduced-motion: reduce) {
  /* Bootstrap disables transitions and animations */
  /* but you can add more */
  .carousel {
    transition: none;
  }
}

포커스 관리와 키보드

대안을 제공하지 않고 포커스 아웃라인(outline: none)을 제거하지 마세요 — 키보드 사용자에게 필요합니다. Bootstrap의 focus-visible은 마우스가 아닌 키보드 포커스에만 링을 보여 줍니다. 모달은 표시 시 포커스를 모달로 옮기고, 숨김 시 트리거로 돌려야 합니다. 커스텀 위젯(탭, 메뉴)은 화살표 키 내비게이션이 필요합니다 — 화살표 키, Enter, Space, Escape의 keydown 핸들러를 구현하세요. 올바른 tabindex 관리(포커스 가능하면 0, 프로그래밍 방식이면 -1)가 논리적 탭 순서를 보장합니다. 키보드 전용 사용자에게 필수입니다.

bootstrap
<!-- visible focus (don't remove outlines!) -->
<!-- Bootstrap provides focus-visible styling -->
<button class="btn btn-primary">Has visible focus ring</button>

<!-- skip link (first focusable element) -->
<body>
  <a href="#main" class="visually-hidden-focusable">Skip to content</a>
  <nav>...</nav>
  <main id="main">...</main>
</body>

<!-- focus management for modals -->
<script>
const modal = document.getElementById('myModal')
modal.addEventListener('shown.bs.modal', () => {
  // focus first input in modal
  modal.querySelector('input')?.focus()
})
modal.addEventListener('hidden.bs.modal', () => {
  // return focus to trigger
  document.getElementById('openModalBtn').focus()
})
</script>

<!-- keyboard navigation for custom widgets -->
<div role="tablist">
  <button role="tab" tabindex="0">Tab 1</button>
  <button role="tab" tabindex="-1">Tab 2</button>
</div>
<script>
// arrow key navigation
document.querySelectorAll('[role="tab"]').forEach((tab, i, tabs) => {
  tab.addEventListener('keydown', (e) => {
    if (e.key === 'ArrowRight') tabs[(i + 1) % tabs.length].focus()
    if (e.key === 'ArrowLeft') tabs[(i - 1 + tabs.length) % tabs.length].focus()
  })
})
</script>
20

리스트 그룹

기본 리스트 그룹

list-group은 일련의 콘텐츠를 표시하는 유연한 컴포넌트입니다. list-group-item이 각 항목을 스타일링합니다. active가 현재 항목을 표시하고, disabled가 회색으로 만듭니다(접근성을 위해 aria-disabled='true' 사용). 리스트 그룹은 대시보드, 설정, 수신함 항목 같은 관련 콘텐츠 목록에 스타일된 div보다 시맨틱합니다. 내비게이션 목록에는 <ul>/<li>를, 목록이 아닌 콘텐츠에는 <div>를 사용하세요.

bootstrap
<!-- basic list group -->
<ul class="list-group">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
  <li class="list-group-item">A fourth item</li>
  <li class="list-group-item">A disabled item</li>
</ul>

<!-- with active item -->
<ul class="list-group">
  <li class="list-group-item active" aria-current="true">Active item</li>
  <li class="list-group-item">Regular item</li>
</ul>

<!-- disabled item -->
<ul class="list-group">
  <li class="list-group-item disabled" aria-disabled="true">Disabled</li>
</ul>

링크와 버튼이 있는 리스트 그룹

동작 가능한 목록 항목(클릭 가능)에는 <a>나 <button> 요소에 list-group-item-action을 사용하세요. hover와 포커스 상태가 추가됩니다. 내비게이션에는 <a>(href와 함께), 동작에는 <button type='button'>을 사용합니다. 링크는 .disabled 클래스(및 aria-disabled)로, 버튼은 disabled 속성으로 비활성화합니다. 동작 가능한 항목에 <li>를 쓰지 마세요 — <ul> 안의 <a>/<button>은 덜 시맨틱하므로 list-group 래퍼로 <div>를 사용하세요.

bootstrap
<!-- list group with links (actionable items) -->
<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action active"
     aria-current="true">
    Active link item
  </a>
  <a href="#" class="list-group-item list-group-item-action">Link item</a>
  <a href="#" class="list-group-item list-group-item-action">Another link</a>
  <a class="list-group-item list-group-item-action disabled">Disabled link</a>
</div>

<!-- with buttons instead of links -->
<div class="list-group">
  <button type="button" class="list-group-item list-group-item-action active">
    Button item
  </button>
  <button type="button" class="list-group-item list-group-item-action">
    Another button
  </button>
</div>

<!-- note: use list-group-item-action for hover/focus states -->

리스트 그룹 Flush와 번호

list-group-flush는 테두리와 둥근 모서리를 제거합니다 — 이중 테두리 없이 카드나 컨테이너 안에 넣을 때. list-group-numbered(<ol>에)는 CSS 카운터로 자동 번호를 추가합니다. list-group-horizontal은 항목을 나란히 놓고, 반응형 변형(list-group-horizontal-md)은 브레이크포인트에서 가로로 전환합니다. 가로 목록은 작은 내비게이션이나 필터 바에 유용합니다. 번호 목록은 단계별 지침이나 순위에 좋습니다.

bootstrap
<!-- flush (no borders, no background, edge-to-edge) -->
<ul class="list-group list-group-flush">
  <li class="list-group-item">Flush item 1</li>
  <li class="list-group-item">Flush item 2</li>
  <li class="list-group-item">Flush item 3</li>
</ul>
<!-- removes outer borders and rounded corners -->

<!-- numbered list group (ordered) -->
<ol class="list-group list-group-numbered">
  <li class="list-group-item">First item</li>
  <li class="list-group-item">Second item</li>
  <li class="list-group-item">Third item</li>
</ol>
<!-- CSS counters add the numbers automatically -->

<!-- horizontal list group -->
<ul class="list-group list-group-horizontal">
  <li class="list-group-item">Item 1</li>
  <li class="list-group-item">Item 2</li>
  <li class="list-group-item">Item 3</li>
</ul>

<!-- responsive horizontal -->
<ul class="list-group list-group-horizontal-md">
  <!-- horizontal at md+, vertical below -->
</ul>

컨텍스트 색상과 배지가 있는 리스트 그룹

컨텍스트 클래스(list-group-item-{color})는 상태 표시를 위해 항목을 물들입니다 — 의미 있게 사용하세요(success=완료, danger=오류). 목록 항목 안의 배지는 d-flex justify-content-between align-items-center로 오른쪽에 밀고 세로 중앙 정렬합니다. rounded-pill 배지가 개수 표시에 모던해 보입니다. 이 패턴이 전통적인 수신함/알림 목록입니다: 왼쪽 레이블, 오른쪽 개수. flex 유틸리티가 커스텀 CSS 없이 정렬을 처리합니다.

bootstrap
<!-- contextual color items -->
<ul class="list-group">
  <li class="list-group-item list-group-item-primary">Primary item</li>
  <li class="list-group-item list-group-item-secondary">Secondary</li>
  <li class="list-group-item list-group-item-success">Success</li>
  <li class="list-group-item list-group-item-danger">Danger</li>
  <li class="list-group-item list-group-item-warning">Warning</li>
  <li class="list-group-item list-group-item-info">Info</li>
  <li class="list-group-item list-group-item-light">Light</li>
  <li class="list-group-item list-group-item-dark">Dark</li>
</ul>

<!-- with badges (counts aligned right) -->
<ul class="list-group">
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Messages
    <span class="badge bg-primary rounded-pill">14</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Notifications
    <span class="badge bg-danger rounded-pill">3</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Spam
    <span class="badge bg-warning text-dark rounded-pill">1</span>
  </li>
</ul>

커스텀 콘텐츠가 있는 리스트 그룹

목록 항목은 풍부한 콘텐츠를 담을 수 있습니다: 제목(fw-bold), 설명(text-muted), 메타데이터(small), 배지. 콘텐츠와 배지 배치에는 d-flex justify-content-between align-items-start를 사용하세요. me-auto가 배지를 오른쪽으로 밉니다. 목록 항목의 체크박스/라디오는 form-check-input과 짝지은 form-check-label을 사용하세요 — 선택 가능한 목록이 됩니다. 흔한 용도: 각 항목에 제목, 설명, 상태가 있는 메일 목록, 설정 패널, 검색 결과.

bootstrap
<!-- rich content list item -->
<ul class="list-group">
  <li class="list-group-item d-flex justify-content-between align-items-start">
    <div class="ms-2 me-auto">
      <div class="fw-bold">Subheading</div>
      <p class="mb-0 text-muted">Descriptive text for the list item.</p>
      <small>Additional metadata</small>
    </div>
    <span class="badge bg-primary rounded-pill">New</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-start">
    <div class="ms-2 me-auto">
      <div class="fw-bold">Another item</div>
      <p class="mb-0">More content here.</p>
    </div>
    <span class="badge bg-secondary rounded-pill">3</span>
  </li>
</ul>

<!-- list group with checkbox/radio -->
<ul class="list-group">
  <li class="list-group-item">
    <input class="form-check-input me-1" type="checkbox" id="check1">
    <label class="form-check-label" for="check1">Checkbox item</label>
  </li>
  <li class="list-group-item">
    <input class="form-check-input me-1" type="radio" name="radio" id="radio1">
    <label class="form-check-label" for="radio1">Radio item</label>
  </li>
</ul>

Was this helpful?

Learning path

Learn from scratch

Learn this language from the ground up with structured lessons.