in English

Введение

Начните работу с Bootstrap, самого популярного в мире фреймворка для создания адаптивных мобильных сайтов, с jsDelivr и стартовой страницей шаблона.

Быстрый старт

Хотите быстро добавить Bootstrap в свой проект? Используйте jsDelivr, бесплатный CDN с открытым исходным кодом. Используете менеджер пакетов или вам нужно загрузить исходные файлы? Перейдите на страницу загрузок .

CSS

Скопируйте и вставьте таблицу стилей <link>в свою <head>перед всеми остальными таблицами стилей, чтобы загрузить наш CSS.

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" integrity="sha384-xOolHFLEh07PJGoPkLv1IbcEPTNtaed2xpHsD9ESMhqIYd0nLMwNLD69Npy4HI+N" crossorigin="anonymous">

JS

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

Поместите один из следующих <script>s в конце ваших страниц, прямо перед закрывающим </body>тегом, чтобы включить их. Первым должен быть jQuery, затем Popper, а затем наши плагины JavaScript.

Пучок

Включите каждый плагин Bootstrap JavaScript в один из наших двух пакетов. Оба bootstrap.bundle.jsи bootstrap.bundle.min.jsвключают Popper для наших всплывающих подсказок и всплывающих окон, но не jQuery . Сначала включите jQuery, а затем пакет Bootstrap JavaScript. Для получения дополнительной информации о том, что включено в Bootstrap, см. наш раздел содержания .

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/jquery.slim.min.js" integrity="sha384-DfXdz2htPH0lsSSs5nCTpuj/zy4C+OGpamoFVy38MVBnE+IbbVYUew+OrCXaRkfj" crossorigin="anonymous"></script>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js" integrity="sha384-Fy6S3B9q64WdZWQUiU+q4/2Lc9npb8tCaSX9FK7E8HnRr0Jz8D6OP9dO5Vg3Q9ct" crossorigin="anonymous"></script>

Отдельный

Если вы решите использовать решение с отдельными скриптами, Popper должен быть первым (если вы используете всплывающие подсказки или всплывающие окна), а затем наши плагины JavaScript.

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/jquery.slim.min.js" integrity="sha384-DfXdz2htPH0lsSSs5nCTpuj/zy4C+OGpamoFVy38MVBnE+IbbVYUew+OrCXaRkfj" crossorigin="anonymous"></script>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/umd/popper.min.js" integrity="sha384-9/reFTGAW83EW2RDu2S0VKaIzap3H66lZH81PoYlFhbGU+6BZp6G7niu735Sk7lN" crossorigin="anonymous"></script>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.min.js" integrity="sha384-+sLIOodYLS7CIrQpBjl+C7nPvqq+FbNUBDunl/OZv93DB7Ln/533i8e/mZXLi/P+" crossorigin="anonymous"></script>

Составные части

Любопытно, какие компоненты явно требуют jQuery, нашего JavaScript и Popper? Щелкните ссылку «Показать компоненты» ниже. Если вы не уверены в структуре страницы, продолжайте читать пример шаблона страницы.

Показать компоненты, требующие JavaScript
  • Оповещения об увольнении
  • Кнопки для переключения состояний и функций флажков/радио
  • Карусель для всех вариантов поведения слайдов, элементов управления и индикаторов
  • Свернуть для переключения видимости содержимого
  • Выпадающие списки для отображения и позиционирования (также требуется Popper )
  • Модальные окна для отображения, позиционирования и поведения прокрутки
  • Панель навигации для расширения нашего плагина Collapse для реализации адаптивного поведения.
  • Scrollspy для поведения прокрутки и обновлений навигации
  • Всплывающие подсказки и всплывающие окна для отображения и позиционирования (также требуется Popper )

Стартовый шаблон

Убедитесь, что ваши страницы настроены в соответствии с последними стандартами дизайна и разработки. Это означает использование типа документа HTML5 и включение метатега области просмотра для правильного реагирования. Соберите все вместе, и ваши страницы должны выглядеть так:

<!doctype html>
<html lang="en">
  <head>
    <!-- Required meta tags -->
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">

    <!-- Bootstrap CSS -->
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" integrity="sha384-xOolHFLEh07PJGoPkLv1IbcEPTNtaed2xpHsD9ESMhqIYd0nLMwNLD69Npy4HI+N" crossorigin="anonymous">

    <title>Hello, world!</title>
  </head>
  <body>
    <h1>Hello, world!</h1>

    <!-- Optional JavaScript; choose one of the two! -->

    <!-- Option 1: jQuery and Bootstrap Bundle (includes Popper) -->
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/jquery.slim.min.js" integrity="sha384-DfXdz2htPH0lsSSs5nCTpuj/zy4C+OGpamoFVy38MVBnE+IbbVYUew+OrCXaRkfj" crossorigin="anonymous"></script>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js" integrity="sha384-Fy6S3B9q64WdZWQUiU+q4/2Lc9npb8tCaSX9FK7E8HnRr0Jz8D6OP9dO5Vg3Q9ct" crossorigin="anonymous"></script>

    <!-- Option 2: Separate Popper and Bootstrap JS -->
    <!--
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/jquery.slim.min.js" integrity="sha384-DfXdz2htPH0lsSSs5nCTpuj/zy4C+OGpamoFVy38MVBnE+IbbVYUew+OrCXaRkfj" crossorigin="anonymous"></script>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/umd/popper.min.js" integrity="sha384-9/reFTGAW83EW2RDu2S0VKaIzap3H66lZH81PoYlFhbGU+6BZp6G7niu735Sk7lN" crossorigin="anonymous"></script>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.min.js" integrity="sha384-+sLIOodYLS7CIrQpBjl+C7nPvqq+FbNUBDunl/OZv93DB7Ln/533i8e/mZXLi/P+" crossorigin="anonymous"></script>
    -->
  </body>
</html>

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

Важные глобальные переменные

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

Тип документа HTML5

Bootstrap требует использования типа документа HTML5. Без него вы увидите какой-то причудливый незавершенный стиль, но включение его не должно вызывать значительных сбоев.

<!doctype html>
<html lang="en">
  ...
</html>

Отзывчивый метатег

Bootstrap разрабатывается в первую очередь для мобильных устройств. Это стратегия, при которой мы сначала оптимизируем код для мобильных устройств, а затем масштабируем компоненты по мере необходимости с помощью медиа-запросов CSS. Чтобы обеспечить правильный рендеринг и сенсорное масштабирование для всех устройств, добавьте метатег адаптивного окна просмотра в файл <head>.

<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">

Вы можете увидеть пример этого в действии в начальном шаблоне .

Размер коробки

Для более простого определения размера в CSS мы переключаем глобальное box-sizingзначение с content-boxна border-box. Это гарантирует padding, что не повлияет на окончательную вычисленную ширину элемента, но может вызвать проблемы с некоторыми сторонними программами, такими как Google Maps и Google Custom Search Engine.

В редких случаях вам нужно переопределить его, используйте что-то вроде следующего:

.selector-for-some-widget {
  box-sizing: content-box;
}

В приведенном выше фрагменте вложенные элементы, включая сгенерированный контент с помощью ::beforeи ::after, будут наследовать указанные box-sizingдля этого .selector-for-some-widget.

Узнайте больше о блочной модели и размерах на CSS Tricks .

Перезагрузить

Для улучшения кросс-браузерного рендеринга мы используем Reboot для исправления несоответствий между браузерами и устройствами, обеспечивая при этом несколько более точные сбросы для общих элементов HTML.

Сообщество

Будьте в курсе развития Bootstrap и обращайтесь к сообществу с помощью этих полезных ресурсов.

  • Читайте и подписывайтесь на официальный блог Bootstrap .
  • Общайтесь с другими загрузчиками в IRC. На irc.libera.chatсервере, в #bootstrapканале.
  • Справку по реализации можно найти в Stack Overflow (с тегом bootstrap-4).
  • Разработчики должны использовать ключевое слово bootstrapв пакетах, которые изменяют или добавляют функциональность Bootstrap при распространении через npm или аналогичные механизмы доставки для максимальной возможности обнаружения.

Вы также можете подписаться на @getbootstrap в Твиттере , чтобы быть в курсе последних сплетен и потрясающих музыкальных клипов.

CSP и встроенные SVG

Несколько компонентов Bootstrap включают в себя встроенные SVG в наш CSS, чтобы стилизовать компоненты последовательно и легко в разных браузерах и на разных устройствах. Для организаций с более строгими конфигурациями CSP мы задокументировали все экземпляры наших встроенных SVG (все они применяются с помощью background-image), чтобы вы могли более тщательно изучить свои варианты.

Основываясь на обсуждении в сообществе , некоторые варианты решения этой проблемы в вашей собственной кодовой базе включают замену URL-адресов локально размещенными активами, удаление изображений и использование встроенных изображений (возможно не во всех компонентах) и изменение вашего CSP. Мы рекомендуем тщательно проанализировать собственные политики безопасности и, при необходимости, выбрать наилучший путь вперед.