搜索栏 SearchBar

搜索栏 SearchBar

搜索组件的搜索栏。

基础用法

通过placeholder属性设置搜索框占位符。

通过cancel-text属性更改输入框后面的文字内容，默认值为取消。

示例代码

  <l-search-bar placeholder="搜索"/>

更改搜索框形状及背景颜色

通过shape属性设置搜索框形状。

通过bg-color属性设置搜索框背景颜色。

示例代码

  <l-search-bar placeholder="搜索"
                bg-color="#f6f6f6"
                shape="circle"/>

设置地址

通过front-text属性设置搜索框前的地址。

  <l-search-bar placeholder="搜索"
                bg-color="#f6f6f6"
                shape="circle"
                front-text="北京"/>

是否显示取消文字

通过show-cancel属性设置是否显示取消文字。

示例代码

  <l-search-bar placeholder="搜索"
                show-cancel="{{false}}"/>

设置插槽内容

设置slot='before'可自定义搜索框前部的内容。

设置slot='after'可自定义搜索框后面的内容。

设置slot='icon'可自定义搜索框图标部分的内容。需同时设置custom属性为true。

示例代码

  <l-search-bar placeholder="搜索">
    <!-- 此处是插槽内容 -->
    <view name="before"/>
  </l-search-bar>
  <l-search-bar placeholder="搜索">
    <!-- 此处是插槽内容 -->
    <view name="after"/>
  </l-search-bar>
  <l-search-bar placeholder="搜索" custom>
    <!-- 此处是插槽内容 -->
    <view name="icon"/>
  </l-search-bar>

搜索栏属性（Search Attributes）

参数	说明	类型	可选值	默认值
placeholder	设置搜索输入框占位符内容	String	—-	—-
cancel-text	设置搜索输入框后面的文字	String	—-	取消
show-cancel	设置是否显示取消文字	Boolean	—-	true
shape	设置搜索框形状	String	circle/primary	circle
icon	设置图标	String	—-	research
icon-color	设置图标颜色	String	—-	#bdbdbd
icon-size	设置图标大小	String	—-	28
custom	是否自定义图标部分内容	Boolean	—-	false
bg-color	设置搜索框背景颜色	String	—-	#f3f3f3
front-text	设置搜索框前的文字	String	—-	—-
focus	获取焦点	Boolean	true/false	false
type	input 的类型	String	—-	—-
value	输入框的初始内容	String	—-	—-
clear	是否显示清除按钮	Boolean	true/false	true
maxlength	最大输入长度，设置为 -1 的时候不限制最大长度	Number		140
placeholder-style	设置输入框占位文本的内联样式	String

搜索栏事件 (Search Events）

事件名称	说明	返回值	备注
bind:lincancel	点击取消文字触发	-	-
bind:linchange	键盘输入时触发	输入框当前值 value	-
bind:linfocus	输入框聚焦时触发	输入框当前值 value	-
bind:linblur	输入框失去焦点时触发	输入框当前值 value	-
bind:linconfirm	点击完成按钮时触发	输入框当前值 value	-
bind:linclear	点击清除按钮时触发	-	-
bind:linfronttap	点击`front-text`文字时触发	-	-

搜索栏插槽 (Search Slot)

插槽名称	说明	备注
before	自定义输入框左边的内容	—-
after	自定义输入框右边的内容	—-
icon	自定义图标的内容	需设置 custom 为`true`生效

搜索栏外部样式类 (Search ExternalClasses)

外部样式类名	说明	备注
l-class	设置输入框容器的样式类（灰色区域）	—-
l-container-class	设置输入框整体的样式类	—-
l-icon-class	设置图标的样式类	—-
l-input-class	设置输入框的样式类	—-
l-cancel-class	设置取消文字的样式类	—-
l-placeholder-class	设置输入框占位符的样式类	—-