提示
由于右侧的演示是通过iframe引入的,缺少移动端的@touchstart事件,故清除控件无效,请在真机演示中查看效果。
搜索组件,集成了常见搜索框所需功能,用户可以一键引入,开箱即用。
#平台差异说明
| App(vue) | App(nvue) | H5 | 小程序 |
| √ | √ | √ | √ |
#基本使用
- 通过
placeholder参数设置占位内容 - 通过
v-model双向绑定一个变量值,设置初始化时搜索框的值,如果初始内容为空,那么请绑定一个值为空字符的变量。
说明: 因为是双向绑定的,所以当组件内容输入框内容变化时,也会实时的反映到绑定的keyword变量,这意味着,您无需监听change事件, 也能实时的得知输入框的内容。
<template> <u-search placeholder="日照香炉生紫烟" v-model="keyword"></u-search> </template> <script> export default { data() { return { keyword: '遥看瀑布挂前川' } } } </script>
copy
#设置输入框形状
通过shape设置输入框两端的形状,square-方形带圆角,round(默认)-半圆形
<u-search shape="round"></u-search>
copy
#是否开启清除控件
clearabled(默认为true)设置为true的话,输入框有内容时,右边会显示一个清除的图标
<u-search :clearabled="true"></u-search>
copy
#是否开启右边控件
该控件为类似按钮形式,可以设置为"搜索"或者"取消"等内容,如果开启动画效果,用户确认搜索后,该控件会自动消失
showAction配置是否开启右边按钮控件actionText配置控件内容animation(默认为false)设置为true的话,失去焦点,或者点击控件按钮时,控件自动消失,并且带有动画效果
说明
- 如果不想点击右侧控件时自动消失,请把
animation设置为false - 右侧控件的默认文字为"搜索"(它本意为控件,碰巧内容为"搜索"二字,并非说它就是一个搜索按钮),点击它的时候触发的是
custom事件,而不是search事件
<u-search :showAction="true" actionText="搜索" :animation="true"></u-search>
copy
#自定义样式
- 通过
inputAlign设置输入框内容的对其方式,和css的text-align同理 - 通过
borderColor设置整个搜索组件的边框,只要配置了颜色,才会出现边框 - 通过
height设置组件高度 - 通过
disabled设置是否禁用输入框 - 通过
bgColor设置是搜索组件背景颜色
<u-search inputAlign="center" height="70"></u-search>