dsh-knit 0.12.1 → 0.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +230 -0
- package/README.md +4 -2
- package/package.json +1 -1
- package/src/client/client.js +343 -138
- package/test/client.test.mjs +267 -93
- package/test/harness.mjs +4 -2
- package/test/tier1.test.mjs +97 -0
package/test/client.test.mjs
CHANGED
|
@@ -377,7 +377,7 @@ test('渲染:无目录时预览头不渲染空的目录段', async () => {
|
|
|
377
377
|
assert.equal(byExactClass(nodes, 'knit-preview-name').map(textOf).join(''), '技术方案.md')
|
|
378
378
|
})
|
|
379
379
|
|
|
380
|
-
test('
|
|
380
|
+
test('渲染:预览面板一展开就是纯阅读底色(不再「滚动才变白」)', async () => {
|
|
381
381
|
installFetch((url) => (url.includes('/api/doc')
|
|
382
382
|
? { ok: true, rel: 'a.md', title: 'A', text: '正文', truncated: false }
|
|
383
383
|
: listPayload()))
|
|
@@ -393,27 +393,20 @@ test('渲染:滚动正文进入阅读态(背景转纯阅读底色),换
|
|
|
393
393
|
byClass(nodes, 'knit-doc')[0].props.onClick()
|
|
394
394
|
nodes = harness.render(h(KnitBody, { sessionId: 's1' }))
|
|
395
395
|
|
|
396
|
-
assert.equal(byToken(nodes, '
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
assert.equal(byToken(nodes, 'reading').length, 0, '1px 抖动不该换背景')
|
|
396
|
+
assert.equal(byToken(nodes, 'knit-preview').length, 1)
|
|
397
|
+
// 用户 2026-09-20:「下拉出现详情时背景是灰的,这个交互比较差……把它改成整个都是白」
|
|
398
|
+
// 底色现在写在 `.knit-preview` 的 CSS 里(bg-base),**跟滚动无关、跟换篇无关**。
|
|
399
|
+
assert.equal(byToken(nodes, 'reading').length, 0,
|
|
400
|
+
'不再有「阅读态」这个 class —— 灰变白那套已删')
|
|
401
|
+
assert.equal(byExactClass(nodes, 'knit-preview')[0].props.className, 'knit-preview',
|
|
402
|
+
'预览面板的 class 恒为 knit-preview')
|
|
404
403
|
|
|
405
|
-
|
|
406
|
-
assert.equal(
|
|
407
|
-
|
|
408
|
-
// 换一篇 → 新文档重新从分层灰开始(面板仍一眼可辨是另一层)
|
|
409
|
-
byClass(nodes, 'knit-doc')[1].props.onClick()
|
|
410
|
-
nodes = harness.render(h(KnitBody, { sessionId: 's1' }))
|
|
411
|
-
assert.equal(byToken(nodes, 'reading').length, 0, '换一篇后复位')
|
|
404
|
+
// 正文上不该再挂 onScroll(那个 handler 是专门为「滚动才变白」加的)
|
|
405
|
+
assert.equal(byExactClass(nodes, 'knit-preview-body')[0].props.onScroll, undefined,
|
|
406
|
+
'正文不许再有 onScroll —— 它只服务于已删除的灰→白过渡')
|
|
412
407
|
})
|
|
413
408
|
|
|
414
|
-
test('
|
|
415
|
-
// 用独立 sessionId,避免模块级集合在用例之间串味
|
|
416
|
-
const sid = 's-durable'
|
|
409
|
+
test('渲染:换一篇后预览面板仍是同一套底色(没有「复位回灰」这一步)', async () => {
|
|
417
410
|
installFetch((url) => (url.includes('/api/doc')
|
|
418
411
|
? { ok: true, rel: 'a.md', title: 'A', text: '正文', truncated: false }
|
|
419
412
|
: listPayload()))
|
|
@@ -422,28 +415,18 @@ test('渲染:阅读态存在模块级,面板重新挂载后仍然是纯阅
|
|
|
422
415
|
const { KnitBody } = exports.__test
|
|
423
416
|
harness.reset()
|
|
424
417
|
harness.seed(['', 'time'])
|
|
425
|
-
let nodes = harness.render(h(KnitBody, { sessionId:
|
|
418
|
+
let nodes = harness.render(h(KnitBody, { sessionId: 's1' }))
|
|
426
419
|
await harness.flush()
|
|
427
|
-
nodes = harness.render(h(KnitBody, { sessionId:
|
|
420
|
+
nodes = harness.render(h(KnitBody, { sessionId: 's1' }))
|
|
428
421
|
|
|
429
422
|
byClass(nodes, 'knit-doc')[0].props.onClick()
|
|
430
|
-
nodes = harness.render(h(KnitBody, { sessionId:
|
|
431
|
-
byExactClass(nodes, 'knit-preview
|
|
432
|
-
nodes = harness.render(h(KnitBody, { sessionId: sid }))
|
|
433
|
-
assert.equal(byToken(nodes, 'reading').length, 1)
|
|
434
|
-
|
|
435
|
-
// 模拟宿主把 tab body 重新挂载:hook 槽位清零 = 组件 state 全丢
|
|
436
|
-
// (用户反馈「鼠标移出去以后就没有了」,就是这一类的重挂载)
|
|
437
|
-
harness.reset()
|
|
438
|
-
harness.seed(['', 'time'])
|
|
439
|
-
nodes = harness.render(h(KnitBody, { sessionId: sid }))
|
|
440
|
-
await harness.flush()
|
|
441
|
-
nodes = harness.render(h(KnitBody, { sessionId: sid }))
|
|
442
|
-
assert.equal(byToken(nodes, 'knit-preview').length, 0, '重挂载后预览本身当然要先重新展开')
|
|
423
|
+
nodes = harness.render(h(KnitBody, { sessionId: 's1' }))
|
|
424
|
+
const first = byExactClass(nodes, 'knit-preview')[0].props.className
|
|
443
425
|
|
|
444
|
-
byClass(nodes, 'knit-doc')[
|
|
445
|
-
nodes = harness.render(h(KnitBody, { sessionId:
|
|
446
|
-
assert.equal(
|
|
426
|
+
byClass(nodes, 'knit-doc')[1].props.onClick()
|
|
427
|
+
nodes = harness.render(h(KnitBody, { sessionId: 's1' }))
|
|
428
|
+
assert.equal(byExactClass(nodes, 'knit-preview')[0].props.className, first,
|
|
429
|
+
'换一篇不改变面板底色(底色只在 CSS 里,不随文档走)')
|
|
447
430
|
})
|
|
448
431
|
|
|
449
432
|
test('splitRelPath:拆目录与文件名(无目录 / 多级 / 空值)', () => {
|
|
@@ -758,6 +741,9 @@ test('媒体:默认文档视图有三个类型按钮,但不出现媒体网
|
|
|
758
741
|
assert.equal(btns.find((b) => textOf(b) === '文档').props['aria-selected'], true)
|
|
759
742
|
assert.equal(byClass(nodes, 'knit-media-grid').length, 0)
|
|
760
743
|
assert.equal(byClass(nodes, 'knit-doc').length, 2)
|
|
744
|
+
// ⚠️ 列数改造后,**默认(1 列)形态的 DOM 与改造前逐字一致**:
|
|
745
|
+
// 不多包一层容器(否则 byClass('knit-doc') 这类子串匹配会多命中一个)。
|
|
746
|
+
assert.equal(byClass(nodes, 'knit-multicol').length, 0, '1 列不该有网格容器')
|
|
761
747
|
assert.match(byClass(nodes, 'knit-count').map(textOf).join(''), /2 篇/)
|
|
762
748
|
})
|
|
763
749
|
|
|
@@ -773,6 +759,9 @@ test('媒体:媒体视图渲染方形网格,图片出 img、视频出首帧
|
|
|
773
759
|
assert.ok(calls[0].includes('kind=media'), `实际 URL: ${calls[0]}`)
|
|
774
760
|
assert.equal(byClass(nodes, 'knit-media-grid').length, 1)
|
|
775
761
|
assert.equal(byClass(nodes, 'knit-media-card').length, 2)
|
|
762
|
+
// ⚠️ 纵向不封顶:媒体档的网格也不许设 maxHeight(第三版修正,见 mediaLayoutFor 那条测试)
|
|
763
|
+
assert.equal(byClass(nodes, 'knit-media-grid')[0].props.style.maxHeight, undefined,
|
|
764
|
+
'媒体档的网格不设高度上限,滚动交给列表')
|
|
776
765
|
assert.equal(byClass(nodes, 'knit-doc').length, 0, '媒体视图不该有文档行')
|
|
777
766
|
assert.equal(nodes.filter((n) => n.type === 'img').length, 1, '一张图片缩略图')
|
|
778
767
|
const videos = nodes.filter((n) => n.type === 'video')
|
|
@@ -828,7 +817,7 @@ test('媒体:点视频卡片就地预览,播放器 controls 且静音自动
|
|
|
828
817
|
assert.ok(!calls.some((u) => u.includes('/api/doc')), '视频不应触发正文请求')
|
|
829
818
|
})
|
|
830
819
|
|
|
831
|
-
test('媒体:「全部」分上下两区,文档上限 4
|
|
820
|
+
test('媒体:「全部」分上下两区,文档上限 4、媒体一格不隐藏', async () => {
|
|
832
821
|
installFetch(kindResponder({ all: bigMixedPayload() }))
|
|
833
822
|
const { KnitBody } = loadClientModule().exports.__test
|
|
834
823
|
harness.reset()
|
|
@@ -843,19 +832,23 @@ test('媒体:「全部」分上下两区,文档上限 4、媒体不截断(
|
|
|
843
832
|
['文档', '图片与视频'],
|
|
844
833
|
)
|
|
845
834
|
assert.equal(byToken(nodes, 'knit-doc').length, 4, '文档区最多 4 条')
|
|
846
|
-
// 载荷里 5 图 + 4 视频 = 9
|
|
835
|
+
// 载荷里 5 图 + 4 视频 = 9 个媒体:一格都不隐藏,纵向也**不封顶**(有多少行铺多少行)
|
|
847
836
|
assert.equal(byToken(nodes, 'knit-media-card').length, 9, '媒体区不截断,9 个全出')
|
|
848
837
|
assert.equal(byExactClass(nodes, 'knit-media-grid in-section').length, 1, '媒体区用分区网格')
|
|
849
838
|
assert.match(byClass(nodes, 'knit-count').map(textOf).join(''), /16 项/, '顶行仍报总数')
|
|
850
839
|
|
|
851
840
|
const grid = byExactClass(nodes, 'knit-media-grid in-section')[0]
|
|
852
841
|
// 测试环境没有 ResizeObserver → 量不到宽度 → 走默认面板几何(632px)
|
|
853
|
-
assert.equal(grid.props.style['--knit-media-cell'], '118px', '默认面板下 9 个媒体 →
|
|
854
|
-
|
|
855
|
-
assert.equal(grid.props.style
|
|
842
|
+
assert.equal(grid.props.style['--knit-media-cell'], '118px', '默认面板下 9 个媒体 → 118px 的格子')
|
|
843
|
+
// 列数**不再由 JS 下发** —— 交给 CSS 的 auto-fill,面板一变宽就自己多一列
|
|
844
|
+
assert.equal(grid.props.style['--knit-media-cols'], undefined, '不再下发列数')
|
|
845
|
+
assert.equal(grid.props.style['--knit-media-label'], undefined, '118px 还有地方写文件名/时间')
|
|
846
|
+
// ⚠️ 纵向不许封顶:2026-09-20 前两版设 maxHeight 封「两行」,真机上第三行只露一点点
|
|
847
|
+
assert.equal(grid.props.style.maxHeight, undefined,
|
|
848
|
+
'网格不许设 maxHeight —— 纵向有多少行就铺多少行,滚动交给 .knit-list')
|
|
856
849
|
})
|
|
857
850
|
|
|
858
|
-
test('
|
|
851
|
+
test('媒体:条目不多时卡片正常带文件名与时间,不让文字让位', async () => {
|
|
859
852
|
// 1 篇文档 + 5 媒体(正好一屏内)
|
|
860
853
|
const docs = bigMixedPayload().docs.slice(0, 1).concat(
|
|
861
854
|
bigMixedPayload().docs.filter((d) => d.kind !== 'md').slice(0, 5))
|
|
@@ -980,45 +973,128 @@ test('媒体:「全部」的键盘导航只走到分区上限内,不落到
|
|
|
980
973
|
assert.ok(!/^d[5-7]\.md$/.test(reached), `不该落到被截断的文档:${reached}`)
|
|
981
974
|
})
|
|
982
975
|
|
|
983
|
-
test('媒体:mediaLayoutFor ——
|
|
984
|
-
const {
|
|
985
|
-
|
|
986
|
-
|
|
987
|
-
|
|
988
|
-
|
|
989
|
-
|
|
990
|
-
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
1001
|
-
|
|
1002
|
-
|
|
1003
|
-
|
|
1004
|
-
|
|
1005
|
-
|
|
1006
|
-
|
|
1007
|
-
|
|
1008
|
-
|
|
1009
|
-
|
|
1010
|
-
|
|
1011
|
-
|
|
1012
|
-
|
|
1013
|
-
|
|
1014
|
-
|
|
1015
|
-
|
|
1016
|
-
|
|
976
|
+
test('媒体:mediaLayoutFor —— 列数只跟可用宽度走,格子基准固定、与条目数无关', () => {
|
|
977
|
+
const {
|
|
978
|
+
mediaLayoutFor, MEDIA_TRACK_PX, MEDIA_LABEL_MIN_PX, MEDIA_GAP_PX, MEDIA_MAX_ITEMS,
|
|
979
|
+
} = loadClientModule().exports.__test
|
|
980
|
+
|
|
981
|
+
assert.equal(MEDIA_TRACK_PX, 104, '格子基准由「响应区间」定,不由条目数定')
|
|
982
|
+
assert.equal(MEDIA_MAX_ITEMS, 8, '旧版的一屏基准 8 个现在只用来做默认值')
|
|
983
|
+
|
|
984
|
+
// 量不到宽度就按默认面板算(右侧栏 ~632px 可用)
|
|
985
|
+
assert.deepEqual(mediaLayoutFor(0), { min: 104, columns: 5, cell: 118, scaled: false })
|
|
986
|
+
|
|
987
|
+
// JS 的列数口径必须与 CSS 的 auto-fill **含 gap** 的算术逐字一致,否则测试数字与真机对不上
|
|
988
|
+
for (const width of [120, 240, 320, 375, 500, 632, 900, 1400]) {
|
|
989
|
+
const l = mediaLayoutFor(width)
|
|
990
|
+
const expected = Math.max(1, Math.floor((width + MEDIA_GAP_PX) / (MEDIA_TRACK_PX + MEDIA_GAP_PX)))
|
|
991
|
+
assert.equal(l.columns, expected, `${width}px:列数口径要与 CSS 一致`)
|
|
992
|
+
assert.equal(l.min, MEDIA_TRACK_PX, `${width}px:下发的基准宽始终是常量`)
|
|
993
|
+
assert.equal(l.cell, Math.floor((width - (l.columns - 1) * MEDIA_GAP_PX) / l.columns),
|
|
994
|
+
`${width}px:单格宽按列数现算`)
|
|
995
|
+
}
|
|
996
|
+
|
|
997
|
+
// ⚠️ 核心回归(2026-09-20 第二版):**列数只与宽度有关,与有几个媒体无关**。
|
|
998
|
+
// 第一版把格宽和条目数绑在一起(条目 >8 个就缩到 64px),结果列数被条目数**锁死** ——
|
|
999
|
+
// 实测 400→1200px 一直是 5 列,只有格子被吹大;用户反馈「它不是真的响应式」。
|
|
1000
|
+
for (const width of [320, 420, 632, 900, 1200]) {
|
|
1001
|
+
const a = mediaLayoutFor(width)
|
|
1002
|
+
// 函数签名就只有 width —— 条目数根本传不进去(传了也忽略)
|
|
1003
|
+
assert.deepEqual(mediaLayoutFor(width, 120), a, `${width}px:120 个条目不该改变列数`)
|
|
1004
|
+
assert.ok(a.cell >= MEDIA_TRACK_PX, `${width}px:格子不低于基准宽(实际 ${a.cell}px)`)
|
|
1005
|
+
assert.ok(a.cell <= 160, `${width}px:格子不越过响应区间上限(实际 ${a.cell}px)`)
|
|
1006
|
+
}
|
|
1007
|
+
|
|
1008
|
+
// 列数随宽度**平滑**增长:绝不出现「拖 400px 还是 5 列」那种平台期。
|
|
1009
|
+
// 第一版的病灶正是平台期(实测 400→1200px 一直 5 列),所以这条按「每 120px 至少多一列」量。
|
|
1010
|
+
for (let width = 200; width <= 1600; width += 120) {
|
|
1011
|
+
const here = mediaLayoutFor(width).columns
|
|
1012
|
+
const next = mediaLayoutFor(width + 120).columns
|
|
1013
|
+
assert.ok(next >= here, `${width}→${width + 120}px:列数不该变少(${here}→${next})`)
|
|
1014
|
+
// 每 120px 至少多一列 = 不存在平台期;理论上最多多一列(120/114),允许边界上偶尔到 2
|
|
1015
|
+
assert.ok(next >= here + 1, `${width}→${width + 120}px:出现了平台期(${here}→${next})`)
|
|
1016
|
+
assert.ok(next <= here + 2, `${width}→${width + 120}px:跳得太猛(${here}→${next})`)
|
|
1017
|
+
}
|
|
1018
|
+
|
|
1019
|
+
// 窄面板只出 2 列(格子约 135px),宽面板连续铺满
|
|
1020
|
+
assert.equal(mediaLayoutFor(320).columns, 2, '320px 面板:2 列,而不是硬塞 5 列 48px')
|
|
1021
|
+
assert.ok(mediaLayoutFor(900).columns >= 7, '900px 面板:至少 7 列')
|
|
1022
|
+
assert.ok(mediaLayoutFor(1200).columns >= 10, '1200px 面板:至少 10 列——真的是「铺满」')
|
|
1023
|
+
|
|
1024
|
+
// 实际格宽永远 ≥100px(基准 104 + 1fr 只会撑宽),所以文字让位这条分支**不该被触发**
|
|
1025
|
+
for (const width of [200, 240, 320, 632, 900, 920, 1020, 1060, 1140, 1200, 1400]) {
|
|
1026
|
+
const l = mediaLayoutFor(width)
|
|
1027
|
+
assert.equal(l.scaled, false, `${width}px:格宽 ${l.cell}px,文件名放得下,不该让位`)
|
|
1017
1028
|
}
|
|
1018
|
-
|
|
1019
|
-
|
|
1020
|
-
|
|
1021
|
-
|
|
1029
|
+
assert.equal(MEDIA_LABEL_MIN_PX, 96, '兜底阈值:只有真实格宽 < 96 才让位')
|
|
1030
|
+
|
|
1031
|
+
// ⚠️ 核心回归(2026-09-20 第三版):**纵向不许封顶**。
|
|
1032
|
+
// 前两版返回 maxHeight(按「两行」算死),真机上第三行只露出一点点 ——
|
|
1033
|
+
// 用户的原话是「本来有三行,结果第三行只显示了一点点,应该纵向也完整显示」。
|
|
1034
|
+
// 布局函数只要不再吐出高度的概念,就没法再被谁拿去封顶。
|
|
1035
|
+
assert.equal(mediaLayoutFor(632).maxHeight, undefined, '布局函数不再返回 maxHeight')
|
|
1036
|
+
assert.ok(!('maxHeight' in mediaLayoutFor(632)), '连这个键都不该存在')
|
|
1037
|
+
})
|
|
1038
|
+
|
|
1039
|
+
test('文档:docLayoutFor —— 默认 1 列,宽了最多 2 列,字段一个不少', () => {
|
|
1040
|
+
const client = loadClientModule().exports.__test
|
|
1041
|
+
const { docLayoutFor, DOC_TRACK_PX, DOC_GRID_MAX_COLS, DOC_SUMMARY_MIN_PX, MEDIA_GAP_PX } = client
|
|
1042
|
+
|
|
1043
|
+
assert.equal(DOC_TRACK_PX, 205, '格子下限由「2–3 列时摘要还放得下」反推(150px 会让 632px 排到 4 列)')
|
|
1044
|
+
// 演进:4 列 → 3 列(「视觉跳动信息过载」)→ 2 列(交互评审:3 列摘要每行只剩 16 字)
|
|
1045
|
+
assert.equal(DOC_GRID_MAX_COLS, 2, '上限 2 列 —— 3 列摘要每行只剩 16 个汉字,读不下去')
|
|
1046
|
+
assert.equal(DOC_SUMMARY_MIN_PX, 185)
|
|
1047
|
+
|
|
1048
|
+
// 默认(量不到宽度)→ 1 列,与改造之前逐字一致
|
|
1049
|
+
assert.deepEqual(docLayoutFor(0),
|
|
1050
|
+
{ columns: 1, cell: 0, compact: false, summary: true }, '量不到宽度 = 默认一列')
|
|
1051
|
+
// ⚠️ 「默认一个文档一行」是用户的明确要求 —— 窄面板绝不能自己变多列
|
|
1052
|
+
for (const w of [0, 120, 200, 300, 400]) {
|
|
1053
|
+
assert.equal(docLayoutFor(w).columns, 1, `${w}px:窄面板必须还是 1 列`)
|
|
1054
|
+
assert.equal(docLayoutFor(w).compact, false, `${w}px:1 列不是多列态`)
|
|
1055
|
+
}
|
|
1056
|
+
|
|
1057
|
+
// 列数单调不减、封顶 4 列;断点用实测值钉住(基准 205px + gap 10)
|
|
1058
|
+
let prev = 1
|
|
1059
|
+
for (let w = 100; w <= 2000; w += 50) {
|
|
1060
|
+
const { columns } = docLayoutFor(w)
|
|
1061
|
+
assert.ok(columns >= prev, `${w}px:列数不该回落(${prev}→${columns})`)
|
|
1062
|
+
assert.ok(columns <= DOC_GRID_MAX_COLS, `${w}px:不许超过 4 列`)
|
|
1063
|
+
prev = columns
|
|
1064
|
+
}
|
|
1065
|
+
assert.equal(docLayoutFor(2000).columns, 2, '再宽也停在 2 列')
|
|
1066
|
+
assert.equal(docLayoutFor(419).columns, 1, '419px 可用宽还是 1 列')
|
|
1067
|
+
assert.equal(docLayoutFor(420).columns, 2, '420px → 2 列')
|
|
1068
|
+
assert.equal(docLayoutFor(616).columns, 2, '632px 面板(可用 616px)→ 2 列')
|
|
1069
|
+
assert.equal(docLayoutFor(635).columns, 2, '635px 也只有 2 列(不再有第 3 列)')
|
|
1070
|
+
assert.equal(docLayoutFor(1400).columns, 2, '1400px 也只有 2 列')
|
|
1071
|
+
|
|
1072
|
+
// ⚠️ 核心约束:**compact 与列数同源**(不能出现「排了 2 列但还是 1 列的样子」)
|
|
1073
|
+
for (let w = 100; w <= 2000; w += 25) {
|
|
1074
|
+
const { columns, compact } = docLayoutFor(w)
|
|
1075
|
+
assert.equal(compact, columns > 1, `${w}px:compact 必须 == (columns > 1)`)
|
|
1076
|
+
}
|
|
1077
|
+
// 与 mediaLayoutFor 同一套算术(含 gap),再按 4 列封顶
|
|
1078
|
+
for (const w of [200, 420, 616, 900, 1400]) {
|
|
1079
|
+
assert.equal(docLayoutFor(w).columns,
|
|
1080
|
+
Math.min(DOC_GRID_MAX_COLS,
|
|
1081
|
+
Math.max(1, Math.floor((w + MEDIA_GAP_PX) / (DOC_TRACK_PX + MEDIA_GAP_PX)))),
|
|
1082
|
+
`${w}px:文档列数口径要与媒体同一套算术(2 列封顶)`)
|
|
1083
|
+
}
|
|
1084
|
+
|
|
1085
|
+
// ⚠️ 用户第二次修正的核心:**多列时字段一个不少** —— 摘要在任何可达的列数下都保留
|
|
1086
|
+
// (205px 下限 + 4 列上限 ⇒ 最窄的格子也有 ~217px,摘要放得下)。
|
|
1087
|
+
// `summary:false` 只是兜底分支,留给将来调窄基准宽的情况。
|
|
1088
|
+
for (let w = 100; w <= 2000; w += 5) {
|
|
1089
|
+
const { columns, cell, summary } = docLayoutFor(w)
|
|
1090
|
+
if (columns === 1) continue
|
|
1091
|
+
assert.ok(cell >= DOC_SUMMARY_MIN_PX,
|
|
1092
|
+
`${w}px / ${columns} 列:格子 ${cell}px 应该仍然放得下摘要`)
|
|
1093
|
+
assert.equal(summary, true, `${w}px / ${columns} 列:摘要不该被砍(用户否掉了「只剩标题+时间」)`)
|
|
1094
|
+
}
|
|
1095
|
+
// 兜底分支本身必须能用:格子真的窄到放不下时,摘要让位
|
|
1096
|
+
assert.equal(docLayoutFor(420).summary, true, '2 列 205px 格:摘要保留')
|
|
1097
|
+
assert.equal(docLayoutFor(400).summary, true, '1 列时摘要永远在')
|
|
1022
1098
|
})
|
|
1023
1099
|
|
|
1024
1100
|
test('样式:类型切换的选中态不再用品牌色描边,与列表行同一套中性灰填充', async () => {
|
|
@@ -1057,19 +1133,104 @@ test('样式:悬停 / 选中的灰底各降一档(悬停 −60% / 选中 −
|
|
|
1057
1133
|
assert.match(css, /\.knit-media-thumbbox\{[^}]*background:var\(--dsw-alias-interactive-bg-hover/)
|
|
1058
1134
|
})
|
|
1059
1135
|
|
|
1060
|
-
test('
|
|
1136
|
+
test('样式:文档多列只有 2 列一档显式轨道,容器类名不与 knit-doc 撞前缀', async () => {
|
|
1137
|
+
const { readFileSync } = await import('node:fs')
|
|
1138
|
+
const { fileURLToPath } = await import('node:url')
|
|
1139
|
+
const source = readFileSync(fileURLToPath(new URL('../src/client/client.js', import.meta.url)), 'utf8')
|
|
1140
|
+
const start = source.indexOf('const CSS = `') + 'const CSS = `'.length
|
|
1141
|
+
const css = source.slice(start, source.indexOf('`', start)).replace(/\/\*[\s\S]*?\*\//g, '')
|
|
1142
|
+
|
|
1143
|
+
// 列数由 JS 算好、只下发 cols-2 这一个类(**不写 auto-fit**):写 auto-fit 就变成
|
|
1144
|
+
// 「几列」会有两套算法(容器一个、卡片样式一个),而多列样式是按类生效的,必然对不上。
|
|
1145
|
+
assert.match(css, /\.knit-multicol\.cols-2\{display:grid/)
|
|
1146
|
+
assert.match(css, /\.knit-multicol\.cols-2\{[^}]*grid-template-columns:repeat\(2,minmax\(0,1fr\)\)/)
|
|
1147
|
+
// ⚠️ 上限 2 列:3 列与 4 列的样式都该是死代码,不许留在 CSS 里
|
|
1148
|
+
assert.ok(!/\.knit-multicol\.cols-3/.test(css), '上限是 2 列,不该再有 cols-3 的样式')
|
|
1149
|
+
assert.ok(!/\.knit-multicol\.cols-4/.test(css), '上限是 2 列,不该再有 cols-4 的样式')
|
|
1150
|
+
assert.ok(!/\.knit-multicol[^{]*auto-fit/.test(css), '文档多列不许用 auto-fit')
|
|
1151
|
+
// ⚠️ 容器类名里**不能含 `knit-doc`**:byClass 是子串匹配,会把它当成一个文档行
|
|
1152
|
+
// (§6.5 那个坑的第三次;旧名 knit-doc-grid 就是踩了这个)。
|
|
1153
|
+
assert.ok(!/knit-doc-grid/.test(source), '容器类名不许是 knit-doc* 前缀(会被 byClass 误命中)')
|
|
1154
|
+
assert.ok(!/\.knit-list\.cols-/.test(css),
|
|
1155
|
+
'列数类只许加在文档容器上 —— .knit-list 是唯一滚动容器,媒体档与「全部」都在它里面')
|
|
1156
|
+
|
|
1157
|
+
// ⚠️ **多列不砍数据**(用户第二次修正的核心):摘要只有 `.no-sum` 那条兜底规则能藏,
|
|
1158
|
+
// 路径**任何情况下都不许藏**(第一版的错就是「多列只剩标题 + 时间」)。
|
|
1159
|
+
assert.match(css, /\.knit-multicol\.no-sum \.knit-sum\{display:none\}/,
|
|
1160
|
+
'摘要只由 no-sum 兜底规则让位')
|
|
1161
|
+
assert.ok(!/\.knit-multicol\.cols-[234] \.knit-sum[^{]*\{[^}]*display:none/.test(css),
|
|
1162
|
+
'不许再按列数直接藏摘要(那正是「多列只剩标题+时间」那个被否掉的写法)')
|
|
1163
|
+
assert.ok(!/\.knit-multicol[^{]*\.knit-meta[^{]*\{[^}]*display:none/.test(css),
|
|
1164
|
+
'路径在多列时也必须保留')
|
|
1165
|
+
// 标题折两行、路径折两行
|
|
1166
|
+
assert.match(css, /-webkit-line-clamp:2/)
|
|
1167
|
+
assert.match(css, /\.knit-multicol\.cols-2 \.knit-meta\{[^}]*-webkit-line-clamp:2/)
|
|
1168
|
+
|
|
1169
|
+
// ⚠️ 布局函数不许吃条目数(与 mediaLayoutFor 同一条规矩)。先剥注释再扫真实调用。
|
|
1170
|
+
assert.match(source, /function docLayoutFor\(width\) \{/, 'docLayoutFor 只接受 width')
|
|
1171
|
+
const code = source.replace(/\/\*[\s\S]*?\*\//g, '').replace(/\/\/[^\n]*/g, '')
|
|
1172
|
+
for (const m of code.matchAll(/docLayoutFor\(/g)) {
|
|
1173
|
+
let depth = 1
|
|
1174
|
+
let topLevelComma = false
|
|
1175
|
+
for (let i = m.index + m[0].length; i < code.length && depth > 0; i += 1) {
|
|
1176
|
+
if (code[i] === '(') depth += 1
|
|
1177
|
+
else if (code[i] === ')') depth -= 1
|
|
1178
|
+
else if (code[i] === ',' && depth === 1) topLevelComma = true
|
|
1179
|
+
}
|
|
1180
|
+
assert.ok(!topLevelComma, 'docLayoutFor 的调用处不该传第二个参数')
|
|
1181
|
+
}
|
|
1182
|
+
})
|
|
1183
|
+
|
|
1184
|
+
test('样式:媒体网格靠 auto-fill 连续加列,格子基准与 JS 常量同源', async () => {
|
|
1061
1185
|
const { readFileSync } = await import('node:fs')
|
|
1062
1186
|
const { fileURLToPath } = await import('node:url')
|
|
1063
1187
|
const source = readFileSync(fileURLToPath(new URL('../src/client/client.js', import.meta.url)), 'utf8')
|
|
1064
1188
|
|
|
1065
1189
|
assert.ok(!source.includes('grid-template-columns:1fr 1fr'), '不能再写死两列')
|
|
1066
|
-
assert.ok(!source.includes('minmax(160px,1fr)'), '160px
|
|
1067
|
-
// 列数由
|
|
1068
|
-
assert.
|
|
1069
|
-
assert.match(source, /
|
|
1070
|
-
|
|
1190
|
+
assert.ok(!source.includes('minmax(160px,1fr)'), '160px 下限已按用户要求改掉')
|
|
1191
|
+
// 列数由 CSS 的 auto-fill 自己数(用户点名的、AIGC 资产中心那套机制)
|
|
1192
|
+
assert.ok(!source.includes('--knit-media-cols'), '列数不该由 JS 下发')
|
|
1193
|
+
assert.match(source, /grid-template-columns:repeat\(3,1fr\);/, '旧内核的 3 列兜底要留在前面')
|
|
1194
|
+
// 下限 104px + 1fr:1fr 不能省(否则只有一个媒体时那张图撑满面板宽度),
|
|
1195
|
+
// 下限也不能改成「JS 算出的实际格宽」—— 那样列数会被条目数锁死(见下面那条回归)。
|
|
1196
|
+
assert.match(source,
|
|
1197
|
+
/grid-template-columns:repeat\(auto-fill,minmax\(var\(--knit-media-track,\d+px\),1fr\)\)/,
|
|
1198
|
+
'auto-fill + 基准下限 + 1fr')
|
|
1199
|
+
assert.match(source, /--knit-media-track:\$\{MEDIA_TRACK_PX\}px/, '基准宽直接由 JS 常量插入,不许各写一套')
|
|
1200
|
+
assert.match(source, /const MEDIA_TRACK_PX = 104/)
|
|
1071
1201
|
assert.match(source, /const MEDIA_GAP_PX = 10/)
|
|
1072
1202
|
assert.match(source, /const MEDIA_MAX_ITEMS = 8/)
|
|
1203
|
+
// ⚠️ 核心回归(2026-09-20 第三版):**纵向不许封顶**。
|
|
1204
|
+
// 前两版有 `const MEDIA_ROWS = 2` + 网格上的 `overflow-y:auto` + 行内 maxHeight,
|
|
1205
|
+
// 真机上第三行只露一点点。这条守三件事:常量没了、网格不自己滚、渲染不设 maxHeight。
|
|
1206
|
+
assert.ok(!source.includes('MEDIA_ROWS'), '不再有「一屏两行」这个常量')
|
|
1207
|
+
assert.ok(!/mediaLayout\.maxHeight/.test(source), '渲染处不许再读 maxHeight')
|
|
1208
|
+
// 网格的 CSS 规则里不许出现 overflow-y(只有 .knit-list 该滚)
|
|
1209
|
+
const gridRule = source.match(/\.knit-media-grid\{[^}]*\}/)
|
|
1210
|
+
assert.ok(gridRule, '.knit-media-grid 规则必须在')
|
|
1211
|
+
assert.ok(!gridRule[0].includes('overflow-y'), '媒体网格自己不滚(交给 .knit-list)')
|
|
1212
|
+
assert.ok(!gridRule[0].includes('max-height'), '媒体网格不设高度上限')
|
|
1213
|
+
// ⚠️ 核心回归(2026-09-20 第二版):`mediaLayoutFor` **不许再接受条目数**。
|
|
1214
|
+
// 第一版是 mediaLayoutFor(width, count) —— count 一进来,格宽就跟着条目数走,
|
|
1215
|
+
// 列数随之被锁死(400→1200px 全是 5 列),用户反馈「它不是真的响应式」。
|
|
1216
|
+
assert.match(source, /function mediaLayoutFor\(width\) \{/, '签名里不许再有 count')
|
|
1217
|
+
// ⚠️ 真正的病灶在**调用处**:第一版是 `mediaLayoutFor(可用宽, 条目数)` —— 只要调用时还传
|
|
1218
|
+
// 条目数,格宽就会跟着条目数走、列数随之被锁死。
|
|
1219
|
+
// 只看**真实的调用**(先剥注释),并且要求参数表里没有**顶层**逗号
|
|
1220
|
+
// (嵌套的 Math.max(0, …) 里有逗号,不算)。
|
|
1221
|
+
const code = source.replace(/\/\*[\s\S]*?\*\//g, '').replace(/\/\/[^\n]*/g, '')
|
|
1222
|
+
for (const m of code.matchAll(/mediaLayoutFor\(/g)) {
|
|
1223
|
+
let depth = 1
|
|
1224
|
+
let topLevelComma = false
|
|
1225
|
+
for (let i = m.index + m[0].length; i < code.length && depth > 0; i += 1) {
|
|
1226
|
+
const ch = code[i]
|
|
1227
|
+
if (ch === '(') depth += 1
|
|
1228
|
+
else if (ch === ')') depth -= 1
|
|
1229
|
+
else if (ch === ',' && depth === 1) topLevelComma = true
|
|
1230
|
+
}
|
|
1231
|
+
assert.ok(!topLevelComma, '调用处不该再传第二个参数(条目数)')
|
|
1232
|
+
}
|
|
1233
|
+
assert.match(source, /height:var\(--knit-media-cell/)
|
|
1073
1234
|
})
|
|
1074
1235
|
|
|
1075
1236
|
test('样式:交互强调色走 DSH 品牌令牌,源码里不再有硬编码的紫/蓝强调色', async () => {
|
|
@@ -1127,25 +1288,38 @@ test('样式:滚动条交给 DSH 的全局样式,只覆盖令牌、不重写
|
|
|
1127
1288
|
assert.match(css, /--dsh-scrollbar-thumb-hover:var\(--dsw-alias-scrollbar-hover-l2\)/)
|
|
1128
1289
|
})
|
|
1129
1290
|
|
|
1130
|
-
test('
|
|
1291
|
+
test('样式:预览面板底色恒为纯阅读底色,不靠底色分层;头部对齐官方预览', async () => {
|
|
1131
1292
|
const { readFileSync } = await import('node:fs')
|
|
1132
1293
|
const { fileURLToPath } = await import('node:url')
|
|
1133
1294
|
const source = readFileSync(fileURLToPath(new URL('../src/client/client.js', import.meta.url)), 'utf8')
|
|
1134
1295
|
const start = source.indexOf('const CSS = `') + 'const CSS = `'.length
|
|
1135
1296
|
const css = source.slice(start, source.indexOf('`', start)).replace(/\/\*[\s\S]*?\*\//g, '')
|
|
1136
1297
|
|
|
1137
|
-
//
|
|
1138
|
-
|
|
1298
|
+
// 用户 2026-09-20:「下拉出现详情时背景是灰的,这个交互比较差……把它改成整个都是白」
|
|
1299
|
+
// 底色恒为 bg-base(浅 #fff / 深 #151517)—— **分层改由圆角+边界+柔影承担**。
|
|
1300
|
+
assert.match(css, /\.knit-preview\{[^}]*background:var\(--dsw-alias-bg-base/,
|
|
1301
|
+
'预览面板底色走 bg-base(浅色纯白 / 暗色最深的阅读底色)')
|
|
1302
|
+
// ⚠️ 不许写死 #fff:暗色主题下会白得刺眼。fallback 才是 #fff。
|
|
1303
|
+
assert.ok(!/\.knit-preview\{[^}]*background:#fff/.test(css),
|
|
1304
|
+
'底色不能硬编码 #fff —— 要走 bg-base 让暗色主题跟着走')
|
|
1305
|
+
assert.ok(!css.includes('.knit-preview.reading'),
|
|
1306
|
+
'「滚动才变白」那套(.knit-preview.reading)已删,不要再加回来')
|
|
1307
|
+
assert.ok(!/\.knit-preview\{[^}]*transition:background/.test(css),
|
|
1308
|
+
'没有背景过渡了,transition 也该去掉')
|
|
1309
|
+
// 也仍然不许用 bg-layer-2 分层(浅色主题下 layer-1/2/3 都是 #fff,等于没分)
|
|
1139
1310
|
assert.ok(!/\.knit-preview\{[^}]*bg-layer-2/.test(css),
|
|
1140
1311
|
'别用 bg-layer-2 分层:浅色主题下它和 bg-layer-1 都是 #fff')
|
|
1312
|
+
// 分层三件套仍在:上边界 + 圆角 + 柔影
|
|
1313
|
+
assert.match(css, /\.knit-preview\{[^}]*border-top-left-radius:12px/)
|
|
1314
|
+
assert.match(css, /\.knit-preview\{[^}]*box-shadow:0 -8px 24px/)
|
|
1141
1315
|
// 头部对齐官方 .dhJKeW_header:38px + border-l3
|
|
1142
1316
|
assert.match(css, /\.knit-preview-head\{[^}]*height:38px/)
|
|
1143
1317
|
assert.match(css, /\.knit-preview-head\{[^}]*border-bottom:\.5px solid var\(--dsw-alias-border-l3/)
|
|
1144
1318
|
// 全屏时要去掉圆角与柔影(那时没有「浮在列表上」的隐喻)
|
|
1145
1319
|
assert.match(css, /\.knit-root\.fullscreen \.knit-preview\{[^}]*border-radius:0/)
|
|
1146
|
-
//
|
|
1147
|
-
assert.
|
|
1148
|
-
assert.
|
|
1320
|
+
// ⚠️ 旧行为已废:不再有 .knit-preview.reading,也没有背景过渡
|
|
1321
|
+
assert.ok(!css.includes('.knit-preview.reading'))
|
|
1322
|
+
assert.ok(!css.includes('transition:background-color'))
|
|
1149
1323
|
})
|
|
1150
1324
|
|
|
1151
1325
|
test('媒体:点类型按钮切到「图片与视频」会带 kind=media 重拉并记住偏好', async () => {
|
package/test/harness.mjs
CHANGED
|
@@ -60,8 +60,10 @@ export function loadClientModule(options = {}) {
|
|
|
60
60
|
'module.exports.__test = { KnitBody, OfficialTabBody, BetterSidebarTabBody, '
|
|
61
61
|
+ 'sessionFileAddress, relTime, resolveRelative, pathImagesFor, clampRatio, splitRelPath, '
|
|
62
62
|
+ 'openKnitPanel, makeEntryButton, KnitGlyph, KnitTitle, KNIT_ICON_PATH, openLocalPath, '
|
|
63
|
-
+ 'requestPreview, fmtDuration, readKindPref, mediaUrl, isMedia, mediaLayoutFor, '
|
|
64
|
-
+ '
|
|
63
|
+
+ 'requestPreview, fmtDuration, readKindPref, mediaUrl, isMedia, mediaLayoutFor, docLayoutFor, '
|
|
64
|
+
+ 'nextIndexFor, docOptionId, '
|
|
65
|
+
+ 'MIN_RATIO, MAX_RATIO, ALL_DOC_CAP, MEDIA_MAX_ITEMS, MEDIA_TRACK_PX, '
|
|
66
|
+
+ 'MEDIA_LABEL_MIN_PX, MEDIA_GAP_PX, DOC_TRACK_PX, DOC_GRID_MAX_COLS, DOC_SUMMARY_MIN_PX }\n'
|
|
65
67
|
+ " module.exports.inject = ['slots', 'locale']",
|
|
66
68
|
)
|
|
67
69
|
|
package/test/tier1.test.mjs
CHANGED
|
@@ -295,6 +295,103 @@ test('键盘:↑ 到顶停住,不循环', async () => {
|
|
|
295
295
|
assert.ok(String(byClass(nodes, 'knit-doc')[0].props.className).includes('cursor'), '↑ 到顶应停住')
|
|
296
296
|
})
|
|
297
297
|
|
|
298
|
+
/* ── 1.5 多列键盘导航(P0 修复的守卫) ───────────────
|
|
299
|
+
真实列数要靠 ResizeObserver 量,测试环境量不到 → 永远是 1 列。
|
|
300
|
+
所以这里**直接测纯函数**,让多列分支真的被跑到(否则又是一盏空转的绿灯)。 */
|
|
301
|
+
|
|
302
|
+
test('键盘:nextIndexFor —— 多列时 ←→ 跨行,且到行首/行尾停住不回绕', () => {
|
|
303
|
+
const { nextIndexFor } = loadClientModule().exports.__test
|
|
304
|
+
const at = (i, key, cols) => nextIndexFor(i, key, 5, cols)
|
|
305
|
+
|
|
306
|
+
// 单列:只认 ↑↓(←→ 不该悄悄改变行为,返回 -1 表示「这个键我不处理」)
|
|
307
|
+
assert.equal(at(0, 'ArrowDown', 1), 1)
|
|
308
|
+
assert.equal(at(0, 'ArrowUp', 1), 0, '↑ 到顶停住')
|
|
309
|
+
assert.equal(at(4, 'ArrowDown', 1), 4, '↓ 到底停住')
|
|
310
|
+
assert.equal(at(2, 'ArrowLeft', 1), -1, '单列不认 ←(避免挡掉宿主/输入框)')
|
|
311
|
+
assert.equal(at(2, 'ArrowRight', 1), -1, '单列不认 →')
|
|
312
|
+
assert.equal(at(2, 'a', 1), -1, '无关的键一律不处理')
|
|
313
|
+
|
|
314
|
+
// 2 列:0 1 / 2 3 / 4。←→ 只在本行内移动
|
|
315
|
+
assert.equal(at(0, 'ArrowRight', 2), 1, '0 → 1')
|
|
316
|
+
assert.equal(at(1, 'ArrowRight', 2), 1, '行尾再按 → 停住(不回绕到下一行)')
|
|
317
|
+
assert.equal(at(1, 'ArrowLeft', 2), 0, '1 → 0')
|
|
318
|
+
assert.equal(at(0, 'ArrowLeft', 2), 0, '行首再按 ← 停住(不跳到上一行末尾)')
|
|
319
|
+
assert.equal(at(2, 'ArrowRight', 2), 3)
|
|
320
|
+
assert.equal(at(3, 'ArrowRight', 2), 3, '末行不满时 → 停在最后一个')
|
|
321
|
+
assert.equal(at(4, 'ArrowRight', 2), 4, '末行只有一项')
|
|
322
|
+
assert.equal(at(4, 'ArrowLeft', 2), 4, '末行只有一项时 ← 也停住')
|
|
323
|
+
// ↑↓ 是「相邻项」= 视觉上横向走(DOM 顺序即阅读顺序)
|
|
324
|
+
assert.equal(at(0, 'ArrowDown', 2), 1, '2 列时 ↓ 视觉上是往右走')
|
|
325
|
+
assert.equal(at(1, 'ArrowDown', 2), 2, '再 ↓ 落到下一行行首')
|
|
326
|
+
|
|
327
|
+
// Home / End 与列数无关
|
|
328
|
+
assert.equal(at(3, 'Home', 2), 0)
|
|
329
|
+
assert.equal(at(1, 'End', 2), 4)
|
|
330
|
+
|
|
331
|
+
// 没有光标(index < 0)时按第 0 项算;空列表返回 -1
|
|
332
|
+
assert.equal(nextIndexFor(-1, 'ArrowDown', 5, 2), 1)
|
|
333
|
+
assert.equal(nextIndexFor(-1, 'ArrowUp', 5, 2), 0)
|
|
334
|
+
assert.equal(nextIndexFor(0, 'ArrowDown', 0, 2), -1, '空列表不处理')
|
|
335
|
+
})
|
|
336
|
+
|
|
337
|
+
test('可访问性(listbox):容器指向 activedescendant,选项带 role/aria-selected', async () => {
|
|
338
|
+
const docCalls = []
|
|
339
|
+
installFetch((url) => {
|
|
340
|
+
if (url.includes('/api/doc')) {
|
|
341
|
+
docCalls.push(decodeURIComponent(url.split('rel=')[1]))
|
|
342
|
+
return { ok: true, rel: 'x', title: 'x', text: '# x', truncated: false }
|
|
343
|
+
}
|
|
344
|
+
return listPayload()
|
|
345
|
+
})
|
|
346
|
+
|
|
347
|
+
const { KnitBody } = loadClientModule().exports.__test
|
|
348
|
+
let { nodes, renderAgain } = await mount(KnitBody, { sessionId: 's1' }, ['', 'time'])
|
|
349
|
+
nodes = await renderAgain(true)
|
|
350
|
+
|
|
351
|
+
const list = listNode(nodes)
|
|
352
|
+
assert.equal(list.props.role, 'listbox')
|
|
353
|
+
const active = list.props['aria-activedescendant']
|
|
354
|
+
assert.ok(active, '容器必须给出 aria-activedescendant')
|
|
355
|
+
|
|
356
|
+
const docs = byClass(nodes, 'knit-doc')
|
|
357
|
+
assert.equal(docs.length, 3)
|
|
358
|
+
for (const doc of docs) {
|
|
359
|
+
assert.equal(doc.props.role, 'option', '每个选项都要 role="option"(否则读不出「N 项中的第 i 项」)')
|
|
360
|
+
assert.ok(doc.props.id, '每个选项要有 id,才能被 aria-activedescendant 指到')
|
|
361
|
+
}
|
|
362
|
+
// 指向的 id 必须真的在列表里(不然辅助技术指到一个不存在的节点)
|
|
363
|
+
const ids = docs.map((d) => d.props.id)
|
|
364
|
+
assert.ok(ids.includes(active), `aria-activedescendant=${active} 必须是真实存在的选项 id`)
|
|
365
|
+
// 光标项 = aria-activedescendant 指向的那一项
|
|
366
|
+
const cursorNode = docs.find((d) => String(d.props.className).includes('cursor'))
|
|
367
|
+
assert.ok(cursorNode, '初次渲染 cursor 应落在第一项')
|
|
368
|
+
assert.equal(cursorNode.props.id, active, 'activedescendant 必须指向光标那一项')
|
|
369
|
+
|
|
370
|
+
// aria-selected 表达的是**正在预览**(不是光标):没预览时全为 false
|
|
371
|
+
assert.equal(docs.filter((d) => d.props['aria-selected'] === 'true').length, 0,
|
|
372
|
+
'没打开预览时不该有 aria-selected=true')
|
|
373
|
+
|
|
374
|
+
// 按 Enter 打开预览 → 那一项变成 aria-selected=true,且仍然只有一项
|
|
375
|
+
list.props.onKeyDown(keyEvent('Enter'))
|
|
376
|
+
nodes = await renderAgain(true)
|
|
377
|
+
const after = byClass(nodes, 'knit-doc')
|
|
378
|
+
const selected = after.filter((d) => d.props['aria-selected'] === 'true')
|
|
379
|
+
assert.equal(selected.length, 1, '打开预览后恰好一项 aria-selected=true')
|
|
380
|
+
assert.equal(selected[0].props.id, cursorNode.props.id, '选中的就是当前那一项')
|
|
381
|
+
})
|
|
382
|
+
|
|
383
|
+
test('可访问性:选项 id 由 rel 稳定推导(同一篇跨渲染不变,中文/空格也合法)', () => {
|
|
384
|
+
const { docOptionId } = loadClientModule().exports.__test
|
|
385
|
+
const a = { rel: '01_ Knit PRD/Knit_SDD-v0.12-链接解析.md' }
|
|
386
|
+
assert.equal(docOptionId(a), docOptionId(a), '同一篇必须每次都得到同一个 id')
|
|
387
|
+
assert.notEqual(docOptionId(a), docOptionId({ rel: '01_ Knit PRD/别的.md' }))
|
|
388
|
+
assert.match(docOptionId(a), /^[A-Za-z0-9_-]+$/, 'id 只能是合法字符(会进 HTML 属性与选择器)')
|
|
389
|
+
assert.ok(docOptionId(a).length <= 120, 'id 不该过长')
|
|
390
|
+
// 折叠后可能撞车的两篇,靠哈希区分
|
|
391
|
+
assert.notEqual(docOptionId({ rel: 'a b/c.md' }), docOptionId({ rel: 'a_b/c.md' }),
|
|
392
|
+
'折叠字符相同的两篇不能拿到同一个 id')
|
|
393
|
+
})
|
|
394
|
+
|
|
298
395
|
test('键盘:Esc 收起预览', async () => {
|
|
299
396
|
installFetch((url) => (url.includes('/api/doc')
|
|
300
397
|
? { ok: true, rel: 'x', title: 'x', text: '# x', truncated: false }
|