Exponer información básica de accesibilidad

  • Artículo

La información de accesibilidad básica se suele clasificar en nombre, rol y valor. En este tema se describe el código para ayudar a que tu aplicación exponga la información básica requerida por las tecnologías de asistencia.

Nombre accesible

Un nombre accesible es una cadena de texto descriptiva y corta que un lector de pantalla usa para anunciar un elemento de la interfaz de usuario. Establece el nombre accesible de los elementos de la interfaz de usuario para que tengan un significado que es importante para comprender el contenido o interactuar con la interfaz de usuario. Generalmente, esos elementos incluyen imágenes, campos de entrada, botones y controles.

En esta tabla, se describe cómo definir un nombre accesible para varios tipos de elementos en una interfaz de usuario XAML.

Tipo de elemento Descripción
Texto estático En los elementos TextBlock y RichTextBlock, se determina automáticamente un nombre accesible del texto visible (interno). Todo el texto incluido en ese elemento se usa como nombre. Vea Nombre del texto interno.
Imágenes El elemento XAML Image no tiene un equivalente directo con el atributo alt de HTML de img y elementos similares. Usa AutomationProperties.Name para proporcionar un nombre o usa la técnica de subtítulos. Consulta Nombres accesibles para imágenes.
Elementos de formulario El nombre accesible para un elemento de formulario debe ser el mismo que la etiqueta que se muestra para ese elemento. Consulte Etiquetas y LabeledBy.
Botones y vínculos De manera predeterminada, el nombre accesible de un botón o vínculo se basa en el texto visible, usando las mismas reglas descritas en Nombre del texto interno. En los casos en los que un botón incluye solo una imagen, usa AutomationProperties.Name para proporcionar un equivalente de solo texto de la acción prevista del botón.

Las mayoría de los elementos contenedores, como paneles, no promueven su contenido como nombre accesible. Esto se debe a que el contenido del elemento debe notificar un nombre y su respectivo rol, no su contenedor. El elemento contenedor puede notificar que se trata de un elemento que tiene elementos secundarios en una representación de automatización de la interfaz de usuario de Microsoft para que la lógica de las tecnologías de asistencia pueda recorrerlo. Pero los usuarios de tecnologías de asistencia, por lo general, no necesitan saber sobre los contenedores y, por consiguiente, la mayoría de los contenedores no llevan nombre.

Rol y valor

Los controles y otros elementos de la interfaz de usuario que forman parte del vocabulario XAML de Windows implementan compatibilidad para la automatización de la interfaz de usuario para notificar el rol y el valor como parte de sus definiciones. Puedes usar las herramientas de automatización de la interfaz de usuario para los controles o puedes leer la documentación para las implementaciones de AutomationPeer de cada control. Los roles disponibles en un marco de trabajo de automatización de la interfaz de usuario están definidos en la enumeración AutomationControlType. Los clientes de automatización de la interfaz de usuario, como las tecnologías de asistencia pueden obtener información de roles mediante llamadas a los métodos que el marco de trabajo de automatización de la interfaz de usuario expone con AutomationPeer del control.

No todos los controles tienen un valor. Los controles que tienen un valor proporcionan esta información a la automatización de la interfaz de usuario mediante los modelos y sistemas del mismo nivel admitidos por ese control. Por ejemplo, un elemento de formulario TextBox tiene un valor. Una tecnología de asistencia puede ser un cliente de automatización de la interfaz de usuario y puede descubrir que un valor existe y cuál es su valor. En este caso concreto, TextBox es compatible con el patrón IValueProvider mediante las definiciones TextBoxAutomationPeer.

Nota:

En los casos en los que usas AutomationProperties.Name u otras técnicas para proporcionar el nombre accesible de forma explícita, no incluyas el mismo texto que usa el rol de control ni escribas información en el nombre accesible. Por ejemplo, no incluyas cadenas como "botón" o "lista" en el nombre. La información sobre el rol y el tipo proviene de otra propiedad de automatización de la interfaz de usuario (LocalizedControlType) que es proporcionada por la compatibilidad predeterminada del control para la automatización de la interfaz de usuario. Muchas tecnologías de asistencia anexan LocalizedControlType al nombre accesible, por lo que duplican el rol en el nombre accesible que puede provocar la repetición innecesaria de palabras. Por ejemplo, si asignas a un control Button un nombre accesible de "botón" o incluyes "botón" como la parte final del nombre, los lectores de pantalla podrían leer esto como "botón botón". Debes probar este aspecto de tu información de accesibilidad usando el Narrador.

