Angular カンバンボードコンポーネント | ng-hub-ui-board
ドラッグ&ドロップ、カスタムカードテンプレート、カラムワークフロー、CSS 変数を備えた Angular の Kanban ボードコンポーネント。業務ダッシュボード向けです。
最終更新 2026/09/21
概要
チームがこのライブラリを探す理由
この Angular ボードコンポーネントは、実際の業務ツール向けに、ドラッグ&ドロップ、柔軟なテンプレート、拡張可能な操作パターンを備えた Kanban スタイルのワークフローを提供します。
インストール
npm install ng-hub-ui-boardジャンプ
最適な用途
- タスクボード
- パイプライン追跡
- CRM ワークフロー
- オペレーションダッシュボード
について board
ng-hub-ui-board は、静的なリスト以上のものを必要とする Angular プロダクト向けに設計されています。タスク管理、CRM パイプライン、サポートワークフロー、社内オペレーションダッシュボードなどです。一貫したボード操作モデルを保ちながら、カードのレンダリングを柔軟に保てます。
機能ガイド
基本的な使い方
board の基本機能
サンプル:
基本的なボードの例
基本的なボードの例
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
インタラクション
ユーザーインタラクション機能
サンプル:
カードのドラッグ & ドロップ
カードのドラッグ & ドロップ
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Last Event: None
列の並べ替え
列の並べ替え
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Last Reorder: None
カードクリックイベント
カードクリックイベント
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Last Clicked: None
ボードイベント
ボードイベント
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Event Log
キーボードとスクリーンリーダー
キーボードとスクリーンリーダー
Tab to a card, then press Space or Enter to grab it, the arrow keys to move it within or across columns, Space / Enter to drop it and Esc to cancel. A visually hidden aria-live="polite" region announces every grab, move, drop and rejection, and boardLabel gives the board its accessible name.
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Moves committed from the keyboard (same payload as a pointer drop):
- No move yet.
高度な機能
スクロールと高度な動作
サンプル:
無限スクロール
無限スクロール
To Do
Research
Analyze requirements
Design
Create UI mockups
Scroll Item 1
Scroll to see more
Scroll Item 2
Scroll to see more
Scroll Item 3
Scroll to see more
Scroll Item 4
Scroll to see more
Scroll Item 5
Scroll to see more
Scroll Item 6
Scroll to see more
Scroll Item 7
Scroll to see more
Scroll Item 8
Scroll to see more
Scroll Item 9
Scroll to see more
Scroll Item 10
Scroll to see more
Scroll Item 11
Scroll to see more
Scroll Item 12
Scroll to see more
Scroll Item 13
Scroll to see more
Scroll Item 14
Scroll to see more
Scroll Item 15
Scroll to see more
Scroll Item 16
Scroll to see more
Scroll Item 17
Scroll to see more
Scroll Item 18
Scroll to see more
Scroll Item 19
Scroll to see more
Scroll Item 20
Scroll to see more
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Last Scroll End: None
テンプレート
外観のカスタマイズ
サンプル:
カスタムカードテンプレート
カスタムカードテンプレート
To Do
In Progress
Done
カスタムヘッダーテンプレート
カスタムヘッダーテンプレート
Research
Analyze requirements
Design
Create UI mockups
Development
Implement core features
Planning
Initial meeting
カスタムフッターテンプレート
カスタムフッターテンプレート
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
カスタムカードプレースホルダー
カスタムカードプレースホルダー
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
カスタム列プレースホルダー
カスタム列プレースホルダー
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
カスタムドラッグプレビュー
カスタムドラッグプレビュー
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
設定
board の設定オプション
サンプル:
並べ替えを無効化
並べ替えを無効化
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
ドラッグ動作モード
ドラッグ動作モード
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Current Behavior: collapse
- Collapse: The element completely disappears and its space is removed from the layout
- Best for: Clean interface where you only want to see the placeholder at the destination
スタイリング
CSS 変数による外観のカスタマイズ
サンプル:
CSS カスタマイズ
CSS カスタマイズ
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
主な機能
最近の変更
Version 22.6.2 - 9/21/26, 12:00 AM
changed: The README says what the board is before it warns about anything. The page opened on the 21.1.0 breaking-change notice, so a reader arriving from npm was handed a migration step before a description. The header now carries the one-line description and the licence and Angular badges the rest of the family shows, and the notice moved to an Upgrading from 21.0.x section below the installation instructions. Documentation only: no code, types or styles change.
Version 22.6.1 - 9/16/26, 12:00 AM
changed: Repository, issue and README links follow the move to the hub-env organization. Issues for every Hub UI package are now gathered in hub-env/hub-ui, and the repository and bugs fields of the manifest point at the new addresses. No code, types or styles change.
Version 22.6.0 - 9/8/26, 12:00 AM
changed: BREAKING — the module and the seven template directives are renamed with the Hub prefix: BoardModule becomes HubBoardModule, and CardTemplateDirective, BoardColumnHeaderDirective, BoardColumnFooterDirective, CardPlaceholderDirective, ColumnPlaceholderDirective, CardDragPreviewDirective and ColumnDragPreviewDirective gain the same prefix. CardTemplateDirective is a name any application with cards in it will want, and an unprefixed export claims it inside the consumer’s namespace rather than the library’s. HubBoardComponent already carried the prefix, so the component and the directives that exist only to feed it were spelled two ways in one import list. The selectors are untouched, so no markup changes. All eight old names stay exported as deprecated aliases resolving to the same classes and are removed in 23.0.0. See BREAKING_CHANGES.md.
changed: BREAKING — the colour pipe is HubBoardInvertColorPipe, and answers to hubBoardInvertColor in a template. A pipe’s template name is the one part a consumer cannot rename around, and invertColor took an unprefixed name in the application’s own template namespace. The prefix alone would not have been enough, since ng-hub-ui-forms already publishes HubInvertColorPipe under hubInvertColor, so the library’s name goes in the middle. InvertColorPipe survives as a deprecated subclass still answering to invertColor and is removed in 23.0.0, so migrating means changing the template as well as the import. See BREAKING_CHANGES.md.
changed: ng-hub-ui-ds is declared as an optional peer dependency, >=22.0.0. The stylesheet has themed against --hub-sys-* for several releases, every read already carrying its own fallback, and the manifest never said so: nothing warned that a ng-hub-ui-ds older than the --hub-ref-* / --hub-sys-* architecture would leave the board on those fallbacks, and a reader of the manifest had no way to learn that the token package is what turns the theme on. No code, types or styles change.
fixed: Both READMEs name the classes that ship. Every import block, every section heading and the legacy-module snippet still used the old names, so a reader copying the documented import wrote code that compiles only against the deprecated aliases, which is precisely the audience this rename exists to move.
Version 22.5.2 - 9/6/26, 12:00 AM
fixed: The columns are now the items of the board list. role="list" sat on the host, but its children were two role-less wrappers, the hidden keyboard hint and the live region, so the required-owned-elements chain broke and a screen reader read the board as a list with no items. The list now lives on the columns track, each column container is its listitem, and the column group semantics (role="group", its aria-label and its stable id) moved onto the column itself, which leaves the hint and the announcer outside the list. The host keeps its aria-label and becomes a region, so boardLabel still names the board and a screen-reader user can reach it without the consumer adding a heading of their own.
fixed: BoardModule now exports CardDragPreviewDirective and ColumnDragPreviewDirective. Both are public API and both are documented in the README with no caveat, but neither was in the module, so a consumer who took the documented Module Import (Legacy) route got an <ng-template cardDragPreview> that matched no directive. Nothing failed out loud: the template was simply ignored and the default preview rendered, which is the worst way for an option to not work.
fixed: The documentation now describes the component that ships. Both READMEs promised things the code does not do and hid things it does: a CC BY 4.0 licence that the 22.5.0 relicense had already replaced with MIT, a @use of a stylesheet removed in 21.1.0, a card template bound to let-card="card" when the context key is item (so the snippet rendered an empty card), board typed as Signal<Board> when the input takes a plain Board, a primary default on a variant that has none, EventEmitter where the outputs are output(), a BoardColumn block missing the very predicate the keyboard section relies on, and a virtual scrolling feature that is only end-of-column detection. Each one is a reader copying a line that fails to compile or silently renders nothing.
fixed: FUNCTIONALITIES.md no longer lists a configurable scroll-detection padding. It is a private constant, not an input, so the row promised an API that has never existed.
Version 22.5.1 - 9/1/26, 12:00 AM
changed: The package homepage now points at this library's own documentation page instead of the site root, so the link a registry shows beside the package lands on the reference the reader was already looking for. Metadata only.
Version 22.5.0 - 8/17/26, 12:00 AM
changed: Relicensed from CC-BY-4.0 to MIT. CC licences are not meant for software: no patent grant, no source-distribution terms and an attribution requirement with no defined meaning for code that ends up inside a bundle. MIT grants strictly more, so nobody who took an earlier version loses anything.
Version 22.4.1 - 8/8/26, 12:00 AM
fixed: Documentation links now point at the canonical localized URLs. The README linked to https://hubui.dev/<path> with no locale prefix and no trailing slash, and both forms are 301-redirected, so every reader arriving from npm or GitHub landed on a redirect instead of the canonical page.
Version 22.4.0 - 7/28/26, 12:00 AM
added: ARIA list semantics: the board host is role="list" named by the new boardLabel input, each column is a labelled role="group", each column body a role="list" and each card a role="listitem".
added: Keyboard card reorder: Space/Enter grabs a focused card, ArrowUp/ArrowDown move it within its column and ArrowLeft/ArrowRight to the adjacent column (honouring the same predicate/cardSortingDisabled rules as dragging), Space/Enter drops emitting the same onCardMoved payload as a pointer drop, and Escape cancels restoring the original position.
added: Visually hidden aria-live="polite" announcer for grab, move, drop, cancel and rejected targets (messages are English-only for now), plus a hidden usage hint linked from each focusable card.
added: New optional boardLabel input: accessible name of the board list container (default 'Board').
Version 22.3.0 - 7/7/26, 12:00 AM
changed: BREAKING (packaging): the theme SCSS now ships at ng-hub-ui-board/styles (was dist/board/src/lib/styles), so @use 'ng-hub-ui-board/styles' resolves — update any @use that reached into src/lib/styles.
changed: variant now accepts any colour: besides the built-in semantic accents, a registered custom accent or a literal colour (#hex, rgb(), oklch(), CSS named colour) is resolved through the shared resolveHubAccent helper from ng-hub-ui-utils.
changed: Internal: @HostBinding/@HostListener decorators replaced by the host metadata object (Angular style guide); no public API or behaviour change.
Version 22.2.1 - 7/2/26, 12:00 AM
fixed: Docs: css-variables-reference.md default values resynchronized with the actual code declarations, now guarded by the repo-level tokens-parity check.
Version 22.2.0 - 6/26/26, 12:00 AM
changed: Accent system migrated to the open-set local accent slot pattern: variant re-bases a single --hub-board-accent slot and the emphasis/subtle/on family is derived locally with color-mix, growing the built-in variants from 5 to the nine canonical accents and letting any custom ds accent recolour the drag/drop placeholder at runtime.
added: New tokens --hub-board-accent-on (grayscale contrast flip driven by the accent lightness) and --hub-board-accent-emphasis.
fixed: Accent color-mix derivation for --hub-board-accent-subtle migrated from srgb to oklch for perceptually uniform tints; the subtle tint is now derived at 12% (was 8%).
関連ライブラリ
よくある質問
Angular でドラッグ&ドロップのかんばんボードを作るには?
ng-hub-ui-board をインストールし、列とカードを記述した Board オブジェクトをバインドします。列間のカード移動も列の並べ替えも追加の配線なしで動作します。ドラッグイベントは移動した BoardCard と、移動元・移動先の BoardColumn を返すので、変更は自分のストアや API に保存します。
かんばんの各カードの見た目は変えられますか?
はい。ng-hub-ui-board は用意したテンプレートでカードを描画するため、アバター、タグ、進捗、アクションなど任意のマークアップを入れられます。HubBoardColumnHeaderDirective と HubBoardColumnFooterDirective は各列の上部と下部で同じことを行い、ドラッグ&ドロップの挙動には触れません。
カードがどの列に移動したかを知るには?
ボードはドロップのたびに BoardDragDropEvent を発行します。ドラッグされた項目、移動元の列、移動先の列、そして新しいインデックスが含まれます。これがバックエンドへ送るペイロードで、ボード自身は何も保存しません。
Angular のかんばんボードはタッチ端末でも動きますか?
はい。ドラッグは Angular CDK のドラッグ&ドロップ機構の上に作られており、マウス・タッチ・ペンの入力を扱うため、タブレットやスマートフォンでもデスクトップと同じように動きます。