Angular ボタンライブラリ | ng-hub-ui-buttons

signals ベースの API を備えた Angular 22 向けの完全なボタンシステム — 標準ボタン、FAB、speed dial、overlay dropdown。ng-hub-ui-utils 以外の依存はゼロ。

API リファレンス

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

インプット

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

名前デフォルト説明
variant (hub-button)'solid' | 'outline' | 'soft' | 'ghost' | 'link''solid'ボタンの視覚スタイル:solid、outline、soft、ghost、または link。
color (hub-button)'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'neutral' | 'light' | 'dark' | string'primary'ボタンのセマンティックアクセント。オープンセット:9 つの組み込みアクセントのいずれか、hub-btn-color-rules() で登録したカスタムアクセント、CSS の名前付きカラー、またはリテラル(#hex、rgb()、oklch()、var(...))。すべてのロールカラーの導出元である --hub-btn-accent スロットに供給されます。
size (hub-button)'sm' | 'md' | 'lg' | 'xl''md'ボタンのサイズトークン:sm、md、lg、または xl。
loading (hub-button)booleanfalseアニメーションするスピナーを表示し、ボタンをビジーかつ無効の状態にします:aria-busy="true" とネイティブの disabled 属性を反映し、タブ順序から除外して、ポインター/キーボードによるアクティベーションをブロックするため、処理中の送信が二度発火することはありません。
disabled (hub-button)booleanfalseボタンを無効化し、ホスト要素にネイティブの disabled 属性を反映します。
color (hub-fab)HubSemanticColor'primary'FAB の背景のセマンティックアクセント。組み込みのアクセント、または --hub-fab-accent スロットを通じた任意のカスタム/リテラルカラーを受け付けます。
size (hub-fab)'mini' | 'standard' | 'large''standard'円形 FAB の直径:mini、standard、または large。
extended (hub-fab)booleanfalseFAB を拡張ピルとしてレンダリングし、アイコンの隣に投影された [slot=label] コンテンツを表示します。
position (hub-fab)'top-start' | 'top-center' | 'top-end' | 'middle-start' | 'center' | 'middle-end' | 'bottom-start' | 'bottom-center' | 'bottom-end''bottom-end'9 スロットのグリッド上での FAB の固定ビューポート位置。RTL サポートのために CSS 論理プロパティで実装されています。
collapseOnScroll (hub-fab)booleanfalsetrue の場合、ページが 50px を超えてスクロールされると、拡張 FAB はアイコンのみの表示に折りたたまれます。
disabled (hub-fab)booleanfalseFAB を無効化し、hub-fab-disabled の外観を適用します。
color (hub-speed-dial)HubSemanticColor'primary'スピードダイヤルのトリガー FAB に塗られるセマンティックアクセント。組み込みのアクセント、または任意のカスタム/リテラルカラーを受け付けます。
size (hub-speed-dial)'mini' | 'standard' | 'large''standard'トリガー FAB のサイズ:mini、standard、または large。
position (hub-speed-dial)HubFabPosition'bottom-end'9 スロットの FAB グリッド上でのスピードダイヤルの固定ビューポート位置。
direction (hub-speed-dial)'up' | 'down' | 'left' | 'right''up'アクション項目がトリガーから展開する方向:up、down、left、または right。
trigger (hub-speed-dial)'click' | 'hover''click'スピードダイヤルを開くインタラクション:click はトグルし、hover は mouseenter で開いて mouseleave で閉じます。
isOpen (hub-speed-dial)boolean (two-way model)falseスピードダイヤルの双方向バインド可能な開閉状態(model シグナル)。Escape キーを押すと自動的に閉じます。
icon (hub-speed-dial-item)必須stringアクションアイコン用の CSS クラス文字列。項目ボタンの内部で <i [class]="icon()"> としてレンダリングされます。label が設定されていない場合は aria-label のフォールバックとしても使用されます。
label (hub-speed-dial-item)string''アクションボタンの隣に表示されるツールチップラベル。アクセシブルな aria-label としても使用されます。
color (hub-speed-dial-item)HubSemanticColor | 'default''default'アクションボタンのセマンティックアクセント。'default' は中立的な外観を維持します。カスタム/リテラルカラーは --hub-speed-dial-item-accent スロットを通じて塗られます。
disabled (hub-speed-dial-item)booleanfalseアクション項目ボタンを無効化します。無効な間は itemClick は発行されません。
hubDropdown ([hubDropdown])必須TemplateRef<any>body レベルのオーバーレイパネル内にレンダリングされる ng-template。[hubDropdown]="tpl" としてバインドします。
placement ([hubDropdown])'top-start' | 'top' | 'top-end' | 'start' | 'end' | 'bottom-start' | 'bottom' | 'bottom-end''bottom-start'トリガー要素に対するパネルの配置。オーバーレイはマッピングされた位置を試し、ビューポートに収まるまでフォールバックします。
trigger ([hubDropdown])'click' | 'hover''click'ドロップダウンを開くインタラクション:click はトグルし、hover は mouseenter で開いて mouseleave で閉じます。
closeOnSelect ([hubDropdown])booleantruetrue の場合、パネルコンテンツ内のどこかをクリックすると、ドロップダウンが自動的に閉じます。
disabled ([hubDropdown])booleanfalseドロップダウンが開かないようにします。
offsetY ([hubDropdown])number4配置軸に沿ったトリガーとパネルの間のオフセット(ピクセル単位)。
panelClass ([hubDropdown])string''デフォルトの hub-dropdown-overlay クラスに加えて、オーバーレイパネルに追加される CSS クラス。
isOpen ([hubDropdown])boolean (two-way model)falseドロップダウンの双方向バインド可能な開閉状態(model シグナル)。Escape、外側のクリック、バックドロップのクリック、ページスクロールで自動的に閉じます。
color (hub-dropdown-panel)HubSemanticColor | 'default''default'パネル上端のボーダーのセマンティックアクセント。'default' は中立的なボーダーを維持します。
color (hub-dropdown-item)HubSemanticColor | 'default''default'項目ラベルの色のセマンティックアクセント。'default' はパネルの色を継承します。
icon (hub-dropdown-item)string | undefinedundefinedラベルの前に <i [class]="icon()"> としてレンダリングされるアイコン用の、省略可能な CSS クラス文字列。
disabled (hub-dropdown-item)booleanfalseメニュー項目を無効化します。クリックは無視され、itemClick は発行されません。
selected (hub-dropdown-item)booleanfalse項目が選択されていることを示すチェックマークインジケーターを表示します。

