La configuración de la axe DevTools Browser Extension permite controlar funciones como versiones de axe-core, estándares de prueba, conjuntos de reglas, recopilación de datos de uso, aprendizaje automático, mejores prácticas y más. Sin embargo, para la mayoría de los usuarios, la configuración predeterminada de la extensión axe DevTools funcionará perfectamente bien. Esta página explica cómo configurar la extensión axe DevTools para que funcione dentro de su organización.
¿Tiene un servidor de DevTools en nube privada? Obtenga más información sobre cómo configurar la extensión axe DevTools para la nube privada.
¿Quiere controlar cualquiera de estas configuraciones en toda su organización e incluso en varios productos Deque? ¡Echa un vistazo a Configuración de axe!
Configuración a través de la página de ajustes de extensión
Los usuarios pueden acceder a la página de configuración de la extensión haciendo clic en el elemento de menú "Opciones" (icono de tres puntos) en la barra de menú superior y haciendo clic en el elemento de menú "Configuración".
Configuraciones disponibles
Para garantizar que los usuarios Pro experimenten resultados consistentes, axe DevTools recordará sus configuraciones incluso después de que su sesión haya expirado.
Apariencia
Nombre de la configuración | Descripción | Valores |
---|---|---|
Idioma | El idioma que se utilizará en el texto de la extensión. | Usar el navegador predeterminado (predeterminado)InglésFrancésJaponés |
Destacar tema | El tema de resaltado que se utilizará cuando se resalten los elementos. | Alto contraste (predeterminado)Devtools |
Tema de extensión | El tema de color para la interfaz de usuario de la extensión. | Sigue la configuración de mi navegadorOscuroClaro |
Reglas y problemas
Nombre de la configuración | Descripción | Valores |
---|---|---|
Prácticas recomendadas | Determina si las reglas de mejores prácticas están habilitadas. Esto actúa como un filtro, lo que significa que se puede activar/desactivar sin tener que volver a ejecutar pruebas para ver los problemas de mejores prácticas aplicables encontrados. | HabilitarDesactivar (predeterminado) |
Seleccionar estándar de accesibilidad | El estándar de accesibilidad por el cual filtrar todos los problemas. Tenga en cuenta que Trusted Tester v5 solo es compatible con las versiones 4.7.1 y superiores de axe-core y que los problemas de IGT actualmente no están etiquetados con etiquetas TTv5. | TodoWCAG 2.2 AAAWCAG 2.2 AAWCAG 2.2 AWCAG 2.1 AAAWCAG 2.1 AAWCAG 2.1 AWCAG 2.0 AAAWCAG 2.0 AAWCAG 2.0 ATrusted Tester v5 |
Reglas experimentales (solo plan Pro) | Determina si las reglas experimentales están habilitadas. Estas reglas no se ejecutan cuando las reglas experimentales están deshabilitadas, lo que significa que las pruebas deben volver a ejecutarse para ver cualquier problema aplicable de las reglas experimentales. | HabilitarDesactivar (predeterminado) |
Seleccione la versión de Axe-Core (solo plan Pro) | La versión de axe-core que se utilizará en escaneos y Pruebas Guiadas Inteligentes. | la últimaAdemás de las siguientes versiones:Todas las versiones de parche de axe-core donde la versión menor inicial fue hace menos de 6 mesesLas 3 versiones de parches anteriores de axe-core siempre se incluirán fuera de la política mencionada anteriormente.Todas las versiones menores de axe-core donde la versión menor inicial fue hace menos de 15 meses |
(Solo plan Pro) Opciones que necesitan revisión | Configura cómo se tratan los elementos que necesitan revisión. | Habilitar los problemas que necesitan revisión e incluirlos en el total de problemas automáticosHabilitar la revisión de problemas que necesitan revisión, pero excluir del total de problemas automáticos totalesDeshabilitar la necesidad de revisión por completo |
Comportamiento de la herramienta Contraste de color (solo plan Pro) | Cómo se ejecuta la herramienta de contraste de color (que determina automáticamente si los elementos de contraste de color que "necesitan revisión" son problemas o no), si es que se ejecuta. Para que la herramienta Contraste de color pueda ejecutarse, debe estar habilitada la opción "Opciones de Necesita Revisión". |
Ciertas configuraciones como "Seleccionar estándar de accesibilidad" y "Seleccionar versión de axe-core" indicarán de dónde provienen valores predeterminados específicos:
- "(Org Default)": el valor predeterminado configurado de la organización empresarial para la configuración dada (establecido por el administrador en Configuración de axe)
- "(Valor predeterminado del usuario)": el valor predeterminado configurado por el usuario actual para la configuración dada (establecido por el usuario en Configuración de axe)
- "(axe Default)": el valor predeterminado de la extensión de axe para la configuración dada
La revisión de necesidades, las mejores prácticas y el nivel WCAG funcionan como filtros. Esto significa que si cambia alguna de estas configuraciones, todos los datos y problemas de pruebas anteriores se actualizarán en consecuencia sin tener que volver a ejecutar ninguna de las pruebas.
Export Settings (Pro plan only)
Nombre de la configuración | Descripción | Valores |
---|---|---|
Esquema de exportación | El esquema de exportación de problemas en CSV. | axe DevTools Pro (predeterminado)axe DevTools Reporter |
Advanced Settings (Pro plan only)
Nombre de la configuración | Descripción | Valores |
---|---|---|
Habilitar capturas de pantalla de problemas compartidos | Permite agregar capturas de pantalla a los problemas compartidos. | Habilitar (predeterminado)Desactivar |
Habilitar el aprendizaje automático | Algunas HGP utilizan aprendizaje automático (ML) para optimizar las pruebas. Esto tomará capturas de pantalla y las enviará a nuestros servidores ML para ser procesadas. | Habilitar (predeterminado)Desactivar |
Configuración del servidor
Nombre de la configuración | Descripción | Valores |
---|---|---|
Usar configuración predeterminada (servidor) | Usa la configuración de servidor predeterminada para la URL del servidor axe y los datos de uso (ver a continuación). | activado / marcado (predeterminado)Desactivado / sin marcar |
URL del servidor axe | La URL para el servidor axe DevTools (Portal de cuentas de axe). Solo es necesario cambiarlo si está utilizando un servidor privado en la nube de Deque o su propia instancia de alojamiento. | https://axe.deque.com (predeterminado) |
Enviar datos de uso | Datos analíticos sobre su uso de la aplicación además de los resultados de sus pruebas. | activado / marcado (predeterminado)Desactivado / sin marcar |
URL del Servicio de Uso | La URL del servidor donde se envían los datos de uso. | https://usage.deque.com (predeterminado) |
Organización de Uso del Servicio | El nombre de su organización que se agregará como metadatos a sus análisis de uso. Si está utilizando el servicio de uso de Deque, consulte la sección a continuación. | ninguno (predeterminado) |
Departamento de Uso del Servicio | El nombre de su departamento que se agregará como metadatos a sus análisis de uso. Si está utilizando el servicio de uso de Deque, consulte la sección a continuación. | ninguno (por defecto) |
Aplicación del servicio de seguimiento de uso | El nombre de su aplicación que se agregará como metadatos a sus análisis de uso. Si está utilizando el servicio de uso de Deque, consulte la sección a continuación. | ninguno (predeterminado) |
Offline Mode (Enterprise feature)
Nombre de la configuración | Descripción | Valores |
---|---|---|
Habilitar el modo sin conexión | Si habilitar o no la función Modo sin conexión. | Sin marcar (predeterminado)marcado |
Clave de licencia sin conexión | Dónde ingresar la clave de licencia para la suscripción empresarial del modo sin conexión. |
Uso de Organización/Departamento/Aplicación
Si está utilizando el servicio de informes de uso de Deque, utilice lo siguiente:
- Organización del Usage Service: Obtenga un identificador para su organización de su contacto de Deque (gerente de proyecto/representante de ventas)
- Departamento del Usage Service: decida valores únicos que representarán a los diferentes equipos/productos que desea rastrear con el servicio de uso. Estos valores deben ser utilizados como valores de 'Departamento' por varios grupos.
- Aplicación del Usage Service: de manera similar al Departamento mencionado anteriormente, puede usar la configuración de Aplicación para obtener una representación de datos más granular. Esta configuración le permite adjuntar otro atributo a sus datos de uso.
Configuración mediante política de extensión
Chrome y Edge ofrecen formas en las que los administradores pueden configurar los entornos de sus usuarios, controlando con precisión las opciones de extensiones instaladas y configuradas. Para cada ajuste establecido mediante la política, esta configuración se aplicará automáticamente y se "bloqueará" (se deshabilitará y no se podrá cambiar) para todos sus usuarios. Para cualquier configuración no establecida por política, sus usuarios podrán cambiar libremente los valores.
Debido a la naturaleza "sin conexión" de la función [Modo sin conexión], no es posible extraer la configuración de axe. Por lo tanto, la única forma de controlar la configuración de los usuarios del modo sin conexión en toda la organización es mediante la política de extensión (descrita a continuación).(devtools-offline)
Se recomienda utilizar axe Configuration en lugar de la configuración de políticas, ya que ofrece más flexibilidad y requiere menos mantenimiento.
Si las configuraciones se establecen tanto en axe Configuration como en la política, el valor de [axe Configuration] se usará en favor del valor de la política.
Si descarga la extensión axe DevTools para Microsoft Edge desde Google Chrome Store, utilizará el ID de extensión de Chrome (lhdoppojpmngadmnindnejefpokejbdd). (Es posible descargar extensiones de Chrome para usar con Microsoft Edge). De lo contrario, si descarga la extensión de la tienda Microsoft Edge, el ID de la extensión es kcenlimkmjjkdfcaleembgmldmnnlfkn , como se muestra en la siguiente clave de registro de Windows.
Configuración de políticas de macOS
Cree un archivo configuration.plist con la configuración de política deseada (consulte la tabla a continuación para ver el desglose de las propiedades específicas admitidas):
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>com.google.Chrome.extensions.lhdoppojpmngadmnindnejefpokejbdd</key>
<dict>
<key>AxeURL</key>
<dict>
<key>state</key>
<string>always</string>
<key>value</key>
<string>https://axe.biz</string>
</dict>
<key>UsageServiceURL</key>
<dict>
<key>state</key>
<string>always</string>
<key>value</key>
<string>https://usage.biz</string>
</dict>
<key>DataGather</key>
<dict>
<key>state</key>
<string>always</string>
<key>value</key>
<true />
</dict>
</dict>
</dict>
</plist>
Luego cargue el archivo plist ejecutando el siguiente comando:
dscl -u YOUR_OS_ADMIN_USERNAME /Local/Default -mcximport /Computers/local_computer ./configuration.plist
Si el dscl
comando anterior arroja un error que indica que la ruta no es válida, puede crear un nodo para la máquina local con los siguientes comandos:
$ GUID=\`uuidgen\`
$ ETHER=ifconfig en0 | awk '/ether/ {print $2}'
$ dscl -u admin_username /Local/Default -create /Computers/local_computer
$ dscl -u admin_username /Local/Default -create /Computers/local_computer RealName "Local Computer"
$ dscl -u admin_username /Local/Default -create /Computers/local_computer GeneratedUID $GUID
$ dscl -u admin_username /Local/Default -create /Computers/local_computer ENetAddress $ETHER
Por último, propague los cambios ejecutando el siguiente comando:
sudo mcxrefresh -n YOUR_OS_ADMIN_USERNAME
Configuración de políticas de Windows
En Windows, las políticas se implementan mediante la creación de una entrada de registro.
A continuación se muestra un ejemplo de cómo debería verse la entrada de registro:
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome\3rdparty\extensions\lhdoppojpmngadmnindnejefpokejbdd\policy]
"PROPERTY_NAME"="PROPERTY_VALUE"
Donde PROPERTY_NAME
es una de las siguientes propiedades y PROPERTY_VALUE
es cualquier valor válido para la propiedad (según la columna "Tipo" a continuación).
Si es necesario declarar varias propiedades, deben separarse mediante una nueva línea.
Ejemplo completo con múltiples propiedades declaradas
[HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome\3rdparty\extensions\lhdoppojpmngadmnindnejefpokejbdd\policy]
"DataGather"="1"
"UsageServiceURL"=https://usage.deque.com"
"EnableAutomaticColorContrast"="1"
"WCAGLevel"="wcag21aa"
"IncludedNeedsReviewInIssueCount"="1"
"AutomaticColorContrastReview"="Manual"
Configuraciones disponibles a través de políticas
Nombre de la propiedad | Configuración asociada de axe DevTools | Tipo |
---|---|---|
AxeURL |
URL del servidor axe | Texto |
DataGather |
Enviar datos de uso | Booleano (en el registro de Windows establecido como texto - "1" para true , "0" para false ) |
UsageServiceURL |
URL del Servicio de Uso | Texto |
UsageServiceOrganization |
Organización de Uso del Servicio | Texto |
UsageServiceDepartment |
Departamento de Uso del Servicio | Texto |
UsageServiceApplication |
Aplicación del servicio de seguimiento de uso | Texto |
EnableIssueScreenshots |
Capturas de pantalla de problemas compartidos | Booleano (en el registro de Windows establecido como texto - "1" para true , "0" para false ) |
EnableMachineLearning |
Aprendizaje automático | Booleano (en el registro de Windows establecido como texto - "1" para true , "0" para false ) |
EnableAutomaticColorContrast |
Comportamiento de la herramienta Contraste de color | Booleano (en el registro de Windows establecido como texto - "1" para true , "0" para false ) |
DisableAllScreenshots |
Esta es una configuración solo de política (no disponible en la página de configuración) que deshabilita todas las funciones que toman capturas de pantalla persistentes. | Booleano (en el registro de Windows establecido como texto - "1" para true , "0" para false ) |
WCAGLevel (obsoleto, utilice AccessibilityStandard en su lugar) |
Seleccione el nivel WCAG (consulte AccessibilityStandard los valores permitidos) |
Texto |
AccessibilityStandard |
Seleccione Estándar de accesibilidad. Los valores disponibles son: wcag22aaa wcag22aa wcag22a wcag21aaa wcag21aa wcag21a wcag2aaa wcag2aa wcag2a TTv5 |
Texto |
AxeVersion |
Seleccione la versión de axe-core (consulte la tabla anterior para ver los valores permitidos) | Texto |
DisableIGT |
Esta es una configuración solo de política (no disponible en la página de configuración) que deshabilita/oculta todos los [translation of IGTs]. | Booleano (en el registro de Windows establecido como texto - "1" para true , "0" para false ) |
IncludeNeedsReviewInIssueCount |
Incluir problemas que necesitan revisión en los problemas automáticos | Booleano (en el registro de Windows establecido como texto - "1" para true , "0" para false ) |
AutomaticColorContrastReview |
Comportamiento de la herramienta Contraste de color | Texto (se puede configurar como "automático", que es equivalente a "Ejecutar automáticamente después de cada escaneo" o "manual", que es equivalente a "Elegir cuándo ejecutar (recomendado)"). |
DisableNeedsReview |
Opciones que necesitan revisión | Booleano (en el registro de Windows establecido como texto - "1" para true , "0" para false ) |
OfflineLicenseKey |
Habilitar modo sin conexión / Clave de licencia sin conexión | Texto |
Recursos adicionales
Para obtener más información sobre cómo aprovechar las políticas para configurar las máquinas y extensiones de sus usuarios, consulte la documentación respectiva de Windows, Firefox y Chrome vinculada a continuación.
-
Windows: para distribuir estos cambios a sus usuarios, consulte Distribución de cambios del Registro documentado por Microsoft
-
Chrome: Configuración de aplicaciones y extensiones por política
-
Firefox: Manifiestos nativos - Manifiesto