Компоненты

Десятки переиспользуемых компонентов для навигации, оповещений, всплывающих подсказок и многого другого.

Примеры

Две основные опции, а также две более специфические вариации.

Одна группа кнопок

Оберните серию кнопок с .btn в .btn-group.

<div class="btn-group">
  <button class="btn">Left</button>
  <button class="btn">Middle</button>
  <button class="btn">Right</button>
</div>

Несколько групп кнопок

Объедините наборы <div class="btn-group"> в <div class="btn-toolbar"> для более сложных компонентов.

<div class="btn-toolbar">
  <div class="btn-group">
    ...
  </div>
</div>

Вертикальные группы кнопок

Сделайте набор кнопок появляться вертикально, а не горизонтально.

<div class="btn-group btn-group-vertical">
  ...
</div>

Варианты с чекбоксами и радиокнопками

Группы кнопок также могут функционировать как радиокнопки, где может быть активна только одна кнопка, или как чекбоксы, где может быть активна любая кнопка. См. документацию по JavaScript для этого.

Выпадающие меню в группах кнопок

Heads up! Кнопки с выпадающими меню должны быть отдельно обернуты в свою .btn-group в .btn-toolbar для правильного рендеринга.

Обзор и примеры

Используйте любую кнопку для запуска выпадающего меню, поместив ее в .btn-group и предоставив соответствующую разметку меню.

<div class="btn-group">
  <a class="btn dropdown-toggle" data-toggle="dropdown" href="#">
    Action
    <span class="caret"></span>
  </a>
  <ul class="dropdown-menu">
    <!-- dropdown menu links -->
  </ul>
</div>

Работает с любыми размерами кнопок

Выпадающие меню работают на любом размере: .btn-large, .btn-small, или .btn-mini.

Требуется JavaScript

Выпадающие меню требуют плагина Bootstrap для выпадающих меню для работы.

В некоторых случаях—например, на мобильных устройствах—меню выпадающих меню может выходить за пределы видимости. Вам нужно будет вручную или с помощью пользовательского JavaScript решить проблему выравнивания.


Выпадающие меню

На основе стилей и разметки групп кнопок мы можем легко создать выпадающую кнопку. Выпадающие кнопки включают стандартное действие слева и кнопку переключения справа с контекстными ссылками.

<div class="btn-group">
  <button class="btn">Action</button>
  <button class="btn dropdown-toggle" data-toggle="dropdown">
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu">
    <!-- dropdown menu links -->
  </ul>
</div>

Размеры

Используйте дополнительные классы кнопок .btn-mini, .btn-small, или .btn-large для изменения размеров.

<div class="btn-group">
  <button class="btn btn-mini">Action</button>
  <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown">
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu">
    <!-- dropdown menu links -->
  </ul>
</div>

Выпадающие меню

Меню выпадающих меню также можно переключать снизу вверх, добавив один класс к родительскому элементу .dropdown-menu. Это изменит направление .caret и переместит меню само по себе сверху вниз вместо сверху вниз.

<div class="btn-group dropup">
  <button class="btn">Dropup</button>
  <button class="btn dropdown-toggle" data-toggle="dropdown">
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu">
    <!-- dropdown menu links -->
  </ul>
</div>

Стандартная пагинация

Простая пагинация, вдохновленная Rdio, отлично подходит для приложений и результатов поиска. Большой блок трудно пропустить, легко масштабируется, и обеспечивает большие области клика.

<div class="pagination">
  <ul>
    <li><a href="#">Prev</a></li>
    <li><a href="#">1</a></li>
    <li><a href="#">2</a></li>
    <li><a href="#">3</a></li>
    <li><a href="#">4</a></li>
    <li><a href="#">5</a></li>
    <li><a href="#">Next</a></li>
  </ul>
</div>

Опции

Состояния отключенных и активных элементов

Ссылки настраиваемы для различных обстоятельств. Используйте .disabled для некликабельных ссылок и .active, чтобы указать текущую страницу.

<div class="pagination">
  <ul>
    <li class="disabled"><a href="#">&laquo;</a></li>
    <li class="active"><a href="#">1</a></li>
    ...
  </ul>
