Files
roi-theme/wp-content/themes/apus-theme/assets/js/header.js
FrankZamora d36bc0f725 Implementar Issues #17, #18, #30, #31, #33 - Optimizaciones avanzadas y contenido
Segunda ola de implementaciones masivas con agentes paralelos para funcionalidades avanzadas de SEO, accesibilidad y contenido especializado.

**Issue #17 - Imágenes responsive con srcset/WebP/AVIF:**
- inc/image-optimization.php: 8 nuevas funciones para optimización
  - Soporte WebP/AVIF con detección de servidor
  - Srcset y sizes automáticos contextuales
  - Lazy loading inteligente (excluye LCP)
  - Threshold 2560px para big images
  - Picture element con fallbacks
  - Preload de featured images
  - Calidad JPEG optimizada (85%)
  - Dimensiones explícitas (previene CLS)
- 14 filtros WordPress implementados
- Beneficios: 30-50% reducción con WebP, 50-70% con AVIF
- Core Web Vitals: Mejora LCP y CLS

**Issue #18 - Accesibilidad WCAG 2.1 AA:**
- assets/css/accessibility.css: +461 líneas
  - Focus styles visibles (3px outline)
  - Screen reader utilities
  - Touch targets ≥44px
  - High contrast mode support
  - Reduced motion support
  - Color contrast AA (4.5:1, 3:1)
- assets/js/accessibility.js: 19KB nuevo
  - Skip links con smooth scroll
  - Navegación por teclado en dropdowns
  - Arrow keys en menús WordPress
  - Modal keyboard support
  - Focus management y trap
  - ARIA live regions
  - Announcements para screen readers
- header.php: ARIA labels en navbar
- Actualizaciones JS: Respeto prefers-reduced-motion en main.js, toc.js, header.js
- Cumplimiento completo WCAG 2.1 Level AA