Influencia en las vistas de árbol de automatización de la interfaz de usuario

El marco de trabajo de automatización de la interfaz de usuario tiene un concepto de vistas de árbol, en el que los clientes de automatización de la interfaz de usuario pueden recuperar las relaciones entre los elementos en una interfaz de usuario usando tres posibles vistas: raw, control y content. La vista control es la que suelen usar los clientes de automatización de la interfaz de usuario porque proporciona una buena representación y organización de los elementos en una interfaz de usuario que es interactiva. Las herramientas de pruebas normalmente permiten elegir qué vista de árbol se usará cuando la herramienta presente la organización de los elementos.

De forma predeterminada, cualquier clase derivada de Control y algunos otros elementos aparecerán en la vista de control cuando el marco de automatización de la interfaz de usuario representa la interfaz de usuario de una aplicación de Windows. Pero a veces no quieres que un elemento aparezca en la vista control debido a la composición de la interfaz de usuario, en la que el elemento duplica información o presenta información que no es importante para los escenarios de accesibilidad. Usa la propiedad adjunta AutomationProperties.AccessibilityView para cambiar la manera en que los elementos se exponen en las vistas de árbol. Si colocas un elemento en el árbol Raw, la mayoría de las tecnologías de asistencia no notificarán ese elemento como parte de sus vistas. Para ver algunos ejemplos de cómo funciona esto en los controles existentes, abre el archivo XAML de referencia de diseño generic.xaml en un editor de texto y busca AutomationProperties.AccessibilityView en las plantillas.

Nombre del texto interno

Para simplificar el uso de cadenas que ya existen en la interfaz de usuario visible para los valores de nombres accesibles, muchos de los controles y otros elementos de la interfaz de usuario permiten determinar automáticamente un nombre accesible predeterminado en función del texto interno del elemento o a partir de los valores de cadena de las propiedades de contenido.

  • TextBlock, RichTextBlock, TextBox y RichTextBlock promueven el valor de la propiedad Text como nombre accesible predeterminado.
  • Todas las subclases ContentControl usan una técnica iterativa "ToString" para encontrar cadenas en su valor Content y promueven estas cadenas como nombre accesible predeterminado.

Nota

Tal y como impone la automatización de la interfaz de usuario, la longitud del nombre accesible no puede ser superior a 2048 caracteres. Si una cadena usada para determinar el nombre accesible de manera automática excede ese límite, el nombre accesible se truncará en ese punto.

Nombres accesibles para imágenes

Para admitir lectores de pantalla y proporcionar información de identificación básica de cada elemento de la interfaz de usuario, en ocasiones debes proporcionar alternativas de texto a información no textual, como imágenes o gráficos (y excluir todo elemento meramente decorativo o estructural). Estos elementos no tienen texto interno, por lo que el nombre accesible no tendrá un valor calculado. Puedes definir el nombre accesible configurando la propiedad adjunta AutomationProperties.Name como se muestra en este ejemplo.

XAML

<!-- Comment -->
<Image Source="product.png"
  AutomationProperties.Name="An image of a customer using the product."/>

De manera alternativa, considera incluir un subtítulo que aparezca en la interfaz de usuario visible y que también funcione como información de accesibilidad asociada con la etiqueta para el contenido de imagen. Este es un ejemplo:

XAML

<Image HorizontalAlignment="Left" Width="480" x:Name="img_MyPix"
  Source="snoqualmie-NF.jpg"
  AutomationProperties.LabeledBy="{Binding ElementName=caption_MyPix}"/>
<TextBlock x:Name="caption_MyPix">Mount Snoqualmie Skiing</TextBlock>

Etiquetas y LabeledBy.

