#!/usr/bin/env python3 # -*- coding: utf-8 -*- """同行内容换行探针:一行放不下时该换行的是**整块**,不是里面的字(UI规范 §7 · 用户第 2 条)。 两条判据,同一个道理的两面: 判据① `BTNROWS`(用户第 2 条「同一概念按钮组不要乱跨行」): 每颗 里的子项必须待在同一行; 判据② `HEAD_BREAK`(第 17 轮补):卡头那一行放不下标题 + 右端动作时, 必须是**整块动作**掉到第二行,而不是把标题切成两行。 为什么单独一道闸:「同一概念的几颗按钮不许乱跨行」是用户反复点名的毛病, 而它恰好掉在两张已有闸门的缝里—— · visualcheck 的 wrap 断言只在 >=1024 的档位做,而它实际跑的宽度是 1440/992/768/430,等于**只有 1440 一档**在守这条规矩; · gridcheck 管的是「同族控件右边缘齐不齐」,按钮族和胶囊流整体豁免。 于是中间档里「两排 2+1」这种破法一直没人报:实测分镜导入的 「文本预览 → 导入预演(含图片匹配)→ 正式导入」1024 折成 2+1、860 折成三行, 时间线 1024 掉一颗「补齐缺失配音」,全是从 1440 直接跳 992 漏掉的宽度。 判据:量渲染结果,不读 class——同一个 .nex-action-group 里可见子项的 垂直中心落在两条以上水平线 = 这组被劈开(比中心不比 top:两行高的按钮 和一颗单行按钮同排时 top 本来就错开)。 豁免(只有一条,在代码里有名有姓): · `ant-flex-vertical`:竖排等宽是刻意的「这一组」,不是参差 (页面写死的 `stack` 与 ActionGroup 的自动竖排都长这样)。 曾经有第二条「父级是 `
` 的页头那组在 <1024 允许分行」,第 17 轮删了: 门牌卡改造把 PageHead 从 `
` 换成了 `Panel`,这条豁免于是匹配不上任何东西, 而它描述的那套窄屏方案(`max-lg:[&>button]:flex-1` 按钮等分)本来就是坏的—— `natural()` 见子项 flex-grow>0 直接返回 0,自动竖排永远不触发,三颗主操作照旧 折成 2 + 1(实测 576 档 /review 与 430 档 /library、/review 共 3 处)。页头改用 kit 的自动档(满宽那一行仍放不下整组 → 整组竖排等宽)后,它落进上面那条豁免。 判据② 的量法:卡头里第一段文字(标题本体,副标题折行是合法的)的 Range 拿到两条以上 client rect = 标题被切了;此时标题**没有占满整行**,说明行里还有 一整块可以挪下去,却拿断词换宽度 → 立案。标题占满整行的那一档豁免: 那时候没有任何整块可挪,长句子在自己那一行里折行是排版,不是切字。 症状(修前实测):430 档 /assets「人物母版」切成「人物母 / 版」两行, 430 与 480 档 /projects/:id/dispatch「模型配置已迁移至独立管理中心」断两行。 原因:`.ant-card-head-title` 是 `flex:1 1 0`,折行判定看 flex-basis, 浏览器永远认为 extra 放得下,shrink 的全落在标题上——光给 wrapper 加 flex-wrap 不解决(那条注释在 app.css,写着「掉到第二行」却没人验证)。 修法在 kit:Panel 在 <576(Grid.useBreakpoint 的 sm 以下)给 Card 挂 `nex-head-stack`,CSS 把 extra 收成 `flex:1 1 100%` 自己占一行。 用法: NEX_WIDTHS=1440,1024,860 NEX_THEMES=light .venv/bin/python scripts/ui/btnrowcheck.py 退出码:0 = 两条判据都干净;1 = 有点名。 """ import os import sys from playwright.sync_api import sync_playwright BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5173") WIDTHS = [int(x) for x in os.environ.get("NEX_WIDTHS", "1440,1280,1024,860,768,576,430").split(",")] THEMES = os.environ.get("NEX_THEMES", "light").split(",") ROUTES = [r for r in os.environ.get( "NEX_ROUTES", "/,/assets,/models,/projects/{id}/overview,/projects/{id}/library," "/projects/{id}/storyboard,/projects/{id}/dispatch,/projects/{id}/review," "/projects/{id}/timeline,/projects/{id}/delivery," "/account,/users,/help").split(",") if r] USER, PWD = os.environ.get("NEX_USER", "admin"), os.environ.get("NEX_PASS", "admin1234") # 项目子页量「镜头最多」的项目:空项目全是空态,按钮组根本不渲染(同 visualcheck) PROJECT_JS = r"""async () => { const t = localStorage.getItem('nex-auth'); const tok = t ? (JSON.parse(t)?.state?.token || JSON.parse(t)?.token) || '' : ''; const h = {headers: {Authorization: 'Bearer ' + tok}}; const j = await (await fetch('/api/projects', h)).json(); const list = j.projects || j.items || j.data || (Array.isArray(j) ? j : []); let best = list[0]?.id || 1, n = -1; for (const p of list) { const s = await (await fetch(`/api/projects/${p.id}/shots`, h)).json(); const c = s.count ?? (s.shots || []).length; if (c > n) { n = c; best = p.id; } } return best; }""" # 豁免命中计数:豁免只能挂在一个可数的类名上,且每轮都要报出它跳过了多少组—— # 「死掉的豁免」比没有豁免更坏(第 17 轮那条
豁免就是这么悄悄放走问题的)。 COUNT = r"""() => { const groups = document.querySelectorAll('.nex-action-group').length; const stacked = document.querySelectorAll('.nex-action-group.ant-flex-vertical').length; return [groups, stacked]; }""" JS = r"""() => { const bad = []; for (const el of document.querySelectorAll('.nex-action-group')) { const cls = typeof el.className === 'string' ? el.className : ''; if (cls.indexOf('ant-flex-vertical') >= 0) continue; // 竖排等宽:刻意的「这一组」 const kids = [...el.children].filter((k) => { const r = k.getBoundingClientRect(); return r.width > 1 && r.height > 1; }); if (kids.length < 2) continue; const lines = []; for (const k of kids) { const r = k.getBoundingClientRect(); const y = r.top + r.height / 2; if (!lines.some((v) => Math.abs(v - y) < 8)) lines.push(y); } if (lines.length < 2) continue; const box = el.getBoundingClientRect(); const texts = kids.map((k) => (k.innerText || k.getAttribute('aria-label') || k.tagName) .trim().replace(/\s+/g, ' ').slice(0, 12)); bad.push({ el: cls.trim().split(/\s+/).slice(0, 3).join('.') + ' :: ' + texts.join('|'), at: Math.round(box.top + window.scrollY), w: Math.round(box.width), lines: lines.length, tops: kids.map((k) => Math.round(k.getBoundingClientRect().top)), texts, }); } return bad; }""" # 判据②:卡头标题不许被切成两行(详见文件头) HEAD = r"""() => { const bad = []; for (const w of document.querySelectorAll('.ant-card-head-wrapper')) { const t = w.querySelector('.ant-card-head-title'); const e = w.querySelector('.ant-card-extra'); if (!t || !e) continue; let tn = null; // 标题本体 = 第一段文字 const walk = (n) => { if (tn) return; for (const c of n.childNodes) { if (c.nodeType === 3 && c.textContent.trim()) { tn = c; return; } if (c.nodeType === 1) walk(c); } }; walk(t); if (!tn) continue; const rg = document.createRange(); rg.selectNodeContents(tn); const lines = [...rg.getClientRects()].filter((r) => r.width > 1).length; if (lines < 2) continue; const wb = w.getBoundingClientRect(); const tb = t.getBoundingClientRect(); const eb = e.getBoundingClientRect(); // 标题已经占满整行 = 没有「一整块」可以再挪下去了,长句子在自己行里折行是排版 if (wb.width - tb.width <= 8) continue; bad.push({ el: 'head::' + tn.textContent.trim().replace(/\s+/g, ' ').slice(0, 24), at: Math.round(tb.top + window.scrollY), w: Math.round(tb.width), ew: Math.round(eb.width), lines, }); } return bad; }""" def main() -> int: violations = 0 breaks = 0 groups = 0 stacked = 0 with sync_playwright() as pw: b = pw.chromium.launch() pg = b.new_context(viewport={"width": 1440, "height": 1000}).new_page() pg.set_default_timeout(20000) pg.goto(f"{BASE}/login") pg.wait_for_selector("#login-user") pg.fill("#login-user", USER) pg.fill("#login-pass", PWD) pg.click("button[type=submit]") pg.wait_for_url(lambda u: "/login" not in u, timeout=15000) pid = os.environ.get("NEX_PROJECT_ID") or pg.evaluate(PROJECT_JS) for theme in THEMES: pg.evaluate("t => localStorage.setItem('nex-the', t)", theme) for w in WIDTHS: pg.set_viewport_size({"width": w, "height": 1000}) for route in ROUTES: path = route.replace("{id}", str(pid)) pg.goto(BASE + path) pg.wait_for_timeout(1200) g, st = pg.evaluate(COUNT) groups += g stacked += st for item in pg.evaluate(JS): violations += 1 print(f"VIOLATION {theme} {w}px {path} y={item['at']} " f"w={item['w']} lines={item['lines']} tops={item['tops']} " f":: {' / '.join(item['texts'])}") for item in pg.evaluate(HEAD): breaks += 1 print(f"HEAD_BREAK {theme} {w}px {path} y={item['at']} " f"titlew={item['w']} extraw={item['ew']} " f"lines={item['lines']} :: {item['el']}") print(f"BTNROWS_GROUPS {groups} EXEMPT_STACK {stacked}") print(f"BTNROWS_TOTAL {violations}") print(f"HEAD_BREAK_TOTAL {breaks}") b.close() return 1 if (violations or breaks) else 0 if __name__ == "__main__": sys.exit(main())