CSS: alert

.instui-alert · stable — 一則帶有狀態色條與來自共用圖示集的遮罩狀態圖示的內嵌訊息。

預設為浮動（Floating），具有帶色澤的提升表面和同色系操作。-inline 使用淡色表面、無陰影、狀態色圖示、標準關閉按鈕、主要操作與第三等級的次要操作。單一直接操作按鈕會在未換行的文字後方成列；將兩個操作包在 .button-group 中，會先成為次要然後主要。任一按鈕修飾器會使此自動樣式分配失效。直接的關閉按鈕預設為 small；加入尺寸修飾器以覆寫。

Source: alert.css

TIP

JS 加強 — 此元件的 CSS 可獨立呈現與運作；與 @pantoken/interactions 搭配可加入互動行為。其 -timeout 修飾符由該行為驅動。參見下方的 modifier table。

無障礙

對於重要訊息，新增 role="alert" 或一個 aria-live 區域以便輔助技術能夠宣告；關閉控制是一個已標示的關閉按鈕（範例中的 .instui-close-button 帶有 aria-label="Close"）。

使用方法

css

@import "@pantoken/components/components.css";
@import "@pantoken/components/alert.css";

範例

html

<div class="instui-alert -icon-megaphone --mb-md">
  一個具有預設的警示 </div>
<div class="instui-alert -icon-megaphone -inline --mb-md">
  一個具有預設的警示 </div>
<div class="instui-alert -color-success --mb-md">
  恭喜！你正在使用「success」色彩.
  <button class="instui-button">確定</button>
  <button class="instui-close-button" aria-label="Close"></button>
</div>
<div class="instui-alert -color-success -inline --mb-md">
  恭喜！你正在使用「success」色彩.
  <button class="instui-button">確定</button>
  <button class="instui-close-button" aria-label="Close"></button>
</div>
<div class="instui-alert -color-error --mb-md">
  恭喜！你正在使用「success」色彩.
  <div class="button-group">
    <button class="instui-button">取消</button>
    <button class="instui-button">確定</button>
  </div>
  <button class="instui-close-button" aria-label="Close"></button>
</div>
<div class="instui-alert -color-error -inline --mb-md">
  恭喜！你正在使用「success」色彩.
  <div class="button-group">
    <button class="instui-button">取消</button>
    <button class="instui-button">確定</button>
  </div>
  <button class="instui-close-button" aria-label="Close"></button>
</div>
<div class="instui-alert -color-warning --mb-md">
  恭喜！你正在使用「success」色彩.
  <div class="button-group">
    <button class="instui-button">取消</button>
    <button class="instui-button">確定</button>
  </div>
  <button class="instui-close-button" aria-label="Close"></button>
</div>
<div class="instui-alert -color-warning -inline --mb-md">
  恭喜！你正在使用「success」色彩.
  <div class="button-group">
    <button class="instui-button">取消</button>
    <button class="instui-button">確定</button>
  </div>
  <button class="instui-close-button" aria-label="Close"></button>
</div>

結構

text

.instui-alert
  ‹content›
  (choose one)
    bare-button
      button (component, 0..1)
    button-group
      .button-group
        button (component, 1..2)
  close-button (component, 0..1)

flowchart TD n0[".instui-alert"]:::cssdoc-root n1[/"‹content›"/]:::cssdoc-slot subgraph sg2 subgraph sg3 ["bare-button"] n4["@component button (0..1)"]:::cssdoc-root end subgraph sg5 ["button-group"] n6[".button-group"]:::cssdoc-root n7(["button"]):::cssdoc-component end end n8(["close-button"]):::cssdoc-component n0 --> n1 n6 -->|1..2| n7 n0 --> sg2 n0 -.->|0..1| n8 click n7 "/api/css/button.md" click n8 "/api/css/close-button.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

插槽

插槽	說明
`content`	警示的訊息內容；可包含一個關閉按鈕。

修飾器

