feat: 优化剧集连续阅读布局与目录滚动联动

This commit is contained in:
GouJ committed 2026-09-01 17:02:39 +08:00
1 parent 3fe1b3f5c3
commit a35f5fe82d
7 files changed
+540 -146

No files matched your search

+168
View File
@@ -0,0 +1,168 @@
<script setup lang="ts">
import { NButton, NScrollbar, type ScrollbarInst } from 'naive-ui'
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)
const directory = ref<ScrollbarInst>()
const reader = ref<ScrollbarInst>()
const directoryContent = ref<HTMLElement>()
const readerContent = ref<HTMLElement>()
const viewportHeight = ref(400)
const readerId = useId()
const readingInset = 32
let viewport: HTMLElement | null = null
let directoryViewport: HTMLElement | null = null
let observer: ResizeObserver | undefined
/** 缓存章节在正文滚动容器中的位置,滚动事件不逐集触发布局测量。 */
let positions: { episode: number; top: number }[] = []
/** Naive 的公开实例仅提供滚动方法;从自身内容定位容器,不访问私有实例或全局 DOM。 */
function scrollContainer(content: HTMLElement | undefined) {
return content?.closest<HTMLElement>('.n-scrollbar-container') ?? null
}
/** 只在当前目录项离开可见区时调整目录,避免带动页面或打断手动浏览目录。 */
function revealActive() {
const item = directoryContent.value?.querySelector<HTMLElement>(`[data-episode="${active.value}"]`)
if (!item || !directoryViewport?.clientHeight) return
const bounds = directoryViewport.getBoundingClientRect()
const rect = item.getBoundingClientRect()
if (rect.top < bounds.top + 8) {
directory.value?.scrollTo({ top: directoryViewport.scrollTop + rect.top - bounds.top - 8 })
} else if (rect.bottom > bounds.bottom - 8) {
directory.value?.scrollTo({ top: directoryViewport.scrollTop + rect.bottom - bounds.bottom + 8 })
}
}
/** 以正文顶部的阅读线确定当前集;末集保留足够高度,也能定位到顶部。 */
function syncActive() {
if (!viewport?.clientHeight || !positions.length) return
const readingLine = Math.max(0, viewport.scrollTop) + readingInset + 2
let current = positions[0]!.episode
for (const item of positions) {
if (item.top > readingLine) break
current = item.episode
}
active.value = current
}
/** 内容或面板尺寸变化时重测;隐藏标签不覆盖缓存和已有阅读位置。 */
function measure() {
if (!viewport?.clientHeight || !readerContent.value) return
viewportHeight.value = viewport.clientHeight
const origin = viewport.getBoundingClientRect().top - viewport.scrollTop
positions = [...readerContent.value.querySelectorAll<HTMLElement>('[data-episode]')].map(item => ({
episode: Number(item.dataset.episode),
top: item.getBoundingClientRect().top - origin
}))
syncActive()
}
/** 点击目录使用组件公开方法即时定位,避免长距离平滑滚动经过多集时高亮闪烁。 */
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
revealActive()
}
watch(active, revealActive, { flush: 'post' })
watch(
orderedEpisodes,
items => {
if (!items.some(item => item.episode === active.value)) active.value = items[0]?.episode
measure()
},
{ flush: 'post', deep: true }
)
onMounted(() => {
viewport = scrollContainer(readerContent.value)
directoryViewport = scrollContainer(directoryContent.value)
// 让键盘直接聚焦真正的滚动区域,方向键、PageDown 和 Home/End 均由浏览器处理。
if (viewport) {
viewport.tabIndex = 0
viewport.setAttribute('role', 'region')
viewport.setAttribute('aria-label', '全部剧集正文')
}
measure()
observer = new ResizeObserver(() => {
measure()
revealActive()
})
if (viewport) observer.observe(viewport)
if (readerContent.value) observer.observe(readerContent.value)
if (directoryViewport) observer.observe(directoryViewport)
})
onBeforeUnmount(() => observer?.disconnect())
</script>
<template>
<div class="episode-reader">
<nav class="reader-directory" aria-label="剧集目录">
<div class="reader-directory-heading">
<h3>分集剧本</h3>
<span>{{ orderedEpisodes.length }} 集</span>
</div>
<NScrollbar ref="directory" class="panel-scroll reader-directory-scroll">
<div ref="directoryContent" class="reader-directory-content">
<NButton
v-for="item in orderedEpisodes"
:key="item.episode"
quaternary
block
class="reader-episode-link"
:class="{ active: active === item.episode }"
:data-episode="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>
</NScrollbar>
</nav>
<div class="reader-page">
<NScrollbar ref="reader" class="panel-scroll reader-scroll" @scroll="syncActive">
<div ref="readerContent" class="reader-content" :style="{ '--reader-height': `${viewportHeight}px` }">
<section
v-for="item in orderedEpisodes"
:id="`${readerId}-episode-${item.episode}`"
:key="item.episode"
:data-episode="item.episode"
:aria-labelledby="`${readerId}-heading-${item.episode}`"
class="reader-chapter"
>
<header class="reader-chapter-heading">
<p>第 {{ item.episode }} 集</p>
<h2 :id="`${readerId}-heading-${item.episode}`">{{ item.title || '未命名剧集' }}</h2>
</header>
<p v-if="item.summary" class="script-summary">{{ item.summary }}</p>
<div v-if="item.content" class="script-body">{{ item.content }}</div>
<p v-else class="text-sm text-muted">本集正文尚未写入。</p>
<dl v-if="item.conflict || item.hook" class="script-notes">
<template v-if="item.conflict"
><dt>核心冲突</dt>
<dd>{{ item.conflict }}</dd></template
>
<template v-if="item.hook"
><dt>结尾钩子</dt>
<dd>{{ item.hook }}</dd></template
>
</dl>
</section>
</div>
</NScrollbar>
</div>
</div>
</template>