From f98678f835884b9be04c8e9c8d091cd4c1183819 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marek=20Noco=C5=84?= <mnocon@users.noreply.github.com>
Date: Sat, 18 Jul 2026 12:30:46 +0200
Subject: [PATCH] [PHP API Reference] Fixed navigation on mobile view

---
 .../template/components/header.html.twig      |  3 +
 .../.phpdoc/template/css/base.css.twig        |  8 ++-
 .../template/css/docs.switcher.css.twig       |  6 ++
 .../.phpdoc/template/css/navigation.css.twig  | 56 ++++++++++++++++++-
 .../.phpdoc/template/js/menu-resizer.js       |  2 +-
 .../.phpdoc/template/layout.html.twig         |  3 +
 6 files changed, 72 insertions(+), 6 deletions(-)

diff --git a/tools/api_refs/.phpdoc/template/components/header.html.twig b/tools/api_refs/.phpdoc/template/components/header.html.twig
index edbe4ccfb0f..572634db42b 100644
--- a/tools/api_refs/.phpdoc/template/components/header.html.twig
+++ b/tools/api_refs/.phpdoc/template/components/header.html.twig
@@ -1,5 +1,8 @@
 <header class="md-header" data-md-component="header">
     <nav class="md-header__inner md-grid" aria-label="">
+        <label class="md-header__button md-icon" for="__drawer" aria-label="Open navigation">
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+        </label>
         {% include 'components/header-title.html.twig' %}
         {% include 'components/doc-switcher.html.twig' %}
         {% include 'components/version-switcher.html.twig' %}
diff --git a/tools/api_refs/.phpdoc/template/css/base.css.twig b/tools/api_refs/.phpdoc/template/css/base.css.twig
index 5119280320a..cfcb682b087 100644
--- a/tools/api_refs/.phpdoc/template/css/base.css.twig
+++ b/tools/api_refs/.phpdoc/template/css/base.css.twig
@@ -31,9 +31,11 @@ body.menu-resizing {
     background-color: #306CBE;
 }
 
-.main_nav_content,
-.md-sidebar--primary {
-    width: 100%;
+@media only screen and (min-width: 76.1875em) {
+    .main_nav_content,
+    .md-sidebar--primary {
+        width: 100%;
+    }
 }
 
 .md-sidebar--primary {
diff --git a/tools/api_refs/.phpdoc/template/css/docs.switcher.css.twig b/tools/api_refs/.phpdoc/template/css/docs.switcher.css.twig
index cb4e8073c72..b2e9b63fab7 100644
--- a/tools/api_refs/.phpdoc/template/css/docs.switcher.css.twig
+++ b/tools/api_refs/.phpdoc/template/css/docs.switcher.css.twig
@@ -122,3 +122,9 @@
 .md-header__switcher .rst-other-versions dt {
     display: none;
 }
+
+@media only screen and (max-width: 44.9375em) {
+    .md-header__switcher:not(.push) {
+        display: none;
+    }
+}
diff --git a/tools/api_refs/.phpdoc/template/css/navigation.css.twig b/tools/api_refs/.phpdoc/template/css/navigation.css.twig
index 07aac9a4c27..0cf8687f424 100644
--- a/tools/api_refs/.phpdoc/template/css/navigation.css.twig
+++ b/tools/api_refs/.phpdoc/template/css/navigation.css.twig
@@ -1,17 +1,69 @@
 .main_nav {
     border-right: 1px solid var(--mid-grey);
-    margin-left: -15rem;
     display: flex;
     flex-shrink: 0;
 }
 
+@media only screen and (max-width: 76.1874em) {
+    .main_nav {
+        width: 0 !important;
+        border-right: none;
+    }
+
+    .main_nav .site-header,
+    .main_nav__resize-handler {
+        display: none;
+    }
+
+    .md-sidebar--primary .md-sidebar__scrollwrap {
+        overflow-y: auto;
+    }
+
+    /* Keep the desktop-style nav tree inside the drawer instead of
+       Material's layered sliding panels */
+    .md-nav--primary,
+    .md-nav--primary .md-nav {
+        position: static;
+        display: block;
+        height: auto;
+        z-index: auto;
+    }
+
+    .md-nav--primary .md-nav__item {
+        border-top: none;
+    }
+
+    .md-nav__toggle ~ .md-nav {
+        display: none;
+        opacity: 1;
+        transform: none;
+        transition: none;
+    }
+
+    .md-nav__toggle:checked ~ .md-nav,
+    .md-nav__toggle:indeterminate ~ .md-nav {
+        display: block;
+    }
+
+    .md-typeset h1,
+    .md-typeset h2,
+    .md-typeset h3,
+    .md-typeset h4 {
+        overflow-wrap: anywhere;
+    }
+
+    .md-typeset .method-parameters {
+        display: block;
+        overflow-x: auto;
+    }
+}
+
 .md-sidebar__scrollwrap {
     margin: 0;
 }
 
 @media only screen and (min-width: 76.1875em) {
     .main_nav {
-        margin-left: 0;
         position: sticky;
         top: 56px;
         height: calc(100vh - 56px);
diff --git a/tools/api_refs/.phpdoc/template/js/menu-resizer.js b/tools/api_refs/.phpdoc/template/js/menu-resizer.js
index 1e910d3528f..b32654c67ed 100644
--- a/tools/api_refs/.phpdoc/template/js/menu-resizer.js
+++ b/tools/api_refs/.phpdoc/template/js/menu-resizer.js
@@ -25,7 +25,7 @@
     const setWidthOfSecondLevelMenu = () => {
         let secondLevelMenuWidth = getCookie('php-api:menu-width');
 
-        if (!secondLevelMenuWidth) {
+        if (!secondLevelMenuWidth || window.matchMedia('(max-width: 76.1875em)').matches) {
             return;
         }
 
diff --git a/tools/api_refs/.phpdoc/template/layout.html.twig b/tools/api_refs/.phpdoc/template/layout.html.twig
index 73d1dd0abb0..bdb92a16600 100644
--- a/tools/api_refs/.phpdoc/template/layout.html.twig
+++ b/tools/api_refs/.phpdoc/template/layout.html.twig
@@ -25,9 +25,12 @@
     <div class="popover popover--copied">Copied!</div>
 
     <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
 
     {% include 'components/header.html.twig' %}
 
+    <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
+
     <div class="md-container" data-md-component="container">
         <main class="md-main" data-md-component="main">
             <div class="md-main__inner md-grid">