Skip to content

NoticeBar 通告栏 ​

页面顶部/区块内的通告条:图标 + 文本 + 可关闭 + action 链接。文本超长时可横向无缝滚动(内嵌 oas-marquee 组合复用其滚动引擎);多条通告以 items 纵向轮播(淡入淡出,prefers-reduced-motion 下不自动轮播)。配色走语义 token,暗色主题自动适配。

基础用法 ​

默认通告(info)

系统将于今晚 23:00 – 24:00 进行例行维护,期间服务可能出现短暂波动。

通告类型 ​

type 支持 info(默认,主色系)/ success / warning / error,底色与图标色随语义 token 派生;图标缺省按类型自动匹配(icon="none" 不显示,icon 属性可指定任意图标名)。

四种类型

info:本周五 18:00 停服维护 30 分钟,请提前保存工作。success:数据同步已完成,共 128 条记录。warning:存储空间剩余不足 10%,请及时清理。error:网络连接中断,正在自动重试……

可关闭 ​

closable 显示关闭按钮:点击后派发 oas-close 并自隐藏(淡出退场);宿主重新设置 open 属性即可恢复显示(组件关闭时会自移除 open)。

可关闭 + 恢复

点右侧 ✕ 关闭本条通告,再用下方按钮恢复。
恢复显示

多条轮播(items) ​

items 传 JSON 字符串数组,多条通告纵向轮播(淡出 → 换文本 → 淡入),间隔 interval 毫秒(默认 4000)。prefers-reduced-motion 下不自动轮播,静态显示第一条;轮播自动播放时内容区 aria-live="off",不打扰读屏。非法 JSON / 空数组回退默认插槽单条内容。

items 轮播(interval=2500)

action 操作 ​

action-text 给出右侧操作文字;href 在场渲染为 <a>(原生导航),缺省渲染为 <button>(点击派发 oas-action-click)。

action:链接形态与按钮形态

链接形态:点击走原生导航(href 在场)。按钮形态:点击派发 oas-action-click(无 href)。

超长滚动(scrollable) ​

scrollable 开启后,单条内容超长时横向无缝滚动——内嵌 oas-marquee 组合复用其滚动引擎(无缝循环、内容不足一屏自动填充、prefers-reduced-motion 静态降级均由 marquee 承担)。注意:滚动副本处于组件 shadow 内,页面样式表的 class 选择器不作用于副本(行内样式保留),滚动内容建议用纯文本或行内样式;克隆不复制事件监听,副本内交互元素可见但不可交互。

scrollable:超长通告横向滚动

长通告:这是一条特别长的公告文本,用于演示超长内容的横向无缝滚动效果——无缝循环、恒定速度,悬停行为与 reduced-motion 降级由内嵌走马灯引擎统一处理。

图标自定义 ​

icon 属性指定图标名(oas-icon 体系),icon="none" 隐藏图标;slot="icon" 富内容优先。

icon 自定义与隐藏

icon="star":指定任意图标名。icon="none":不显示图标。置顶slot="icon":富内容覆盖图标(此例用标签充当图标位)。

API ​

oas-notice-bar ​

属性 ​

属性说明类型默认值
action-textaction 操作文字;缺省不渲染 action 区——
closable是否显示关闭按钮;点击派发 oas-close 并自隐藏(设 open 恢复)boolean—
hrefaction 链接地址:在场时 action 渲染为 <a>(原生导航),缺省渲染为 <button>(派发 oas-action-click);运行时增删切换形态——
icon图标名(oas-icon 体系);缺省按 type 自动匹配,icon="none" 不显示,非法名回落 type 默认;slot="icon" 富内容优先——
intervalitems 轮播间隔(毫秒,默认 4000);非法/非正数回退默认string—
items多条通告 JSON 字符串数组:纵向轮播(淡入淡出);非法 JSON/空数组回退默认插槽;items 优先于插槽;prefers-reduced-motion 下不自动轮播——
open恢复开关:关闭后设置即恢复显示(组件关闭时自移除本属性,在场 = 强制可见)boolean—
scrollable单条内容超长时横向无缝滚动(内嵌走马灯引擎);仅插槽单条模式生效(items 优先)boolean—
type通告类型:info(默认,主色系)/ success / warning / error;底色与图标色走语义 token,暗色自动适配;非法值回落 infostringinfo

事件 ​

事件说明
oas-action-clickaction 为按钮形态(无 href)点击时派发
oas-close点击关闭按钮后派发,随后组件自隐藏(淡出退场);宿主设 open 可恢复

插槽 ​

名称说明
默认单条通告内容(items 缺省时显示;scrollable 时物化为滚动内容)
icon图标插槽,覆盖默认/type 图标

Parts ​

Part说明
bar通告条容器
icon图标区
content内容区(插槽投影 / 轮播 / 走马灯的公共容器)
carouselitems 纵向轮播区
marquee内嵌走马灯(scrollable 模式)
action右侧操作区(a / button 形态共用)
close关闭按钮

基于 MIT OR Apache-2.0 双许可发布