Quick reference

Class
Properties
grid-cols-1grid-template-columns: repeat(1, minmax(0, 1fr));
grid-cols-2grid-template-columns: repeat(2, minmax(0, 1fr));
grid-cols-3grid-template-columns: repeat(3, minmax(0, 1fr));
grid-cols-4grid-template-columns: repeat(4, minmax(0, 1fr));
grid-cols-5grid-template-columns: repeat(5, minmax(0, 1fr));
grid-cols-6grid-template-columns: repeat(6, minmax(0, 1fr));
grid-cols-7grid-template-columns: repeat(7, minmax(0, 1fr));
grid-cols-8grid-template-columns: repeat(8, minmax(0, 1fr));
grid-cols-9grid-template-columns: repeat(9, minmax(0, 1fr));
grid-cols-10grid-template-columns: repeat(10, minmax(0, 1fr));
grid-cols-11grid-template-columns: repeat(11, minmax(0, 1fr));
grid-cols-12grid-template-columns: repeat(12, minmax(0, 1fr));
grid-cols-nonegrid-template-columns: none;
grid-cols-subgridgrid-template-columns: subgrid;

Basic usage

그리드에서 컬럼 지정하기

grid-cols-* 유틸리티를 사용하여 동일한 크기의 _n_개 컬럼으로 구성된 그리드를 생성할 수 있습니다.

01
02
03
04
05
06
07
08
09
<div class="grid grid-cols-4 gap-4">
  <div>01</div>
  <!-- ... -->
  <div>09</div>
</div>

Subgrid

grid-cols-subgrid 유틸리티를 사용하여 부모 아이템이 정의한 컬럼 트랙을 적용할 수 있습니다.

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

Applying conditionally

호버, 포커스 및 기타 상태

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

<div class="grid grid-cols-1 hover:grid-cols-6">
  <!-- ... -->
</div>

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

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

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

<div class="grid grid-cols-1 md:grid-cols-6">
  <!-- ... -->
</div>

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


Using custom values

테마 커스터마이징

기본적으로 Tailwind는 최대 12개의 동일한 너비 컬럼으로 기본 그리드를 생성하기 위한 grid-template-column 유틸리티를 포함합니다. tailwind.config.js 파일에서 theme.gridTemplateColumns 또는 theme.extend.gridTemplateColumns를 수정하여 이러한 값을 커스터마이징할 수 있습니다.

여기서는 grid-template-columns CSS 속성에 직접 접근할 수 있으므로, 여러분의 사이트에 맞게 일반적이거나 복잡한 컬럼 값을 자유롭게 설정할 수 있습니다.

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      gridTemplateColumns: {
        // 간단한 16 컬럼 그리드
        '16': 'repeat(16, minmax(0, 1fr))',

        // 사이트에 특화된 복잡한 컬럼 설정
        'footer': '200px minmax(900px, 1fr) 100px',
      }
    }
  }
}

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

임의 값

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

<div class="grid grid-cols-[200px_minmax(900px,_1fr)_100px]">
  <!-- ... -->
</div>

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