ImmersiveMode.astro
ImmersiveMode.astro
---
// src/components/ImmersiveMode.astro
// 沉浸式阅读模式:切换 body.immersive-mode,触发 CSS 过渡。
// - 右栏 outline 列宽 → 0,内容淡出
// - 正文加宽到 --immersive-read-width
// - 整页 max-width 放宽到 --immersive-page-max
// 仅 ≥1280px 生效;小屏拒绝启用并提示。
// 所有动画由 ModuleLayout <style> 里的 transition 驱动。
---
<div class="immersive-toast" role="status" aria-live="polite" hidden></div>
<script is:inline>
(function () {
const IMMERSIVE_KEY = 'pi-agent-book:immersive';
const HINT_SEEN_KEY = 'pi-agent-book:immersive-hint-seen';
const MQ_DESKTOP = window.matchMedia('(min-width: 1280px)');
const body = document.body;
const toast = document.querySelector('.immersive-toast');
function isDesktop() { return MQ_DESKTOP.matches; }
function setImmersive(on, opts) {
opts = opts || {};
if (on && !isDesktop()) {
showToast('沉浸模式仅在 ≥1280px 宽屏下可用');
return;
}
const isOn = body.classList.contains('immersive-mode');
if (isOn === on) return;
body.classList.toggle('immersive-mode', on);
try { localStorage.setItem(IMMERSIVE_KEY, String(on)); } catch (e) {}
document.querySelectorAll('[data-immersive-toggle]')
.forEach(b => b.setAttribute('aria-pressed', String(on)));
if (on && !opts.silent) maybeShowHint();
window.dispatchEvent(new CustomEvent('immersive:change', { detail: { on } }));
}
let toastTimer = null;
function showToast(msg, ms) {
if (!toast) return;
ms = ms || 3000;
toast.textContent = msg;
toast.hidden = false;
requestAnimationFrame(() => toast.classList.add('is-visible'));
if (toastTimer) clearTimeout(toastTimer);
toastTimer = setTimeout(() => {
toast.classList.remove('is-visible');
setTimeout(() => { toast.hidden = true; }, 240);
}, ms);
}
function maybeShowHint() {
try {
if (localStorage.getItem(HINT_SEEN_KEY) === 'true') return;
} catch (e) {}
showToast('沉浸模式 · 按 F 退出', 3000);
try { localStorage.setItem(HINT_SEEN_KEY, 'true'); } catch (e) {}
}
// 快捷键
document.addEventListener('keydown', (e) => {
const t = e.target;
const tag = t && t.tagName;
if (tag === 'INPUT' || tag === 'TEXTAREA' || (t && t.isContentEditable)) return;
if ((e.key === 'f' || e.key === 'F') && !e.ctrlKey && !e.metaKey && !e.altKey) {
e.preventDefault();
setImmersive(!body.classList.contains('immersive-mode'));
return;
}
if (e.key === 'Escape' && body.classList.contains('immersive-mode')) {
setImmersive(false);
}
});
// 顶栏按钮
document.addEventListener('click', (e) => {
if (e.target.closest('[data-immersive-toggle]')) {
e.preventDefault();
setImmersive(!body.classList.contains('immersive-mode'));
}
});
// 初始恢复
let initialWanted = false;
try { initialWanted = localStorage.getItem(IMMERSIVE_KEY) === 'true'; } catch (e) {}
if (initialWanted && isDesktop()) {
requestAnimationFrame(() => setImmersive(true, { silent: true }));
}
// 窗口缩小自动退出
MQ_DESKTOP.addEventListener('change', (ev) => {
if (!ev.matches && body.classList.contains('immersive-mode')) {
setImmersive(false);
showToast('屏幕变窄,已退出沉浸模式');
}
});
})();
</script>
<style is:global>
/* Toast:首次进入提示 */
.immersive-toast {
position: fixed;
left: 50%;
bottom: 32px;
transform: translateX(-50%) translateY(16px);
padding: var(--space-3) var(--space-5);
background: var(--ink-strong);
color: var(--paper);
font-family: var(--font-mono);
font-size: var(--fs-small);
letter-spacing: 0.04em;
border-radius: 9999px;
box-shadow: var(--shadow-3);
opacity: 0;
pointer-events: none;
transition: opacity var(--dur-base) var(--ease),
transform var(--dur-base) var(--ease);
z-index: 200;
max-width: 90vw;
}
.immersive-toast.is-visible {
opacity: 1;
transform: translateX(-50%) translateY(0);
}
@media (prefers-reduced-motion: reduce) {
.immersive-toast { transition-duration: 0.01ms; }
}
</style>