Перейти до основного вмісту Перейти до навігації документами
Check
in English

Таблиці

Документація та приклади оформлення таблиць (враховуючи їхнє поширене використання в плагінах JavaScript) за допомогою Bootstrap.

Огляд

Завдяки широкому використанню <table>елементів у сторонніх віджетах, таких як календарі та засоби вибору дати, таблиці Bootstrap доступні для вибору . Додайте базовий клас .tableдо будь-якого <table>, а потім розширте за допомогою наших додаткових класів-модифікаторів або власних стилів. Усі стилі таблиць не успадковуються в Bootstrap, тобто будь-які вкладені таблиці можуть бути стилізовані незалежно від батьківської.

Використовуючи найпростішу розмітку таблиць, ось як .tableвиглядають таблиці на базі Bootstrap.

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table">
  <thead>
    <tr>
      <th scope="col">#</th>
      <th scope="col">First</th>
      <th scope="col">Last</th>
      <th scope="col">Handle</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <th scope="row">1</th>
      <td>Mark</td>
      <td>Otto</td>
      <td>@mdo</td>
    </tr>
    <tr>
      <th scope="row">2</th>
      <td>Jacob</td>
      <td>Thornton</td>
      <td>@fat</td>
    </tr>
    <tr>
      <th scope="row">3</th>
      <td colspan="2">Larry the Bird</td>
      <td>@twitter</td>
    </tr>
  </tbody>
</table>

Варіанти

Використовуйте контекстні класи для розфарбовування таблиць, рядків таблиць або окремих клітинок.

Клас Заголовок Заголовок
За замовчуванням Стільниковий Стільниковий
Первинний Стільниковий Стільниковий
Вторинний Стільниковий Стільниковий
Успіх Стільниковий Стільниковий
Небезпека Стільниковий Стільниковий
УВАГА Стільниковий Стільниковий
Інформація Стільниковий Стільниковий
світло Стільниковий Стільниковий
Темний Стільниковий Стільниковий
<!-- On tables -->
<table class="table-primary">...</table>
<table class="table-secondary">...</table>
<table class="table-success">...</table>
<table class="table-danger">...</table>
<table class="table-warning">...</table>
<table class="table-info">...</table>
<table class="table-light">...</table>
<table class="table-dark">...</table>

<!-- On rows -->
<tr class="table-primary">...</tr>
<tr class="table-secondary">...</tr>
<tr class="table-success">...</tr>
<tr class="table-danger">...</tr>
<tr class="table-warning">...</tr>
<tr class="table-info">...</tr>
<tr class="table-light">...</tr>
<tr class="table-dark">...</tr>

<!-- On cells (`td` or `th`) -->
<tr>
  <td class="table-primary">...</td>
  <td class="table-secondary">...</td>
  <td class="table-success">...</td>
  <td class="table-danger">...</td>
  <td class="table-warning">...</td>
  <td class="table-info">...</td>
  <td class="table-light">...</td>
  <td class="table-dark">...</td>
</tr>
Передача значення допоміжним технологіям

Використання кольору для додання значення забезпечує лише візуальну індикацію, яка не буде передана користувачам допоміжних технологій, таких як програми зчитування з екрана. Переконайтеся, що інформація, позначена кольором, або очевидна з самого вмісту (наприклад, видимого тексту), або включена за допомогою альтернативних засобів, таких як додатковий текст, прихований разом із .visually-hiddenкласом.

Акцентні столи

Смугасті ряди

Використовуйте .table-stripedдля додавання смуг зебри до будь-якого рядка таблиці в <tbody>.

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-striped">
  ...
</table>

Смугасті колони

Використовуйте .table-striped-columnsдля додавання смуг зебри до будь-якого стовпця таблиці.

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-striped-columns">
  ...
</table>

Ці класи також можна додати до варіантів таблиці:

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-dark table-striped">
  ...
</table>
# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-dark table-striped-columns">
  ...
</table>
# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-success table-striped">
  ...
</table>
# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-success table-striped-columns">
  ...
</table>

Нависаючі ряди

Додайте .table-hover, щоб увімкнути стан наведення курсора на рядки таблиці в межах <tbody>.

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-hover">
  ...
</table>
# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-dark table-hover">
  ...
</table>

Ці височіючі ряди також можна комбінувати з варіантом смугастих рядів:

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-striped table-hover">
  ...
</table>

Активні таблиці

Виділіть рядок або клітинку таблиці, додавши .table-activeклас.

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table">
  <thead>
    ...
  </thead>
  <tbody>
    <tr class="table-active">
      ...
    </tr>
    <tr>
      ...
    </tr>
    <tr>
      <th scope="row">3</th>
      <td colspan="2" class="table-active">Larry the Bird</td>
      <td>@twitter</td>
    </tr>
  </tbody>
