Angular スケルトンローダーコンポーネント | ng-hub-ui-skeleton

再利用可能なプリセット、インライン DSL テンプレート、レスポンシブな値、シマー状態向けの CSS 変数を備えた Angular のスケルトン読み込みプレースホルダー。

API リファレンス

skeleton の完全な仕様をここにまとめました。バインド、リッスン、プロジェクション、テーマ設定ができるすべてが一か所に集約されています。必要なものを接続し、好きなようにスタイリングしてください — standalone で signal フレンドリーです。

インプット

7 個のインプットで skeleton を調整。通常の Angular @Input と同じようにバインドできます。

名前デフォルト説明
presetstring | nullnullバンドル済みまたは登録済みのプリセットの名前。指定すると、コンポーネントはプリセットレジストリからデフォルト、バリアント、エイリアス合成を解決します。
templatestring | HubSkeletonTemplateDefinition | nullnullインラインの Emmet 風 DSL 文字列、または任意のレスポンシブブレークポイント上書きを伴うテンプレート定義オブジェクト。
paramsHubSkeletonParams{}解析およびプリセット展開の前に `{{param}}` プレースホルダーに補間される、シリアライズ可能なパラメータ。
variantstring | nullnull`compact` などの任意のプリセットバリアント名。テンプレートのデフォルトを切り替えたり、ベースプリセットテンプレートを上書きしたりするために使用します。
animatedbooleantrue同じプレースホルダーレイアウトを保ちながら、シマーアニメーションを有効または無効にします。
appearance'default' | 'subtle' | 'contrast''default'解決済みのレイアウトを変えずに、スケルトン表面の視覚的な強度を変更します。
ariaLabelstring'Loading placeholder'支援技術のためにコンテナ要素に適用されるアクセシブルなラベル。

アウトプット

アウトプットはまだドキュメント化されていません。

テンプレート

自分好みに — 3 個のテンプレートスロットでカスタムマークアップをプロジェクションできます。

名前説明サンプル
Bundled Presets初期カタログで利用可能なプリセット名: card、list-item、table-row、detail-view、form-section、dashboard-widget、stat-card、chart-panel、profile-summary、master-detail、kanban-card、feed-item、search-result、table-toolbar、filter-bar、empty-state-skeleton。<hub-skeleton preset="table-row" [params]="{ columns: 4 }"></hub-skeleton>
Preset DSLノード名、修飾子、`+` による兄弟合成、`>` による子のネスト、`*N` による繰り返しをサポートするコンパクトな文字列構文。<hub-skeleton template="stack(gap:12)>circle(size:40)+stack(gap:8)>line(width:42%)+line(width:72%)"></hub-skeleton>
provideHubSkeletonPresets任意のコンポーネントが名前でレンダリングできるよう、Angular の依存性注入にカスタムプリセットを登録します。providers: [provideHubSkeletonPresets([{ name: 'profile-card', template: 'stack(gap:16)>circle(size:72)+line(width:48%)' }])]

CSS 変数

5 個の CSS 変数であらゆるピクセルをテーマ設定。:root で上書きするか、ラッパーにスコープを限定できます。

ビジュアル tokens

ホストコンポーネントが公開するコアな CSS カスタムプロパティ。

変数デフォルト説明
--hub-skeleton-bgrgba(148, 163, 184, 0.18)color 表示されるスケルトン表面に使用されるベースのプレースホルダー色。
--hub-skeleton-highlightrgba(255, 255, 255, 0.52)color シマーグラデーションで使用されるハイライト色。
--hub-skeleton-radius12pxlength block ノードおよび line ノードのデフォルトの角丸半径。
--hub-skeleton-gap12pxlength 修飾子で上書きされない場合に stack ノードおよび grid ノードで使用されるデフォルトのギャップ。
--hub-skeleton-animation-duration1.35stransition シマーアニメーションサイクルの長さ。

スタイリングとテーマ設定

スタイリングのサンプルはまだドキュメント化されていません。このセクションには、カスタマイズのレシピやテーマ設定のサンプルが含まれる予定です。