</div>

Вы можете по желанию заменить активные или отключенные ссылки на элементы <span>, чтобы не терять возможность кликать, сохраняя при этом стили.

<div class="pagination">
  <ul>
    <li class="disabled"><span>&laquo;</span></li>
    <li class="active"><span>1</span></li>
    ...
  </ul>
</div>

Размеры

Как насчет больших или меньших пагинаций? Добавьте .pagination-large, .pagination-small, или .pagination-mini для дополнительных размеров.

<div class="pagination pagination-large">
  <ul>
    ...
  </ul>
</div>
<div class="pagination">
  <ul>
    ...
  </ul>
</div>
<div class="pagination pagination-small">
  <ul>
    ...
  </ul>
</div>
<div class="pagination pagination-mini">
  <ul>
    ...
  </ul>
</div>

Выравнивание

Добавьте один из двух опциональных классов, чтобы изменить выравнивание пагинационных ссылок: .pagination-centered и .pagination-right.

<div class="pagination pagination-centered">
  ...
</div>
<div class="pagination pagination-right">
  ...
</div>

Пагинатор

Быстрые предыдущие и следующие ссылки для простых реализаций пагинации с легкой разметкой и стилями. Это отлично подходит для простых сайтов, таких как блогов или журналов.

По умолчанию

По умолчанию пагинатор центрирует ссылки.

<ul class="pager">
  <li><a href="#">Previous</a></li>
  <li><a href="#">Next</a></li>
</ul>

Выровненные ссылки

Альтернативно, вы можете выровнять каждую ссылку по сторонам:

<ul class="pager">
  <li class="previous">
    <a href="#">&larr; Older</a>
  </li>
  <li class="next">
    <a href="#">Newer &rarr;</a>
  </li>
</ul>

Необязательное состояние отключенности

Ссылки пагинатора также используют общий класс .disabled утилиты.

<ul class="pager">
  <li class="previous disabled">
    <a href="#">&larr; Older</a>
  </li>
  ...
</ul>

Надписи

Надписи Разметка
По умолчанию <span class="label">Default</span>
Успех <span class="label label-success">Success</span>
Предупреждение <span class="label label-warning">Warning</span>
Важно <span class="label label-important">Important</span>
Информация <span class="label label-info">Info</span>
Инвертированный <span class="label label-inverse">Inverse</span>

Значки

Имя Пример Разметка
По умолчанию 1 <span class="badge">1</span>
Успех 2 <span class="badge badge-success">2</span>
Предупреждение 4 <span class="badge badge-warning">4</span>
Важно 6 <span class="badge badge-important">6</span>
Информация 8 <span class="badge badge-info">8</span>
Инвертированный 10 <span class="badge badge-inverse">10</span>

Легко сворачиваемые

