Referencia describeElement()

describeElement()

describeElement() genera una descripción de los elementos presentes en el lienzo, la cual es accesible para lectores de pantalla y otras tecnologías de asistencia.

Los elementos son formas o grupos de formas que juntas crean significado. Por ejemplo, unos círculos superpuestos podrían formar un elemento “ojo”.

describeElement() cuenta con tres parámetros.

El primer parámetro, name, es el nombre del elemento.

El segundo parámetro, text, es la descripción del elemento.

El tercer parámetro, display, es opcional y determina de qué manera se va a mostrar la descripción. Si LABEL se pasa como argumento, por ejemplo: describe('Descripción del lienzo.', LABEL), la descripción será visible en un elemento ‘div’ al lado del lienzo. Sin embargo, el uso de LABEL crea mensajes duplicados que son ineficientes para los usuarios de lectores de pantalla, por lo que recomendamos utilizar únicamente LABEL durante la fase de desarrollo. Por otro lado, si FALLBACK se pasa como argumento, por ejemplo: describe('Descripción del lienzo.', FALLBACK), la descripción será visible solo para los lectores de pantalla. Este es el modo predeterminado.

Lee ‘ Escribiendo descripciones accesibles para lienzos’ para aprender más sobre cómo hacer que tus ‘sketches’ sean accesibles.

Ejemplos

Sintaxis

describeElement(name, text, [display])

Parámetros

name
String:

nombre del elemento.

text
String:

descripción del elemento..

display
Constant:

ya sea LABEL o FALLBACK.

Notice any errors or typos? Please let us know. Please feel free to edit src/accessibility/describe.js and open a pull request!

Referencias Relacionadas