public string Label

Gets the label shown by the component.

public string SubLabel

Gets the secondary line shown below the label, or null when the card has none.

public bool IsRemovable

Returns a value indicating whether the component shows a remove button.

public object Tag { get; set; }

Gets or sets an arbitrary payload associated with this card - the document, record or file it stands for, so a remove or click handler can act on it without a lookup.

public ContextCard SetLabel(string label)

Sets the label of the component. The label is ellipsized to the width the card is given, and carries the full text as its native tooltip.

public ContextCard KeepExtensionVisible(bool value = true)

Configures whether a trailing file extension is held out of the ellipsis, so a label too long for the card reads "Quarterly repo….pdf" rather than "Quarterly repor…". On by default.

public ContextCard MaxLabelWidth(UnitSize size)

Caps the width the label is ellipsized at, for a dense row where every card should stay short. The extension, when kept visible, sits outside this width.

public ContextCard MonospaceSubLabel(bool value = true)

Renders the secondary line in the monospace font, for a path, a table name or a size - the same treatment ToolCall gives the command it names.

public ContextCard WithChevron(bool value = true)

Shows a chevron at the end of the card, the hint that clicking it opens what it stands for. Pair it with OnClick.

public ContextCard SetSubLabel(string subLabel)

Sets the secondary line shown below the label ("PDF", "3 pages", a folder). A null or empty value hides the line and leaves the card as a single centered row.

public ContextCard SetImage(string url)

Sets a thumbnail that fills the whole tile (cropped to cover it), for context that has a preview of its own - an image, a screenshot, a site favicon. The tile's background color is dropped, as the image covers it.

public ContextCard IconBackground(string color)

Sets the background color of the icon tile (any CSS color, e.g. "#ef4444" or "var(--tss-danger-background-color)").

public ContextCard IconForeground(string color)

Sets the color of the glyph on the icon tile.

public ContextCard IconTint(string color, int percent = 14)

Tints the icon tile with the given color: a wash of it behind the glyph, and the glyph itself in full strength. The quieter alternative to a saturated tile, and what a row of many cards usually wants so the colors read as file types rather than as decoration.

public ContextCard NoIconBackground()

Configures the icon tile to have no background, letting the glyph or image sit directly on the card.

public ContextCard Background(string color)

Sets the background color of the card itself.

public ContextCard Removable(bool value = true)

Configures whether the card shows its remove button. Turning it off keeps any handler registered with OnRemove, so turning it back on restores the same behaviour.

public ContextCard NoRemove()

Configures the component to show no remove button.

public ContextCard Compact(bool value = true)

Configures the card as a single tighter row - a pill with a small tile, the label, and the secondary line beside it rather than below. Use it when many cards share a composer, or for one card named inline in a sentence.

public override ContextCard OnClick(ComponentEventHandler<ContextCard, MouseEvent> onClick, bool clearPrevious = true)

Registers a callback invoked when the click event fires. A clickable card also becomes keyboard reachable and is activated with Enter or Space.

public ContextCard ShowMenu()

Opens the menu registered with OnContextMenu anchored to the card, the way the keyboard menu key does. Does nothing when the card has no menu.

public ContextCard Selectable(bool value = true)

Configures whether the text on the card can be selected. It cannot by default: a card is a token standing for one piece of context, not prose, and dragging or right-clicking one should not leave half its label highlighted.

public override HTMLElement Render()

Renders the component's root HTML element.

public IReadOnlyList<ContextCard> Cards

Gets the cards in this group, in the order they were added.

public int Count

Gets the number of cards in this group.

public bool IsExpanded

Returns a value indicating whether the group is expanded (in compact mode: whether the cards beyond MaxVisible are shown).

public ContextCards Add(ContextCard card)

Adds a card to the group. Its remove button is wired to the group, so the (x) takes the card out of the list - a handler the caller registered on the card still runs.

public ContextCards AddRange(IEnumerable<ContextCard> cards)

Adds the given cards to the group.

public ContextCards Remove(ContextCard card)

Removes a card from the group. Does nothing if the card isn't in it.

public ContextCards Clear()

Removes every card from the group.

public ContextCards SetSummary(string summary)

Sets the summary shown on the header pill. Without one, the group summarises itself as "Added N items to context", updated as cards come and go.

public ContextCards SetIcon(UIcons icon)

Sets the icon shown on the header pill (a stack of layers by default).

public ContextCards IconBackground(string color)

Sets the background color of the header's icon tile (any CSS color).

public ContextCards IconForeground(string color)

Sets the color of the glyph on the header's icon tile.

public ContextCards Compact(bool value = true)

Renders the group as a wrapping row of pills with no header, showing the first MaxVisible cards and a "+N more" pill for the rest. For a dense line of attachments where the list view would be too much.

public ContextCards MaxVisible(int count)

Sets how many pills the compact row shows before the "+N more" pill takes over (5 by default). Ignored while the group isn't compact, where the list shows every card.

public ContextCards MoreText(string moreFormat, string lessText = null)

Sets the wording of the pill standing in for the cards the compact row is hiding, as a format string whose {0} is how many that is ("+{0} more" by default), and the wording it takes once they are all shown ("Show less").

public ContextCards OnShowAll(Action handler)

Hands the "+N more" pill over to the given handler instead of revealing the hidden cards in place - for a host that would rather open the full list somewhere else (a panel, a search scoped to the context). Passing null restores the reveal-in-place behaviour.

public ContextCards Expanded(bool value = true)

Expands or collapses the group.

public ContextCards Expand()

Expands the group.

public ContextCards Collapse()

Collapses the group.

public ContextCards Toggle()

Toggles the group between expanded and collapsed.

public ContextCards OnToggle(Action<ContextCards> onToggle)

Registers a callback invoked whenever the group is expanded or collapsed.

public override HTMLElement Render()

Renders the component's root HTML element.