feat(offline): header background on offline page + fix header ::before stacking #174

Merged
jmiller merged 4 commits from feature/offline-header-background into dev 2026-07-18 23:48:08 +00:00
Owner

⚠️ HOLD — for review & client-side testing, do not merge yet

Offline page inherits header background

  • .moko-offline-wrap now consumes the full --header-background-* set (color, image, size, repeat, position, attachment, opacity, filter).
  • Image moved to .moko-offline-wrap::before so --header-background-opacity / --header-background-filter fade the image only, not the offline card/content.
  • Dark-theme darkening overlay moved from ::before::after (image z-index 0 < overlay z-index 1 < content z-index 2).
  • Full inheritance chosen: offline mirrors the header (#dfdfdf/#1a1f2b backdrop, 0.35 opacity, dark invert).

Fix: header/offline background image not painting

  • The .container-header::before header image (z-index:-1) could fail to paint when the header didn't reliably form its own stacking context, letting the negative-z-index layer fall behind an ancestor.
  • Added isolation: isolate to .container-header and .moko-offline-wrap to guarantee a self-contained stacking context.
  • Note: the header repaint fix touches code already released in v02.31.00 — flagged for review.

Cleanup

  • Removed unused bg.svg (superseded by header-background.svg) and hero.jpg (unreferenced).

Testing checklist

  • Header background image paints in light and dark (sticky and static)
  • Offline page shows background image + card readable in both themes
  • Dark offline overlay darkens correctly; card backdrop-blur intact
## ⚠️ HOLD — for review & client-side testing, do not merge yet ### Offline page inherits header background - `.moko-offline-wrap` now consumes the full `--header-background-*` set (color, image, size, repeat, position, attachment, opacity, filter). - Image moved to `.moko-offline-wrap::before` so `--header-background-opacity` / `--header-background-filter` fade the **image only**, not the offline card/content. - Dark-theme darkening overlay moved from `::before` → `::after` (image z-index 0 < overlay z-index 1 < content z-index 2). - Full inheritance chosen: offline mirrors the header (#dfdfdf/#1a1f2b backdrop, 0.35 opacity, dark invert). ### Fix: header/offline background image not painting - The `.container-header::before` header image (z-index:-1) could fail to paint when the header didn't reliably form its own stacking context, letting the negative-z-index layer fall behind an ancestor. - Added `isolation: isolate` to `.container-header` **and** `.moko-offline-wrap` to guarantee a self-contained stacking context. - **Note:** the header repaint fix touches code already released in v02.31.00 — flagged for review. ### Cleanup - Removed unused `bg.svg` (superseded by `header-background.svg`) and `hero.jpg` (unreferenced). ### Testing checklist - [ ] Header background image paints in light and dark (sticky and static) - [ ] Offline page shows background image + card readable in both themes - [ ] Dark offline overlay darkens correctly; card backdrop-blur intact
jmiller marked the pull request as work in progress 2026-07-18 21:52:40 +00:00
jmiller marked the pull request as ready for review 2026-07-18 23:46:12 +00:00
jmiller added 3 commits 2026-07-18 23:47:40 +00:00
Offline wrap now consumes the full --header-background-* set (color, image, size, repeat, position, attachment, opacity, filter). Image moved to .moko-offline-wrap::before so opacity/filter fade the image only; dark overlay moved to ::after; content lifted above both layers.
bg.svg superseded by header-background.svg (no remaining references); hero.jpg unreferenced.
fix(template): isolate header/offline stacking so background image paints
Universal: Auto Version Bump / Version Bump (push) Successful in 20s
Universal: PR Check / Branch Policy (pull_request) Successful in 2s
Generic: Project CI / Lint & Validate (pull_request) Successful in 18s
Universal: PR Check / Secret Scan (pull_request) Successful in 7s
Joomla: Metadata Validation / Validate Joomla Metadata (pull_request) Failing after 9s
Universal: PR Check / Validate PR (pull_request) Failing after 21s
Generic: Project CI / Tests (pull_request) Has been cancelled
Universal: PR Check / Build RC Package (pull_request) Has been cancelled
Universal: PR Check / Report Issues (pull_request) Has been cancelled
a824f3761a
The .container-header::before (z-index:-1) header image could fail to paint when the header did not reliably form its own stacking context, letting the negative-z-index layer fall behind an ancestor. Add isolation:isolate to .container-header and .moko-offline-wrap to guarantee a self-contained stacking context.
jmiller force-pushed feature/offline-header-background from 6eadb817e5 to a824f3761a 2026-07-18 23:47:40 +00:00 Compare
jmiller added 1 commit 2026-07-18 23:48:01 +00:00
chore(version): auto-bump patch 02.31.02-dev [skip ci]
Branch Cleanup / Delete merged branch (pull_request) Successful in 2s
RC Revert / Rename rc/ back to dev/ (pull_request) Has been skipped
98494d3dc9
jmiller merged commit f5c5f8e9aa into dev 2026-07-18 23:48:08 +00:00
jmiller deleted branch feature/offline-header-background 2026-07-18 23:48:09 +00:00
Sign in to join this conversation.
No Reviewers
No labels
Priority -
Type -
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/MokoOnyx#174