ライフサイクル

グローバルライフサイクル

  • Starting: 初期化中。業務ユニットは未作成です。
  • Ready: 最初の業務ユニットが作成済み。追加作成では再発火しません。
  • Rendered: 標準 UI の初回レンダリング切り替えが完了。全非同期コンテンツの準備は保証しません。
  • Steady: 標準 UI が Rendered 後に遅延して移行。全非同期処理の完了は待ちません。

Facade API

TypeScript
const currentStage = univerAPI.getCurrentLifecycleStage()const disposable = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {  console.log(stage)})

イベントが通知する対象

LifeCycleChanged は Univer のグローバル段階を通知します。例えば、グローバル段階が Ready になった後に B を読み込むと、B の onReady() は呼ばれますが、グローバルな Ready イベントは再発火しません。

リスナーを追加すると、Starting を含む現在の段階がコールバックにすぐ届く場合があります。現在の段階を確認するだけなら、univerAPI.getCurrentLifecycleStage() を直接呼び出してください。

リスナーを削除するには、返却された disposable オブジェクトを利用します。

TypeScript
disposable.dispose()

プラグインのライフサイクルフック

プラグインは読み込み時に onStarting() を実行し、現在のグローバル段階まで追いつきます。B の読み込み段階を選び、A との呼び出し順序を比較してください。

B の読み込み段階 · Rendered
Startingグローバルプラグイン A未読込読込StartingReadyRenderedSteadyプラグイン B未読込読込StartingReadyRenderedSteady
グローバル: Startingグローバル: Starting · 1 / 14

同期フックの順序を示すため、ゆっくり再生します。

汎用プラグインは登録時、業務タイプのプラグインは通常そのタイプの最初のユニット構築前に読み込まれます。起動済みタイプへの追加登録は遅延してまとめて読み込まれます。依存関係により早く読み込まれる場合もあります。

各バッチは依存順、段階順に同期的にフックを呼び、非同期処理は待ちません。ユニット、DOM、リソースの準備は個別に確認してください。

このガイドはいかがですか?

© 2026 DreamNum Co., Ltd.