Для простого использования, надписи и значки просто сократятся (через CSS's :empty селектор) при отсутствии содержимого внутри.

Единичный компонент

Легкий, гибкий компонент для демонстрации ключевого контента на вашем сайте. Он хорошо подходит для маркетинга и сайтов с большим объемом контента.

Hello, world!

This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.

Learn more

<div class="hero-unit">
  <h1>Heading</h1>
  <p>Tagline</p>
  <p>
    <a class="btn btn-primary btn-large">
      Learn more
    </a>
  </p>
</div>

Заголовок страницы

Простой оболочек для h1 для правильного отступа и разделения разделов на странице. Он может использовать элемент h1's default small, а также большинство других компонентов (с дополнительными стилями).

<div class="page-header">
  <h1>Example page header <small>Subtext for header</small></h1>
</div>

Миниатюры по умолчанию

По умолчанию миниатюры Bootstrap спроектированы для демонстрации ссылок на изображениях с минимальной необходимой разметкой.

Высоко настраиваемые

С небольшим дополнительным HTML можно добавить любые виды HTML-контента, такие как заголовки, абзацы или кнопки в миниатюрах.

  • Надпись миниатюры

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    Action Action

  • Надпись миниатюры

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    Action Action

  • Надпись миниатюры

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    Action Action

Зачем использовать миниатюры

Миниатюры (ранее .media-grid до версии 1.4) отлично подходят для сеток фотографий или видео, результатов поиска изображений, розничных товаров, портфолио и многого другого. Они могут быть ссылками или статическим контентом.

Простая, гибкая разметка

Разметка миниатюр проста—ul с любым количеством li элементов достаточно. Также она очень гибкая, позволяя вам добавить любой тип контента с немного большей разметкой для обертки вашего контента.

Использование классов сетки

Наконец, компонент миниатюр использует существующие классы системы сетки—например, .span2 или .span3—для контроля размеров миниатюр.

Разметка

Как уже упоминалось ранее, необходимая разметка для миниатюр проста и прямая. Вот пример базовой настройки для ссылок на изображениях:

<ul class="thumbnails">
  <li class="span4">
    <a href="#" class="thumbnail">
      <img data-src="holder.js/300x200" alt="">
    </a>
  </li>
  ...
</ul>

Для пользовательского HTML-контента в миниатюрах разметка изменяется незначительно. Чтобы позволить блочному контенту в любом месте, мы меняем <a> на <div> вот так:

<ul class="thumbnails">
  <li class="span4">
    <div class="thumbnail">
      <img data-src="holder.js/300x200" alt="">
      <h3>Надпись миниатюры</h3>
      <p>Подпись миниатюры...</p>
    </div>
  </li>
  ...
</ul>

Другие примеры

Исследуйте все свои варианты с различными классами сетки, доступными вам. Вы также можете смешивать и сочетать различные размеры.

По умолчанию

Оберните любой текст и опциональную кнопку закрытия в .alert для базового предупреждающего сообщения.

Предупреждение! Лучше проверьте себя, ты не выглядишь слишком хорошо.
<div class="alert">
  <button type="button" class="close" data-dismiss="alert">&times;</button>
  <strong>Warning!</strong> Best check yo self, you're not looking too good.
</div>

Кнопки закрытия

Мобильные браузеры Safari и Opera, кроме атрибута data-dismiss="alert", требуют href="#" для закрытия алертов при использовании тега <a>.

<a href="#" class="close" data-dismiss="alert">&times;</a>

В качестве альтернативы вы можете использовать элемент <button> с атрибутом данных, который мы выбрали для наших документов. Когда используется <button>, вы должны включить type="button", иначе ваши формы могут не отправляться.

<button type="button" class="close" data-dismiss="alert">&times;</button>

Закрытие алертов через JavaScript

Используйте плагин jQuery для алертов для быстрого и простого закрытия алертов.


Опции

Для более длинных сообщений увеличьте отступы сверху и снизу обертки алерта, добавив .alert-block.

Предупреждение!

Лучше проверьте себя, ты не выглядишь слишком хорошо. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.

<div class="alert alert-block">
  <button type="button" class="close" data-dismiss="alert">&times;</button>
  <h4>Warning!</h4>
  Best check yo self, you're not...
</div>

Контекстные альтернативы

Добавьте опциональные классы, чтобы изменить коннотацию алерта.

Ошибка или опасность

О нет! Измените несколько вещей и попробуйте еще раз.
<div class="alert alert-error">
  ...
</div>

Успех

Отлично! Вы успешно прочитали это важное предупреждающее сообщение.
<div class="alert alert-success">
  ...
</div>

Информация

Внимание! Это предупреждение требует вашего внимания, но оно не очень важно.
<div class="alert alert-info">
  ...
</div>

Примеры и разметка

Базовые

По умолчанию полоса прогресса с вертикальным градиентом.

<div class="progress">
  <div class="bar" style="width: 60%;"></div>
</div>

Полоски

Использует градиент для создания эффекта полоски. Не поддерживается в IE7-8.

<div class="progress progress-striped">
  <div class="bar" style="width: 20%;"></div>
</div>

Анимация

Добавьте .active к .progress-striped, чтобы анимировать полоски слева направо. Не поддерживается во всех версиях IE.

<div class="progress progress-striped active">
  <div class="bar" style="width: 40%;"></div>
</div>

Наложение

Поместите несколько полос в один .progress, чтобы наложить их друг на друга.

<div class="progress">
  <div class="bar bar-success" style="width: 35%;"></div>
  <div class="bar bar-warning" style="width: 20%;"></div>
  <div class="bar bar-danger" style="width: 10%;"></div>
</div>

Опции

Дополнительные цвета

Полосы прогресса используют некоторые из тех же классов кнопок и предупреждающих сообщений для согласованного стиля.

<div class="progress progress-info">
  <div class="bar" style="width: 20%"></div>
</div>
<div class="progress progress-success">
  <div class="bar" style="width: 40%"></div>
</div>
<div class="progress progress-warning">
  <div class="bar" style="width: 60%"></div>
</div>
<div class="progress progress-danger">
  <div class="bar" style="width: 80%"></div>
</div>

Полоски

Похожие на основные цвета, у нас есть разнообразные полоски прогресса.

<div class="progress progress-info progress-striped">
  <div class="bar" style="width: 20%"></div>
</div>
<div class="progress progress-success progress-striped">
  <div class="bar" style="width: 40%"></div>
</div>
<div class="progress progress-warning progress-striped">
  <div class="bar" style="width: 60%"></div>
</div>
<div class="progress progress-danger progress-striped">
  <div class="bar" style="width: 80%"></div>
</div>

Поддержка браузеров

Полосы прогресса используют CSS3 градиенты, переходы и анимации для достижения всех своих эффектов. Эти функции не поддерживаются в IE7-9 или старых версиях Firefox.

Версии, предшествующие Internet Explorer 10 и Opera 12, не поддерживают анимации.

Абстрактные стили объектов для создания различных типов компонентов (например, комментариев блога, Твитов и т.д.) с изображением слева или справа от текстового контента.

Пример по умолчанию

По умолчанию объект медиа позволяет плавать объекту медиа (изображения, видео, аудио) влево или вправо от блока контента.

Heading 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.

Heading 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.

Heading 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.
<div class="media">
  <a class="pull-left" href="#">
    <img class="media-object" data-src="holder.js/64x64">
  </a>
  <div class="media-body">
    <h4 class="media-heading">Heading media</h4>
    ...

    <!-- Nested media object -->
    <div class="media">
      ...
    </div>
  </div>
</div>

Список медиа

С небольшим дополнительным HTML вы можете использовать медиа внутри списка (полезно для потоков комментариев или списков статей).

  • Heading 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.

    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.
  • Heading 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.
<ul class="media-list">
  <li class="media">
    <a class="pull-left" href="#">
      <img class="media-object" data-src="holder.js/64x64">
    </a>
    <div class="media-body">
      <h4 class="media-heading">Heading media</h4>
      ...

      <!-- Nested media object -->
      <div class="media">
        ...
     </div>
    </div>
  </li>
</ul>

Well

Используйте well как простой эффект на элементе, чтобы он выглядел вставленным.

Look, I'm in a well!
<div class="well">
  ...
</div>

Опциональные классы

Управляйте отступами и скруглением углов с помощью двух опциональных модификаторных классов.

Look, I'm in a well!
<div class="well well-large">
  ...
</div>
Look, I'm in a well!
<div class="well well-small">
  ...
</div>

Иконка закрытия

Используйте универсальную иконку закрытия для закрытия контента, такого как модальные окна и алерты.

<button class="close">&times;</button>

Устройства iOS требуют href="#" для событий клика, если вы предпочитаете использовать тег <a>.

<a class="close" href="#">&times;</a>

Классы помощи

Простые, сосредоточенные классы для небольших изменений отображения или поведения.

.pull-left

Плавающий элемент влево

class="pull-left"
.pull-left {
  float: left;
}

.pull-right

Плавающий элемент вправо

class="pull-right"
.pull-right {
  float: right;
}

.muted

Измените цвет элемента на #999

class="muted"
.muted {
  color: #999;
}

.clearfix

Очистите float на любом элементе

class="clearfix"
.clearfix {
  *zoom: 1;
  &:before,
  &:after {
    display: table;
    content: "";
  }
  &:after {
    clear: both;
  }
}