feat(short-drama-agent-front): 优化分镜界面并新增弹窗手势

This commit is contained in:
GJ committed 2026-11-18 18:50:15 +08:00
1 parent b15a6011ce
commit d68f03471c
59 files changed
+2694 -857

No files matched your search

+5 -1
View File
@@ -58,7 +58,11 @@ describe('管理后台组件边界', () => {
const assetPicker = /\.style-asset-picker\s*\{[^}]*\}/
expect(css.match(assetPicker)?.[0]).toContain('max-height: 280px;')
expect(css.match(assetPicker)?.[0]).toContain('overflow-y: auto;')
expect(css.replace(mobileReading, '').replace(assetPicker, '')).not.toMatch(
/** 图片详情浮层有独立高度上限,不让长错误改变卡片与页面高度。 */
const candidateDetails = /\.keyframe-card-details\s*\{[^}]*\}/
expect(css.match(candidateDetails)?.[0]).toContain('max-height: min(480px, 65dvh);')
expect(css.match(candidateDetails)?.[0]).toContain('overflow-y: auto;')
expect(css.replace(mobileReading, '').replace(assetPicker, '').replace(candidateDetails, '')).not.toMatch(
/overflow(?:-[xy])?\s*:\s*(?:auto|scroll)\b/
)
})
+216
View File
@@ -0,0 +1,216 @@
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import { afterEach, describe, expect, it, vi } from 'vitest'
import { NDrawer } from 'naive-ui'
import MobilePanelHandle from '@/components/ui/MobilePanelHandle.vue'
import AppDialog from '@/components/ui/AppDialog.vue'
import AppDrawer from '@/components/ui/AppDrawer.vue'
/** 当前测试挂载实例,结束后释放监听和计时。 */
let wrapper: VueWrapper | undefined
afterEach(() => {
wrapper?.unmount()
wrapper = undefined
document.body.innerHTML = ''
vi.useRealTimers()
vi.restoreAllMocks()
})
/**
* 明确模拟手机断点及旋转,动画偏好默认正常。
* @param initial 初始是否手机
* @returns 改变断点的方法
*/
function viewport(initial = true) {
let mobile = initial
const listeners = new Set<(event: MediaQueryListEvent) => void>()
vi.spyOn(window, 'matchMedia').mockImplementation(
query =>
({
media: query,
get matches() {
return query === '(max-width: 639px)' && mobile
},
onchange: null,
addEventListener: (_type: string, listener: EventListenerOrEventListenerObject) => {
if (query === '(max-width: 639px)') listeners.add(listener as (event: MediaQueryListEvent) => void)
},
removeEventListener: (_type: string, listener: EventListenerOrEventListenerObject) =>
listeners.delete(listener as (event: MediaQueryListEvent) => void),
addListener: vi.fn<() => void>(),
removeListener: vi.fn<() => void>(),
dispatchEvent: () => true
}) as MediaQueryList
)
return (next: boolean) => {
mobile = next
listeners.forEach(listener => listener({ matches: next } as MediaQueryListEvent))
}
}
/**
* 发送真实指针事件,显式指定时间以验证拖动距离和甩动速度。
* @param node 手柄或正文节点
* @param type 指针阶段
* @param y 当前纵坐标
* @param time 当前毫秒
* @param x 当前横坐标
* @param id 指针身份
*/
function pointer(node: Element, type: string, y: number, time: number, x = 10, id = 1) {
const event = new PointerEvent(type, {
bubbles: true,
cancelable: true,
pointerId: id,
isPrimary: id === 1,
button: 0,
clientX: x,
clientY: y
})
Object.defineProperty(event, 'timeStamp', { value: time })
node.dispatchEvent(event)
}
/** 创建一个真实面板容器,所有手势只作用于最近这一层。 */
function handle() {
viewport()
vi.useFakeTimers()
const panel = document.createElement('div')
panel.className = 'app-mobile-panel'
document.body.append(panel)
vi.spyOn(panel, 'getBoundingClientRect').mockReturnValue({ height: 600 } as DOMRect)
wrapper = mount(MobilePanelHandle, { attachTo: panel, props: { active: true } })
return { panel, grip: wrapper.get('button').element }
}
describe('手机面板手柄关闭', () => {
it('轻触、短拖和横向移动均回位,正文没有拖动关闭监听', async () => {
const { panel, grip } = handle()
pointer(grip, 'pointerdown', 0, 0)
pointer(grip, 'pointerup', 0, 100)
await vi.advanceTimersByTimeAsync(180)
pointer(grip, 'pointerdown', 0, 200)
pointer(grip, 'pointermove', 30, 500)
expect(panel.style.transform).toContain('30px')
pointer(grip, 'pointerup', 30, 800)
grip.dispatchEvent(new MouseEvent('click', { detail: 0, bubbles: true }))
await vi.advanceTimersByTimeAsync(180)
expect(panel.style.transform).toBe('')
pointer(grip, 'pointerdown', 0, 900)
pointer(grip, 'pointerup', 120, 950, 200)
await vi.advanceTimersByTimeAsync(180)
pointer(panel, 'pointerdown', 0, 1000)
pointer(panel, 'pointermove', 300, 1300)
pointer(panel, 'pointerup', 300, 1400)
expect(wrapper!.emitted('dismiss')).toBeUndefined()
})
it.each([
[160, 1000],
[64, 40]
])('明确下拉或快速甩动关闭一次:%s像素/%s毫秒', async (distance, time) => {
const { panel, grip } = handle()
pointer(grip, 'pointerdown', 0, 0)
pointer(grip, 'pointermove', distance, time)
pointer(grip, 'pointerup', distance, time)
expect(wrapper!.emitted('dismiss')).toBeUndefined()
await vi.advanceTimersByTimeAsync(180)
expect(wrapper!.emitted('dismiss')).toEqual([[]])
expect(panel.hasAttribute('data-drag-dismissed')).toBe(true)
pointer(grip, 'pointerup', distance, time + 1)
await vi.advanceTimersByTimeAsync(180)
expect(wrapper!.emitted('dismiss')).toHaveLength(1)
await wrapper!.setProps({ active: false })
await wrapper!.setProps({ active: true })
expect(panel.style.transform).toBe('')
expect(panel.hasAttribute('data-drag-dismissed')).toBe(false)
})
it.each(['pointercancel', 'lostpointercapture'])('系统取消%s时不关闭', async type => {
const { grip } = handle()
pointer(grip, 'pointerdown', 0, 0)
pointer(grip, 'pointermove', 200, 100)
pointer(grip, type, 200, 110)
await vi.advanceTimersByTimeAsync(180)
expect(wrapper!.emitted('dismiss')).toBeUndefined()
})
it('拖动中进入提交状态撤销手势,离场动画中加锁也不关闭', async () => {
const { grip } = handle()
pointer(grip, 'pointerdown', 0, 0)
pointer(grip, 'pointermove', 200, 100)
await wrapper!.setProps({ disabled: true })
pointer(grip, 'pointerup', 200, 120)
await vi.advanceTimersByTimeAsync(180)
expect(wrapper!.emitted('dismiss')).toBeUndefined()
await wrapper!.setProps({ disabled: false })
pointer(grip, 'pointerdown', 0, 500)
pointer(grip, 'pointerup', 200, 600)
await wrapper!.setProps({ disabled: true })
await vi.advanceTimersByTimeAsync(180)
expect(wrapper!.emitted('dismiss')).toBeUndefined()
})
it('额外触点不能接管主指针,向上拖动不关闭', async () => {
const { panel, grip } = handle()
pointer(grip, 'pointerdown', 100, 0)
pointer(grip, 'pointerdown', 0, 1, 10, 2)
pointer(grip, 'pointermove', 400, 30, 10, 2)
expect(panel.style.transform).toBe('')
pointer(grip, 'pointermove', 40, 100)
pointer(grip, 'pointerup', 40, 200)
await vi.advanceTimersByTimeAsync(180)
expect(wrapper!.emitted('dismiss')).toBeUndefined()
})
it.each([AppDialog, AppDrawer])('公共弹层复用手柄,提交锁与键盘关闭同时生效', async component => {
viewport()
wrapper = mount(component, {
attachTo: document.body,
props: { open: true, title: '隔离弹窗', busy: true },
slots: { default: '<p>原正文保持</p>' }
})
await flushPromises()
const grip = document.querySelector<HTMLButtonElement>('.mobile-panel-handle')!
expect(grip.disabled).toBe(true)
expect(document.querySelector('.app-mobile-panel')?.textContent).toContain('原正文保持')
await wrapper.setProps({ busy: false })
grip.dispatchEvent(new MouseEvent('click', { detail: 0, bubbles: true }))
expect(wrapper.emitted('update:open')?.at(-1)).toEqual([false])
})
it('切回桌面时清除正在拖动的位移,继续沿用原抽屉布局', async () => {
const changeViewport = viewport()
wrapper = mount(AppDrawer, { attachTo: document.body, props: { open: true, title: '隔离抽屉' } })
await flushPromises()
expect(wrapper.getComponent(NDrawer).props('placement')).toBe('bottom')
const grip = document.querySelector('.mobile-panel-handle')!,
panel = document.querySelector<HTMLElement>('.app-mobile-panel')!
pointer(grip, 'pointerdown', 0, 0)
pointer(grip, 'pointermove', 90, 100)
expect(panel.style.transform).toContain('90px')
changeViewport(false)
await flushPromises()
expect(wrapper.getComponent(NDrawer).props('placement')).toBe('right')
expect(document.querySelector('.mobile-panel-handle')).toBeNull()
expect(panel.style.transform).toBe('')
expect(wrapper.emitted('update:open')).toBeUndefined()
})
it.each([AppDialog, AppDrawer])('正文滚动才显示标题阴影,回到顶部和重新打开均清除', async component => {
viewport()
wrapper = mount(component, {
attachTo: document.body,
props: { open: true, title: '滚动阴影' },
slots: { default: '<p>长正文</p>' }
})
await flushPromises()
const frame = document.querySelector<HTMLElement>('.app-mobile-panel')!
const scroll = frame.querySelector<HTMLElement>('.n-scrollbar-container')!
expect(frame.classList.contains('has-body-scroll')).toBe(false)
Object.defineProperty(scroll, 'scrollTop', { value: 80, writable: true })
scroll.dispatchEvent(new Event('scroll'))
await flushPromises()
expect(frame.classList.contains('has-body-scroll')).toBe(true)
scroll.scrollTop = 0
scroll.dispatchEvent(new Event('scroll'))
await flushPromises()
expect(frame.classList.contains('has-body-scroll')).toBe(false)
scroll.scrollTop = 60
scroll.dispatchEvent(new Event('scroll'))
await flushPromises()
await wrapper.setProps({ open: false })
await wrapper.setProps({ open: true })
await flushPromises()
expect(document.querySelector('.app-mobile-panel')?.classList.contains('has-body-scroll')).toBe(false)
})
})
@@ -0,0 +1,96 @@
import { type Component } from 'vue'
import { flushPromises, mount } from '@vue/test-utils'
import { describe, expect, it } from 'vitest'
import AppDialog from '@/components/ui/AppDialog.vue'
import AppDrawer from '@/components/ui/AppDrawer.vue'
import WorkspaceSectionHeading from '@/components/ui/WorkspaceSectionHeading.vue'
import FieldLabel from '@/components/ui/FieldLabel.vue'
import ImageGenerationPreview from '@/features/subject-images/components/ImageGenerationPreview.vue'
import { imagePreviewFixture } from '../../fixtures/image-preview'
/** 各种公共标题保持相同的说明入口,动态状态不被隐藏。 */
const cases: Array<{
/** 当前公共布局。 */ component: Component
/** 可访问说明名称。 */ label: string
/** 原布局需要的显隐参数。 */ extra: Record<string, unknown>
}> = [
{ component: AppDialog, label: '操作说明', extra: { open: true } },
{ component: AppDrawer, label: '操作说明', extra: { open: true } },
{ component: WorkspaceSectionHeading, label: '审核范围说明', extra: {} }
]
describe('分镜界面按需显示说明', () => {
it.each(cases)('$label 首屏保留标题,完整说明由用户主动展开', async ({ component, label, extra }) => {
const wrapper = mount(component, {
props: {
...extra,
title: '审核范围',
description: '完整操作说明应能保留并随时核对',
descriptionAsInfo: true
},
global: { stubs: { teleport: true } }
})
try {
await flushPromises()
expect(wrapper.text()).toContain('审核范围')
expect(wrapper.text()).not.toContain('完整操作说明应能保留')
await wrapper.get(`button[aria-label="${label}"]`).trigger('click')
await flushPromises()
expect(wrapper.text()).toContain('完整操作说明应能保留并随时核对')
} finally {
wrapper.unmount()
}
})
it('动态状态插槽直接显示,不能被静态说明收起选项隐藏', async () => {
const wrapper = mount(AppDialog, {
props: { open: true, title: '原任务', description: '流程说明', descriptionAsInfo: true },
slots: { description: '<p>当前费用未知,请核查原请求</p>' },
global: { stubs: { teleport: true } }
})
try {
await flushPromises()
expect(wrapper.text()).toContain('当前费用未知,请核查原请求')
expect(wrapper.find('button[aria-label="操作说明"]').exists()).toBe(false)
} finally {
wrapper.unmount()
}
})
it('视觉重点等创作内容原样展示,不被系统术语转换改写', async () => {
const original = 'Prompt 是角色在画面中写下的原始台词'
const wrapper = mount(FieldLabel, {
props: { label: '视觉重点', description: original, iconOnly: true, icon: 'info', verbatim: true },
global: { stubs: { teleport: true } }
})
try {
expect(wrapper.text()).not.toContain(original)
await wrapper.get('button').trigger('click')
await flushPromises()
expect(wrapper.text()).toContain(original)
} finally {
wrapper.unmount()
}
})
it('图片预览先显示参考与主要操作,完整提示词仍可主动核对', async () => {
const original = '必须完整保留的画面描述,'.repeat(30)
const wrapper = mount(ImageGenerationPreview, {
props: {
preview: { ...imagePreviewFixture(), providerPrompt: original },
loading: false,
error: '',
staleNotice: ''
}
})
try {
expect(wrapper.text()).toContain('预览实际生成输入')
expect(wrapper.text()).not.toContain(original)
await wrapper
.findAll('.n-collapse-item__header-main')
.find(row => row.text() === '本次实际使用的画面描述')!
.trigger('click')
await flushPromises()
expect(wrapper.text()).toContain(original)
} finally {
wrapper.unmount()
}
})
})