Corregir los roles ARIA list y listitem del Loop Grid de Elementor Pro

Dificultad: Fácil

Si usas el widget Loop Grid de Elementor Pro para mostrar entradas, proyectos o productos, el contenedor del listado incluye role="list" y el contenedor de cada elemento incluye role="listitem". El problema es que entre uno y otro hay un div de la plantilla del bucle sin ningún rol, así que el elemento de lista no es hijo directo de la lista. Los validadores de accesibilidad pueden señalar esa estructura como incorrecta. Este snippet elimina esos dos roles solo en el Loop Grid. Lo he comprobado en Elementor Pro 4.4.

Puedes utilizar este sencillo snippet en php desde el archivo functions.php.

Importante: no modifiques directamente el archivo functions.php del tema que tengas instalado. Genera un tema hijo con alguno de los plugins del repositorio de WordPress y actívalo. Cuando lo tengas, entra en el functions.php del tema hijo. Una alternativa es instalar algún plugin que permite incrustar código sin problema de pérdida en la actualización del tema.


/**
 * Quitar los roles ARIA list y listitem del Loop Grid de Elementor Pro
 */
add_filter( 'elementor/widget/render_content', 'lc_loop_grid_quitar_roles', 10, 2 );
function lc_loop_grid_quitar_roles( $content, $widget ) {
    if ( 'loop-grid' !== $widget->get_name() ) {
        return $content;
    }
    return str_replace( array( ' role="list"', ' role="listitem"' ), '', $content );
}

Solo afecta al Loop Grid: El filtro elementor/widget/render_content se ejecuta con el HTML de cada widget, y la función solo actúa cuando el widget es loop-grid. El resto de widgets de Elementor se quedan como están.

Qué se pierde: Al quitar los roles, los lectores de pantalla dejan de anunciar el listado como una lista de elementos. Si cada elemento es una tarjeta independiente, suele ser un cambio aceptable, pero valóralo según tu contenido.

Compatibilidad: Está pensado para el Loop Grid de Elementor Pro. Si usas otros widgets de bucle, como el Loop Carousel, comprueba antes su marcado y añade su nombre a la condición solo si lleva los mismos roles.

Cómo comprobarlo: Vacía la caché de tu web, abre el código fuente de una página con un Loop Grid y busca role="list": ya no debería aparecer. Después puedes pasar de nuevo Lighthouse o una extensión como axe para confirmar que el aviso ha desaparecido.

Si trabajas con Elementor y WooCommerce, mira también cómo reparar el fallo de scroll suave en las pestañas y valoraciones de WooCommerce.

¿Necesitas esto en tu web?

Desarrollo funciones a medida e integraciones para WordPress y tiendas WooCommerce, y reviso con una auditoría las tiendas que van lentas o dan errores. Cuéntame tu caso.