mirror of
https://github.com/microsoft/BCQuality.git
synced 2026-10-05 22:56:55 +01:00
2b5550c346
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>
32 lines
1.4 KiB
Markdown
32 lines
1.4 KiB
Markdown
---
|
|
bc-version: [all]
|
|
domain: ui
|
|
keywords: [show-caption, group, first-child, multiline, accessibility]
|
|
technologies: [al]
|
|
countries: [w1]
|
|
application-area: [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`](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`](group-labeled-first-child-exception.bad.al).
|