materialize-css
Version:
Builds Materialize distribution packages
414 lines (374 loc) • 17.9 kB
HTML
<div class="container">
<div class="row">
<div class="col s12 m9 l10">
<div id="right" class="section scrollspy">
<p class="caption">The navbar is fully contained by an HTML5 Nav tag. Inside a recommended container div, there are 2 main parts of the navbar. A logo or brand link, and the navigations links. You can align these links to the left or right.
</p>
<h2 class="header">Right Aligned Links</h2>
<p>To right align your navbar links, just add a <code class="language-markup">right</code> class to your <code class="language-markup"><ul></code> that contains them.</p>
<nav>
<div class="nav-wrapper">
<div class="col s12">
<a href="#!" class="brand-logo">Logo</a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li><a href="collapsible.html">JavaScript</a></li>
</ul>
</div>
</div>
</nav><br>
<pre><code class="language-markup">
<nav>
<div class="nav-wrapper">
<a href="#" class="brand-logo">Logo</a>
<ul id="nav-mobile" class="right hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li><a href="collapsible.html">JavaScript</a></li>
</ul>
</div>
</nav>
</code></pre>
</div>
<div id="left" class="section scrollspy">
<h2 class="header">Left Aligned Links</h2>
<p>To left align your navbar links, just add a <code class="language-markup">left</code> class to your <code class="language-markup"><ul></code> that contains them.</p>
<nav>
<div class="nav-wrapper">
<div class="col s12">
<a href="#!" class="brand-logo right">Logo</a>
<ul class="left hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li><a href="collapsible.html">JavaScript</a></li>
</ul>
</div>
</div>
</nav><br>
<pre><code class="language-markup">
<nav>
<div class="nav-wrapper">
<a href="#" class="brand-logo right">Logo</a>
<ul id="nav-mobile" class="left hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li><a href="collapsible.html">JavaScript</a></li>
</ul>
</div>
</nav>
</code></pre>
</div>
<div id="center" class="section scrollspy">
<h2 class="header">Centering the logo</h2>
<p>The logo will center itself on medium and down screens, but if you want the logo to always be centered, add the <code class="language-markup">center</code> class to your <code class="language-markup"><a class="brand-logo"></code>. You will have to make sure yourself that links do not overlap if you use this.</p>
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo center">Logo</a>
<ul class="left hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
</ul>
</div>
</nav><br>
<pre><code class="language-markup">
<nav>
<div class="nav-wrapper">
<a href="#" class="brand-logo center">Logo</a>
<ul id="nav-mobile" class="left hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li><a href="collapsible.html">JavaScript</a></li>
</ul>
</div>
</nav>
</code></pre>
</div>
<div id="active-label" class="section scrollspy">
<h2 class="header">Active Items</h2>
<p>
Add active class to your li tags to denote the current page.
</p>
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo center">Logo</a>
<ul class="left hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li class="active"><a href="collapsible.html">JavaScript</a></li>
</ul>
</div>
</nav><br>
<pre><code class="language-markup">
<div class="navbar-fixed">
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo">Logo</a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li class="active"><a href="collapsible.html">JavaScript</a></li>
</ul>
</div>
</nav>
</div>
</code></pre>
</div>
<div id="navbar-fixed" class="section scrollspy">
<h2 class="header">Fixed Navbar</h2>
<p>
To make the navbar fixed, you have to add an outer wrapping div with the class <code class="language-markup">navbar-fixed</code>. This will offset your other content while making your nav fixed. You can adjust the height of this outer div to change how much offset is on your content.
</p>
<pre><code class="language-markup">
<div class="navbar-fixed">
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo">Logo</a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
</ul>
</div>
</nav>
</div>
</code></pre>
</div>
<div id="navbar-dropdown" class="section scrollspy">
<h2 class="header">Navbar Dropdown Menu</h2>
<p>
To add a navbar dropdown menu, add the <code class="language-markup">ul</code> dropdown structure into the page.
Then, add an element to trigger the dropdown menu. Make sure to supply the id of the dropdown structure to the
<code class="language-markup">data-activates</code> attribute of the dropdown trigger.
</p>
<!-- Dropdown Structure -->
<ul id="dropdown1" class="dropdown-content">
<li><a href="#!">one</a></li>
<li><a href="#!">two</a></li>
<li class="divider"></li>
<li><a href="#!">three</a></li>
</ul>
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo">Logo</a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<!-- Dropdown Trigger -->
<li><a class="dropdown-button" href="#!" data-activates="dropdown1">Dropdown<i class="material-icons right">arrow_drop_down</i></a></li>
</ul>
</div>
</nav><br>
<pre><code class="language-markup">
<!-- Dropdown Structure -->
<ul id="dropdown1" class="dropdown-content">
<li><a href="#!">one</a></li>
<li><a href="#!">two</a></li>
<li class="divider"></li>
<li><a href="#!">three</a></li>
</ul>
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo">Logo</a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<!-- Dropdown Trigger -->
<li><a class="dropdown-button" href="#!" data-activates="dropdown1">Dropdown<i class="material-icons right">arrow_drop_down</i></i></a></li>
</ul>
</div>
</nav>
</code></pre>
<p>To activate the dropdown menu, insert this line of code into your JavaScript file, within the <code class="language-javascript">$( document ).ready(function)</code> block</p>
<pre><code class="language-javascript">
$(".dropdown-button").dropdown();
</code></pre>
<h5>Trigger dropdown menu on click</h5>
<p>
By default, the dropdown menu is activated by hovering over the dropdown trigger.
To activate the dropdown menu on click, pass <code class="language-javascript">{ hover: false }</code>
into the above <code class="language-javascript">dropdown()</code> function
</p>
</div>
<div id="icons" class="section scrollspy">
<h2 class="header">Icon Links</h2>
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo"><i class="material-icons">cloud</i>Logo</a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html"><i class="material-icons">search</i></a></li>
<li><a href="badges.html"><i class="material-icons">view_module</i></a></li>
<li><a href="collapsible.html"><i class="material-icons">refresh</i></a></li>
<li><a href="mobile.html"><i class="material-icons">more_vert</i></a></li>
</ul>
</div>
</nav>
<br>
<p>You can add icons into links. For icon only links you don't need any additional class. Just pop the <code class="language-markup">i</code> tag in and it will work.</p>
<pre><code class="language-markup">
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo"><i class="material-icons">cloud</i>Logo</a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html"><i class="material-icons">search</i></a></li>
<li><a href="badges.html"><i class="material-icons">view_module</i></a></li>
<li><a href="collapsible.html"><i class="material-icons">refresh</i></a></li>
<li><a href="mobile.html"><i class="material-icons">more_vert</i></a></li>
</ul>
</div>
</nav></code></pre>
<br>
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo">Logo</a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html"><i class="material-icons left">search</i>Link with Left Icon</a></li>
<li><a href="badges.html"><i class="material-icons right">view_module</i></i>Link with Right Icon</a></li>
</ul>
</div>
</nav>
<br>
<p>For adding an icon to a text link you need to add either a <code class="language-markup">left</code> or <code class="language-markup">right</code> class to the icon depending on where you want the icon to be.</p>
<pre><code class="language-markup">
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo">Logo</a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html"><i class="material-icons left">search</i>Link with Left Icon</a></li>
<li><a href="badges.html"><i class="material-icons right">view_module</i></i>Link with Right Icon</a></li>
</ul>
</div>
</nav></code></pre>
<br>
</div>
<div id="buttons" class="section scrollspy">
<h2 class="header">Buttons</h2>
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo">Logo</a>
<ul class="right hide-on-med-and-down">
<li><a>A link</a></li>
<li><a class="waves-effect waves-light btn">A button</a></li>
<li><a class="waves-effect waves-light btn-large">A large button</a></li>
</ul>
</div>
</nav>
<br>
<p>You can add buttons into links. For buttons you don't need any additional class. Just pop the <code class="language-markup">.btn</code> class on the <code class="language-markup">a</code> tag.</p>
<pre><code class="language-markup">
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo">Logo</a>
<ul class="right hide-on-med-and-down">
<li><a href="#">A link</a></li>
<li><a class="waves-effect waves-light btn">A button</a></li>
<li><a class="waves-effect waves-light btn-large">A large button</a></li>
</ul>
</div>
</nav></code></pre>
<br>
</div>
<div id="search-docs" class="section scrollspy">
<h2 class="header">Search Bar</h2>
<nav>
<div class="nav-wrapper">
<form>
<div class="input-field">
<input id="search-example" type="search" required>
<label for="search"><i class="material-icons">search</i></label>
<i class="material-icons">close</i>
</div>
</form>
</div>
</nav>
<br>
<p>You can add a search form in the navbar.</p>
<pre><code class="language-markup">
<nav>
<div class="nav-wrapper">
<form>
<div class="input-field">
<input id="search" type="search" required>
<label for="search"><i class="material-icons">search</i></label>
<i class="material-icons">close</i>
</div>
</form>
</div>
</nav></code></pre>
<br>
</div>
<div id="mobile-collapse" class="section scrollspy">
<h2 class="header">Mobile Collapse Button</h2>
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo">Logo</a>
<a href="#" data-activates="mobile-demo" class="button-collapse"><i class="material-icons">menu</i></a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li><a href="collapsible.html">Javascript</a></li>
<li><a href="mobile.html">Mobile</a></li>
<li><a class="btn waves-effect waves-light" href="buttons.html">Buttons</a></li>
</ul>
<ul class="side-nav" id="mobile-demo">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li><a href="collapsible.html">Javascript</a></li>
<li><a href="mobile.html">Mobile</a></li>
<li><a class="btn waves-effect waves-light" href="buttons.html">Buttons</a></li>
</ul>
</div>
</nav>
<br>
<p>When your nav bar is resized, you will see that the links on the right turn into a hamburger icon <i class="material-icons">menu</i>. Take a look at the example below to get this functionality. Add the entire <code class="language-markup">button-collapse</code> line to your <code class="language-markup">nav</code>.</p>
<pre><code class="language-markup">
<nav>
<div class="nav-wrapper">
<a href="#!" class="brand-logo">Logo</a>
<a href="#" data-activates="mobile-demo" class="button-collapse"><i class="material-icons">menu</i></i></a>
<ul class="right hide-on-med-and-down">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li><a href="collapsible.html">Javascript</a></li>
<li><a href="mobile.html">Mobile</a></li>
</ul>
<ul class="side-nav" id="mobile-demo">
<li><a href="sass.html">Sass</a></li>
<li><a href="badges.html">Components</a></li>
<li><a href="collapsible.html">Javascript</a></li>
<li><a href="mobile.html">Mobile</a></li>
</ul>
</div>
</nav>
</code></pre>
<br>
<h4>Initialization</h4>
<p>After including the button-collapse line into your navbar, all you have to do now is place this code in your page's <code class="language-javascript">$( document ).ready(function(){})</code> code. This example below assumes you have not modified the classes in the above example. In the case that you have, just change the jQuery selector in the line below to match it.</p>
<pre><code class="language-javascript">
$(".button-collapse").sideNav();
</code></pre>
</div>
</div>
<div class="col hide-on-small-only m3 l2">
<div class="toc-wrapper">
<div class="buysellads hide-on-small-only">
<!-- CarbonAds Zone Code -->
<script async type="text/javascript" src="//cdn.carbonads.com/carbon.js?zoneid=1673&serve=C6AILKT&placement=materializecss" id="_carbonads_js"></script>
</div>
<div style="height: 1px;">
<ul class="section table-of-contents">
<li><a href="#right">Right Aligned</a></li>
<li><a href="#left">Left Aligned</a></li>
<li><a href="#center">Center Logo</a></li>
<li><a href="#active-label">Active Items</a></li>
<li><a href="#navbar-fixed">Fixed Navbar</a></li>
<li><a href="#navbar-dropdown">Dropdown Menu</a></li>
<li><a href="#icons">Icon Links</a></li>
<li><a href="#buttons">Buttons</a></li>
<li><a href="#search-docs">Search Bar</a></li>
<li><a href="#mobile-collapse">Mobile Collapse</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>