Quick reference

Class
Properties
columns-1columns: 1;
columns-2columns: 2;
columns-3columns: 3;
columns-4columns: 4;
columns-5columns: 5;
columns-6columns: 6;
columns-7columns: 7;
columns-8columns: 8;
columns-9columns: 9;
columns-10columns: 10;
columns-11columns: 11;
columns-12columns: 12;
columns-autocolumns: auto;
columns-3xscolumns: 16rem; /* 256px */
columns-2xscolumns: 18rem; /* 288px */
columns-xscolumns: 20rem; /* 320px */
columns-smcolumns: 24rem; /* 384px */
columns-mdcolumns: 28rem; /* 448px */
columns-lgcolumns: 32rem; /* 512px */
columns-xlcolumns: 36rem; /* 576px */
columns-2xlcolumns: 42rem; /* 672px */
columns-3xlcolumns: 48rem; /* 768px */
columns-4xlcolumns: 56rem; /* 896px */
columns-5xlcolumns: 64rem; /* 1024px */
columns-6xlcolumns: 72rem; /* 1152px */
columns-7xlcolumns: 80rem; /* 1280px */

Basic usage

컬럼 수에 따라 추가하기

columns-2columns-3 같은 유틸리티를 사용해 엘리먼트 내부의 콘텐츠에 생성될 컬럼 수를 설정할 수 있습니다. 컬럼 너비는 해당 수에 맞게 자동으로 조정됩니다.

<div class="columns-3 ...">
  <img class="w-full aspect-video ..." src="..." />
  <img class="w-full aspect-square ..." src="..." />
  <!-- ... -->
</div>

컬럼 너비에 따라 추가하기

columns-xscolumns-sm 같은 유틸리티를 사용해 엘리먼트 내부의 콘텐츠에 적합한 컬럼 너비를 설정할 수 있습니다. 이때 컬럼의 개수는 자동으로 조정되어 해당 값을 수용합니다.

이 “티셔츠” 스케일은 max-width 스케일과 동일하며, 더 작은 컬럼이 필요한 경우를 대비해 2xs3xs가 추가되었습니다.

<div class="columns-3xs ...">
  <img class="w-full aspect-video ..." src="..." />
  <img class="w-full aspect-square ..." src="..." />
  <!-- ... -->
</div>

컬럼 간격 설정하기

컬럼 사이의 너비를 지정하려면 gap-x 유틸리티를 사용할 수 있습니다:

<div class="gap-8 columns-3 ...">
  <img class="w-full aspect-video ..." src="..." />
  <img class="w-full aspect-square ..." src="..." />
  <!-- ... -->
</div>

Applying conditionally

호버, 포커스 및 기타 상태

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

<div class="columns-2 hover:columns-3">
  <!-- ... -->
</div>

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

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

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

<div class="columns-2 md:columns-3">
  <!-- ... -->
</div>

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


Using custom values

테마 커스터마이징

기본적으로 Tailwind는 1-12까지의 컬럼 개수 스케일과 3xs-7xl까지의 티셔츠 사이즈 스케일을 제공합니다. tailwind.config.js 파일에서 theme.columns 또는 theme.extend.columns를 수정하여 이 값을 커스터마이징할 수 있습니다.

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      columns: {
        '4xs': '14rem',
      }
    },
  }
}

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

임의 값

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

<div class="columns-[10rem]">
  <!-- ... -->
</div>

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