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:

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():

// Initialize a webAccessibility container
WebAccessibility webAccessibility = new WebAccessibility();

// List of rule codes can contain both technique codes and principles,
// guidelines and criteria - all rules that implement the interface IRule
String[] rulesCodes = new String[]{"H2", "H37", "H30", "1.1", "1.2.1"};

// Get a list of IRule objects; if a rule with the specified code is not found,
// it will not be in the list
List<IRule> rules = webAccessibility.getRules().getRules(rulesCodes);

// Get code and description of rule
for (IRule rule : rules) {
    System.out.println(String.format("%s: %s",
            rule.getCode(),
            rule.getDescription()
    ));
}

El programa mostrará la salida en la consola:

    H2:Combining adjacent image and text links for the same resource
    H37:Using alt attributes on img elements
    H30:Providing link text that describes the purpose of a link for anchor elements
    1.1:Text Alternatives
    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:

// Initialize a webAccessibility container
WebAccessibility webAccessibility = new WebAccessibility();

// Get the principle by code
Principle rule = webAccessibility.getRules().getPrinciple("1");

// Get code and description of principle
System.out.println(String.format("%s: %s",
        rule.getCode(),
        rule.getDescription()
));
// @output: 1:Perceivable

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:

// Initialize a webAccessibility container
WebAccessibility webAccessibility = new WebAccessibility();

// Get the principle by code
Principle principle = webAccessibility.getRules().getPrinciple("1");

// Get guideline 1.1
Guideline guideline = principle.getGuideline("1.1");
if (guideline != null) {
    System.out.println(String.format("%s: %s, %s",
            guideline.getCode(),
            guideline.getDescription(),
            guideline
    ));
    // @output: 1.1:Text Alternatives
}

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:

// Initialize a webAccessibility container
WebAccessibility webAccessibility = new WebAccessibility();

// Get the principle by code
Principle principle = webAccessibility.getRules().getPrinciple("1");

// Get guideline
Guideline guideline = principle.getGuideline("1.1");

// Get criterion by code
Criterion criterion = guideline.getCriterion("1.1.1");
if (criterion != null) {
    System.out.println(String.format("%s: %s - %s",
            criterion.getCode(),
            criterion.getDescription(),
            criterion.getLevel()
    ));
    // @output: 1.1.1:Non-text Content - A

    // Get all Sufficient Techniques and write to console
    for (IRule technique : criterion.getSufficientTechniques())
        System.out.println(String.format("%s: %s",
                technique.getCode(),
                technique.getDescription()
        ));
}

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.

String htmlPath = "input.html";

// Initialize a webAccessibility container
WebAccessibility webAccessibility = new WebAccessibility();

// List of necessary rules for checking (rule code according to the specification)
String[] rulesCode = new String[]{"H2", "H37", "H67", "H86"};

// Get the required IList<Rule> rules from the rules reference
List<IRule> rules = webAccessibility.getRules().getRules(rulesCode);

// Create an accessibility validator, pass the found rules as parameters,
// and specify the full validation settings
AccessibilityValidator validator = webAccessibility.createValidator(
        rules, ValidationBuilder.getAll());

// Initialize an object of the HTMLDocument
final HTMLDocument document = new HTMLDocument(htmlPath);
// Check the document
ValidationResult validationResult = validator.validate(document);

// Return the result in string format
// SaveToString - return only errors and warnings
System.out.println(validationResult.saveToString());

• 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.