c2n/web-componentsv1.0.18
OverviewGetting startedComponentsIconsGuidesExamples
OverviewGetting startedComponentsIconsGuidesExamples
GitHub repositoryJoin the c2n-webcomponents Discord

Flow

A pipeline, dependency graph or database schema on a pannable canvas: steps with a status, smooth edges, rows joined row to row, auto layout, draggable nodes saved to localStorage, a hover card and a context menu.

Attributes

NameTypeDefaultDescription
nodesFlowNode[][]The steps. A property, or a JSON attribute.
edgesFlowEdge[][]The dependencies between steps. A property, or a JSON attribute.
directionFlowDirectionLRMain axis of the auto layout. The user can switch it from the context menu; the choice is saved with the layout.
edge-typeFlowEdgeTypebezierEdge shape: smooth curves or rounded orthogonal segments.
storage-keystring—localStorage key the custom layout and direction are saved under. Empty disables persistence.
editablebooleanfalseLets the user add, rename, connect and delete nodes and delete edges. The flow fires node-add, node-edit, node-delete, edge-add and edge-delete and the application updates nodes and edges.
no-double-click-addbooleanfalseTurns off adding a node by double-clicking (or double-tapping) empty canvas, for an application whose actions toolbar has an add button calling addNode(): a double-click then only selects nothing, and no node appears where the user merely meant to deselect or zoom. The canvas menu's Add node, N and Enter still add one.
actions-placementFlowActionsPlacementtopEdge of the canvas the actions toolbar sits on: top or bottom lay the buttons out in a row, left or right in a column (and the arrow keys follow).
fit-min-zoomCustomEventDEFAULT_FIT_MIN_ZOOMLeast zoom fitting the view may choose (fitView(), the first render, a resize or new data while the user has not panned or zoomed), from 0.25 to 1. A flow too large for its box at this zoom shows its start instead of its middle: the first rank sits at the left edge (LR) or the top edge (TB), centred across if it fits that way. Raise it for a small preview whose labels must stay readable. Zooming by hand still goes down to 25%.
row-limitnumber0How many rows a node shows before the rest fold into a "+ N more" row the user clicks to show them (Shift+Enter or the context menu from the keyboard); a node's own rowLimit wins. Rows an edge meets always show. 0 shows every row. Which nodes are open is saved with the layout under storage-key.
lockedbooleanfalseTurns off moving nodes; panning, zooming, selection and the hover card still work.
selectedstring | nullnullId of the selected node, or null.
no-cardbooleanfalseTurns off the hover card.
no-context-menubooleanfalseTurns off the context menu, so the browser shows its own.
open-delaynumber400Delay before the hover card opens, in milliseconds.
close-delaynumber200Delay before the hover card closes once the pointer or focus has left the node and the card, in milliseconds.

Slots

NameDescription
node:{id}Body of the node whose id is {id}, e.g. slot="node:build". Replaces renderNode and the default body for that node.
card:{id}Content of the hover card of node {id}. Replaces renderCard and the default card for that node.
actionsButtons drawn over the canvas, along the edge actions-placement names, e.g. add node, auto layout (resetLayout()) or fit view (fitView()). They form a toolbar: the arrow keys move between them.

Events

NameTypeDescription
layout-changeCustomEvent<FlowLayoutChangeDetail>The user moved a node, switched direction or went back to auto layout, or setLayout() was called. Does not bubble.
selection-changeCustomEvent<FlowSelectionChangeDetail>The selected node changed through the user. detail.selected is its id, or null. Does not bubble.
node-clickCustomEvent<FlowNodeEventDetail>A node was clicked, activated with Enter or Space, or chosen with a flow:details context-menu row. Does not bubble.
rows-toggleCustomEvent<FlowRowsToggleDetail>The user showed or folded the rows of node detail.id past the row-limit (the "+ N more" row, Shift+Enter or the context menu). Does not bubble.
row-moveCustomEvent<FlowRowMoveDetail>editable only: the user moved row detail.row of node detail.id from index detail.from to detail.to of its rows, by its grip, the keyboard (R) or the row's context menu. Move it in rows. Does not bubble.
node-addCustomEvent<FlowNodeAddDetail>editable only: the user asked for a node at detail.position (canvas pixels, the node's top-left corner), connected from detail.source (by its side detail.sourceSide, into the new node's detail.targetSide) when it came from a connection dropped on empty canvas. Append it to nodes. Does not bubble.
edge-addCustomEvent<FlowEdgeAddDetail>editable only: the user connected detail.source to detail.target, from side detail.sourceSide of the source to side detail.targetSide of the target, or between rows detail.sourcePort and detail.targetPort (an end on a row has no side: it faces the other end). Never an existing edge, nor a self-loop except between two different rows of one node. Does not bubble.
node-deleteCustomEvent<FlowNodeDeleteDetail>editable only: the user asked to delete node detail.id. Does not bubble.
edge-deleteCustomEvent<FlowEdgeEventDetail>editable only: the user asked to delete the edge from detail.source to detail.target. Does not bubble.
edge-editCustomEvent<FlowEdgeEditDetail>editable only: the user changed the label of the edge from detail.source to detail.target to detail.label with the inline editor; an empty label removes it. Does not bubble.
node-editCustomEvent<FlowNodeEditDetail>editable only: the user renamed node detail.id to detail.label with the inline editor. Does not bubble.
flow-menu-selectCustomEvent<FlowMenuSelectDetail>A context-menu row added by renderContextMenu was activated, with the node it was opened on. Does not bubble.

