#!/usr/bin/env python3 # -*- coding: utf-8 -*- """栅格体检:找「该用栅格却在自然排列」的容器(2026-11 第七轮起常驻)。 用户口径:**该用 grid 的地方不要用自然排列**。自然排列(`flex-wrap`)在同类子块 宽度参差时会产出两种坏画面:① 一行里右边缘参差不齐;② 折行点随内容漂移, 第二行的左边缘对不上第一行。同量子块只要 >2 个并排,就必须落在栅格里 (`Ctlbar cols={n}` / `Row+Col` / `OptionGrid` / CSS grid)。 判定(对着渲染结果量,不看代码): 容器 = display:flex + flex-direction:row + flex-wrap:wrap; 子块按「族」归类(form-item / select / input / number / card / check / seg …), **同一族 ≥3 颗**才立案——混排的胶囊流本来就不要求等宽。 立案条件(任一): rag 同族子块宽度极差 > 40px(一行放得下也没对齐) misalign 折行后各行左边缘极差 > 8px(折行点随意) 折行错位按**容器全部子块**分行——行首的标签 / 前置按钮会把第一行推右, 只按同族子块分行会把这算成 100~270px 的假错位。 按族豁免: btn 按钮组本就该按内容自然排列(同概念不跨行由 visualcheck 的 ActionGroup 断言管) span .nex-chipbar / .nex-taggroup 里的胶囊与只读标签:筛已有内容 = 胶囊流, 宽度**必须**跟着文案走,等宽反而读不出区别 判据②(同一句话的另一半:横滚不是栅格):`[role="list"]` 是 kit `Steps` 流程条专用(全站唯一),它是一串**等宽重复卡片**,必须容器自适应铺开。 命中条件(任一):容器自身横向可滚 `scrollWidth-clientWidth > 2`; 或有子块右缘越出容器右缘 > 2px。 为什么单独立一条:横滚容器里 `flex-wrap` 根本不折行,判据①(看 rag/折行) 永远安静——第七轮实测流程条 12 格在 1440 宽度下 `scrollLeft=126`、 总控台那条 526px 容器装 1244px 内容,**9 格藏在视野外**而下面写着「已完成 10/12」, 正是判据① 看不见的那类「该用 grid 却在自然排列」。 判据③(同一行表单的「控件不对齐」):`.nex-form-row` 的一条视觉行里, 带标签字段的控件行(`.ant-form-item-control-input`)与**裸控件**(复选框 / 开关 / 按钮 / 下拉……直接坐在 Col 里、自己没标签)中心线相差 > 4px 立案。 为什么必须量像素:FormRow 的列是块级 Col,调用点在裸控件上写的 `self-center` / `self-end` 在块容器里根本不参与对齐——分镜检查器「环境声 / 启用字幕」 那颗复选框实测顶在标签行,和右边输入框的中心差 35px,写 class 的人以为对齐了。 现在由 app.css 表单 glue ⑥ 统一让位(让出标签块再在 controlHeight 里垂直居中), 这条判据盯的是「又有人在调用点自己写对齐」或「glue 被改坏」。 用法: NEX_THEMES=light NEX_WIDTHS=1440,1280,1024 .venv/bin/python scripts/ui/gridcheck.py 退出码:0 = 干净,1 = 有立案。 """ import os import pathlib import sys from collections import Counter 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").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 = os.environ.get("NEX_USER", "admin") PWD = os.environ.get("NEX_PASS", "admin1234") OUT = pathlib.Path(os.environ.get("NEX_SHOTS", "/tmp/nex_ui_grid")); OUT.mkdir(parents=True, exist_ok=True) 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 = ''; let 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 || list[0]?.id || ''; }""" JS = r"""() => { const cls=(el)=>(typeof el.className==='string'?el.className:'').trim().split(/\s+/).slice(0,5).join('.'); // 子块「同类」判定:同一控件族才要求等宽 const kind=(el)=>{ if (el.matches('.ant-form-item')) return 'form-item'; if (el.matches('.ant-card')) return 'card'; if (el.matches('.ant-select')) return 'select'; if (el.matches('.ant-input-affix-wrapper,.ant-input')) return 'input'; if (el.matches('.ant-input-number')) return 'number'; if (el.matches('.ant-btn')) return 'btn'; if (el.matches('.ant-checkbox-wrapper')) return 'check'; if (el.matches('.ant-radio-button-wrapper,.ant-segmented-item')) return 'seg'; if (el.matches('.nex-chip,.ant-tag-checkable')) return 'tile'; // 可点胶囊 / 可选项 if (el.matches('.ant-tag')) return 'tag'; // 只读回显标签 if (el.matches('.nex-tile,.nex-opt-cell')) return 'tile'; return ''; // 裸 span/div/a 是内容不是控件族 }; const out=[]; for (const el of document.querySelectorAll('main *')) { const cs=getComputedStyle(el); if (cs.display!=='flex'||cs.flexDirection!=='row'||cs.flexWrap==='nowrap') continue; const kids=[...el.children].filter(c=>{const k=getComputedStyle(c),r=c.getBoundingClientRect(); return k.display!=='none'&&k.position!=='absolute'&&k.position!=='fixed'&&r.height>4&&r.width>20;}); if (kids.length<3) continue; const byKind={}; kids.forEach(k=>{const g=kind(k);(byKind[g]=byKind[g]||[]).push(k);}); for (const [g,set] of Object.entries(byKind)) { if (!g || set.length<3) continue; if (g==='btn') continue; // 按钮组本就该自然排列 /* 只读标签(kit Tag / Status)整族豁免:宽度天生跟文案走。 「完成 6/6」「待补 2」这种并排回显挤在一起是设计意图,等宽反而读不出差别; 真正该上栅格的是**可选项**,它们走 Chip / OptionGrid(tile 族),仍然在检查里。 胶囊流(.nex-chipbar / .nex-taggroup)里的可点 Chip 同理豁免。 */ if (g==='tag') continue; if (g==='tile' && set.every(k=>k.closest('.nex-chipbar,.nex-taggroup,.ant-pagination'))) continue; const ws=set.map(k=>Math.round(k.getBoundingClientRect().width)); const rag=Math.max(...ws)-Math.min(...ws); /* 折行错位要按**容器全部子块**分行:行首常有标签 / 选择按钮这类前置件, 只按同族子块分行会把「第一行被前置件推右」误判成折行错位(104~270px 的假案)。 分行容差 10px:居中排列时同排子块的 top 会差几像素。 */ const rows=[]; for (const k of kids.map(c=>({l:c.getBoundingClientRect().left,t:c.getBoundingClientRect().top})) .sort((x,y)=>x.t-y.t)) { const r=rows.find(g2=>Math.abs(g2.t-k.t)<=10); if (r) r.ls.push(k.l); else rows.push({t:k.t,ls:[k.l]}); } const starts=rows.map(r=>Math.round(Math.min(...r.ls))); const misalign=rows.length>1 ? Math.max(...starts)-Math.min(...starts) : 0; if (misalign<=8 && rag<=40) continue; if (rag>40 || misalign>8) out.push({kind:g,n:set.length,rag,misalign,rows:rows.length, el:el.tagName.toLowerCase()+'.'+cls(el).slice(0,70),widths:ws.slice(0,8), rows:rows.length,n:set.length, texts:set.slice(0,6).map(k=>((k.innerText||'').trim().slice(0,10)))}); } } /* 判据②:重复卡片排成一条 = 容器自适应 grid,横向滚动 / 越界一律立案。 `role="list"` 全站只有 kit 的 Steps(流程条)在用;格子宽窄由 `.nex-steps` 的 auto-fill minmax 轨道决定,容器宽度变了就多排几列,而不是把尾巴滚掉。 rag 复用成「容器还能滚多少 px」,misalign 复用成「子块越出右缘多少 px」。 */ // 不加 main 前缀:流程条现在住在「项目概况」抽屉里(antd Drawer 挂到 body 的 portal, // 实测 inMain=false),只查 main 会正好漏掉唯一那条长文流程条。 for (const el of document.querySelectorAll('[role="list"]')) { const cs=getComputedStyle(el); if (cs.display==='none'||cs.visibility==='hidden') continue; const box=el.getBoundingClientRect(); if (box.width<40) continue; const kids=[...el.children].filter(c=>{const k=getComputedStyle(c),r=c.getBoundingClientRect(); return k.display!=='none'&&k.position!=='absolute'&&k.position!=='fixed'&&r.height>4&&r.width>20;}); if (kids.length<3) continue; const over=Math.max(0, Math.round(el.scrollWidth-el.clientWidth)); const spill=Math.max(0, ...kids.map(k=>Math.round(k.getBoundingClientRect().right-box.right))); if (over<=2 && spill<=2) continue; out.push({kind:'rail',n:kids.length,rag:over,misalign:spill,rows:1, el:el.tagName.toLowerCase()+'.'+cls(el).slice(0,70), widths:kids.slice(0,8).map(k=>Math.round(k.getBoundingClientRect().width)), texts:kids.slice(0,6).map(k=>((k.innerText||'').trim().replace(/\s+/g,'').slice(0,10)))}); } /* 判据③:一行表单里的裸控件必须和同排字段的控件行对齐(kind=ctl)。 rag/misalign 都复用成「离控件中心线差多少 px」;按视觉行分组,窄屏折行之后 每行各量各的。比中心线而不是顶边:复选框 22 高、输入框 32 高,比顶边会误报。 */ for (const row of document.querySelectorAll('.nex-form-row')) { const cs=getComputedStyle(row); if (cs.display==='none'||cs.visibility==='hidden') continue; const cols=[...row.children].filter(c=>c.matches('.ant-col')&&c.getBoundingClientRect().height>4); if (cols.length<2) continue; const lines=[]; for (const c of cols) { const t=c.getBoundingClientRect().top; const g=lines.find(l=>Math.abs(l.t-t)<=10); if (g) g.cs.push(c); else lines.push({t,cs:[c]}); } for (const l of lines) { if (l.cs.length<2) continue; const labeled=[], bare=[]; for (const c of l.cs) { const ctl=c.querySelector('.ant-form-item-control-input'); if (ctl) { labeled.push(ctl); continue; } const k=[...c.children].find(x=>{const xg=getComputedStyle(x); return xg.display!=='none'&&xg.position!=='absolute'&&xg.position!=='fixed'&&x.getBoundingClientRect().height>4;}); if (k&&k.matches('.ant-checkbox-wrapper,.ant-switch,.ant-btn,.ant-select,.ant-input,.ant-input-number,.ant-radio-group,.nex-chip')) bare.push(k); } if (!labeled.length||!bare.length) continue; const mid=(e)=>{const r=e.getBoundingClientRect();return r.top+r.height/2}; const base=labeled.reduce((a,e)=>a+mid(e),0)/labeled.length; const off=Math.round(Math.max(...bare.map(e=>Math.abs(mid(e)-base)))); if (off<=4) continue; out.push({kind:'ctl',n:labeled.length+bare.length,rag:off,misalign:off,rows:1, el:'div.'+cls(row).slice(0,70), widths:l.cs.map(c=>Math.round(c.getBoundingClientRect().width)).slice(0,8), texts:[...labeled,...bare].map(e=>(e.innerText||String(e.className)||'').trim().slice(0,12)).filter(Boolean).slice(0,6)}); } } return out; } """ def main() -> int: seen: Counter = Counter() detail: dict = {} with sync_playwright() as pw: b = pw.chromium.launch() ctx = b.new_context(viewport={"width": 1440, "height": 900}) pg = ctx.new_page() pg.set_default_timeout(20000) pg.goto(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=20000) pid = pg.evaluate(PROJECT_JS) for width in WIDTHS: pg.set_viewport_size({"width": width, "height": 900}) for theme in THEMES: pg.evaluate("(t) => localStorage.setItem('nex-the', t)", theme) for r in ROUTES: if "{id}" in r and not pid: continue route = r.replace("{id}", str(pid)) pg.goto(BASE + route) pg.wait_for_timeout(1300) for row in pg.evaluate(JS): key = (route, theme, width, row["el"][:70], row["kind"]) seen[key] += 1 detail.setdefault(key, row) b.close() for k, v in seen.items(): d = detail[k] print(f"{k[0]:<32} {k[1]}/{k[2]} x{v:<2} {k[4]:<10} " f"rag={d['rag']:<4} mis={d['misalign']:<4} rows={d['rows']} n={d['n']} {k[3][:60]}") print(f" widths={d['widths']} texts={d['texts']}") total = sum(seen.values()) print("GRID_TOTAL", total, "unique", len(seen)) if total: print("→ kind≠rail:同族子块 ≥3 却没走栅格,改 Ctlbar cols={n} / Row+Col / OptionGrid," "或确认它属于胶囊流(应在 .nex-chipbar / .nex-taggroup 里)") print("→ kind=rail:流程条在横滚/越界(rag=还能滚 px,mis=越界 px)," "格子别钉宽度,交给 .nex-steps 的 auto-fill minmax 轨道") print("→ kind=ctl:同一行的裸控件没坐进控件行(rag=离控件中心线 px)," "别在调用点写 self-center/self-end,交给 app.css 表单 glue ⑥") return 1 return 0 if __name__ == "__main__": sys.exit(main())