feat(short-drama-agent-front): 新增剧本骨架屏并优化阅读导出

This commit is contained in:
GJ committed 2026-10-10 23:12:59 +08:00
1 parent 54a381ebd3
commit 3cc65aa056
16 files changed
+792 -167

No files matched your search

+188 -22
View File
@@ -1,9 +1,10 @@
<script setup lang="ts">
import { NButton, NScrollbar, type ScrollbarInst } from 'naive-ui'
import { NButton, NDrawer, NDrawerContent, NScrollbar, type ScrollbarInst } from 'naive-ui'
import { ChevronLeft, ChevronRight, List } from '@lucide/vue'
import { computed, onBeforeUnmount, onMounted, ref, useId, watch } from 'vue'
import type { Episode } from '../projects/types'
/** 连续剧本阅读器:目录与正文独立滚动,导航仅影响本阅读器。 */
/** 连续剧本阅读器:宽屏目录与正文独立滚动,手机采用全宽正文与底部目录。 */
const props = defineProps<{ episodes: Episode[] }>()
const orderedEpisodes = computed(() => props.episodes.toSorted((a, b) => a.episode - b.episode))
const active = ref(orderedEpisodes.value[0]?.episode)
@@ -13,7 +14,14 @@ const directoryContent = ref<HTMLElement>()
const readerContent = ref<HTMLElement>()
const viewportHeight = ref(400)
const readerId = useId()
const readingInset = 32
/** 手机目录抽屉仅在用户点击目录时打开,不占用正文宽度。 */
const directoryOpen = ref(false)
/** 抽屉目录根节点,用于打开时定位到当前集。 */
const sheetContent = ref<HTMLElement>()
/** 当前集在有序目录中的位置,支持不连续的剧集编号。 */
const activeIndex = computed(() => orderedEpisodes.value.findIndex(item => item.episode === active.value))
/** 缓存正文顶部留白,目录跳转与当前集判断使用同一阅读线。 */
let readingInset = 32
let viewport: HTMLElement | null = null
let directoryViewport: HTMLElement | null = null
let observer: ResizeObserver | undefined
@@ -51,10 +59,11 @@ function syncActive() {
active.value = current
}
/** 内容或面板尺寸变化时重测;隐藏标签不覆盖缓存和已有阅读位置。 */
/** 内容或尺寸变化时同步实际顶部留白与章节位置;隐藏标签不覆盖已有阅读位置。 */
function measure() {
if (!viewport?.clientHeight || !readerContent.value) return
viewportHeight.value = viewport.clientHeight
readingInset = parseFloat(getComputedStyle(readerContent.value).paddingTop) || 32
const origin = viewport.getBoundingClientRect().top - viewport.scrollTop
positions = [...readerContent.value.querySelectorAll<HTMLElement>('[data-episode]')].map(item => ({
episode: Number(item.dataset.episode),
@@ -63,16 +72,39 @@ function measure() {
syncActive()
}
/** 点击目录使用组件公开方法即时定位,避免长距离平滑滚动经过多集时高亮闪烁。 */
/**
* 即时定位所选剧集并关闭手机目录,避免长距离平滑滚动造成高亮闪烁。
* @param episode 需要定位的剧集编号
*/
function selectEpisode(episode: number) {
measure()
const position = positions.find(item => item.episode === episode)
if (!position) return
reader.value?.scrollTo({ top: Math.max(0, position.top - readingInset), behavior: 'auto' })
active.value = episode
directoryOpen.value = false
revealActive()
}
/**
* 按目录顺序切换相邻剧集,首集和末集不越界。
* @param offset 上一集或下一集的相对位置
*/
function selectRelativeEpisode(offset: -1 | 1) {
const episode = orderedEpisodes.value[activeIndex.value + offset]
if (episode) selectEpisode(episode.episode)
}
/** 目录抽屉展开后露出当前集,只滚动抽屉内部列表。 */
function revealSheetActive() {
const item = sheetContent.value?.querySelector<HTMLElement>('[aria-current="location"]')
const scroll = scrollContainer(sheetContent.value)
if (!item || !scroll) return
scroll.scrollTo({
top: scroll.scrollTop + item.getBoundingClientRect().top - scroll.getBoundingClientRect().top - 8
})
}
watch(active, revealActive, { flush: 'post' })
watch(
orderedEpisodes,
@@ -83,6 +115,7 @@ watch(
{ flush: 'post', deep: true }
)
/** 挂载后测量阅读区域,尺寸变化时更新章节位置并关闭宽屏下的手机目录。 */
onMounted(() => {
viewport = scrollContainer(readerContent.value)
directoryViewport = scrollContainer(directoryContent.value)
@@ -96,6 +129,8 @@ onMounted(() => {
observer = new ResizeObserver(() => {
measure()
revealActive()
// 恢复宽屏布局时关闭手机目录,避免遮罩继续覆盖正文。
if (window.innerWidth > 800) directoryOpen.value = false
})
if (viewport) observer.observe(viewport)
if (readerContent.value) observer.observe(readerContent.value)
@@ -107,6 +142,7 @@ onBeforeUnmount(() => observer?.disconnect())
<template>
<div class="episode-reader">
<!-- 以下是宽屏分集目录模块 -->
<nav class="reader-directory" aria-label="剧集目录">
<div class="reader-directory-heading">
<h3>分集剧本</h3>
@@ -164,6 +200,79 @@ onBeforeUnmount(() => observer?.disconnect())
</div>
</NScrollbar>
</div>
<!-- 以下是手机底部章节导航模块,正文与导航分别占用独立空间 -->
<nav class="reader-mobile-navigation" aria-label="章节导航">
<NButton
quaternary
class="reader-directory-trigger"
aria-label="打开剧集目录"
aria-haspopup="dialog"
:aria-expanded="directoryOpen"
@click="directoryOpen = true"
>
<template #icon><List :size="18" aria-hidden="true" /></template>
目录
</NButton>
<span class="reader-mobile-position">第 {{ active }} 集 / 共 {{ orderedEpisodes.length }} 集</span>
<NButton
quaternary
class="icon-button reader-chapter-control"
aria-label="上一集"
:disabled="activeIndex <= 0"
@click="selectRelativeEpisode(-1)"
>
<template #icon><ChevronLeft :size="20" aria-hidden="true" /></template>
</NButton>
<NButton
quaternary
class="icon-button reader-chapter-control"
aria-label="下一集"
:disabled="activeIndex < 0 || activeIndex >= orderedEpisodes.length - 1"
@click="selectRelativeEpisode(1)"
>
<template #icon><ChevronRight :size="20" aria-hidden="true" /></template>
</NButton>
</nav>
<!-- 以下是手机分集目录抽屉模块,保留完整标题方便查找和跳转 -->
<NDrawer
v-model:show="directoryOpen"
placement="bottom"
height="min(70dvh, 560px)"
class="reader-directory-sheet"
@after-enter="revealSheetActive"
>
<!-- 列表正文取消左右内边距,让目录项背景铺满抽屉宽度 -->
<NDrawerContent
title="分集剧本"
closable
:native-scrollbar="false"
:body-content-style="{ padding: '0 0 max(12px, env(safe-area-inset-bottom))' }"
>
<!-- 以下是垂直居中的目录标题与总集数模块 -->
<template #header>
<div class="reader-sheet-heading">
<span class="reader-sheet-title">分集剧本</span>
<span class="reader-sheet-count">/ 共 {{ orderedEpisodes.length }} 集</span>
</div>
</template>
<div ref="sheetContent" class="reader-sheet-directory" role="navigation" aria-label="手机剧集目录">
<NButton
v-for="item in orderedEpisodes"
:key="item.episode"
quaternary
block
class="reader-episode-link reader-sheet-episode-link"
:class="{ active: active === item.episode }"
:aria-current="active === item.episode ? 'location' : undefined"
:aria-controls="`${readerId}-episode-${item.episode}`"
@click="selectEpisode(item.episode)"
>
<span class="reader-episode-label">第 {{ item.episode }} 集</span>
<span class="reader-episode-title">{{ item.title || '未命名剧集' }}</span>
</NButton>
</div>
</NDrawerContent>
</NDrawer>
</div>
</template>
@@ -186,14 +295,25 @@ onBeforeUnmount(() => observer?.disconnect())
@apply text-muted leading-[1.8] mb-[15px];
}
.episode-reader {
/* 正文与吸顶标题共用底色,切换主题后保持连续的阅读背景。 */
--reader-background: var(--app-surface);
@apply grid grid-cols-[clamp(190px,_22%,_240px)_minmax(0,_1fr)] h-full min-h-0 min-w-0 overflow-hidden;
container-type: inline-size;
}
:root:not([data-theme='dark']) .episode-reader {
/* 浅色正文增加浅灰底色,与白色页面区分。 */
--reader-background: var(--app-subtle);
}
.reader-directory {
@apply flex flex-col min-h-0 min-w-0 bg-(--app-subtle);
}
:root:not([data-theme='dark']) .reader-directory {
/* 浅色目录比正文深一级,明确区分章节导航和阅读区域。 */
@apply bg-(--app-control);
}
.reader-directory-heading {
@apply flex justify-between items-center shrink-0 gap-2 pt-[22px] px-5 pb-3.5 text-[13px];
/* 目录标题与剧集条目统一左侧留白。 */
@apply flex justify-between items-center shrink-0 gap-2 pt-[22px] px-3.5 pb-3.5 text-[13px];
}
.reader-directory-heading h3 {
@apply font-semibold;
@@ -223,7 +343,28 @@ onBeforeUnmount(() => observer?.disconnect())
@apply bg-(--app-selected) text-accent shadow-[inset_3px_0_var(--app-accent)];
}
.reader-page {
@apply min-w-0 min-h-0 overflow-hidden bg-(--app-surface);
@apply min-w-0 min-h-0 overflow-hidden bg-(--reader-background);
}
/* 手机导航只在窄屏显示,抽屉内容复用同一目录条目样式。 */
.reader-mobile-navigation {
display: none;
}
.reader-sheet-heading {
/* 标题与总集数共用一条垂直居中线,避免不同字号按基线错位。 */
@apply flex items-center gap-2 min-w-0;
}
.reader-sheet-title {
@apply text-sm leading-5;
}
.reader-sheet-count {
@apply text-xs leading-5 text-muted font-normal;
}
.reader-sheet-directory {
@apply flex flex-col gap-1.5 py-2;
}
.n-button.reader-sheet-episode-link {
/* 条目背景铺满整行,文字与抽屉标题保持同一左侧对齐线。 */
padding-inline: 24px;
}
.reader-scroll .n-scrollbar-container:focus-visible {
@apply outline-[2px_solid_var(--app-accent)] outline-offset-[-3px];
@@ -242,7 +383,7 @@ onBeforeUnmount(() => observer?.disconnect())
min-height: max(160px, calc(var(--reader-height) - 64px));
}
.reader-chapter-heading {
@apply sticky top-0 z-[2] mb-6 bg-(--app-surface);
@apply sticky top-0 z-[2] mb-6 bg-(--reader-background);
margin-inline: calc(var(--reader-gutter) * -1);
padding: 14px var(--reader-gutter) 18px;
}
@@ -259,29 +400,54 @@ onBeforeUnmount(() => observer?.disconnect())
}
@media (max-width: 800px) {
.episode-reader {
@apply grid-cols-[72px_minmax(0,_1fr)];
@apply flex flex-col;
}
.reader-directory-heading {
@apply flex-col items-start gap-0 pt-2.5 px-1.5 pb-2;
}
.reader-directory-heading h3 {
.reader-directory {
@apply hidden;
}
.n-button.reader-episode-link {
@apply min-h-11 py-2 px-1;
.reader-page {
@apply flex-1;
}
.n-button.reader-episode-link .n-button__content {
@apply items-center text-center;
.reader-mobile-navigation {
@apply flex items-center shrink-0 min-w-0 bg-(--app-subtle);
padding-bottom: env(safe-area-inset-bottom);
}
.reader-episode-title {
@apply hidden;
.reader-mobile-position {
@apply flex-1 min-w-0 truncate text-center text-xs text-muted px-1;
}
.reader-episode-label {
@apply text-[11px];
.n-button.reader-directory-trigger {
@apply h-11 px-3 text-xs;
}
.n-button.reader-chapter-control {
@apply w-11 min-w-11 h-11;
}
.n-button.reader-chapter-control:disabled,
.n-button.reader-chapter-control:disabled svg {
/* 首集与末集的边界按钮保留禁用行为,并明确以灰色图标显示。 */
color: var(--app-disabled-text);
}
.reader-content {
--reader-gutter: 18px;
@apply px-[18px];
/* 缩小手机阅读顶部留白,保持左右文字间距。 */
@apply px-[18px] py-3;
}
.reader-chapter + .reader-chapter {
@apply mt-8 pt-0;
}
.reader-chapter:last-child {
/* 与手机正文上下 12px 留白配合,短末集仍能定位到阅读线。 */
min-height: max(160px, calc(var(--reader-height) - 24px));
}
.reader-chapter-heading {
@apply mb-3;
padding-block: 8px;
}
.reader-chapter-heading p {
@apply mb-1;
}
.episode-reader .script-summary {
/* 标题后立即进入摘要,减少摘要与正文之间的空白。 */
@apply pt-0 pb-4 mb-4;
}
}
</style>