CSS parts

Shadow DOM styling hooks used with ::part(name). Prefer CSS custom properties when they cover the change.

NameDescription
actionsThe toolbar around the actions slot.

CSS custom properties

Grouped by semantic target and state from --c2-<component>__<target>__<state>--<property>. Click a group to collapse it; click a name to copy it.

NameTypeDefaultDescription
c2-flow
--c2-flow--heightpixel480pxHeight of the canvas.
--c2-flow--background-colorcolor#fafafaCanvas background.
--c2-flow--borderborder1px solid #e4e4e7
--c2-flow--border-radiusborder-radius8px
--c2-flow--font-familyfont-family—
c2-flow > actions
--c2-flow__actions--alignjustify-contentflex-startWhere the actions toolbar sits along its edge: flex-start, center or flex-end.
--c2-flow__actions--offsetpixel12pxDistance between the actions toolbar and the edge of the canvas.
--c2-flow__actions--gappixel4pxSpace between two action buttons.
--c2-flow__actions--paddingpadding4px
--c2-flow__actions--background-colorcolor#ffffff
--c2-flow__actions--borderborder1px solid #e4e4e7
--c2-flow__actions--border-radiusborder-radius8px
--c2-flow__actions--box-shadowbox-shadow0 1px 2px rgba(24, 24, 27, 0.06)
c2-flow > dot
--c2-flow__dot--colorcolor#ebebedColour of the canvas dot grid.
--c2-flow__dot--sizepixel1pxRadius of one grid dot.
--c2-flow__dot--gappixel20pxSpacing of the dot grid at 100% zoom; it scales with the zoom, within the two bounds below.
--c2-flow__dot--min-gappixel14pxSmallest dot spacing, reached when zoomed out.
--c2-flow__dot--max-gappixel32pxLargest dot spacing, reached when zoomed in.
c2-flow > rank
--c2-flow__rank--gappixel72pxSpace between two ranks of the auto layout.
c2-flow > node
--c2-flow__node--gappixel20pxSpace between two nodes of the same rank.
--c2-flow__node--widthpixel200px
--c2-flow__node--padding-toppadding10px
--c2-flow__node--padding-rightpadding12px
--c2-flow__node--padding-bottompadding10px
--c2-flow__node--padding-leftpadding12px
--c2-flow__node--background-colorcolor#ffffff
--c2-flow__node--colorcolor#18181b
--c2-flow__node--borderborder1px solid #bcbcc6
--c2-flow__node--border-radiusborder-radius8px
--c2-flow__node--box-shadowbox-shadow0 1px 2px rgba(24, 24, 27, 0.06)
--c2-flow__node--cursorcursordefaultPointer over a node that can be moved, its label and rows included; grab shows the hand there. A row's grip shows grab, a node being dragged grabbing, a node of a locked flow pointer.
c2-flow > node > hover
--c2-flow__node__hover--border-colorcolor#a1a1aa
c2-flow > node > selected
--c2-flow__node__selected--border-colorcolorrgb(2, 101, 220)
--c2-flow__node__selected--box-shadowbox-shadow0 0 0 3px rgba(2, 101, 220, 0.2)
c2-flow > node > focus
--c2-flow__node__focus--outlineoutline2px solid rgba(2, 101, 220, 0.4)
c2-flow > node > dragging
--c2-flow__node__dragging--box-shadowbox-shadow0 10px 28px rgba(24, 24, 27, 0.14)Shadow of a node while it is dragged.
c2-flow > node > skipped
--c2-flow__node__skipped--opacitynumber0.6Opacity of the body of a skipped node.
c2-flow > node > connect-target
--c2-flow__node__connect-target--border-colorcolorrgb(2, 101, 220)Border of the node a connection would be made to.
--c2-flow__node__connect-target--box-shadowbox-shadow0 0 0 3px rgba(2, 101, 220, 0.2)
c2-flow > label
--c2-flow__label--font-sizefont-size14px
--c2-flow__label--font-weightfont-weight500
c2-flow > description
--c2-flow__description--font-sizefont-size12pxSize of the description and the meta value.
--c2-flow__description--colorcolor#71717a
c2-flow > handle
--c2-flow__handle--sizepixel7pxDiameter of the dots on the sides of a node that edges leave or arrive by.
--c2-flow__handle--background-colorcolor#ffffff
--c2-flow__handle--border-colorcolor#a1a1aa
c2-flow > edge
--c2-flow__edge--colorcolor#d4d4d8Edge between steps that have not run yet.
--c2-flow__edge--widthpixel1.5px
--c2-flow__edge--animation-durationtime600msOne cycle of the active edge's dash animation.
c2-flow > edge > done
--c2-flow__edge__done--colorcolor#a1a1aaEdge out of a finished step.
c2-flow > edge > active
--c2-flow__edge__active--colorcolorrgb(2, 101, 220)Animated edge into a running or waiting step.
c2-flow > edge > failed
--c2-flow__edge__failed--colorcolor#dc2626Edge out of a failed step.
c2-flow > edge > highlighted
--c2-flow__edge__highlighted--widthpixel2.5pxEdges of the hovered or selected node.
c2-flow > edge > draft
--c2-flow__edge__draft--colorcolorrgb(2, 101, 220)The edge drawn while a connection is being made.
c2-flow > edge > selected
--c2-flow__edge__selected--colorcolorrgb(2, 101, 220)Selected edge of an editable flow.
--c2-flow__edge__selected--widthpixel2.5px
c2-flow > arrow
--c2-flow__arrow--sizepixel8pxLength and width of the arrowhead at the target end of every edge. It takes the edge's colour.
--c2-flow__arrow--displaydisplayblocknone draws the edges without arrowheads.
c2-flow > edge-marker
--c2-flow__edge-marker--sizepixel12pxHeight of a crow's-foot end (one, many…); it is 5/3 as long. It takes the edge's colour and width.
c2-flow > edge-label
--c2-flow__edge-label--background-colorcolor#ffffffBackground of the pill an edge's label is drawn in, so it stays readable over the line and the dot grid.
--c2-flow__edge-label--colorcolor#71717a
--c2-flow__edge-label--font-sizefont-size12px
--c2-flow__edge-label--font-weightfont-weight500
--c2-flow__edge-label--paddingpadding1px 8px
--c2-flow__edge-label--borderborder1px solid #e4e4e7
--c2-flow__edge-label--border-radiusborder-radius999px
c2-flow > marker
--c2-flow__marker--displaydisplayinline-flexThe status marker of the default node body. none hides it and the label sits flush with the padding.
c2-flow > success
--c2-flow__success--colorcolor#16a34a
c2-flow > error
--c2-flow__error--colorcolor#dc2626
c2-flow > warning
--c2-flow__warning--colorcolor#d97706
c2-flow > running
--c2-flow__running--colorcolorrgb(2, 101, 220)
c2-flow > current
--c2-flow__current--colorcolorrgb(2, 101, 220)
c2-flow > pending
--c2-flow__pending--colorcolor#a1a1aa
c2-flow > skipped
--c2-flow__skipped--colorcolor#a1a1aa
c2-flow > card
--c2-flow__card--widthpixel300px
--c2-flow__card--paddingpadding14px
--c2-flow__card--background-colorcolor#ffffff
--c2-flow__card--colorcolor#18181b
--c2-flow__card--borderborder1px solid #e4e4e7
--c2-flow__card--border-radiusborder-radius8px
--c2-flow__card--box-shadowbox-shadow0 8px 24px rgba(24, 24, 27, 0.08)
--c2-flow__card--font-sizefont-size14px
--c2-flow__card--offsetpixel8pxDistance between the node and its hover card.
--c2-flow__card--transition-durationtime150ms
c2-flow > card > term
--c2-flow__card__term--colorcolor#71717aLabels of the card's detail rows.
c2-flow > canvas
c2-flow > canvas > focus
--c2-flow__canvas__focus--outlineoutline2px solid rgba(2, 101, 220, 0.4)Focus ring of the empty canvas of an editable flow, the one place that takes focus when there is no node.
c2-flow > connector
--c2-flow__connector--sizepixel12pxDiameter of the connection handles an editable flow shows in the middle of each side of a hovered, focused or selected node.
--c2-flow__connector--background-colorcolorrgb(2, 101, 220)
--c2-flow__connector--border-colorcolor#ffffff
c2-flow > ghost
--c2-flow__ghost--borderborder1.5px dashed rgb(2, 101, 220)Outline of the placeholder that follows the pointer while dragNewNode() drags a new node onto the canvas.
--c2-flow__ghost--background-colorcolorrgba(2, 101, 220, 0.06)
c2-flow > edge-hit
--c2-flow__edge-hit--widthpixel12pxWidth of the invisible band round an edge that a click selects it by.
c2-flow > editor
--c2-flow__editor--background-colorcolor#ffffffInline label editor.
--c2-flow__editor--colorcolor#18181b
--c2-flow__editor--borderborder1px solid #bcbcc6
--c2-flow__editor--border-radiusborder-radius4px
c2-flow > editor > focus
--c2-flow__editor__focus--outlineoutline2px solid rgba(2, 101, 220, 0.4)
c2-flow > icon
--c2-flow__icon--sizepixel16pxSize of a node's icon and of a row's.
--c2-flow__icon--colorcolorcurrentColorColour of a node's icon; the node's text colour by default.
c2-flow > rows
--c2-flow__rows--border-topborder1px solid #e4e4e7Line between a node's header and its rows.
c2-flow > row
--c2-flow__row--min-heightpixel32px
--c2-flow__row--paddingpadding0 12px
--c2-flow__row--gappixel8pxSpace between a row's icon, label and meta.
--c2-flow__row--font-familyfont-family—Font of the rows, e.g. a monospace one for a schema.
--c2-flow__row--font-sizefont-size13px
--c2-flow__row--border-topborder1px solid #f4f4f5Line between two rows.
c2-flow > row > highlighted
--c2-flow__row__highlighted--background-colorcolorrgba(2, 101, 220, 0.08)The hovered row and the rows at the far end of its edges, and the row a connection would arrive at.
c2-flow > row > moving
--c2-flow__row__moving--background-colorcolorrgba(2, 101, 220, 0.12)The row being moved, by its grip or the keyboard.
c2-flow > row-meta
--c2-flow__row-meta--colorcolor#71717aA row's meta, such as a column type.
--c2-flow__row-meta--font-sizefont-size12px
c2-flow > row-grip
--c2-flow__row-grip--colorcolor#a1a1aaThe grip an editable flow shows on a hovered row, which reorders the rows.
c2-flow > row-more
--c2-flow__row-more--colorcolorrgb(2, 101, 220)The "+ N more" row of a node past its row-limit.
--c2-flow__row-more--font-sizefont-size12px
c2-flow > shape
--c2-flow__shape--border-colorcolor#bcbcc6Outline of a diamond, circle or slanted node, and the fold of a note.
--c2-flow__shape--border-widthpixel1pxWidth of that outline.
c2-flow > shape > diamond
--c2-flow__shape__diamond--min-heightpixel88pxA diamond's least height, so its middle has room for the label.
c2-flow > shape > circle
--c2-flow__shape__circle--sizepixel128pxWidth and height of a circle node.
c2-flow > shape > note
--c2-flow__shape__note--fold-sizepixel14pxSize of a note's folded corner.
c2-flow > shape > focus
--c2-flow__shape__focus--colorcolorrgba(2, 101, 220, 0.6)Focus ring of a diamond, circle or slanted node, drawn along its outline in place of --c2-flow__node__focus--outline.
--c2-flow__shape__focus--widthpixel2pxHow much wider than the outline that ring is.

