Lynx

Floating Action Button

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

Engine ≥ 3.9
사용 가능 버전@seed-design/[email protected], @seed-design/[email protected]
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

Lynx에는 React의 <Float> 컴포넌트가 없습니다. 위치 기준 Box에 position="relative"를 지정하고, 버튼 wrapper에 position="absolute", right, bottom을 적용해 같은 배치를 구성하세요.

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

웹 버전과의 차이

  • onClick 대신 bindtap을 사용합니다. React state를 바꾸는 handler의 첫 줄에는 "background only"를 두세요.
  • aria-label 대신 accessibility-label을 사용합니다. Registry는 필수 label을 기본 접근성 이름으로 사용합니다.
  • HTML button prop과 asChild는 지원하지 않습니다.
  • React의 Float은 제공하지 않습니다. native absolute layout으로 위치를 지정하세요.

Last updated on

목차