GPUI Deck

Button

포인터와 키보드 활성화, 비활성화 상태, 포커스, 접근 가능한 이름과 역할, 선택적 현재 페이지 메타데이터.

GPUI 웹 백엔드가 그리는 실제 컴포넌트입니다. WebGPU를 지원하는 브라우저가 필요합니다.

Button은 다른 컨트롤들이 기반으로 삼는 활성화 기본 요소입니다. 포인터와 Enter/Space 활성화, 포커스, 비활성화 상태, 네이티브 Button 역할을 소유합니다. 내용, 간격, 모양, 상태별 스타일은 애플리케이션이 맡습니다.

미리보기에 쓰인 라이트·다크 버튼 스타일을 앱에 복사합니다.

cargo run -p gpui-deck-cli --locked -- add button --to ../my-app/src/ui
use ui::{Appearance, recipes::ButtonVariant};

let palette = Appearance::Settings.palette();
ButtonVariant::Primary
    .apply(Button::new("save").accessibility_label("세션 저장"), palette)
    .on_click(|_, window, cx| {
        // The application decides what activation does.
    })
    .child("저장")

활성화와 포커스

클릭, Enter, Space는 버튼을 한 번 활성화합니다. .disabled(true)는 활성화를 무시하고 Tab 스톱을 제거합니다. 포커스를 가진 상태에서 비활성화된 버튼은 포커스가 떠날 때까지 포커스 바인딩을 유지하므로 Tab으로 어느 방향으로든 계속 이동할 수 있습니다. .track_focus(&handle)는 애플리케이션이 소유하는 포커스 핸들을 사용합니다. 예를 들어 대화 상자가 닫힌 뒤 포커스를 복원할 때 씁니다. .tab_index(...)와 .tab_stop(...)는 이동 순서를 조정합니다.

접근성

아이콘만 있는 버튼처럼 자식이 일반 텍스트가 아니면 언제나 .accessibility_label(...)로 버튼에 이름을 붙입니다. .selected(true)는 선택된 스타일만 적용합니다. .current(true)는 내비게이션 항목에 aria-current="page"를 별도로 노출하므로, 선택된 모양이 곧 현재 페이지를 뜻하지는 않습니다.

Toggle, Collapsible과 Tooltip 트리거, CarouselControl, 메뉴 트리거는 Button을 조합하므로 이 활성화 및 포커스 계약을 공유합니다.