Notify 消息提示

介绍

在页面顶部展示消息提示，支持组件调用和函数调用两种方式。

函数调用

为了便于使用 Notify，zebra 提供了一系列辅助函数，通过辅助函数可以快速唤起全局的消息提示。

比如使用 showNotify 函数，调用后会直接在页面中渲染对应的提示。

import { useNotify } from '../../uni_modules/zebra-ui'
const notify = useNotify()
notify.showNotify({
  message: '通知内容',
  type
})

基础用法

import { useNotify } from '../../uni_modules/zebra-ui'
const notify = useNotify()
// 3 秒后自动关闭
notify.showNotify('通知内容');
// 主动关闭
notify.closeNotify();

通知类型

支持 primary、success、warning、danger 四种通知类型，默认为 danger。

import { useNotify } from '../../uni_modules/zebra-ui'
const notify = useNotify()

// 主要通知
notify.showNotify({ type: 'primary', message: '通知内容' });

// 成功通知
notify.showNotify({ type: 'success', message: '通知内容' });

// 危险通知
notify.showNotify({ type: 'danger', message: '通知内容' });

// 警告通知
notify.showNotify({ type: 'warning', message: '通知内容' });

自定义通知

自定义消息通知的颜色、位置和展示时长。

notify.showNotify({
  message: '自定义颜色',
  color: '#ad0000',
  background: '#ffe1e1',
});

notify.showNotify({
  message: '自定义位置',
  position: 'bottom',
});

notify.showNotify({
  message: '自定义时长',
  duration: 1000,
});

使用 Notify 组件

如果需要在 Notify 内嵌入组件或其他自定义内容，可以直接使用 Notify 组件，并使用默认插槽进行定制。

<z-cell is-link title="使用 Notify 组件" @click="showComponentCall" />
<z-notify
  v-model:show="show"
  type="success"
  custom-navbar
  use-component
>
  <z-icon name="notification" />
  <text style="margin-left: 8rpx">内容</text>
</z-notify>

const show = ref(false)
const showComponentCall = () => {
  show.value = true
  setTimeout(() => {
    show.value = false
  }, 2000)
}

方法

zebra 中导出了以下 Notify 相关的辅助函数：

NotifyOptions

调用 showNotify 等方法时，支持传入以下选项：

Props

通过组件调用 Notify 时，支持以下 Props：

Events

通过组件调用 Notify 时，支持以下事件：

Slots

通过组件调用 Notify 时，支持以下插槽：

样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。