Uso de reglas personalizadas

Descripción general de las reglas personalizadas en la extensión axe Expert

Cuando desee que la herramienta axe Expert analice páginas web y aplicaciones en función de reglas específicas para las necesidades únicas de su organización, puede hacerlo con la funcionalidad Reglas personalizadas en el Rules panel. Al hacer clic en el elemento de enlace Reglas en el menú principal de axe Expert (menú desplegable cerca del logotipo de la extensión axe Expert en la parte superior del panel izquierdo), aparece Rules un panel que ofrece un botón Agregar conjunto de reglas personalizado para mostrar un formulario en el panel derecho para enviar un conjunto de reglas personalizadas. El formulario simple consta de dos campos de entrada de texto y un botón de acción que le permiten configurar reglas personalizadas que pueden seleccionarse para ejecutarse en el motor automatizado cuando se analiza una página cargada en el panel Analizar.

Al igual que al analizar una página con los conjuntos de reglas de axe Expert, los resultados mostrarán cualquier violación de sus reglas personalizadas que se encuentre, junto con la información que especificó en el conjunto de reglas personalizado (destino, código fuente HTML, resumen de corrección, enlace de ayuda Más información, etc.). Todas las demás opciones de acción disponibles con las reglas estándar también se aplican a las violaciones de reglas personalizadas (Inspeccionar, Resaltar, Exportar, Cargar, etc.). Hay un límite de cinco conjuntos de reglas personalizados que se permiten al mismo tiempo.

1. Agregar un botón de conjunto de reglas: en la sección Custom rulesets del panel izquierdo del panel Rules , un comando +Add a ruleset le presenta un formulario en el panel derecho para enviar un conjunto personalizado de reglas.
2. Nombre para reglas personalizadas(solo alfanumérico): este será el nombre del conjunto de reglas que aparecerá en la sección Estándares de la pestaña Configuración. Es importante seguir las convenciones (alfanumérico, sin espacios) y garantizar que el nombre sea significativo y fácilmente reconocible como una opción de selección.
3. Introducir JSON rules.textareaInstructions_: La notación de objetos JavaScript (JSON) es el estándar basado en texto al que debe ajustarse el contenido para funcionar con la extensión del navegador HTML 2.0 de Firefox. _ Para obtener más información, consulte abajo el Ejemplo .
4. Botón GUARDAR Y UTILIZAR CONJUNTO DE REGLAS: hace que las reglas personalizadas se conviertan en una opción seleccionable en el menú del panel de la barra lateral izquierda del panel. Rules Para obtener más información, consulte Seleccionar un conjunto de reglas.

Ejemplo de regla personalizada

El código de muestra que sigue puede servir como un ejemplo práctico de un archivo JSON de regla personalizada de ax Expert con el formato correcto.

{
  "checks": [
    {
      "id": "test",
      "options": ["test"],
      "evaluate": "function() { return false; }",
      "metadata": {
        "impact": "minor",
        "messages": {
          "pass": "how did you pass",
          "fail": "there is no way to pass"
        }
      }
    }
  ],
  "rules": [
    {
      "id": "test",
      "metadata": {
        "description": "Will always fail",
        "help": "There is no way to make this pass! It is for testing",
        "helpUrl": "https://foo.com/bar"
      },
      "selector": "html",
      "any": [],
      "all": ["test"],
      "none": [],
      "tags": ["wcag2aa"]
    }
  ]
}

Conjuntos de reglas personalizados de proyectos de axe Monitor: después de iniciar sesión en axe Monitor y seleccionar un proyecto, todos los conjuntos de reglas personalizados asociados con ese proyecto se cargan automáticamente en el Rules panel y quedan disponibles para su selección.

Enviar reglas personalizadas

Cuando desee enviar reglas personalizadas para uso futuro en la extensión axe Expert, siga estos sencillos pasos. El envío de reglas personalizadas se realiza especificando un nombre para el conjunto de reglas para fines de selección futura y pegando el contenido del archivo de texto JSON con el formato correcto en los campos de entrada de texto; luego, haciendo clic en un botón para guardar y usar las reglas.

Para enviar reglas personalizadas:

1. Abra DevTools y seleccione axe Expert. Seleccione Reglas en el menú principal de axe Expert.

2. En el panel izquierdo, seleccione + Agregar un conjunto de reglas en la sección Conjuntos de reglas personalizados del menú. El formulario Ruleset se muestra en el panel derecho.

3. En el campo Nombre de reglas personalizadas, ingrese el nombre alfanumérico deseado sin espacios.

   Esto aparecerá en la sección Custom Rulesets del panel izquierdo del Rules panel, por lo que el nombre debe ser significativo y fácilmente reconocible para su selección.

4. En el campo Ingresar JSON, pegue el contenido de su archivo de texto .json de reglas personalizadas desde el portapapeles virtual. Agarre y arrastre la esquina inferior derecha del campo para aumentar el área visible, si lo desea.

