Glosario

a11y

Una abreviatura de accesibilidad: interpretada como la letra a seguida de 11 caracteres y luego la letra y.

Agora

Agora es el repositorio de artefactos interno de Deque. Está basado en una instancia de Artifactory. A través de Agora, los usuarios pueden descargar componentes de Axe DevTools Linter y el binario del Conector.

Clave API

Una clave API autoriza el uso del servicio de linting SaaS alojado por Deque o el linting local. Usted gestiona sus claves API a través de Configuración de la cuenta de Axe. Consulte Obtener una clave de API de SaaS de Axe DevTools Linter para más información.

ARIA

Aplicaciones Ricas en Internet Accesibles (ARIA) es una especificación técnica publicada por el World Wide Web Consortium (W3C) que define formas de aumentar la accesibilidad de las páginas web, en particular, el contenido dinámico y los componentes de la interfaz de usuario desarrollados con Ajax, HTML, JavaScript y tecnologías relacionadas.

Mejores Prácticas

Las mejores prácticas de Deque son técnicas probadas en el tiempo que proporcionan los resultados de accesibilidad deseados cuando no existen métodos formales específicos o son insuficientes. Aunque no están incluidas oficialmente en ningún conjunto de reglas de accesibilidad establecido, seguir las mejores prácticas de Deque puede mejorar la accesibilidad y la calidad general del código que escriba. Cabe destacar que no cumplir con las guías de mejores prácticas de Deque no indica automáticamente un fallo. Además, se requiere juicio experto para considerar la idoneidad en el contexto de los objetivos de la aplicación, sitio o página. A veces, la técnica de accesibilidad de mejor práctica no es aplicable o práctica para resolver un problema específico.

CI/CD

CI/CD significa integración continua y entrega continua (o despliegue continuo). Se refiere a pipelines automatizados que construyen, prueban y lanzan software. El Conector Axe DevTools Linter y la Acción de GitHub se integran en pipelines de CI/CD para detectar problemas de accesibilidad antes de que el código se fusione o implemente.

Biblioteca de Componentes

Una biblioteca de componentes es una colección de componentes de interfaz de usuario reutilizables. Axe DevTools Linter tiene soporte integrado para varias bibliotecas de componentes populares, incluidas @mui/material, @deque/cauldron-react y react-native, y puede analizar sus componentes como si fueran elementos HTML nativos. Consulte Bibliotecas de Componentes Preconfiguradas para más información.

Conector

El Conector (formalmente el Conector Axe DevTools Linter) es una herramienta de línea de comandos para Linux, macOS y Windows que proporciona una interfaz de línea de comandos para analizar sus archivos. Puede utilizarse para scripting y en pipelines de CI/CD. Consulte Usar Axe DevTools Linter Connector para más información.

Componente Personalizado

Un componente personalizado es un componente de interfaz de usuario que define o importa de una biblioteca de terceros que no corresponde directamente a un elemento HTML nativo. Axe DevTools Linter puede analizar componentes personalizados al asignarlos a elementos HTML nativos en su configuración, lo que le permite aplicar reglas estándar de accesibilidad a sus componentes. Consulte Analizar Componentes Personalizados para más información.

Directiva en Línea

Una directiva en línea es un comentario especialmente formateado añadido directamente al código fuente que suprime una o más reglas de Axe DevTools Linter para una línea específica, un rango de líneas o el resto de un archivo. Las directivas en línea le permiten reconocer violaciones conocidas sin modificar su configuración global. Consulte Suprimir Reglas de Linting con Directivas en Línea para más información.

Clave de Licencia

Una clave de licencia es una alternativa a una clave API para autenticar linting local con el Conector. A diferencia de una clave API, una clave de licencia no requiere autenticación remota y no reporta información de uso. Debe solicitar una clave de licencia a Mesa de Ayuda de Deque. El uso de una clave de licencia requiere la opción --local del Conector.

Linter

Un linter es una herramienta que analiza automáticamente el código fuente para encontrar problemas, incluidos errores de sintaxis, inconsistencias estilísticas y posibles errores, sin ejecutar el código. Axe DevTools Linter es un linter de accesibilidad: encuentra patrones en el código fuente que probablemente causen problemas de accesibilidad. Vea Acerca de Axe DevTools Linter.

