Skip to Content
Lynx

Floating Action Button

화면 위에 떠 있으며 주요 액션을 실행하는 버튼입니다.

Engine ≥ 3.9
사용 가능 버전@seed-design/lynx-react@0.8.0, @seed-design/lynx-css@0.12.0
Lynx 예제를 불러오는 중입니다.

Installation

npx @seed-design/cli@latest add ui:floating-action-button

Props

Prop

Type

iconReact.ReactElement<LynxIconElementProps, string | React.JSXElementConstructor<any>>
labelstring

Usage

label은 필수이며 기본 접근성 이름으로도 사용됩니다. extended의 기본값은 true입니다.

import IconPlusLine from "@karrotmarket/lynx-monochrome-icon/IconPlusLine";

import { FloatingActionButton } from "@/components/ui/floating-action-button";

function handleTap() {
  "background only";
  // 새 글 작성 동작을 처리합니다.
}

export function NewPostButton() {
  return (
    <FloatingActionButton
      icon={<IconPlusLine />}
      label="새 글 작성"
      bindtap={handleTap}
    />
  );
}

extended={false}이면 label은 화면에서 숨겨지고 56×56px 아이콘 버튼으로 표시됩니다. 이때도 label은 Root의 접근성 이름으로 남습니다. 다른 설명이 필요하면 accessibility-label을 직접 지정하세요.

Examples

Extended

extended prop으로 label 표시와 레이아웃을 전환할 수 있습니다. 기본값은 true입니다.

Lynx 예제를 불러오는 중입니다.

Float Composition

Floating Action Button은 Float와 함께 사용하면 편리합니다. 위치 기준 Box에 position="relative"를 지정하고, Float의 placement와 offset으로 버튼을 배치하세요.

Lynx 예제를 불러오는 중입니다.

Glass Effect

glassEffect로 iOS Liquid Glass를 적용합니다. style은 glass 재질("regular"·"clear")을, interactive는 glass가 터치에 직접 반응할지를 정합니다. glass일 때는 현재 상태의 배경색이 glass tint가 되고, 그림자를 그리지 않습니다.

Lynx 예제를 불러오는 중입니다.

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

목차