Quick reference

Class
Properties
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;

Basic usage

컬럼 병합

col-span-* 유틸리티를 사용해 엘리먼트가 _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-*col-end-* 유틸리티를 사용해 엘리먼트가 그리드의 n번째 라인에서 시작하거나 끝나도록 설정할 수 있습니다. 이 유틸리티는 col-span-*와 함께 사용해 특정 개수의 컬럼을 차지하도록 설정할 수도 있습니다.

CSS 그리드 라인은 0이 아닌 1부터 시작합니다. 따라서 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>

Applying conditionally

호버, 포커스 및 기타 상태

Tailwind는 상태에 따라 유틸리티 클래스를 조건부로 적용할 수 있게 해줍니다. 예를 들어, hover:col-span-6 를 사용하면 col-span-6 유틸리티를 hover 상태에서만 적용할 수 있습니다.

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

사용 가능한 모든 상태 수정자 목록은 호버, 포커스, & 기타 상태 문서를 참고하세요.

브레이크포인트와 미디어 쿼리

여러분은 반응형 브레이크포인트, 다크 모드, prefers-reduced-motion 등과 같은 미디어 쿼리를 타겟팅하기 위해 변형 수식어를 사용할 수 있습니다. 예를 들어, md:col-span-6를 사용하면 중간 화면 크기 이상에서만 col-span-6 유틸리티를 적용할 수 있습니다.

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

더 자세히 알아보려면 반응형 디자인, 다크 모드, 그리고 다른 미디어 쿼리 수식어에 대한 문서를 확인하세요.


Using custom values

테마 커스터마이징

기본적으로 Tailwind는 최대 12개의 컬럼을 가진 그리드 작업을 위한 grid-column 유틸리티를 제공합니다. Tailwind 테마 설정 파일에서 gridColumn, gridColumnStart, gridColumnEnd 섹션을 커스터마이징하여 이를 변경하거나 추가, 제거할 수 있습니다.

새로운 col-* 유틸리티를 추가하려면 Tailwind 테마 설정 파일의 gridColumn 섹션을 커스터마이징하세요:

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

이 설정은 내부적으로 col-span-* 유틸리티를 위해 사용됩니다. 이 설정은 grid-column 단축 속성을 직접 구성하므로, 값 이름에 span을 직접 포함시킵니다. 이는 클래스 이름에 자동으로 포함되지 않는다는 의미입니다. 따라서 여기에 원하는 어떤 값도 자유롭게 추가할 수 있으며, 반드시 span 유틸리티일 필요는 없습니다.

새로운 col-start-* 유틸리티를 추가하려면 Tailwind 테마 설정 파일의 gridColumnStart 섹션을 커스터마이징하세요:

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

새로운 col-end-* 유틸리티를 추가하려면 Tailwind 테마 설정 파일의 gridColumnEnd 섹션을 커스터마이징하세요:

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

기본 테마 커스터마이징에 대해 더 알아보려면 테마 커스터마이징 문서를 참고하세요.

임의 값

테마에 포함시키기 어려운 grid column 값을 일회성으로 사용해야 한다면, 대괄호를 사용해 임의의 값으로 속성을 즉석에서 생성할 수 있습니다.

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

임의 값 지원에 대해 더 알아보려면 임의 값 문서를 참고하세요.