Quick reference

Class
Properties
ring-offset-0--tw-ring-offset-width: 0px; box-shadow: 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color), var(--tw-ring-shadow);
ring-offset-1--tw-ring-offset-width: 1px; box-shadow: 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color), var(--tw-ring-shadow);
ring-offset-2--tw-ring-offset-width: 2px; box-shadow: 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color), var(--tw-ring-shadow);
ring-offset-4--tw-ring-offset-width: 4px; box-shadow: 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color), var(--tw-ring-shadow);
ring-offset-8--tw-ring-offset-width: 8px; box-shadow: 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color), var(--tw-ring-shadow);

Basic usage

링 오프셋 너비 설정

ring-offset-2ring-offset-4 같은 유틸리티를 사용하여 고체 흰색 박스 쉐도우를 추가하고 오프셋을 수용하기 위해 동반되는 아웃라인 링의 두께를 늘려 오프셋을 시뮬레이션할 수 있습니다.

ring-offset-0

ring-offset-2

ring-offset-4

<button class="... ring ring-pink-500 ring-offset-0">Button A</button>
<button class="... ring ring-pink-500 ring-offset-2">Button B</button>
<button class="... ring ring-pink-500 ring-offset-4">Button C</button>

오프셋 색상 변경하기

CSS에서는 박스 그림자를 오프셋할 수 없기 때문에, 부모 배경색과 일치하는 단색 그림자를 사용해 이를 흉내내야 합니다. 기본적으로 흰색을 사용하지만, 다른 배경색 위에 링 오프셋을 추가할 때는 ring-offset-slate-50과 같은 링 오프셋 색상 유틸리티를 사용해 부모 배경색과 일치시킬 수 있습니다.

ring-offset-slate-50

<button class="ring ring-pink-500 ring-offset-2 ring-offset-slate-50 dark:ring-offset-slate-900 ...">
  Save Changes
</button>

더 자세한 정보는 링 오프셋 색상 문서를 참고하세요.


Applying conditionally

호버, 포커스 및 기타 상태

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

<button class="ring-2 ring-offset-2 hover:ring-offset-4">
  <!-- ... -->
</button>

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

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

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

<button class="ring-2 ring-offset-2 md:ring-offset-4">
  <!-- ... -->
</button>

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


Using custom values

테마 커스터마이징

링 오프셋 너비 유틸리티를 커스터마이징하려면 tailwind.config.js 파일의 theme 섹션 아래 ringOffsetWidth 키에 커스텀 값을 추가하세요.

tailwind.config.js
/** @type {import('tailwindcss').Config} */
module.exports = {
  theme: {
    extend: {
      ringOffsetWidth: {
        '3': '3px',
        '6': '6px',
        '10': '10px',
      }
    }
  }
}

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

임의 값

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

<div class="ring-offset-[3px]">
  <!-- ... -->
</div>

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