feat: 优化剧集连续阅读布局与目录滚动联动
This commit is contained in:
1 parent
3fe1b3f5c3
commit
a35f5fe82d
7 files changed
+540
-146
No files matched your search
@@ -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>
|
||||
Reference in new issue
Block a user