Skip to content

Notify 消息通知

消息通知组件,用于在页面顶部展示重要通知信息,支持多种通知类型和自定义样式。

平台差异说明

App(vue)App(nvue)H5小程序

基本使用

  • 通过 v-model:show 控制 Notify 的显示与隐藏。
  • 通过 message 设置通知文字。
vue
<template>
  <see-notify v-model:show="show" message="这是一条通知消息" />
  <button @click="show = true">显示通知</button>
</template>

<script lang="ts" setup>
import { ref } from 'vue'
const show = ref(false)
</script>

通知类型

  • 通过 type 参数设置通知类型,默认为 info
vue
<template>
  <see-notify v-model:show="showSuccess" message="更新成功" type="success" />
  <see-notify v-model:show="showError" message="网络错误" type="error" />
  <see-notify v-model:show="showWarning" message="警告信息" type="warning" />
  <see-notify v-model:show="showInfo" message="新消息" type="info" />
</template>

自定义样式

  • 通过 color 自定义文字颜色。
  • 通过 background 自定义背景色。
vue
<see-notify
  v-model:show="show"
  message="自定义样式通知"
  color="#FFFFFF"
  background="#7232dd"
/>

自定义图标

  • 通过 icon 参数设置自定义图标。
vue
<see-notify v-model:show="show" message="自定义图标通知" icon="bell" />

显示时长

  • 通过 duration 参数设置显示时长(毫秒)。
vue
<see-notify v-model:show="show" message="显示 5 秒" :duration="5000" />

可关闭通知

  • 通过 isClosable 设置是否可手动关闭。
vue
<see-notify v-model:show="show" message="可关闭的通知" :isClosable="true" />

安全区适配

  • 通过 isSafeArea 设置是否适配安全区,默认为 true
vue
<see-notify v-model:show="show" message="不适配安全区" :isSafeArea="false" />

命令式调用

Notify 支持命令式调用,无需在模板中声明组件。

ts
import { notify } from 'see-u-ui'

// 成功通知
notify.success('更新成功')

// 错误通知
notify.error('网络错误')

// 警告通知
notify.warning('警告信息')

// 信息通知
notify.info('新消息')

API

Props

参数名说明类型默认值可选值
show是否显示(v-model)booleanfalsetruefalse
message通知文字string''任意字符串
type通知类型'success' | 'error' | 'warning' | 'info''info'-
duration显示时长(ms)number3000任意数字
icon自定义图标string''图标名称
color自定义文字颜色string''任意 CSS 颜色值
background自定义背景色string''任意 CSS 颜色值
isClosable是否可手动关闭booleanfalsetruefalse
zIndexz-index 层级number2000任意数字
isSafeArea是否适配安全区booleantruetruefalse

Events

属性名说明
onClick点击通知时触发
onClose关闭时触发
update:showv-model 更新时触发

辽 ICP 备 2025070134 号