feat(jd): 京东数据库与建单页类目面板换京麦授权类目真树(2026-11-16 客户拍板「京麦类目是这些 我们后台的现在的不对」+「你直接爬」)

真机取证京麦首屏接口 getVenderLicenseCategory(62KB:一级就 3 个=该店铺授权经营类目 服饰内衣1315/母婴1319/运动户外1318,250 个末级,最深 4 级;落库末级名样本「艺考形体服/啦啦队服/拉丁舞服」都在树内 level 3=category_path 等值过滤契约成立;4 组末级同名跨支如实登记,取证件 D:/tmp/jd_cat_probe/)。两份 jd-category-tree.ts 正本同轮重写;JdCategoryCascader 重做京麦同款逐级下钻+末级选中(admin 单选过滤/建单页多选 categoryPaths),搜索搜树内末级(行 title 带路径)+树外兜底段(京麦树已无的历史名仍可选);建单页 hint 文案随真树口径更新。判据:vue-tsc×2 rc=0;node --test 树测试 6/6×2+jd-collect-tab 9/9;vitest admin mount 28/28、用户端 mount 78/78(「勾选类目」用例改真树下钻 运动户外>舞蹈体操鞋服/装备>艺考形体服);fast 闸门 overall=pass 四面绿
This commit is contained in:
2026-11-16 12:16:18 +08:00
parent 7b853a605e
commit c9ecae6e6d
8 changed files with 685 additions and 320 deletions
+172 -100
View File
@@ -1,24 +1,28 @@
<script setup lang="ts">
/** 建单页「采集类目」多选级联面板(2026-11-16 客户口径「客户端前端也要同步加上京东类目」)。
/** 建单页「采集类目」多选级联面板(2026-11-16 客户口径「京麦类目是这些 我们后台的现在
* 的不对」+「你直接爬」→ 树数据换成京麦授权类目真树,见 ./jd-category-tree.ts 头注释
* 的取证来源与边界;面板形状与后管筛选面板同款,两处差异:① **多选**——末级行点击=
* toggle(方点 checkbox),「全部类目」行=清空,触发框显示「已选 N 个类目」;
* ② 触发框配色按本页暗色主题适配(面板本体仍是白底弹层)。
*
* 形状照后管京东数据库的筛选面板(admin-frontend-vue/src/pages/jd/JdCategoryCascader.vue,
* 京麦同款三栏:一级静态导航 / 二级纯导航 / 第三栏已落库末级全集+搜索),两处差异:
* ① **多选**——第三栏行点击=toggle(方点 checkbox),「全部类目」行=清空,触发框显示
* 「已选 N 个类目」;② 触发框配色按本页暗色主题适配(面板本体仍是白底弹层)。
*
* 数据边界与后管同源(见 ./jd-category-tree.ts 头注释):采集链只有末级类目名,一/二级
* 不参与过滤;第三栏选项=/api/jd-collect/categories 现算的公共库已落库全集,从未采集过
* 的店铺类目不在集内(先全店采一次即有)。选中值随建单走 categoryPaths → 客户端按
* categoryPath 等值过滤。零依赖自绘(方点/箭头都是 CSS),无 element 依赖。
*
* 交互:点开面板 → 点/hover 一级展第二栏 → 第三栏搜索或点行勾选/取消 → 收面板;
* 「全部类目」行=清空;触发框已选时出 × 清除;面板外点透明遮罩关闭。 */
* 交互(京麦真机同款,2026-11-16 面板逐级点开取证):面板按点亮路径动态出栏——第一栏
* 一级(3 个)、后续栏=点亮节点的 children(最深 4 栏);**非末级行点击=下钻**、
* **末级行(children 空)点击=toggle 勾选**(随建单走 categoryPaths → 客户端按
* categoryPath 等值过滤)。搜索框搜树内全部末级(行 title 带全路径);树外命中(已
* 落库但京麦类目体系变更后的历史名)从 options 兜底段选。面板是 fixed 浮层(窄触发框
* 不撑文档横向滚动),打开瞬间按触发框实际位置定位。零依赖自绘,无 element 依赖。 */
import { computed, ref } from 'vue'
import { jdCategoryNavChildren, jdCategoryNavRoots } from './jd-category-tree.ts'
import {
jdCategoryChildren,
jdCategoryRoots,
jdCategorySearchLeaves,
type JdCategoryNode,
} from './jd-category-tree.ts'
const props = defineProps<{
/** 已落库末级类目选项(/api/jd-collect/categories 现算,页面传入:{name, productCount})。 */
options: { name: string; productCount: number }[]
/** 已落库末级类目全集(/api/jd-collect/categories 现算)——只作**树外兜底**(搜索无
* 树内命中时列出「已落库类目(树外历史)」段),不再默认铺第三栏。 */
options?: { name: string; productCount: number }[]
/** 当前选中的末级类目名列表;空数组 = 全部类目(全店采集)。 */
modelValue: string[]
}>()
@@ -26,22 +30,46 @@ const props = defineProps<{
const emit = defineEmits<{ (event: 'change', value: string[]): void }>()
const open = ref(false)
const activeRoot = ref('')
/** 已下钻的节点名路径(非末级行点击推进)。 */
const activePath = ref<string[]>([])
const searchText = ref('')
/** 触发框元素:打开面板瞬间按它的实际位置给浮层定位(fixed 不撑文档横向滚动)。 */
const triggerRef = ref<HTMLElement | null>(null)
/** 面板浮层定位(fixed 的 top/left,px 字符串)。 */
const panelPos = ref({ top: '0px', left: '0px' })
const roots = jdCategoryNavRoots()
/** 第二栏=点亮一级的静态二级;无静态子级的一级不出第二栏。 */
const activeChildren = computed(() => jdCategoryNavChildren(activeRoot.value))
const roots = jdCategoryRoots()
/** 树内全部末级名集合(判定 options 哪些是「树外历史」)。 */
const treeLeafNames = new Set(
jdCategorySearchLeaves('').map((leaf) => leaf.name),
)
/** 第三栏=已落库末级全集按搜索词过滤(大小写不敏感的 includes)。 */
const filteredLeaves = computed(() => {
/** 面板各栏内容:第 0 栏一级,第 i+1 栏=点亮路径前 i+1 个的 children(栏数随路径动态 1~4)。 */
const columns = computed<JdCategoryNode[][]>(() => {
const cols: JdCategoryNode[][] = [roots]
for (let i = 0; i < activePath.value.length; i++) {
const children = jdCategoryChildren(activePath.value.slice(0, i + 1))
if (!children.length) break
cols.push(children)
}
return cols
})
/** 搜索激活=搜索词非空:面板切换成扁平末级结果列表。 */
const searching = computed(() => searchText.value.trim().length > 0)
/** 树内命中末级(名称或路径段命中)。 */
const searchLeaves = computed(() =>
searching.value ? jdCategorySearchLeaves(searchText.value) : [],
)
/** 树外兜底:options 里不在树名集的行按搜索词过滤(历史行仍可勾选过滤)。 */
const fallbackOptions = computed(() => {
if (!searching.value) return []
const keyword = searchText.value.trim().toLowerCase()
if (!keyword) return props.options
return props.options.filter((option) => option.name.toLowerCase().includes(keyword))
return (props.options ?? [])
.filter((option) => !treeLeafNames.has(option.name))
.filter((option) => option.name.toLowerCase().includes(keyword))
})
/** 触发框文案:空=全店采集;一个=类目名;多个=已选 N 个类目(title 列全名)。 */
@@ -57,10 +85,10 @@ function toggle(): void {
close()
return
}
activeRoot.value = ''
activePath.value = []
searchText.value = ''
// 面板是 fixed 浮层(京麦本尊形态:窄触发框 + 视口级宽面板,不撑文档横向滚动条),
// 打开瞬间按触发框实际位置定位;测试环境无真实布局时 rect 全 0,top/left 落在视口原点即可。
// 面板是 fixed 浮层:打开瞬间按触发框实际位置定位;测试环境无真实布局时 rect 全 0,
// top/left 落在视口原点即可。
const rect = triggerRef.value?.getBoundingClientRect()
if (rect) {
const width = Math.min(652, Math.max(320, window.innerWidth - 24))
@@ -74,11 +102,16 @@ function toggle(): void {
function close(): void {
open.value = false
activeRoot.value = ''
activePath.value = []
}
function pickRoot(name: string): void {
activeRoot.value = name
/** 非末级行点击=下钻;末级行点击=toggle 勾选(多选,不收面板,连续勾多个)。 */
function pick(node: JdCategoryNode, depth: number): void {
if (node.children && node.children.length) {
activePath.value = [...activePath.value.slice(0, depth), node.name]
return
}
toggleLeaf(node.name)
}
function clearAll(): void {
@@ -86,7 +119,7 @@ function clearAll(): void {
close()
}
/** 第三栏行点击=toggle(多选);勾选状态由页面传入的 modelValue 决定。 */
/** 叶子勾选/取消(同名跨支叶子是同一个过滤值,选中态共享)。 */
function toggleLeaf(name: string): void {
const picked = props.modelValue.includes(name)
? props.modelValue.filter((item) => item !== name)
@@ -94,6 +127,11 @@ function toggleLeaf(name: string): void {
emit('change', picked)
}
/** 搜索结果行点击=toggle 勾选(不收面板,连续勾多个)。 */
function pickName(name: string): void {
toggleLeaf(name)
}
function clear(): void {
emit('change', [])
}
@@ -123,67 +161,88 @@ function clear(): void {
<!-- 面板外点透明遮罩关闭(零 document 监听器,无泄漏面)。 -->
<div v-if="open" class="cat-mask" @click="close"></div>
<div v-if="open" class="cat-panel" :style="panelPos">
<!-- 第一栏:静态一级导航(radio 形状照京麦,点选只展开不落值)。 -->
<div class="cat-col">
<div
v-for="root in roots"
:key="root"
class="cat-row"
:class="{ active: activeRoot === root }"
@click="pickRoot(root)"
@mouseenter="pickRoot(root)"
>
<span class="cat-dot" aria-hidden="true"></span>
<span class="cat-name" :title="root">{{ root }}</span>
<span v-if="jdCategoryNavChildren(root).length" class="cat-arrow" aria-hidden="true">›</span>
<!-- 搜索态:树内末级命中+树外兜底段(扁平列表,行 title 带全路径)。 -->
<template v-if="searching">
<div class="cat-col cat-col-search">
<template v-if="searchLeaves.length || fallbackOptions.length">
<div
v-for="leaf in searchLeaves"
:key="`tree-${leaf.path.join('/')}`"
class="cat-row"
:class="{ active: modelValue.includes(leaf.name) }"
:title="leaf.path.join(' > ')"
@click="pickName(leaf.name)"
>
<span
class="cat-dot cat-dot-check"
:class="{ on: modelValue.includes(leaf.name) }"
aria-hidden="true"
></span>
<span class="cat-name">{{ leaf.name }}</span>
<span class="cat-path">{{ leaf.path.slice(0, -1).join(' › ') }}</span>
</div>
<div v-if="fallbackOptions.length" class="cat-seg">已落库类目(树外历史)</div>
<div
v-for="option in fallbackOptions"
:key="`db-${option.name}`"
class="cat-row"
:class="{ active: modelValue.includes(option.name) }"
:title="option.name"
@click="pickName(option.name)"
>
<span
class="cat-dot cat-dot-check"
:class="{ on: modelValue.includes(option.name) }"
aria-hidden="true"
></span>
<span class="cat-name">{{ option.name }}</span>
<span class="cat-count">{{ option.productCount }}</span>
</div>
</template>
<div v-else class="cat-empty">未找到类目</div>
</div>
</div>
</template>
<!-- 第二栏:点亮一级的静态二级(纯导航;归属数据缺,不联动第三栏——组件头注释)。 -->
<div v-if="activeChildren.length" class="cat-col">
<!-- 下钻态:逐级动态栏;首栏顶部搜索框+「全部类目」行=清空。 -->
<template v-else>
<div
v-for="child in activeChildren"
:key="child"
class="cat-row"
v-for="(col, depth) in columns"
:key="depth"
class="cat-col"
>
<span class="cat-dot" aria-hidden="true"></span>
<span class="cat-name" :title="child">{{ child }}</span>
<span class="cat-arrow" aria-hidden="true">›</span>
<div v-if="depth === 0" class="cat-search-row">
<input
v-model="searchText"
type="text"
class="cat-search"
placeholder="搜索类目"
@click.stop
/>
</div>
<div v-if="depth === 0" class="cat-row cat-row-all" :class="{ active: !modelValue.length }" @click="clearAll">
<span class="cat-dot" :class="{ on: !modelValue.length }" aria-hidden="true"></span>
<span class="cat-name">全部类目(全店采集)</span>
</div>
<div
v-for="node in col"
:key="`${depth}-${node.name}`"
class="cat-row"
:class="{ active: activePath[depth] === node.name || (depth === 0 && modelValue.includes(node.name)) }"
:title="node.name"
@click="pick(node, depth)"
>
<span
v-if="!node.children || !node.children.length"
class="cat-dot cat-dot-check"
:class="{ on: modelValue.includes(node.name) }"
aria-hidden="true"
></span>
<span v-else class="cat-dot" aria-hidden="true"></span>
<span class="cat-name">{{ node.name }}</span>
<span v-if="node.children && node.children.length" class="cat-arrow" aria-hidden="true">›</span>
</div>
</div>
</div>
<!-- 第三栏:已落库末级全集+搜索(选中发生地;点行=勾选/取消,随建单走 categoryPaths)。 -->
<div class="cat-col cat-col-leaf">
<div class="cat-row cat-row-all" :class="{ active: !modelValue.length }" @click="clearAll">
<span class="cat-dot" :class="{ on: !modelValue.length }" aria-hidden="true"></span>
<span class="cat-name">全部类目(全店采集)</span>
</div>
<input
v-model="searchText"
type="text"
class="cat-search"
placeholder="搜索类目"
@click.stop
/>
<div v-if="!filteredLeaves.length" class="cat-empty">
{{ options.length ? '未找到类目' : '暂无可选类目:先全店采集一次,落库后这里出选项' }}
</div>
<div
v-for="leaf in filteredLeaves"
:key="leaf.name"
class="cat-row"
:class="{ active: modelValue.includes(leaf.name) }"
@click="toggleLeaf(leaf.name)"
>
<span
class="cat-dot cat-dot-check"
:class="{ on: modelValue.includes(leaf.name) }"
aria-hidden="true"
></span>
<span class="cat-name" :title="leaf.name">{{ leaf.name }}</span>
<span class="cat-count">{{ leaf.productCount }}</span>
</div>
</div>
</template>
</div>
</div>
</template>
@@ -265,10 +324,9 @@ function clear(): void {
}
.cat-panel {
/* fixed 浮层:位置由 toggle() 按触发框实际位置写 :style(top/left)。
* 建单页侧栏只有 ~370px,贴容器宽会把三栏压到每栏 ~120px(一级名截成「服饰…」);
* 三栏内容 200+200+250=650,宽度固定 652 向右展开,fixed 不撑文档横向滚动条。 */
* 宽度随栏数自适应(200/栏 + 搜索态 300),cap 652 不撑文档横向滚动条。 */
position: fixed;
width: min(652px, calc(100vw - 16px));
max-width: min(860px, calc(100vw - 16px));
z-index: 2560;
display: flex;
align-items: stretch;
@@ -288,8 +346,8 @@ function clear(): void {
.cat-col:last-child {
border-right: 0;
}
.cat-col-leaf {
width: 250px;
.cat-col-search {
width: 300px;
}
/* 行=京麦同款:圆点 + 名称 + 右箭头;hover 浅蓝底。 */
.cat-row {
@@ -317,12 +375,7 @@ function clear(): void {
border-radius: 50%;
background: #ffffff;
}
/* radio 选中=京麦同款蓝芯;一级/二级的圆点是导航形状,不落选中态。 */
.cat-dot.on {
border-color: #3b82c4;
background: radial-gradient(circle, #3b82c4 0 4px, #ffffff 4.6px);
}
/* 第三栏多选=方点 checkbox(与第一/二栏的导航圆点区分形状)。 */
/* 导航圆点(非末级)=纯形状;末级=方点 checkbox。 */
.cat-dot-check {
border-radius: 3px;
}
@@ -348,6 +401,16 @@ function clear(): void {
text-overflow: ellipsis;
white-space: nowrap;
}
/* 搜索态行尾的路径灰字(同名跨支时定位用)。 */
.cat-path {
flex: none;
max-width: 110px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
color: #9fb0c0;
font-size: 12px;
}
.cat-arrow {
flex: none;
color: #9fb0c0;
@@ -359,10 +422,19 @@ function clear(): void {
color: #8293a5;
font-size: 12px;
}
.cat-seg {
padding: 8px 12px 4px;
color: #8293a5;
font-size: 11.5px;
border-top: 1px solid #e7eef5;
}
.cat-search-row {
padding: 4px 8px 6px;
border-bottom: 1px solid #e7eef5;
}
.cat-search {
display: block;
width: calc(100% - 20px);
margin: 4px 10px 8px;
width: 100%;
min-height: 30px;
padding: 4px 10px;
border: 1px solid #cbd9e6;
+1 -1
View File
@@ -437,7 +437,7 @@ onUnmounted(() => {
<p class="category-hint">
{{ selectedCategories.length
? `只采选中 ${selectedCategories.length} 个类目的商品;清空恢复全店采集。`
: '不选=全店采集。选项来自「京东数据库」已落库类目,新店铺先全店采一次即出。' }}
: '不选=全店采集。类目树与京麦后台一致(按店铺授权类目逐级下钻到末级)。' }}
</p>
</div>
File diff suppressed because one or more lines are too long