Get StartedFoundationsComponentsPatternsRulesDevelopAI & ToolsUpdates

Input Button

입력 필드 형태의 버튼으로, 선택창이나 피커를 열고 선택된 값을 라벨에 보여줘요.

설치

pnpm dlx shadcn@latest add https://rebar.conmarket-landing.workers.dev/r/input-button.json

Anatomy

Input Button은 Value, 이를 감싸는 Container, Clear Button(선택), 그리고 Prefix/Suffix Slot으로 구성돼요.

  • Container: 입력 필드와 같은 모양의 버튼이에요. 누르면 선택창이 열려요.
  • Value / Placeholder: 선택된 값이 있으면 Value를, 없으면 Placeholder를 보여줘요.
  • Prefix / Suffix: 값 앞뒤에 아이콘(prefixIcon, suffixIcon)이나 텍스트(prefix, suffix)를 둘 수 있어요.
  • Clear Button: 값이 있을 때 지울 수 있는 버튼이에요.

Properties

Size

Large, Medium 두 가지 Size를 제공해요. Medium은 Breakpoint lg 이상(데스크톱)에서만 사용하고, Responsive는 lg 미만에서 Large, 이상에서 Medium으로 전환돼요.

State

Enabled, Pressed, Error, Error Pressed, Disabled, Read Only 상태를 가져요. Error는 테두리가 Critical 색으로 강조되고, Disabled와 Read Only는 배경이 채워져요. Read Only는 값을 그대로 보여주지만 눌러도 반응하지 않아요.

Value

값이 있으면 value 로 넘겨요. 일반 텍스트를 표시하고, 비어 있으면 placeholder 를 보여줘요. 값이 너비를 넘으면 말줄임돼요.

Clear Button

값이 있을 때 showClearButton 으로 값을 지우는 버튼을 표시할 수 있어요. 값이 없거나 Disabled, Read Only 상태에서는 표시되지 않아요. 기본 접근성 라벨은 "지우기"이고 clearButtonLabel 로 바꿀 수 있어요.

Guidelines

Input Button의 활용

Input Button은 Input과 비슷한 모양이지만 직접 값을 입력할 수 없는 버튼이에요. 누르면 Bottom Sheet나 Date/Time Picker 등이 열려 값을 고르고, 고르면 버튼에 해당 값이 표시돼요.

Input Button은 단독으로 사용하지 않아요. 항상 Bottom Sheet, Date/Time Picker처럼 선택 가능한 목록을 제공하는 UI와 함께 사용해요.

마포구 합정동
Do· 선택창과 함께 사용

누르면 Bottom Sheet가 열려 값을 고르고, 고른 값이 버튼에 표시돼요.

상품명을 입력해 주세요
Don't· 직접 입력이 필요한 곳에 사용

자유롭게 텍스트를 입력해야 한다면 Text Input을 사용해요.

접근성

Input Button 자체에는 보이는 라벨이 없으니 Field의 Label과 함께 쓰거나 aria-label 을 지정해요. 선택창이 열린다는 것을 알리려면 aria-haspopup 을 함께 지정해요.

Props

Prop

Type

On this page