雜項
匯入
import { defaultConverter } from 'lit';
類型
ComplexAttributeConverter
一個布林值,在伺服器環境(如 Node)中將為 true
,而在瀏覽器環境中將為 false
。請注意,您的伺服器環境或工具鏈必須支援 "node"
匯出條件,才能使此值為 true
。
匯入
import { isServer } from 'lit';
類型
false
詳細資訊
這可以在撰寫元件時使用,以根據元件是否在 SSR 環境中執行來變更行為。
包含屬於不穩定除錯 API 的類型。
匯入
import { LitUnstable } from 'lit';
詳細資訊
此 API 中的所有內容皆不穩定,並且未來可能會變更或移除,即使在修補程式版本中也是如此。
方法和屬性
當 Lit 在開發模式下執行且 window.emitLitDebugLogEvents
為 true 時,我們會將 'lit-debug' 事件發送到 window,並提供有關更新和渲染生命週期的即時詳細資訊。這些對於撰寫除錯工具和視覺化非常有用。
詳細資訊
請注意,在 window.emitLitDebugLogEvents 執行的情況下,會有效能上的開銷,這會使某些通常非常便宜的操作(例如無操作渲染)變得慢得多,因為我們必須複製資料並發送事件。
如果 value
與 oldValue
不同,則傳回 true 的變更函式。此方法用作屬性 hasChanged
函式的預設值。
匯入
import { notEqual } from 'lit';
簽名
notEqual(value, old): boolean
參數
- value
unknown
- old
unknown
包含屬於不穩定除錯 API 的類型。
匯入
import { ReactiveUnstable } from 'lit';
詳細資訊
此 API 中的所有內容皆不穩定,並且未來可能會變更或移除,即使在修補程式版本中也是如此。
方法和屬性
當 Lit 在開發模式下執行且 window.emitLitDebugLogEvents
為 true 時,我們會將 'lit-debug' 事件發送到 window,並提供有關更新和渲染生命週期的即時詳細資訊。這些對於撰寫除錯工具和視覺化非常有用。
詳細資訊
請注意,在 window.emitLitDebugLogEvents 執行的情況下,會有效能上的開銷,這會使某些通常非常便宜的操作(例如無操作渲染)變得慢得多,因為我們必須複製資料並發送事件。
Template 的可更新執行個體。持有用於更新模板執行個體的 Parts 參考。
匯入
import { TemplateInstance } from 'lit';
方法和屬性
new TemplateInstance(template, parent): TemplateInstance
連結至建構函式參數
- template
Template
- parent
ChildPart
包含屬於不穩定除錯 API 的類型。
匯入
import { Unstable } from 'lit';
詳細資訊
此 API 中的所有內容皆不穩定,並且未來可能會變更或移除,即使在修補程式版本中也是如此。
方法和屬性
當 Lit 在開發模式下執行且 window.emitLitDebugLogEvents
為 true 時,我們會將 'lit-debug' 事件發送到 window,並提供有關更新和渲染生命週期的即時詳細資訊。這些對於撰寫除錯工具和視覺化非常有用。
詳細資訊
請注意,在 window.emitLitDebugLogEvents 執行的情況下,會有效能上的開銷,這會使某些通常非常便宜的操作(例如無操作渲染)變得慢得多,因為我們必須複製資料並發送事件。
匯入
import { CompiledTemplate } from 'lit';
方法和屬性
匯入
import { CompiledTemplateResult } from 'lit';
方法和屬性
匯入
import { DirectiveParent } from 'lit';
匯入
import { Disconnectable } from 'lit';
匯入
import { HasChanged } from 'lit';
簽名
HasChanged(value, old): boolean
參數
- value
unknown
- old
unknown
匯入
import { HTMLTemplateResult } from 'lit';
類型
TemplateResult<HTML_RESULT>
匯入
import { Initializer } from 'lit';
類型
(element: ReactiveElement) => void
請勿使用,建議改用 PropertyValues
。
匯入
import { PropertyValueMap } from 'lit';
方法和屬性
參數
- k
K
參數
- k
K
參數
- k
K
參數
- key
K
- value
T[K]
從 render
返回的頂層 ChildPart
,用於管理在其下方整個樹狀結構中建立的 AsyncDirective
的連線狀態。
匯入
import { RootPart } from 'lit';
方法和屬性
該部分的尾端標記節點(如果有的話)。請參閱 .parentNode
以取得更多資訊。
該部分將內容呈現到的父節點。
詳細資訊
ChildPart 的內容由 .parentNode
的相鄰子節點範圍組成,可能以「標記節點」(.startNode
和 .endNode
)作為邊界。
- 如果
.startNode
和.endNode
都不為 null,則該部分的內容由.startNode
和.endNode
之間的所有同層級節點(不包含.startNode
和.endNode
本身)組成。 - 如果
.startNode
不為 null,但.endNode
為 null,則該部分的內容由.startNode
後面的所有同層級節點組成,直到並包含.parentNode
的最後一個子節點。如果.endNode
不為 null,則.startNode
將始終不為 null。 - 如果
.endNode
和.startNode
都為 null,則該部分的內容由.parentNode
的所有子節點組成。
該部分的前導標記節點(如果有的話)。請參閱 .parentNode
以取得更多資訊。
設定此根 ChildPart 中包含的 AsyncDirective
的連線狀態。
參數
- isConnected
布林值
此樹狀結構中的指令是否應該連線
詳細資訊
lit-html 不會自動監控呈現的 DOM 的連線狀態;因此,呼叫者有責任在可能丟棄部分物件之前,確保呼叫 part.setConnected(false)
,以確保 AsyncDirective
有機會處置所持有的任何資源。如果先前已中斷連線的 RootPart
隨後重新連線(並且其 AsyncDirective
應重新連線),則應呼叫 setConnected(true)
。
一個函式,可以對將寫入特定種類 DOM 接收器的值進行清理。
匯入
import { ValueSanitizer } from 'lit';
類型
(value: unknown) => unknown
詳細資訊
請參閱 SanitizerFactory。
一個字串,表示其中一個支援的開發模式警告類別。
匯入
import { WarningKind } from 'lit';
類型
"change-in-update" | "migration"