suggested simplification · w3c/accname@ef5724a (original) (raw)

`@@ -294,7 +294,26 @@

Computation steps

294

295

296

297

Otherwise, if computing a name, and if the current node has an aria-label attribute whose value is not the empty string, nor, when trimmed of white space, is not the empty string:

297

Otherwise, if the current node is a control embedded within the label (e.g. the label element in HTML or any element directly referenced by aria-labelledby) for another widget, where the user can adjust the embedded control's value, then include the embedded control as part of the text alternative in the following manner:

298

299

If the embedded control has role textbox, return its value.

300

If the embedded control has role menu button, return the text alternative of the button.

301

If the embedded control has role combobox or listbox, return the text alternative of the chosen option.

302

If the embedded control has role range (e.g., a spinbutton or slider):
`

``

303

`+
- If the aria-valuetext property is present, return its value,
- Otherwise, if the aria-valuenow property is present, return its value,
- Otherwise, use the value as specified by a host language attribute.
`

``

308

`+

309

310

311

Example:

312

Consider a check box label that contains a text input field: "Flash the screen [input] times". If the user has entered "5" for the embedded textbox, the complete label is "Flash the screen 5 times", e.g.:

313

<div role="checkbox" aria-checked="false">Flash the screen <span role="textbox" aria-multiline="false"> 5 </span> times</div>

314

315

316

Otherwise, if computing a name, and if the current node has an aria-label attribute whose value is not the empty string, nor, when trimmed of white space, is not the empty string:

298

317

299

318

If traversal of the current node is due to recursion and the current node is an embedded control as defined in step 2E, ignore aria-label and skip to rule 2E.

300

319

Otherwise, return the value of aria-label.

`@@ -315,31 +334,13 @@

Computation steps

315

334

`</ul>

316

335

317

336

318

Otherwise, if the current node's native markup provides an attribute (e.g. title) or element (e.g. HTML label) that defines a text alternative, return that alternative in the form of a flat string as defined by the host language, unless the element is marked as presentational (role="presentation" or role="none").

337

338

319

339

320

340

Comment:

321

341

For example, in HTML, the img element's alt attribute defines a text alternative string, and the label element provides text for the referenced form element. In SVG2, the desc and title elements provide a description of their parent element.

322

342

323

343

324

325

326

If the embedded control has role textbox, return its value.

327

If the embedded control has role menu button, return the text alternative of the button.

328

If the embedded control has role combobox or listbox, return the text alternative of the chosen option.

329

If the embedded control has role range (e.g., a spinbutton or slider):
`

330

``

`-
- If the aria-valuetext property is present, return its value,
- Otherwise, if the aria-valuenow property is present, return its value,
- Otherwise, use the value as specified by a host language attribute.
`

335

``

`-