Volver al Centro de conocimiento
Huella digital

Screen Orientation API y experiencias adaptables

Usa los cambios de orientación como estado del diseño adaptable y conserva accesibilidad, elección y privacidad.

BotBrowser Team

Documentación

Quieres la documentación estructurada de Huella digital?

Este artículo forma parte de la biblioteca editorial. Para pasos de configuración, material de referencia y actualizaciones continuas, entra en la sección de docs.

La especificación Screen Orientation de W3C y MDN describen lo que el navegador puede exponer; BotBrowser puede ofrecer entradas de orientación controladas para perfiles compatibles, pero no garantiza la rotación física ni el bloqueo en todos los hosts. Combina la matriz con comprobaciones de accesibilidad de los eventos de puntero y con la validación de propiedades del viewport para medir la recuperación como una tarea, no como una etiqueta del dispositivo.

Los cambios de orientación adaptan el diseño mientras conservan el foco, los controles y la recuperación.

Resumen

  • Usa CSS y consultas de contenedor para reflujo; lock() puede rechazarse.
  • Conserva foco, datos, orden de lectura y recuperación al girar.
  • Prueba zoom, teclado, asistencia y anchos intermedios.

Contenido

Trata la orientación como estado de diseño

screen.orientation.type describe categorías como portrait-primary o landscape-primary, y angle indica el ángulo respecto a la orientación natural. Ambos pueden cambiar durante una rotación y el orden de eventos depende del navegador y del sistema operativo. Espera a que el viewport se estabilice en vez de asumir que un evento representa toda la transición.

La mayoría de decisiones pertenecen a CSS. Las consultas (orientation: portrait) pueden cambiar una cuadrícula y las consultas de contenedor permiten que un componente responda a su propio ancho en una vista dividida o un documento incrustado. JavaScript puede usar matchMedia o el objeto de orientación para una conducta concreta, como cambiar un lienzo. La condición debe corresponder al resultado visible, no a un catálogo de dispositivos.

La orientación no identifica un teléfono, tableta, escritorio o sesión remota. La interfaz del navegador, la gestión de ventanas, el zoom, la asistencia y el teclado virtual cambian el espacio efectivo. Una ventana estrecha de escritorio sigue siendo válida. No deduzcas identidad, ubicación, edad o capacidad a partir de este valor. Otra señal relacionada se trata en Keyboard Layout API, preferencias regionales y privacidad.

Conserva la tarea durante la rotación

La rotación puede ocurrir mientras alguien lee, edita o rellena un formulario. Conserva los datos escritos, el desplazamiento útil, la pestaña seleccionada y el control enfocado. No reconstruyas la página ni navegues solo por un cambio de orientación. Si debes reconstruir un componente, restaura el foco de forma explícita y anuncia únicamente un cambio relevante.

Usa pistas flexibles, etiquetas que puedan saltar de línea, imágenes adaptables y puntos de corte basados en el contenido. Un formulario de dos columnas puede pasar a una; una tabla ancha puede mostrar columnas prioritarias y una vista de desbordamiento accesible por teclado. Un control oculto en vertical debe tener una acción equivalente. Una acción esencial nunca debe depender de un gesto de una sola orientación.

El teclado virtual, la barra del navegador o una ventana dividida pueden cubrir contenido. Mantén visible el campo activo, evita acciones fijas tapadas y recoloca diálogos cuando cambie el viewport visual. La especificación CSSOM View define la geometría; el producto debe garantizar el resultado operable.

Solicita orientación solo cuando sea necesario

screen.orientation.lock() es una solicitud, no una orden universal. La especificación y la documentación del navegador imponen condiciones de visibilidad, contexto, activación del usuario, pantalla completa y política de plataforma. La promesa puede rechazarse. La página debe seguir funcionando si no se puede bloquear.

Un juego, una vista de cámara o una presentación pueden necesitar una proporción estable. Explica el efecto antes de solicitarlo, ofrece una salida visible y libera el bloqueo al terminar. No bloquees para simplificar un diseño de escritorio, clasificar visitantes o impedir que el diseño adaptable responda.

El modo debe comenzar con una acción explícita. Una página abierta desde un enlace no debe girar de repente ni atrapar a la persona. Si el navegador rechaza la solicitud, muestra el diseño normal y conserva la tarea. El rechazo es un resultado de compatibilidad, no una señal sobre el dispositivo.

Usa eventos sin carreras

El objeto de orientación expone el evento change. El controlador debe leer el estado actual, actualizar solo el componente afectado y tolerar notificaciones repetidas. Combínalo con resize o viewport visual cuando importe el espacio real; son cambios relacionados, pero no equivalentes.

Evita trabajo síncrono costoso. Programa una actualización acotada, cancela trabajo obsoleto y conserva la respuesta de entrada. Al redimensionar medios, mapas o lienzos, conserva su contenido semántico. Un redibujado fallido debe dejar una alternativa útil y no una zona vacía.

