樣式
將指定的樣式套用至 shadowRoot
。當 Shadow DOM 可用但 adoptedStyleSheets
不可用時,樣式會附加到 shadowRoot
以 模擬規範行為。請注意,當使用墊片時,任何後續放入 shadowRoot 的樣式都應放在任何墊片化的採納樣式 *之前*。這將符合規範行為,使採納的樣式表優先於 shadowRoot 中的樣式。
匯入
import { adoptStyles } from 'lit';
簽名
adoptStyles(renderRoot, styles): void
參數
- renderRoot
ShadowRoot
- styles
Array<CSSResultOrNative>
一個範本字串標籤,可與 LitElement 的 styles
屬性搭配使用,以設定元素樣式。
匯入
import { css } from 'lit';
簽名
css(strings, values): CSSResult
參數
- strings
TemplateStringsArray
- values
Array<number | CSSResultGroup>
詳細資料
基於安全性考量,嵌入式表達式中只能使用字串字面值和數字。若要併入非字面值,可以使用表達式內的 unsafeCSS
。
CSS 文字字串的容器,可用於建立 CSSStyleSheet。
匯入
import { CSSResult } from 'lit';
詳細資料
CSSResult 是 css
標籤範本字串和 unsafeCSS()
的傳回值。為了確保 CSSResult 僅透過 css
標籤和 unsafeCSS()
建立,CSSResult 無法直接建構。
方法和屬性
匯入
import { getCompatibleStyle } from 'lit';
簽名
getCompatibleStyle(s): CSSResultOrNative
參數
目前瀏覽器是否支援 adoptedStyleSheets
。
匯入
import { supportsAdoptingStyleSheets } from 'lit';
類型
boolean
在 css
標籤範本字串中包裝一個用於內插的值。
匯入
import { unsafeCSS } from 'lit';
簽名
unsafeCSS(value): CSSResult
參數
- value
unknown
詳細資料
這是不安全的,因為不受信任的 CSS 文字可用於向攻擊者控制的網站發送資訊或洩露資料。請謹慎使用,僅使用受信任的輸入。
匯入
import { CSSResultArray } from 'lit';
類型
Array<CSSResultOrNative | CSSResultArray>
單一 CSSResult、CSSStyleSheet 或它們的陣列或巢狀陣列。
匯入
import { CSSResultGroup } from 'lit';
類型
CSSResultOrNative | CSSResultArray
CSSResult 或原生 CSSStyleSheet。
匯入
import { CSSResultOrNative } from 'lit';
類型
CSSResult | CSSStyleSheet
詳細資料
在支援可建構 CSS 樣式表的瀏覽器中,CSSStyleSheet 物件可與 css
範本標籤的 CSSResult 一起用於設定樣式。