**Issue #30 - Tablas APU (Análisis Precios Unitarios):**
- assets/css/tables-apu.css: 560 líneas
  - Diseño sin bordes, moderno
  - Zebra striping (#f8f9fa/#ffffff)
  - Headers sticky con degradado azul
  - 4 tipos de filas: normal, section-header, subtotal, total
  - Fuente monospace para columnas monetarias
  - Responsive (scroll horizontal móvil)
  - Print styles con color-adjust: exact
- inc/apu-tables.php: 330 líneas, 6 funciones
  - apus_process_apu_tables() - Procesamiento automático
  - Shortcodes: [apu_table], [apu_row type=""]
  - apus_generate_apu_table($data) - Generación programática
  - 4 métodos de uso: data-apu, shortcode, clase manual, PHP
- docs/APU-TABLES-GUIDE.md: Guía completa de usuario
- docs/APU-TABLE-EXAMPLE.html: Ejemplo funcional
- 6 columnas: Clave, Descripción, Unidad, Cantidad, Costo, Importe
- CRÍTICO: Contenido principal del sitio de construcción

**Issue #31 - Botones de compartir en redes sociales:**
- inc/social-share.php: 127 líneas
  - apus_get_social_share_buttons() - Genera HTML
  - apus_display_social_share() - Template tag
  - 5 redes: Facebook, X/Twitter, LinkedIn, WhatsApp, Email
  - URLs nativas sin JavaScript de terceros
  - Encoding seguro, ARIA labels
- assets/css/social-share.css: 137 líneas
  - Animaciones hover (translateY, scale)
  - Colores específicos por red
  - Responsive (576px, 360px)
  - Focus styles accesibles
- single.php: Integración después del contenido
- Bootstrap Icons CDN (v1.11.3)
- Panel de opciones con configuración

**Issue #33 - Schema.org completo (5 tipos):**
- inc/schema-org.php: 468 líneas, 7 funciones
  - Organization schema con logo y redes sociales
  - WebSite schema con SearchAction
  - Article schema (posts) con autor, imagen, categorías, wordCount
  - WebPage schema (páginas) con featured image
  - BreadcrumbList schema (8 contextos diferentes)
- JSON-LD format en <head>
- Referencias cruzadas con @id
- Google Rich Results compliant
- Deshabilita schemas Rank Math/Yoast (evita duplicación)
- Locale: es-MX
- Hook: wp_head (prioridad 5)

**Archivos Modificados:**
- functions.php: Includes de nuevos módulos (schema-org, apu-tables, social-share)
- inc/enqueue-scripts.php: Enqueue de nuevos CSS/JS, Bootstrap Icons CDN
- inc/image-optimization.php: 8 funciones nuevas WebP/AVIF
- assets/css/accessibility.css: +461 líneas
- assets/js/main.js, toc.js, header.js: Reduced motion support
- single.php: Social share buttons
- header.php: ARIA labels
- inc/admin/options-api.php: Social share settings

**Archivos Creados:**
- 3 archivos PHP funcionales (apu-tables, social-share, schema-org)
- 1 archivo JavaScript (accessibility.js - 19KB)
- 3 archivos CSS (tables-apu, social-share)
- 2 archivos docs/ (APU guide y example)
- 5 reportes .md de documentación

**Estadísticas:**
- Total funciones nuevas: 30+
- Líneas de código nuevas: 2,500+
- Archivos nuevos: 13
- Archivos modificados: 10
- Mejoras de accesibilidad: WCAG 2.1 AA compliant
- Mejoras SEO: 5 schemas JSON-LD
- Mejoras performance: WebP/AVIF, lazy loading, srcset

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 17:12:03 -06:00

343 lines
8.8 KiB
JavaScript

/**
* Header Navigation JavaScript
*
* This file handles:
* - Mobile hamburger menu toggle
* - Sticky header behavior
* - Smooth scroll to anchors (optional)
* - Accessibility features (keyboard navigation, ARIA attributes)
* - Body scroll locking when mobile menu is open
*
* @package Apus_Theme
* @since 1.0.0
*/
(function() {
'use strict';
/**
* Initialize on DOM ready
*/
function init() {
setupMobileMenu();
setupStickyHeader();
setupSmoothScroll();
setupKeyboardNavigation();
}
/**
* Mobile Menu Functionality
*/
function setupMobileMenu() {
const mobileMenuToggle = document.getElementById('mobile-menu-toggle');
const mobileMenu = document.getElementById('mobile-menu');
const mobileMenuOverlay = document.getElementById('mobile-menu-overlay');
const mobileMenuClose = document.getElementById('mobile-menu-close');
if (!mobileMenuToggle || !mobileMenu || !mobileMenuOverlay) {
return;
}
// Open mobile menu
mobileMenuToggle.addEventListener('click', function() {
openMobileMenu();
});
// Close mobile menu via close button
if (mobileMenuClose) {
mobileMenuClose.addEventListener('click', function() {
closeMobileMenu();
});
}
// Close mobile menu via overlay click
mobileMenuOverlay.addEventListener('click', function() {
closeMobileMenu();
});
// Close mobile menu on Escape key
document.addEventListener('keydown', function(e) {
if (e.key === 'Escape' && mobileMenu.classList.contains('active')) {
closeMobileMenu();
mobileMenuToggle.focus();
}
});
// Close mobile menu when clicking a menu link
const mobileMenuLinks = mobileMenu.querySelectorAll('a');
mobileMenuLinks.forEach(function(link) {
link.addEventListener('click', function() {
closeMobileMenu();
});
});
// Handle window resize - close mobile menu if switching to desktop
let resizeTimer;
window.addEventListener('resize', function() {
clearTimeout(resizeTimer);
resizeTimer = setTimeout(function() {
if (window.innerWidth >= 768 && mobileMenu.classList.contains('active')) {
closeMobileMenu();
}
}, 250);
});
}
/**
* Open mobile menu
*/
function openMobileMenu() {
const mobileMenuToggle = document.getElementById('mobile-menu-toggle');
const mobileMenu = document.getElementById('mobile-menu');
const mobileMenuOverlay = document.getElementById('mobile-menu-overlay');
// Add active classes
mobileMenu.classList.add('active');
mobileMenuOverlay.classList.add('active');
document.body.classList.add('mobile-menu-open');
// Update ARIA attributes
mobileMenuToggle.setAttribute('aria-expanded', 'true');
mobileMenu.setAttribute('aria-hidden', 'false');
mobileMenuOverlay.setAttribute('aria-hidden', 'false');
// Focus trap - focus first menu item
const firstMenuItem = mobileMenu.querySelector('a');
if (firstMenuItem) {
setTimeout(function() {
firstMenuItem.focus();
}, 300);
}
}
/**
* Close mobile menu
*/
function closeMobileMenu() {
const mobileMenuToggle = document.getElementById('mobile-menu-toggle');
const mobileMenu = document.getElementById('mobile-menu');
const mobileMenuOverlay = document.getElementById('mobile-menu-overlay');
// Remove active classes
mobileMenu.classList.remove('active');
mobileMenuOverlay.classList.remove('active');
document.body.classList.remove('mobile-menu-open');
// Update ARIA attributes
mobileMenuToggle.setAttribute('aria-expanded', 'false');
mobileMenu.setAttribute('aria-hidden', 'true');
mobileMenuOverlay.setAttribute('aria-hidden', 'true');
}
/**
* Sticky Header Behavior
*/
function setupStickyHeader() {
const header = document.getElementById('masthead');
if (!header) {
return;
}
let lastScrollTop = 0;
let scrollThreshold = 100;
window.addEventListener('scroll', function() {
const scrollTop = window.pageYOffset || document.documentElement.scrollTop;
// Add/remove scrolled class based on scroll position
if (scrollTop > scrollThreshold) {
header.classList.add('scrolled');
} else {
header.classList.remove('scrolled');
}
lastScrollTop = scrollTop;
}, { passive: true });
}
/**
* Smooth Scroll to Anchors (Optional)
*/
function setupSmoothScroll() {
// Check if user prefers reduced motion
const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (prefersReducedMotion) {
return;
}
// Get all anchor links
const anchorLinks = document.querySelectorAll('a[href^="#"]');
anchorLinks.forEach(function(link) {
link.addEventListener('click', function(e) {
const href = this.getAttribute('href');
// Skip if href is just "#"
if (href === '#') {
return;
}
const target = document.querySelector(href);
if (target) {
e.preventDefault();
// Get header height for offset
const header = document.getElementById('masthead');
const headerHeight = header ? header.offsetHeight : 0;
const targetPosition = target.getBoundingClientRect().top + window.pageYOffset - headerHeight - 20;
window.scrollTo({
top: targetPosition,
behavior: prefersReducedMotion ? 'auto' : 'smooth'
});
// Update URL hash
if (history.pushState) {
history.pushState(null, null, href);
}
// Focus target element for accessibility
target.setAttribute('tabindex', '-1');
target.focus();
}
});
});
}
/**
* Keyboard Navigation for Menus
*/
function setupKeyboardNavigation() {
const menuItems = document.querySelectorAll('.primary-menu > li, .mobile-primary-menu > li');
menuItems.forEach(function(item) {
const link = item.querySelector('a');
const submenu = item.querySelector('.sub-menu');
if (!link || !submenu) {
return;
}
// Open submenu on Enter/Space
link.addEventListener('keydown', function(e) {
if (e.key === 'Enter' || e.key === ' ') {
if (submenu) {
e.preventDefault();
toggleSubmenu(item, submenu);
}
}
// Close submenu on Escape
if (e.key === 'Escape') {
closeSubmenu(item, submenu);
link.focus();
}
});
// Close submenu when focus leaves
const submenuLinks = submenu.querySelectorAll('a');
if (submenuLinks.length > 0) {
const lastSubmenuLink = submenuLinks[submenuLinks.length - 1];
lastSubmenuLink.addEventListener('keydown', function(e) {
if (e.key === 'Tab' && !e.shiftKey) {
closeSubmenu(item, submenu);
}
});
}
});
}
/**
* Toggle submenu visibility
*/
function toggleSubmenu(item, submenu) {
const isExpanded = item.classList.contains('submenu-open');
if (isExpanded) {
closeSubmenu(item, submenu);
} else {
openSubmenu(item, submenu);
}
}
/**
* Open submenu
*/
function openSubmenu(item, submenu) {
item.classList.add('submenu-open');
submenu.setAttribute('aria-hidden', 'false');
const firstLink = submenu.querySelector('a');
if (firstLink) {
firstLink.focus();
}
}
/**
* Close submenu
*/
function closeSubmenu(item, submenu) {
item.classList.remove('submenu-open');
submenu.setAttribute('aria-hidden', 'true');
}
/**
* Trap focus within mobile menu when open
*/
function setupFocusTrap() {
const mobileMenu = document.getElementById('mobile-menu');
if (!mobileMenu) {
return;
}
document.addEventListener('keydown', function(e) {
if (!mobileMenu.classList.contains('active')) {
return;
}
if (e.key === 'Tab') {
const focusableElements = mobileMenu.querySelectorAll(
'a, button, [tabindex]:not([tabindex="-1"])'
);
const firstElement = focusableElements[0];
const lastElement = focusableElements[focusableElements.length - 1];
if (e.shiftKey) {
// Shift + Tab
if (document.activeElement === firstElement) {
e.preventDefault();
lastElement.focus();
}
} else {
// Tab
if (document.activeElement === lastElement) {
e.preventDefault();
firstElement.focus();
}
}
}
});
}
/**
* Initialize focus trap
*/
setupFocusTrap();
/**
* Initialize when DOM is ready
*/
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', init);
} else {
init();
}
})();