From 005d8923e4fa9431936d43876be6f8dbd45bfd98 Mon Sep 17 00:00:00 2001
From: Ad-closeNN <1709301095@qq.com>
Date: Sat, 2 May 2026 13:34:18 +0800
Subject: [PATCH] =?UTF-8?q?feat(theme):=20=E5=9B=BE=E7=89=87=E5=8A=A0?=
 =?UTF-8?q?=E8=BD=BD=E5=8A=A8=E7=94=BB=E3=80=81Blur?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/PostCard.astro          |  2 +-
 src/components/misc/ImageWrapper.astro |  6 +-
 src/layouts/Layout.astro               | 82 ++++++++++++++++++++++++++
 src/layouts/MainGridLayout.astro       |  2 +-
 src/pages/posts/[...slug].astro        |  4 +-
 src/styles/main.css                    | 44 ++++++++++++++
 6 files changed, 134 insertions(+), 6 deletions(-)

diff --git a/src/components/PostCard.astro b/src/components/PostCard.astro
index 35dfdcf..534125f 100644
--- a/src/components/PostCard.astro
+++ b/src/components/PostCard.astro
@@ -110,7 +110,7 @@ const { remarkPluginFrontmatter } = await render(entry);
             </Icon>
         </div>
         <ImageWrapper src={image} basePath={path.join("content/posts/", getDir(entry.id))} alt="Cover Image of the Post"
-                  class="w-full h-full">
+                  class="w-full h-full" loader>
         </ImageWrapper>
     </a>}
 
diff --git a/src/components/misc/ImageWrapper.astro b/src/components/misc/ImageWrapper.astro
index 5fb3b3e..c4e0fee 100644
--- a/src/components/misc/ImageWrapper.astro
+++ b/src/components/misc/ImageWrapper.astro
@@ -8,12 +8,14 @@ interface Props {
 	alt?: string;
 	position?: string;
 	basePath?: string;
+	loader?: boolean;
+	blur?: boolean;
 }
 
 import { Image } from "astro:assets";
 import { url } from "../../utils/url-utils";
 
