Una página de horarios muestra actividades de varias zonas. Al filtrar, JavaScript necesita saber la zona de cada tarjeta aunque cambie su nombre visible. Los atributos data en HTML permiten almacenar esta referencia junto al elemento que la usa.
Del atributo a dataset
Un atributo data-zona se lee como element.dataset.zona. Data-id-sede usa dataset.idSede. Todos los valores llegan como texto. Convierte los datos a número de forma explícita cuando vayas a calcular con ellos.
Ejemplo para probar
Copia el archivo completo como index.html y ábrelo en tu navegador.
<!doctype html>
<html lang="es">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Práctica de HTML</title>
<style>
body { font: 1rem/1.6 system-ui, sans-serif; margin: 2rem auto; padding-inline: 1rem; max-width: 48rem; }
img { max-width: 100%; height: auto; }
input, button { font: inherit; }
</style>
</head>
<body>
<button id="filtrar" type="button">Ver solo actividades del centro</button>
<div id="agenda">
<article data-zona="centro"><h2>Taller de cerámica</h2></article>
<article data-zona="norte"><h2>Ruta en bicicleta</h2></article>
</div>
<script>
const filtro = document.querySelector('#filtrar');
const actividades = document.querySelectorAll('#agenda [data-zona]');
filtro.addEventListener('click', () => {
actividades.forEach((actividad) => {
actividad.hidden = actividad.dataset.zona !== 'centro';
});
});
</script>
</body>
</html>Pega el fragmento en el body de una página y añade una tercera actividad. Puedes cambiar su zona sin tocar el script. El selector busca solo tarjetas de la agenda, así que otra sección con data-zona conserva su comportamiento.
Cómo comprobar el resultado
Abre la página y pulsa el botón. Verifica que se conserva la actividad del centro y que las demás quedan ocultas. Inspecciona una tarjeta y cambia su zona para comprobar de dónde lee el filtro.
Un error que conviene evitar
Los atributos data son visibles en el navegador. Úsalos para detalles de interfaz. Para identificar a una persona o decidir si una operación está permitida, realiza las comprobaciones correspondientes en el servidor.
Cómo adaptar el ejemplo a tu página
Si el contenido se añade después de ejecutar querySelectorAll, vuelve a consultar los elementos al aplicar el filtro. Si los valores crecen hasta parecer un catálogo completo, guarda los datos de la aplicación en una estructura aparte.
Diseña un vocabulario estable para las tarjetas
Imagina que el filtro tiene que reconocer las opciones centro, norte y sur. Define esos valores de forma coherente y usa los mismos al construir los controles. La etiqueta visible puede decir «Zona Centro» y conservar centro como referencia interna.
Esto ayuda cuando la persona que edita la página cambia el nombre comercial de una zona o cuando se traduce la interfaz. Antes de añadir más información a cada elemento, verifica qué decisiones necesita tomar el código.
La tarjeta debería llevar los datos que usa en esa interfaz.
Interpreta cadenas vacías y datos ausentes
Si el atributo existe sin un valor explícito, dataset puede devolver una cadena vacía. Cuando el atributo falta, la propiedad devuelve undefined. Distingue si ambos casos representan lo mismo en tu filtro. Si una tarjeta no tiene zona, decide si se conserva visible, se agrupa como pendiente o se excluye.
Dale a ese caso una prueba concreta. Con números, recuerda que convertir una cadena vacía puede dar cero. Valida que el campo esté presente antes de usarlo como cantidad.
Amplía el ejemplo con un segundo estado
Añade un botón para mostrar todas las actividades y haz que vuelva a poner hidden en false. Prueba primero el filtro del centro, luego restablece la lista y vuelve a aplicar el filtro. Si añades un selector, define un valor común para representar todas las zonas.
También puedes actualizar un contador visible con el número de resultados. Si no queda ninguna actividad, muestra un mensaje con una acción clara para limpiar el filtro. Esto es particularmente útil cuando varios filtros se combinan.
Usa selectores que no afecten otras secciones
La consulta del ejemplo se limita al elemento agenda. Si la página tiene dos calendarios, cada contenedor puede tener sus controles y sus tarjetas. Obtén las tarjetas dentro de ese contenedor en vez de buscarlas en todo el documento.
Para datos que llegan de un servidor, compara las cadenas directamente en el código cuando no necesites construir selectores. Si construyes un selector a partir de texto variable, comprueba el escape correspondiente. Así evitas que caracteres inesperados provoquen una consulta inválida.
Revisa la interfaz después de cambiar los datos
Añade una tarjeta nueva al DOM y pulsa el filtro. Si la colección se leyó al cargar la página, esa tarjeta puede quedar fuera de la actualización. Una consulta dentro del manejador soluciona este caso en listas pequeñas.
En listas grandes puedes mantener la selección de elementos junto al estado de la interfaz cuando se añadan o eliminen registros. Haz también una prueba con una tarjeta oculta y un enlace interno. Comprueba que el recorrido de teclado se mantenga en los resultados visibles.
Usa data como referencia y el texto como interfaz
Si la zona de cada actividad ayuda a decidir, muéstrala como texto en la tarjeta, aunque también exista en data-zona. Quien lee la página puede reconocer la zona sin activar el filtro. Una clase CSS puede colorear una etiqueta, pero añade un nombre legible para que la información siga disponible si el color cambia.
Comprueba qué ocurre con una actividad que aparece en dos zonas. Decide si debe duplicarse o si el modelo necesita una lista de valores. Revisa la estructura al añadir ese requisito para evitar comparaciones por coincidencia parcial que muestren tarjetas equivocadas.
Sigue practicando con Qué es el DOM en JavaScript y cómo manipularlo.




