提示
由于右侧的演示是通过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>