vant 移动端搜索框
时间: 2025-02-18 11:40:03 浏览: 56
### Vant 移动端 Search 组件使用教程
#### 一、安装与引入 Vant
为了在项目中使用 Vant 的 `Search` 组件,首先需要确保已经成功安装了 Vant 库。可以通过 Yarn 或 NPM 安装:
```bash
npm install vant
```
或者
```bash
yarn add vant
```
接着,在项目的入口文件(通常是 main.js)中按需引入 `Search` 组件[^2]。
```javascript
import { createApp } from 'vue';
import App from './App.vue';
import { Search } from 'vant';
const app = createApp(App);
app.use(Search);
app.mount('#app');
```
#### 二、基本用法
下面是一个简单的例子展示如何创建一个带有默认占位符文本的搜索框[^1]。
```html
<template>
<van-search
v-model="value"
show-action
placeholder="请输入搜索关键词"
@search="onSearch"
@cancel="onCancel"
/>
</template>
<script setup>
import { ref } from 'vue';
let value = ref('');
function onSearch() {
console.log('触发 search 事件', value.value);
}
function onCancel() {
console.log('取消');
}
</script>
```
此代码片段展示了如何监听用户的输入以及点击“搜索”按钮时的行为。当用户点击取消按钮时也会触发相应的回调函数。
#### 三、自定义样式
如果希望调整 `Search` 组件外观,则可以利用 CSS 变量来自定义主题颜色和其他属性。Vant 提供了一系列预设变量用于快速定制组件风格。
例如改变背景色和字体大小:
```css
.van-search__content--round {
background-color: #f7f8fa;
}
.van-field__control {
font-size: 16px !important;
}
```
以上就是关于 Vant 中移动端 `Search` 组件的基础介绍及其应用实例说明。
阅读全文
相关推荐

















