bcquality/microsoft/knowledge/ui/group-labeled-first-child-exception.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.4 KiB

bc-version domain keywords technologies countries application-area
all
ui
show-caption
group
first-child
multiline
accessibility
al
w1
all

Group-labeled first child exception

Description

ShowCaption = false is acceptable on an editable field only when all of the following conditions are met:

  1. The control is the first visible field in its parent group.
  2. The field has ShowCaption = false.
  3. The parent group has a visible caption: ShowCaption is true (the default) and the group has a non-empty Caption value.

When these three conditions hold, the group caption becomes the accessible label for the field. This works regardless of whether the field is multiline. The presence of InstructionalText on the field is irrelevant to this check.

Best Practice

Do not second-guess this exception. If the three conditions are met, the pattern is acceptable — even if the group caption seems generic (e.g. "General Information") or does not exactly match the field name.

See sample: group-labeled-first-child-exception.good.al.

Anti Pattern

If the parent group has ShowCaption = false or no Caption, the first-child exception does not apply: the field has no accessible label anywhere.

See sample: group-labeled-first-child-exception.bad.al.