跳到主要内容

Search 组件

介绍

通用业务搜索栏组件,常用于页面的顶部搜索,也可以与导航栏组合使用.

用法

基本引入

import { FQSearch } from '@fq/fq-weapp-ui-pro';

组件依赖的样式文件(仅按需引用时需要)

import '@fq/fq-weapp-ui-pro/dist/styles/components/search.scss';

基础用法

<FQSearch size='default' placeholder='请输入' ref={inputRef} onInput={handleInput} onSearch={handleSearch} onConfirm={handleConfirm} />

小号搜索框

<FQSearch size='small' placeholder='请输入内容' />

固定宽度

<FQSearch style={{ margin: '0 auto' }} width={440} size='small' placeholder='请输入' />

受控组件

<FQSearch value={currentValue} onInput={setCurrentValue} onSearch={setCurrentValue} placeholder='请输入' />

带图标组合使用

<FQSearch size='small' placeholder='请输入' />

搜索按钮颜色

<FQSearch enterButtonType='primary' placeholder='请输入' />

不带搜索按钮和清除按钮

<FQSearch showSearchButton={false} allowClear={false} placeholder='请输入' />

禁用

<FQSearch disabled placeholder='请输入' />

API

属性

参数名类型默认值说明
valuestring-当前值
refRef<HTMLInputElement>-当前input的ref实例
sizeSizeType'default'搜索栏大小 ['default', 'small'],如果有width,height,则失效
width`stringnumber`'default'
height`stringnumber`'default'
onSearch(value: string) => void-搜索回调
onInput(value: string) => void-输入回调
onConfirm(value: string) => void-回车/键盘搜索后的回调
showSearchButtonbooleantrue是否展示右侧搜索按钮
autoFocusbooleanfalse自动聚焦
allowClearbooleantrue展示清除按钮
loadingbooleanfalse加载中状态
confirmTextstring'搜索'搜索按钮文本
disabledbooleanfalse禁用
borderedbooleantrue边框
enterButtonReact.ReactNode-搜索按钮
enterButtonTypestring'default'搜索按钮类型 'default'
defaultPrefixClsstring-默认前缀类名
focusPrefixClsstring-焦点前缀类名
placeholderstring-占位符
searchButtonTextstring-搜索按钮文案
addonBeforeIconReact.ReactNode-展示左侧放大镜搜索图标
inputPropsObject{}Input 扩展方法, 参考微信Input文档