修飾器	說明
`.-color-danger`	錯誤訊息。
`.-color-error`	Alias — maps to `.-color-danger`.
`.-color-info`	資訊性（預設）。
`.-color-success`	正向／確認訊息。
`.-color-warning`	警示／注意訊息。
`.-has-shadow-false`	Alias — maps to `.-without-shadow`.
`.-icon-*`	用自訂圖示替換狀態圖示（例如 `-icon-megaphone`），在變體的彩色色條上保持為白色。
`.-inline`	一個非提升（non-elevated）的淡色表面，適於文件流程中的放置。
`.-screen-reader-only`	視覺上隱藏但會被宣告。
`.-timeout`	Interaction — The alert will automatically dismiss after a default of 5 seconds.
`.-timeout-1`	自動關閉前一秒。
`.-timeout-2`	自動關閉前兩秒。
`.-timeout-3`	自動關閉前三秒。
`.-timeout-4`	自動關閉前四秒。
`.-timeout-5`	自動關閉前五秒。
`.-variant-error`	已棄用 — use `.-color-danger`.
`.-variant-info`	已棄用 — use `.-color-info`.
`.-variant-success`	已棄用 — use `.-color-success`.
`.-variant-warning`	已棄用 — use `.-color-warning`.
`.-without-shadow`	已棄用 — use `.-inline`.

部件

部件	說明
`.button-group`	用於引言與來源標註的容器。

偽元素

偽元素	說明
`::after`	白色狀態圖示，被遮罩並置中於色條上。
`::before`	—

狀態

狀態	說明
`[aria-disabled="true"]`	—
`:disabled`	—

自訂屬性

屬性	型別	預設	說明
`--pantoken-alert-glyph`	`<url>`	—	低階的狀態圖示來源；`-icon-<name>` 會為你設定。可覆寫為自訂圖示（URL 編碼的 SVG）。
`--pantoken-alert-icon-bg`	`<color>`	—	圖示後方的彩色狀態色條填充；每個 `-color-*` 變體會設定其自己的填充。
`--timeout`	`<integer>`	—	自動關閉前的毫秒數；`0` 可停用。需要 alert 互動套件。

已使用的代幣

