bcquality/microsoft/knowledge/ui/standalone-content-in-layout-table.md
Jesper Schulz-Wedde b6da405376 Improve partner onboarding and documentation navigation
Lead with a complete plugin quick start and add task-oriented usage, troubleshooting, customization, and contribution guides. Preserve the broader plugin framing, correct conflicting contract guidance, support Agents folder reviews, and align repository validation. Convert existing sample references to clickable links without changing knowledge rules.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
2026-09-09 17:25:29 +02:00

1.1 KiB

bc-version domain keywords technologies countries application-area
all
ui
grid
fixed
layout-table
standalone-content
show-caption
accessibility
al
w1
all

Standalone content in a layout-table grid

Description

A non-editable field with ShowCaption = false is acceptable inside a layout-table grid only when the field is standalone content — it displays a value that is meaningful on its own (for example a status message or a description) and is not intended to label or be labeled by another field in the grid.

Layout tables have no <th> column headers, so a captionless field that is meant to participate in a tabular relationship with a neighbour has no accessible label at all.

Best Practice

Reserve ShowCaption = false in a layout-table grid for non-editable, free-standing content cells. If a field's role is to label or annotate another field in the same grid, restructure the grid to meet the data-table conditions (see grid-data-table-heuristic.md) instead of hiding the caption.

See sample: standalone-content-in-layout-table.good.al.