Microsoft/bcquality
1
0
Fork 0
mirror of https://github.com/microsoft/BCQuality.git synced 2026-10-05 14:46:55 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
bcquality/microsoft/knowledge/ui/group-labeled-first-child-exception.md
Jesper Schulz-Wedde 2b5550c346
Some checks failed
Validate knowledge index / validate-index (push) Has been cancelled
Details
Validate AL review fixtures / validate-review-fixtures (push) Has been cancelled
Details
Validate frontmatter and structure / validate (push) Has been cancelled
Details
Improve partner onboarding and documentation navigation (#174) 
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: Jesper Schulz-Wedde <jesper.schulzwedde@microsoft.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
2026-09-09 17:31:03 +02:00

1.4 KiB
Raw Blame History

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.