扩展组件(uni-ui)之uni-search-bar

902 阅读1分钟

uni-search-bar 是 uni-app 的 uni-ui 组件库中的一个搜索栏组件,用于实现搜索功能的用户界面。这个组件通常包含一个文本输入框和搜索按钮,用户可以在输入框中输入搜索关键词,然后点击搜索按钮或键盘上的“搜索”键来执行搜索操作。

基本用法

在使用 uni-search-bar 之前,你需要确保已经正确安装了 uni-ui 库,并在页面中引入了 uni-search-bar 组件。

引入组件

<template>
    <uni-search-bar 
        v-model="keyword" 
        @confirm="onSearch" 
        @clear="onClear" 
        @input="onInput"
        placeholder="请输入搜索内容">
    </uni-search-bar>
</template>

<script>
    import uniSearchBar from '@dcloudio/uni-ui/lib/uni-search-bar/uni-search-bar.vue'
    export default {
        components: { uniSearchBar },
        data() {
            return {
                keyword: '' // 搜索关键词
            }
        },
        methods: {
            onSearch(value) {
                console.log('执行搜索:', value);
            },
            onClear() {
                console.log('清空搜索');
            },
            onInput(value) {
                console.log('输入内容:', value);
            }
        }
    }
</script>

属性

  • v-model:绑定搜索栏的值。
  • placeholder:输入框的占位符。
  • showAction:是否显示右侧取消按钮,默认为 false
  • confirm-type:设置键盘右下角按钮的文字,仅在 type='text' 时生效。

事件

  • confirm:点击键盘上的搜索按钮时触发,返回输入框的内容。
  • clear:点击清空按钮时触发。
  • input:输入框内容发生变化时触发。

示例

以下是 uni-search-bar 组件的使用示例:

<uni-search-bar v-model="keyword" placeholder="请输入搜索内容" @confirm="onSearch"></uni-search-bar>

注意事项

  • 使用 v-model 绑定搜索栏的值,可以轻松获取和更新用户输入的内容。
  • confirm 事件通常用于获取用户输入并执行搜索操作。
  • 如果你想在用户输入时即时获取输入框的内容,可以使用 input 事件。

更多关于 uni-search-bar 组件的使用细节,可以查阅 uni-ui 官方文档 或 uni-ui 库的相关文档。