mirror of
https://codeberg.org/PostERG/xamxam.git
synced 2026-06-25 16:19:19 +02:00
e17246c850
WCAG 3.3.1 (Error Identification): failing fields now get aria-errormessage pointing to the flash-error container and aria-invalid="true". WCAG 3.3.3 (Error Suggestion): <small> hint text on inputs, selects, and file fields is now linked via aria-describedby (always, not just on error). Changes: - text-field.php, select-field.php, checkbox-list.php: accept $errorFieldName; add aria-errormessage/aria-invalid on match; add id to <small> and aria-describedby on the control - fieldset-tfe-info.php: aria-invalid on synopsis textarea - fichiers-fragment.php: aria-describedby on cover, note d'intention, TFE, annexes, and website inputs; aria-invalid on format checkboxes when error matches 'formats' - form.php: id="flash-error" + tabindex="-1" on flash-error div; accept $errorFieldName from callers - admin/add.php: set $errorFieldName, wire $withAutofocusFn (was identity default) - admin/edit.php: set $errorFieldName - partage/index.php: consume autofocus field, wire autofocus function, add App::flashAutofocus() in submit catch block Also fixes WCAG standards issue: removed invalid 'required' HTML attribute from <fieldset> elements in checkbox-list.php and fichiers-fragment.php (only aria-required stays). Added role="group" for explicit ARIA semantics.
68 lines
3.3 KiB
PHP
68 lines
3.3 KiB
PHP
<?php
|
|
/**
|
|
* Checkbox list partial — renders a group of checkboxes (e.g. languages, formats).
|
|
*
|
|
* The group label uses a visible <span> as the first column (matching other form
|
|
* rows), while a <fieldset>/<legend> in the second column provides the accessible
|
|
* grouping required by WCAG 1.3.1. The <legend> is visually hidden (sr-only) to
|
|
* avoid duplicating the visible label text.
|
|
*
|
|
* Variables consumed:
|
|
* string $name — input name attribute (will be posted as array: name[])
|
|
* string $label — group label text (htmlspecialchars'd unless $labelHtml is set)
|
|
* string $labelHtml — raw HTML label override (bypasses htmlspecialchars, optional)
|
|
* array $options — each element must have 'id' and 'name' keys
|
|
* array $checked — array of 'id' values that are currently checked
|
|
* bool $required — whether at least one checkbox must be checked; default false
|
|
* string $hxPost — optional hx-post URL for HTMX live update
|
|
* string $hxTarget — optional hx-target CSS selector for HTMX swap
|
|
* string $hxSwap — optional hx-swap value; default 'outerHTML'
|
|
* string $hxInclude — optional hx-include selector; default 'this'
|
|
* string|null $errorFieldName — when set and matches $name, adds aria-invalid on checkboxes
|
|
*/
|
|
|
|
$checked = $checked ?? [];
|
|
$required = $required ?? false;
|
|
$hxPost = $hxPost ?? '';
|
|
$hxTarget = $hxTarget ?? '';
|
|
$hxSwap = $hxSwap ?? 'outerHTML';
|
|
$hxInclude = $hxInclude ?? 'this';
|
|
$errorFieldName = $errorFieldName ?? null;
|
|
|
|
$ariaInvalid = ($errorFieldName === $name) ? ' aria-invalid="true" aria-errormessage="flash-error"' : '';
|
|
// aria-describedby only when there's an error (no hint text for checkbox groups)
|
|
$ariaDescribedBy = ($errorFieldName === $name) ? ' aria-describedby="flash-error"' : '';
|
|
?>
|
|
<div>
|
|
<span class="admin-row-label"><?= isset($labelHtml) ? $labelHtml : (htmlspecialchars($label) . ($required ? ' <span class="asterisk">*</span>' : '')) ?></span>
|
|
<fieldset class="admin-checkbox-group"
|
|
role="group"
|
|
<?= $required ? ' aria-required="true"' : '' ?>
|
|
<?php if ($hxPost !== ''): ?>
|
|
hx-post="<?= htmlspecialchars($hxPost) ?>"
|
|
hx-target="<?= htmlspecialchars($hxTarget) ?>"
|
|
hx-trigger="change"
|
|
hx-include="<?= htmlspecialchars($hxInclude) ?>"
|
|
hx-swap="<?= htmlspecialchars($hxSwap) ?>"
|
|
<?php endif; ?>>
|
|
<legend class="sr-only"><?= htmlspecialchars($label) ?></legend>
|
|
<ul>
|
|
<?php foreach ($options as $opt): ?>
|
|
<li>
|
|
<label class="admin-checkbox-label">
|
|
<input type="checkbox"
|
|
name="<?= htmlspecialchars($name) ?>[]"
|
|
value="<?= htmlspecialchars((string)$opt['id']) ?>"
|
|
<?= in_array((string)$opt['id'], array_map('strval', $checked)) ? 'checked' : '' ?>
|
|
<?= $ariaInvalid ?>
|
|
<?= $ariaDescribedBy ?>>
|
|
<?= htmlspecialchars($opt['name']) ?>
|
|
</label>
|
|
</li>
|
|
<?php endforeach; ?>
|
|
</ul>
|
|
</fieldset>
|
|
</div>
|
|
<?php
|
|
unset($checked, $hxPost, $hxTarget, $hxSwap, $hxInclude, $ariaInvalid, $ariaDescribedBy, $errorFieldName);
|