Text and languages

The text the component shows, in English. It shows another language when the app adds one with addTranslations, under flow, and the nearest lang asks for it; any message not translated stays in English. {0}, {1}… stand for the values a message carries. Languages guide.

KeyEnglishValues
renameRename—
editLabelEdit label—
deleteDelete—
addNodeAdd node—
zoomInZoom in—
zoomOutZoom out—
fitViewFit view—
layoutLayout—
leftToRightLeft to right—
topToBottomTop to bottom—
autoLayoutAuto layout—
lockLayoutLock layout—
alreadyConnected{0} is already connected to every other node.{0} node
connectPromptConnect {0} to {1}. Arrow keys or Tab choose another node, Enter connects, Escape cancels.{0} source
{1} target
connectTarget{0}, {1} of {2}{0} node
{1} position
{2} total
connectedConnected {0} to {1}.{0} source
{1} target
connectionCancelledConnection cancelled.—
edgeSelectedEdge from {0} to {1}, labelled {2}, {3} of {4}, selected. Delete removes it, F2 edits its label.{0} source
{1} target
{2} label
{3} position
{4} total
noEdges{0} has no edges.{0} node
renameNodeRename {0}{0} node
edgeLabelFieldLabel of the edge from {0} to {1}{0} source
{1} target
after—{0} items
{1} labelled
before—{0} items
{1} labelled
throughRow{0} through {1}{0} end
{1} row
rows—{0} items
moreRows+ {0} more{0} count
fewerRowsShow fewer—
showAllRowsShow all rows—
showFewerRowsShow fewer rows—
rowsHidden{0} more rows, Shift+Enter shows them.{0} count
rowsShownAll rows of {0} shown.{0} node
rowsFoldedRows of {0} folded.{0} node
dragToReorderDrag to reorder—
moveRowUpMove row up—
moveRowDownMove row down—
rowMovePromptReordering the rows of {0}. {1}, {2} of {3}. Up and down arrows pick a row, Alt with an arrow moves it, Enter or Escape ends.{0} node
{1} row
{2} position
{3} total
rowPicked{0}, {1} of {2}{0} row
{1} position
{2} total
rowMoved{0} moved to {1} of {2}.{0} row
{1} position
{2} total
rowMoveEndedDone reordering rows.—
durationDuration—
dragToConnectDrag to connect—
flowActionsFlow actions—
flowMenuFlow—
emptyFlowEmpty flow—
emptyHintPress N or Enter to add a node.—
statusPendingPending—
statusCurrentWaiting—
statusRunningRunning—
statusSuccessSucceeded—
statusErrorFailed—
statusWarningSucceeded with warnings—
statusSkippedSkipped—
AccordionConnected, animated panels with shared borders and single or multiple expansion.LayoutAction BarA floating bar for the current selection: the count, the bulk actions and a button that clears it.LayoutApp ShellThe frame of an application: header, navigation, main, an optional details panel, banner and footer, laid out from its own width.LayoutArea chartA line chart with the region under each line filled — every line-chart attribute, plus a fill opacity.ChartAttachmentFile and image attachments with metadata, upload progress, failure states, and actions.Data displayAutocompleteSearchable combobox for local or remote items with customizable list rows.InputsAvatarImage, initials or icon for a person, with status dot and badge.Data displayBadgeTinted pill for status text, counts and dots, optionally pinned to a corner of another element.Data displayBannerA persistent, full-width message in the page flow for system notices, outages and account status.FeedbackBar chartBars over categories or time buckets, with several series drawn side by side within each band.ChartBar ListA ranked list whose rows carry their own bar: top pages, referrers, countries, or the changes between two periods.Data displayBorder BeamA decorative beam that travels around the border of any positioned container.LayoutBottom NavThe mobile tab bar: three to five destinations along the bottom of the screen, each an icon over a short label with a count or dot badge.NavigationBreadcrumbNavigation trail of link buttons with separators, a current page and optional collapsing.NavigationBubble chartAn ECharts scatter plot with a third measure encoded as bubble area, for comparing how two measures relate while showing how much each point weighs.ChartButterfly chartTwo series back to back on a shared category axis, the categories named between them. The population pyramid is the classic case.ChartButtonThemeable button with slots for text, prefix, suffix and running icons.ButtonsButton GroupJoined actions and polished segmented controls with single or multiple selection.ButtonsCandlestick chartAn ECharts OHLC chart for market sessions and other open-close ranges, with semantic positive and negative colours.ChartCardGroups related content and actions on a single bordered surface.LayoutCard InputCard number, expiry date and security code in one field, formatted as the brand prints them and checked as they are typed.InputsCarouselA swipeable slideshow with previous/next controls, indicators, looping and optional autoplay.LayoutCascaderSelect a value from related, multi-level data in one floating panel.InputsChat InputAuto-growing message composer with keyboard submission, toolbar actions and native form support.ChatChat MessageFlexible message row for conversations, assistant answers and activity updates.ChatChat Message ListScrolling conversation log that follows new messages, counts unread ones and loads older history.ChatCheckboxNative checkbox behaviour in a quiet, themeable box with an opt-in hover layer.InputsCheckbox groupCheckboxes grouped into one form control with a value array, a group label and an at-least-one rule.InputsChipA compact pill for a filter, a choice or an entered value: selectable as a toggle, removable with a button or the keyboard.InputsChip GroupA single row of chips or badges that collapses whatever does not fit into a +N indicator, recomputed as the row or its items change size.Data displayChoice MatrixRows × columns of checkboxes or radio buttons in one form control: permissions, notification settings, agreement scales.InputsChord chartFlows between groups around a circle, where one row is one flow from a source to a target.ChartCitationA numbered inline marker that names its source, with a hover preview of the page it cites.ChatCode EditorEditable, syntax-highlighted source field on CodeMirror 6, themed entirely through CSS variables.Editors & viewersCode ViewerSyntax-highlighted code with line numbers, copy button and dark mode, powered by shiki.Editors & viewersColor AreaTwo-dimensional area for picking saturation and value of a colour.InputsColor SelectColour swatch that opens a full picker built from area and slider.InputsColor SliderHorizontal slider for choosing a hue from 0 to 360.InputsCommandA searchable list of commands: type to filter, arrows to highlight, Enter to run. The core of a ⌘K palette.NavigationComparison BarSegmented ratio bar comparing two or three quantities, such as the bid/ask balance of an order book.Data displayConfirm DialogAsks the user to confirm an action: await show() or confirm() for a true/false answer, with a destructive variant and an async confirm action.FeedbackContext MenuA menu opened by right-clicking or long-pressing an area, built from a slotted c2-menu or a render function per clicked spot.NavigationCopy ButtonButton that copies text to the clipboard — the element it sits in, another element by id, or a literal string.ButtonsCountdownTime left until a date, or through a timer, drawn as segments, a clock or a phrase, and kept current to the second.Data displayDashboardGrid of resizable panes, dragged by the edges they share.LayoutDate InputForm-associated single-date input with native picker, constraints, helper text and error states.InputsDate SelectorAccessible one- or two-month calendar for choosing a date range.InputsDate StripA row of days to pick one from, a week at a time, with dots on the days that have something on them.InputsDate Time PickerForm-associated date-and-time field with a calendar and time popup, min/max/step constraints and an IANA time zone.InputsDepth chartCumulative bid and ask size around the mid price of an order book, as trading screens show market depth.ChartDescription ListRead-only label and value pairs for a detail page, in columns that wrap with the available width.Data displayDetailsCollapsible disclosure built on native details and summary.LayoutDiff ViewerRead-only line diff of two texts, unified or side by side, with folded unchanged lines and word highlights.Editors & viewersDistribution BarOne 100% stacked bar of a breakdown, with a legend of shares and the hovered part brought forward.Data displayEmoji PickerA searchable grid of emoji in categories, with skin tones and the emoji used last.InputsFacet ListOne facet of a filter sidebar: an attribute’s values with counts, to include or exclude from a search.InputsFieldsetGroups related controls under a legend, with a description, a group-level error and a disabled state that reaches every control inside.InputsFilter BuilderA filter bar of sentence chips (Status is any of Active), an add-filter picker and an editor for each part; it reports a plain JSON filter tree.InputsFloat ButtonA floating action button for the main action of a screen, which can expand into a speed dial of related actions.ButtonsFlowA pipeline, dependency graph or database schema on a pannable canvas: steps with a status, smooth edges, rows joined row to row, auto layout, draggable nodes saved to localStorage, a hover card and a context menu.Editors & viewersFormForm container with validation timing, an error summary, server errors, dirty tracking and async submit.InputsForm FieldLabel, hint, error, warning and character counter around any form control, wired for assistive technology.InputsFormat DateA date and time formatted for the reader's language and, optionally, a fixed time zone.Data displayFormat NumberA number formatted for its locale: currency, percent, units, compact counts and byte sizes, from Intl.NumberFormat.Data displayGanttA read-only project timeline: tasks, groups, milestones and dependencies on a day, week or month scale.PlanningGauge chartA focused radial KPI gauge drawn by ECharts, with a configurable scale, progress arc and pointer.ChartGoogle MapGoogle Maps with markers, a road route from A to B, and Street View, loaded once per page from a browser key.Data displayHeaderArranges brand, navigation, actions and a mobile trigger in a reusable site shell.LayoutHeatmap chartRows binned into cells by two keys, aggregated, and coloured by a sequential, diverging or stepped scale: a currency matrix, pair × tenor, hour × weekday, or a calendar of days. Drawn by ECharts, with a colour key that counts, marks and filters.ChartHighlightMarks the parts of a text that match a search query.Data displayHover CardInteractive preview card shown when a link or mention is hovered or focused, rendered in the top layer.FeedbackIcon ButtonRound, hoverable button wrapping a slotted SVG icon.ButtonsImageImage with lazy loading, a loading placeholder, an error fallback, click-to-load for untrusted URLs and a full-screen preview.Data displayImage CropperChoose the part of an image to keep by moving and resizing a selection, then read it back as a canvas or a blob.Editors & viewersIndicatorSolid dot or count pinned to an edge or corner of any element, with an accessible name for the count.Data displayInline EditText that turns into a field on click: Enter (Ctrl/⌘+Enter when multiline) commits, Escape cancels, and any control with a value that fires change can be the editor.InputsJSON FormA form generated from a JSON Schema, laid out by the schema, a UI schema or your own markup.InputsJSON ViewerBrowse a JSON value as a collapsible tree, search it, and copy any path or value.Editors & viewersKanbanBoard layout and card movement by pointer or keyboard, with cards drawn by your own renderItem.PlanningKbdKeyboard key label for shortcuts and command hints, with the semantics of the native kbd element.Data displayKey Value EditorEditable KEY=value rows for environment variables and headers: paste a .env file to split it into rows, mask secret values, and flag duplicate or malformed keys.InputsLabelCaption that names and activates the control referenced by its for attribute, with a required marker.InputsLine chartA line chart over a time or numeric x axis, drawn on canvas by uPlot, with series declared as children.ChartLink ButtonText-styled control for link and navigation actions, rendered as a real anchor or a button.NavigationListVertical list container with single or multiple selection.Data displayList ItemSelectable row with icon slots, used on its own or as the option of list and select.Data displayLoading OverlayCovers a region while it loads: the content stays in place, dimmed and blocked, with a spinner and an announced label.FeedbackLog ViewerExplore large logs with variable-height virtual scrolling and sticky tabular attributes.Editors & viewersMap chartA choropleth and point map on vector outlines, drawn by ECharts: regions shaded by a value, with layers of sized points and flow lines, on the bundled world and US maps or your own GeoJSON, TopoJSON or SVG.ChartMarkdownSafe markdown renderer that streams: chat answers and READMEs, with code, math and diagrams.ChatMarkerAn inline marker that highlights, underlines, strikes through, boxes or circles a run of text.Data displayMask InputA text input that fits what is typed to a pattern, for postcodes, IBANs, tax IDs, expiry dates and other fixed formats.InputsMasonryAutomatically pack differently sized dashboard tiles, then move or resize them in edit mode.LayoutMaster DetailA list beside the record it opens, one pane at a time with a Back step when the element is narrow.LayoutMathTeX formulas rendered as native MathML: no font CSS, readable by screen readers, safe for untrusted input.Data displayMenuCommands, links, checkboxes and submenus in a popover anchored to a trigger.NavigationMenubarDesktop-style File, Edit and View menus in one bar, with the arrow-key and hover movement of an application menu bar.NavigationMermaidMermaid text diagrams drawn in your theme colours, loaded on demand and safe for untrusted sources.Data displayMeterA measurement inside a known range — storage, quota, strength — with native meter thresholds and an optional segmented breakdown.Data displayModalDialog built on the native dialog element: focus trap, backdrop, Escape, title, body and footer.FeedbackMoney InputCurrency amount field that groups digits as you type, follows the locale and stores an integer count of minor units.InputsMonth PickerPick a month, or a year: billing periods, reports and card expiry.InputsMonth PlannerMonth calendar that draws events and trips as bars across the days they cover.PlanningNavigation MenuSite navigation bar whose triggers open panels of links below the header.NavigationNotepadA rich-text notepad that looks like paper: handwriting on ruled lines, a formatting toolbar over the selection, checklists and tear-off pages.PlanningNotification CenterAn inbox panel of notifications grouped by day, with read and unread states and mark all as read.FeedbackNumber InputForm-associated numeric input with native validation, step controls, adornments and helper states.InputsOrg ChartA hierarchy drawn as connected cards that collapse and expand: an organization chart, a reporting line or a team structure.Data displayOTP InputForm-associated one-time-code field with one cell per character, paste and SMS autofill, grouping and masking.InputsOverflow ListOne row of actions or links that shows what fits and folds the rest into a "More" menu, refitting as its width changes.LayoutOverlap chartA Venn diagram of two or three sets, where each circle is a set and each shared area counts the members of exactly that combination.ChartOverlayAnchored popup built on the browser Popover API, positioned with floating-ui.FeedbackPage EditorA Notion-style editor for long text: Markdown shortcuts while you type, a / menu for blocks, a toolbar over selected text, code blocks with syntax colours and eight named colours.Editors & viewersPage HeaderThe top of a page: breadcrumb or parent link, your heading with status badges, description, metadata, page actions that fold into a menu, tabs and a toolbar.LayoutPaginationPage navigation in three layouts: numbered pages, a simple page status, or a table-footer row with rows-per-page.NavigationPassword FieldA password input with a show/hide toggle, a strength meter, a requirements checklist and a Caps Lock warning.InputsPhone InputA phone number field with a searchable country picker, as-you-type grouping and an E.164 value.InputsPie chartA pie or donut chart drawn by ECharts, where one row is one slice and label-field names it.ChartPopconfirmA small "Are you sure?" popup anchored to the button that asked for it.FeedbackProgressProgress bar or ring, indeterminate or filling to a value, with an optional label and count.FeedbackPyramid chartRanked levels of a whole, stacked from a narrow apex to a wide base, where one row is one level.ChartQR CodeGenerate accessible, themeable QR codes locally as crisp SVG graphics.Data displayQuery InputA key:value query field whose filters are chips you can switch off or remove, with syntax highlighting and field and value suggestions, as in Datadog, GitHub and Sentry.InputsQuestionnaireA multi-step single- and multiple-choice flow with validation, shortcuts and form submission.InputsRadar chartCompare several profiles across the same set of normalized indicators.ChartRadioRadio options built on native inputs, grouped into one value with keyboard navigation.InputsRateAccessible star rating input with hover preview, keyboard control and optional half values.InputsReaction BarEmoji reactions with counts under a message or comment, toggled by the current user, with a picker to add more.ChatRelative TimeTime relative to now, such as "3 minutes ago" or "in 2 days", that keeps itself current and shows the full date on hover.Data displayReorder ListReorder a vertical queue with pointer or keyboard input while the application owns persistence.Data displayRich Text EditorA compact formatted-text field for comments, replies and email bodies: bold, links, lists, quotes and code, a one-tab-stop toolbar, and a Markdown value.InputsSankey chartQuantities moving through stages, where one row is one flow and each band is as wide as what it carries.ChartSave BarA floating bar that appears while a form has unsaved changes, with Discard and Save.LayoutScatter chartAn ECharts scatter plot for finding relationships, clusters and outliers across two numeric measures.ChartSearch FieldA search box with a debounced search event, a clear button, a keyboard shortcut hint and recent searches.InputsSecret FieldShows an API key or other secret masked, with buttons to reveal it, copy it and ask for a new one.InputsSelectDropdown that pairs a themeable trigger with an anchored list of c2-list-item options.InputsSeparatorHorizontal or vertical rule with an optional label, for dividing content and toolbars.LayoutSheetDialog pinned to an edge of the screen, for content that complements the page rather than interrupting it.FeedbackShortcutKeyboard shortcuts for a whole application from one element: each binding fires an action event, runs a handler or activates a target.InputsSide NavResponsive navigation drawer beside the page: pushes the content on large screens, slides over it with a backdrop on small ones.NavigationSkeletonPlaceholder block standing in for content that has not arrived, in three shapes and three animations.FeedbackSkip LinkA "Skip to main content" link that appears when a keyboard user tabs onto it and moves focus into the main content.NavigationSliderRange input with a themeable track, thumb, step ticks and value bubble.InputsSparklineA chromeless trend line sized for a table cell, a list row or the trend slot of a c2-stat.ChartSpinnerCircular progress indicator, indeterminate or showing a value, with optional text.FeedbackSplit ButtonA main action with a caret menu of alternatives, such as "Send ▾", or a remembered choice like a merge method.ButtonsSplit PanelTwo panels separated by a divider the user drags, or moves with the keyboard, to resize them.LayoutSpreadsheetA small editable grid with basic formulas, for budgets, quotes, price lists and score sheets.Editors & viewersStatDisplays a KPI with an optional icon, trend and supporting description.Data displayState TimelineOne band per series, coloured by the discrete state it was in over time: service health, CI runs, host power.ChartStatus LightColoured dot plus a short label for the state of something, such as Live, Building or Failed.Data displayStatus PanelCommunicate empty states, operation outcomes and recoverable errors with clear next steps.FeedbackStepsThe trace of a task as it runs, or a stepper across the top of a view: statuses, durations, stages that open while they work, and steps the reader can select.Data displayStickyPins content to the top or bottom of its scroll container and tells you when it is stuck, optionally hiding it while the reader scrolls down.LayoutStreaming TextPlain text that arrives in bursts, such as an LLM answer, revealed at a steady pace behind a caret.ChatSwipe ActionA list row that slides sideways to reveal actions behind it, as in a mail or task list on a phone.LayoutSwitchOn/off toggle on a native switch input, with label, description and thumb icons.InputsTableVirtualized data grid with declarative columns, sorting, selection, pinning and resizing.Data displayTable Of ContentsAn "On this page" navigation that lists the headings of a document, nests them by level and highlights the section being read.NavigationTabsTab strip that shows one content panel at a time.NavigationTag InputTurns typed or pasted text into removable tags — recipients, keywords, labels — with configurable delimiters, parsing and validation.InputsText FieldSingle-line input with icon slots, clear button, helper and error text, and a character counter.InputsTextareaMultiline text input with resizing, helper and error text, and a character counter.InputsTheme SelectColour-theme switcher: click to step to the next mode, hover for the full menu.InputsTime InputForm-associated time-of-day input with a scroll-wheel picker, step and range constraints, helper text and error states.InputsTime Range PickerDashboard time range control: searchable quick ranges, an absolute range typed or picked on a calendar, time zone, shift and zoom, and auto-refresh.InputsTime Slot PickerPick a free time from someone's calendar: a row of days, then that day's times grouped into morning, afternoon and evening.InputsTimelineA vertical sequence of dated events on a connected rail: order history, activity feeds, changelogs.Data displayToastNotification cards and a manager for stacked, queued notifications with independent lifetimes.FeedbackTodo ListA to-do list with the feel of paper: hand-drawn ticks, notes, highlighters, swipe and drag, and a remembered look.PlanningToggletipA small ⓘ button that opens a help bubble on click or tap; the bubble can hold links and is announced to screen readers.FeedbackTooltipContextual hint shown when its target is hovered or focused, rendered in the top layer.FeedbackTourA guided product tour that spotlights one element at a time and explains it in a panel beside it.FeedbackTrace WaterfallShow the spans of a distributed trace as a tree, each with a duration bar on one shared time axis.Data displayTreeHierarchical tree view with expansion, selection, checkboxes and lazy loading.Data displayTree SelectA dropdown for picking one or several rows from a hierarchy, with checkboxes, search and a form value.InputsTreemap chartA whole split into nested rectangles, each sized by its value: market maps, budgets and disk usage.ChartTruncateClamps text to a number of lines, with an optional Show more button.Data displayUploadDrag-and-drop file selection with validation, upload progress, retry, cancellation, and attachment results.InputsView OptionsThe Display popover of a collection: layout, grouping, ordering on several levels, Show switches and visible properties, reported as one plain value.InputsVirtual ListWindowed list with built-in search, sorting, selection and an async data source.Data displayVisually HiddenText for screen readers only: kept in the accessibility tree, drawn nowhere, optionally shown while it holds focus.LayoutWaterfall chartA running total bridged by the steps that move it, where one row is one step and totals mark where the bridge lands.ChartWeek PlannerWeekly schedule with time blocks: a typical week with optional odd and even weeks, or a dated week the user edits.PlanningWorking IndicatorA live "work in progress" line: animated mark, shimmering label, trailing dots and elapsed time.FeedbackFeather Icons287 open-source Feather icons, one web component each.IconsMat Icon2,234 Material Icons ligatures rendered through a single element.IconsPhosphor Icons1,512 flexible icons in six weights, one web component each.IconsSymbols157 themeable spot illustrations for empty states, status panels, onboarding and error pages.IconsTask icons191 duotone icons for to-do items: work, home, health, sport, learning, food, money, travel and more.IconsThemingTheme every c2n component from a handful of design tokens with @c2n/theme, or reach for any component variable directly.GuideLanguagesComponents show their text in English; add your app’s languages as one JSON object, picked by the nearest lang.GuideFrameworksUse the components from React, Vue, Angular, Svelte, Lit or plain HTML — typed events, generated template types, and the one piece of configuration each framework needs.GuideUsing c2n in an applicationThe workflow behind every c2n app: load the theme once, use c2-* tags directly, and turn every repeated pattern into a small variant or composed component.GuideAI toolsGive Claude Code, Codex, Google Antigravity or GitHub Copilot the c2n skill, live component APIs, examples and application conventions.GuideNo components match.
↑↓navigate↵openescclose