Normas de Accesibilidad Web – Principles, Guidelines, Criterions, Techniques

Aspose.HTML for Java proporciona el paquete com.aspose.html.accessibility, destinado a todas las manipulaciones y comprobaciones relacionadas con la accesibilidad web. En este artículo, aprenderá a utilizar la clase AccessibilityRules, que es un repositorio de requisitos, criterios de éxito y técnicas WCAG 2.0.

Las reglas de accesibilidad son un conjunto de directrices, estándares o buenas prácticas que definen cómo diseñar y desarrollar contenidos digitales, como sitios web, aplicaciones y medios de comunicación, para garantizar que puedan ser utilizados por personas con discapacidad. Estas normas ayudan a que las experiencias en línea sean accesibles para las personas con discapacidades visuales, auditivas, motoras o cognitivas, fomentando la inclusión digital y garantizando la igualdad de acceso a la información, los servicios y la tecnología para todos.

La estructura de la referencia rápida sobre accesibilidad web puede representarse como un diagrama, que se muestra a continuación:

Texto “La estructura de las normas de accesibilidad web – principios, pautas y criterios”.

Reglas de accesibilidad

La clase AccessibilityRules es un repositorio de requisitos, criterios de éxito y técnicas WCAG 2.0 y tiene una estructura que se corresponde con la especificación WCAG (Referencia rápida). Para ver la lista de reglas, es necesario inicializar el contenedor WebAccessibility y utilizar la propiedad Rules.

La propiedad devuelve un objeto de tipo AccessibilityRules, que tiene dichos métodos para acceder a las reglas:

Methods	Description
getPrinciple(`string code`)	Returns a Principle object by code from WCAG.
getPrinciples()	Returns a list of principles IList<Principle>.
getRules(`params string[] codes`)	Returns a list of rules IList< IRule> for given codes from WCAG.

El directorio contiene reglas que heredan de la clase abstracta Rule. Existen varios tipos de reglas:

principle
guideline
criterion
technique

IRule

Todas las reglas implementan la interfaz IRule es una interfaz pública que define las propiedades básicas de las reglas:

Property	Description
Code	Rule code from the quick reference WCAG.
Description	Description of Rule from the quick reference WCAG.

Rule

La clase abstracta base para todas las reglas, que implementa la interfaz IRule. Para obtener cualquier regla, puede utilizar el método getRules():

 1// Retrieve and list accessibility rules by code with their descriptions from the rules repository
 2
 3// Initialize a webAccessibility container
 4WebAccessibility webAccessibility = new WebAccessibility();
 5
 6// List of rule codes can contain both technique codes and principles,
 7// guidelines and criteria - all rules that implement the interface IRule
 8String[] rulesCodes = new String[]{"H2", "H37", "H30", "1.1", "1.2.1"};
 9
10// Get a list of IRule objects; if a rule with the specified code is not found,
11// it will not be in the list
12List<IRule> rules = webAccessibility.getRules().getRules(rulesCodes);
13
14// Get code and description of rule
15for (IRule rule : rules) {
16    System.out.println(String.format("%s: %s",
17            rule.getCode(),
18            rule.getDescription()
19    ));
20}

Example_GetAccessibilityRulesByCode.java hosted with ❤ by GitHub

El programa mostrará la salida en la consola:

1    H2:Combining adjacent image and text links for the same resource
2    H37:Using alt attributes on img elements
3    H30:Providing link text that describes the purpose of a link for anchor elements
4    1.1:Text Alternatives
5    1.2.1:Audio-only and Video-only (Prerecorded)

Principle

En el primer nivel de la lista de reglas se encuentran los Principles, que indican la dirección principal y el propósito de las reglas que se encuentran en esta sección. Por lo tanto, el trabajo con el directorio comienza con ellos.

La clase Principle hereda de IRule y también contiene una lista de directrices.

Method	Description
getGuideline(`string code`)	Get Guideline by code from WCAG, contained in principle. Return Guideline object.
getGuidelines()	Get a list of Guideline from Principle. Return IList< Guideline> object.

Un ejemplo de cómo obtener un objeto Principle a partir de una lista de reglas:

 1// Get accessibility principle by code from WCAG rules in Aspose.HTML for Java
 2
 3// Initialize a webAccessibility container
 4WebAccessibility webAccessibility = new WebAccessibility();
 5
 6// Get the principle by code
 7Principle rule = webAccessibility.getRules().getPrinciple("1");
 8
 9// Get code and description of principle
10System.out.println(String.format("%s: %s",
11        rule.getCode(),
12        rule.getDescription()
13));
14// @output: 1:Perceivable

Example_GetAccessibilityPrincipleByCode.java hosted with ❤ by GitHub

Guideline

La clase Guideline hereda de IRule y contiene una lista de criterios. Las Guidelines son el nivel siguiente a los principios. Esbozan marcos y objetivos generales que ayudan a los autores a comprender los criterios de éxito y a aplicar mejor las técnicas.

Method	Description
getCriterion(`string code`)	Get Guideline by code from WCAG, contained in current Guideline. Return Criterion object.
getCriterions()	Get a list of Criterion from current Guideline. Return IList< Criterion> object.

Un ejemplo de cómo obtener un objeto Guideline a partir de una lista de reglas:

 1// Get accessibility guideline by code from WCAG principle in Aspose.HTML for Java
 2
 3// Initialize a webAccessibility container
 4WebAccessibility webAccessibility = new WebAccessibility();
 5
 6// Get the principle by code 
 7Principle principle = webAccessibility.getRules().getPrinciple("1");
 8
 9// Get guideline 1.1
