<div class="property" id="aria-errormessage">

<pdef>aria-errormessage</pdef>

<div class="property-description">

<p><a>Identifies</a> the <a>element</a> that provides an error message for an <a>object</a>. See related <sref>aria-invalid</sref> and <pref>aria-describedby</pref>.</p>

<p>The <code>aria-errormessage</code> attribute references another element that contains error message text. Authors MUST use <sref>aria-invalid</sref> in conjunction with <code>aria-errormessage</code>.</p>

<p>When the value of an object is not valid, <sref>aria-invalid</sref> is set to <code>true</code>, which indicates that the message contained by an element referenced by <code>aria-errormessage</code> is pertinent.</p>

<p>When an object is in a valid state, it has either <sref>aria-invalid</sref> set to <code>false</code> or it does not have the <sref>aria-invalid</sref> attribute. Authors MAY use <code>aria-errormessage</code> on an object that is currently valid, but only if the element referenced by <code>aria-errormessage</code> is [=element/hidden=], because the message it contains is not pertinent.</p>

<p><a>Identifies</a> the <a>element</a> (or elements) that provides an error message for an <a>object</a>. See related <sref>aria-invalid</sref> and <pref>aria-describedby</pref>.</p>

<p>The <code>aria-errormessage</code> attribute references other elements that contain error message text. Authors MUST use <sref>aria-invalid</sref> in conjunction with <code>aria-errormessage</code>.</p>

<p>When the value of an object is not valid, <sref>aria-invalid</sref> is set to <code>true</code>, which indicates that the message contained by elements referenced by <code>aria-errormessage</code> is pertinent.</p>

<p>When an object is in a valid state, it has either <sref>aria-invalid</sref> set to <code>false</code> or it does not have the <sref>aria-invalid</sref> attribute. Authors MAY use <code>aria-errormessage</code> on an object that is currently valid, but only if the elements referenced by <code>aria-errormessage</code> are [=element/hidden=], because the message they contain is not pertinent.</p>

<p>When <code>aria-errormessage</code> is pertinent, authors MUST ensure the content is not hidden so users can navigate to and examine the error message. Similarly, when <code>aria-errormessage</code> is not pertinent, authors MUST either ensure the content is [=element/hidden=] or remove the <code>aria-errormessage</code> attribute or its value.</p>

<p>User agents MUST NOT expose <code>aria-errormessage</code> for an object with an <sref>aria-invalid</sref> value of <code>false</code>.</p>

<p>Authors MAY call attention to a newly rendered error message with a live region by either applying an <pref>aria-live</pref> property or using one of the <a href="#live_region_roles">live region roles</a>, such as <rref>alert</rref>. A live region is appropriate when an error message is displayed to users after they have provided an invalid value.</p>

</tr>

<tr>

<th class="property-value-head" scope="row">Value:</th>

<td class="property-value"><a href="#valuetype_idref">ID reference</a></td>

<td class="property-value"><a href="#valuetype_idref_list">ID reference list</a></td>

</tr>

</tbody>

</table>

[CEReactions] attribute DOMString? ariaDescription;

[CEReactions] attribute FrozenArray&lt;Element&gt;? ariaDetailsElements;

[CEReactions] attribute DOMString? ariaDisabled;

[CEReactions] attribute Element? ariaErrorMessageElement;

[CEReactions] attribute FrozenArray&lt;Element&gt;? ariaErrorMessageElements;

[CEReactions] attribute DOMString? ariaExpanded;

[CEReactions] attribute FrozenArray&lt;Element&gt;? ariaFlowToElements;

[CEReactions] attribute DOMString? ariaHasPopup;

<tr><td><dfn>ariaDescription</dfn></td><td><pref>aria-description</pref></td></tr>

<tr><td><dfn>ariaDetailsElements</dfn></td><td><pref>aria-details</pref></td></tr>

<tr><td><dfn>ariaDisabled</dfn></td><td><sref>aria-disabled</sref></td></tr>

<tr><td><dfn>ariaErrorMessageElement</dfn></td><td><pref>aria-errormessage</pref></td></tr>

<tr><td><dfn>ariaErrorMessageElements</dfn></td><td><pref>aria-errormessage</pref></td></tr>

<tr><td><dfn>ariaExpanded</dfn></td><td><sref>aria-expanded</sref></td></tr>

<tr><td><dfn>ariaFlowToElements</dfn></td><td><pref>aria-flowto</pref></td></tr>

<tr><td><dfn>ariaHasPopup</dfn></td><td><pref>aria-haspopup</pref></td></tr>