0Pricing
React Academy · Lección

Tooltips y menús desplegables con Portals

Utilice Portals para renderizar tooltips y menús desplegables que escapen de contenedores overflow-hidden.

Tooltips y menús desplegables con Portals es una lección gratuita de React Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de React Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de React Academy incluye 4 lecciones en total.

Bienvenida

En esta lección creará componentes de tooltip y menú desplegable que usan React Portals para renderizarse en document.body y escapar de las restricciones de overflow-hidden y de los contextos de apilamiento de z-index de los padres.

El problema de overflow

Un tooltip colocado en relación con su botón activador se recortará si algún ancestro tiene `overflow: hidden` o `overflow: scroll`. Mover el tooltip a document.body mediante un portal resuelve completamente este problema.

Estrategia de posicionamiento

Para colocar correctamente un tooltip renderizado mediante un portal, mida el rectángulo delimitador del elemento activador con `getBoundingClientRect()` y calcule las coordenadas absolutas teniendo en cuenta la posición de desplazamiento.
const rect = triggerRef.current.getBoundingClientRect();
const top = rect.bottom + window.scrollY + 8;
const left = rect.left + window.scrollX;

Componente Tooltip

Cree un Tooltip que envuelva a sus children, asigne una ref al elemento activador y renderice mediante un portal un cuadro de tooltip posicionado cuando el usuario pase el cursor sobre él.
function Tooltip({ content, children }) {
  const [visible, setVisible] = useState(false);
  const [pos, setPos] = useState({ top: 0, left: 0 });
  const ref = useRef();

  const show = () => {
    const r = ref.current.getBoundingClientRect();
    setPos({ top: r.bottom + window.scrollY + 4,
             left: r.left + window.scrollX });
    setVisible(true);
  };

  return (
    <span ref={ref} onMouseEnter={show} onMouseLeave={() => setVisible(false)}>
      {children}
      {visible && createPortal(
        <div style={{ position:'absolute', top: pos.top, left: pos.left }}
             className="tooltip">{content}</div>,
        document.body
      )}
    </span>
  );
}

Actualización de la posición al desplazarse y cambiar el tamaño

Si el usuario se desplaza mientras un tooltip está visible, su posición queda obsoleta. Escuche los eventos `scroll` y `resize` para volver a calcular la posición o cerrar el tooltip.
useEffect(() => {
  if (!visible) return;
  const update = () => setVisible(false);
  window.addEventListener('scroll', update, true);
  window.addEventListener('resize', update);
  return () => {
    window.removeEventListener('scroll', update, true);
    window.removeEventListener('resize', update);
  };
}, [visible]);

Arquitectura de un menú desplegable

Un menú desplegable sigue el mismo patrón que un tooltip. El botón activador muestra u oculta el menú, el menú se renderiza mediante un portal y un controlador de clics fuera del menú lo cierra.

Controlador de clics fuera

Use un listener de `mousedown` en `document` para detectar los clics fuera del menú. Compare el objetivo del clic con las refs del menú y del activador para decidir si debe cerrarlo.
useEffect(() => {
  if (!open) return;
  const handler = (e) => {
    if (!menuRef.current?.contains(e.target) &&
        !triggerRef.current?.contains(e.target)) {
      setOpen(false);
    }
  };
  document.addEventListener('mousedown', handler);
  return () => document.removeEventListener('mousedown', handler);
}, [open]);

Navegación con teclado en menús desplegables

Implemente ArrowDown/ArrowUp para desplazarse entre los elementos del menú, Enter para seleccionar y Escape para cerrar. Guarde el índice del elemento enfocado en el estado y llame mediante código a `.focus()` en los elementos del menú.

Uso de una biblioteca de posicionamiento

En producción, use **@floating-ui/react** (antes Popper.js). Gestiona automáticamente el volteo (reposicionamiento cerca de los bordes de la ventana), el desplazamiento (para mantener visible el tooltip) y la posición de la flecha.
import { useFloating, flip, shift } from '@floating-ui/react';

const { refs, floatingStyles } = useFloating({
  middleware: [flip(), shift()],
});

Accesibilidad: ARIA para tooltips

En los tooltips, agregue `role='tooltip'` al elemento del tooltip y `aria-describedby` apuntando al id del tooltip en el activador. Esto permite que los lectores de pantalla anuncien el contenido del tooltip.
<button aria-describedby="tip1">Hover me</button>
{visible && createPortal(
  <div id="tip1" role="tooltip">Helpful text</div>,
  document.body
)}

Comprobación rápida

¿Cómo se calcula la posición correcta en pantalla de un tooltip renderizado mediante un portal?

Repaso

Los portales permiten que los tooltips y los menús desplegables escapen de los elementos padre con overflow-hidden. Mida el elemento activador con getBoundingClientRect, añada los desplazamientos de desplazamiento para el posicionamiento absoluto, cierre al hacer clic fuera y al desplazarse, y añada atributos ARIA para la accesibilidad.

Curso completado

¡Enhorabuena! Ha terminado **Portals & Modals in React**. Ahora puede crear modales, tooltips y menús desplegables accesibles y correctamente posicionados que escapen de cualquier restricción de apilamiento de CSS.

Preguntas frecuentes

¿La lección «Tooltips y menús desplegables con Portals» es gratis?

Sí — el texto completo de «Tooltips y menús desplegables con Portals» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de React Academy, actualiza a CoddyKit PRO. El curso de React Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Tooltips y menús desplegables con Portals»?

Utilice Portals para renderizar tooltips y menús desplegables que escapen de contenedores overflow-hidden. Practicas React Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar React Academy?

No se requiere experiencia previa. React Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.

¿Cuánto tiempo toma la lección «Tooltips y menús desplegables con Portals»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de React Academy?

Sí. Cada lección de React Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. ¿Qué son los React Portals?
  2. Construcción de un componente modal con Portals
  3. Gestión del foco y trampas de teclado en modales
  4. Tooltips y menús desplegables con Portals
← Volver a React Academy