admin 3913475887 oaapp init 3 gadi atpakaļ
..
components 3913475887 oaapp init 3 gadi atpakaļ
changelog.md 3913475887 oaapp init 3 gadi atpakaļ
package.json 3913475887 oaapp init 3 gadi atpakaļ
readme.md 3913475887 oaapp init 3 gadi atpakaļ

readme.md

SearchBar 搜索栏

组件名:uni-search-bar 代码块: uSearchBar

评分组件

安装方式

本组件符合easycom规范,HBuilderX 2.5.5起,只需将本组件导入项目,在页面template中即可直接使用,无需在页面中import和注册components

如需通过npm方式使用uni-ui组件,另见文档:https://ext.dcloud.net.cn/plugin?id=55

基本用法

template 中使用组件

<!-- 基本用法 -->
<uni-search-bar @confirm="search" @input="input" ></uni-search-bar>

<!-- v-model 用法 -->
<uni-search-bar @confirm="search" :focus="true" v-model="searchValue" @blur="blur" @focus="focus" @input="input" @cancel="cancel" @change="change" @clear="clear">

<!-- 自定义Placeholder -->
<uni-search-bar placeholder="自定placeholder" @confirm="search"></uni-search-bar>

<!-- 设置圆角 -->
<uni-search-bar :radius="100" @confirm="search"></uni-search-bar>

API

SearchBar Props

属性名 类型 默认值 说明
value/v-model StringNumber 搜索栏绑定值
placeholder String 搜索 搜索栏Placeholder
radius Number 10 搜索栏圆角,单位px
clearButton String auto 是否显示清除按钮,可选值always-一直显示、auto-输入框不为空时显示、none-一直不显示
cancelButton String auto 是否显示取消按钮,可选值always-一直显示、auto-输入框不为空时显示、none-一直不显示
cancelText String 取消 取消按钮的文字
bgColor String #F8F8F8 输入框背景颜色
maxlength Number 100 输入最大长度
focus Boolean false

SearchBar Events

事件称名 说明 返回参数
@confirm uniSearchBar 的输入框 confirm 事件,返回参数为uniSearchBar的value e={value:Number}
@input uniSearchBar 的 value 改变时触发事件,返回参数为uniSearchBar的value e=value
@cancel 点击取消按钮时触发事件,返回参数为uniSearchBar的value e={value:Number}
@clear 点击清除按钮时触发事件,返回参数为uniSearchBar的value e={value:Number}
@focus input 获取焦点时触发事件,返回参数为uniSearchBar的value e={value:Number}
@blur input 失去焦点时触发事件,返回参数为uniSearchBar的value e={value:Number}

替换 icon 的 slot 插槽

插槽称名 说明
searchIcon 替换组件的搜索图标
clearIcon 替换组件的清除图标
<!-- 替换组件的搜索图标 -->
<uni-search-bar placeholder="自定义searchIcon" @confirm="search" @cancel="cancel" cancel-text="cancel">
	<uni-icons slot="searchIcon" color="#999999" size="18" type="home" />
</uni-search-bar>

<!-- 替换组件的清除图标 -->
<uni-search-bar placeholder="自定义clearIcon" @confirm="search" @cancel="cancel" cancel-text="cancel">
	<view slot="clearIcon" style="color: #999999" >X</view>
</uni-search-bar>

组件示例

点击查看:https://hellouniapp.dcloud.net.cn/pages/extUI/search-bar/search-bar