feat(phase-2): 京东数据库侧栏组件——商品目录树计数徽标/树外兜底+店铺分类双 Tab(additive,页面 Phase 5 接线)

This commit is contained in:
2026-11-21 03:56:11 +08:00
parent 380792aa82
commit 3702c83c60
2 changed files with 683 additions and 0 deletions
@@ -0,0 +1,233 @@
/**
* 京东数据库侧栏(JdCategorySidebar,v1.6 蓝图 Phase 2)的挂载契约。
*
* 纯展示组件:取数与失败兜底全在页面(props 流入、emit 流出),本文件零 api mock——
* 钉的是「徽标数=点节点后列表命中的行数」(jdCategoryCountTree 同源)、双 Tab 切换、
* 点节点 emit 形状(树内带路径/树外兜底 path 空/全部商品 null)、可写档分档入口。
*
* 跑法:`npx vitest run tests/mount/jd-category-sidebar.mount.test.ts`
*/
import { beforeEach, describe, expect, it } from 'vitest'
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import JdCategorySidebar from '@/pages/jd/JdCategorySidebar.vue'
import type { JdProductCategoryOption, JdProductGroup } from '@/pages/jd/jd-product-api.ts'
/** 类目计数夹具:树内名(连衣裙支+同名跨支短裤)+树外历史名,读数与 Phase 1
* 纯函数测试同源——服饰内衣根徽标 20(子树去重)、全部商品 37、兜底 12。 */
const CATEGORY_OPTIONS: JdProductCategoryOption[] = [
{ name: '连衣裙', productCount: 7 },
{ name: '短袖连衣裙', productCount: 4 },
{ name: '艺考形体服', productCount: 5 },
{ name: '短裤', productCount: 9 },
{ name: '已下架历史类目', productCount: 12 },
]
const CATEGORIES: JdProductGroup[] = [
{ id: 7, name: '裙装', ownerGroupId: 11, sortOrder: 0, productCount: 3 },
{ id: 8, name: '裤装', ownerGroupId: 11, sortOrder: 1, productCount: 1 },
]
interface MountOptions {
editable?: boolean
selectedCategory?: { name: string; path: string[] } | null
selectedGroupId?: number | null
}
function mountSidebar(options: MountOptions = {}): VueWrapper<Element> {
return mount(JdCategorySidebar, {
props: {
categoryOptions: CATEGORY_OPTIONS,
categories: CATEGORIES,
editable: options.editable ?? true,
selectedCategory: options.selectedCategory ?? null,
selectedGroupId: options.selectedGroupId ?? null,
},
})
}
/** 在指定 Tab 体内按文案找行(两个 Tab 体 v-show 共存于 DOM,必须先圈定范围)。 */
function rowByText(scope: VueWrapper<Element>, text: string) {
const row = scope.findAll('.jd-side-row').find((node) => node.text().includes(text))
expect(row, `应存在文案含「${text}」的侧栏行`).toBeTruthy()
return row!
}
beforeEach(() => {
// 纯展示组件无副作用;占位保持与页面 mount 测试同构。
})
describe('商品目录 Tab(京麦授权类目树+计数徽标)', () => {
it('出厂停在商品目录 Tab;徽标与 Phase 1 聚合同源(根=子树去重和、全部商品=计数行总和)', () => {
const wrapper = mountSidebar()
const catalog = wrapper.get('.jd-side-catalog')
const all = catalog.get('.jd-side-all')
expect(all.text()).toContain('全部商品')
expect(all.text()).toContain('37', '全部商品徽标=5 条计数行求和(7+4+5+9+12)')
expect(rowByText(catalog, '服饰内衣').text()).toContain('20',
'服饰内衣根徽标=子树去重和(连衣裙7+短袖4+短裤9,短裤跨支同名只记一次)')
expect(rowByText(catalog, '母婴').text()).toContain('0', '无词条一级归 0 不缺节点')
expect(rowByText(catalog, '运动户外').text()).toContain('5')
wrapper.unmount()
})
it('一级默认展开(二级首屏可见);逐级展开后末级行点行 emit {name, path}', async () => {
const wrapper = mountSidebar()
const catalog = wrapper.get('.jd-side-catalog')
const women = rowByText(catalog, '女装')
expect(women.classes()).toContain('depth-1', '一级默认展开 ⇒ 二级行(depth-1 缩进)首屏可见')
// 末级艺考形体服在 depth-2:其父(舞蹈体操鞋服/装备)未展开时不可见。
expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('艺考形体服'))).toBe(false)
await catalog.get('[aria-label="展开或收起 舞蹈体操鞋服/装备"]').trigger('click')
await flushPromises()
const yikao = rowByText(catalog, '艺考形体服')
expect(yikao.classes()).toContain('depth-2', '艺考形体服是 level 3(depth 2 缩进)')
await yikao.trigger('click')
await flushPromises()
expect(wrapper.emitted('select-category')).toEqual([[{ name: '艺考形体服', path: ['运动户外', '舞蹈体操鞋服/装备', '艺考形体服'] }]])
wrapper.unmount()
})
it('点二级节点 emit 完整路径(页面按子树展开 IN);箭头只折展不选中', async () => {
const wrapper = mountSidebar()
const catalog = wrapper.get('.jd-side-catalog')
// 女装行未展开时,其子行(连衣裙)不可见。
expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('连衣裙'))).toBe(false)
const women = rowByText(catalog, '女装')
await women.trigger('click')
await flushPromises()
expect(wrapper.emitted('select-category')).toEqual([[{ name: '女装', path: ['服饰内衣', '女装'] }]],
'点行=选中即筛,emit 完整名称路径')
// 点行顺手展开(下钻感):子行现在可见。
expect(wrapper.emitted('select-category')).toHaveLength(1)
expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('连衣裙'))).toBe(true,
'非末级行点行后展开子级')
// 箭头(role=button, aria-label)只折展:点它不得触发 select-category。
const before = wrapper.emitted('select-category')?.length ?? 0
await catalog.get('[aria-label="展开或收起 女装"]').trigger('click')
await flushPromises()
expect(wrapper.emitted('select-category')?.length).toBe(before, '箭头点击不选中(click.stop 防冒泡)')
expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('连衣裙'))).toBe(false,
'再点箭头=收起(子行隐藏)')
wrapper.unmount()
})
it('「全部商品」行 emit null(页面清类目筛选重查);挂载即带选中态时祖先自动展开并高亮', async () => {
const wrapper = mountSidebar({ selectedCategory: { name: '连衣裙', path: ['服饰内衣', '女装', '连衣裙'] } })
const catalog = wrapper.get('.jd-side-catalog')
const dress = rowByText(catalog, '连衣裙')
expect(dress.classes()).toContain('selected', '外部选中态回显高亮')
expect(dress.classes()).toContain('depth-2', '挂载即带选中 ⇒ watch immediate 展开祖先(女装已展开,行可见)')
await wrapper.setProps({ selectedCategory: null })
expect(catalog.get('.jd-side-all').classes()).toContain('selected', 'null=全部商品高亮')
await catalog.get('.jd-side-all').trigger('click')
await flushPromises()
expect(wrapper.emitted('select-category')).toEqual([[null]], '点全部商品=清选')
wrapper.unmount()
})
})
describe('树外兜底组(树上对不上的历史行,单名等值出口)', () => {
it('兜底组头渲染计数和=extraTotal;行点击 emit {name, path:[]}(页面按单名等值回落)', async () => {
const wrapper = mountSidebar()
const catalog = wrapper.get('.jd-side-catalog')
const head = catalog.get('.jd-side-extra-head')
expect(head.text()).toContain('树外兜底')
expect(head.text()).toContain('12', '兜底组头徽标=extraTotal(历史行求和)')
const extra = rowByText(catalog, '已下架历史类目')
await extra.trigger('click')
await flushPromises()
expect(wrapper.emitted('select-category')).toEqual([[{ name: '已下架历史类目', path: [] }]],
'树外名 path 空数组=无路径序列化(单名等值旧形状,不静默丢筛选)')
wrapper.unmount()
})
it('全部是树内名时兜底组整体不渲染(不占一条空组)', () => {
const wrapper = mount(JdCategorySidebar, {
props: {
categoryOptions: [{ name: '连衣裙', productCount: 7 }],
categories: CATEGORIES,
editable: true,
selectedCategory: null,
selectedGroupId: null,
},
})
expect(wrapper.find('.jd-side-extra').exists()).toBe(false)
wrapper.unmount()
})
})
describe('店铺分类 Tab(当前分组分类平铺+入口分档)', () => {
it('点店铺分类切 Tab;分类行带计数;点行 emit id、再点已选中的 emit null(toggle 清选)', async () => {
const wrapper = mountSidebar()
const tabs = wrapper.findAll('.jd-sidebar-tab')
expect(tabs.map((tab) => tab.text())).toEqual(['商品目录', '店铺分类'])
await tabs[1]!.trigger('click')
await flushPromises()
expect(tabs[1]!.classes()).toContain('active')
const custom = wrapper.get('.jd-side-custom')
const skirt = rowByText(custom, '裙装')
expect(skirt.text()).toContain('3', '分类行计数徽标')
await skirt.trigger('click')
await flushPromises()
expect(wrapper.emitted('select-group')).toEqual([[7]])
await wrapper.setProps({ selectedGroupId: 7 })
expect(rowByText(custom, '裙装').classes()).toContain('selected', '选中态回显')
await rowByText(custom, '裙装').trigger('click')
await flushPromises()
expect(wrapper.emitted('select-group')?.at(-1)).toEqual([null], '再点已选中=清选回全部分类')
wrapper.unmount()
})
it('可写档出「新建分类」行:emit 分类名并清输入,空名按钮置灰;只读档不渲染该行', async () => {
const editable = mountSidebar({ editable: true })
const custom = editable.get('.jd-side-custom')
const input = custom.get('[aria-label="新分类名称"]')
const createBtn = custom.findAll('button').find((b) => b.text() === '新建分类')!
expect(createBtn.attributes('disabled')).toBeDefined()
await input.setValue('上新区')
await createBtn.trigger('click')
await flushPromises()
expect(editable.emitted('create-category')).toEqual([['上新区']],
'侧栏只 emit,建分类的 API 调用与刷新在页面(Phase 5 接线)')
expect((input.element as HTMLInputElement).value).toBe('', '提交即清输入')
await input.setValue(' ')
expect(createBtn.attributes('disabled')).toBeDefined(), '纯空白名按钮置灰'
editable.unmount()
const readonly = mountSidebar({ editable: false })
expect(readonly.get('.jd-side-custom').find('[aria-label="新分类名称"]').exists()).toBe(false,
'只读档不渲染新建行')
readonly.unmount()
})
it('「分类管理」入口对所有人渲染(同组普通号只读可看 V203),点击 emit manage-categories', async () => {
for (const editable of [true, false]) {
const wrapper = mountSidebar({ editable })
const manage = wrapper.get('.jd-side-custom').get('.jd-side-manage')
expect(manage.text()).toBe('分类管理')
await manage.trigger('click')
await flushPromises()
expect(wrapper.emitted('manage-categories')).toHaveLength(1)
wrapper.unmount()
}
})
it('空分类空态文案分档:可写档引导新建,只读档直说', () => {
const writable = mount(JdCategorySidebar, {
props: { categoryOptions: [], categories: [], editable: true, selectedCategory: null, selectedGroupId: null },
})
expect(writable.get('.jd-side-empty').text()).toBe('本组暂无分类,先新建一个')
writable.unmount()
const readonly = mount(JdCategorySidebar, {
props: { categoryOptions: [], categories: [], editable: false, selectedCategory: null, selectedGroupId: null },
})
expect(readonly.get('.jd-side-empty').text()).toBe('本组暂无分类')
readonly.unmount()
})
})