Screen Orientation API 与响应式体验
了解 Screen Orientation API 如何影响响应式布局、锁定请求与可访问性,并查看 BotBrowser 在受控配置文件中提供方向输入的范围与限制。
BotBrowser Team
W3C Screen Orientation 规范和 MDN 说明浏览器可能暴露哪些方向接口;BotBrowser 可以为受支持的配置文件提供受控方向输入,但不保证所有宿主都能物理旋转或锁定方向。应把矩阵与指针事件无障碍检查和视口属性验证结合,按用户任务衡量旋转后的恢复,而不是按设备标签判断。
要点
- 普通重排使用 CSS 和容器查询;
lock()可能被拒绝。 - 旋转时保留焦点、数据、阅读顺序和恢复控件。
- 测试缩放、键盘、辅助技术和中间宽度。
内容导航
把方向视为布局状态
screen.orientation.type 描述 portrait-primary 或 landscape-primary 等当前方向类别,angle 报告相对自然方向的角度。旋转期间两者都可能变化,事件顺序取决于浏览器和操作系统。布局应等待视口稳定,而不是假设一个事件就是完整转换。
大多数布局决策应放在 CSS 中。(orientation: portrait) 媒体查询可以切换网格,容器查询可以让组件在分屏或嵌入文档中响应自身宽度。只有在调整画布或游戏棋盘等行为无法用 CSS 表达时,JavaScript 才使用 matchMedia 或方向对象。分支应绑定可见结果,而不是设备目录。
方向不能告诉应用这是手机、平板、桌面还是远程会话。浏览器界面、窗口管理、缩放、辅助功能和虚拟键盘都会改变有效空间。桌面窗口的窄视口仍是有效状态。不要从方向推断身份、位置、年龄或能力。另一个相关信号可参阅 Keyboard Layout API、区域设置与隐私。
旋转时保留任务
旋转发生在阅读、编辑或填写表单过程中。保留已输入数据、仍然有意义的滚动位置、选中的标签和焦点控件。不要因为方向变化重建页面或导航。如果组件必须重建,应明确恢复焦点,只在状态确实有意义时播报。
使用弹性轨道、可换行标签、响应式图片和以内容为依据的断点。窄时双列表单可变为单列;宽表格可展示优先列,并提供键盘可操作的溢出视图。纵向隐藏的控件必须在当前布局有等效操作。关键任务不能只依赖某个方向的手势。
虚拟键盘、浏览器工具栏或分屏分隔线会遮住内容,使视觉视口不同于布局视口。保持活动字段可见,避免固定底部操作被遮挡,并在视觉视口变化时重新放置对话框。CSSOM View 规范提供几何概念,但应用仍需保证可操作结果。
只为真实需求请求方向
screen.orientation.lock() 是请求,不是通用命令。规范和浏览器文档说明文档可见性、浏览上下文、用户激活、全屏和平台政策等限制。调用可能拒绝,浏览器也可能不执行。请求不可用时页面必须仍可使用。
游戏棋盘、相机预览或确实依赖稳定宽高比的演示可以考虑锁定。请求前说明影响,提供明显退出方式,任务结束时释放锁。不要为了简化桌面布局、分类访问者或阻止响应式适配而锁定。
改变整个显示模式应从明确用户操作开始。链接打开的页面不应突然旋转或把用户困在模式中。浏览器拒绝请求时显示普通响应式布局并保留任务。失败是兼容性结果,不代表设备或用户信息。
使用事件避免竞态
方向对象提供 change 事件。处理器应读取当前状态,只更新受影响组件,并容忍重复通知。若组件依赖实际空间,可与 resize 或视觉视口观察结合;方向变化和视口变化相关但并不等同。
避免在事件处理器中执行昂贵同步工作。安排有界更新,取消过时任务,保持旋转时输入响应。媒体、地图或画布需要新尺寸时,应保留语义内容,只改变渲染尺寸。重绘失败也应留下可用替代,而不是空白区域。
用特性检测保护可选行为,检查 screen.orientation 和目标方法,捕获 lock() 被拒绝的 promise。CSS 媒体查询和普通 resize 处理是合理回退。API 不存在时不要静默收集方向、角度、视口和屏幕值。
让可访问性与控制保持可见
响应式重排必须保留语义标题、地标、标签和逻辑阅读顺序。方向变化后测试键盘导航,包括视觉视口边缘附近的焦点环。只有在控件确实移动等情况下才向读屏器播报有用状态,不必播报每次原始角度。
同时尊重缩放、文字放大、减少动画和高对比度或强制颜色模式。默认比例能容纳的布局,在横向放大文字或键盘打开时仍可能失败。保持点击目标、对比度和错误信息可用。WCAG 2.2是这些结果的参考,方向本身不决定符合性。
方向依赖模式必须有可见退出入口。“返回响应式视图”应可用键盘操作且不清除工作。说明旋转由浏览器或操作系统控制时应用只是请求偏好。不要暗示拒绝锁定说明用户错误配置浏览器。
测试行为而非设备类别
测试矩阵应围绕用户结果:纵向和横向、窄和宽窗口、放大文字、虚拟键盘、键盘和触摸输入、减少动画,以及不实现 API 的浏览器。每个场景都验证阅读内容、到达主要操作、恢复错误和离开锁定模式;加入最容易换行失败的中间宽度,例如 360、768 和 1024 CSS 像素。
记录浏览器版本、视口、方向和偏好作为测试配置。截图或自动运行只证明该配置,不是运行者稳定特征。使用合成夹具,不要把原始方向历史发送到分析服务。确需遥测时,优先记录“打开了紧凑导航”等聚合结果,而非角度、尺寸和时序集合。把 window.orientation、screen.orientation.type 和 innerWidth/innerHeight 写进运行日志,而不是用户档案。
改动浏览器支持或锁定请求时先做兼容性检查:核对公开规范和当前 MDN 说明,再到方法缺失或被拒绝的浏览器上验证回退路径。保持该功能可选,并写明由哪个用户操作触发。面向用户的支持说明要描述可见行为和支持范围,不要承诺各平台的相同事件顺序。screen.orientation.lock('landscape') 在桌面宿主上以 NotSupportedError 拒绝属正常结果,页面必须照常渲染并保持可用。
建立隐私友好的响应式契约
读取方向属性前写明支持的用户决策,例如“组件足够宽时把预览放在控件旁”。优先用 CSS 和本地 matchMedia('(min-width: 768px)').matches 这类判断,让值不离开浏览器。若服务确实需要结果改进产品,应记录目的、保留时间、访问者和用户选择,并移除不影响决策的原始角度和尺寸。旋转事件到达时,只在需要它的处理器里读取 screen.orientation.angle,不要缓存到长期存在的会话对象。
方向与其他值结合可能成为指纹,但响应式布局不需要建立此类档案。不要把纵向或横向作为账户、风控或资格信号。共享电脑、旋转显示器、模拟器和调整大小的窗口都能产生相同值。值缺失或粗略是正常情况,保留基础体验。
契约要在各语言和各产品间写清楚:浏览器可以提供方向,应用可以调整呈现,锁定可能不可用或被拒绝。这是三种不同的说法。不要把有条件的能力写成文档、界面文案或译文中的保证。用户选择模式时,把该选择记录为产品偏好,而不是推断出的硬件数据。
视觉视口要单独检查,不能和方向混为一谈。旋转先改变布局视口,浏览器工具栏或键盘随后又会缩小可见区域;应按聚焦控件所需的空间把它移入视野,而不是改写文档语义。旋转后放得下的固定页脚,键盘弹出时仍可能被挡住,因此用 env(safe-area-inset-bottom) 留出安全区内边距,滚动容器用 100dvh 而不是 100vh,让工具栏和键盘变化不会把控件挤出屏幕。安全区域和临时覆盖属于渲染限制,不是设备的永久属性;可折叠屏、桌面分屏、远程会话和手动调整的窗口同理。
为每个响应式状态定义可见结果,例如紧凑导航下键盘用户能打开菜单、确认当前页面并在关闭后不丢失焦点,媒体区域改变大小后字幕、播放和主要操作仍可用。这些结果比设备型号列表或精确角度更稳定,并能在不收集详细环境档案的情况下描述失败。当浏览器改变实现细节时,重新运行结果矩阵,只有可见行为变化时才修订面向用户的说明。
实验和分析也应记录任务结果,而不是原始角度、完整尺寸和时间组成的用户档案。实验分组应独立于锁定请求,用户拒绝模式时仍能使用基础界面。
增加方向相关功能时复查契约,删除不再支持可见决策的属性,并确认翻译保留条件语气和可访问回退。
可访问回退是功能的一部分,不是错误页:它应保留相同标题、标签和任务数据,说明锁定被拒绝后可以在纵向或调整后的窗口继续。嵌入工具同样适用:容器给不出预期宽高比时,控件仍须可见可操作。把错误恢复、状态提示、草稿保留和下一步都留在回退里,让锁定请求抛出的 NotSupportedError 不变成死路;状态变化用 aria-live="polite" 播报,而不是移动焦点。
方向选择应可撤销。明确的用户偏好应与浏览器观察分开保存,并提供重置操作,不要把偏好变成设备结论;下次访问时重新评估可用空间,让用户在不丢失当前位置的前提下换回呈现方式。
实用清单
- 普通重排使用 CSS 或容器查询,JavaScript 只处理有界行为。
- 旋转时保留表单值、焦点、阅读顺序和恢复控件。
- 仅在用户操作后请求锁定,拒绝时使用响应式回退。
- 在两种方向测试缩放、键盘、辅助技术和中间窄宽度。
- 除非有记录在案且可选的产品决策,否则让方向测量留在本地。
规划转换与恢复
方向变化可能与路由、网络请求或校验错误同时发生。保持这些状态独立,保存草稿并让布局围绕它变化。媒体、画布和嵌入组件应保留语义内容、字幕、焦点和任务;无法容纳时提供可读替代。旋转不应改变 URL、重复提交表单或清除输入。服务端渲染可以先使用保守布局,客户端确认视口时不要替换用户文字。优先容器查询处理 iframe、侧栏和可调整编辑器。动画应可中断并尊重减少动画偏好。支持文档说明浏览器可能拒绝锁定,不承诺统一的角度和事件顺序。排查问题时记录可见结果、路由、浏览器、视口和方向,不收集完整屏幕清单或持久标识符。
BotBrowser 支持为移动 profile 设置朝向,覆盖方向 API 和 CSS media query;Android profile 也提供运动与方向事件。BotBrowser 不保证方向锁定或所有宿主上的物理旋转行为。
来源
对于可能跨越多个屏幕的界面,Window Management API 的多屏边界把屏幕权限和拓扑变化与方向处理分开,并保留单窗口路径。
实践结论
把方向当作暂时布局状态,仅在用户操作后请求锁定,并保留可用回退。BotBrowser 可提供可重复的 profile 方向测试设置,但应用负责可访问性与隐私。
常见问题
方向是设备标识吗?
不是;窗口、缩放、分屏和旋转都会改变它。
每个页面都应锁定方向吗?
不应;只有依赖稳定宽高比的任务才请求,并提供退出。
旋转后应检查什么?
检查内容可读、焦点可见、主要操作可达、数据保留且可以退出模式。
本文属于指南: 什么是浏览器指纹?原理、风险、信号与隐私边界