</table>
# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-dark">
  <thead>
    ...
  </thead>
  <tbody>
    <tr class="table-active">
      ...
    </tr>
    <tr>
      ...
    </tr>
    <tr>
      <th scope="row">3</th>
      <td colspan="2" class="table-active">Larry the Bird</td>
      <td>@twitter</td>
    </tr>
  </tbody>
</table>

Як працюють варіанти та таблиці акцентів?

Для таблиць із акцентами ( смугасті рядки , смугасті стовпці , наведені рядки та активні таблиці ) ми використали деякі методи, щоб ці ефекти працювали для всіх наших варіантів таблиць :

  • Ми починаємо з встановлення фону клітинки таблиці за допомогою --bs-table-bgспеціальної властивості. Потім усі варіанти таблиці встановлюють цю спеціальну властивість, щоб розфарбувати клітинки таблиці. Таким чином, ми не матимемо проблем, якщо напівпрозорі кольори використовуються як фон таблиці.
  • Потім ми додаємо тінь вставного поля до клітинок таблиці за допомогою box-shadow: inset 0 0 0 9999px var(--bs-table-accent-bg);шару поверх будь-якого вказаного background-color. Оскільки ми використовуємо великий розкид і відсутність розмиття, колір буде монотонним. Оскільки --bs-table-accent-bgза замовчуванням не встановлено, ми не маємо тіні вікна за замовчуванням.
  • Коли додаються класи .table-striped, .table-striped-columns, .table-hoverабо , для розфарбовування фону встановлюється напівпрозорий колір..table-active--bs-table-accent-bg
  • Для кожного варіанту таблиці ми створюємо --bs-table-accent-bgколір із найвищим контрастом залежно від цього кольору. Наприклад, колір акценту .table-primaryтемніший, а .table-darkколір акценту – світліший.
  • Кольори тексту та рамки генеруються однаково, і їхні кольори успадковуються за замовчуванням.

За кадром це виглядає так:

@mixin table-variant($state, $background) {
  .table-#{$state} {
    $color: color-contrast(opaque($body-bg, $background));
    $hover-bg: mix($color, $background, percentage($table-hover-bg-factor));
    $striped-bg: mix($color, $background, percentage($table-striped-bg-factor));
    $active-bg: mix($color, $background, percentage($table-active-bg-factor));
    $border-color: mix($color, $background, percentage($table-border-factor));

    --#{$prefix}table-color: #{$color};
    --#{$prefix}table-bg: #{$background};
    --#{$prefix}table-border-color: #{$border-color};
    --#{$prefix}table-striped-bg: #{$striped-bg};
    --#{$prefix}table-striped-color: #{color-contrast($striped-bg)};
    --#{$prefix}table-active-bg: #{$active-bg};
    --#{$prefix}table-active-color: #{color-contrast($active-bg)};
    --#{$prefix}table-hover-bg: #{$hover-bg};
    --#{$prefix}table-hover-color: #{color-contrast($hover-bg)};

    color: var(--#{$prefix}table-color);
    border-color: var(--#{$prefix}table-border-color);
  }
}

Межі таблиці

Облямовані столи

Додайте .table-borderedдля меж з усіх боків таблиці та комірок.

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-bordered">
  ...
</table>

Для зміни кольорів можна додати утиліти кольору рамки :

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-bordered border-primary">
  ...
</table>

Столи без бордюрів

Додайте .table-borderlessдля таблиці без рамок.

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-borderless">
  ...
</table>
# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-dark table-borderless">
  ...
</table>

Маленькі столики

Додайте .table-sm, щоб зробити .tableбільш компактним, розрізавши всю комірку paddingнавпіл.

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-sm">
  ...
</table>
# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-dark table-sm">
  ...
</table>

Роздільники груп столу

Додайте більш товсту, темнішу рамку між групами таблиць— <thead>, <tbody>і <tfoot>—за допомогою .table-group-divider. Налаштуйте колір, змінивши border-top-color(для якого наразі ми не надаємо службовий клас).

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
html
<table class="table">
  <thead>
    <tr>
      <th scope="col">#</th>
      <th scope="col">First</th>
      <th scope="col">Last</th>
      <th scope="col">Handle</th>
    </tr>
  </thead>
  <tbody class="table-group-divider">
    <tr>
      <th scope="row">1</th>
      <td>Mark</td>
      <td>Otto</td>
      <td>@mdo</td>
    </tr>
    <tr>
      <th scope="row">2</th>
      <td>Jacob</td>
      <td>Thornton</td>
      <td>@fat</td>
    </tr>
    <tr>
      <th scope="row">3</th>
      <td colspan="2">Larry the Bird</td>
      <td>@twitter</td>
    </tr>
  </tbody>
</table>

Вертикальне вирівнювання

Комірки таблиці <thead>завжди вертикально вирівняні донизу. Комірки таблиці <tbody>успадковують своє вирівнювання від <table>і за замовчуванням вирівнюються вгорі. Використовуйте класи вертикального вирівнювання , щоб повторно вирівняти, де це необхідно.

Заголовок 1 Заголовок 2 Заголовок 3 Заголовок 4
Ця комірка успадковується vertical-align: middle;від таблиці Ця комірка успадковується vertical-align: middle;від таблиці Ця комірка успадковується vertical-align: middle;від таблиці Це деякий текст-заповнювач, призначений для того, щоб зайняти трохи вертикального простору, щоб продемонструвати, як працює вертикальне вирівнювання в попередніх клітинках.
Ця клітинка успадковує vertical-align: bottom;рядок таблиці Ця клітинка успадковує vertical-align: bottom;рядок таблиці Ця клітинка успадковує vertical-align: bottom;рядок таблиці Це деякий текст-заповнювач, призначений для того, щоб зайняти трохи вертикального простору, щоб продемонструвати, як працює вертикальне вирівнювання в попередніх клітинках.
Ця комірка успадковується vertical-align: middle;від таблиці Ця комірка успадковується vertical-align: middle;від таблиці Ця комірка вирівнюється вгорі. Це деякий текст-заповнювач, призначений для того, щоб зайняти трохи вертикального простору, щоб продемонструвати, як працює вертикальне вирівнювання в попередніх клітинках.
<div class="table-responsive">
  <table class="table align-middle">
    <thead>
      <tr>
        ...
      </tr>
    </thead>
    <tbody>
      <tr>
        ...
      </tr>
      <tr class="align-bottom">
        ...
      </tr>
      <tr>
        <td>...</td>
        <td>...</td>
        <td class="align-top">This cell is aligned to the top.</td>
        <td>...</td>
      </tr>
    </tbody>
  </table>
</div>

Гніздування

Стилі меж, активні стилі та варіанти таблиць не успадковуються вкладеними таблицями.

# Спочатку Останній Ручка
1 Марк Отто @mdo
Заголовок Заголовок Заголовок
А Спочатку Останній
Б Спочатку Останній
C Спочатку Останній
3 Ларрі птах @twitter
<table class="table table-striped">
  <thead>
    ...
  </thead>
  <tbody>
    ...
    <tr>
      <td colspan="4">
        <table class="table mb-0">
          ...
        </table>
      </td>
    </tr>
    ...
  </tbody>
</table>

Як працює вкладення

Щоб запобігти витоку будь-яких> стилів у вкладені таблиці, ми використовуємо селектор дочірнього комбінатора ( ) у нашому CSS. Оскільки нам потрібно націлити всі tds і ths у thead, tbody, і tfoot, наш селектор виглядав би досить довгим без нього. Таким чином, ми використовуємо досить дивний .table > :not(caption) > * > *селектор для націлювання на всі tds і ths .table, але не на будь-яку потенційно вкладену таблицю.

Зауважте, що якщо ви додаєте <tr>s як прямі дочірні елементи таблиці, вони <tr>будуть загорнуті в a <tbody>за замовчуванням, таким чином наші селектори працюватимуть належним чином.

Анатомія

Голова столу

Подібно до таблиць і темних таблиць, використовуйте класи-модифікатори .table-lightабо .table-dark, щоб вони <thead>виглядали світло- або темно-сірими.

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Ларрі птах @twitter
<table class="table">
  <thead class="table-light">
    ...
  </thead>
  <tbody>
    ...
  </tbody>
</table>
# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Ларрі птах @twitter
<table class="table">
  <thead class="table-dark">
    ...
  </thead>
  <tbody>
    ...
  </tbody>
</table>

Ніжка столу

# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Ларрі птах @twitter
нижній колонтитул нижній колонтитул нижній колонтитул нижній колонтитул
<table class="table">
  <thead>
    ...
  </thead>
  <tbody>
    ...
  </tbody>
  <tfoot>
    ...
  </tfoot>
</table>

Підписи

A <caption>функціонує як заголовок для таблиці. Це допомагає користувачам із програмами зчитування з екрана знайти таблицю, зрозуміти, про що йдеться, і вирішити, чи хочуть вони її прочитати.

Список користувачів
# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Пташка Ларрі @twitter
<table class="table table-sm">
  <caption>List of users</caption>
  <thead>
    ...
  </thead>
  <tbody>
    ...
  </tbody>
</table>

Ви також можете розмістити <caption>на вершині таблиці за допомогою .caption-top.

Список користувачів
# Спочатку Останній Ручка
1 Марк Отто @mdo
2 Яків Торнтон @жирний
3 Ларрі птах @twitter
html
<table class="table caption-top">
  <caption>List of users</caption>
  <thead>
    <tr>
      <th scope="col">#</th>
      <th scope="col">First</th>
      <th scope="col">Last</th>
      <th scope="col">Handle</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <th scope="row">1</th>
      <td>Mark</td>
      <td>Otto</td>
      <td>@mdo</td>
    </tr>
    <tr>
      <th scope="row">2</th>
      <td>Jacob</td>
      <td>Thornton</td>
      <td>@fat</td>
    </tr>
    <tr>
      <th scope="row">3</th>
      <td>Larry</td>
      <td>the Bird</td>
      <td>@twitter</td>
    </tr>
  </tbody>
</table>

Чуйні столи

Чуйні таблиці дозволяють легко прокручувати таблиці горизонтально. Зробіть будь-яку таблицю адаптивною для всіх вікон перегляду, обернувши a .tableз .table-responsive. Або виберіть максимальну точку зупину, з якою матимете адаптивну таблицю, використовуючи .table-responsive{-sm|-md|-lg|-xl|-xxl}.

Вертикальне обрізання/обрізання

У адаптивних таблицях використовується функція overflow-y: hidden, яка відсікає будь-який вміст, що виходить за межі нижнього або верхнього краю таблиці. Зокрема, це може відрізати спадні меню та інші сторонні віджети.

Завжди чуйний

Через кожну точку розриву використовуйте .table-responsiveдля горизонтального прокручування таблиць.

# Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок
1 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
2 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
3 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
<div class="table-responsive">
  <table class="table">
    ...
  </table>
</div>

Специфічна точка зупину

Використовуйте .table-responsive{-sm|-md|-lg|-xl|-xxl}за потреби для створення адаптивних таблиць до певної точки зупину. Від цієї точки зупинки та вище таблиця працюватиме нормально й не прокручуватиметься горизонтально.

Ці таблиці можуть виглядати зламаними, доки їхні адаптивні стилі не будуть застосовані до певної ширини вікна перегляду.

# Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок
1 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
2 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
3 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
# Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок
1 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
2 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
3 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
# Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок
1 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
2 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
3 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
# Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок
1 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
2 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
3 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
# Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок
1 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
2 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
3 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
# Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок Заголовок
1 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
2 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
3 Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий Стільниковий
<div class="table-responsive">
  <table class="table">
    ...
  </table>
</div>

<div class="table-responsive-sm">
  <table class="table">
    ...
  </table>
</div>

<div class="table-responsive-md">
  <table class="table">
    ...
  </table>
</div>

<div class="table-responsive-lg">
  <table class="table">
    ...
  </table>
</div>

<div class="table-responsive-xl">
  <table class="table">
    ...
  </table>
</div>

<div class="table-responsive-xxl">
  <table class="table">
    ...
  </table>
</div>

Сасс

Змінні

$table-cell-padding-y:        .5rem;
$table-cell-padding-x:        .5rem;
$table-cell-padding-y-sm:     .25rem;
$table-cell-padding-x-sm:     .25rem;

$table-cell-vertical-align:   top;

$table-color:                 var(--#{$prefix}body-color);
$table-bg:                    transparent;
$table-accent-bg:             transparent;

$table-th-font-weight:        null;

$table-striped-color:         $table-color;
$table-striped-bg-factor:     .05;
$table-striped-bg:            rgba($black, $table-striped-bg-factor);

$table-active-color:          $table-color;
$table-active-bg-factor:      .1;
$table-active-bg:             rgba($black, $table-active-bg-factor);

$table-hover-color:           $table-color;
$table-hover-bg-factor:       .075;
$table-hover-bg:              rgba($black, $table-hover-bg-factor);

$table-border-factor:         .1;
$table-border-width:          $border-width;
$table-border-color:          var(--#{$prefix}border-color);

$table-striped-order:         odd;
$table-striped-columns-order: even;

$table-group-separator-color: currentcolor;

$table-caption-color:         $text-muted;

$table-bg-scale:              -80%;

Петля

$table-variants: (
  "primary":    shift-color($primary, $table-bg-scale),
  "secondary":  shift-color($secondary, $table-bg-scale),
  "success":    shift-color($success, $table-bg-scale),
  "info":       shift-color($info, $table-bg-scale),
  "warning":    shift-color($warning, $table-bg-scale),
  "danger":     shift-color($danger, $table-bg-scale),
  "light":      $light,
  "dark":       $dark,
);

Налаштування

  • Факторні змінні ( $table-striped-bg-factor, $table-active-bg-factor& $table-hover-bg-factor) використовуються для визначення контрасту у варіантах таблиці.
  • Окрім світлих і темних варіантів таблиці, кольори теми освітлюються $table-bg-scaleзмінною.