Protege el comportamiento opcional con detección de capacidades, comprueba el método que usarás y captura el rechazo de lock(). Las consultas CSS y resize son un retorno válido. No recolectes silenciosamente orientación, ángulo, viewport y pantalla cuando falte la API.

Mantén visibles accesibilidad y control

El reflujo debe conservar títulos semánticos, regiones, etiquetas y orden de lectura. Prueba la navegación con teclado después de girar, incluidos los indicadores de foco cerca del borde visible. Un lector de pantalla solo necesita un mensaje útil, no el ángulo bruto de cada giro.

Respeta zoom, aumento de texto, movimiento reducido y alto contraste o colores forzados. Una interfaz que cabe al tamaño predeterminado puede fallar con texto ampliado o el teclado abierto. Conserva objetivos táctiles, contraste y mensajes de error. WCAG 2.2 orienta estos resultados; la orientación por sí sola no determina la conformidad.

Un modo dependiente de orientación necesita una salida visible y alcanzable con teclado que no borre el trabajo. Explica cuándo el navegador o el sistema controla el giro y cuándo la aplicación solo solicita una preferencia. No presentes el rechazo como una configuración incorrecta de la persona.

Prueba conductas, no categorías de dispositivos

Prueba vertical y horizontal, ventanas estrechas y anchas, texto ampliado, teclado virtual, entrada de teclado y táctil, movimiento reducido y un navegador sin la API. En cada caso verifica lectura, acción principal, recuperación de errores y salida del modo bloqueado. Incluye un ancho intermedio donde el salto de línea sea difícil, por ejemplo 360, 768 y 1024 píxeles CSS.

Registra versión del navegador, viewport, orientación y preferencias como configuración de prueba. Una captura solo demuestra esa configuración, no una característica estable de quien la ejecutó. Usa datos sintéticos y evita enviar historiales de orientación a analítica. Si necesitas telemetría, registra un resultado agregado, no un conjunto de ángulo, dimensiones y tiempos. Guarda window.orientation, screen.orientation.type e innerWidth/innerHeight en el registro de la ejecución, no en un registro de usuario.

Ejecuta una comprobación de compatibilidad al cambiar el soporte o una solicitud de bloqueo. Confirma la especificación pública y las notas actuales de MDN; después prueba la ruta de reserva en un navegador donde el método no exista o sea rechazado. Mantén la función opcional y documenta qué acción de la persona la inicia. La guía pública debe describir el comportamiento visible y el rango de soporte, sin prometer el mismo orden de eventos en cada plataforma. Un screen.orientation.lock('landscape') que se rechaza con NotSupportedError es un resultado normal en equipos de escritorio, y la página debe seguir renderizando y ser utilizable.

Define un contrato adaptable y respetuoso

Antes de leer una propiedad escribe la decisión que respalda, como colocar la vista previa junto a los controles cuando el componente sea suficientemente ancho. Prefiere CSS y decisiones locales con matchMedia para que el valor nunca salga del navegador, por ejemplo matchMedia('(min-width: 768px)').matches. Si un servicio necesita un resultado para mejorar el producto, documenta finalidad, retención, acceso y elección, y elimina los campos de ángulo y dimensiones que no cambien la decisión.

La orientación puede contribuir a una huella junto con otros valores, pero el diseño adaptable no exige crear ese perfil. No uses vertical u horizontal como señal de cuenta, riesgo o elegibilidad. Un equipo compartido, un monitor girado, un emulador y una ventana redimensionada pueden dar el mismo valor. La ausencia o poca precisión son normales; conserva la experiencia base. Cuando llega un evento de rotación, lee screen.orientation.angle solo dentro del controlador que lo necesita y no lo guardes en un objeto de sesión de larga duración.

Mantén el contrato explícito entre idiomas y productos: el navegador puede exponer una orientación, la aplicación puede adaptar su presentación y el bloqueo puede no estar disponible o ser rechazado. Son afirmaciones distintas; no conviertas una capacidad condicional en garantía en la documentación, el texto de la interfaz ni una traducción. Cuando la persona elige un modo, registra esa elección como preferencia de producto, no como dato de hardware inferido.

El viewport visual merece una comprobación separada. Un giro cambia el viewport de diseño y, un instante después, una barra del navegador o el teclado puede reducir el área visible. Mide el espacio que necesita el control enfocado y llévalo a la vista sin cambiar el significado del documento. Un pie fijo que cabe tras el giro puede quedar oculto al abrirse el teclado: rellena el elemento fijo con env(safe-area-inset-bottom) y dimensiona el contenedor de desplazamiento con 100dvh en lugar de 100vh. Las áreas seguras y las superposiciones temporales son límites de renderizado, no propiedades permanentes del dispositivo. Lo mismo vale para pantallas plegables, vistas divididas, sesiones remotas y ventanas redimensionadas sin rotación física.

