Componente Kanban Board para Angular | ng-hub-ui-board
Componente Kanban para Angular con drag and drop, plantillas de tarjeta, flujos por columnas y variables CSS para paneles de negocio.
Última actualización 21 sept 2026
Visión General
Por qué los equipos buscan esta librería
Este componente board para Angular te ayuda a entregar flujos estilo Kanban con drag and drop, plantillas flexibles y patrones de interacción escalables para herramientas de negocio reales.
Instalación
npm install ng-hub-ui-boardIr a
Ideal para
- tableros de tareas
- seguimiento de pipelines
- flujos CRM
- paneles operativos
Sobre board
ng-hub-ui-board está diseñado para productos Angular que necesitan algo más que una lista estática: seguimiento de tareas, pipelines CRM, flujos de soporte o paneles internos de operaciones. Mantiene flexible el renderizado de tarjetas sin perder un modelo coherente de interacción.
Guías de uso
Uso básico
Funcionalidades fundamentales del board
Ejemplos:
Ejemplo básico de tablero
Ejemplo básico de tablero
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Interacciones
Capacidades de interacción del usuario
Ejemplos:
Arrastrar y soltar tarjetas
Arrastrar y soltar tarjetas
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Last Event: None
Reordenación de columnas
Reordenación de columnas
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Last Reorder: None
Evento de clic en tarjeta
Evento de clic en tarjeta
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Last Clicked: None
Eventos del tablero
Eventos del tablero
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Event Log
Teclado y lector de pantalla
Teclado y lector de pantalla
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.
Funcionalidades avanzadas
Desplazamiento y comportamiento avanzado
Ejemplos:
Desplazamiento infinito
Desplazamiento infinito
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
Plantillas
Personalización de la apariencia
Ejemplos:
Plantilla de tarjeta personalizada
Plantilla de tarjeta personalizada
To Do
In Progress
Done
Plantilla de cabecera personalizada
Plantilla de cabecera personalizada
Research
Analyze requirements
Design
Create UI mockups
Development
Implement core features
Planning
Initial meeting
Plantilla de pie personalizada
Plantilla de pie personalizada
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Marcador de posición de tarjeta personalizado
Marcador de posición de tarjeta personalizado
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Marcador de posición de columna personalizado
Marcador de posición de columna personalizado
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Vista previa de arrastre personalizada
Vista previa de arrastre personalizada
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Configuración
Opciones de configuración del board
Ejemplos:
Desactivar ordenación
Desactivar ordenación
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Modos de comportamiento de arrastre
Modos de comportamiento de arrastre
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
Estilizado
Personalización de la apariencia mediante variables CSS
Ejemplos:
Personalización con CSS
Personalización con CSS
To Do
Research
Analyze requirements
Design
Create UI mockups
In Progress
Development
Implement core features
Done
Planning
Initial meeting
Características clave
Cambios recientes
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%).
Librerías relacionadas
Preguntas frecuentes
¿Cómo se construye un tablero Kanban con arrastrar y soltar en Angular?
Instala ng-hub-ui-board y enlaza un objeto Board que describa sus columnas y sus tarjetas. Arrastrar tarjetas entre columnas y reordenar columnas funciona sin cableado adicional; los eventos de arrastre devuelven la BoardCard movida junto con su BoardColumn de origen y de destino, así que el cambio lo persistes en tu propio store o API.
¿Se puede personalizar el aspecto de cada tarjeta del Kanban?
Sí. ng-hub-ui-board dibuja las tarjetas con plantillas que tú aportas, de modo que una tarjeta puede contener cualquier marcado: avatares, etiquetas, progreso, acciones. HubBoardColumnHeaderDirective y HubBoardColumnFooterDirective hacen lo mismo con la parte superior e inferior de cada columna, sin tocar el comportamiento de arrastrar y soltar.
¿Cómo se sabe a qué columna se ha movido una tarjeta?
El tablero emite un BoardDragDropEvent en cada soltada. Lleva el elemento arrastrado, la columna de la que venía y la columna en la que ha caído, más el nuevo índice. Esa es la carga que envías a tu backend; el tablero no persiste nada por su cuenta.
¿Funciona el tablero Kanban de Angular en dispositivos táctiles?
Sí. El arrastre está construido sobre las primitivas de drag-and-drop del CDK de Angular, que atienden entrada de ratón, táctil y lápiz, así que el tablero se comporta igual en tabletas y móviles que en escritorio.