갤러리로 돌아가기

숫자 스피너

숫자를 직접 입력하거나 위아래 또는 양옆의 버튼으로 한 단계씩 조절해요.

Quantity

Choose a number from 1 to 9.

권장 API

속성·요소형식예제 초기값설명
type and nameNative input attributesnumber, quantity수량을 직접 편집 가능한 숫자 하나로 받아요.
min, max, stepNumbers1, 9, 1최솟값, 최댓값과 한 번에 바뀌는 양을 정해요.
value and requiredNumber and Boolean2, true초깃값을 넣고 유효한 숫자를 입력하도록 해요.
data-layoutstacked, sidesstacked증감 버튼을 수직으로 쌓거나 필드 양옆에 배치해요.

상태

상태조건·조작결과
stepping위아래 버튼이나 방향키를 눌러요.수량이 하나씩 바뀌고 최솟값이나 최댓값에서는 해당 방향 버튼이 비활성화돼요.
invalid범위를 벗어난 값을 직접 입력해요.브라우저가 범위 오류로 표시하고 입력한 값은 그대로 둬요.
layout changed위아래형 또는 양옆형을 선택해요.버튼 위치가 바뀌고 입력값과 검증 상태는 유지돼요.

CSS 변수

변수타입기본값설명
--q-textcolor #28302a제목과 기본 텍스트의 색이에요.
--q-mutedcolor #70776f설명이나 보조 텍스트의 색이에요.
--q-font-sizelength 13px컴포넌트의 기준 글자 크기예요.
--q-accentcolor #344e41활성 상태, 표시 막대, 포커스에 쓰는 강조색이에요.
--q-surfacecolor #ffffff컨트롤과 카드의 배경색이에요.
--q-bordercolor #dce0d8테두리와 구분선의 색이에요.
--q-radiuslength 10px모서리를 둥글게 하는 기준값이에요.
--q-gaplength calc(var(--q-space) * 2)내용 사이의 간격이에요. 기본 간격으로 계산해요.
--q-control-pxlength calc(var(--q-space) * 4)컨트롤 안쪽의 좌우 여백이에요.
--q-control-pylength calc(var(--q-space) * 2.5)컨트롤 안쪽의 위아래 여백이에요.
--q-spacelength 4px간격과 여백을 계산하는 기준값이에요.