mirror of
https://github.com/twbs/bootstrap.git
synced 2024-12-10 22:24:19 +01:00
b648a77ed3
Conflicts: Gruntfile.js _config.yml dist/css/bootstrap-theme.css dist/css/bootstrap-theme.min.css dist/css/bootstrap.css dist/css/bootstrap.css.map dist/css/bootstrap.min.css dist/fonts/glyphicons-halflings-regular.eot dist/fonts/glyphicons-halflings-regular.svg dist/fonts/glyphicons-halflings-regular.ttf dist/fonts/glyphicons-halflings-regular.woff docs/_data/glyphicons.yml docs/_includes/components/alerts.html docs/_includes/components/badges.html docs/_includes/components/button-dropdowns.html docs/_includes/components/button-groups.html docs/_includes/components/dropdowns.html docs/_includes/components/glyphicons.html docs/_includes/components/input-groups.html docs/_includes/components/labels.html docs/_includes/components/media.html docs/_includes/components/navbar.html docs/_includes/components/navs.html docs/_includes/components/pagination.html docs/_includes/components/panels.html docs/_includes/components/progress-bars.html docs/_includes/css/buttons.html docs/_includes/css/forms.html docs/_includes/css/grid.html docs/_includes/css/helpers.html docs/_includes/css/images.html docs/_includes/css/less.html docs/_includes/css/responsive-utilities.html docs/_includes/css/sass.html docs/_includes/css/tables.html docs/_includes/css/type.html docs/_includes/getting-started/accessibility.html docs/_includes/getting-started/browser-device-support.html docs/_includes/getting-started/community.html docs/_includes/getting-started/download.html docs/_includes/getting-started/examples.html docs/_includes/getting-started/whats-included.html docs/_includes/js/affix.html docs/_includes/js/alerts.html docs/_includes/js/buttons.html docs/_includes/js/carousel.html docs/_includes/js/collapse.html docs/_includes/js/dropdowns.html docs/_includes/js/modal.html docs/_includes/js/overview.html docs/_includes/js/tabs.html docs/_includes/nav/components.html docs/_includes/nav/css.html docs/_includes/nav/javascript.html docs/_includes/nav/main.html docs/about.html docs/assets/css/docs.min.css docs/assets/js/customize.min.js docs/assets/js/raw-files.min.js docs/dist/css/bootstrap-theme.css docs/dist/css/bootstrap-theme.min.css docs/dist/css/bootstrap.css docs/dist/css/bootstrap.css.map docs/dist/css/bootstrap.min.css docs/dist/fonts/glyphicons-halflings-regular.eot docs/dist/fonts/glyphicons-halflings-regular.svg docs/dist/fonts/glyphicons-halflings-regular.ttf docs/dist/fonts/glyphicons-halflings-regular.woff docs/examples/carousel/index.html docs/examples/navbar-fixed-top/index.html docs/examples/navbar-static-top/index.html docs/examples/navbar/index.html docs/examples/non-responsive/index.html docs/examples/non-responsive/non-responsive.css docs/examples/sticky-footer-navbar/index.html docs/examples/theme/index.html fonts/glyphicons-halflings-regular.eot fonts/glyphicons-halflings-regular.svg fonts/glyphicons-halflings-regular.ttf fonts/glyphicons-halflings-regular.woff less/_carousel.less less/_forms.less less/glyphicons.less
170 lines
4.6 KiB
Markdown
170 lines
4.6 KiB
Markdown
---
|
|
layout: page
|
|
title: Navbar
|
|
---
|
|
|
|
The navbar is a simple wrapper for positioning branding, navigation, and other elements. It's easily extensible and with the help of our collapse plugin it can easily integrate offscreen content.
|
|
|
|
### Basics
|
|
|
|
Here's what you need to know before getting started with the navbar:
|
|
|
|
- Navbars require a wrapping `.navbar` and either a color scheme class or custom styles.
|
|
- When using multiple components in a navbar, some [alignment classes](#alignment) are required.
|
|
- Navbars and their contents are fluid by default. Use [optional containers](#containers) to limit their horizontal width.
|
|
- Ensure accessibility by using a `<nav>` element or, if using a more generic element such as a `<div>`, add a `role="navigation"` to every navbar to explicitly identify it as a landmark region for users of assistive technologies.
|
|
|
|
### Branding
|
|
|
|
Name your company, product, or project with `.navbar-brand`.
|
|
|
|
{% example html %}
|
|
<nav class="navbar navbar-default">
|
|
<h3 class="navbar-brand">
|
|
<a href="#">Navbar</a>
|
|
</h3>
|
|
</nav>
|
|
{% endexample %}
|
|
|
|
### Navigation
|
|
|
|
Use `.nav-pills` within a navbar for basic navigation.
|
|
|
|
{% example html %}
|
|
<nav class="navbar navbar-default">
|
|
<ul class="nav nav-pills">
|
|
<li class="nav-item active">
|
|
<a class="nav-link" href="#">Home <span class="sr-only">(current)</span></a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">Features</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">Pricing</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">About</a>
|
|
</li>
|
|
</ul>
|
|
</nav>
|
|
{% endexample %}
|
|
|
|
### Inline forms
|
|
|
|
Add an `.inline-form` within the navbar with nearly any combination of form controls and buttons.
|
|
|
|
{% example html %}
|
|
<nav class="navbar navbar-default">
|
|
<form class="form-inline">
|
|
<input class="form-control" type="text" placeholder="Search">
|
|
<button class="btn btn-primary" type="submit">Search</button>
|
|
</form>
|
|
</nav>
|
|
{% endexample %}
|
|
|
|
### Containers
|
|
|
|
Although it's not required, you can wrap a navbar in a `.container` or add one within for basic horizontal control.
|
|
|
|
{% example html %}
|
|
<nav class="navbar navbar-default">
|
|
<div class="container">
|
|
<h3 class="navbar-brand">
|
|
<a href="#">Navbar</a>
|
|
</h3>
|
|
</div>
|
|
</nav>
|
|
{% endexample %}
|
|
|
|
{% example html %}
|
|
<div class="container">
|
|
<nav class="navbar navbar-default">
|
|
<h3 class="navbar-brand">
|
|
<a href="#">Navbar</a>
|
|
</h3>
|
|
</nav>
|
|
</div>
|
|
{% endexample %}
|
|
|
|
### Alignment
|
|
|
|
Use `.pull-left` or `.pull-right` to align multiple elements within the navbar.
|
|
|
|
{% example html %}
|
|
<nav class="navbar navbar-default">
|
|
<h3 class="navbar-brand pull-left">
|
|
<a href="#">Navbar</a>
|
|
</h3>
|
|
<ul class="nav nav-pills pull-left">
|
|
<li class="nav-item active">
|
|
<a class="nav-link" href="#">Home <span class="sr-only">(current)</span></a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">Features</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">Pricing</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">About</a>
|
|
</li>
|
|
</ul>
|
|
<ul class="nav nav-pills pull-right">
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">Help</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">Sign out</a>
|
|
</li>
|
|
</ul>
|
|
</nav>
|
|
{% endexample %}
|
|
|
|
### Inverse color scheme
|
|
|
|
Replace `.navbar-default` with `.navbar-inverse` for a darker background color and white text.
|
|
|
|
{% example html %}
|
|
<nav class="navbar navbar-inverse">
|
|
<h3 class="navbar-brand pull-left">
|
|
<a href="#">Navbar</a>
|
|
</h3>
|
|
<ul class="nav nav-pills pull-left">
|
|
<li class="nav-item active">
|
|
<a class="nav-link" href="#">Home <span class="sr-only">(current)</span></a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">Features</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">Pricing</a>
|
|
</li>
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="#">About</a>
|
|
</li>
|
|
</ul>
|
|
<form class="form-inline pull-right">
|
|
<input class="form-control" type="text" placeholder="Search">
|
|
<button class="btn btn-primary" type="submit">Search</button>
|
|
</form>
|
|
</nav>
|
|
{% endexample %}
|
|
|
|
### Collapsible content
|
|
|
|
Our collapse plugin allows you to use a `<button>` or `<a>` to toggle hidden content.
|
|
|
|
{% example html %}
|
|
<div class="collapse" id="navbar-header">
|
|
<div class="inverse p-a">
|
|
<h3>Collapsed content</h3>
|
|
<p>Toggleable via the navbar brand.</p>
|
|
</div>
|
|
</div>
|
|
<nav class="navbar navbar-default">
|
|
<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbar-header">
|
|
☰
|
|
</button>
|
|
</nav>
|
|
{% endexample %}
|