La manera preferida de asociar una etiqueta con un elemento de formulario es usar TextBlock con x:Name para el texto de la etiqueta y después definir la propiedad adjunta AutomationProperties.LabeledBy en el elemento de formulario para hacer referencia a la etiqueta TextBlock por su nombre XAML. Si usa este patrón, las tecnologías de asistencia pueden usar el texto de la etiqueta como nombre accesible para el campo de formulario. A continuación te mostramos un ejemplo que muestra esta técnica.

XAML

<StackPanel x:Name="LayoutRoot" Background="White">
   <StackPanel Orientation="Horizontal">
     <TextBlock Name="lbl_FirstName">First name</TextBlock>
     <TextBox
      AutomationProperties.LabeledBy="{Binding ElementName=lbl_FirstName}"
      Name="tbFirstName" Width="100"/>
   </StackPanel>
   <StackPanel Orientation="Horizontal">
     <TextBlock Name="lbl_LastName">Last name</TextBlock>
     <TextBox
      AutomationProperties.LabeledBy="{Binding ElementName=lbl_LastName}"
      Name="tbLastName" Width="100"/>
   </StackPanel>
 </StackPanel>

Descripción accesible (opcional)

Una descripción accesible proporciona información de accesibilidad adicional acerca de un elemento de la interfaz de usuario particular. Generalmente proporcionas una descripción accesible cuando un nombre accesible solo no transmite suficientemente el propósito de un elemento.

El lector de pantalla Narrador lee la descripción accesible de un elemento solamente cuando el usuario solicita más información acerca del elemento presionando Bloq Mayús+F.

El nombre accesible está destinado a identificar el control, en lugar de documentar su comportamiento. Si una breve descripción no es suficiente para explicar el control, puede establecer la propiedad adjunta AutomationProperties.HelpText además de AutomationProperties.Name.

Probar la accesibilidad desde el principio y con frecuencia

En última instancia, el mejor enfoque para admitir lectores de pantalla es probar tu aplicación usando uno tú mismo. Eso mostrará cómo se comporta el lector de pantalla y qué información de accesibilidad básica puede faltar en la aplicación. Después, puedes ajustar los valores de la interfaz de usuario o propiedad de automatización de la interfaz de usuario en consecuencia. Para obtener más información, consulta Pruebas de accesibilidad.

Una de las herramientas que puedes usar para probar la accesibilidad se llama AccScope. La herramienta AccScope es especialmente útil porque puedes ver representaciones visuales de la interfaz de usuario que muestran cómo verían tu aplicación las tecnologías de asistencia como un árbol de automatización. En particular, hay un modo de Narrador que muestra cómo el Narrador obtiene el texto de la aplicación y cómo organiza los elementos de la interfaz de usuario. AccScope está diseñado para que pueda usarse y resulte útil durante todo el ciclo de desarrollo de una aplicación, incluso en la fase de diseño preliminar. Para más información, consulta el tema sobre AccScope.

Nombres accesibles de datos dinámicos

Windows admite muchos controles que se pueden usar para mostrar valores que provienen de un origen de datos asociado, a través de una función conocida como enlace de datos. Cuando rellenas listas con elementos de datos, puedes tener que usar una técnica que establezca nombres accesibles para elementos de lista enlazados a datos después de que se haya rellenado la lista inicial. Para obtener más información, consulta "Escenario 4" en el ejemplo de accesibilidad XAML.

Nombres accesibles y localización

Para asegurarte de que el nombre accesible también sea un elemento que está localizado, deberías usar técnicas adecuadas para almacenar las cadenas localizables como recursos y después hacer referencia a las conexiones de los recursos con valores directiva x:Uid. Si el nombre accesible proviene de un uso de AutomationProperties.Name establecido de manera explícita, asegúrate de que esa cadena también sea localizable.

Ten en cuenta que las propiedades adjuntas, como las propiedades AutomationProperties, usan una sintaxis de calificación especial para el nombre del recurso, de manera que el recurso hace referencia a la propiedad adjunta como si se aplicara a un elemento específico. Por ejemplo, el nombre de recurso AutomationProperties.Name tal y como se aplica a un elemento de la interfaz de usuario denominado MediumButton es: MediumButton.[using:Windows.UI.Xaml.Automation]AutomationProperties.Name.