숫자 스피너
숫자를 직접 입력하거나 위아래 또는 양옆의 버튼으로 한 단계씩 조절해요.
Quantity
Choose a number from 1 to 9.
권장 API
| 속성·요소 | 형식 | 예제 초기값 | 설명 |
|---|---|---|---|
type and name | Native input attributes | number, quantity | 수량을 직접 편집 가능한 숫자 하나로 받아요. |
min, max, step | Numbers | 1, 9, 1 | 최솟값, 최댓값과 한 번에 바뀌는 양을 정해요. |
value and required | Number and Boolean | 2, true | 초깃값을 넣고 유효한 숫자를 입력하도록 해요. |
data-layout | stacked, sides | stacked | 증감 버튼을 수직으로 쌓거나 필드 양옆에 배치해요. |
상태
| 상태 | 조건·조작 | 결과 |
|---|---|---|
stepping | 위아래 버튼이나 방향키를 눌러요. | 수량이 하나씩 바뀌고 최솟값이나 최댓값에서는 해당 방향 버튼이 비활성화돼요. |
invalid | 범위를 벗어난 값을 직접 입력해요. | 브라우저가 범위 오류로 표시하고 입력한 값은 그대로 둬요. |
layout changed | 위아래형 또는 양옆형을 선택해요. | 버튼 위치가 바뀌고 입력값과 검증 상태는 유지돼요. |
CSS 변수
| 변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
--q-text | color | #28302a | 제목과 기본 텍스트의 색이에요. |
--q-muted | color | #70776f | 설명이나 보조 텍스트의 색이에요. |
--q-font-size | length | 13px | 컴포넌트의 기준 글자 크기예요. |
--q-accent | color | #344e41 | 활성 상태, 표시 막대, 포커스에 쓰는 강조색이에요. |
--q-surface | color | #ffffff | 컨트롤과 카드의 배경색이에요. |
--q-border | color | #dce0d8 | 테두리와 구분선의 색이에요. |
--q-radius | length | 10px | 모서리를 둥글게 하는 기준값이에요. |
--q-gap | length | calc(var(--q-space) * 2) | 내용 사이의 간격이에요. 기본 간격으로 계산해요. |
--q-control-px | length | calc(var(--q-space) * 4) | 컨트롤 안쪽의 좌우 여백이에요. |
--q-control-py | length | calc(var(--q-space) * 2.5) | 컨트롤 안쪽의 위아래 여백이에요. |
--q-space | length | 4px | 간격과 여백을 계산하는 기준값이에요. |