Nombra un resultado esperado para cada estado adaptable: en un estado de navegación compacta, quien usa el teclado debe abrir el menú, identificar la página actual y cerrarlo sin perder el foco; en un estado de medios, subtítulos, reproducción y acción principal deben seguir disponibles cuando la vista previa cambie de tamaño. Estos resultados son más duraderos que una lista de modelos y describen fallos sin recopilar un perfil detallado del entorno. Cuando un navegador cambia un detalle de implementación, vuelve a ejecutar la matriz de resultados y revisa la guía de soporte pública solo si cambia el comportamiento visible.

En análisis y experimentos registra qué presentación se mostró y si la tarea solicitada se completó; no conserves el ángulo, las dimensiones de pantalla y los tiempos como sustituto de un perfil. La asignación del experimento debe ser independiente de la solicitud de bloqueo para que rechazarla no quite la interfaz básica.

Revisa el contrato al añadir una función dependiente de orientación: elimina propiedades que ya no sustentan una decisión visible, comprueba que cada explicación traducida conserva el lenguaje condicional y verifica que el retorno sigue siendo alcanzable con teclado y tecnología de asistencia.

El retorno accesible forma parte de la función, no es una pantalla de error: conserva el mismo título, las etiquetas y los datos de la tarea, y permite continuar en vertical tras pedir horizontal o en una ventana redimensionada cuando termina la pantalla completa. Un componente incrustado debe exponer sus controles aunque su contenedor no ofrezca la proporción esperada, y el retorno debe mantener visibles la recuperación del error, el estado y la siguiente acción, de modo que un NotSupportedError del bloqueo no deje a nadie sin salida; anuncia el cambio con aria-live="polite" en lugar de mover el foco.

Las preferencias de orientación deben poder deshacerse. Guarda la elección explícita por separado de las observaciones del navegador y ofrece un restablecimiento, sin convertirla en una conclusión sobre el dispositivo. En la siguiente visita vuelve a evaluar el espacio disponible y permite cambiar la presentación sin perder el lugar.

Lista práctica

  • Usa CSS o consultas de contenedor para reflujo; reserva JavaScript para una conducta concreta.
  • Conserva valores, foco, orden de lectura y recuperación al girar.
  • Solicita el bloqueo tras una acción del usuario y ofrece retorno adaptable si se rechaza.
  • Prueba zoom, teclado, asistencia y anchos intermedios en ambas orientaciones.
  • Mantén las mediciones locales salvo una decisión opcional y documentada.

Planifica transiciones y recuperación

Un giro puede coincidir con navegación, una petición pendiente o un error de validación. Mantén esos estados separados y conserva el borrador sin repetir el envío. Medios, lienzos y componentes incrustados deben conservar contenido, subtítulos y foco; ofrece una alternativa legible si no caben. La URL y el historial no deben cambiar por la orientación. La interfaz renderizada en servidor puede empezar de forma conservadora y reconciliar el viewport sin borrar texto. Prefiere consultas de contenedor en paneles e iframe. Las animaciones deben poder interrumpirse y respetar movimiento reducido. Documenta navegadores probados y el comportamiento de retorno, sin prometer el mismo orden de eventos. Para investigar un fallo registra el resultado visible y la configuración de prueba, no un inventario persistente de pantalla.

BotBrowser permite configurar la orientación de perfiles móviles para las API de orientación y las media queries CSS, y los perfiles Android exponen eventos de movimiento y orientación. BotBrowser no garantiza el bloqueo de orientación ni el comportamiento de rotación física en todos los hosts.

Fuentes

Para una interfaz que puede abarcar pantallas, límites multi-pantalla de Window Management API separa permisos y topología de la orientación y conserva una ruta de una ventana.

Conclusión práctica

Usa orientación como estado temporal, solicita bloqueo tras una acción clara y conserva un retorno adaptable. BotBrowser ofrece ajustes reproducibles de prueba; el producto responde por accesibilidad y privacidad.

Preguntas frecuentes

¿La orientación identifica un dispositivo?

No; cambia con ventanas, zoom, pantalla dividida o rotación.

¿Debe cada página bloquear la orientación?

No; solo tareas con proporción estable y siempre con retorno.

¿Qué comprueba una prueba?

Texto legible, foco visible, acción alcanzable, datos conservados y salida disponible.

#Screen Orientation API#Diseño Adaptable#Accesibilidad#Web Móvil

Este artículo forma parte de la guía: ¿Qué es la huella digital del navegador?

Ejecuta la misma comprobación en BotBrowser

Carga un perfil, mantén dentro del navegador las señales que acabas de leer y confirma el resultado en tu propia máquina antes del despliegue.