为页面提供导航功能,常用于页面顶部。
通过以下方式来全局注册组件,更多注册方式请参考组件注册。
import { createApp } from "vue";
import { NavBar } from "vant";
const app = createApp();
app.use(NavBar);
<van-nav-bar
title="标题"
left-text="返回"
right-text="按钮"
left-arrow
@click-left="onClickLeft"
@click-right="onClickRight"
/>
import { Toast } from "vant";
export default {
setup() {
const onClickLeft = () => Toast("返回");
const onClickRight = () => Toast("按钮");
return {
onClickLeft,
onClickRight,
};
},
};
通过插槽自定义导航栏两侧的内容。
<van-nav-bar title="标题" left-text="返回" left-arrow>
<template #right>
<van-icon name="search" size="18" />
</template>
</van-nav-bar>
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
title | 标题 | string | ""
|
left-text | 左侧文案 | string | ""
|
right-text | 右侧文案 | string | ""
|
left-arrow | 是否显示左侧箭头 | boolean | false
|
border | 是否显示下边框 | boolean | true
|
fixed | 是否固定在顶部 | boolean | false
|
placeholder | 固定在顶部时,是否在标签位置生成一个等高的占位元素 | boolean | false
|
z-index | 导航栏 z-index | number | string | 1
|
safe-area-inset-top | 是否开启顶部安全区适配 | boolean | false
|
名称 | 说明 |
---|---|
title | 自定义标题 |
left | 自定义左侧区域内容 |
right | 自定义右侧区域内容 |
事件名 | 说明 | 回调参数 |
---|---|---|
click-left | 点击左侧按钮时触发 | event: MouseEvent |
click-right | 点击右侧按钮时触发 | event: MouseEvent |
组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件。
名称 | 默认值 | 描述 |
---|---|---|
--van-nav-bar-height | 46px | - |
--van-nav-bar-background-color | var(--van-white) | - |
--van-nav-bar-arrow-size | 16px | - |
--van-nav-bar-icon-color | var(--van-primary-color) | - |
--van-nav-bar-text-color | var(--van-primary-color) | - |
--van-nav-bar-title-font-size | var(--van-font-size-lg) | - |
--van-nav-bar-title-text-color | var(--van-text-color) | - |
--van-nav-bar-z-index | 1 | - |
Element 组件内部默认使用中文,若希望使用其他语言,则需要进行多语言设置。以英文为例,在 main.js 中:import { i18n } from ...
当一个数据集合有清晰的层级结构时,可通过级联选择器逐级查看并选择。基础用法有两种触发子菜单的方式只需为 Cascader 的option...
Avatar 头像用图标、图片或者字符的形式展示用户或事物信息。基本用法通过shape和size设置头像的形状和大小。templateel-row cla...
action.timeline | *时间轴组件相关的行为,必须引入时间轴组件后才能使用。action.timeline.timelineChange | Action设置当前的...