Skip to content

轻提示

使用方法 ​

Toast 是一种不打断操作的轻量反馈,用来确认操作结果或提示状态变化,数秒后自动消失。使用时,在应用根节点放置一次 ToastViewport,然后在任意组件中调用 useToast 弹出提示:

vue
<script setup lang="ts">
import { ToastViewport, useToast } from '@astryx-vue/core/Toast'

const toast = useToast()

toast({ body: '操作成功', type: 'success' })
</script>

<template>
  <div>
    <button @click="toast({ body: '已保存' })">
      保存
    </button>
    <ToastViewport />
  </div>
</template>

最佳实践 ​

指引实践
推荐将 ToastViewport 放在应用顶层,确保提示能覆盖所有页面,位置与堆叠顺序也保持一致。
推荐错误信息使用 type="error",组件会自动应用 role="alert",让屏幕阅读器优先播报。
推荐保持提示文本简洁,一行说明操作结果即可,用户通常只会扫一眼。
避免避免同时弹出大量提示:信息过载会让用户忽略真正重要的内容,必要时合并为一条。
避免避免用 Toast 替代需要用户确认的对话框:提示会自动消失,用户可能来不及做出响应。

示例 ​

基础用法

点击按钮即可触发轻提示,示例中展示了不同的 type 和 duration 组合。

堆叠

多条轻提示会在视口中依次堆叠,并保持出现的先后顺序。