1.5.1 • Published 1 year ago

@wines/search-bar v1.5.1

Weekly downloads
-
License
-
Repository
-
Last release
1 year ago

@wines/search-bar

SearchBar 搜索栏

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

使用指南

在 page.json 中引入组件

{
  "navigationBarTitleText": "SearchBar",
  "usingComponents": {
    "wux-search-bar": "@wines/search-bar"
  }
}

示例

<view class="page">
	<view class="page__hd">
		<view class="page__title">SearchBar</view>
		<view class="page__desc">搜索栏</view>
	</view>
	<view class="page__bd">
		<view class="sub-title">Normal</view>
		<wux-search-bar clear maxlength="8" />
		<view class="sub-title">Focus</view>
		<wux-search-bar clear focus />
		<view class="sub-title">Show cancel button</view>
		<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"
		/>
	</view>
</view>
import './index.less';

Page({
  data: {
    value: '',
  },
  onChange(e) {
    console.log('onChange', e);
    this.setData({
      value: e.detail.value,
    });
  },
  onFocus(e) {
    console.log('onFocus', e);
  },
  onBlur(e) {
    console.log('onBlur', e);
  },
  onConfirm(e) {
    console.log('onConfirm', e);
  },
  onClear(e) {
    console.log('onClear', e);
    this.setData({
      value: '',
    });
  },
  onCancel(e) {
    console.log('onCancel', e);
  },
});

API

SearchBar props

参数类型描述默认值
prefixClsstring自定义类名前缀wux-search-bar
defaultValuestring输入框的默认值,当 controlledfalse 时才生效-
valuestring输入框的当前值,当 controlledtrue 时才生效-
controlledboolean是否受控 说明文档false
placeholderstring输入框为空时占位符-
placeholder-stylestring,object指定 placeholder 的样式-
placeholder-classstring指定 placeholder 的样式类input-placeholder
disabledboolean是否禁用false
maxlengthnumber最大输入长度,设置为 -1 的时候不限制最大长度140
cursor-spacingnumber指定光标与键盘的距离,单位 px11
focusboolean获取焦点false
confirm-typestring设置键盘右下角按钮的文字,仅在type='text'时生效search
confirm-holdboolean点击键盘右下角按钮时是否保持键盘不收起false
cursornumber指定focus时的光标位置-1
selection-startnumber光标起始位置,自动聚集时有效,需与selection-end搭配使用-1
selection-endnumber光标结束位置,自动聚集时有效,需与selection-start搭配使用-1
adjust-positionboolean键盘弹起时,是否自动上推页面true
clearboolean是否显示清除图标,当 disabledfalse 时才生效false
cancelTextstring自定义取消按钮的文字取消
showCancelboolean是否一直显示取消按钮false
bind:changefunction键盘输入时触发-
bind:focusfunction输入框聚焦时触发-
bind:blurfunction输入框失去焦点时触发-
bind:confirmfunction点击完成按钮时触发-
bind:clearfunction点击清除图标时触发-
bind:cancelfunction点击取消按钮时触发-

SearchBar externalClasses

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

1 year ago

1.5.0

1 year ago

1.3.5

2 years ago

1.4.0

2 years ago

1.3.2

3 years ago

1.3.1

3 years ago

1.3.0

3 years ago