SearchBar 搜索栏

用于展现搜索栏,提醒用户输入相关内容进行搜索。

使用指南

在 page.json 中引入组件

  1. {
  2. "navigationBarTitleText": "SearchBar",
  3. "usingComponents": {
  4. "wux-search-bar": "../../dist/search-bar/index"
  5. }
  6. }

示例

  1. <view class="page">
  2. <view class="page__hd">
  3. <view class="page__title">SearchBar</view>
  4. <view class="page__desc">搜索栏</view>
  5. </view>
  6. <view class="page__bd">
  7. <view class="sub-title">Normal</view>
  8. <wux-search-bar clear maxlength="8" />
  9. <view class="sub-title">Focus</view>
  10. <wux-search-bar clear focus />
  11. <view class="sub-title">Show cancel button</view>
  12. <wux-search-bar clear show-cancel value="{{ value }}" controlled placeholder="Search" bind:change="onChange" bind:focus="onFocus" bind:blur="onBlur" bind:confirm="onConfirm" bind:clear="onClear" bind:cancel="onCancel" />
  13. </view>
  14. </view>
  1. Page({
  2. data: {
  3. value: '',
  4. },
  5. onChange(e) {
  6. console.log('onChange', e)
  7. this.setData({
  8. value: e.detail.value,
  9. })
  10. },
  11. onFocus(e) {
  12. console.log('onFocus', e)
  13. },
  14. onBlur(e) {
  15. console.log('onBlur', e)
  16. },
  17. onConfirm(e) {
  18. console.log('onConfirm', e)
  19. },
  20. onClear(e) {
  21. console.log('onClear', e)
  22. this.setData({
  23. value: '',
  24. })
  25. },
  26. onCancel(e) {
  27. console.log('onCancel', e)
  28. },
  29. })

视频演示

SearchBar

API

SearchBar props

参数 类型 描述 默认值
prefixCls string 自定义类名前缀 wux-search-bar
defaultValue string 输入框的默认值,当 controlledfalse 时才生效 -
value string 输入框的当前值,当 controlledtrue 时才生效 -
controlled boolean 是否受控 说明文档 false
placeholder string 输入框为空时占位符 -
placeholder-style string,object 指定 placeholder 的样式 -
placeholder-class string 指定 placeholder 的样式类 input-placeholder
disabled boolean 是否禁用 false
maxlength number 最大输入长度,设置为 -1 的时候不限制最大长度 140
cursor-spacing number 指定光标与键盘的距离,单位 px 11
focus boolean 获取焦点 false
confirm-type string 设置键盘右下角按钮的文字,仅在type=’text’时生效 search
confirm-hold boolean 点击键盘右下角按钮时是否保持键盘不收起 false
cursor number 指定focus时的光标位置 -1
selection-start number 光标起始位置,自动聚集时有效,需与selection-end搭配使用 -1
selection-end number 光标结束位置,自动聚集时有效,需与selection-start搭配使用 -1
adjust-position boolean 键盘弹起时,是否自动上推页面 true
clear boolean 是否显示清除图标,当 disabledfalse 时才生效 false
cancelText string 自定义取消按钮的文字 取消
showCancel boolean 是否一直显示取消按钮 false
bind:change function 键盘输入时触发 -
bind:focus function 输入框聚焦时触发 -
bind:blur function 输入框失去焦点时触发 -
bind:confirm function 点击完成按钮时触发 -
bind:clear function 点击清除图标时触发 -
bind:cancel function 点击取消按钮时触发 -

SearchBar externalClasses

名称 描述
wux-class 根节点样式类