Token	型別	值
`--instui-color-background-interactive-action-primary-active`	`<color>`	LightDark`light-dark(#061C30, #D5E2F6)`
`--instui-color-background-interactive-action-primary-base`	`<color>`	LightDark`light-dark(#1D354F, #EEF4FD)`
`--instui-color-background-interactive-action-primary-hover`	`<color>`	LightDark`light-dark(#234465, #ffffff)`
`--instui-color-drop-shadow-shadow-color1`	`<color>`	LightDark`light-dark(rgba(35,68,101,0.15), rgba(0,0,0,0.3))`
`--instui-color-icon-base`	`<color>`	LightDark`light-dark(#273540, #ffffff)`
`--instui-color-icon-error`	`<color>`	LightDark`light-dark(#C51F22, #FA917F)`
`--instui-color-icon-info`	`<color>`	LightDark`light-dark(#2369A4, #7FB4F1)`
`--instui-color-icon-on-color`	`<color>`	`#ffffff`
`--instui-color-icon-success`	`<color>`	LightDark`light-dark(#017533, #61C378)`
`--instui-color-icon-warning`	`<color>`	LightDark`light-dark(#664800, #E0A300)`
`--instui-color-stroke-interactive-action-primary-active`	`<color>`	LightDark`light-dark(#061C30, #D5E2F6)`
`--instui-color-stroke-interactive-action-primary-base`	`<color>`	LightDark`light-dark(#1D354F, #EEF4FD)`
`--instui-color-stroke-interactive-action-primary-hover`	`<color>`	LightDark`light-dark(#234465, #ffffff)`
`--instui-color-text-base`	`<color>`	LightDark`light-dark(#273540, #F2F4F5)`
`--instui-color-text-interactive-action-primary-base`	`<color>`	LightDark`light-dark(#ffffff, #1D354F)`
`--instui-component-alert-border-radius`	`<length>`	`0.75rem`
`--instui-component-alert-border-style`	—	`solid`
`--instui-component-alert-border-width`	`<length>`	`0.0625rem`
`--instui-component-alert-content-font-family`	`[ <font-family-name> \| <generic-font-family> ]#`	`Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif`
`--instui-component-alert-content-font-size`	`<length>`	`1rem`
`--instui-component-alert-content-font-weight`	`<integer>`	`400`
`--instui-component-alert-content-line-height`	`<percentage>`	`125%`
`--instui-component-alert-content-padding-horizontal`	`<length>`	`0.75rem`
`--instui-component-alert-content-padding-vertical`	`<length>`	`0.75rem`
`--instui-component-alert-danger-background`	`<color>`	`#E62429`
`--instui-component-alert-danger-background-inline`	`<color>`	LightDark`light-dark(#FFE3DE, #750D0F)`
`--instui-component-alert-danger-border-color`	`<color>`	`#E62429`
`--instui-component-alert-danger-border-color-inline`	—	`color-mix(in srgb, light-dark(#5F6E7A, #9EA6AD) 20%, transparent)`
`--instui-component-alert-icon-padding-left`	`<length>`	`0.75rem`
`--instui-component-alert-icon-padding-vertical`	`<length>`	`1rem`
`--instui-component-alert-info-background`	`<color>`	`#2B7ABC`
`--instui-component-alert-info-background-inline`	`<color>`	LightDark`light-dark(#DEEBFF, #123E62)`
`--instui-component-alert-info-border-color`	`<color>`	`#2B7ABC`
`--instui-component-alert-info-border-color-inline`	—	`color-mix(in srgb, light-dark(#5F6E7A, #9EA6AD) 20%, transparent)`
`--instui-component-alert-success-background`	`<color>`	`#03893D`
`--instui-component-alert-success-background-inline`	`<color>`	LightDark`light-dark(#CAF4D0, #01451B)`
`--instui-component-alert-success-border-color`	`<color>`	`#03893D`
`--instui-component-alert-success-border-color-inline`	—	`color-mix(in srgb, light-dark(#5F6E7A, #9EA6AD) 20%, transparent)`
`--instui-component-alert-warning-background`	`<color>`	LightDark`light-dark(#F0C16C, #8C6400)`
`--instui-component-alert-warning-background-inline`	`<color>`	LightDark`light-dark(#F7E7CF, #4D3600)`
`--instui-component-alert-warning-border-color`	`<color>`	LightDark`light-dark(#F0C16C, #8C6400)`
`--instui-component-alert-warning-border-color-inline`	—	`color-mix(in srgb, light-dark(#5F6E7A, #9EA6AD) 20%, transparent)`
`--instui-component-base-button-medium-height`	`<length>`	`2.5rem`
`--instui-component-base-button-primary-disabled-background-color`	`<color>`	LightDark`light-dark(#C7CACD, #4A5B68)`
`--instui-component-base-button-primary-disabled-border-color`	`<color>`	LightDark`light-dark(#C7CACD, #4A5B68)`
`--instui-component-base-button-primary-disabled-text-color`	`<color>`	LightDark`light-dark(#F2F4F5, #273540)`
`--instui-component-base-button-primary-ghost-active-background`	—	`color-mix(in srgb, light-dark(#1D354F, #EEF4FD) 20%, transparent)`
`--instui-component-base-button-primary-ghost-border-color`	—	`color-mix(in srgb, light-dark(#1D354F, #EEF4FD) 40%, transparent)`
`--instui-component-base-button-primary-ghost-color`	`<color>`	LightDark`light-dark(#1D354F, #EEF4FD)`
`--instui-component-base-button-primary-ghost-hover-background`	—	`color-mix(in srgb, light-dark(#1D354F, #EEF4FD) 10%, transparent)`
`--instui-component-base-button-primary-inverse-active-background`	`<color>`	`#E2EAF7`
`--instui-component-base-button-primary-inverse-background`	`<color>`	`#ffffff`
`--instui-component-base-button-primary-inverse-border-color`	`<color>`	`#ffffff`
`--instui-component-base-button-primary-inverse-color`	`<color>`	`#213D5B`
`--instui-component-base-button-primary-inverse-ghost-active-background`	`<color>`	`rgba(255,255,255,0.1)`
`--instui-component-base-button-primary-inverse-ghost-border-color`	`<color>`	`#ffffff`
`--instui-component-base-button-primary-inverse-ghost-color`	`<color>`	`#ffffff`
`--instui-component-base-button-primary-inverse-ghost-hover-background`	`<color>`	`rgba(255,255,255,0.1)`
`--instui-component-base-button-primary-inverse-hover-background`	`<color>`	`#EEF4FD`
`--instui-component-base-button-primary-on-color-active-border-color`	`<color>`	`#B6CCEA`
`--instui-component-base-button-primary-on-color-active-text-color`	`<color>`	`#213D5B`
`--instui-component-base-button-primary-on-color-disabled-background-color`	`<color>`	`#8D959F`
`--instui-component-base-button-primary-on-color-disabled-border-color`	`<color>`	`#8D959F`
`--instui-component-base-button-primary-on-color-disabled-text-color`	`<color>`	`#4A5B68`
`--instui-component-base-button-primary-on-color-hover-border-color`	`<color>`	`#D5E2F6`
`--instui-component-base-button-primary-on-color-hover-text-color`	`<color>`	`#213D5B`
`--instui-component-base-button-secondary-on-color-active-border-color`	`<color>`	`#B6CCEA`
`--instui-component-base-button-secondary-on-color-active-text-color`	`<color>`	`#ffffff`
`--instui-component-base-button-secondary-on-color-disabled-border-color`	`<color>`	`#8D959F`
`--instui-component-base-button-secondary-on-color-disabled-text-color`	`<color>`	`#9EA6AD`
`--instui-component-base-button-small-font-size`	`<length>`	`0.875rem`
`--instui-component-base-button-small-height`	`<length>`	`2rem`
`--instui-component-base-button-small-padding-horizontal`	`<length>`	`0.75rem`
`--instui-component-base-button-tertiary-active-border-color`	—	`color-mix(in srgb, light-dark(#1D354F, #EEF4FD) 30%, transparent)`
`--instui-component-base-button-tertiary-active-text-color`	`<color>`	LightDark`light-dark(#1D354F, #EEF4FD)`
`--instui-component-base-button-tertiary-disabled-border-color`	`<color>`	LightDark`light-dark(#C7CACD, #4A5B68)`
`--instui-component-base-button-tertiary-disabled-text-color`	`<color>`	LightDark`light-dark(#AAB0B5, #4A5B68)`
`--instui-component-base-button-tertiary-hover-border-color`	—	`color-mix(in srgb, light-dark(#1D354F, #EEF4FD) 20%, transparent)`
`--instui-component-base-button-tertiary-hover-text-color`	`<color>`	LightDark`light-dark(#1D354F, #EEF4FD)`
`--instui-component-shared-tokens-spacing-gap-buttons`	`<length>`	`0.75rem`
`--instui-component-shared-tokens-spacing-general-space-md`	`<length>`	`0.75rem`
`--instui-component-text-base-on-color`	`<color>`	`#ffffff`
`--instui-drop-shadow-blur-elevation4-dropshadow1`	`<length>`	`12px`
`--instui-drop-shadow-spread-elevation4-dropshadow1`	`<length>`	`6px`
`--instui-drop-shadow-y-elevation4-dropshadow1`	`<length>`	`8px`
`--instui-icon-circle-check`	`<image>`	`url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Ccircle%20cx%3D%2212%22%20cy%3D%2212%22%20r%3D%2210%22%2F%3E%3Cpath%20d%3D%22m16%209-5.5%205.5L8%2012%22%2F%3E%3C%2Fsvg%3E')`
`--instui-icon-circle-x`	`<image>`	`url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Ccircle%20cx%3D%2212%22%20cy%3D%2212%22%20r%3D%2210%22%2F%3E%3Cpath%20d%3D%22m15%209-6%206%22%2F%3E%3Cpath%20d%3D%22m9%209%206%206%22%2F%3E%3C%2Fsvg%3E')`
`--instui-icon-info`	`<image>`	`url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Ccircle%20cx%3D%2212%22%20cy%3D%2212%22%20r%3D%2210%22%2F%3E%3Cpath%20d%3D%22M12%2016v-4%22%2F%3E%3Cpath%20d%3D%22M12%208h.01%22%2F%3E%3C%2Fsvg%3E')`
`--instui-icon-triangle-alert`	`<image>`	url('data:image/svg+xml;utf8,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20stroke%3D%22currentColor%22%20stroke-width%3D%222%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%3E%3Cpath%20d%3D%22m21.73%2018-8-14a2%202%200%200%200-3.48%200l-8%2014A2%202%200%200%200%204%2021h16a2%202%200%200%200%201.73-3%22%2F%3E%3Cpath%20d%3D%22M12%209v4%22%2F%3E%3Cpath%20d%3D%22M12%2017h.01%22%2F%3E%3C%2Fsvg%3E')
`--instui-spacing-space-xs`	`<length>`	`0.25rem`
`--pantoken-alert-icon-color`	`<color>`	`#ffffff`
`--pantoken-glyph`	`<url>`	`url("data:image/svg+xml`

元件

breadcrumb

calendar

drawer-layout

list

menu

modal

pagination

segmented-control

side-nav-bar

table

tabs

工具

規則

宣告

Plugins

layout

CSS: alert

無障礙

使用方法

範例

結構

插槽

修飾器

部件

偽元素

狀態

自訂屬性

已使用的代幣

子元件

相關

breadcrumb

calendar

drawer-layout

list

menu

modal

pagination

segmented-control

side-nav-bar

table

tabs

CSS: alert ​

無障礙 ​

使用方法 ​

範例 ​

結構 ​

插槽 ​

修飾器 ​

部件 ​

偽元素 ​

狀態 ​

自訂屬性 ​

已使用的代幣 ​

子元件 ​

相關 ​

CSS: alert

無障礙

使用方法

範例

結構

插槽

修飾器

部件

偽元素

狀態

自訂屬性

已使用的代幣

子元件

相關