Mastheads are responsive meta components that serve as navigation headers for your application or site. They begin collapsed (and are toggleable) in mobile views and become horizontal as the available viewport width increases.
Justified masthead nav links are currently not supported.
Since TODC Bootstrap doesn't know how much space the content in your masthead needs, you might run into issues with content wrapping into a second row. To resolve this, you can:
@grid-float-breakpoint
variable or add your own media query.If JavaScript is disabled and the viewport is narrow enough that the navbar collapses, it will be impossible to expand the navbar and view the content within the .navbar-collapse
.
The responsive masthead requires the collapse plugin to be included in your version of Bootstrap.
Depending on the content in your masthead, you might need to change the point at which your masthead switches between collapsed and horizontal mode. Customize the @grid-float-breakpoint
variable or add your own media query.
Be sure to add a role="navigation"
to every masthead to help with accessibility.
Replace the navbar brand with your own image by swapping the text for an <img>
. Since the .navbar-brand
has its own padding and height, you may need to override some CSS depending on your image.
Place form content within .navbar-form
for proper vertical alignment and collapsed behavior in narrow viewports. Use the alignment options to decide where it resides within the navbar content.
As a heads up, .navbar-form
shares much of its code with .form-inline
via mixin. Some form controls, like input groups, may require fixed widths to be show up properly within a masthead.
Add the .navbar-btn
class to <button>
elements not residing in a <form>
to vertically center them in the masthead.
Wrap strings of text in an element with .navbar-text
, usually on a <p>
tag for proper leading and color.
For folks using standard links that are not within the regular navbar navigation component, use the .navbar-link
class to add the proper colors for the default and inverse navbar options.
Align nav links, forms, buttons, or text, using the .navbar-left
or .navbar-right
utility classes. Both classes will add a CSS float in the specified direction. For example, to align nav links, put them in a separate <ul>
with the respective utility class applied.
These classes are mixin-ed versions of .pull-left
and .pull-right
, but they're scoped to media queries for easier handling of navbar components across device sizes.
Mastheads currently have a limitation with multiple .navbar-right
classes. To properly space content, we use negative margin on the last .navbar-right
element. When there are multiple elements using that class, these margins don't work as intended.
We'll revisit this when we can rewrite that component in v4.
Add .navbar-fixed-top
and include a .container
or .container-fluid
to center and pad navbar content.
The fixed masthead will overlay your other content, unless you add padding
to the top of the <body>
. Try out your own values or use our snippet below. Tip: By default, the navbar is 44px high.
Make sure to include this after the core Bootstrap CSS.
Add .navbar-fixed-bottom
and include a .container
or .container-fluid
to center and pad navbar content.
The fixed masthead will overlay your other content, unless you add padding
to the bottom of the <body>
. Try out your own values or use our snippet below. Tip: By default, the navbar is 44px high.
Make sure to include this after the core Bootstrap CSS.
Create a full-width navbar that scrolls away with the page by adding .navbar-static-top
and include a .container
or .container-fluid
to center and pad navbar content.
Unlike the .navbar-fixed-*
classes, you do not need to change any padding on the body
.
Modify the look of the navbar by adding .navbar-inverse
.