Floating Action Button
화면 위에 떠 있으며 주요 액션을 실행하는 버튼입니다.
Installation
의존성 설치
아래 코드를 복사 후 붙여넣고 사용하세요
Props
Usage
label은 필수이며 기본 접근성 이름으로도 사용됩니다. extended의 기본값은 true입니다.
extended={false}이면 label은 화면에서 숨겨지고 56×56px 아이콘 버튼으로 표시됩니다. 이때도 label은 Root의 접근성 이름으로 남습니다. 다른 설명이 필요하면 accessibility-label을 직접 지정하세요.
Examples
Extended
extended prop으로 label 표시와 레이아웃을 전환할 수 있습니다. 기본값은 true입니다.
Float Composition
Floating Action Button은 Float와 함께 사용하면 편리합니다. 위치 기준 Box에 position="relative"를 지정하고, Float의 placement와 offset으로 버튼을 배치하세요.
Glass Effect
glassEffect로 iOS Liquid Glass를 적용합니다. style은 glass 재질("regular"·"clear")을, interactive는 glass가 터치에 직접 반응할지를 정합니다. glass일 때는 현재 상태의 배경색이 glass tint가 되고, 그림자를 그리지 않습니다.
Liquid Glass는 실험적인 구현입니다. 앱 root SeedProvider에 supportsLiquidGlass를 넘겨야 활성화되며, 지금은 iOS 26 이상에서만 그립니다. 활성화 방법과 제약은 Host Integration을 참고하세요. 이 예제는 미리보기를 위해 예제 안에서만 supportsLiquidGlass를 켭니다.
웹 버전과의 차이
onClick대신bindtap을 사용합니다. React state를 바꾸는 handler의 첫 줄에는"background only"를 두세요.aria-label대신accessibility-label을 사용합니다. Registry는 필수label을 기본 접근성 이름으로 사용합니다.- HTML button prop과
asChild는 지원하지 않습니다.
Last updated on