Quick reference

Class
Properties
ring-0box-shadow: var(--tw-ring-inset) 0 0 0 calc(0px + var(--tw-ring-offset-width)) var(--tw-ring-color);
ring-1box-shadow: var(--tw-ring-inset) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color);
ring-2box-shadow: var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color);
ringbox-shadow: var(--tw-ring-inset) 0 0 0 calc(3px + var(--tw-ring-offset-width)) var(--tw-ring-color);
ring-4box-shadow: var(--tw-ring-inset) 0 0 0 calc(4px + var(--tw-ring-offset-width)) var(--tw-ring-color);
ring-8box-shadow: var(--tw-ring-inset) 0 0 0 calc(8px + var(--tw-ring-offset-width)) var(--tw-ring-color);
ring-inset--tw-ring-inset: inset;

Basic usage

링 추가하기

ring-* 유틸리티를 사용해 엘리먼트에 특정 두께의 고체 박스 쉐도우를 적용할 수 있습니다. 기본적으로 링은 반투명한 파란색으로, 많은 시스템의 기본 포커스 링 스타일과 유사합니다.

ring-2

ring

ring-4

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

링 유틸리티는 일반 shadow-* 유틸리티와 자연스럽게 조합될 수 있으며, 동일한 엘리먼트에 함께 사용할 수 있습니다.

또한 ringColor, ringOpacity, ringOffsetWidth 유틸리티를 사용해 링의 색상, 투명도, 오프셋을 조절할 수 있습니다.

포커스 링

링 너비 유틸리티를 사용하면 focus:ring-* 유틸리티 앞에 추가하여 커스텀 포커스 링을 쉽게 사용할 수 있습니다.

이 버튼에 포커스를 맞추면 링이 나타나는 것을 확인할 수 있습니다

<button class="... focus:ring-2">변경 사항 저장</button>

focus 변형은 기본적으로 ringColor, ringOpacity, ringOffsetWidth, 그리고 ringOffsetColor 유틸리티에도 활성화되어 있습니다.

안쪽으로 렌더링되는 링

ring-inset 유틸리티를 사용하면 링이 엘리먼트의 바깥쪽이 아닌 안쪽으로 렌더링되도록 강제할 수 있습니다. 이는 화면 가장자리에 위치한 엘리먼트에서 링의 일부가 보이지 않을 때 유용합니다.

<button class="... ring-2 ring-pink-300 ring-inset">
  Save Changes
</button>

Applying conditionally

호버, 포커스 및 기타 상태

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

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

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

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

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

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

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


Using custom values

테마 커스터마이징

기본적으로 Tailwind는 일반적인 용도의 ring-width 유틸리티를 포함하고 있습니다. tailwind.config.js 파일에서 theme.ringWidth 또는 theme.extend.ringWidth를 수정하여 이 값을 커스터마이징할 수 있습니다.

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      ringWidth: {
        '10': '10px',
      }
    }
  }
}

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

임의 값

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

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

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