React

Search Bar

Stackflow 화면 상단에서 검색어를 입력하는 App Bar입니다. Search Input을 Back·닫기 버튼과 함께 배치합니다.

사용 가능 버전@seed-design/[email protected], @seed-design/[email protected], @seed-design/[email protected]
Loading...

Search Bar는 App Screen의 AppBar 안에 Search Input을 배치한 컴포넌트입니다. App Bar가 Stackflow activity에 의존하므로 Stackflow 밖에서는 Search Input snippet을 직접 사용하고 바 레이아웃을 구성하세요.

Installation

npx @seed-design/cli@latest add ui:search-bar

Usage

import { AppScreen, AppScreenContent } from "seed-design/ui/app-screen";
import { SearchBar } from "seed-design/ui/search-bar";
<AppScreen>
  <SearchBar
    value={value}
    onValueChange={setValue}
    onSubmit={handleSubmit}
    placeholder="검색어를 입력해주세요"
    onClose={() => pop()}
  />
  <AppScreenContent>{/* content */}</AppScreenContent>
</AppScreen>

Props

Prop

Type

placeholder?string | undefined
defaultValue?string | undefined
name?string | undefined
value?string | undefined
onValueChange?((value: string) => void) | undefined

showBackButton, onClose, closeLabel을 제외한 prop은 Search Input snippet으로 전달됩니다. ui:search-bar를 설치하면 ui:search-input과 ui:app-screen도 함께 설치됩니다.

Examples

Back Button

showBackButton을 사용하면 이전 화면으로 돌아가는 Back 버튼을 표시합니다. 검색 플로우에서 이전 화면으로 돌아가는 동작을 제공할 때만 사용하세요. root activity에서는 Back 버튼이 표시되지 않습니다.

닫기 버튼은 항상 표시되며, onClose로 동작을 지정합니다. 레이블은 closeLabel로 바꿀 수 있습니다.

Keyboard

Enter를 누르면 onSubmit이 호출되고 입력의 focus가 해제되어 모바일 키보드가 내려갑니다. 콘텐츠를 누르거나 스크롤할 때 키보드를 내리는 동작은 화면에서 처리합니다. 위 예제는 콘텐츠를 누르면 focus를 해제합니다.

Last updated on

목차