Vertical Navbar
Here is the default Phoenix's powerful, responsive vertical navigation. The following sections describe how you can customize both the responsive breakpoint and collapsing behavior.
Vertical navbar exampleNavbar vertical structure
<!DOCTYPE html>
<html>
<head>...</head>
<body>
<main>
<div class="container-fluid">
<nav class="navbar navbar-vertical navbar-expand-lg">
<!-- navbar vertical content goes here-->
</nav>
<nav class="navbar navbar-top navbar-expand">
<!-- navbar top content goes here-->
</nav>
<div class="content">
<!-- content goes here-->
</div>
</div>
</main>
</body>
</html>
Responsive behavior
<p class="mb-3">Phoenix used the Hummingbird's <code>.navbar-expand{-sm|-md|-lg|-xl|-xxl} </code> classes in <code>.navbar-vertical </code>element to decide when the navbar vertical will expand or not.</p><pre class="scrollbar mt-8"><code class="language-html"><nav class="navbar navbar-vertical navbar-expand-lg"></nav></code></pre>
Phoenix used the Hummingbird's .navbar-expand{-sm|-md|-lg|-xl|-xxl} classes in .navbar-vertical element to decide when the navbar vertical will expand or not.
<nav class="navbar navbar-vertical navbar-expand-lg"></nav>
Collapsing behavior
<p>You can control the default collapsing behavior of phoenix's vertical navigation - whether it will show up with the collapsed or expanded state when the page loads.</p>
<p class="mb-3">From your project directory, If you are using gulp version open <code>src/js/config.js </code>or if you are using directly from the public folder open <code>public/assets/js/config.js </code>and set <code>phoenixIsNavbarVerticalCollapsed: true </code>of <code>initialConfig </code>object to collapse the Vertical Navigation by default</p><pre class="scrollbar mt-8"><code class="lang-html">const initialConfig = {
phoenixIsNavbarVerticalCollapsed: false,
...
};
</code></pre>
You can control the default collapsing behavior of phoenix's vertical navigation - whether it will show up with the collapsed or expanded state when the page loads.
From your project directory, If you are using gulp version open src/js/config.js or if you are using directly from the public folder open public/assets/js/config.js and set phoenixIsNavbarVerticalCollapsed: true of initialConfig object to collapse the Vertical Navigation by default
const initialConfig = {
phoenixIsNavbarVerticalCollapsed: false,
...
};
Vertical Navbar appearance
You can control Navbar vertical style of phoenix's between defaults and darker.
From your project directory, If you are using gulp version open src/js/config.js or if you are using directly from the public folder open public/assets/js/config.js and set phoenixNavbarVerticalStyle: 'darker' of initialConfig object to collapse the Vertical Navigation by default
const initialConfig = {
phoenixNavbarVerticalStyle: 'default' || 'darker',
...
};
Or to change navbar vertical color add data-navbar-appearance="darker" attribute in navbar-vertical
<nav class="navbar navbar-vertical navbar-expand-lg" data-navbar-appearance="darker"></nav>
Customize
<p class="mb-3">Phoenix Tailwind allow you to customize your Navbar Vertical with CSS variables. The available options are listed below: </p><pre class="language-css"><code class="lang-css">:root {
--content-padding-x: --spacing(10);
--content-padding-bottom: 6.375rem;
--content-padding-top: calc(var(--navbar-top-height) + 2rem);
--footer-height: 4rem;
--navbar-vertical-width: 15.875rem;
--navbar-vertical-icon-width: 1rem;
--navbar-vertical-link-font-size: var(--text-md);
--navbar-vertical-link-padding-y: 0.35rem;
--navbar-vertical-dropdown-font-size: 0.8125rem;
--navbar-vertical-dropdown-link-padding-x: --spacing(2);
--navbar-vertical-dropdown-link-padding-y: --spacing(1);
--navbar-vertical-footer-height: var(--footer-height);
--navbar-footer-border-color: var(--border-color-base);
--navbar-vertical-height: calc(100vh - var(--navbar-top-height));
--navbar-vertical-content-height: calc(100vh - var(--navbar-top-height) - var(--navbar-vertical-footer-height));
--navbar-vertical-content-padding-x: --spacing(2);
--navbar-vertical-content-padding-y: --spacing(4);
--navbar-vertical-label-font-size: var(--text-sm);
--navbar-vertical-collapse-width: 4rem;
--navbar-vertical-link-collapse-padding-x: 1.5rem;
--navbar-vertical-collapse-padding-x: 2.5rem;
--navbar-vertical-hover-width: 12.625rem;
--navbar-vertical-collapsed-hover-shadow: 0.625rem 0 0.625rem -0.5625rem var(--navbar-vertical-collapsed-hover-shadow-color);
--navbar-vertical-border-color: var(--border-color-base);
--navbar-vertical-bg-color: var(--background-color-body-emphasis);
--navbar-vertical-label-color: var(--gray-600);
--navbar-vertical-link-color: var(--gray-700);
--navbar-vertical-link-hover-color: var(--text-color-body-secondary);
--navbar-vertical-link-hover-bg: var(--gray-100);
--navbar-vertical-link-active-color: var(--color-primary);
--navbar-vertical-link-disable-color: var(--gray-500);
--navbar-vertical-collapsed-menu-bg: var(--color-white);
--navbar-vertical-hr-color: var(--gray-200);
--navbar-vertical-dropdown-indicator-color: var(--gray-500);
}</code></pre>
Phoenix Tailwind allow you to customize your Navbar Vertical with CSS variables. The available options are listed below:
:root {
--content-padding-x: --spacing(10);
--content-padding-bottom: 6.375rem;
--content-padding-top: calc(var(--navbar-top-height) + 2rem);
--footer-height: 4rem;
--navbar-vertical-width: 15.875rem;
--navbar-vertical-icon-width: 1rem;
--navbar-vertical-link-font-size: var(--text-md);
--navbar-vertical-link-padding-y: 0.35rem;
--navbar-vertical-dropdown-font-size: 0.8125rem;
--navbar-vertical-dropdown-link-padding-x: --spacing(2);
--navbar-vertical-dropdown-link-padding-y: --spacing(1);
--navbar-vertical-footer-height: var(--footer-height);
--navbar-footer-border-color: var(--border-color-base);
--navbar-vertical-height: calc(100vh - var(--navbar-top-height));
--navbar-vertical-content-height: calc(100vh - var(--navbar-top-height) - var(--navbar-vertical-footer-height));
--navbar-vertical-content-padding-x: --spacing(2);
--navbar-vertical-content-padding-y: --spacing(4);
--navbar-vertical-label-font-size: var(--text-sm);
--navbar-vertical-collapse-width: 4rem;
--navbar-vertical-link-collapse-padding-x: 1.5rem;
--navbar-vertical-collapse-padding-x: 2.5rem;
--navbar-vertical-hover-width: 12.625rem;
--navbar-vertical-collapsed-hover-shadow: 0.625rem 0 0.625rem -0.5625rem var(--navbar-vertical-collapsed-hover-shadow-color);
--navbar-vertical-border-color: var(--border-color-base);
--navbar-vertical-bg-color: var(--background-color-body-emphasis);
--navbar-vertical-label-color: var(--gray-600);
--navbar-vertical-link-color: var(--gray-700);
--navbar-vertical-link-hover-color: var(--text-color-body-secondary);
--navbar-vertical-link-hover-bg: var(--gray-100);
--navbar-vertical-link-active-color: var(--color-primary);
--navbar-vertical-link-disable-color: var(--gray-500);
--navbar-vertical-collapsed-menu-bg: var(--color-white);
--navbar-vertical-hr-color: var(--gray-200);
--navbar-vertical-dropdown-indicator-color: var(--gray-500);
}

