From c51559dee56cbafe325e509585aceeac783f81c7 Mon Sep 17 00:00:00 2001
From: ZhenShuo Leo <98386542+ZhenShuo2021@users.noreply.github.com>
Date: Mon, 3 Nov 2025 10:28:54 +0800
Subject: [PATCH] fix(a11y): create disable_images button only when layout is
 background

---
 layouts/partials/header/basic.html | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/layouts/partials/header/basic.html b/layouts/partials/header/basic.html
index b8d3e7d9..b4fb3fe6 100644
--- a/layouts/partials/header/basic.html
+++ b/layouts/partials/header/basic.html
@@ -200,11 +200,20 @@
       <div class="space-y-5">
         {{ $toggles := slice }}
         {{ $shouldDisableBlur := or site.Params.homepage.layoutBackgroundBlur site.Params.article.layoutBackgroundBlur site.Params.list.layoutBackgroundBlur }}
+        {{ $shouldDisableBackgroundImage := or 
+          (eq site.Params.homepage.layout "background")
+          (eq site.Params.article.heroStyle "background")
+          (eq site.Params.list.heroStyle "background")
+          (eq site.Params.taxonomy.heroStyle "background")
+          (eq site.Params.term.heroStyle "background")
+        }}
         {{ if $shouldDisableBlur }}
           {{ $toggles = $toggles | append (dict "id" (print $prefix "disable-blur") "label" (i18n "a11y.disable_blur")) }}
         {{ end }}
+        {{ if $shouldDisableBackgroundImage }}
+          {{ $toggles = $toggles | append (dict "id" (print $prefix "disable-images") "label" (i18n "a11y.disable_images")) }}
+        {{ end }}
         {{- $toggles = $toggles | append
-          (dict "id" (print $prefix "disable-images") "label" (i18n "a11y.disable_images"))
           (dict "id" (print $prefix "underline-links") "label" (i18n "a11y.show_link_underline"))
           (dict "id" (print $prefix "zen-mode") "label" (i18n "article.zen_mode_title.enable"))
         -}}