Phalcon Forms component attributes support in version 4.2 shifts ARIA responsibility to developers

Answer

Phalcon's Forms component in version 4.2 does not automatically inject ARIA attributes when the optional attributes array is omitted; the developer must supply them.

Confirmed facts

• The component renders only explicitly supplied attributes; no aria‑* attributes are added by default.
• There is no configuration flag to enable automatic ARIA injection.
• To add default ARIA labels you must extend the base form element class (e.g., Phalcon\\Forms\\Element\\Text) and override getAttributes() to merge fallback attributes when the attributes array is empty.

Likely explanation

Automatically deriving an aria‑label from the field's label or name could override intentional accessibility attributes set by the developer and would break backward compatibility for projects that rely on the current behaviour.

Steps to add a fallback aria‑label (if you decide to implement it)

1. Create a custom element class, e.g. src/Form/Element/Text.php, extending Phalcon\\Forms\\Element\\Text.
2. Override getAttributes():

getLabel();
            if ($label !== null) {
                $attributes['aria-label'] = $label;
            } elseif ($this->getName() !== null) {
                $attributes['aria-label'] = $this->getName();
            }
        }

        return $attributes;
    }
}

1. Use the custom element in your form instead of the default one.
2. Verify the output: render the form in a view and inspect the generated HTML; the should contain an aria-label attribute when no explicit attributes were supplied.

Configuration / disabling

Because the behaviour is implemented in a custom element class, you can enable or disable it per project simply by choosing whether to use the custom element or the default Phalcon element. No global switch exists.

Missing diagnostic detail

Do you already have a custom base form element class in your project? If you do, you can add the fallback logic there; otherwise you will need to create one as shown above.