-const { id, src, alt, position = "center", basePath = "/" } = Astro.props;
+const { id, src, alt, position = "center", basePath = "/", loader = false, blur = false } = Astro.props;
 const className = Astro.props.class;
 
 const isLocal = !(
@@ -51,7 +53,7 @@ const originalSrc = isLocal && img ? img.src : isPublic ? url(normalizedPublicSr
 const originalWidth = isLocal && img ? img.width : undefined;
 const originalHeight = isLocal && img ? img.height : undefined;
 ---
-<div id={id} class:list={[className, 'overflow-hidden relative']}>
+<div id={id} class:list={[className, "overflow-hidden relative", loader && "image-loading-shell is-loading", blur && "image-blur-shell is-loading"]}>
     <div class="transition absolute inset-0 dark:bg-black/10 bg-opacity-50 pointer-events-none"></div>
     {isLocal && img && <Image src={img} alt={alt || ""} class={imageClass} style={imageStyle} data-pswp-src={originalSrc} data-pswp-width={originalWidth} data-pswp-height={originalHeight} data-original-src={originalSrc}/>}
     {!isLocal && <img src={originalSrc} alt={alt || ""} class={imageClass} style={imageStyle} data-pswp-src={originalSrc} data-original-src={originalSrc}/>}
diff --git a/src/layouts/Layout.astro b/src/layouts/Layout.astro
index afdbe10..3e0782c 100644
--- a/src/layouts/Layout.astro
+++ b/src/layouts/Layout.astro
@@ -679,6 +679,88 @@ window.onresize = () => {
 }
 </script>
 
+<script>
+type ImageLoaderState = {
+	pageLoadRegistered: boolean
+	swupHookRegistered: boolean
+}
+
+const imageLoaderState = (((window as Window & { __blogImageLoader?: ImageLoaderState }).__blogImageLoader ??= {
+	pageLoadRegistered: false,
+	swupHookRegistered: false,
+}) as ImageLoaderState)
+
+function markImageLoaded(wrapper: HTMLElement) {
+	if (wrapper.classList.contains("image-blur-shell")) {
+		window.setTimeout(() => wrapper.classList.remove("is-loading"), 120)
+		return
+	}
+	wrapper.classList.remove("is-loading")
+}
+
+function bindImageLoader(wrapper: HTMLElement) {
+	if (wrapper.dataset.imageLoadingBound === "true") {
+		return
+	}
+
+	const image = wrapper.querySelector("img")
+	if (!(image instanceof HTMLImageElement)) {
+		markImageLoaded(wrapper)
+		return
+	}
+
+	wrapper.dataset.imageLoadingBound = "true"
+	if (image.complete) {
+		markImageLoaded(wrapper)
+		return
+	}
+
+	image.addEventListener("load", () => markImageLoaded(wrapper), { once: true })
+	image.addEventListener("error", () => markImageLoaded(wrapper), { once: true })
+}
+
+function wrapMarkdownImage(image: HTMLImageElement) {
+	if (image.closest(".image-loading-shell, .image-blur-shell") || !image.parentNode) {
+		return
+	}
+
+	const wrapper = document.createElement("span")
+	wrapper.className = "image-loading-shell image-loading-shell--markdown is-loading"
+	image.parentNode.insertBefore(wrapper, image)
+	wrapper.appendChild(image)
+}
+
+function initImageLoaders() {
+	document.querySelectorAll<HTMLImageElement>(".custom-md img:not([data-image-loading-skip])").forEach(wrapMarkdownImage)
+	document.querySelectorAll<HTMLElement>(".image-loading-shell, .image-blur-shell").forEach(bindImageLoader)
+}
+
+function registerImageLoaderSwupHook() {
+	if (imageLoaderState.swupHookRegistered || !window.swup?.hooks) {
+		return
+	}
+	window.swup.hooks.on("page:view", initImageLoaders)
+	imageLoaderState.swupHookRegistered = true
+}
+
+if (document.readyState === "loading") {
+	document.addEventListener("DOMContentLoaded", initImageLoaders, { once: true })
+} else {
+	initImageLoaders()
+}
+
+if (!imageLoaderState.pageLoadRegistered) {
+	document.addEventListener("astro:page-load", initImageLoaders)
+	imageLoaderState.pageLoadRegistered = true
+}
+
+if (window.swup?.hooks) {
+	registerImageLoaderSwupHook()
+} else {
+	document.addEventListener("swup:enable", registerImageLoaderSwupHook, { once: true })
+}
+</script>
+
 <script>
 import PhotoSwipeLightbox from "photoswipe/lightbox"
 import "photoswipe/style.css"
diff --git a/src/layouts/MainGridLayout.astro b/src/layouts/MainGridLayout.astro
index 2e9cd5c..0757fd6 100644
--- a/src/layouts/MainGridLayout.astro
+++ b/src/layouts/MainGridLayout.astro
@@ -54,7 +54,7 @@ const mainPanelTop = siteConfig.banner.enable
 <!-- Banner -->
 {siteConfig.banner.enable && <div id="banner-wrapper" class={`absolute z-10 w-full transition duration-700 overflow-hidden`} style={`top: -${BANNER_HEIGHT_EXTEND}vh`}>
     <ImageWrapper id="banner" alt="Banner image of the blog" class:list={["object-cover h-full transition duration-700 opacity-0 scale-105"]}
-                  src={siteConfig.banner.src} position={siteConfig.banner.position}
+                  src={siteConfig.banner.src} position={siteConfig.banner.position} blur
     >
     </ImageWrapper>
 </div>}
diff --git a/src/pages/posts/[...slug].astro b/src/pages/posts/[...slug].astro
index aab9ef2..16d7a3e 100644
--- a/src/pages/posts/[...slug].astro
+++ b/src/pages/posts/[...slug].astro
@@ -373,12 +373,12 @@ const isOutdated = entry.data.outdated;
             <!-- always show cover as long as it has one -->
             <!-- 使用自制 showcover 控制器控制头图的出现 -->
             {showcover && entry.data.image &&
-                <ImageWrapper id="post-cover" src={entry.data.image} basePath={path.join("content/posts/", getDir(entry.id))} class="mb-8 rounded-xl banner-container onload-animation"/>
+                <ImageWrapper id="post-cover" src={entry.data.image} basePath={path.join("content/posts/", getDir(entry.id))} class="mb-8 rounded-xl banner-container onload-animation" loader/>
             }
             
             <!-- 自制内部头图 customcover-->
             {customcover &&
-                <ImageWrapper id="post-cover" src={entry.data.customcover} basePath={path.join("content/posts/", getDir(entry.id))} class="mb-8 rounded-xl banner-container onload-animation"/>
+                <ImageWrapper id="post-cover" src={entry.data.customcover} basePath={path.join("content/posts/", getDir(entry.id))} class="mb-8 rounded-xl banner-container onload-animation" loader/>
             }
 
             <!-- 头图调试代码
diff --git a/src/styles/main.css b/src/styles/main.css
index 536dc19..8022227 100644
--- a/src/styles/main.css
+++ b/src/styles/main.css
@@ -156,6 +156,50 @@
     @apply cursor-zoom-in
 }
 
+.image-loading-shell {
+    background: color-mix(in oklch, var(--card-bg) 92%, var(--btn-regular-bg) 8%);
+}
+
+.image-loading-shell > img {
+    transition: opacity 0.28s ease, filter 0.55s ease;
+}
+
+.image-blur-shell > img {
+    transition: filter 0.28s ease;
+}
+
+.image-loading-shell.is-loading > img {
+    opacity: 0;
+    filter: blur(4px);
+}
+
+.image-blur-shell.is-loading > img {
+    filter: blur(3px);
+}
+
+
+.image-loading-shell--markdown {
+    display: block;
+    position: relative;
+    overflow: hidden;
+    border-radius: 0.75rem;
+}
+
+.image-loading-shell--markdown.is-loading {
+    min-height: 12rem;
+}
+
+.custom-md .image-loading-shell--markdown {
+    margin-top: 2em;
+    margin-bottom: 2em;
+}
+
+.custom-md .image-loading-shell--markdown img {
+    margin-top: 0;
+    margin-bottom: 0;
+}
+
+
 ::selection {
     background-color: var(--selection-bg);
     color: inherit;