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,450 @@
<script setup lang="ts">
/** 京东数据库页左侧栏(v1.6 蓝图 Phase 2,additive——页面接线随 Phase 5):
* 双 Tab=商品目录(京麦授权类目真树+计数徽标+展开折叠+树外兜底组)/
* 店铺分类(当前数据权限分组的分类平铺+计数+新建分类+分类管理入口)。
*
* 纯展示组件:取数与失败兜底全在页面(props 流入、emit 流出),本组件不发请求、
* 不 import api——mount 测试免 mock;内部状态只有双 Tab 切换、树展开/折叠与新建输入框。
* 计数聚合走 jdCategoryCountTree(v1.6 Phase 1):节点徽标=自身名+子树叶和(与
* 「点节点 → 子树展开 IN 过滤」的命中集合同源),树上对不上的历史行归「树外兜底」组
* (点兜底行=单名等值旧形状,path 空数组交给页面回落)。 */
import { computed, ref, watch } from 'vue'
import {
jdCategoryCountTree,
type JdCategoryCountedNode,
} from './jd-category-tree.ts'
import type { JdProductCategoryOption, JdProductGroup } from './jd-product-api.ts'
const props = defineProps<{
/** /categories 计数行(京麦末级类目+商品数;页面持有,失败静默回空数组)。 */
categoryOptions: JdProductCategoryOption[]
/** 当前数据权限分组的分类(V203 归属口径,带 productCount 徽标)。 */
categories: JdProductGroup[]
/** 当前分组分类可写(scope.editable 投影):可写档渲染「新建分类」行;
* 「分类管理」入口对所有人渲染(同组普通号只读可看,V203,写控件由对话框分档)。 */
editable: boolean
/** 当前类目选中(name+完整名称路径;树外历史名 path 为空数组;null=全部商品)。 */
selectedCategory?: { name: string; path: string[] } | null
/** 当前分类选中 id(null=全部分类)。 */
selectedGroupId?: number | null
}>()
const emit = defineEmits<{
/** 选类目:树内节点带完整路径(页面按子树展开类目名集合 IN 下发);树外兜底名
* path=[](序列化回落单名等值);null=「全部商品」清选重查。 */
(event: 'select-category', value: { name: string; path: string[] } | null): void
/** 选分类:分类 id;再点已选中的=清选(emit null,回全部分类)。 */
(event: 'select-group', id: number | null): void
/** 新建分类(可写档):页面调 createJdProductGroup 落当前分组,成功后刷新,
* 侧栏数据随 props 流回(本组件不感知成功/失败,输入框提交即清)。 */
(event: 'create-category', name: string): void
/** 打开分类管理对话框(建/改名/删+搜索,V204 并入的既有组件)。 */
(event: 'manage-categories'): void
}>()
/** 左 Tab 内置展示态:出厂停在「商品目录」(首屏主筛选面)。 */
const activeTab = ref<'catalog' | 'custom'>('catalog')
// ---------------- 计数聚合(Phase 1 纯函数) ----------------
const counted = computed(() => jdCategoryCountTree(props.categoryOptions ?? []))
/** 「全部商品」徽标=全部计数行求和(树内+树外=有类目名的商品总数;无类目名的行
* 不在任何类目筛选的命中集里,不计进任何徽标)。 */
const totalCount = computed(() =>
(props.categoryOptions ?? []).reduce((sum, row) => sum + (row.productCount || 0), 0))
/** 展开态:按路径串('/' 连接)记,含树外兜底组头。一级默认展开(二级可见)。 */
const expanded = ref<Set<string>>(new Set())
const expandKey = (path: string[]): string => path.join('/')
// 一级默认展开:init 时把每个一级的 key 放进集合。
for (const root of counted.value.roots) expanded.value.add(expandKey([root.name]))
// ---------------- 商品目录树:扁平渲染(深度缩进 + 祖先全展开才可见) ----------------
interface FlatNode {
node: JdCategoryCountedNode
path: string[]
depth: number
}
const flatTree = computed<FlatNode[]>(() => {
const out: FlatNode[] = []
const walk = (nodes: JdCategoryCountedNode[], depth: number, prefix: string[]): void => {
for (const node of nodes) {
const path = [...prefix, node.name]
out.push({ node, path, depth })
if (node.children.length && expanded.value.has(expandKey(path))) {
walk(node.children, depth + 1, path)
}
}
}
walk(counted.value.roots, 0, [])
return out
})
function toggleExpand(path: string[]): void {
const key = expandKey(path)
const next = new Set(expanded.value)
if (next.has(key)) next.delete(key)
else next.add(key)
expanded.value = next
}
/** 点树行=选中即筛;非末级行顺手展开(下钻感,与京麦列表筛选器同形;收起走箭头)。 */
function pickNode(node: FlatNode): void {
if (node.node.children.length && !expanded.value.has(expandKey(node.path))) {
toggleExpand(node.path)
}
emit('select-category', { name: node.node.name, path: node.path })
}
/** 外部选中态(重置/清选/页面回显):展开选中节点的全部祖先,让它可见。
* immediate=页面带着已激活的类目筛选挂载侧栏时(如切换回本页),选中路径直接展开到位。 */
watch(
() => props.selectedCategory,
(selected) => {
if (!selected || !selected.path.length) return
const next = new Set(expanded.value)
for (let i = 1; i < selected.path.length; i++) {
next.add(expandKey(selected.path.slice(0, i)))
}
expanded.value = next
},
{ immediate: true },
)
const isSelectedNode = (node: FlatNode): boolean => {
const selected = props.selectedCategory
if (!selected || selected.path.length !== node.path.length) return false
return selected.path.every((name, index) => name === node.path[index])
}
// ---------------- 树外兜底组(树上对不上的历史行,单名等值出口) ----------------
const extraOpen = ref(true)
function pickExtra(name: string): void {
// 树外名不进树:path 空数组=页面按「无路径」序列化(单名等值旧形状,不静默丢筛选)。
emit('select-category', { name, path: [] })
}
const isSelectedExtra = (name: string): boolean => {
const selected = props.selectedCategory
return !!selected && selected.path.length === 0 && selected.name === name
}
// ---------------- 店铺分类 Tab(当前分组分类平铺) ----------------
function pickGroup(group: JdProductGroup): void {
// 再点已选中的=清选(回全部分类),与旧「全部分类」下拉行的语义等价。
emit('select-group', props.selectedGroupId === group.id ? null : group.id)
}
const newCategoryName = ref('')
function submitCreate(): void {
const name = newCategoryName.value.trim()
if (!name) return
emit('create-category', name)
newCategoryName.value = ''
}
</script>
<template>
<aside class="jd-sidebar" aria-label="商品目录与店铺分类">
<div class="jd-sidebar-tabs" role="tablist">
<button
type="button"
role="tab"
:aria-selected="activeTab === 'catalog'"
class="jd-sidebar-tab"
:class="{ active: activeTab === 'catalog' }"
@click="activeTab = 'catalog'"
>商品目录</button>
<button
type="button"
role="tab"
:aria-selected="activeTab === 'custom'"
class="jd-sidebar-tab"
:class="{ active: activeTab === 'custom' }"
@click="activeTab = 'custom'"
>店铺分类</button>
</div>
<!-- 商品目录:全部商品 + 京麦授权类目树(计数徽标)+ 树外兜底组 -->
<div v-show="activeTab === 'catalog'" class="jd-sidebar-body jd-side-catalog">
<button
type="button"
class="jd-side-row jd-side-all"
:class="{ selected: !selectedCategory }"
@click="emit('select-category', null)"
>
<span class="jd-side-name">全部商品</span>
<span class="jd-side-count">{{ totalCount }}</span>
</button>
<div class="jd-side-tree">
<button
v-for="flat in flatTree"
:key="flat.path.join('/')"
type="button"
class="jd-side-row"
:class="[`depth-${flat.depth}`, { selected: isSelectedNode(flat) }]"
:title="flat.path.join(' / ')"
@click="pickNode(flat)"
>
<span
v-if="flat.node.children.length"
class="jd-side-arrow"
:class="{ open: expanded.has(flat.path.join('/')) }"
role="button"
:aria-label="`展开或收起 ${flat.node.name}`"
@click.stop="toggleExpand(flat.path)"
>▸</span>
<span v-else class="jd-side-leaf-dot" />
<span class="jd-side-name">{{ flat.node.name }}</span>
<span class="jd-side-count">{{ flat.node.count }}</span>
</button>
</div>
<div v-if="counted.extra.length" class="jd-side-extra">
<button
type="button"
class="jd-side-row jd-side-extra-head"
:aria-expanded="extraOpen"
@click="extraOpen = !extraOpen"
>
<span class="jd-side-name">树外兜底</span>
<span class="jd-side-count">{{ counted.extraTotal }}</span>
</button>
<template v-if="extraOpen">
<button
v-for="row in counted.extra"
:key="row.name"
type="button"
class="jd-side-row depth-1"
:class="{ selected: isSelectedExtra(row.name) }"
:title="row.name"
@click="pickExtra(row.name)"
>
<span class="jd-side-leaf-dot" />
<span class="jd-side-name">{{ row.name }}</span>
<span class="jd-side-count">{{ row.productCount }}</span>
</button>
</template>
</div>
</div>
<!-- 店铺分类:当前分组分类平铺 + 新建分类(可写档)+ 分类管理入口(所有人) -->
<div v-show="activeTab === 'custom'" class="jd-sidebar-body jd-side-custom">
<template v-if="categories.length">
<button
v-for="cat in categories"
:key="cat.id"
type="button"
class="jd-side-row"
:class="{ selected: selectedGroupId === cat.id }"
:title="cat.name"
@click="pickGroup(cat)"
>
<span class="jd-side-leaf-dot" />
<span class="jd-side-name">{{ cat.name }}</span>
<span class="jd-side-count">{{ cat.productCount }}</span>
</button>
</template>
<p v-else class="jd-side-empty">{{ editable ? '本组暂无分类,先新建一个' : '本组暂无分类' }}</p>
<div v-if="editable" class="jd-side-create">
<input
v-model="newCategoryName"
type="text"
placeholder="新分类名称"
aria-label="新分类名称"
@keyup.enter="submitCreate"
/>
<button type="button" :disabled="!newCategoryName.trim()" @click="submitCreate">新建分类</button>
</div>
<button type="button" class="jd-side-manage" @click="emit('manage-categories')">分类管理</button>
</div>
</aside>
</template>
<style scoped>
.jd-sidebar {
width: 232px;
flex-shrink: 0;
background: #fff;
border: 1px solid #e4e7ed;
border-radius: 8px;
overflow: hidden;
align-self: flex-start;
}
.jd-sidebar-tabs {
display: flex;
border-bottom: 1px solid #e4e7ed;
}
.jd-sidebar-tab {
flex: 1;
padding: 10px 0;
border: none;
background: transparent;
cursor: pointer;
font-size: 14px;
color: #606266;
}
.jd-sidebar-tab.active {
color: #409eff;
font-weight: 600;
box-shadow: inset 0 -2px 0 #409eff;
}
.jd-sidebar-body {
display: flex;
flex-direction: column;
max-height: 640px;
overflow-y: auto;
padding: 6px;
}
.jd-side-row {
display: flex;
align-items: center;
gap: 6px;
width: 100%;
padding: 6px 8px;
border: none;
background: transparent;
border-radius: 6px;
cursor: pointer;
font-size: 13px;
color: #303133;
text-align: left;
}
.jd-side-row:hover {
background: #f5f7fa;
}
.jd-side-row.selected {
background: #ecf5ff;
color: #409eff;
font-weight: 600;
}
.jd-side-row.depth-1 { padding-left: 22px; }
.jd-side-row.depth-2 { padding-left: 36px; }
.jd-side-row.depth-3 { padding-left: 50px; }
.jd-side-arrow {
width: 14px;
flex-shrink: 0;
color: #909399;
transition: transform 0.15s;
cursor: pointer;
}
.jd-side-arrow.open {
transform: rotate(90deg);
}
.jd-side-leaf-dot {
width: 14px;
flex-shrink: 0;
text-align: center;
color: #c0c4cc;
}
.jd-side-leaf-dot::before {
content: '·';
}
.jd-side-name {
flex: 1;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.jd-side-count {
flex-shrink: 0;
min-width: 24px;
text-align: right;
font-size: 12px;
color: #909399;
background: #f0f2f5;
border-radius: 10px;
padding: 1px 7px;
}
.jd-side-row.selected .jd-side-count {
color: #409eff;
background: #d9ecff;
}
.jd-side-extra {
margin-top: 4px;
border-top: 1px dashed #e4e7ed;
padding-top: 4px;
}
.jd-side-extra-head {
color: #909399;
}
.jd-side-empty {
margin: 8px 4px;
font-size: 13px;
color: #909399;
text-align: center;
}
.jd-side-create {
display: flex;
gap: 6px;
margin-top: 8px;
padding: 6px 4px;
border-top: 1px dashed #e4e7ed;
}
.jd-side-create input {
flex: 1;
min-width: 0;
padding: 5px 8px;
border: 1px solid #dcdfe6;
border-radius: 6px;
font-size: 13px;
}
.jd-side-create button {
padding: 5px 10px;
border: 1px solid #dcdfe6;
border-radius: 6px;
background: #fff;
cursor: pointer;
font-size: 13px;
color: #409eff;
}
.jd-side-create button:disabled {
color: #c0c4cc;
cursor: not-allowed;
}
.jd-side-manage {
margin-top: 8px;
padding: 6px 8px;
border: none;
border-top: 1px dashed #e4e7ed;
background: transparent;
color: #606266;
font-size: 13px;
cursor: pointer;
text-align: left;
}
.jd-side-manage:hover {
color: #409eff;
}
</style>