Estructura de la página

Mal ejemplo

Bienvenido
Contenido principal de la página...
<!-- pageStructure.badComment -->
<div class="page-header">
  <div class="site-title">pageStructure.siteTitle</div>
  <div class="navigation">
    <div>pageStructure.home</div>
    <div>pageStructure.about</div>
  </div>
</div>
<div class="page-content">
  <div class="content-title">pageStructure.welcome</div>
  <div>pageStructure.mainContent</div>
</div>
<div class="page-footer">
  pageStructure.copyright
</div>

Buen ejemplo

Bienvenido

Contenido principal de la página...

© 2025 Mi Sitio

<!-- pageStructure.goodComment -->
<header>
  <div class="site-title">pageStructure.siteTitle</div>
  <nav aria-label="pageStructure.mainNav">
    <ul>
      <li><a href="/">pageStructure.home</a></li>
      <li><a href="/about">pageStructure.about</a></li>
    </ul>
  </nav>
</header>
<main>
  <h1>pageStructure.welcome</h1>
  <p>pageStructure.mainContent</p>
</main>
<footer>
  <p>pageStructure.copyright</p>
</footer>

Explicación: Una estructura semántica clara ayuda a los lectores de pantalla a navegar y comprender el contenido. Los elementos de sección (header, nav, main, footer) crean puntos de referencia importantes.

Jerarquía de encabezados

Mal ejemplo

Introducción a la accesibilidad

La accesibilidad web es importante...

Técnicas básicas

Aquí hay algunas técnicas...

HTML Semántico

El HTML semántico...

Elementos de estructura

Elementos como header, nav...

CSS y accesibilidad

CSS puede mejorar...

<!-- headings.badComment -->
<div class="title-large">headings.intro</div>
<p>headings.content</p>
<div class="title-medium">headings.section1</div>
<p>headings.content</p>
<div class="title-medium">headings.section2</div>
<p>headings.content</p>
<div class="title-small">headings.subsection</div>
<p>headings.content</p>

Buen ejemplo

Introducción a la accesibilidad

La accesibilidad web es importante...

Técnicas básicas

Aquí hay algunas técnicas...

HTML Semántico

El HTML semántico...

Elementos de estructura

Elementos como header, nav...

CSS y accesibilidad

CSS puede mejorar...

<!-- headings.goodComment -->
<h1>headings.intro</h1>
<p>headings.content</p>
<h2>headings.basicTechniques</h2>
<p>headings.content</p>
<h3>headings.semanticHTML</h3>
<p>headings.content</p>
<h4>headings.structureElements</h4>
<p>headings.content</p>
<h3>headings.cssAccessibility</h3>
<p>headings.content</p>

Explicación: Una jerarquía lógica de encabezados (h1 → h2 → h3) permite a los lectores de pantalla crear un esquema de navegación y a los usuarios comprender la estructura del contenido.

Botones vs elementos clicables

Mal ejemplo

💾 Guardar
🗑️ Eliminar
👤 Ver perfil
ℹ️ Más información
<!-- buttonsVsLinks.badComment -->
<div @click="handleSave" style="cursor: pointer;">
  💾 buttonsVsLinks.save
</div>
<div @click="handleDelete" style="cursor: pointer;">
  🗑️ buttonsVsLinks.delete
</div>
<span @click="navigateToProfile" style="cursor: pointer;">
  👤 buttonsVsLinks.profile
</span>

Buen ejemplo

👤 Ver perfil
<!-- buttonsVsLinks.goodComment -->
<button type="button" @click="handleSave">
  💾 buttonsVsLinks.save
</button>
<button type="button" @click="handleDelete">
  🗑️ buttonsVsLinks.delete
</button>
<a href="/profile">
  👤 buttonsVsLinks.profile
</a>
<button type="button" @click="toggleModal">
  ℹ️ buttonsVsLinks.moreInfo
</button>

Explicación: Usa los elementos correctos para las acciones: botones para acciones, enlaces para navegación. Esto asegura la semántica adecuada y los comportamientos de teclado esperados.

Listas y datos estructurados

Mal ejemplo

Ingredientes para una tortilla:
3 huevos
2 cucharadas de leche
Sal y pimienta
1 cucharada de mantequilla
Pasos:
1. Batir los huevos con la leche
2. Calentar la mantequilla
3. Verter los huevos y cocinar
4. Doblar por la mitad y servir
<!-- lists.badComment -->
<div class="list-title">lists.ingredientsTitle</div>
<div>lists.eggs</div>
<div>lists.milk</div>
<div>lists.seasoning</div>

<div class="list-title">lists.stepsTitle</div>
<div>1. lists.step1</div>
<div>2. lists.step2</div>
<div>3. lists.step3</div>

Buen ejemplo

Ingredientes para una tortilla:

  • 3 huevos
  • 2 cucharadas de leche
  • Sal y pimienta
  • 1 cucharada de mantequilla

Pasos:

  1. Batir los huevos con la leche
  2. Calentar la mantequilla
  3. Verter los huevos y cocinar
  4. Doblar por la mitad y servir
<!-- lists.goodComment -->
<h3>lists.ingredientsTitle</h3>
<ul>
  <li>lists.eggs</li>
  <li>lists.milk</li>
  <li>lists.seasoning</li>
</ul>

<h3>lists.stepsTitle</h3>
<ol>
  <li>lists.step1Full</li>
  <li>lists.step2</li>
  <li>lists.step3</li>
  <li>lists.step4</li>
</ol>

Explicación: Usar elementos de lista apropiados permite a los lectores de pantalla anunciar el número de elementos y facilitar la navegación.