Análisis de código

Análisis de código es el proceso automatizado de usar un analizador para analizar el código fuente en busca de problemas. Axe DevTools Linter realiza un análisis de accesibilidad: verifica tus archivos fuente según las reglas de accesibilidad de Deque e informa cualquier patrón que pueda causar barreras de accesibilidad. Consulta Acerca del Analizador de Axe DevTools.

Análisis Local

Análisis Local es una opción para el Conector que realiza un análisis de accesibilidad en la máquina que ejecuta el Conector, en lugar de enviar tus archivos a un servidor. El análisis local es más rápido y evita dependencias de red. Requiere una clave de API o una clave de licencia. Consulta Análisis Local para más información.

En las Instalaciones del Cliente

En las instalaciones del cliente (también en premisa) se refiere a ejecutar el servidor de Axe DevTools Linter dentro de tu propia infraestructura, en lugar de usar el servidor SaaS alojado en la nube de Deque. Una instalación en las instalaciones del cliente te da control total sobre el servidor y mantiene el contenido de los archivos dentro de tu red. Consulta Instalación y Seguridad para más información.

Regla

Una regla es una verificación de accesibilidad individual que aplica Axe DevTools Linter a tus archivos fuente. Cada regla corresponde a uno o más criterios de directrices de accesibilidad y está identificada por un ID de regla único (por ejemplo, image-alt o label). Las reglas pueden activarse, desactivarse o configurarse para reportar advertencias mediante tu configuración. Consulta Reglas de Accesibilidad para la lista completa de reglas.

SaaS

SaaS (Software como Servicio) se refiere al servidor Axe DevTools Linter alojado en la nube de Deque. Cuando usas el servidor SaaS, tus archivos se envían al servidor de Deque para su análisis. Usar SaaS requiere una clave de API. Consulta Obtener una Clave API SaaS de Axe DevTools Linter para más información.

Sección 508

Una enmienda a la Ley de Rehabilitación de los Estados Unidos de 1973 que requiere que las agencias federales hagan que su tecnología electrónica e informativa sea accesible para las personas con discapacidades. Comprende dieciséis disposiciones basadas en las directrices de acceso desarrolladas por las Directrices de Accesibilidad de Contenidos Web (WCAG) desarrolladas por el World Wide Web Consortium (W3C), pero no son idénticas a los estándares WCAG 1.0 o 2.0.

Análisis Estático

Análisis Estático es el examen del código fuente sin ejecutarlo. Axe DevTools Linter utiliza el análisis estático para detectar problemas de accesibilidad al principio del desarrollo, antes de que el código se compile, se fusione o se implemente. Debido a que el análisis estático no ejecuta tu aplicación, no puede detectar todos los problemas de accesibilidad; algunos problemas requieren pruebas manuales o basadas en navegadores.

Etiqueta

Una etiqueta es una etiqueta que agrupa reglas juntas basándose en el estándar de accesibilidad al que corresponden (por ejemplo, wcag2a o best-practice). Puedes usar etiquetas en tu configuración para habilitar o deshabilitar un grupo completo de reglas a la vez. Consulta Etiquetas para la lista completa de etiquetas compatibles.

Violación

Una violación es un problema de accesibilidad que Axe DevTools Linter detectó en tu código fuente, específicamente, un patrón que no se conforma a una o más de las reglas que verifica Axe DevTools Linter. Las violaciones se reportan con el ID de regla, una descripción y la ubicación del archivo.

WCAG

Las WCAG, o Directrices de Accesibilidad de Contenidos Web, fueron desarrolladas por el World Wide Web Consortium (W3C) y explican cómo hacer que el contenido web sea más accesible para las personas con discapacidades. WCAG 1.0 fue publicado en mayo de 1999. WCAG 2.0 se publicó en diciembre de 2008. WCAG 2.1 se publicó en junio de 2018. WCAG 2.2, la iteración más reciente de las directrices, se publicó en 2023 y ofrece nueve nuevos criterios de éxito sobre WCAG 2.1.