Skip to content

Wallpaper and Atmosphere

Aafff623 edited this page Aug 8, 2026 · 1 revision

Wallpaper-and-Atmosphere

壁纸基础模式与官方相同;本站多了 氛围层 atmosphere(官方 背景壁纸.md 没有这一节)。

配置:src/config/backgroundWallpaper.ts
出厂键表:docs/official/02-基础配置/背景壁纸.md

壁纸模式(与官方同构)

mode 含义
banner 横幅(常见)
fullscreen 全屏
overlay 全屏透明
none 纯色

图片 src.desktop / src.mobile 支持单图、数组随机、远程 API;路径规则见官方文档。

访客能否在设置里切模式:看 displaySettingsConfig(官方亦有说明)。

本站 carousel 习惯(示例,以配置为准)

  • 轮播可开;间隔、过渡效果(如 zoom)在 backgroundWallpaper 的 carousel 段
  • 改图:换资源路径或改数组项,然后本地预览横幅

氛围层(fork 专有)

atmosphere 独立于 mode:不是第四种 wallpaper mode。

典型能力:

概念 说明
垫底图 Banner 模式下正文区 fixed 氛围图
variants 多套氛围资源(常与横幅索引配对)
syncWithBanner 与横幅轮播同色同频(跟横幅事件,而非另起一套瞎转)
软过渡 靠 mask,不靠近白水波纹硬切

改氛围:

  1. 资源放入 public/assets/atmosphere/(或配置里写的路径)
  2. 编辑 backgroundWallpaper.atmosphere
  3. pnpm dev 看首页/文章区垫底是否跟横幅同步

术语摘录见主仓 CONTEXT.md「Banner 氛围层」。

背景视频

横幅背景视频与站点音乐互斥,见 Music-Player
开关与片源以 backgroundWallpaper / 播放器相关配置为准。

Clone this wiki locally