アウトプット

buttons の動作に反応 — ロジックを接続できる 9 個のイベント。

名前説明
fabClick (hub-fab)OutputEmitterRef<void>FAB のアクティベーション用に宣言されたアウトプット。現在の実装では内部から発行されることはありません — 代わりに <hub-fab> のネイティブ (click) イベントをバインドしてください。
isOpenChange (hub-speed-dial)OutputEmitterRef<boolean>isOpen モデルが変化するたびに新しい開閉状態を発行します(双方向バインディングの change 側)。
opened (hub-speed-dial)OutputEmitterRef<void>スピードダイヤルが開いた後に発行されます。
closed (hub-speed-dial)OutputEmitterRef<void>スピードダイヤルが閉じた後に発行されます。Escape キーによって閉じた場合も含みます。
itemClick (hub-speed-dial-item)OutputEmitterRef<void>アクション項目ボタンがアクティベートされたときに発行されます。
isOpenChange ([hubDropdown])OutputEmitterRef<boolean>isOpen モデルが変化するたびに新しい開閉状態を発行します(双方向バインディングの change 側)。
opened ([hubDropdown])OutputEmitterRef<void>オーバーレイパネルがアタッチされ、ドロップダウンが開いた後に発行されます。
closed ([hubDropdown])OutputEmitterRef<void>ドロップダウンが閉じてオーバーレイが破棄された後に発行されます(Escape、外側のクリック、スクロール、バックドロップ、または closeOnSelect)。
itemClick (hub-dropdown-item)OutputEmitterRef<void>メニュー項目がアクティベートされたときに発行されます。項目が無効な間は抑制されます。

テンプレート

テンプレートはまだドキュメント化されていません。