Components
Over a dozen reusable components built to provide iconography, dropdowns, input groups, navigation, alerts, and much more.
Visma icons Visma
The default size of the icons is 24x24.
Work surface + Toolbar icons
- vismaicon vismaicon-briefcase
- vismaicon vismaicon-new
- vismaicon vismaicon-note
- vismaicon vismaicon-note-blank
- vismaicon vismaicon-note-filled
- vismaicon vismaicon-edit
- vismaicon vismaicon-copy
- vismaicon vismaicon-paste
- vismaicon vismaicon-cut
- vismaicon vismaicon-save
- vismaicon vismaicon-delete
- vismaicon vismaicon-attach
- vismaicon vismaicon-print
- vismaicon vismaicon-refresh
- vismaicon vismaicon-comment
- vismaicon vismaicon-unread-comment
- vismaicon vismaicon-add-comment
- vismaicon vismaicon-user
- vismaicon vismaicon-users
- vismaicon vismaicon-add-user
- vismaicon vismaicon-user-folder
- vismaicon vismaicon-user-placeholder
- vismaicon vismaicon-like
- vismaicon vismaicon-dislike
- vismaicon vismaicon-zoom-in
- vismaicon vismaicon-zoom-out
- vismaicon vismaicon-rotate-ccw
- vismaicon vismaicon-rotate-cw
- vismaicon vismaicon-replace
- vismaicon vismaicon-undo
- vismaicon vismaicon-redo
- vismaicon vismaicon-flag
- vismaicon vismaicon-report
- vismaicon vismaicon-graphs
- vismaicon vismaicon-home
- vismaicon vismaicon-search
- vismaicon vismaicon-employee
- vismaicon vismaicon-email
- vismaicon vismaicon-phone
- vismaicon vismaicon-locked
- vismaicon vismaicon-unlocked
- vismaicon vismaicon-money
- vismaicon vismaicon-open
- vismaicon vismaicon-upload
- vismaicon vismaicon-download
- vismaicon vismaicon-preview
- vismaicon vismaicon-favourite
- vismaicon vismaicon-filter
- vismaicon vismaicon-link
- vismaicon vismaicon-xml
- vismaicon vismaicon-web
- vismaicon vismaicon-office-word
- vismaicon vismaicon-office-powerpoint
- vismaicon vismaicon-office-excel
- vismaicon vismaicon-pdf
- vismaicon vismaicon-text-document
- vismaicon vismaicon-image-document
- vismaicon vismaicon-xml-document
- vismaicon vismaicon-archive-document
- vismaicon vismaicon-document-info
- vismaicon vismaicon-undifined-document
- vismaicon vismaicon-contract
- vismaicon vismaicon-video
- vismaicon vismaicon-sound
- vismaicon vismaicon-export
- vismaicon vismaicon-changelog
- vismaicon vismaicon-time
- vismaicon vismaicon-reminder
- vismaicon vismaicon-hourglass
- vismaicon vismaicon-alert
- vismaicon vismaicon-announcement
- vismaicon vismaicon-break
- vismaicon vismaicon-lunch
- vismaicon vismaicon-breadcrumb-folder
- vismaicon vismaicon-detach
- vismaicon vismaicon-enter-full-screen
- vismaicon vismaicon-exit-full-screen
- vismaicon vismaicon-drag
- vismaicon vismaicon-evaluate
- vismaicon vismaicon-exclude
- vismaicon vismaicon-folder-building
- vismaicon vismaicon-office-building
- vismaicon vismaicon-location
- vismaicon vismaicon-logon-failed
- vismaicon vismaicon-panel
- vismaicon vismaicon-price
- vismaicon vismaicon-secret-document
- vismaicon vismaicon-send
- vismaicon vismaicon-sending-failed
- vismaicon vismaicon-shared
- vismaicon vismaicon-education
- vismaicon vismaicon-filter-column
<span class="vismaicon vismaicon-print" aria-hidden="true"></span>Action icons
- vismaicon vismaicon-menu-circle
- vismaicon vismaicon-add-circle
- vismaicon vismaicon-add2-circle
- vismaicon vismaicon-remove-circle
- vismaicon vismaicon-ok-circle
- vismaicon vismaicon-cancel-circle
- vismaicon vismaicon-arrow-up-circle
- vismaicon vismaicon-arrow-down-circle
- vismaicon vismaicon-arrow-left-circle
- vismaicon vismaicon-arrow-right-circle
- vismaicon vismaicon-expand-circle
- vismaicon vismaicon-collapse-circle
- vismaicon vismaicon-other-circle
- vismaicon vismaicon-forward-circle
- vismaicon vismaicon-rewind-circle
- vismaicon vismaicon-pause-circle
- vismaicon vismaicon-play-circle
- vismaicon vismaicon-first-circle
- vismaicon vismaicon-last-circle
- vismaicon vismaicon-move-up-circle
- vismaicon vismaicon-move-left-circle
- vismaicon vismaicon-move-right-circle
- vismaicon vismaicon-move-down-circle
<span class="vismaicon vismaicon-menu-circle" aria-hidden="true"></span>Informative filled icons
<span class="vismaicon vismaicon-filled vismaicon-success" aria-hidden="true"></span>Top Menu Icons
<span class="vismaicon vismaicon-menu vismaicon-user" aria-hidden="true"></span>Social Media Icons
- vismaicon vismaicon-facebook
- vismaicon vismaicon-flickr
- vismaicon vismaicon-google
- vismaicon vismaicon-linkedin
- vismaicon vismaicon-pinterest
- vismaicon vismaicon-skype
- vismaicon vismaicon-tumblr
- vismaicon vismaicon-twitter
- vismaicon vismaicon-vimeo
- vismaicon vismaicon-youtube
<span class="vismaicon vismaicon-menu vismaicon-user" aria-hidden="true"></span>Interface controls
- vismaicon vismaicon-datepicker
- vismaicon vismaicon-autocomplete
- vismaicon vismaicon-multiselection
<span class="vismaicon vismaicon-datepicker" aria-hidden="true"></span>Sizes
The small size of the icons is 16x16. Just use vismaicon-sm class for the smaller version.
There is also a larger sizes, 50x50, but just for the Informative filled icons. For this case use vismaicon-lg class.
Small work surface + Toolbar icons
- vismaicon vismaicon-sm vismaicon-briefcase
- vismaicon vismaicon-sm vismaicon-new
- vismaicon vismaicon-sm vismaicon-note
- vismaicon vismaicon-sm vismaicon-edit
- vismaicon vismaicon-sm vismaicon-copy
- vismaicon vismaicon-sm vismaicon-paste
- vismaicon vismaicon-sm vismaicon-cut
- vismaicon vismaicon-sm vismaicon-save
- vismaicon vismaicon-sm vismaicon-delete
- vismaicon vismaicon-sm vismaicon-attach
- vismaicon vismaicon-sm vismaicon-print
- vismaicon vismaicon-sm vismaicon-refresh
- vismaicon vismaicon-sm vismaicon-comment
- vismaicon vismaicon-sm vismaicon-unread-comment
- vismaicon vismaicon-sm vismaicon-add-comment
- vismaicon vismaicon-sm vismaicon-user
- vismaicon vismaicon-sm vismaicon-users
- vismaicon vismaicon-sm vismaicon-like
- vismaicon vismaicon-sm vismaicon-dislike
- vismaicon vismaicon-sm vismaicon-zoom-in
- vismaicon vismaicon-sm vismaicon-zoom-out
- vismaicon vismaicon-sm vismaicon-undo
- vismaicon vismaicon-sm vismaicon-redo
- vismaicon vismaicon-sm vismaicon-flag
- vismaicon vismaicon-sm vismaicon-report
- vismaicon vismaicon-sm vismaicon-graphs
- vismaicon vismaicon-sm vismaicon-home
- vismaicon vismaicon-sm vismaicon-search
- vismaicon vismaicon-sm vismaicon-employee
- vismaicon vismaicon-sm vismaicon-email
- vismaicon vismaicon-sm vismaicon-phone
- vismaicon vismaicon-sm vismaicon-locked
- vismaicon vismaicon-sm vismaicon-unlocked
- vismaicon vismaicon-sm vismaicon-money
- vismaicon vismaicon-sm vismaicon-open
- vismaicon vismaicon-sm vismaicon-upload
- vismaicon vismaicon-sm vismaicon-download
- vismaicon vismaicon-sm vismaicon-preview
- vismaicon vismaicon-sm vismaicon-favourite
- vismaicon vismaicon-sm vismaicon-filter
- vismaicon vismaicon-sm vismaicon-web
- vismaicon vismaicon-sm vismaicon-office-word
- vismaicon vismaicon-sm vismaicon-office-powerpoint
- vismaicon vismaicon-sm vismaicon-office-excel
- vismaicon vismaicon-sm vismaicon-pdf
- vismaicon vismaicon-sm vismaicon-export
- vismaicon vismaicon-sm vismaicon-changelog
- vismaicon vismaicon-sm vismaicon-time
- vismaicon vismaicon-sm vismaicon-reminder
Small action icons
- vismaicon vismaicon-sm vismaicon-menu-circle
- vismaicon vismaicon-sm vismaicon-add-circle
- vismaicon vismaicon-sm vismaicon-add2-circle
- vismaicon vismaicon-sm vismaicon-remove-circle
- vismaicon vismaicon-sm vismaicon-ok-circle
- vismaicon vismaicon-sm vismaicon-cancel-circle
- vismaicon vismaicon-sm vismaicon-arrow-up-circle
- vismaicon vismaicon-sm vismaicon-arrow-down-circle
- vismaicon vismaicon-sm vismaicon-arrow-left-circle
- vismaicon vismaicon-sm vismaicon-arrow-right-circle
- vismaicon vismaicon-sm vismaicon-expand-circle
- vismaicon vismaicon-sm vismaicon-collapse-circle
- vismaicon vismaicon-sm vismaicon-other-circle
- vismaicon vismaicon-sm vismaicon-forward-circle
- vismaicon vismaicon-sm vismaicon-rewind-circle
- vismaicon vismaicon-sm vismaicon-pause-circle
- vismaicon vismaicon-sm vismaicon-play-circle
- vismaicon vismaicon-sm vismaicon-first-circle
- vismaicon vismaicon-sm vismaicon-last-circle
- vismaicon vismaicon-sm vismaicon-move-up-circle
- vismaicon vismaicon-sm vismaicon-move-left-circle
- vismaicon vismaicon-sm vismaicon-move-right-circle
- vismaicon vismaicon-sm vismaicon-move-down-circle
Informative filled icons
Small - vismaicon-sm
Large - vismaicon-lg
Disabled states
For the disabled version of the icons, simply use disabled class, like in the example below.
- vismaicon vismaicon-print disabled
- vismaicon vismaicon-sm vismaicon-print disabled
- vismaicon vismaicon-menu-circle disabled
- vismaicon vismaicon-sm vismaicon-menu-circle disabled
- vismaicon vismaicon-facebook disabled
- vismaicon vismaicon-google disabled
<span class="vismaicon vismaicon-print disabled" aria-hidden="true"></span>
<span class="vismaicon vismaicon-sm vismaicon-print disabled" aria-hidden="true"></span>How to use
For performance reasons, all icons require a base class and individual icon class. To use, place the following code just about anywhere. Be sure to leave a space between the icon and text for proper padding.
Don't mix with other components
Icon classes cannot be directly combined with other components. They should not be used along with other classes on the same element. Instead, add a nested <span> and apply the icon classes to the <span>.
Only for use on empty elements
Icon classes should only be used on elements that contain no text content and have no child elements.
Accessible icons
Modern versions of assistive technologies will announce CSS generated content, as well as specific Unicode characters. To avoid unintended and confusing output in screen readers (particularly when icons are used purely for decoration), we hide them with the aria-hidden="true" attribute.
If you're using an icon to convey meaning (rather than only as a decorative element), ensure that this meaning is also conveyed to assistive technologies – for instance, include additional content, visually hidden with the .sr-only class.
If you're creating controls with no other text (such as a <button> that only contains an icon), you should always provide alternative content to identify the purpose of the control, so that it will make sense to users of assistive technologies. In this case, you could add an aria-label attribute on the control itself.
Examples
Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.
Here you can find more details about how to use the icons in a top navigation.
<!-- Icons in button toolbar -->
<div role="toolbar" class="btn-toolbar">
<div class="btn-group">
<button type="button" class="btn btn-default" aria-label="Left">
<span class="vismaicon vismaicon-sm vismaicon-arrow-left-circle" aria-hidden="true"></span>
</button>
<button type="button" class="btn btn-default" aria-label="Center">
<span class="vismaicon vismaicon-sm vismaicon-other-circle" aria-hidden="true"></span>
</button>
<button type="button" class="btn btn-default" aria-label="Right">
<span class="vismaicon vismaicon-sm vismaicon-arrow-right-circle" aria-hidden="true"></span>
</button>
</div>
</div>
<!-- Icons in buttons -->
<button type="button" class="btn btn-default btn-lg">
<span class="vismaicon vismaicon-favourite" aria-hidden="true"></span> Star
</button>
<button type="button" class="btn btn-default">
<span class="vismaicon vismaicon-sm vismaicon-favourite" aria-hidden="true"></span>
</button>
<!-- Top menu icons in navigation -->
<nav class="navbar navbar-default">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-navbar-collapse-vismaicons">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<div class="active-on-mobile"> </div>
<a class="navbar-brand" href="#">Visma Product</a>
</div>
<div class="collapse navbar-collapse" id="bs-navbar-collapse-vismaicons">
<ul class="nav navbar-nav navbar-right">
<li class="icon">
<a href="#">
<span class="vismaicon vismaicon-menu vismaicon-user" aria-hidden="true"></span>
</a>
</li>
</ul>
</div>
</nav>An icon used in an alert to convey that it's an error message, with additional .sr-only text to convey this hint to users of assistive technologies.
Error:
Enter a valid email address
<div class="alert alert-danger" role="alert">
<div>
<span class="vismaicon vismaicon-lg vismaicon-filled vismaicon-error" aria-hidden="true"></span>
<span class="sr-only">Error:</span>
Enter a valid email address
</div>
</div>Favicons
The web library comes with a set of favicons for web browsers, Android, iOS and Windows tiles. By default, it's the Visma logo. If your product is using a product icon, replace the images in img/favicons/ with your product icon in the appropriate sizes.
<link rel="icon" type="image/png" href="img/favicons/favicon-16x16.png" sizes="16x16" />
<link rel="icon" type="image/png" href="img/favicons/favicon-32x32.png" sizes="32x32" />
Dropdowns
Toggleable, contextual menu for displaying lists of links. Made interactive with the dropdown JavaScript plugin.
Example
Wrap the dropdown's trigger and the dropdown menu within .dropdown, or another element that declares position: relative;. Then add the menu's HTML.
<div class="dropdown">
<button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true">
Dropdown
<span class="caret"></span>
</button>
<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu1">
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Action</a></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Another action</a></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Something here</a></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Separated link</a></li>
</ul>
</div>Dropdown menus can be changed to expand upwards (instead of downwards) by adding .dropup to the parent.
<div class="dropup">
<button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu2" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Dropup
<span class="caret"></span>
</button>
<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu2">
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Action</a></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Another action</a></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Something here</a></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Separated link</a></li>
</ul>
</div>Alignment
By default, a dropdown menu is automatically positioned 100% from the top and along the left side of its parent. Add .dropdown-menu-right to a .dropdown-menu to right align the dropdown menu.
May require additional positioning
Dropdowns are automatically positioned via CSS within the normal flow of the document. This means dropdowns may be cropped by parents with certain overflow properties or appear out of bounds of the viewport. Address these issues on your own as they arise.
Deprecated .pull-right alignment
As of v3.1.0, we've deprecated .pull-right on dropdown menus. To right-align a menu, use .dropdown-menu-right. Right-aligned nav components in the navbar use a mixin version of this class to automatically align the menu. To override it, use .dropdown-menu-left.
<ul class="dropdown-menu dropdown-menu-right" role="menu" aria-labelledby="dLabel">
...
</ul>Headers
Add a header to label sections of actions in any dropdown menu.
<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu2">
...
<li role="presentation" class="dropdown-header">Dropdown header</li>
...
</ul>Disabled menu items
Add .disabled to a <li> in the dropdown to disable the link.
<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu3">
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Regular link</a></li>
<li role="presentation" class="disabled"><a role="menuitem" tabindex="-1" href="#">Disabled link</a></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Another link</a></li>
</ul>Button groups
Group a series of buttons together on a single line with the button group. Add on optional JavaScript radio and checkbox style behavior with our buttons plugin.
Tooltips & popovers in button groups require special setting
When using tooltips or popovers on elements within a .btn-group, you'll have to specify the option container: 'body' to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip or popover is triggered).
Ensure correct role and provide a label
In order for assistive technologies – such as screen readers – to convey that a series of buttons is grouped, an appropriate role attribute needs to be provided. For button groups, this would be role="group", while toolbars should have a role="toolbar".
One exception are groups which only contain a single control (for instance the justified button groups with <button> elements) or a dropdown.
In addition, groups and toolbars should be given an explicit label, as most assistive technologies will otherwise not announce them, despite the presence of the correct role attribute. In the examples provided here, we use aria-label, but alternatives such as aria-labelledby can also be used.
Basic example
Wrap a series of buttons with .btn in .btn-group and .btn-toolbar.
<div class="btn-toolbar" role="toolbar" aria-label="...">
<div class="btn-group" role="group" aria-label="...">
<button type="button" class="btn btn-default">Left</button>
<button type="button" class="btn btn-default">Middle</button>
<button type="button" class="btn btn-default">Right</button>
</div>
</div>Button toolbar
Combine sets of <div class="btn-group"> into a <div class="btn-toolbar"> for more complex components.
<div class="btn-toolbar" role="toolbar" aria-label="...">
<div class="btn-group" role="group" aria-label="...">
<button type="button" class="btn btn-default">1</button>
<button type="button" class="btn btn-default">2</button>
<button type="button" class="btn btn-default">3</button>
</div>
</div>
<div class="btn-toolbar" role="toolbar"
<div class="btn-group" role="group" aria-label="...">
<button type="button" class="btn btn-default">4</button>
<button type="button" class="btn btn-default">5</button>
</div>
<div class="btn-group" role="group" aria-label="...">
<button type="button" class="btn btn-default">8</button>
</div>
</div>Options
Use any of the following classes to each .btn-toolbar to quickly create a styled button toolbar: .btn-toolbar-default (or leave it simple .btn-toolbar) or .btn-toolbar-primary. The difference is just for the active state of each item from the button toolbar.
<!-- Default - full size -->
<div class="btn-toolbar btn-toolbar-default" role="toolbar" aria-label="...">
<div class="btn-group" role="group" aria-label="...">
<button type="button" class="btn btn-default active">Left</button>
<button type="button" class="btn btn-default">Middle</button>
<button type="button" class="btn btn-default">Right</button>
</div>
</div>
<!-- Default - larger size -->
<div class="btn-toolbar btn-toolbar-default" role="toolbar" aria-label="...">
<div class="btn-group btn-group-lg" role="group" aria-label="...">
<button type="button" class="btn btn-default active">Left</button>
<button type="button" class="btn btn-default">Middle</button>
<button type="button" class="btn btn-default">Right</button>
</div>
</div>
<!-- Primary - full size -->
<div class="btn-toolbar btn-toolbar-primary" role="toolbar" aria-label="...">
<div class="btn-group" role="group" aria-label="...">
<button type="button" class="btn btn-default active">Left</button>
<button type="button" class="btn btn-default">Middle</button>
<button type="button" class="btn btn-default">Right</button>
</div>
</div>
<!-- Primary - larger size -->
<div class="btn-toolbar btn-toolbar-primary" role="toolbar" aria-label="...">
<div class="btn-group btn-group-lg" role="group" aria-label="...">
<button type="button" class="btn btn-default active">Left</button>
<button type="button" class="btn btn-default">Middle</button>
<button type="button" class="btn btn-default">Right</button>
</div>
</div>Sizing
Instead of applying button sizing classes to every button in a group, just add .btn-group-sm to each .btn-group, for a smaller size, or leave it simple, .btn-group, for the default size.
<!-- Default -->
<div class="btn-toolbar btn-toolbar-default" role="toolbar" aria-label="...">
<div class="btn-group" role="group" aria-label="...">
<button type="button" class="btn btn-default">Left</button>
<button type="button" class="btn btn-default">Middle</button>
<button type="button" class="btn btn-default">Right</button>
</div>
</div>
<!-- Large -->
<div class="btn-toolbar btn-toolbar-default" role="toolbar" aria-label="...">
<div class="btn-group btn-group-lg" role="group" aria-label="...">
<button type="button" class="btn btn-default">Left</button>
<button type="button" class="btn btn-default">Middle</button>
<button type="button" class="btn btn-default">Right</button>
</div>
</div>Nesting
Place a .btn-group within another .btn-group when you want dropdown menus mixed with a series of buttons.
<div class="btn-toolbar" role="toolbar" aria-label="...">
<div class="btn-group" role="group" aria-label="...">
<button type="button" class="btn btn-default">1</button>
<button type="button" class="btn btn-default">2</button>
<div class="btn-group" role="group">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Dropdown
<span class="caret"></span>
</button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Dropdown link</a></li>
<li><a href="#">Dropdown link</a></li>
</ul>
</div>
</div>
</div>Vertical variation
Make a set of buttons appear vertically stacked rather than horizontally. Split button dropdowns are not supported here.
<div class="btn-group-vertical" role="group" aria-label="...">
...
</div>Add a .disabled class to disabled all buttons in that group.
<div class="btn-group-vertical disabled" role="group" aria-label="...">
...
</div>Justified button groups
Make a group of buttons stretch at equal sizes to span the entire width of its parent. Also works with button dropdowns within the button group.
Handling borders
Due to the specific HTML and CSS used to justify buttons (namely display: table-cell), the borders between them are doubled. In regular button groups, margin-left: -1px is used to stack the borders instead of removing them. However, margin doesn't work with display: table-cell. As a result, depending on your customizations to Bootstrap, you may wish to remove or re-color the borders.
With <a> elements
Just wrap a series of .btns in .btn-group.btn-group-justified.
<div class="btn-group btn-group-justified" role="group" aria-label="...">
...
</div>Links acting as buttons
If the <a> elements are used to act as buttons – triggering in-page functionality, rather than navigating to another document or section within the current page – they should also be given an appropriate role="button".
With <button> elements
To use justified button groups with <button> elements, you must wrap each button in a button group. Most browsers don't properly apply our CSS for justification to <button> elements, but since we support button dropdowns, we can work around that.
<div class="btn-group btn-group-justified" role="group" aria-label="...">
<div class="btn-group" role="group">
<button type="button" class="btn btn-default">Left</button>
</div>
<div class="btn-group" role="group">
<button type="button" class="btn btn-default">Middle</button>
</div>
<div class="btn-group" role="group">
<button type="button" class="btn btn-default">Right</button>
</div>
</div>Button dropdowns
Use any button to trigger a dropdown menu by placing it within a .btn-group and providing the proper menu markup.
Plugin dependency
Button dropdowns require the dropdown plugin to be included in your version of Bootstrap.
Single button dropdowns
Turn a button into a dropdown toggle with some basic markup changes.
<!-- Single button -->
<div class="btn-group">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Action <span class="caret"></span>
</button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>Disabled state for the simple dropdown button.
<!-- Single button with a class 'disabled' -->
<div class="btn-group">
<button type="button" class="btn btn-default dropdown-toggle disabled" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Action <span class="caret"></span>
</button>
<ul>
...
</ul>
</div><!-- Single button with the atribute 'disabled' -->
<div class="btn-group">
<button type="button" class="btn btn-primary dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false" disabled>
Action <span class="caret"></span>
</button>
<ul>
...
</ul>
</div>Split button dropdowns
Similarly, create split button dropdowns with the same markup changes, only with a separate button.
<!-- Split button - with button tag -->
<div class="btn-group btn-split">
<button type="button" class="btn btn-default">Action</button>
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
<span class="caret"></span>
<span class="sr-only">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
<!-- Split button - with a tag -->
<div class="btn-group btn-split">
<a href="#" class="btn btn-default">Action</a>
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
<span class="caret"></span>
<span class="sr-only">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
Disabled state for the split button dropdowns - with dropdown disabled.
<!-- Split button - with button tag -->
<div class="btn-group btn-split">
<button type="button" class="btn btn-default">Action</button>
<button type="button" class="btn btn-default dropdown-toggle disabled" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
<span class="caret"></span>
<span class="sr-only">Toggle Dropdown</span>
</button>
<ul>
...
</ul>
</div>
<!-- Split button - with a tag -->
<div class="btn-group btn-split">
<a href="#" class="btn btn-default">Action</a>
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false" disabled>
<span class="caret"></span>
<span class="sr-only">Toggle Dropdown</span>
</button>
<ul>
...
</ul>
</div>
Disabled state for the split button dropdowns - with the hole group disabled.
<!-- Split button - with button tag -->
<div class="btn-group btn-split disabled">
<button type="button" class="btn btn-default">Action</button>
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
<span class="caret"></span>
<span class="sr-only">Toggle Dropdown</span>
</button>
<ul>
...
</ul>
</div>
<!-- Split button - with a tag -->
<div class="btn-group btn-split disabled">
<a href="#" class="btn btn-default">Action</a>
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
<span class="caret"></span>
<span class="sr-only">Toggle Dropdown</span>
</button>
<ul>
...
</ul>
</div>
Sizing
Button dropdowns work with buttons of all sizes.
Large single buttons
Regular single buttons
Large split buttons
Regular split buttons
Regular single buttons
Large split buttons
Regular split buttons
<!-- Large button group -->
<div class="btn-group">
<button class="btn btn-default btn-lg dropdown-toggle" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Large button <span class="caret"></span>
</button>
<ul class="dropdown-menu" role="menu">
...
</ul>
</div>
<!-- Default button group -->
<div class="btn-group">
<button class="btn btn-default dropdown-toggle" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Default button <span class="caret"></span>
</button>
<ul class="dropdown-menu" role="menu">
...
</ul>
</div>Dropup variation
Trigger dropdown menus above elements by adding .dropup to the parent.
<div class="btn-group dropup">
<button type="button" class="btn btn-default">Dropup</button>
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
<span class="caret"></span>
<span class="sr-only">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu" role="menu">
<!-- Dropdown menu links -->
</ul>
</div>Input groups
Extend form controls by adding text or buttons before, after, or on both sides of any text-based <input>. Use .input-group with an .input-group-addon to prepend or append elements to a single .form-control.
Textual <input>s only
Avoid using <select> elements here as they cannot be fully styled in WebKit browsers.
Avoid using <textarea> elements here as their rows attribute will not be respected in some cases.
Tooltips & popovers in input groups require special setting
When using tooltips or popovers on elements within an .input-group, you'll have to specify the option container: 'body' to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip or popover is triggered).
Don't mix with other components
Do not mix form groups or grid column classes directly with input groups. Instead, nest the input group inside of the form group or grid-related element.
Always add labels
Screen readers will have trouble with your forms if you don't include a label for every input. For these input groups, ensure that any additional label or functionality is conveyed to assistive technologies.
The exact technique to be used (<label> elements hidden using the .sr-only class, or use of the aria-label, aria-labelledby, aria-describedby, title or placeholder attribute) and what additional information will need to be conveyed will vary depending on the exact type of interface widget you're implementing. The examples in this section provide a few suggested, case-specific approaches.
Basic example
Place one add-on or button on either side of an input. You may also place one on both sides of an input.
We do not support multiple add-ons on a single side.
We do not support multiple form-controls in a single input group.
<div class="input-group">
<a href="#" class="input-group-addon btn btn-default" id="basic-addon1">@</a>
<input type="text" class="form-control" placeholder="Username" aria-describedby="basic-addon1">
</div>
<div class="input-group">
<input type="text" class="form-control" placeholder="Recipient's username" aria-describedby="basic-addon2">
<a href="#" class="input-group-addon btn btn-default" id="basic-addon2">@example.com</a>
</div>
<div class="input-group">
<a href="#" class="input-group-addon btn btn-default">$</a>
<input type="text" class="form-control" aria-label="Amount (to the nearest dollar)">
<a href="#" class="input-group-addon btn btn-default">.00</a>
</div>Sizing
Add the relative form sizing classes to the .input-group itself and contents within will automatically resize—no need for repeating the form control size classes on each element.
<div class="input-group input-group-lg">
<a href="#" class="input-group-addon btn btn-default" id="sizing-addon1">@</a>
<input type="text" class="form-control" placeholder="Username" aria-describedby="sizing-addon1">
</div>
<div class="input-group">
<a href="#" class="input-group-addon btn btn-default" id="sizing-addon2">@</span>
<input type="text" class="form-control" placeholder="Username" aria-describedby="sizing-addon2">
</div>Checkboxes and radio addons
Place any checkbox or radio option within an input group's addon instead of text.
<div class="row">
<div class="col-lg-6">
<div class="input-group">
<span class="input-group-addon">
<input type="checkbox" aria-label="...">
</span>
<input type="text" class="form-control" aria-label="...">
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
<div class="col-lg-6">
<div class="input-group">
<span class="input-group-addon">
<input type="radio" aria-label="...">
</span>
<input type="text" class="form-control" aria-label="...">
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
</div><!-- /.row -->Button addons
Buttons in input groups are a bit different and require one extra level of nesting. Instead of .input-group-addon, you'll need to use .input-group-btn to wrap the buttons. This is required due to default browser styles that cannot be overridden.
<div class="row">
<div class="col-lg-6">
<div class="input-group">
<span class="input-group-btn">
<button class="btn btn-default" type="button">Go!</button>
</span>
<input type="text" class="form-control" placeholder="Search for...">
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
<div class="col-lg-6">
<div class="input-group">
<input type="text" class="form-control" placeholder="Search for...">
<span class="input-group-btn">
<button class="btn btn-default" type="button">Go!</button>
</span>
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
</div><!-- /.row -->Buttons with dropdowns
<div class="row">
<div class="col-lg-6">
<div class="input-group">
<div class="input-group-btn">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Action <span class="caret"></span></button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div><!-- /btn-group -->
<input type="text" class="form-control" aria-label="...">
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
<div class="col-lg-6">
<div class="input-group">
<input type="text" class="form-control" aria-label="...">
<div class="input-group-btn">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Action <span class="caret"></span></button>
<ul class="dropdown-menu dropdown-menu-right" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div><!-- /btn-group -->
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
</div><!-- /.row -->Segmented buttons
<div class="input-group">
<div class="input-group-btn btn-split">
<!-- Button and dropdown menu -->
</div>
<input type="text" class="form-control" aria-label="...">
</div>
<div class="input-group">
<input type="text" class="form-control" aria-label="...">
<div class="input-group-btn btn-split">
<!-- Button and dropdown menu -->
</div>
</div>Navs
Navs available in Bootstrap have shared markup, starting with the base .nav class, as well as shared states. Swap modifier classes to switch between each style.
Tabs
Note the .nav-tabs class requires the .nav base class.
| # | First Name | Last Name | Username |
|---|---|---|---|
| 1 | Mark | Otto | @mdo |
| 2 | Jacob | Thornton | @fat |
| # | First Name | Last Name | Username |
|---|---|---|---|
| 1 | Mark | Otto | @mdo |
| 2 | Jacob | Thornton | @fat |
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer eu nibh nulla. Phasellus imperdiet nibh nec imperdiet mattis. Nullam laoreet sit amet ligula pulvinar sagittis. Nullam ut risus dignissim, consectetur lacus eu, laoreet mauris. Vestibulum ornare non erat ac porta. Donec rutrum arcu tortor, at vestibulum tellus egestas dictum. Sed imperdiet egestas porta. Aenean ut placerat ex, quis faucibus tortor. Pellentesque a ipsum ornare, dictum nisi a, congue arcu. Nullam in leo et lorem facilisis lobortis at nec sapien. Donec gravida vulputate velit ac consectetur. In sit amet vestibulum lectus. Pellentesque quis dictum urna, in commodo leo. Phasellus consectetur ex elit, eu vehicula arcu maximus in. Donec luctus mi sed sem elementum, eget volutpat libero dignissim.
<ul class="nav nav-tabs">
<li role="presentation" class="active">
<a href="#selected" id="selected-tab" role="tab" data-toggle="tab" aria-controls="selected" aria-expanded="true">Selected</a>
</li>
<li role="presentation">
<a href="#normal" id="normal-tab" role="tab" data-toggle="tab" aria-controls="normal">Normal</a>
</li>
<li class="disabled" role="presentation">
<a href="#disabled" id="disabled-tab" role="tab" data-toggle="tab" aria-controls="disabled">Disabled</a>
</li>
<li role="presentation">
<a href="#normal" id="normal-tab" role="tab" data-toggle="tab" aria-controls="normal">Normal</a>
</li>
<li role="presentation">
<a href="#focus" id="focus-tab" role="tab" data-toggle="tab" aria-controls="focus">Focus</a>
</li>
<li role="presentation">
<a href="#normal" id="normal-tab" role="tab" data-toggle="tab" aria-controls="normal">Normal</a>
</li>
<li class="active" role="presentation">
<a href="#focus-selected" id="focus-selected-tab" role="tab" data-toggle="tab" aria-controls="focus-selected">Focus Selected</a>
</li>
</ul>
<div id="myTabContent" class="tab-content">
<div role="tabpanel" class="tab-pane fade in active" id="selected" aria-labelledby="selected-tab">
<table> ... </table>
</div>
<div role="tabpanel" class="tab-pane fade" id="normal" aria-labelledby="normal-tab">
<table> ... </table>
<div class="content"> ... </div>
</div>
<div role="tabpanel" class="tab-pane fade" id="disabled" aria-labelledby="disabled-tab">
<table> ... </table>
<div class="content"> ... </div>
</div>
<div role="tabpanel" class="tab-pane fade" id="normal2" aria-labelledby="normal-tab">
<table> ... </table>
<div class="content"> ... </div>
</div>
<div role="tabpanel" class="tab-pane fade" id="focus" aria-labelledby="focus-tab">
<table> ... </table>
</div>
<div role="tabpanel" class="tab-pane fade" id="normal3" aria-labelledby="normal-tab">
<table> ... </table>
<div class="content"> ... </div>
</div>
<div role="tabpanel" class="tab-pane fade" id="focus-selected" aria-labelledby="focus-selected-tab">
<table> ... </table>
</div>
</div>
Pills
Take that same HTML, but use .nav-pills instead:
Default
<ul class="nav nav-pills">
<li role="presentation" class="active"><a href="#">Home</a></li>
<li role="presentation"><a href="#">Profile</a></li>
<li role="presentation"><a href="#">Messages</a></li>
<li role="presentation" class="disabled"><a href="#">News</a></li>
</ul>Primary
<ul class="nav nav-pills nav-pills-primary">
...
</ul>Pills are also vertically stackable. Just add .nav-stacked.
<ul class="nav nav-pills nav-stacked">
...
</ul>Justified
Easily make tabs or pills equal widths of their parent at screens wider than 768px with .nav-justified. On smaller screens, the nav links are stacked.
Justified navbar nav links are currently not supported.
| # | First Name | Last Name | Username |
|---|---|---|---|
| 1 | Mark | Otto | @mdo |
| 2 | Jacob | Thornton | @fat |
<ul class="nav nav-tabs nav-justified">
...
</ul>
<ul class="nav nav-pills nav-justified">
...
</ul>Disabled links
For any nav component (tabs or pills), add .disabled for gray links and no hover effects.
<ul class="nav nav-pills">
...
<li role="presentation" class="disabled"><a href="#">Disabled link</a></li>
...
</ul>Navbar Visma
Default navbar
Navbars 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 navbar nav links are currently not supported.
<nav class="navbar navbar-default">
<!-- Brand and toggle get grouped for better mobile display -->
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-navbar-collapse-ex1" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="#">Visma Product</a>
</div>
<!-- Collect the nav links, forms, and other content for toggling -->
<div class="collapse navbar-collapse" id="bs-navbar-collapse-ex1">
<ul class="nav navbar-nav nav-tabs first-level">
<li class="active first-level-item"><a href="#">Link <span class="sr-only">(current)</span></a></li>
<li class="dropdown first-level-item">
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Dropdown <span class="caret"></span></a>
<div class="dropdown-menu" role="menu">
<div><a href="#">Action</a></div>
<div><a href="#">Another action</a></div>
<div><a href="#">Something else here</a></div>
<div class="divider"></div>
<div><a href="#">Separated link</a></div>
<div class="divider"></div>
<div><a href="#">One more separated link</a></div>
</div>
</li>
</ul>
<ul class="nav navbar-nav navbar-right">
<li class="first-level-item">
<form class="navbar-form navbar-left" role="search">
<div class="form-group search-group">
<input type="text" class="form-control" placeholder="Search...">
<span class="search-icon"></span>
</div>
</form>
</li>
<li class="first-level-item"><a href="#">Link</a></li>
</ul><!-- /.navbar-right -->
</div><!-- /.navbar-collapse -->
</nav>Two-level navbar Visma
To apply the styles for the second level of the navbar add .navbar-second-level class on the <div class="navbar navbar-default"> ... </div>, like in the example below.
<nav class="navbar navbar-default navbar-second-level">
<!-- Brand and toggle get grouped for better mobile display -->
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-navbar-collapse-ex2" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="#">Visma Product</a>
</div>
<!-- Collect the nav links, forms, and other content for toggling -->
<div class="collapse navbar-collapse" id="bs-navbar-collapse-ex2">
<ul class="nav navbar-nav nav-tabs first-level">
<li class="first-level-item"><a href="#">Link</a></li>
<li class="first-level-item"><a href="#">Link</a></li>
<li class="active first-level-item">
<a href="#">Link</a>
<a class="dropdown-toggle" data-toggle="collapse" data-target="#bs-navbar-collapse-ex2-1"><b class="caret"></b></a>
<div class="collapse second-level second-level-collapse" id="bs-navbar-collapse-ex2-1">
<div class="second-level-item"><a href="#">Link</a></div>
<div class="second-level-item"><a href="#">Link</a></div>
<div class="dropdown-element open-lvl-role second-level-item">
<a data-toggle="dropdown">Dropdown</a>
<a class="dropdown-toggle" data-toggle="dropdown"><b class="caret"></b></a>
<div class="collapse third-level third-level-collapse dropdown-menu" id="bs-navbar-collapse-ex2-2">
<div class="third-level-item"><a href="#">Link</a></div>
<div class="third-level-item dropdown-header" role="presentation">Header</div>
<div class="third-level-item"><a href="#">Link</a></div>
<div class="third-level-item"><a href="#">Link</a></div>
<div class="third-level-item dropdown-header" role="presentation">Header</div>
<div class="third-level-item"><a href="#">Link</a></div>
<div class="third-level-item"><a href="#">Link</a></div>
</div> <!-- /.third-level -->
</div>
<div class="second-level-item"><a href="#">Link</a></div>
</div> <!-- /.second-level -->
</li>
<li class="first-level-item"><a href="#">Link</a></li>
<li class="first-level-item"><a href="#">Link</a></li>
</ul> <!-- /.first-level -->
</div><!-- /.navbar-collapse -->
</nav>Brand text
Replace the navbar brand with your own text. Since the .navbar-brand has its own padding and height, you may need to override some CSS depending on your text.
<nav class="navbar navbar-default">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-navbar-collapse-ex2" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="#"> Visma Product </a>
</div>
</nav>Brand dropdown Visma
Replace the navbar brand text with a dropdown. Add a new class,.dropdown, together with .navbar-brand class. Check out the code provided below.
<nav class="navbar navbar-default">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-navbar-collapse-ex2" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<div class="dropdown navbar-brand">
<a class="dropdown-toggle" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Visma Product</a>
<ul class="dropdown-menu" role="menu">
...
</ul>
</div>
</div>
</nav>Forms
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. Also, together with the .form-group class, add this class too .search-group
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 navbar.
Default
Primary
<!-- Default -->
<form class="navbar-form navbar-left" role="search">
<div class="form-group search-group">
<input type="text" class="form-control" placeholder="Search">
<span class="search-icon"></span>
</div>
</form>
<!-- Primary -->
<form class="navbar-form navbar-left navbar-form-primary" role="search">
<div class="form-group search-group">
<input type="text" class="form-control" placeholder="Search">
<span class="search-icon"></span>
</div>
</form>Buttons
Add the .navbar-btn class to <button> elements not residing in a <form> to vertically center them in the navbar.
<button type="button" class="btn btn-default navbar-btn">Sign in</button>Text
Wrap strings of text in an element with .navbar-text, usually on a <p> tag for proper leading and color.
<p class="navbar-text">Signed in as Mark Otto</p>With icons Visma
If you need an item to have an icon insted of text in the main menu just add .icon on the li element that you want, also add a span with the right class to display the icons that you need. Just follow the code listed below.
<!-- Icons as menu items -->
<nav class="navbar navbar-default">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-navbar-collapse-ex1" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="#">Visma Product</a>
</div>
<div class="collapse navbar-collapse" id="bs-navbar-collapse-ex1">
<ul class="nav navbar-nav navbar-right">
<!-- Simple -->
<li class="icon">
<a href="#">
<span class="vismaicon vismaicon-menu vismaicon-message" aria-hidden="true"></span>
</a>
</li>
<!-- with badge -->
<li class="icon">
<a href="#">
<span class="vismaicon vismaicon-menu vismaicon-message" aria-hidden="true"></span>
<span class="badge">99+</span></li>
</a>
</li>
</ul>
</div>
</nav> Non-nav links
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.
<p class="navbar-text navbar-right">Signed in as <a href="#" class="navbar-link">Mark Otto</a></p>Component alignment
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.
Fixed to top
Add .navbar-fixed-top and include a .container or .container-fluid to center and pad navbar content.
<nav class="navbar navbar-default navbar-fixed-top">
...
</nav>Fixed to bottom
Add .navbar-fixed-bottom and include a .container or .container-fluid to center and pad navbar content.
<nav class="navbar navbar-default navbar-fixed-bottom">
...
</nav>Static top
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.
<nav class="navbar navbar-default navbar-static-top">
...
</nav>Breadcrumbs
Indicate the current page's location within a navigational hierarchy.
Separators are automatically added in CSS through :before and content.
<ol class="breadcrumb">
<li><a href="#">Home</a></li>
<li class="disabled"><a href="#">Disabled</a></li>
<li><a href="#">Library</a></li>
<li class="active">Data</li>
</ol>Pagination
Provide pagination links for your site or app with the multi-page pagination component, or the simpler pager alternative.
Default pagination
Simple pagination inspired by Rdio, great for apps and search results. The large block is hard to miss, easily scalable, and provides large click areas.
<nav aria-label="Page navigation">
<ul class="pagination">
<li>
<a class="go2first btn" href="#" aria-label="go-to-first">
<span aria-hidden="true">«</span>
</a>
</li>
<li>
<a class="prev btn" href="#" aria-label="Previous">
<span aria-hidden="true">«</span>
</a>
</li>
<li><a>1-3</a></li>
<li class="of"><span>of</span></li>
<li><a>685</a></li>
<li>
<a class="next btn" href="#" aria-label="Next">
<span aria-hidden="true">»</span>
</a>
</li>
<li>
<a class="go2last btn" href="#" aria-label="go-to-last">
<span aria-hidden="true">»</span>
</a>
</li>
</ul>
</nav>Labelling the pagination component
The pagination component should be wrapped in a <nav> element to identify it as a navigation section to screen readers and other assistive technologies. In addition, as a page is likely to have more than one such navigation section already (such as the primary navigation in the header, or a sidebar navigation), it is advisable to provide a descriptive aria-label for the <nav> which reflects its purpose. For example, if the pagination component is used to navigate between a set of search results, an appropriate label could be aria-label="Search results pages".
Disabled states
Links are customizable for different circumstances. Use .disabled for unclickable link
<nav aria-label="...">
<ul class="pagination">
<li>
<a class="go2first btn disabled" href="#" aria-label="go-to-first">
<span aria-hidden="true">«</span>
</a>
</li>
<li>
<a class="prev btn disabled" href="#" aria-label="Previous">
<span aria-hidden="true">«</span>
</a>
</li>
<li><a>1-3</a></li>
<li class="of"><span>of</span></li>
<li><a>685</a></li>
<li>
<a class="next btn" href="#" aria-label="Next">
<span aria-hidden="true">»</span>
</a>
</li>
<li>
<a class="go2last btn" href="#" aria-label="go-to-last">
<span aria-hidden="true">»</span>
</a>
</li>
</ul>
</nav>Sizing
Fancy larger pagination? Add .pagination-lg for a larger size.
<nav aria-label="..."><ul class="pagination pagination-lg">...</ul></nav>
<nav aria-label="..."><ul class="pagination">...</ul></nav>Pager
Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.
Default example
By default, the pager centers links.
<nav aria-label="...">
<ul class="pager">
<li><a href="#">Previous</a></li>
<li><a href="#">Next</a></li>
</ul>
</nav>Aligned links
Alternatively, you can align each link to the sides:
<nav aria-label="...">
<ul class="pager">
<li class="previous"><a href="#"><span aria-hidden="true">←</span> Older</a></li>
<li class="next"><a href="#">Newer <span aria-hidden="true">→</span></a></li>
</ul>
</nav>Optional disabled state
Pager links also use the general .disabled utility class from the pagination.
<nav aria-label="...">
<ul class="pager">
<li class="previous disabled"><a href="#"><span aria-hidden="true">←</span> Older</a></li>
<li class="next"><a href="#">Newer <span aria-hidden="true">→</span></a></li>
</ul>
</nav>Labels
Example
Example heading New
Example heading New
Example heading New
<h1>Example heading <span class="label label-default">New</span></h1>
<button class="btn btn-default" type="button">
Message <span class="label">Important</span>
</button>
<button class="btn btn-primary" type="button">
Message <span class="label">Important</span>
</button>
Available variations
Add any of the below mentioned modifier classes to change the appearance of a label.
Default
Primary
Secondary
<span class="label label-default">Default</span>
<span class="label label-primary">Primary</span>
<span class="label label-secondary">Secondary</span> Badges
Easily highlight new or unread items by adding a <span class="badge"> to links, Bootstrap navs, and more.
99+
99+
99+
99+
99+
99+
<span class="badge badge-default">99+</span> <!-- regular -->
<span class="badge badge-default badge-sm">99+</span> <!-- small -->
<span class="badge badge-primary">99+</span> <!-- regular -->
<span class="badge badge-primary badge-sm">99+</span> <!-- small -->
<span class="badge badge-secondary">99+</span> <!-- regular -->
<span class="badge badge-secondary badge-sm">99+</span> <!-- small -->
<a href="#">Inbox <span class="badge">42</span></a>
<button class="btn btn-default" type="button">
Message <span class="badge">Important</span>
</button>
<button class="btn btn-primary" type="button">
Message <span class="badge">Important</span>
</button>
Self collapsing
When there are no new or unread items, badges will simply collapse (via CSS's :empty selector) provided no content exists within.
Cross-browser compatibility
Badges won't self collapse in Internet Explorer 8 because it lacks support for the :empty selector.
Adapts to active nav states
Built-in styles are included for placing badges in active states in pill navigations.
<ul class="nav nav-pills" role="tablist">
<li role="presentation" class="active"><a href="#">Home <span class="badge">42</span></a></li>
<li role="presentation"><a href="#">Profile</a></li>
<li role="presentation"><a href="#">Messages <span class="badge">3</span></a></li>
</ul>Jumbotron
A lightweight, flexible component that can optionally extend the entire viewport to showcase key content on your site.
Hello, world!
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
<div class="jumbotron">
<h1>Hello, world!</h1>
<p>...</p>
<p><a class="btn btn-primary btn-lg" href="#" role="button">Learn more</a></p>
</div>To make the jumbotron full width, and without rounded corners, place it outside all .containers and instead add a .container within.
<div class="jumbotron">
<div class="container">
...
</div>
</div>Page header
A simple shell for an h1 to appropriately space out and segment sections of content on a page. It can utilize the h1's default small element, as well as most other components (with additional styles).
Example page header Subtext for header
<div class="page-header">
<h1>Example page header <small>Subtext for header</small></h1>
</div>Thumbnails
Extend Bootstrap's grid system with the thumbnail component to easily display grids of images, videos, text, and more.
If you're looking for Pinterest-like presentation of thumbnails of varying heights and/or widths, you'll need to use a third-party plugin such as Masonry, Isotope, or Salvattore.
Default example
By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.
<div class="row">
<div class="col-xs-6 col-md-3">
<a href="#" class="thumbnail">
<img src="..." alt="...">
</a>
</div>
...
</div>Custom content
With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.
<div class="row">
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="..." alt="...">
<div class="caption">
<h3>Thumbnail label</h3>
<p>...</p>
<p><a href="#" class="btn btn-primary" role="button">Button</a> <a href="#" class="btn btn-default" role="button">Button</a></p>
</div>
</div>
</div>
</div>Alerts
Provide contextual feedback messages for typical user actions with the handful of available and flexible alert messages.
Examples
Wrap any text and an optional dismiss button in .alert for basic alert messages.
Well done! You successfully read this important alert message.
Heads up! This alert needs your attention, but it's not super important.
Warning! Better check yourself, you're not looking too good.
Oh snap! Change a few things up and try submitting again.
<div class="alert" role="alert">
<div>
<span class="vismaicon vismaicon-lg vismaicon-filled vismaicon-success" aria-hidden="true"></span>
<strong>Well done!</strong> You successfully read this important alert message.
</div>
</div>
<div class="alert" role="alert">
<div>
<span class="vismaicon vismaicon-lg vismaicon-filled vismaicon-info" aria-hidden="true"></span>
<strong>Heads up!</strong> This alert needs your attention, but it's not super important.
</div>
</div>
<div class="alert" role="alert">
<div>
<span class="vismaicon vismaicon-lg vismaicon-filled vismaicon-warning" aria-hidden="true"></span>
<strong>Warning!</strong> Better check yourself, you're not looking too good.
</div>
</div>
<div class="alert" role="alert">
<div>
<span class="vismaicon vismaicon-lg vismaicon-filled vismaicon-error" aria-hidden="true"></span>
<strong>Oh snap!</strong> Change a few things up and try submitting again.
</div>
</div>Sizing
Fancy small alerts? Add .alert-sm fop the small version.
Well done! You successfully read this important alert message.
Heads up! This alert needs your attention, but it's not super important.
Warning! Better check yourself, you're not looking too good.
Oh snap! Change a few things up and try submitting again.
<div class="alert alert-sm" role="alert">
<div>
<span class="vismaicon vismaicon-filled vismaicon-success" aria-hidden="true"></span>
<strong>Well done!</strong> You successfully read this important alert message.
</div>
</div>
<div class="alert alert-sm" role="alert">
<div>
<span class="vismaicon vismaicon-filled vismaicon-info" aria-hidden="true"></span>
<strong>Heads up!</strong> This alert needs your attention, but it's not super important.
</div>
</div>
<div class="alert alert-sm" role="alert">
<div>
<span class="vismaicon vismaicon-filled vismaicon-warning" aria-hidden="true"></span>
<strong>Warning!</strong> Better check yourself, you're not looking too good.
</div>
</div>
<div class="alert alert-sm" role="alert">
<div>
<span class="vismaicon vismaicon-filled vismaicon-error" aria-hidden="true"></span>
<strong>Oh snap!</strong> Change a few things up and try submitting again.
</div>
</div>Dismissible alerts
Build on any alert by adding an optional .alert-dismissible and close button.
Requires JavaScript alert plugin
For fully functioning, dismissible alerts, you must use the alerts JavaScript plugin.
Warning! Better check yourself, you're not looking too good.
Warning! Better check yourself, you're not looking too good.
<div class="alert alert-dismissible" role="alert">
<button type="button" class="close" data-dismiss="alert" aria-label="Close"><span>×</span></button>
<div>
<span class="vismaicon vismaicon-lg vismaicon-filled vismaicon-warning" aria-hidden="true"></span>
<strong>Warning!</strong> Better check yourself, you're not looking too good.
</div>
</div>
<div class="alert alert-sm alert-dismissible" role="alert">
<button type="button" class="close" data-dismiss="alert" aria-label="Close"><span>×</span></button>
<div>
<span class="vismaicon vismaicon-filled vismaicon-warning" aria-hidden="true"></span>
<strong>Warning!</strong> Better check yourself, you're not looking too good.
</div>
</div>
Ensure proper behavior across all devices
Be sure to use the <button> element with the data-dismiss="alert" data attribute.
Links in alerts
Use the .alert-link utility class to quickly provide matching colored links within any alert.
Well done! You successfully read this important alert message.
Heads up! This alert needs your attention, but it's not super important.
Warning! Better check yourself, you're not looking too good.
Oh snap! Change a few things up and try submitting again.
<div class="alert" role="alert">
<div>
<a href="#" class="alert-link">...</a>
</div>
</div>With options
Use the .alert-options utility class when you have more things included in your alert.
<div class="alert alert-options" role="alert">
<div>
<h4>Well done! You clearly are a dojo master!</h4>
<span class="vismaicon vismaicon-lg vismaicon-filled vismaicon-success" aria-hidden="true"></span>
<p>I grew up doing martial arts, and I'm a second-degree black belt. So I do know a thing or two about Karate.</p>
<p>
<button type="button" class="btn btn-default">Take this action</button>
</p>
</div>
</div>Wizard Visma
Script dependency
The wizards require visma-additional.js to be included.
Wizards are used to give the user step-by-step guidance to achieve their goal. Wizards consist of a series of screens, each of which helps the user complete a step in the workflow.
Examples
Wrap all the items from your wizard in .wizard and each item in <li> </li>.
<!-- Default -->
<div class="wizard">
<ul>
<li class="first active">
<a href="#"><span> Normal </span></a>
</li>
<li class="normal">
<a href="#"><span> Normal </span></a>
</li>
<li class="normal">
<a href="#"><span> Normal </span></a>
</li>
<li class="normal last">
<a href="#"><span> Normal </span></a>
</li>
</ul>
</div>
<!-- Primary -->
<div class="wizard wizard-primary">
...
</div>Wizard states
See all the states for the wizard in the example below.
<!-- Visited, Selected, Normal, Mouse over and Focus state -->
<div class="wizard">
<ul>
<li class="visited first">
<a href="#"><span>Visited </span></a>
</li>
<li class="active">
<a href="#"><span>Selected </span></a>
</li>
<li class="normal">
<a href="#"><span>Normal </span></a>
</li>
</li>
<li class="normal">
<a href="#"><span>Mouse over </span></a>
</li>
<li class="normal last">
<a href="#"><span>Focus </span></a>
</li>
</ul>
</div>
<!-- Visited, Selected focus, Normal, Disabled and Normal state -->
<div class="wizard">
<ul>
<li class="visited first">
<a href="#"><span>Visited </span></a>
</li>
<li class="active">
<a href="#"><span>Selected focus</span></a>
</li>
<li class="normal">
<a href="#"><span>Normal </span></a>
</li>
</li>
<li class="normal">
<a href="#"><span>Pressed </span></a>
</li>
<li class="disabled last">
<a href="#"><span>Disabled </span></a>
</li>
</ul>
</div>Options
There are 2 versions of the wizard design, normal and primary. See the UX guidelines for when to use which version.
For the primary version, just add wizard-primary in the top level div, like in the example below: <div class="wizard wizard-primary"> ... </div>.
<!-- Default -->
<div class="wizard">
<ul>
<li class="active first">
<a href="#"><span> Selected </span></a>
</li>
<li class="active">
<a href="#"><span> Selected focus</span></a>
</li>
<li class="normal last">
<a href="#"><span> Normal </span></a>
</li>
</ul>
</div>
<!-- Primary -->
<div class="wizard wizard-primary">
<ul>
<li class="active first">
<a href="#"><span> Selected </span></a>
</li>
<li class="active">
<a href="#"><span> Selected focus</span></a>
</li>
<li class="normal last">
<a href="#"><span> Normal </span></a>
</li>
</ul>
</div>With icons
There is an option to add icons on your wizard. The icons will appear on the visited and active step of the wizard. Just add a new class in the div that holds everything, like in the example below, <div class="wizard wizard-icon"> ... </div>.
<!-- Default -->
<div class="wizard wizard-icon">
...
</div>
<!-- Primary -->
<div class="wizard wizard-primary wizard-icon">
...
</div>Progress bars
Provide up-to-date feedback on the progress of a workflow or action with simple yet flexible progress bars.
Cross-browser compatibility
Progress bars use CSS3 transitions and animations to achieve some of their effects. These features are not supported in Internet Explorer 9 and below or older versions of Firefox. Opera 12 does not support animations.
Content Security Policy (CSP) compatibility
If your website has a Content Security Policy (CSP) which doesn't allow style-src 'unsafe-inline', then you won't be able to use inline style attributes to set progress bar widths as shown in our examples below. Alternative methods for setting the widths that are compatible with strict CSPs include using a little custom JavaScript (that sets element.style.width) or using custom CSS classes.
Basic example
Default progress bar.
<div class="progress">
<div class="progress-bar" role="progressbar" aria-valuenow="80" aria-valuemin="0" aria-valuemax="100" style="width: 80%;">
<span class="sr-only">80% Complete</span>
</div>
</div>With label
Remove the <span> with .sr-only class from within the progress bar to show a visible percentage.
<div class="progress">
<div class="progress-bar" role="progressbar" aria-valuenow="80" aria-valuemin="0" aria-valuemax="100" style="width: 80%;">
80%
</div>
</div>Sizes
There are 3 available sizes for the progress bars: .progress-xs, .progress-sm and the default one .progress.
<div class="progress progress-xs">
<div class="progress-bar" role="progressbar" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100" style="width: 0%;">
<span class="percentage">100%</span>
</div>
</div>
<div class="progress progress-sm">
<div class="progress-bar" role="progressbar" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100" style="width: 0%;">
<span class="percentage">100%</span>
</div>
</div>
<div class="progress">
<div class="progress-bar" role="progressbar" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100" style="width: 0%;">
<span class="percentage">100%</span>
</div>
</div>Spinners Visma
For actions without a clear progress, use a spinning work indicator. Use the approriate GIF depending on background and size needed.
Media object
Abstract object styles for building various types of components (like blog comments, Tweets, etc) that feature a left- or right-aligned image alongside textual content.
Default media
The default media displays a media object (images, video, audio) to the left or right of a content block.
Media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.
Media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.
Nested media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.Media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.
Media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.
<div class="media">
<div class="media-left">
<a href="#">
<img class="media-object" src="..." alt="...">
</a>
</div>
<div class="media-body">
<h4 class="media-heading">Media heading</h4>
...
</div>
</div>The classes .pull-left and .pull-right also exist and were previously used as part of the media component, but are deprecated for that use as of v3.3.0. They are approximately equivalent to .media-left and .media-right, except that .media-right should be placed after the .media-body in the html.
Media alignment
The images or other media can be aligned top, middle, or bottom. The default is top aligned.
Top aligned media
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.
Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.
Middle aligned media
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.
Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.
Bottom aligned media
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.
Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.
<div class="media">
<div class="media-left media-middle">
<a href="#">
<img class="media-object" src="..." alt="...">
</a>
</div>
<div class="media-body">
<h4 class="media-heading">Middle aligned media</h4>
...
</div>
</div>Media list
With a bit of extra markup, you can use media inside list (useful for comment threads or articles lists).
-
Media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.
Nested media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.
Nested media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.
Nested media heading
Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.
<ul class="media-list">
<li class="media">
<div class="media-left">
<a href="#">
<img class="media-object" src="..." alt="...">
</a>
</div>
<div class="media-body">
<h4 class="media-heading">Media heading</h4>
...
</div>
</li>
</ul>List group
List groups are a flexible and powerful component for displaying not only simple lists of elements, but complex ones with custom content.
Basic example
The most basic list group is simply an unordered list with list items, and the proper classes. Build upon it with the options that follow, or your own CSS as needed.
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
<ul class="list-group">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
<ul class="list-group list-group-primary">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>With title Visma
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
<ul class="list-group">
<li class="list-group-item list-group-title">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
<ul class="list-group list-group-primary">
<li class="list-group-item list-group-title">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>Options
There are 2 options for the list groups, the blue list group is the default one, simply use the .list-group class for this type of list.
There is also a second version, .list-group-primary, just add this class along with the default class of the list group .list-group
Default
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
<!-- Default -->
<ul class="list-group">
<li class="list-group-item list-group-title">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
<!-- Primary -->
<ul class="list-group list-group-primary">
<li class="list-group-item list-group-title">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>Badges
Add the badges component to any list group item and it will automatically be positioned on the right.
- 21 Cras justo odio
- (9) Dapibus ac facilisis in
- (4) Morbi leo risus
- (8) Vestibulum maximus
- 21 Cras justo odio
- 9 Dapibus ac facilisis in
- 4 Morbi leo risus
- 9 Vestibulum maximus
<!-- Default -->
<ul class="list-group">
<li class="list-group-item">
<span class="badge">14</span>
Cras justo odio
</li>
</ul>
<!-- Primary -->
<ul class="list-group list-group-primary">
<li class="list-group-item">
<span class="badge">14</span>
Cras justo odio
</li>
</ul>Linked items
Linkify list group items by using anchor tags instead of list items (that also means a parent <div> instead of an <ul>). No need for individual parents around each element.
<!-- Default -->
<div class="list-group">
<li class="list-group-item list-group-title">Cras justo odio</li>
<a href="#" class="list-group-item">Dapibus ac facilisis in</a>
<a href="#" class="list-group-item">Morbi leo risus</a>
<a href="#" class="list-group-item active">Porta ac consectetur ac</a>
<a href="#" class="list-group-item">Vestibulum at eros</a>
</div>
<!-- Primary -->
<div class="list-group list-group-primary">
<li class="list-group-item list-group-title">Cras justo odio</li>
<a href="#" class="list-group-item">Dapibus ac facilisis in</a>
<a href="#" class="list-group-item">Morbi leo risus</a>
<a href="#" class="list-group-item active">Porta ac consectetur ac</a>
<a href="#" class="list-group-item">Vestibulum at eros</a>
</div>Disabled items
Add .disabled to a .list-group-item to gray it out to appear disabled.
<!-- Default -->
<div class="list-group">
<a href="#" class="list-group-item disabled">Cras justo odio</a>
<a href="#" class="list-group-item">Dapibus ac facilisis in</a>
<a href="#" class="list-group-item">Morbi leo risus</a>
<a href="#" class="list-group-item">Porta ac consectetur ac</a>
<a href="#" class="list-group-item">Vestibulum at eros</a>
</div>
<!-- Primary -->
<div class="list-group list-group-primary">
<a href="#" class="list-group-item disabled">Cras justo odio</a>
<a href="#" class="list-group-item">Dapibus ac facilisis in</a>
<a href="#" class="list-group-item">Morbi leo risus</a>
<a href="#" class="list-group-item">Porta ac consectetur ac</a>
<a href="#" class="list-group-item">Vestibulum at eros</a>
</div>Custom content
Add nearly any HTML within, even for linked list groups like the one below.
List group item heading
Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.
List group item heading
Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.
List group item heading
Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.
List group item heading
Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.
List group item heading
Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.
List group item heading
Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.
<!-- Default -->
<div class="list-group">
<a href="#" class="list-group-item active">
<h4 class="list-group-item-heading">List group item heading</h4>
<p class="list-group-item-text">...</p>
</a>
</div>
<!-- Primary -->
<div class="list-group list-group-primary">
<a href="#" class="list-group-item active">
<h4 class="list-group-item-heading">List group item heading</h4>
<p class="list-group-item-text">...</p>
</a>
</div>Panels
While not always necessary, sometimes you need to put your DOM in a box. For those situations, try the panel component.
Basic example
By default, all the .panel does is apply some basic border and padding to contain some content.
Basic panel example
<div class="panel panel-default">
<div class="panel-body">
Basic panel example
</div>
</div>Panel with heading
Easily add a heading container to your panel with .panel-heading. You may also include any <h1>-<h6> with a .panel-title class to add a pre-styled heading.
For proper link coloring, be sure to place links in headings within .panel-title.
Panel title
Panel content
Panel title
Panel content
<div class="panel panel-default">
<div class="panel-heading">Panel title</div>
<div class="panel-body">
Panel content
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h3 class="panel-title">Panel title</h3>
</div>
<div class="panel-body">
Panel content
</div>
</div>Panel with footer
Wrap buttons or secondary text in .panel-footer. Note that panel footers do not inherit colors and borders when using contextual variations as they are not meant to be in the foreground.
Panel content
<div class="panel panel-default">
<div class="panel-body">
Panel content
</div>
<div class="panel-footer">Panel footer</div>
</div>Contextual alternatives
Like other components, easily make a panel more meaningful to a particular context by adding any of the contextual state classes.
Panel title
Panel content
Panel title
Panel content
<div class="panel panel-default">...</div>
<div class="panel panel-primary">...</div>With tables
Add any non-bordered .table within a panel for a seamless design. If there is a .panel-body, we add an extra border to the top of the table for separation.
Panel heading
Some default panel content here. Nulla vitae elit libero, a pharetra augue. Aenean lacinia bibendum nulla sed consectetur. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Nullam id dolor id nibh ultricies vehicula ut id elit.
| # | First Name | Last Name | Username |
|---|---|---|---|
| 1 | Mark | Otto | @mdo |
| 2 | Jacob | Thornton | @fat |
| 3 | Larry | the Bird |
<div class="panel panel-default">
<!-- Default panel contents -->
<div class="panel-heading">Panel heading</div>
<div class="panel-body">
<p>...</p>
</div>
<!-- Table -->
<table class="table">
...
</table>
</div>If there is no panel body, the component moves from panel header to table without interruption.
Panel heading
| # | First Name | Last Name | Username |
|---|---|---|---|
| 1 | Mark | Otto | @mdo |
| 2 | Jacob | Thornton | @fat |
| 3 | Larry | the Bird |
<div class="panel panel-default">
<!-- Default panel contents -->
<div class="panel-heading">Panel heading</div>
<!-- Table -->
<table class="table">
...
</table>
</div>With list groups
Easily include full-width list groups within any panel.
Panel heading
Some default panel content here. Nulla vitae elit libero, a pharetra augue. Aenean lacinia bibendum nulla sed consectetur. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Nullam id dolor id nibh ultricies vehicula ut id elit.
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
<div class="panel panel-default">
<!-- Default panel contents -->
<div class="panel-heading">Panel heading</div>
<div class="panel-body">
<p>...</p>
</div>
<!-- List group -->
<ul class="list-group">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
</div>Responsive embed
Allow browsers to determine video or slideshow dimensions based on the width of their containing block by creating an intrinsic ratio that will properly scale on any device.
Rules are directly applied to <iframe>, <embed>, <video>, and <object> elements; optionally use an explicit descendant class .embed-responsive-item when you want to match the styling for other attributes.
Pro-Tip! You don't need to include frameborder="0" in your <iframe>s as we override that for you.
<!-- 16:9 aspect ratio -->
<div class="embed-responsive embed-responsive-16by9">
<iframe class="embed-responsive-item" src="..."></iframe>
</div>
<!-- 4:3 aspect ratio -->
<div class="embed-responsive embed-responsive-4by3">
<iframe class="embed-responsive-item" src="..."></iframe>
</div>Wells
Default well
Use the well as a simple effect on an element to give it an inset effect.
Look, I'm in a well!
<div class="well">...</div>Optional classes
Control padding and rounded corners with two optional modifier classes.
Look, I'm in a large well!
<div class="well well-lg">...</div>
Look, I'm in a small well!
<div class="well well-sm">...</div>