갤러리로 돌아가기

버튼

저장, 제출, 프로젝트 추가처럼 사용자가 눌러서 실행하는 작업에 써요.

권장 API

속성·요소형식예제 초기값설명
asbutton or abutton기본 버튼으로 작업을 실행하거나 링크로 이동해요.
colorprimary, danger, light, darkprimary동작 의미에 맞는 색 계열을 선택해요.
variantfill or weakfill버튼의 시각적 강조 정도를 선택해요.
displayinline, block, fullinline내용 너비, 한 줄 전체 또는 양 끝에 붙는 배치를 정해요.
sizesmall, medium, large, xlargexlarge최소 높이, 좌우 안쪽 여백과 모서리 반경을 정해요.
loadingBooleanfalse처리 중 상태를 보여주고 중복 실행을 막아요.
disabledBooleanfalse실행을 막고 흐리게 표시해요.
typebutton, submit, resetbutton폼에서 실행할 기본 동작을 선택해요.
hrefURL string—링크로 쓰는 경우 이동할 주소를 정해요.
style / htmlStyleCSS declarations—스타일과 Quark 버튼 토큰 재정의 값을 적용해요.
childrenSnippet, node or slot—접근 가능한 동작 이름이나 아이콘을 넣어요.
clickMouseEvent callback—사용 가능한 상태에서 동작을 실행해요.

상태

상태조건·조작결과
pressed활성 버튼을 누른 채 유지해요.눌림 레이어가 배경을 어둡게 하고 버튼 크기가 줄어요.
loadingloading을 true로 설정해요.점 세 개가 나타나고 너비가 유지되며 중복 실행을 막아요.
disableddisabled를 true로 설정해요.버튼이 흐리게 표시되고 실행할 수 없어요.

Svelte 구현 지침

네이티브 버튼 또는 링크에 배경, 콘텐츠, 눌림 피드백, 로딩 레이어를 둡니다. 버튼을 누르면 배경이 진해집니다. 로딩 중에는 이름과 너비를 유지하고 중복 실행을 막습니다.

Save the copied source as Button.svelte. Pass children as a snippet, onclick as a callback, and custom CSS declarations as a string in style.

CSS 변수

변수타입기본값설명
--q-textcolor #28302a제목과 기본 텍스트의 색이에요.
--q-mutedcolor #70776f설명이나 보조 텍스트의 색이에요.
--q-font-sizelength 13px컴포넌트의 기준 글자 크기예요.
--q-accentcolor #344e41활성 상태, 표시 막대, 포커스에 쓰는 강조색이에요.
--q-on-accentcolor #ffffff강조색 배경 위의 글자나 아이콘 색이에요.
--q-surfacecolor #ffffff컨트롤과 카드의 배경색이에요.
--q-bordercolor #dce0d8테두리와 구분선의 색이에요.
--q-border-widthlength 1px테두리의 두께예요.
--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-shadowshadow 0 4px 16px rgb(0 0 0 / 8%)바닥에서 떠 보이는 요소의 그림자예요.
--q-durationtime 175ms상태가 바뀔 때 전환에 걸리는 시간이에요.
--q-spacelength 4px간격과 여백을 계산하는 기준값이에요.