5. Seleccione SAVE AND USE RULESET.

   

   El nombre ingresado aparece en la sección Conjuntos de reglas personalizados en el panel izquierdo y aparece en la parte superior del panel derecho, en el campo Conjunto de reglas:. Además, los botones para eliminar o usar el conjunto de reglas aparecen en la parte inferior del formulario, en el panel derecho.

   En el panel derecho, Seleccione Analyze now.

   El 'Éxito! ¡Datos de regla guardados.' Mensaje que aparece en la parte superior derecha de las herramientas para desarrolladores

   El nombre del conjunto de reglas personalizado aparece en el menú Reglas de la barra lateral izquierda precedido por una marca de verificación para indicar que es el conjunto de reglas seleccionado actualmente que se utilizará al realizar el análisis.

Analizar una página para detectar infracciones de las reglas de accesibilidad

Para iniciar un análisis de accesibilidad en la extensión axe Expert, navegue hasta el panel Analizar y haga clic en el botón Analizar. El proceso de análisis produce un mensaje que indica el número total de violaciones de las reglas de accesibilidad encontradas en la página, así como una sección de resultados que muestra las violaciones identificadas de las reglas y el número total de violaciones identificadas. Al activar una fila en el panel de resultados izquierdo, se muestran detalles en el panel de contenido principal a la derecha. Esta acción también inicializa los botones de flecha Anterior y Siguiente de violación para que aparezcan en la parte superior del panel de contenido, lo que le permite navegar de una violación a la siguiente para cualquier regla seleccionada.

Analizar una página para detectar infracciones de las reglas:

1. Con la pestaña Experto de axe seleccionada, seleccione Analizar en el menú principal en el panel izquierdo a la derecha del logotipo de la extensión Experto de axe. Aparece el panel Analizar.

2. En el panel de contenido, se debe activar ANALYZE. Dependiendo de cómo hayas acoplado las herramientas para desarrolladores o hayas redimensionado la ventana de tu navegador, esto suele estar en el centro del panel izquierdo del panel Analizar.

   El panel Analizar puede mostrar temporalmente un mensaje de estado que diga Analyzing...please wait contenido faltante hasta que se complete el análisis de la página contra el conjunto de reglas seleccionado.

   Debajo del logotipo de Axe Expert Extension, se muestra el número total de violaciones encontradas, junto con el número de problemas que requieren revisión manual. Además, aparece un menú contextual desplegable y Run again un enlace a la derecha de los recuentos totales. Una tabla de dos columnas que muestra el nombre corto de cada regla, con la columna de la derecha mostrando la cantidad de violaciones encontradas de cada una, se muestra en el menú contextual desplegable de mostrar.

   

3. En la sección rules violated (panel izquierdo), haz clic en una rule fila.

   

   El panel de contenido de la derecha se actualiza para mostrar la primera violación de esa regla. En la pantalla de contenido se incluyen enlaces Target y HTML, las secciones de información Summary (How to Fix the Problem) , Inspect y Highlight , un menú contextual (que incluye opciones para Export, Scope, Upload y Download) y, en la parte inferior derecha, un botón de flecha expansible a la izquierda para mostrar los Estándares (conjuntos de reglas) aplicables para la regla seleccionada. Para obtener información más detallada sobre cada componente que se muestra en el panel de contenido de violación de reglas, consulte las descripciones en la descripción general proporcionada en el tema Analizar . Los botones de navegación entre violaciones anterior < y siguiente > aparecen en la parte superior del panel, lo que le permite navegar entre las violaciones de la regla seleccionada. Además, el HTML relevante que contiene la infracción se resalta automáticamente en la página probada.

4. Haga clic en Siguiente (>) para navegar a la siguiente infracción de la norma seleccionada actualmente, o seleccione una norma diferente del panel de resultados de normas infringidas de la izquierda, según lo desee.

   

Eliminar un conjunto de reglas personalizado

Elimine un conjunto de reglas personalizadas del Rules panel cuando ya no necesite un conjunto de reglas personalizadas. Seleccione la regla que desea eliminar en el panel Rules y haga clic en un botón para eliminar.

Si desea reutilizar parte del contenido en un futuro conjunto de reglas personalizadas, es posible que desee asegurarse de guardar el contenido del archivo JSON antes de eliminarlo, ya que este procedimiento da como resultado una eliminación permanente e irreversible.

Para eliminar un conjunto de normas personalizado:

1. En la parte inferior de la lista de opciones de la sección Custom rulesets del panel izquierdo Rules , asegúrese de que el conjunto que desea eliminar esté marcado (seleccionado).
2. Haz clic DELETE RULESET.

El conjunto se elimina del menú del panel izquierdo y ya no está disponible para su selección.