反馈与浮层有已知边界

NnFloatingNotification 任务通知

带进度和操作区的固定位置通知。

示例

API

Props

名称	类型	默认值	说明
open	boolean	false	受控可见状态，配合 v-model:open。
rootClass	string | unknown[] | object	''	通知根节点附加 class。
title	string | number	''	标题；title 插槽优先。
description	string | number	''	最多显示三行的说明；description 插槽优先。
percent	number	0	内部进度条百分比。
showProgress	boolean	false	显示内部 NnProgress。
progressAriaLabel	string	'任务进度'	内部进度条的无障碍标签。
status	string	'loading'	loading、info、success、warning、error；其他值回退 loading。
closable	boolean	true	是否显示关闭按钮。
closeText	string	'关闭'	关闭按钮文字。
teleportTo	string | object	'body'	Teleport 目标选择器或 DOM 元素。

status 会映射内部进度条状态：loading→active、info→normal，其余同名。warning/error 使用 role="alert" 和 assertive live region，其他状态使用 role="status"。

Events

事件	参数	说明
update:open	(false)	点击内建关闭按钮时触发。
click	(event: MouseEvent)	点击通知正文时触发；操作区点击被拦截。
close	(event: MouseEvent)	点击内建关闭按钮时与更新事件一起触发。

Slots

名称	作用域参数	说明
icon	{ status: string }	自定义左侧图标。
title	—	替换标题。
description	—	替换说明。
default	—	标题和说明之后的附加正文。
actions	—	关闭按钮之前的操作区；其中的点击不会触发根节点 click。

当前限制

• 通知固定显示在视口右下角；组件没有堆叠管理，同一时刻打开多个实例会互相覆盖。
• 没有自动关闭计时。根节点点击和自定义 actions 不会自动关闭，调用方需要更新 open。