Краткая справка

Класс
Свойства
col-autogrid-column: auto;
col-span-1grid-column: span 1 / span 1;
col-span-2grid-column: span 2 / span 2;
col-span-3grid-column: span 3 / span 3;
col-span-4grid-column: span 4 / span 4;
col-span-5grid-column: span 5 / span 5;
col-span-6grid-column: span 6 / span 6;
col-span-7grid-column: span 7 / span 7;
col-span-8grid-column: span 8 / span 8;
col-span-9grid-column: span 9 / span 9;
col-span-10grid-column: span 10 / span 10;
col-span-11grid-column: span 11 / span 11;
col-span-12grid-column: span 12 / span 12;
col-span-fullgrid-column: 1 / -1;
col-start-1grid-column-start: 1;
col-start-2grid-column-start: 2;
col-start-3grid-column-start: 3;
col-start-4grid-column-start: 4;
col-start-5grid-column-start: 5;
col-start-6grid-column-start: 6;
col-start-7grid-column-start: 7;
col-start-8grid-column-start: 8;
col-start-9grid-column-start: 9;
col-start-10grid-column-start: 10;
col-start-11grid-column-start: 11;
col-start-12grid-column-start: 12;
col-start-13grid-column-start: 13;
col-start-autogrid-column-start: auto;
col-end-1grid-column-end: 1;
col-end-2grid-column-end: 2;
col-end-3grid-column-end: 3;
col-end-4grid-column-end: 4;
col-end-5grid-column-end: 5;
col-end-6grid-column-end: 6;
col-end-7grid-column-end: 7;
col-end-8grid-column-end: 8;
col-end-9grid-column-end: 9;
col-end-10grid-column-end: 10;
col-end-11grid-column-end: 11;
col-end-12grid-column-end: 12;
col-end-13grid-column-end: 13;
col-end-autogrid-column-end: auto;

Основы использования

Связующие столбцы

Используйте утилиты col-span-{n}, чтобы сделать элемент охватывающим n столбцов.

01
02
03
04
05
06
07
<div class="grid grid-cols-3 gap-4">
  <div class="...">01</div>
  <div class="...">02</div>
  <div class="...">03</div>
  <div class="col-span-2 ...">04</div>
  <div class="...">05</div>
  <div class="...">06</div>
  <div class="col-span-2 ...">07</div>
</div>

Начальная и конечная линии

Используйте утилиты col-start-{n} и col-end-{n}, чтобы сделать начало или конец элемента на линии сетки nth. Их также можно комбинировать с утилитами col-span-{n}, чтобы охватить определенное количество столбцов.

Обратите внимание, что линии сетки CSS начинаются с 1, а не с 0, поэтому элемент полной ширины в сетке из 6 столбцов будет начинаться со строки 1 и заканчиваться на строке 7.

01
02
03
04
<div class="grid grid-cols-6 gap-4">
  <div class="col-start-2 col-span-4 ...">01</div>
  <div class="col-start-1 col-end-3 ...">02</div>
  <div class="col-end-7 col-span-2 ...">03</div>
  <div class="col-start-1 col-end-7 ...">04</div>
</div>

Применяя условно

Tailwind lets you conditionally apply utility classes in different states using variant modifiers. For example, use hover:col-span-6 to only apply the col-span-6 utility on hover.

<div class="col-span-2 hover:col-span-6">
  <!-- ... -->
</div>

For a complete list of all available state modifiers, check out the Hover, Focus, & Other States documentation.

Контрольные точки и медиа-запросы

You can also use variant modifiers to target media queries like responsive breakpoints, dark mode, prefers-reduced-motion, and more. For example, use md:col-span-6 to apply the col-span-6 utility at only medium screen sizes and above.

<div class="col-span-2 md:col-span-6">
  <!-- ... -->
</div>

To learn more, check out the documentation on Responsive Design, Dark Mode and other media query modifiers.


Использование пользовательских значений

Настройка вашей темы

По умолчанию Tailwind включает в себя утилиты для работы с сетками, содержащими до 12 столбцов. Вы изменяете, добавляете или удаляете их, настраивая разделы gridColumn, gridColumnStart и gridColumnEnd в конфигурации Вашей темы Tailwind.

Для создания дополнительных утилит col-{value}, которые напрямую управляют сокращенным свойством grid-column, настройте раздел gridColumn в конфигурации Вашей темы Tailwind:

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      gridColumn: {
        'span-16': 'span 16 / span 16',
      }
    }
  }
}

Мы используем это внутренне для наших утилит col-span-{n}. Обратите внимание: так как это настраивает сокращенное свойство grid-column напрямую, мы включаем слово span прямо в имя значения, оно не автоматически вставляется в имя класса. Это означает, что вы можете добавлять сюда записи, которые делают все, что захотите - они не должны быть просто утилитами span.

Чтобы добавить новые утилиты col-start-{n}, используйте раздел gridColumnStart конфигурации Вашей темы Tailwind:

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      gridColumnStart: {
        '13': '13',
        '14': '14',
        '15': '15',
        '16': '16',
        '17': '17',
      }
    }
  }
}

Чтобы добавить новые утилиты col-end-{n}, используйте раздел gridColumnEnd конфигурации Вашей темы Tailwind:

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      gridColumnEnd: {
        '13': '13',
        '14': '14',
        '15': '15',
        '16': '16',
        '17': '17',
      }
    }
  }
}

Дополнительные сведения о настройке темы по умолчанию смотрите в документации настройка темы.

Произвольные значения

If you need to use a one-off grid-column/grid-column-start/grid-column-end value that doesn’t make sense to include in your theme, use square brackets to generate a property on the fly using any arbitrary value.

<div class="col-[16_/_span_16]">
  <!-- ... -->
</div>

Learn more about arbitrary value support in the arbitrary values documentation.