@jsswift/ui 1.0.48 → 1.0.50

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsswift/ui",
-  "version": "1.0.48",
+  "version": "1.0.50",
   "description": "JSswift UI layer built on top of @jsswift/core",
   "license": "MIT",
   "repository": {
@@ -38,6 +38,6 @@
     "src"
   ],
   "peerDependencies": {
-    "@jsswift/core": "^1.0.48"
+    "@jsswift/core": "^1.0.50"
   }
 }

package/src/10-primitives-layout.js

@@ -1092,6 +1092,7 @@
   // props: { model: rod OR [get,set] signal OR plain, placeholder, type }
 
 
+  let uiFieldMessageId = 0;
   UI.FormField = (props = {}) => {
 
     applyCommonProps(props);
@@ -1224,6 +1225,14 @@
       return true;
     };
     let messageEl = null;
+    const messageId = `jsswift-field-message-${++uiFieldMessageId}`;
+    const syncDescription = () => {
+      if (!controlEl?.setAttribute) return;
+      const ids = [uiUnwrap(props.ariaDescribedBy), messageEl?.id].filter(Boolean).join(" ").trim();
+      if (ids) controlEl.setAttribute("aria-describedby", [...new Set(ids.split(/\s+/))].join(" "));
+      else controlEl.removeAttribute("aria-describedby");
+    };
+    wrap._syncDescription = syncDescription;
     const renderMessage = () => {
       const statusOrder = [
         { key: "error", value: resolveValue(props.error), slot: "errorMessage", className: "cms-error" },
@@ -1251,7 +1260,7 @@
         ? renderSlotToArray(slots, active.slot, ctx, active.value)
         : [];
       const nextEl = nodes.length
-        ? _.div({ class: active?.className }, ...nodes)
+        ? _.div({ id: messageId, class: active?.className }, ...nodes)
         : null;
 
       const stateKeys = ["error", "warning", "success", "note"];
@@ -1264,6 +1273,7 @@
         wrap.appendChild(nextEl);
       }
       messageEl = nextEl;
+      syncDescription();
     };
 
     // state updater
@@ -1405,6 +1415,30 @@
     return el;
   };
 
+  // Public field attributes belong to the interactive control, not its wrapper.
+  function uiConfigureFieldControl(field, control, props, native = false) {
+    field.focus = (options) => control.focus(options);
+    const set = (name, value) => {
+      if (value == null || value === false) control.removeAttribute(name);
+      else control.setAttribute(name, String(value));
+    };
+    JSswift.reactive.effect(() => {
+      const label = uiUnwrap(props.ariaLabel) ?? (typeof props.label === "string" ? props.label : null);
+      set("aria-label", label);
+      set("aria-labelledby", uiUnwrap(props.ariaLabelledBy));
+      field._syncDescription?.();
+      const invalid = props.ariaInvalid == null ? !!uiUnwrap(props.error) : !!uiUnwrap(props.ariaInvalid);
+      control.setAttribute("aria-invalid", String(invalid));
+      const required = !!uiUnwrap(props.required);
+      control.setAttribute("aria-required", String(required));
+      if (native) {
+        control.required = required;
+        for (const name of ["min", "max", "step", "pattern", "minLength", "maxLength"])
+          set(name.toLowerCase(), uiUnwrap(props[name]));
+      }
+    }, "UI.Field:controlAttributes");
+  }
+
   UI.Input = (props = {}) => {
     const slots = props.slots || {};
     const fieldProps = {
@@ -1566,6 +1600,7 @@
 
     // expose reference
     field._input = input;
+    uiConfigureFieldControl(field, input, props, true);
     uiRegisterShortcode(input, props, {
       isEnabled: () => !input.disabled,
       action: () => uiFocusShortcutTarget(input, { selectText: !!props.selectOnShortcode })
@@ -2963,6 +2998,7 @@
     // refresh has-value when value changes
     JSswift.reactive.effect(() => { field._refresh?.(); }, "UI.Select:fieldRefresh");
 
+    uiConfigureFieldControl(field, root, props);
     field._select = root;
     field._dispose = root._dispose;
     JSswift._registerCleanup?.(field, field._dispose);