버튼
저장, 제출, 프로젝트 추가처럼 사용자가 눌러서 실행하는 작업에 써요.
권장 API
| 속성·요소 | 형식 | 예제 초기값 | 설명 |
|---|---|---|---|
as | button or a | button | 기본 버튼으로 작업을 실행하거나 링크로 이동해요. |
color | primary, danger, light, dark | primary | 동작 의미에 맞는 색 계열을 선택해요. |
variant | fill or weak | fill | 버튼의 시각적 강조 정도를 선택해요. |
display | inline, block, full | inline | 내용 너비, 한 줄 전체 또는 양 끝에 붙는 배치를 정해요. |
size | small, medium, large, xlarge | xlarge | 최소 높이, 좌우 안쪽 여백과 모서리 반경을 정해요. |
loading | Boolean | false | 처리 중 상태를 보여주고 중복 실행을 막아요. |
disabled | Boolean | false | 실행을 막고 흐리게 표시해요. |
type | button, submit, reset | button | 폼에서 실행할 기본 동작을 선택해요. |
href | URL string | — | 링크로 쓰는 경우 이동할 주소를 정해요. |
style / htmlStyle | CSS declarations | — | 스타일과 Quark 버튼 토큰 재정의 값을 적용해요. |
children | Snippet, node or slot | — | 접근 가능한 동작 이름이나 아이콘을 넣어요. |
click | MouseEvent callback | — | 사용 가능한 상태에서 동작을 실행해요. |
상태
| 상태 | 조건·조작 | 결과 |
|---|---|---|
pressed | 활성 버튼을 누른 채 유지해요. | 눌림 레이어가 배경을 어둡게 하고 버튼 크기가 줄어요. |
loading | loading을 true로 설정해요. | 점 세 개가 나타나고 너비가 유지되며 중복 실행을 막아요. |
disabled | disabled를 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-text | color | #28302a | 제목과 기본 텍스트의 색이에요. |
--q-muted | color | #70776f | 설명이나 보조 텍스트의 색이에요. |
--q-font-size | length | 13px | 컴포넌트의 기준 글자 크기예요. |
--q-accent | color | #344e41 | 활성 상태, 표시 막대, 포커스에 쓰는 강조색이에요. |
--q-on-accent | color | #ffffff | 강조색 배경 위의 글자나 아이콘 색이에요. |
--q-surface | color | #ffffff | 컨트롤과 카드의 배경색이에요. |
--q-border | color | #dce0d8 | 테두리와 구분선의 색이에요. |
--q-border-width | length | 1px | 테두리의 두께예요. |
--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-shadow | shadow | 0 4px 16px rgb(0 0 0 / 8%) | 바닥에서 떠 보이는 요소의 그림자예요. |
--q-duration | time | 175ms | 상태가 바뀔 때 전환에 걸리는 시간이에요. |
--q-space | length | 4px | 간격과 여백을 계산하는 기준값이에요. |