2017-07-01 17:30:39 +00:00
---
2017-10-17 09:28:59 +00:00
title: Navbar
2017-07-01 17:30:39 +00:00
layout: documentation
doc-tab: components
doc-subtab: navbar
---
{% include subnav-components.html %}
2017-07-02 15:52:20 +00:00
{% capture navbar_example %}
2017-10-24 11:23:31 +00:00
{% include examples/navbar.html id="Default" %}
2017-07-02 16:34:44 +00:00
{% endcapture %}
{% capture navbar_brand_example %}
2017-09-09 10:33:05 +00:00
< nav class = "navbar" role = "navigation" aria-label = "main navigation" >
2017-07-02 16:34:44 +00:00
< div class = "navbar-brand" >
2017-09-10 16:04:54 +00:00
<!-- navbar items, navbar burger... -->
2017-07-02 16:34:44 +00:00
< / div >
< / nav >
{% endcapture %}
2017-07-02 21:07:30 +00:00
{% capture navbar_burger_example %}
2017-09-09 10:33:05 +00:00
< button class = "button navbar-burger" >
2017-07-02 21:07:30 +00:00
< span > < / span >
< span > < / span >
< span > < / span >
2017-09-09 10:33:05 +00:00
< / button >
2017-07-02 21:07:30 +00:00
{% endcapture %}
2017-07-02 16:34:44 +00:00
{% capture navbar_brand_items_example %}
2017-09-09 10:33:05 +00:00
< nav class = "navbar" role = "navigation" aria-label = "main navigation" >
2017-07-02 16:34:44 +00:00
< div class = "navbar-brand" >
< a class = "navbar-item" href = "{{ site.url }}" >
< img src = "{{ site.url }}/images/bulma-logo.png" alt = "{{ site.title }}" width = "112" height = "28" >
< / a >
2017-09-09 10:33:05 +00:00
< button class = "button navbar-burger" >
2017-07-02 16:34:44 +00:00
< span > < / span >
< span > < / span >
< span > < / span >
2017-09-09 10:33:05 +00:00
< / button >
2017-07-02 16:34:44 +00:00
< / div >
< / nav >
2017-07-02 15:52:20 +00:00
{% endcapture %}
2017-07-02 21:07:30 +00:00
{% capture navbar_menu_example %}
2017-09-09 10:33:05 +00:00
< nav class = "navbar" role = "navigation" aria-label = "main navigation" >
2017-07-02 21:07:30 +00:00
< div class = "navbar-brand" >
2017-09-10 16:04:54 +00:00
<!-- navbar items, navbar burger... -->
2017-07-02 21:07:30 +00:00
< / div >
< div class = "navbar-menu" >
<!-- navbar start, navbar end -->
< / div >
< / nav >
{% endcapture %}
{% capture navbar_menu_active_example %}
< div class = "navbar-menu" >
<!-- hidden on mobile -->
< / div >
< div class = "navbar-menu is-active" >
<!-- shown on mobile -->
< / div >
{% endcapture %}
{% capture navbar_start_end_example %}
< div class = "navbar-menu" >
< div class = "navbar-start" >
<!-- navbar items -->
< / div >
< div class = "navbar-end" >
<!-- navbar items -->
< / div >
< / div >
{% endcapture %}
{% capture navbar_item_link_example %}
< a class = "navbar-item" >
Home
< / a >
{% endcapture %}
{% capture navbar_item_brand_example %}
< a class = "navbar-item" >
2017-09-09 10:33:05 +00:00
< img src = "{{ site.url }}/images/bulma-logo.png" width = "112" height = "28" alt = "Bulma" >
2017-07-02 21:07:30 +00:00
< / a >
{% endcapture %}
{% capture navbar_item_dropdown_example %}
< div class = "navbar-item has-dropdown" >
< a class = "navbar-link" >
Docs
< / a >
< div class = "navbar-dropdown" >
<!-- Other navbar items -->
< / div >
< / div >
{% endcapture %}
{% capture navbar_item_dropdown_bis_example %}
< div class = "navbar-dropdown" >
< a class = "navbar-item" >
Overview
< / a >
< / div >
{% endcapture %}
{% capture navbar_item_other_example %}
< div class = "navbar-item" >
< div class = "field is-grouped" >
< p class = "control" >
2017-07-16 18:17:51 +00:00
< a class = "button" >
2017-07-02 21:07:30 +00:00
< span class = "icon" >
2018-01-10 16:30:23 +00:00
< i class = "fab fa-twitter" aria-hidden = "true" > < / i >
2017-07-02 21:07:30 +00:00
< / span >
< span > Tweet< / span >
< / a >
< / p >
< p class = "control" >
< a class = "button is-primary" >
< span class = "icon" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-download" aria-hidden = "true" > < / i >
2017-07-02 21:07:30 +00:00
< / span >
< span > Download< / span >
< / a >
< / p >
< / div >
< / div >
{% endcapture %}
{% capture navbar_transparent_example %}
2017-10-24 11:23:31 +00:00
{% include examples/navbar.html transparent=true boxed=true id="TransparentExample" %}
2017-07-02 21:07:30 +00:00
{% endcapture %}
{% capture navbar_dropdown_example %}
2017-09-09 10:33:05 +00:00
< nav class = "navbar" role = "navigation" aria-label = "dropdown navigation" >
2017-07-02 21:07:30 +00:00
< div class = "navbar-item has-dropdown" >
< a class = "navbar-link" >
Docs
< / a >
< div class = "navbar-dropdown" >
< a class = "navbar-item" >
Overview
< / a >
< a class = "navbar-item" >
Elements
< / a >
< a class = "navbar-item" >
Components
< / a >
< hr class = "navbar-divider" >
< div class = "navbar-item" >
Version {{ site.version }}
< / div >
< / div >
< / div >
< / nav >
{% endcapture %}
2017-08-02 22:52:36 +00:00
{% capture navbar_dropdown_hover_snippet %}
< div class = "navbar-item has-dropdown is-hoverable" >
<!-- navbar - link, navbar - dropdown etc. -->
< / div >
{% endcapture %}
2017-07-02 21:07:30 +00:00
{% capture navbar_dropdown_hover_example %}
2017-09-09 10:33:05 +00:00
< nav class = "navbar" role = "navigation" aria-label = "dropdown navigation" >
2017-07-02 21:07:30 +00:00
< div class = "navbar-item has-dropdown is-hoverable" >
< a class = "navbar-link" >
Docs
< / a >
< div class = "navbar-dropdown" >
< a class = "navbar-item" >
Overview
< / a >
< a class = "navbar-item" >
Elements
< / a >
< a class = "navbar-item" >
Components
< / a >
< hr class = "navbar-divider" >
< div class = "navbar-item" >
Version {{ site.version }}
< / div >
< / div >
< / div >
< / nav >
{% endcapture %}
2017-08-02 22:52:36 +00:00
{% capture navbar_dropdown_active_snippet %}
< div class = "navbar-item has-dropdown is-active" >
<!-- navbar - link, navbar - dropdown etc. -->
< / div >
{% endcapture %}
2017-07-02 21:07:30 +00:00
{% capture navbar_dropdown_active_example %}
2017-09-09 10:33:05 +00:00
< nav class = "navbar" role = "navigation" aria-label = "dropdown navigation" >
2017-07-02 21:07:30 +00:00
< div class = "navbar-item has-dropdown is-active" >
< a class = "navbar-link" >
Docs
< / a >
< div class = "navbar-dropdown" >
< a class = "navbar-item" >
Overview
< / a >
< a class = "navbar-item" >
Elements
< / a >
< a class = "navbar-item" >
Components
< / a >
< hr class = "navbar-divider" >
< div class = "navbar-item" >
Version {{ site.version }}
< / div >
< / div >
< / div >
< / nav >
{% endcapture %}
2017-08-02 22:52:36 +00:00
{% capture navbar_dropdown_right_snippet %}
< div class = "navbar-dropdown is-right" >
<!-- navbar - item, navbar - divider etc. -->
< / div >
{% endcapture %}
{% capture navbar_dropdown_right_example %}
2017-09-09 10:33:05 +00:00
< nav class = "navbar" role = "navigation" aria-label = "dropdown navigation" >
2017-08-02 22:52:36 +00:00
< div class = "navbar-menu" >
< div class = "navbar-start" >
< div class = "navbar-item has-dropdown is-active" >
< a class = "navbar-link" >
Left
< / a >
< div class = "navbar-dropdown" >
< a class = "navbar-item" >
Overview
< / a >
< a class = "navbar-item" >
Elements
< / a >
< a class = "navbar-item" >
Components
< / a >
< hr class = "navbar-divider" >
< div class = "navbar-item" >
Version {{ site.version }}
< / div >
< / div >
< / div >
< / div >
< div class = "navbar-end" >
< div class = "navbar-item has-dropdown is-active" >
< a class = "navbar-link" >
Right
< / a >
< div class = "navbar-dropdown is-right" >
< a class = "navbar-item" >
Overview
< / a >
< a class = "navbar-item" >
Elements
< / a >
< a class = "navbar-item" >
Components
< / a >
< hr class = "navbar-divider" >
< div class = "navbar-item" >
Version {{ site.version }}
< / div >
< / div >
< / div >
< / div >
< / div >
< / nav >
< section class = "hero is-primary" >
< div class = "hero-body" >
< p class = "title" >
Documentation
< / p >
< p class = "subtitle" >
Everything you need to < strong > create a website< / strong > with Bulma
< / p >
< / div >
< / section >
{% endcapture %}
2017-10-24 11:31:14 +00:00
{% capture navbar_dropup_snippet %}
< div class = "navbar-item has-dropdown has-dropdown-up is-hoverable" >
< a class = "navbar-link" href = "/documentation/overview/start/" >
Docs
< / a >
< div class = "navbar-dropdown" >
< a class = "navbar-item" href = "/documentation/overview/start/" >
Overview
< / a >
< / div >
< / div >
{% endcapture %}
{% capture navbar_dropup_example %}
< section class = "hero is-primary" >
< div class = "hero-body" >
< p class = "title" >
Documentation
< / p >
< p class = "subtitle" >
Everything you need to < strong > create a website< / strong > with Bulma
< / p >
< / div >
< / section >
< nav class = "navbar" role = "navigation" aria-label = "dropdown navigation" >
< div class = "navbar-menu" >
< div class = "navbar-start" >
< div class = "navbar-item has-dropdown has-dropdown-up is-active" >
< a class = "navbar-link" >
Dropup
< / a >
< div class = "navbar-dropdown" >
< a class = "navbar-item" >
Overview
< / a >
< a class = "navbar-item" >
Elements
< / a >
< a class = "navbar-item" >
Components
< / a >
< hr class = "navbar-divider" >
< div class = "navbar-item" >
Version {{ site.version }}
< / div >
< / div >
< / div >
< / div >
< / div >
< / nav >
{% endcapture %}
2017-07-02 21:07:30 +00:00
{% capture navbar_dropdown_default_example %}
2017-09-09 10:33:05 +00:00
< nav class = "navbar" role = "navigation" aria-label = "dropdown navigation" >
2017-07-02 21:07:30 +00:00
< a class = "navbar-item" >
< img src = "{{ site.url }}/images/bulma-logo.png" alt = "{{ site.title }}" width = "112" height = "28" >
< / a >
< div class = "navbar-item has-dropdown is-active" >
< a class = "navbar-link" >
Docs
< / a >
< div class = "navbar-dropdown" >
< a class = "navbar-item" >
Overview
< / a >
< a class = "navbar-item" >
Elements
< / a >
< a class = "navbar-item" >
Components
< / a >
< hr class = "navbar-divider" >
< div class = "navbar-item" >
Version {{ site.version }}
< / div >
< / div >
< / div >
< / nav >
< section class = "hero is-primary" >
< div class = "hero-body" >
< p class = "title" >
Documentation
< / p >
< p class = "subtitle" >
Everything you need to < strong > create a website< / strong > with Bulma
< / p >
< / div >
< / section >
{% endcapture %}
{% capture navbar_dropdown_boxed_example %}
2017-09-09 10:33:05 +00:00
< nav class = "navbar is-transparent" role = "navigation" aria-label = "dropdown navigation" >
2017-07-02 21:07:30 +00:00
< a class = "navbar-item" >
< img src = "{{ site.url }}/images/bulma-logo.png" alt = "{{ site.title }}" width = "112" height = "28" >
< / a >
< div class = "navbar-item has-dropdown is-active" >
< a class = "navbar-link" >
Docs
< / a >
< div class = "navbar-dropdown is-boxed" >
< a class = "navbar-item" >
Overview
< / a >
< a class = "navbar-item" >
Elements
< / a >
< a class = "navbar-item" >
Components
< / a >
< hr class = "navbar-divider" >
< div class = "navbar-item" >
Version {{ site.version }}
< / div >
< / div >
< / div >
< / nav >
< section class = "hero" >
< div class = "hero-body" >
< p class = "title" >
Documentation
< / p >
< p class = "subtitle" >
Everything you need to < strong > create a website< / strong > with Bulma
< / p >
< / div >
< / section >
{% endcapture %}
{% capture navbar_dropdown_item_active_example %}
2017-09-09 10:33:05 +00:00
< nav class = "navbar" role = "navigation" aria-label = "dropdown navigation" >
2017-07-02 21:07:30 +00:00
< a class = "navbar-item" >
< img src = "{{ site.url }}/images/bulma-logo.png" alt = "{{ site.title }}" width = "112" height = "28" >
< / a >
< div class = "navbar-item has-dropdown is-active" >
< a class = "navbar-link" >
Docs
< / a >
< div class = "navbar-dropdown" >
< a class = "navbar-item" >
Overview
< / a >
< a class = "navbar-item is-active" >
Elements
< / a >
< a class = "navbar-item" >
Components
< / a >
< hr class = "navbar-divider" >
< div class = "navbar-item" >
Version {{ site.version }}
< / div >
< / div >
< / div >
< / nav >
< section class = "hero is-primary" >
< div class = "hero-body" >
< p class = "title" >
Documentation
< / p >
< p class = "subtitle" >
Everything you need to < strong > create a website< / strong > with Bulma
< / p >
< / div >
< / section >
{% endcapture %}
{% capture navbar_divider_example %}
< hr class = "navbar-divider" >
{% endcapture %}
2017-07-11 21:19:06 +00:00
{% capture navbar_js_html %}
2017-09-09 10:33:05 +00:00
< button class = "button navbar-burger" data-target = "navMenu" >
2017-07-11 21:19:06 +00:00
< span > < / span >
< span > < / span >
< span > < / span >
2017-09-09 10:33:05 +00:00
< / button >
2017-07-11 21:19:06 +00:00
< div class = "navbar-menu" id = "navMenu" >
<!-- navbar - start, navbar - end... -->
< / div >
{% endcapture %}
{% capture navbar_js_code %}
document.addEventListener('DOMContentLoaded', function () {
2017-07-15 14:42:26 +00:00
// Get all "navbar-burger" elements
var $navbarBurgers = Array.prototype.slice.call(document.querySelectorAll('.navbar-burger'), 0);
2017-07-11 21:19:06 +00:00
2017-09-09 21:56:54 +00:00
// Check if there are any navbar burgers
2017-07-15 14:42:26 +00:00
if ($navbarBurgers.length > 0) {
2017-07-11 21:19:06 +00:00
// Add a click event on each of them
2017-07-15 14:42:26 +00:00
$navbarBurgers.forEach(function ($el) {
2017-07-31 18:19:31 +00:00
$el.addEventListener('click', function () {
2017-07-11 21:19:06 +00:00
// Get the target from the "data-target" attribute
var target = $el.dataset.target;
var $target = document.getElementById(target);
2017-07-15 14:42:26 +00:00
// Toggle the class on both the "navbar-burger" and the "navbar-menu"
2017-07-11 21:19:06 +00:00
$el.classList.toggle('is-active');
$target.classList.toggle('is-active');
});
});
}
});
{% endcapture %}
2017-09-10 16:04:54 +00:00
{% capture navbar_color_markup %}
< nav class = "navbar is-primary" >
<!-- navbar brand, navbar menu... -->
2017-09-09 21:56:54 +00:00
< / nav >
{% endcapture %}
2017-07-01 17:30:39 +00:00
< section class = "section" >
< div class = "container" >
2017-07-02 15:52:20 +00:00
2017-07-28 22:27:59 +00:00
< h1 class = "title" > Navbar< / h1 >
< h2 class = "subtitle" >
2017-11-16 08:36:16 +00:00
A responsive horizontal < strong > navbar< / strong > that can support images, links, buttons, and dropdowns
2017-07-28 22:27:59 +00:00
< / h2 >
{%
include meta.html
new=true
since="0.4.3"
2017-09-09 21:56:54 +00:00
colors=true
2017-07-28 22:27:59 +00:00
sizes=false
variables=true
%}
2017-07-01 17:30:39 +00:00
2017-07-02 15:52:20 +00:00
< hr >
2017-07-01 19:50:05 +00:00
< div class = "message is-success" >
< div class = "message-body" >
2017-07-02 21:07:30 +00:00
< p > The new < code > navbar< / code > replaces the deprecated < code > nav< / code > component, whose documentation you can still access temporarily < a href = "{{ site.url }}/documentation/components/nav/" > here< / a > .< / p >
2017-07-01 19:50:05 +00:00
< / div >
< / div >
2017-07-02 15:52:20 +00:00
< div class = "content" >
< p >
2017-07-02 21:07:30 +00:00
The < code > navbar< / code > component is a responsive and versatile horizontal navigation bar with the following structure:
2017-07-02 15:52:20 +00:00
< / p >
< ul >
< li >
2017-07-02 21:07:30 +00:00
< code > navbar< / code > the < strong > main< / strong > container
2017-07-02 15:52:20 +00:00
< ul >
< li >
2017-07-02 21:07:30 +00:00
< code > navbar-brand< / code > the < strong > left side< / strong > , < strong class = "has-text-success" > always visible< / strong > , which usually contains the < strong > logo< / strong > and optionally some links or icons
2017-07-02 15:52:20 +00:00
< ul >
< li >
2017-07-02 21:07:30 +00:00
< code > navbar-burger< / code > the < strong > hamburger< / strong > icon, which toggles the navbar menu on touch devices
2017-07-02 15:52:20 +00:00
< / li >
< / ul >
< / li >
< li >
2017-07-02 21:07:30 +00:00
< code > navbar-menu< / code > the < strong > right side< / strong > , hidden on touch devices, visible on desktop
2017-07-02 15:52:20 +00:00
< ul >
< li >
2017-07-02 21:07:30 +00:00
< code > navbar-start< / code > the < strong > left part< / strong > of the menu, which appears next to the navbar brand on desktop
2017-07-02 15:52:20 +00:00
< / li >
< li >
2017-07-02 21:07:30 +00:00
< code > navbar-end< / code > the < strong > right part< / strong > of the menu, which appears at the end of the navbar
2017-07-02 15:52:20 +00:00
< ul >
< li >
2017-08-07 18:06:07 +00:00
< code > navbar-item< / code > each < strong > single item< / strong > of the navbar, which can either be an < code > a< / code > or a < code > div< / code >
2017-07-02 15:52:20 +00:00
< ul >
< li >
2017-07-02 21:07:30 +00:00
< code > navbar-link< / code > a < strong > link< / strong > as the sibling of a dropdown, with an arrow
2017-07-02 15:52:20 +00:00
< / li >
< li >
2017-07-02 21:07:30 +00:00
< code > navbar-dropdown< / code > the < strong > dropdown menu< / strong > , which can include navbar items and dividers
2017-07-02 15:52:20 +00:00
< ul >
< li >
2017-07-02 21:07:30 +00:00
< code > navbar-divider< / code > a < strong > horizontal line< / strong > to separate navbar items
2017-07-02 15:52:20 +00:00
< / li >
< / ul >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< / ul >
< / div >
2017-08-14 17:25:14 +00:00
{% include anchor.html name="Navbar brand" %}
2017-07-02 16:34:44 +00:00
< div class = "content" >
< p >
2017-07-02 21:07:30 +00:00
The < code > navbar-brand< / code > is the left side of the navbar. It can contain:
2017-07-02 16:34:44 +00:00
< / p >
< ul >
< li >
2017-07-02 21:07:30 +00:00
a number of < code > navbar-item< / code >
2017-07-02 16:34:44 +00:00
< / li >
< li >
2017-07-02 21:07:30 +00:00
the < code > navbar-burger< / code > as last child
2017-07-02 16:34:44 +00:00
< / li >
< / ul >
< / div >
{% highlight html %}{{navbar_brand_example}}{% endhighlight %}
< div class = "content" >
< p >
2017-07-02 21:07:30 +00:00
The navbar brand is < strong > always visible< / strong > : on both touch devices {% include bp/touch.html %} and desktop {% include bp/desktop.html %}. As a result, it is recommended to only use a few navbar items to avoid < strong > overflowing< / strong > horizontally on small devices.
2017-07-02 16:34:44 +00:00
< / p >
< / div >
2017-08-14 11:44:24 +00:00
< div class = "bd-example is-paddingless" >
2017-07-02 16:34:44 +00:00
{{navbar_brand_items_example}}
< / div >
{% highlight html %}{{navbar_brand_items_example}}{% endhighlight %}
2017-07-02 21:07:30 +00:00
< div class = "content" >
< p >
On desktop {% include bp/desktop.html %}, the navbar brand will only take up the space it needs.
< / p >
< / div >
2017-08-14 17:25:14 +00:00
{% include anchor.html name="Navbar burger" %}
2017-07-02 21:07:30 +00:00
< div class = "content" >
< p >
The < code > navbar-burger< / code > is a hamburger menu that only appears on < strong > mobile< / strong > . It has to appear as the last child of < code > navbar-brand< / code > .
< / p >
< / div >
2017-08-14 11:44:24 +00:00
< div class = "bd-example is-paddingless" >
2017-07-02 21:07:30 +00:00
< div class = "navbar-burger" style = "display: flex;" >
< span > < / span >
< span > < / span >
< span > < / span >
< / div >
< / div >
{% highlight html %}{{ navbar_burger_example }}{% endhighlight %}
< div class = "content" >
< p >
You can add the modifier class < code > is-active< / code > to turn it into a cross.
< / p >
< / div >
2017-08-14 11:44:24 +00:00
< div class = "bd-example is-paddingless" >
2017-07-02 21:07:30 +00:00
< div class = "navbar-burger is-active" style = "display: flex;" >
< span > < / span >
< span > < / span >
< span > < / span >
< / div >
< / div >
2017-08-14 17:25:14 +00:00
{% include anchor.html name="Navbar menu" %}
2017-07-02 21:07:30 +00:00
< div class = "content" >
< p >
2017-07-07 08:06:03 +00:00
The < code > navbar-menu< / code > is the < strong > counterpart< / strong > of the navbar brand. As such, it must appear as a direct child of < code > navbar< / code > , as a sibling of < code > navbar-brand< / code > .
2017-07-02 21:07:30 +00:00
< / p >
< / div >
{% highlight html %}{{navbar_menu_example}}{% endhighlight %}
< div class = "content" >
< p >
The < code > navbar-menu< / code > is < strong > hidden on touch devices< / strong > {% include bp/touch.html %}. You need to add the modifier class < code > is-active< / code > to display it.
< / p >
< / div >
{% highlight html %}{{navbar_menu_active_example}}{% endhighlight %}
< div class = "content" >
< p >
On desktop {% include bp/desktop.html %}, the < code > navbar-menu< / code > will < strong > fill up the space< / strong > available in the navbar, leaving the navbar brand just the space it needs. It needs, however, two elements as direct children:
< / p >
< ul >
< li >
< code > navbar-start< / code >
< / li >
< li >
< code > navbar-end< / code >
< / li >
< / ul >
< / div >
< hr >
2017-07-11 21:19:06 +00:00
< div id = "navbarJsExample" class = "message is-info" >
< h4 class = "message-header" > Javascript toggle< / h4 >
< div class = "message-body" >
< div class = "content" >
< p >
The Bulma package < strong > does not come with any JavaScript< / strong > .
< br >
2017-07-15 14:42:26 +00:00
Here is however an implementation example, which toggles the class < code > is-active< / code > on both the < code > navbar-burger< / code > and the targeted < code > navbar-menu< / code > .
2017-07-11 21:19:06 +00:00
< / p >
{% highlight html %}{{ navbar_js_html }}{% endhighlight %}
{% highlight javascript %}{{ navbar_js_code }}{% endhighlight %}
< / div >
< / div >
< / div >
2017-08-14 17:25:14 +00:00
{% include anchor.html name="Navbar start and navbar end" %}
2017-07-02 21:07:30 +00:00
< div class = "content" >
< p >
The < code > navbar-start< / code > and < code > navbar-end< / code > are the two direct and only children of the < code > navbar-menu< / code > .
< / p >
< p >
On desktop {% include bp/desktop.html %}:
< / p >
< ul >
< li >
< code > navbar-start< / code > will appear on the < strong > left< / strong >
< / li >
< li >
< code > navbar-end< / code > will appear on the < strong > right< / strong >
< / li >
< / ul >
< p >
Each of them can contain any number of < code > navbar-item< / code > .
< / p >
< / div >
{% highlight html %}{{navbar_start_end_example}}{% endhighlight %}
2017-08-14 17:25:14 +00:00
{% include anchor.html name="Navbar item" %}
2017-07-02 21:07:30 +00:00
< div class = "content" >
< p >
A < code > navbar-item< / code > is a repeatable element that can be:
< / p >
2017-10-26 16:54:26 +00:00
< ul class = "bd-spaced" >
2017-07-02 21:07:30 +00:00
< li >
a navigation < strong > link< / strong >
{% highlight html %}{{ navbar_item_link_example }}{% endhighlight %}
< / li >
< li >
a container for the < strong > brand logo< / strong >
{% highlight html %}{{ navbar_item_brand_example }}{% endhighlight %}
< / li >
< li >
the < strong > parent< / strong > of a dropdown menu
{% highlight html %}{{ navbar_item_dropdown_example }}{% endhighlight %}
< / li >
< li >
a child of a < strong > navbar dropdown< / strong >
{% highlight html %}{{ navbar_item_dropdown_bis_example }}{% endhighlight %}
< / li >
< li >
a container for almost < strong > anything< / strong > you want, like a < code > field< / code >
2017-10-09 14:38:12 +00:00
< div class = "highlight-full" >
{% highlight html %}{{ navbar_item_other_example }}{% endhighlight %}
< / div >
2017-07-02 21:07:30 +00:00
< / li >
< / ul >
< p >
It can either be an anchor tag < code > < a> < / code > or a < code > < div> < / code > , as a < strong > direct child< / strong > of either:
< / p >
< ul >
< li >
< code > navbar< / code >
< / li >
< li >
< code > navbar-brand< / code >
< / li >
< li >
< code > navbar-start< / code >
< / li >
< li >
< code > navbar-end< / code >
< / li >
< li >
< code > navbar-dropdown< / code >
< / li >
< / ul >
2017-10-26 11:12:25 +00:00
< p >
You can add the modifier class < code > is-expanded< / code > to turn it into a full-width element.
< / p >
2017-07-02 21:07:30 +00:00
< / div >
2017-08-14 17:25:14 +00:00
{% include anchor.html name="Transparent navbar" %}
2017-07-02 21:07:30 +00:00
< div class = "content" >
< p >
2017-10-02 18:24:29 +00:00
To seamlessly integrate the navbar in any visual context, you can add the < code > is-transparent< / code > modifier on the < code > navbar< / code > component. This will remove any hover or active background from the navbar items.
2017-07-02 21:07:30 +00:00
< / p >
< / div >
2017-10-09 14:38:12 +00:00
{% include snippet.html content=navbar_transparent_example paddingless=true horizontal=true more=true %}
2017-07-02 21:07:30 +00:00
2017-10-24 11:23:31 +00:00
{% include anchor.html name="Fixed navbar" %}
{% include elements/new-tag.html version="0.6.1" %}
< div class = "content" >
< p >
You can now < strong > fix< / strong > the navbar to either the < strong > top< / strong > or < strong > bottom< / strong > of the page. This is a 2-step process:
< / p >
2017-10-26 16:54:26 +00:00
< ul class = "bd-spaced" >
2017-10-24 11:23:31 +00:00
< li >
Add either < code > is-fixed-top< / code > or < code > is-fixed-bottom< / code > to the < code > navbar< / code > component
{% highlight html %}< nav class = "navbar is-fixed-top" > {% endhighlight %}
< / li >
< li >
Add the corresponding < code > has-navbar-fixed-top< / code > or < code > has-navbar-fixed-bottom< / code > modifier to the < code > < html> < / code > element to provide the appropriate padding to the page
{% highlight html %}< html class = "has-navbar-fixed-top" > {% endhighlight %}
< / li >
< / ul >
< / div >
< h4 class = "title is-5" > Try it out!< / h4 >
< div id = "navbarToggles" class = "buttons" >
< a id = "navbarFixBottom" class = "button is-link" >
< span class = "icon" >
2018-01-10 16:30:23 +00:00
< i class = "far fa-square" > < / i >
2017-10-24 11:23:31 +00:00
< / span >
2017-10-26 16:54:26 +00:00
< span > Show < strong > bottom< / strong > navbar< / span >
2017-10-24 11:23:31 +00:00
< / a >
< / div >
2017-08-14 17:25:14 +00:00
{% include anchor.html name="Dropdown menu" %}
2017-07-02 21:07:30 +00:00
< div class = "content" >
< p >
To create a < strong > dropdown menu< / strong > , you will need < strong > 4< / strong > elements:
< / p >
< ul >
< li >
< code > navbar-item< / code > with the < code > has-dropdown< / code > modifier
< / li >
< li >
< code > navbar-link< / code > which contains the dropdown arrow
< / li >
< li >
< code > navbar-dropdown< / code > which can contain instances of < code > navbar-item< / code > and < code > navbar-divider< / code >
< / li >
< / ul >
< / div >
< div class = "columns" >
< div class = "column" >
2017-08-14 11:44:24 +00:00
< div class = "bd-example is-paddingless" >
2017-07-02 21:07:30 +00:00
{{ navbar_dropdown_example }}
< / div >
< / div >
< div class = "column" >
{% highlight html %}{{ navbar_dropdown_example }}{% endhighlight %}
< / div >
< / div >
< h4 class = "title is-4" >
Show/hide the dropdown with either < strong > CSS< / strong > or < strong > JavaScript< / strong >
< / h4 >
< div class = "content" >
< p >
The < code > navbar-dropdown< / code > is visible on touch devices {% include bp/touch.html %} but hidden on desktop {% include bp/desktop.html %}. < em > How< / em > the dropdown is displayed on desktop depends on the parent's class.
< / p >
< p >
The < code > navbar-item< / code > with the < code > has-dropdown< / code > modifier, has < strong > 2 additional modifiers< / strong >
< / p >
< ul >
< li >
< code > is-hoverable< / code > : the dropdown will show up when < strong > hovering< / strong > the parent < code > navbar-item< / code >
< / li >
< li >
< code > is-active< / code > : the dropdown will show up < strong > all the time< / strong >
< / li >
< / ul >
< / div >
< div class = "message is-success" >
< p class = "message-body" >
While the CSS < code > :hover< / code > implementation works perfectly, the < code > is-active< / code > class is available for users who want to control the display of the dropdown with < strong > JavaScript< / strong > .
< / p >
< / div >
2017-08-02 22:52:36 +00:00
{% highlight html %}{{ navbar_dropdown_hover_snippet }}{% endhighlight %}
2017-07-02 21:07:30 +00:00
< div class = "columns" >
< div class = "column" >
2017-08-14 11:44:24 +00:00
< div class = "bd-example is-paddingless" >
2017-07-02 21:07:30 +00:00
{{ navbar_dropdown_hover_example }}
< / div >
< / div >
< div class = "column" >
{% highlight html %}{{ navbar_dropdown_hover_example }}{% endhighlight %}
< / div >
< / div >
2017-08-02 22:52:36 +00:00
{% highlight html %}{{ navbar_dropdown_active_snippet }}{% endhighlight %}
2017-07-02 21:07:30 +00:00
< div class = "columns" >
< div class = "column" >
2017-08-14 11:44:24 +00:00
< div class = "bd-example is-paddingless" >
2017-07-02 21:07:30 +00:00
{{ navbar_dropdown_active_example }}
< / div >
< / div >
< div class = "column" >
{% highlight html %}{{ navbar_dropdown_active_example }}{% endhighlight %}
< / div >
< / div >
2017-08-02 22:52:36 +00:00
< h4 class = "title is-4" >
Right dropdown
< / h4 >
< div class = "content" >
< p >
If your parent < code > navbar-item< / code > is on the right side, you can position the dropdown to start from the < strong > right< / strong > with the < code > is-right< / code > modifier.
< / p >
< / div >
{% highlight html %}{{ navbar_dropdown_right_snippet }}{% endhighlight %}
< div class = "columns" >
< div class = "column" >
2017-08-14 11:44:24 +00:00
< div class = "bd-example is-paddingless" >
2017-08-02 22:52:36 +00:00
{{ navbar_dropdown_right_example }}
< / div >
< / div >
< div class = "column" >
{% highlight html %}{{ navbar_dropdown_right_example }}{% endhighlight %}
< / div >
< / div >
2017-10-24 11:31:14 +00:00
< h4 class = "title is-4" >
Dropup
< / h4 >
{% include elements/new-tag.html version="0.6.1" %}
< div class = "content" >
< p >
If you're using a navbar at the bottom, like the < a href = "#fixed-navbar" > fixed bottom navbar< / a > , you might want to use a < strong > dropup menu< / strong > . Simply add the < code > has-dropdown< / code > and < code > has-dropdown-up< / code > modifiers to the parent < code > navbar-item< / code > .
< / p >
< / div >
{% highlight html %}{{ navbar_dropup_snippet }}{% endhighlight %}
< div class = "columns" >
< div class = "column" >
< div class = "bd-example is-paddingless" >
{{ navbar_dropup_example }}
< / div >
< / div >
< div class = "column" >
{% highlight html %}{{ navbar_dropup_example }}{% endhighlight %}
< / div >
< / div >
2017-07-02 21:07:30 +00:00
< h4 class = "title is-4" >
Styles for the dropdown menu
< / h4 >
< div class = "content" >
< p >
By default, the < code > navbar-dropdown< / code > has:
< / p >
< ul >
< li >
a grey < code > border-top< / code >
< / li >
< li >
a < code > border-radius< / code > at both bottom corners
< / li >
< / ul >
< / div >
< div class = "columns" >
< div class = "column" >
2017-08-14 11:44:24 +00:00
< div class = "bd-example is-paddingless" >
2017-07-02 21:07:30 +00:00
{{ navbar_dropdown_default_example }}
< / div >
< / div >
< div class = "column" >
{% highlight html %}{{ navbar_dropdown_default_example }}{% endhighlight %}
< / div >
< / div >
< div class = "content" >
< p >
When having a < a href = "#transparent-navbar" > transparent navbar< / a > , it is preferable to use the boxed version of the dropdown, by using the < code > is-boxed< / code > modifier.
< / p >
< ul >
< li >
the grey border is < strong > removed< / strong >
< / li >
< li >
a slight < strong > inner shadow< / strong > is added
< / li >
< li >
all corners are < strong > rounded< / strong >
< / li >
< li >
the hover/active state is < strong > animated< / strong >
< / li >
< / ul >
< / div >
< div class = "columns" >
< div class = "column" >
2017-08-14 11:44:24 +00:00
< div class = "bd-example is-paddingless" >
2017-07-02 21:07:30 +00:00
{{ navbar_dropdown_boxed_example }}
< / div >
< / div >
< div class = "column" >
{% highlight html %}{{ navbar_dropdown_boxed_example }}{% endhighlight %}
< / div >
< / div >
< h4 class = "title is-4" >
Active dropdown navbar item
< / h4 >
< div class = "columns" >
< div class = "column" >
2017-08-14 11:44:24 +00:00
< div class = "bd-example is-paddingless" >
2017-07-02 21:07:30 +00:00
{{ navbar_dropdown_item_active_example }}
< / div >
< / div >
< div class = "column" >
{% highlight html %}{{ navbar_dropdown_item_active_example }}{% endhighlight %}
< / div >
< / div >
< h4 class = "title is-4" >
Dropdown divider
< / h4 >
< div class = "content" >
< p >
You can add a < code > navbar-divider< / code > to display a < strong > horizontal rule< / strong > in a < code > navbar-dropdown< / code > .
< / p >
< / div >
{% highlight html %}{{ navbar_divider_example }}{% endhighlight %}
2017-09-09 21:56:54 +00:00
{% include anchor.html name="Colors" %}
< div class = "tags has-addons" >
< span class = "tag" > New!< / span >
< span class = "tag is-info" > 0.5.2< / span >
< / div >
2017-09-10 16:16:12 +00:00
< div class = "content" >
< p >
You can change the background color of the < code > navbar< / code > by using one of the < strong > 9 color modifiers:< / strong >
< / p >
< ul >
< li > < code > is-primary< / code > < / li >
2017-10-10 09:22:28 +00:00
< li > < code > is-link< / code > < / li >
2017-09-10 16:16:12 +00:00
< li > < code > is-info< / code > < / li >
< li > < code > is-success< / code > < / li >
< li > < code > is-warning< / code > < / li >
< li > < code > is-danger< / code > < / li >
< li > < code > is-black< / code > < / li >
< li > < code > is-dark< / code > < / li >
< li > < code > is-light< / code > < / li >
< li > < code > is-white< / code > < / li >
< / ul >
< / div >
2017-09-10 16:04:54 +00:00
{% highlight html %}{{ navbar_color_markup }}{% endhighlight %}
< div class = "bd-example is-paddingless" >
{% include examples/navbar-color.html color="primary" %}
< / div >
< div class = "bd-example is-paddingless" >
2017-10-10 09:22:28 +00:00
{% include examples/navbar-color.html color="link" %}
< / div >
< div class = "bd-example is-paddingless" >
2017-09-10 16:04:54 +00:00
{% include examples/navbar-color.html color="info" %}
< / div >
2017-09-09 21:56:54 +00:00
< div class = "bd-example is-paddingless" >
2017-09-10 16:04:54 +00:00
{% include examples/navbar-color.html color="success" %}
2017-09-09 21:56:54 +00:00
< / div >
2017-09-10 16:04:54 +00:00
< div class = "bd-example is-paddingless" >
2017-09-10 16:16:12 +00:00
{% include examples/navbar-color.html color="warning" light=true %}
2017-09-10 16:04:54 +00:00
< / div >
< div class = "bd-example is-paddingless" >
{% include examples/navbar-color.html color="danger" %}
< / div >
2017-09-09 21:56:54 +00:00
2017-09-10 16:16:12 +00:00
< div class = "bd-example is-paddingless" >
{% include examples/navbar-color.html color="black" %}
< / div >
< div class = "bd-example is-paddingless" >
{% include examples/navbar-color.html color="dark" %}
< / div >
< div class = "bd-example is-paddingless" >
{% include examples/navbar-color.html color="light" light=true %}
< / div >
< div class = "bd-example is-paddingless" >
{% include examples/navbar-color.html color="white" light=true %}
< / div >
2017-10-17 09:28:59 +00:00
{% include variables.html type='component' %}
2017-07-28 22:27:59 +00:00
2017-07-01 17:30:39 +00:00
< / div >
< / section >