提示横幅

在内容上方放一条提示。显示什么、关掉以后还显示不显示,由页面决定。组件只负责画出来,并发出关闭。

要放按钮时,再引入对应的按钮。

标签何时使用
<md-alert-banner>页面内容上方的一条通知、说明、成功、警告或错误
<md-filled-button>横幅里的主操作
<md-outlined-button>横幅里的次操作
import 'genv4/alert-banner/alert-banner.js';
import 'genv4/button/filled-button.js';
import 'genv4/button/outlined-button.js';

宽度固定 740。父级更窄时横幅不缩小,由页面滚动。关闭按钮一直在。点关闭会发出 close,并加上 hidden,不再占高度。组件不记住这次关闭。页面去掉 hidden 就会再显示;页面如果记下关闭,下次可以不渲染。

<md-alert-banner label="普通通知" supporting-text="默认底色和图标。"></md-alert-banner>
<md-alert-banner scheme="informational" label="说明" supporting-text="补充一点信息。"></md-alert-banner>
<md-alert-banner scheme="success" label="已完成" supporting-text="这一步已经做完。"></md-alert-banner>
<md-alert-banner scheme="warning" label="请注意" supporting-text="继续之前先看一下。"></md-alert-banner>
<md-alert-banner scheme="error" label="无法保存" supporting-text="这次没有写入。"></md-alert-banner>
<md-alert-banner label="普通通知" supporting-text="平铺在页面上。"></md-alert-banner>
<md-alert-banner elevated label="普通通知" supporting-text="加上阴影,和背景分开。"></md-alert-banner>
确定取消确定取消确定取消确定取消确定取消
<md-alert-banner label="普通通知" supporting-text="实心按钮用主色。">
  <md-filled-button slot="actions">确定</md-filled-button>
  <md-outlined-button slot="actions">取消</md-outlined-button>
</md-alert-banner>
<md-alert-banner scheme="informational" label="说明" supporting-text="实心按钮改成深色。">
  <md-filled-button slot="actions">确定</md-filled-button>
  <md-outlined-button slot="actions">取消</md-outlined-button>
</md-alert-banner>
<md-alert-banner scheme="success" label="已完成" supporting-text="实心按钮改成深色。">
  <md-filled-button slot="actions">确定</md-filled-button>
  <md-outlined-button slot="actions">取消</md-outlined-button>
</md-alert-banner>
<md-alert-banner scheme="warning" label="请注意" supporting-text="实心按钮改成深色。">
  <md-filled-button slot="actions">确定</md-filled-button>
  <md-outlined-button slot="actions">取消</md-outlined-button>
</md-alert-banner>
<md-alert-banner scheme="error" label="无法保存" supporting-text="实心按钮改成深色。">
  <md-filled-button slot="actions">确定</md-filled-button>
  <md-outlined-button slot="actions">取消</md-outlined-button>
</md-alert-banner>

下表适用于 <md-alert-banner>。

属性HTML 属性类型默认值说明
schemescheme"warning" | "error" | "default" | "informational" | "success"'default'配色。取值 default、informational、success、warning、error。
elevatedelevatedbooleanfalse为真时加阴影。默认没有。
labellabelstring''标题。空字符串不画这一行。
supportingTextsupporting-textstring''正文。空字符串不画这一行。
iconiconstring''图标连字。空字符串时按 scheme 用默认图标。
事件类型冒泡穿透说明
closeEvent是是点关闭时发出。组件随即加上 hidden,不再占高度。组件不记住这次关闭,要不要再出现由页面决定。
名称说明
actions按钮。放 md-filled-button 或 md-outlined-button。横幅里按钮高 32。为空时不占位
checkbox勾选框和它的文字。组件只负责显示,不记勾选状态。为空时不占位

用组件 CSS 变量覆盖。下面只列出 Sass 里标记为支持的变量。

变量默认值
--md-alert-banner-button-color#0e131e
--md-alert-banner-button-gap6px
--md-alert-banner-button-height32px
--md-alert-banner-button-label-color--md-sys-color-on-primary
--md-alert-banner-button-label-line-height16px
--md-alert-banner-button-label-size12px
--md-alert-banner-button-label-weight600
--md-alert-banner-button-padding16px
--md-alert-banner-button-padding-block8px
--md-alert-banner-checkbox-label-line-height16px
--md-alert-banner-checkbox-label-size12px
--md-alert-banner-checkbox-label-tracking0.1px
--md-alert-banner-close-icon-color#0e131e
--md-alert-banner-close-icon-size16px
--md-alert-banner-close-size32px
--md-alert-banner-column-gap12px
--md-alert-banner-content-gap16px
--md-alert-banner-copy-min-size268px
--md-alert-banner-elevation0 1px 3px 0 rgba(0, 0, 0, .3), 0 4px 8px 3px rgba(0, 0, 0, .12)
--md-alert-banner-icon-container-height32px
--md-alert-banner-icon-container-shape999px
--md-alert-banner-icon-container-width32px
--md-alert-banner-icon-size16px
--md-alert-banner-label-line-height20px
--md-alert-banner-label-size14px
--md-alert-banner-label-tracking0.25px
--md-alert-banner-label-weight600
--md-alert-banner-min-height72px
--md-alert-banner-padding12px
--md-alert-banner-shape16px
--md-alert-banner-success-container-color#a8f5a6
--md-alert-banner-success-icon-color#3e8643
--md-alert-banner-supporting-weight400
--md-alert-banner-warning-container-color#ffdeaa
--md-alert-banner-warning-icon-color#9c6e03
--md-alert-banner-width740px

全部样式:alert-banner/internal/_alert-banner.scss

开发指南
快速开始主题问题与支持
Components
Ai Input提示横幅 Alert banner按钮 ButtonCheckboxChipsDialogsFloating action button (FAB)图标 Icon图标按钮 Icon ButtonLists菜单 MenuMenus弹窗 Modal步骤条 Process stepperProgress indicatorsRadioRipple搜索栏 Search BarSelectSlidersSwitchTabsText field文本输入 Text Input