Vant Weapp Notify 消息提示
2025-08-20 15:08 更新
介绍
在页面顶部展示消息提示,支持函数调用和组件调用两种方式。
引入
在app.json
或index.json
中引入组件,详细介绍见快速上手。
"usingComponents": {
"van-notify": "@vant/weapp/notify/index"
}
代码演示
基础用法
import Notify from '@vant/weapp/notify/notify';
Notify('通知内容');
<!-- 在页面内添加对应的节点 -->
<van-notify id="van-notify" />
通知类型
支持primary、success、warning、danger四种通知类型,默认为danger。
// 主要通知
Notify({ type: 'primary', message: '通知内容' });
// 成功通知
Notify({ type: 'success', message: '通知内容' });
// 危险通知
Notify({ type: 'danger', message: '通知内容' });
// 警告通知
Notify({ type: 'warning', message: '通知内容' });
自定义通知
自定义消息通知的颜色和展示时长。
Notify({
message: '自定义颜色',
color: '#ad0000',
background: '#ffe1e1',
});
Notify({
message: '自定义时长',
duration: 1000,
});
自定义选择器
Notify({
message: '自定义节点选择器',
duration: 1000,
selector: '#custom-selector',
});
<!-- 在页面内添加自定义节点 -->
<van-notify id="custom-selector" />
API
方法
方法名 | 说明 | 参数 | 返回值 |
---|---|---|---|
Notify | 展示提示 | options | message
|
notify 实例 |
Notify.clear | 关闭提示 | options
|
void
|
Options
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
type v1.0.0
|
类型,可选值为 primary success warning
|
string | danger
|
message v1.0.0
|
展示文案,支持通过\n 换行 |
string | ''
|
duration | 展示时长(ms),值为 0 时,notify 不会消失 | number | 3000
|
selector | 自定义节点选择器 | string | van-notify
|
color | 字体颜色 | string | #fff
|
top | 顶部距离 | number | 0
|
background | 背景颜色 | string | - |
context | 选择器的选择范围,可以传入自定义组件的 this 作为上下文 | object | 当前页面 |
onClick | 点击时的回调函数 | Function | - |
onOpened | 完全展示后的回调函数 | Function | - |
onClose | 关闭时的回调函数 | Function | - |
safeAreaInsetTop | 是否留出顶部安全距离(状态栏高度) | boolean | false
|
实例演示
以上内容是否对您有帮助:
更多建议: