import { AfterViewInit, ChangeDetectionStrategy, Component, ElementRef, OnDestroy, effect, inject, input, model, output, signal, viewChild, } from '@angular/core'; /** * PDF 预览 —— 逐页 canvas 渲染(**懒渲染**)。 * * ## 借鉴(E:\work\lami\borin-academy-beta-version 的 pdf-preview 组件) * * 那套实现踩过坑,以下几条直接照搬,不做"优化": * * 1. **polyfill 必须 `Object.defineProperty(enumerable: false)` 注入** * —— 直接赋值会生成可枚举属性,触发 pdf.js 的 * 「unexpected enumerable properties」污染检查,加载直接失败。 * 2. **worker 地址带缓存版本号** —— 企微等内置浏览器会长期复用旧 worker。 * 3. **加载失败要能重试**,且错误文案要具体(不要只写"加载失败")。 * * ## 2026-10-30 重构(《预览面板重构-设计-20261030》) * - **懒渲染**:首屏页立即画,其余页用 IntersectionObserver 等进入视口附近才画; * 未渲染的页面显示同尺寸灰色骨架,滚动位置不跳。 * - **缩放上收**:缩放比例由宿主(app-file-preview)通过 `zoom` 模型驱动, * 本组件不再自带工具栏;页码与总页数通过 `page` / `pageCount` 模型回传宿主状态栏。 * * 未照搬的部分:双版本 legacy 降级(我们主用 pdf.js 6.x,现代浏览器足够; * 真遇到老内核再加,避免一开始就把复杂度堆上来)。 */ @Component({ selector: 'app-pdf-preview', changeDetection: ChangeDetectionStrategy.OnPush, template: `
@if (state() === 'loading') {

正在加载 PDF…

} @else if (state() === 'error') {

{{ error() }}

} @else {
}
`, styles: [ ` :host { display: block; height: 100%; } .pdf-wrap { display: flex; flex-direction: column; height: 100%; min-height: 0; } .pdf-state { flex: 1; display: grid; place-content: center; justify-items: center; gap: var(--sp-3); color: var(--muted); } .pdf-state .err { max-width: 420px; text-align: center; color: var(--danger); } .retry { min-height: var(--touch-min); padding: 0 var(--sp-4); border: 1px solid var(--edge); border-radius: var(--r-sm); background: var(--surface); color: var(--primary); cursor: pointer; } .pdf-scroll { /* * 🔴 flex:1 会让它在缩放后**仍然等于视口高度**,导致超出部分滚不到 * (实测:scale 130% 时 scrollHeight 恒为 506)。 * 这里改为按缩放比例反向撑高:可视高度 × 1/zoom = 缩放后的内容高度。 * --fp-scale 由宿主的 .fp-content 继承下来。 */ height: calc(100% / var(--fp-scale, 1)); min-height: 0; overflow: auto; background: var(--surface-2); padding: var(--sp-3); } /* 页面居中,canvas 宽度随缩放变化 */ .pdf-pages { display: grid; justify-items: center; align-content: start; gap: var(--sp-3); } .pdf-pages canvas { max-width: 100%; height: auto; box-shadow: var(--shadow-card); background: var(--surface); } /* 未渲染页的占位:与渲染后同尺寸,避免滚动位置跳动 */ .pdf-ph { display: grid; place-items: center; background: var(--surface); box-shadow: var(--shadow-card); color: var(--muted); font-size: var(--fs-12); } `, ], }) export class PdfPreviewComponent implements AfterViewInit, OnDestroy { readonly url = input.required(); readonly close = output(); /** * 缩放由宿主统一实现(2026-10-31):宿主把所有类型包进同一个 .fp-content 做 zoom, * 这里不再自己响应缩放,避免双重缩放与重复渲染。 */ /** 当前页(随滚动更新,回传给宿主状态栏) */ readonly page = model(1); /** 总页数(回传给宿主状态栏) */ readonly pageCount = model(0); readonly state = signal<'loading' | 'ready' | 'error'>('loading'); readonly error = signal(''); private readonly pagesEl = viewChild>('pages'); private readonly scrollEl = viewChild>('scroll'); private readonly host = inject(ElementRef); private doc: PdfDoc | null = null; /** 每页的渲染状态(含页面尺寸,重渲染时用) */ private pages: PageSlot[] = []; private observer: IntersectionObserver | null = null; /** 当前 fit 比例(容器宽 / 页面宽),缩放叠加在上面 */ private fit = 1; /** 防并发:缩放与懒渲染同时改 DOM */ private renderToken = 0; /** 上一次渲染用的 dpr(裁剪用) */ private readonly dpr = Math.min(window.devicePixelRatio || 1, 2); constructor() { effect(() => { const u = this.url(); if (u) void this.load(u); }); } reload(): void { void this.load(this.url()); } private async load(url: string): Promise { this.state.set('loading'); this.error.set(''); this.teardown(); try { installPdfjsCompatPolyfills(); // 懒加载:pdf.js 体积大,不进首屏 const pdfjs = await import('pdfjs-dist'); pdfjs.GlobalWorkerOptions.workerSrc = workerSrc(); const task = pdfjs.getDocument({ url, verbosity: pdfjs.VerbosityLevel?.ERRORS ?? 0, } as never); const doc = (await task.promise) as unknown as PdfDoc; this.doc = doc; this.state.set('ready'); /* * 等一帧:`@else` 分支(含 .pdf-pages 容器)在本 tick 之后才插入 DOM, * 立刻查会是 null。两帧更稳(首帧布局、次帧含样式)。 */ await nextFrames(2); if (this.state() !== 'ready' || this.doc !== doc) return; await this.buildPages(doc); } catch (e) { this.error.set(pdfErrorText(e)); this.state.set('error'); } } /** * 建立页面占位 + 懒渲染观察器。 * * 先取每页 viewport(只读尺寸,不解码内容),得到所有页的显示尺寸与总高度; * 再一次性插入骨架 div,让滚动条从一开始就是最终长度 —— 否则边渲染边撑高, * 用户一旦滚动就会被"追着跑"。 */ private async buildPages(doc: PdfDoc): Promise { const host = this.pagesEl()?.nativeElement; if (!host) return; const token = ++this.renderToken; host.innerHTML = ''; this.pages = []; const first = await doc.getPage(1); const vp1 = first.getViewport({ scale: 1 }); this.fit = calcFit(host, vp1.width); this.pageCount.set(doc.numPages); for (let i = 1; i <= doc.numPages; i++) { const el = document.createElement('div'); el.className = 'pdf-ph'; el.dataset['page'] = String(i); host.appendChild(el); this.pages.push({ el, canvas: null }); } // 占位尺寸按第一页的比例估算(PDF 常见统一页面尺寸) this.sizePlaceholders(vp1.width, vp1.height); if (token !== this.renderToken) return; // 观察器:进入视口前 600px 就渲染,滚动时不至于看见灰块 this.observer = new IntersectionObserver( (entries) => { for (const en of entries) { if (!en.isIntersecting) continue; const n = Number((en.target as HTMLElement).dataset['page']); void this.renderPage(n); } }, { root: this.scrollEl()?.nativeElement ?? null, rootMargin: '600px 0px' }, ); for (const p of this.pages) this.observer.observe(p.el); // 首屏页不等观察器回调,立即画(避免"加载完还是一片灰") await this.renderPage(1); } /** 按比例重排占位尺寸(缩放 / 首次构建共用) */ private sizePlaceholders(w: number, h: number): void { const scale = this.fit; const width = Math.floor(w * scale); const height = Math.floor(h * scale); for (const p of this.pages) { if (p.canvas) { p.canvas.style.width = `${width}px`; } else { p.el.style.width = `${width}px`; p.el.style.height = `${height}px`; } } } /** * 缩放:清掉所有画布,保留骨架,再让观察器重新播报可见页。 * * 不直接对 canvas 做 CSS scale —— 那只是放大图片,文字会糊; * 按新比例重新渲染才能保持矢量清晰度。 */ private async renderPage(n: number): Promise { const doc = this.doc; const slot = this.pages[n - 1]; if (!doc || !slot || slot.canvas) return; const token = this.renderToken; const page = await doc.getPage(n); if (token !== this.renderToken || slot.canvas) return; const vp1 = page.getViewport({ scale: 1 }); const display = this.fit; const viewport = page.getViewport({ scale: display * this.dpr }); const canvas = document.createElement('canvas'); canvas.width = Math.floor(viewport.width); canvas.height = Math.floor(viewport.height); canvas.style.width = `${Math.floor(vp1.width * display)}px`; const ctx = canvas.getContext('2d'); if (!ctx) return; await page.render({ canvasContext: ctx, viewport }).promise; if (token !== this.renderToken) return; // 画完替换骨架(骨架保持同尺寸,替换不引起回流) slot.el.replaceWith(canvas); slot.canvas = canvas; } /** 当前视口中央对应的页号(滚动时更新 page 模型) */ private visiblePage(): number { const sc = this.scrollEl()?.nativeElement; if (!sc || this.pages.length === 0) return this.page(); const mid = sc.scrollTop + sc.clientHeight / 2; let top = 0; let best = 1; for (let i = 0; i < this.pages.length; i++) { const el = this.pages[i].canvas ?? this.pages[i].el; const h = el.getBoundingClientRect().height; if (mid < top + h) return i + 1; top += h + 12; best = i + 1; } return best; } private onScroll(): void { const n = this.visiblePage(); if (n !== this.page()) this.page.set(n); } /** 滚动时更新页码(事件委托到容器的 scroll 事件) */ private scrollListener = (): void => this.onScroll(); ngAfterViewInit(): void { /* * 🔴 不用 viewChild 取 .pdf-scroll:就绪后几百毫秒它才由 @else 分支插入 DOM, * ngAfterViewInit 时还是 undefined,监听会静默挂不上(页码不更新)。 * 改为委托在宿主自身:子元素滚动不冒泡,但 scroll 事件在捕获阶段能经过 * host —— 这里用宿主原生监听 + 被动模式即可拿到所有子滚动。 */ this.host.nativeElement.addEventListener('scroll', this.scrollListener, { passive: true, capture: true, }); } ngOnDestroy(): void { this.host.nativeElement.removeEventListener('scroll', this.scrollListener, { capture: true }); this.teardown(); } private teardown(): void { this.observer?.disconnect(); this.observer = null; this.renderToken++; this.pages = []; try { this.doc?.destroy(); } catch { /* 销毁失败不影响后续 */ } this.doc = null; } } interface PdfDoc { numPages: number; getPage(n: number): Promise; destroy(): void; } interface PdfPage { getViewport(o: { scale: number }): { width: number; height: number }; render(o: { canvasContext: CanvasRenderingContext2D; viewport: unknown }): { promise: Promise }; } interface PageSlot { el: HTMLElement; canvas: HTMLCanvasElement | null; } /** * 容器宽 → fit 比例。 * * 🔴 容器刚插入 DOM 时 clientWidth 可能是 0 或极小(192px 那种), * 直接用它会把页面渲染得极小。这里给一个合理下限,并优先用面板宽度。 */ function calcFit(host: HTMLElement, pageWidth: number): number { const panel = host.closest('.fp-panel') as HTMLElement | null; const avail = Math.max(host.clientWidth, panel?.clientWidth ?? 0, 360) - 32; return Math.min(avail, 900) / pageWidth; } /** 等 n 帧(让 Angular 把新分支渲染进 DOM) */ function nextFrames(n: number): Promise { return new Promise((resolve) => { const step = (left: number): void => { if (left <= 0) return resolve(); requestAnimationFrame(() => step(left - 1)); }; step(n); }); } /** worker 地址带缓存版本(企微等内置浏览器会长期复用旧 worker) */ const WORKER_VERSION = '20261021-1'; function workerSrc(): string { return `${new URL('/pdf.worker.js', location.origin).toString()}?v=${WORKER_VERSION}`; } /** 错误文案要具体,不要只写"加载失败" */ function pdfErrorText(e: unknown): string { const msg = e instanceof Error ? e.message : String(e); if (/Password/i.test(msg)) return '这个 PDF 有密码保护,无法预览。可下载后用本地应用打开。'; if (/Invalid|corrupt/i.test(msg)) return 'PDF 文件可能已损坏,无法解析。'; if (/CORS|Failed to fetch|NetworkError/i.test(msg)) return '无法下载 PDF 文件(可能是跨域限制)。'; return `PDF 加载失败:${msg}`; } /** * pdf.js 在渲染路径直接调用 ES2022 `Array/String.prototype.at` 与 * ES2021 `String.prototype.replaceAll`,企微等老内核缺失 → 会抛 * "pattern.at is not a function"。 * * 🔴 必须 `defineProperty(enumerable: false)`:直接赋值生成可枚举属性, * 会触发 pdf.js 的 Array.prototype 污染检查,加载直接失败。 */ function installPdfjsCompatPolyfills(): void { const defineHidden = (obj: object, name: string, value: unknown): void => { Object.defineProperty(obj, name, { value, writable: true, configurable: true, enumerable: false }); }; const ap = Array.prototype as unknown as { at?: unknown }; if (typeof ap.at !== 'function') { defineHidden(Array.prototype, 'at', function (this: unknown[], i: number) { const k = i < 0 ? this.length + i : i; return k < 0 || k >= this.length ? undefined : this[k]; }); } const sp = String.prototype as unknown as { at?: unknown; replaceAll?: unknown }; if (typeof sp.at !== 'function') { defineHidden(String.prototype, 'at', function (this: string, i: number) { const k = i < 0 ? this.length + i : i; return k < 0 || k >= this.length ? undefined : this.charAt(k); }); } if (typeof sp.replaceAll !== 'function') { defineHidden(String.prototype, 'replaceAll', function (this: string, s: string, r: string) { return this.split(s).join(r); }); } /* * 🔴 `Promise.try`(ES2025)—— pdf.js 6.x 在消息通道里直接调用它。 * 实测报错:`TypeError: Promise.try is not a function`,表现为**永远卡在「正在加载」**。 * 参考项目没遇到这条,是因为它对老内核走了 3.11 legacy 兜底; * 我们只用 6.x,所以必须自己补。 */ const PP = Promise as unknown as { try?: unknown }; if (typeof PP.try !== 'function') { defineHidden(Promise, 'try', function (fn: (...a: unknown[]) => unknown, ...args: unknown[]) { return new Promise((resolve) => resolve(fn(...args))); }); } }