10Guideline guideline = principle.getGuideline("1.1");
11if (guideline != null) {
12    System.out.println(String.format("%s: %s, %s",
13            guideline.getCode(),
14            guideline.getDescription(),
15            guideline
16    ));
17    // @output: 1.1:Text Alternatives
18}

Example_GetAccessibilityGuideline.java hosted with ❤ by GitHub

Criterion

La clase Criterion describe los criterios de éxito WCAG, heredados de la clase abstracta Rule. Puede encontrar información detallada aquí – Understanding Techniques for WCAG Success Criteria. La base para determinar la conformidad con las WCAG 2.0 son los criterios de éxito de la norma. El criterio contiene una lista de techniques para cumplir las pautas WCAG de accesibilidad al contenido web. Si todos los métodos suficientes para un criterio dado son compatibles con la accesibilidad, entonces se ha superado el criterio de éxito.

Utilice el método getCriterion(code) para acceder a los criterios de las pautas:

 1// Get accessibility criterion and its sufficient techniques in Java
 2
 3// Initialize a webAccessibility container
 4WebAccessibility webAccessibility = new WebAccessibility();
 5
 6// Get the principle by code 
 7Principle principle = webAccessibility.getRules().getPrinciple("1");
 8
 9// Get guideline 
10Guideline guideline = principle.getGuideline("1.1");
11
12// Get criterion by code
13Criterion criterion = guideline.getCriterion("1.1.1");
14if (criterion != null) {
15    System.out.println(String.format("%s: %s - %s",
16            criterion.getCode(),
17            criterion.getDescription(),
18            criterion.getLevel()
19    ));
20    // @output: 1.1.1:Non-text Content - A
21
22    // Get all Sufficient Techniques and write to console
23    for (IRule technique : criterion.getSufficientTechniques())
24        System.out.println(String.format("%s: %s",
25                technique.getCode(),
26                technique.getDescription()
27        ));
28}

Example_GetAccessibilityCriterion.java hosted with ❤ by GitHub

Comprobación de HTML según normas específicas de accesibilidad web

Este código demuestra cómo validar un documento HTML para la accesibilidad web utilizando el conjunto de reglas especificado.

 1// Validate an HTML document using specific rule codes with Java
 2
 3String htmlPath = "input.html";
 4
 5// Initialize a webAccessibility container
 6WebAccessibility webAccessibility = new WebAccessibility();
 7
 8// List of necessary rules for checking (rule code according to the specification) 
 9String[] rulesCode = new String[]{"H2", "H37", "H67", "H86"};
10
11// Get the required IList<Rule> rules from the rules reference
12List<IRule> rules = webAccessibility.getRules().getRules(rulesCode);
13
14// Create an accessibility validator, pass the found rules as parameters,
15// and specify the full validation settings
16AccessibilityValidator validator = webAccessibility.createValidator(
17        rules, ValidationBuilder.getAll());
18
19// Initialize an object of the HTMLDocument
20final HTMLDocument document = new HTMLDocument(htmlPath);
21// Check the document
22ValidationResult validationResult = validator.validate(document);
23
24// Return the result in string format
25// SaveToString - return only errors and warnings
26System.out.println(validationResult.saveToString());

Example_CheckHtmlAgainstSpecificWebAccessibilityRules.java hosted with ❤ by GitHub

Utilice el constructor WebAccessibility() para crear el contenedor webAccessibility, que gestiona las reglas de accesibilidad y la validación.
Defina una lista de códigos de reglas (p. ej., “H2”, “H37”, “H67”, “H86”) que correspondan a los estándares de accesibilidad que desea validar.
Llame al método getRules() y pase la lista de códigos de reglas como parámetro.
Cree un validador llamando al método createValidator() en el contenedor webAccessibility y pasándole las reglas resultantes y ValidationBuilder.getAll().
Cargue el documento HTML que desee validar utilizando uno de los constructores HTMLDocument().
Utilice el método validate(document) del validador para comprobar el HTMLDocument cargado con las reglas definidas. El resultado de la validación es el objeto ValidationResult.
Llame al método saveToString() en el objeto ValidationResult para formatear los resultados, incluyendo únicamente los errores y advertencias, como una cadena.
Envíe los resultados de la validación a la consola o guárdelos según sea necesario para su posterior análisis o generación de informes.

Ver también

Encontrará consejos útiles para evaluar y mejorar la visibilidad del texto en el artículo Accesibilidad del contraste de color, que aborda la comprobación de contraste basada en WCAG con Aspose.HTML for Java.
Para obtener instrucciones sobre cómo comprobar la compatibilidad del contenido web con lectores de pantalla, consulte el artículo Accesibilidad de lectores de pantalla. Aprenderá a comprobar el texto alternativo y otros elementos clave.
Si desea aprender a ver los resultados de la validación e identificar problemas de accesibilidad web, consulte el artículo Resultados de la validación.
En el artículo Comprobación de accesibilidad web – Errores y advertencias, aprenderá cómo recopilar programáticamente en Java información de errores y advertencias mientras se verifica la accesibilidad de un sitio web.

Aspose.HTML ofrece una Comprobador de accesibilidad web gratuita en línea. Esta herramienta analiza páginas web, las valida según WCAG, identifica problemas y sugiere mejoras. Obtén información instantánea sobre el cumplimiento de tu sitio y determina qué ajustes necesitas hacer para alcanzar los requisitos de WCAG.

Comprobación de accesibilidad web Validador de accesibilidad