用 playwright 连本机共享 Chromium,在 390px(iPhone 14 Pro)与 320px (iPhone SE)量真实盒子。之前的窄屏适配是「照着规则写对」,实测发现 一个功能性 bug 加五处可用性问题。 ## 抽屉式侧栏遮挡底部导航(真 bug) 抽屉是 `fixed left-0 top-0 bottom-0 z-50`,铺满整个视口高度;底部导航没有 z-index。抽屉打开时点最左那一项「收件」,elementFromPoint 命中的是抽屉里的 SVG,不是导航按钮 —— 按钮在那里、尺寸也够、CSS 规则也没写错,只有命中测试 才能发现。 **删掉抽屉而不是给导航加 z-index**:抽屉装的六项(收件/发件/联系/用户/新建/ 管理)与底部导航完全重复,唯一独有的是退出登录。为一个按钮维护一套 fixed 层级加遮罩不划算,而它还附带「Esc 关不掉」「底层未锁滚」两个毛病。 退出登录移到「我的」页 —— 它与密码、密钥同属「账号自身」,而那页此前根本 没有退出入口。`NavToggle` 与 uiStore 的 navOpen/toggleNav/closeNav 一并删除。 ## 触摸命中区:新增 .tap 详情页那排工具按钮视觉高度只有 15-16px(实测「标记已读」48x16、「对话树」 54x16、「转发」42x16、「抄送」20x15),移动端下限是 44x44。 直接加 padding 会把本来就挤的头部撑散、320px 下换行,因此用居中的透明伪元素 扩大命中区:**视觉一像素不动**。只在 max-width:767px 生效 —— 桌面用鼠标精度 足够,而扩大后的命中区在密排工具栏里会互相重叠,点一个可能命中隔壁那个。 覆盖 MailView / ContactPanel / WorkCard / ModelScopePanel / AdminUsersPage / ComposePage / ThreadView / KeyPanel / QuotaPanel / Attachments / BackButton。 ## 看不见却按得动的按钮:新增 .reveal `opacity-0 group-hover:opacity-100` 在没有 hover 的设备上永远是 opacity:0, **但仍然接收点击** —— 实测联系人列表里 elementFromPoint 命中的就是那个看不见的 「归档」。一个看不见却按得动的破坏性按钮比没有按钮更糟:人以为点的是卡片, 实际归档了一条会话。 改为默认可见,只在 `(hover: hover) and (pointer: fine)` 时隐藏。 单看 hover 会把带触摸板的平板算进去。 ## 对话树 - 缩进随屏宽自适应:固定「每级 20px、上限 8 级」= 最多 160px,320px 屏还要 去掉 px-4 的 32px 与连接线 18px,卡片只剩 110px,发件人一行直接被 truncate 吃掉。窄屏改为每级 10px、上限 5 级 - 补返回出口:原先只有「关闭」。两者语义不同 —— 返回退出整个详情栏回到列表, 关闭只收起树、留在这封邮件上 ## 把实测脚本留进仓库 `web/test/manual/`(`npm run test:narrow` / `test:wide`),不进 npm test —— 要一个跑着的浏览器加一个活的 Gateway。 留着而不是用完即删,是因为结构性断言守不住「按钮实际多大、点下去命中谁」, 而这次最严重的 bug 恰好只有 elementFromPoint 能发现。helper 里两个函数专门 为此:tapTargets() 量 .tap 的真实命中区(伪元素尺寸,不是 boundingBox), hitTest() 验每个元素点下去是否命中自己。 ## 验证 - 窄屏 13 项 + 宽屏 5 项全通过。宽屏回归特意验了两件只该在窄屏生效的事: .tap 伪元素 content 为 none、没有返回按钮 - narrow-layout.test.mjs 从 20 条扩到 28 条,逐条钉住上面每个修复 - 无横向溢出:390px 与 320px 下 scrollWidth === clientWidth - 生产已部署
72 lines
2.7 KiB
JavaScript
72 lines
2.7 KiB
JavaScript
/**
|
||
* 宽屏回归:窄屏修复不能把桌面布局改坏。
|
||
*
|
||
* 特别是两个只该在窄屏生效的东西:
|
||
* - `.tap` 的伪元素命中区(桌面密排工具栏里会互相重叠)
|
||
* - `BackButton`(宽屏列表与详情并排,返回没有意义)
|
||
*
|
||
* 用法:ADMIN_PW=<密码> node web/test/manual/wide-regression.mjs
|
||
*/
|
||
import { openApp, WIDE } from './narrow-probe-helper.mjs';
|
||
|
||
const { browser, page, issues } = await openApp(WIDE);
|
||
const failed = [];
|
||
const chk = (n, ok, note = '') => {
|
||
console.log(` ${ok ? '通过' : '失败'} ${n}${note ? ' — ' + note : ''}`);
|
||
if (!ok) failed.push(n);
|
||
};
|
||
|
||
console.log('宽屏回归(1280px):');
|
||
|
||
const cols = await page.evaluate(() => {
|
||
const root = document.querySelector('#root > div');
|
||
return { n: root?.children.length, first: root?.children[0]?.className?.toString().slice(0, 30) };
|
||
});
|
||
chk('仍是三栏并排', cols.n === 3, `栏数=${cols.n} 首栏=${cols.first}`);
|
||
|
||
// 常驻侧栏是宽屏唯一的退出入口(账号页也有,两处都要在)
|
||
const side = await page.evaluate(() => {
|
||
const s = document.querySelector('#root > div > div');
|
||
const btns = s
|
||
? [...s.querySelectorAll('button')].map(b =>
|
||
(b.getAttribute('title') || b.textContent || '').trim().slice(0, 12)
|
||
)
|
||
: [];
|
||
return { w: s ? Math.round(s.getBoundingClientRect().width) : 0, btns };
|
||
});
|
||
chk('常驻侧栏仍有退出登录', side.btns.some(b => b.includes('退出')), `宽=${side.w}`);
|
||
|
||
// 宽屏不该出现返回按钮
|
||
// 邮件行是 <button class="w-full text-left ...">
|
||
const rows = page.locator('button.w-full.text-left');
|
||
if ((await rows.count()) > 0) await rows.first().click();
|
||
await page.waitForTimeout(1000);
|
||
const backN = await page.locator('button[aria-label="返回"], button[aria-label="会话"]').count();
|
||
chk('没有返回按钮', backN === 0, `${backN} 个`);
|
||
|
||
// .tap 只在 max-width:767px 生效
|
||
const tapWide = await page.evaluate(() => {
|
||
const b = [...document.querySelectorAll('.tap')].find(x => x.getBoundingClientRect().height > 0);
|
||
if (!b) return null;
|
||
const cs = getComputedStyle(b, '::after');
|
||
return { content: cs.content, w: cs.width, h: cs.height };
|
||
});
|
||
chk(
|
||
'.tap 伪元素在宽屏不生效',
|
||
!tapWide || tapWide.content === 'none' || tapWide.w === 'auto',
|
||
JSON.stringify(tapWide)
|
||
);
|
||
|
||
const of = await page.evaluate(() => ({
|
||
d: document.documentElement.clientWidth,
|
||
s: document.documentElement.scrollWidth
|
||
}));
|
||
chk('无横向溢出', of.s <= of.d, `doc=${of.d} scroll=${of.s}`);
|
||
|
||
console.log('\nissues:', issues.length ? issues : '无');
|
||
console.log(failed.length === 0 ? '\n宽屏回归:全部通过' : `\n宽屏回归:${failed.length} 项失败`);
|
||
|
||
await page.close();
|
||
await browser.close();
|
||
process.exit(failed.length === 0 ? 0 : 1);
|