Ponto de partida
Introdução ao Bootstrap, como baixar e usar, exemplos de templates, e etc.
Introdução ao Bootstrap, como baixar e usar, exemplos de templates, e etc.
Bootstrap (atualmente v3.3.7) possibilita algumas maneiras para se usar, cada uma diferente dependendo do seu seu nível de conhecimento ou caso de uso. Leia e descubra qual a mais adequada às suas necessidades.
CSS, JavaScript e fonts compilados e minificados. Não inclui a documentação ou código fonte.
Less, JavaScript e arquivos fonts, junto com nossa documentação. Requer um compilador Less e alguma configuração.
Bootstrap portou Less para Sass para facilitar a inserção em projetos Rails, Compass, ou Sass-only.
O pessoal da MaxCDN fornece graciosamente suporte CDN para CSS e JavaScript do Bootstrap. Basta usar Bootstrap CDN atráves desses links.
Você pode tambem instalar e manusear o Less, CSS, JavaScript e fonts do Bootstrap usando Bower:
You can also install Bootstrap using npm:
require('bootstrap')
will load all of Bootstrap's jQuery plugins onto the jQuery object. The bootstrap
module itself does not export anything. You can manually load Bootstrap's jQuery plugins individually by loading the /js/*.js
files under the package's top-level directory.
Bootstrap's package.json
contains some additional metadata under the following keys:
less
- caminho para o arquivo principal Less do Bootstrapstyle
- caminho para CSS não minificado do Bootstrap, que foram pré-compilados usando as configurações padrão (sem personalização)Você pode tambem instalar e manusear o Less, CSS, JavaScript e fonts do Bootstrap usando Composer:
Bootstrap usa Autoprefixer para trabalhar com CSS vendor prefixes. Se você está compilando o Less/Sass do Bootstrap e não está usando o nosso Gruntfile, então você precisa do Autoprefixer para integrar seu processo de construção. Se você estiver usando Bootstrap pré-compilado ou usando o nosso Gruntfile, você não precisa se preocupar com isso porque o Autoprefixer já está integrado no nosso Gruntfile.
Bootstrap está disponível para download em duas formas, no qual você encontrará os seguintes diretórios e arquivos, agrupando logicamente recursos comuns e fornecendo ambas as variações: compilados e minificados.
Por favor, note que todos plugins JavaScript necessitam do jQuery para serem incluídos, como mostrado no template de partida. Consulte nosso bower.json
para ver quais versões do jQuery são suportados.
Feito o download, descompacte a pasta compactada para ver a estrutura do Bootstrap (o compilado). Você verá algo parecido com isto:
Esta é a forma mais básica de Bootstrap: arquivos pré-compilados, caí como uma luva para quase qualquer um projeto web. Nós fornecemos CSS e JS compilados (bootstrap.*
), assim como CSS e JS compilados e minificados (bootstrap.min.*
). CSS source maps (bootstrap.*.map
) estão disponíveis para uso com ferramentas de desenvolvimento em determinados navegadores. Fonts Glyphicons estão incluídos, assim como o tema Bootstrap opcional.
O download do código fonte Bootstrap inclui o CSS, JavaScript pré-compilados e assets fonts, junto com o fonte do Less, JavaScripts e documentação. Mais precisamente, ele inclui algo assim:
Os diretórios less/
, js/
, e fonts/
incluí códigos fonte para nosso CSS, JS, e fonts ícones (respectivamente). O diretório dist/
incluí tudo referente a sessão de download pré-compilado sozinho. O diretório docs/
incluí o código fonte da documentação, com exemplos de uso em examples/
. Além disso, qualquer outro arquivo incluído fornece suporte para pacotes, informações de licença e desenvolvimento.
Bootstrap usa Grunt para seu sistema de compilação, com métodos convenientes para trabalhar com o framework. É como nós compilamos nosso código, executamos testes, e muito mais.
Para instalar Grunt, você deve primeiro baixar e instalar o node.js (que inclui npm). npm auxilia com os node packaged modules e é uma maneira de gerar dependências de desenvolvimento através do node.js.
Então, a partir do command line (linha de comando):grunt-cli
com npm install -g grunt-cli
./bootstrap/
, depois execute npm install
. npm vai identificar o arquivo package.json
e automaticamente instar as dependencias necessárias listada lá.Quando concluído, você será capaz de executar os vários comandos disponibilizados pelo Grunt a partir da linha de comando.
grunt dist
(Apenas compila o CSS e JavaScript)Regenera o diretório /dist/
com arquivos CSS e JavaScript compilados e minificados. Como usuário Bootstrap, este é normalmente o comando mais desejado.
grunt watch
(Assistir)Assiste em tempo real os arquivos fonte Less e automaticamente recompila para CSS sempre que você salvar alguma alteração.
grunt test
(Executar testes)Executa testes com JSHint e o QUnit em PhantomJS.
grunt docs
(Construir & testar documentação assets)Cria e testa o CSS, JavaScript, e outros assets que são usados ao executar a documentação localmente via bundle exec jekyll serve
.
grunt
(Construir absolutamente tudo e executar testes)Compila e minifica o CSS e JavaScript, constrói o site da documentação, executa o validador HTML5 de encontro com o docs, regenera os assets personalizados, e muito mais. Requer Jekyll. Normalmente, só é necessário se você está explorando a fundo Bootstrap.
Se você encontrar problemas com a instalação de dependências ou ao executar comandos Grunt, primeiro exclua o diretório /node_modules/
gerado pelo npm. Então, execute novamente npm install
.
Comece com este modelo básico de HTML, ou modifique estes exemplos. Esperamos que você possa personalizar nossos modelos de exemplos, adaptando-os para atender às suas necessidades.
Copie o código HTML abaixo para começar a trabalhar com um documento Bootstrap mínimo.
Criados a partir do modelo base acima e com muitos componentes do Bootstrap. Nós encorajamos você a personalizar e adaptar o Bootstrap para atender às necessidades do seu projeto.
Possua todo o código fonte de exemplo abaixo fazendo o download do repositório do Bootstrap. Exemplos podem ser encontrados no diretório docs/examples/
.
Template super básico que incluí a barra de navegação com algum conteúdo adicional.
Estrura básica para um painel de controle administrativo com barra lateral e navegação fixos.
Cria uma barra de navegação personalizada com links justificados. Aviso! Não é amigavel no Safari.
Bootlint is the official Bootstrap HTML linter tool. It automatically checks for several common HTML mistakes in webpages that are using Bootstrap in a fairly "vanilla" way. Vanilla Bootstrap's components/widgets require their parts of the DOM to conform to certain structures. Bootlint checks that instances of Bootstrap components have correctly-structured HTML. Consider adding Bootlint to your Bootstrap web development toolchain so that none of the common mistakes slow down your project's development.
Mantenha-se atualizado sobre o desenvolvimento do Bootstrap e aproxime mais da comunidade com esses recursos.
irc.freenode.net
, no canal ##bootstrap.twitter-bootstrap-3
.bootstrap
em pacotes alterados ou criados com funcionalidade do Bootstrap e distribuir através npm ou mecanismos similares para que possam ser descobertos facilmente.Você tambem pode seguir @getbootstrap no Twitter e @getbootstrap no Facebook para as últimas fofocas e vídeo-clipes bacanas.
Páginas com Bootstrap é adaptado automaticamente para várias tamanhos de telas. Veja aqui como desativar essa funcionalidade para ficar como este exemplo não-responsivo.
<meta>
viewport mencionada na documentação CSSwidth
no .container
para cada camada do grid com uma única largura, por exemplo width: 970px !important;
Certifique-se de que esta regra venha após o CSS padrão do Bootstrap. Opcionalmente, você pode evitar o !important
com *media queries* ou alguns seletores..col-xs-*
, ou no lugar de, colunas .col-md-*
ou .col-lg-*
. Não se preocupe, as colunas .col-xs-*
serve para para todas as resoluções.Você vai ainda precisar do Respond.js para IE8 (pois nossa *media queries* e vão precisar ser processadas).
Nós seguimos essas etapas para o exemplo. Leia o seu código fonte para ver as alterações específicas foram aplicadas.
Procurando migrar da versão antiga do Bootstrap para v3.x? Verifique nosso guia de migração.
Bootstrap esta criado para funcionar nos melhores e atualizados navegadores desktop e móveis, ou seja, os navegadores mais antigos podem ser exibidos de forma diferente, embora totalmente funcional.
Especificamente, Oferecemos suporte para últimas versões de navegadores e plataformas.
Alternative browsers which use the latest version of WebKit, Blink, or Gecko, whether directly or via the platform's web view API, are not explicitly supported. However, Bootstrap should (in most cases) display and function correctly in these browsers as well. More specific support information is provided below.
Generally speaking, Bootstrap supports the latest versions of each major platform's default browsers. Note that proxy browsers (such as Opera Mini, Opera Mobile's Turbo mode, UC Browser Mini, Amazon Silk) are not supported.
Chrome | Firefox | Safari | |
---|---|---|---|
Android | Suportado | Suportado | N/A |
iOS | Suportado | Suportado | Suportado |
Similarly, the latest versions of most desktop browsers are supported.
Chrome | Firefox | Internet Explorer | Opera | Safari | |
---|---|---|---|---|---|
Mac | Suportado | Suportado | N/A | Suportado | Suportado |
Windows | Suportado | Suportado | Suportado | Suportado | Não suportado |
On Windows, we support Internet Explorer 8-11.
For Firefox, in addition to the latest normal stable release, we also support the latest Extended Support Release (ESR) version of Firefox.
Unofficially, Bootstrap should look and behave well enough in Chromium and Chrome for Linux, Firefox for Linux, and Internet Explorer 7, as well as Microsoft Edge, though they are not officially supported.
For a list of some of the browser bugs that Bootstrap has to grapple with, see our Wall of browser bugs.
Internet Explorer 8 and 9 are also Suportado, however, please be aware that some CSS3 properties and HTML5 elements are not fully Suportado by these browsers. In addition, Internet Explorer 8 requires the use of Respond.js to enable media query support.
Feature | Internet Explorer 8 | Internet Explorer 9 |
---|---|---|
border-radius |
Não Suportado | Suportado |
box-shadow |
Não Suportado | Suportado |
transform |
Não Suportado | Suportado, with -ms prefix |
transition |
Não Suportado | |
placeholder |
Não Suportado |
Visit Can I use... for details on browser support of CSS3 and HTML5 features.
Beware of the following caveats when using Respond.js in your development and production environments for Internet Explorer 8.
Using Respond.js with CSS hosted on a different (sub)domain (for example, on a CDN) requires some additional setup. See the Respond.js docs for details.
file://
Due to browser security rules, Respond.js doesn't work with pages viewed via the file://
protocol (like when opening a local HTML file). To test responsive features in IE8, view your pages over HTTP(S). See the Respond.js docs for details.
@import
Respond.js doesn't work with CSS that's referenced via @import
. In particular, some Drupal configurations are known to use @import
. See the Respond.js docs for details.
IE8 does not fully support box-sizing: border-box;
when combined with min-width
, max-width
, min-height
, or max-height
. For that reason, as of v3.0.1, we no longer use max-width
on .container
s.
IE8 has some issues with @font-face
when combined with :before
. Bootstrap uses that combination with its Glyphicons. If a page is cached, and loaded without the mouse over the window (i.e. hit the refresh button or load something in an iframe) then the page gets rendered before the font loads. Hovering over the page (body) will show some of the icons and hovering over the remaining icons will show those as well. See issue #13863 for details.
Bootstrap is Não Suportado in the old Internet Explorer compatibility modes. To be sure you're using the latest rendering mode for IE, consider including the appropriate <meta>
tag in your pages:
Confirm the document mode by opening the debugging tools: press F12 and check the "Document Mode".
This tag is included in all of Bootstrap's documentation and examples to ensure the best rendering possible in each Suportado version of Internet Explorer.
See this StackOverflow question for more information.
Internet Explorer 10 doesn't differentiate device width from viewport width, and thus doesn't properly apply the media queries in Bootstrap's CSS. Normally you'd just add a quick snippet of CSS to fix this:
However, this doesn't work for devices running Windows Phone 8 versions older than Update 3 (a.k.a. GDR3), as it causes such devices to show a mostly desktop view instead of narrow "phone" view. To address this, you'll need to include the following CSS and JavaScript to work around the bug.
For more information and usage guidelines, read Windows Phone 8 and Device-Width.
As a heads up, we include this in all of Bootstrap's documentation and examples as a demonstration.
The rendering engine of versions of Safari prior to v7.1 for OS X and Safari for iOS v8.0 had some trouble with the number of decimal places used in our .col-*-1
grid classes. So if you had 12 individual grid columns, you'd notice that they came up short compared to other rows of columns. Besides upgrading Safari/iOS, you have some options for workarounds:
.pull-right
to your last grid column to get the hard-right alignmentSupport for overflow: hidden
on the <body>
element is quite limited in iOS and Android. To that end, when you scroll past the top or bottom of a modal in either of those devices' browsers, the <body>
content will begin to scroll. See Chrome bug #175502 (fixed in Chrome v40) and WebKit bug #153852.
As of iOS 9.3, while a modal is open, if the initial touch of a scroll gesture is within the boundary of a textual <input>
or a <textarea>
, the <body>
content underneath the modal will be scrolled instead of the modal itself. See WebKit bug #153856.
Also, note that if you're using a fixed navbar or using inputs within a modal, iOS has a rendering bug that doesn't update the position of fixed elements when the virtual keyboard is triggered. A few workarounds for this include transforming your elements to position: absolute
or invoking a timer on focus to try to correct the positioning manually. This is not handled by Bootstrap, so it is up to you to decide which solution is best for your application.
The .dropdown-backdrop
element isn't used on iOS in the nav because of the complexity of z-indexing. Thus, to close dropdowns in navbars, you must directly click the dropdown element (or any other element which will fire a click event in iOS).
Page zooming inevitably presents rendering artifacts in some components, both in Bootstrap and the rest of the web. Depending on the issue, we may be able to fix it (search first and then open an issue if need be). However, we tend to ignore these as they often have no direct solution other than hacky workarounds.
:hover
/:focus
on mobileEven though real hovering isn't possible on most touchscreens, most mobile browsers emulate hovering support and make :hover
"sticky". In other words, :hover
styles start applying after tapping an element and only stop applying after the user taps some other element. This can cause Bootstrap's :hover
states to become undesirably "stuck" on such browsers. Some mobile browsers also make :focus
similarly sticky. There is currently no simple workaround for these issues other than removing such styles entirely.
Even in some modern browsers, printing can be quirky.
In particular, as of Chrome v32 and regardless of margin settings, Chrome uses a viewport width significantly narrower than the physical paper size when resolving media queries while printing a webpage. This can result in Bootstrap's extra-small grid being unexpectedly activated when printing. See issue #12078 and Chrome bug #273306 for some details. Suggested workarounds:
@screen-*
Less variables so that your printer paper is considered larger than extra-small.Also, as of Safari v8.0, fixed-width .container
s can cause Safari to use an unusually small font size when printing. See #14868 and WebKit bug #138192 for more details. One potential workaround for this is adding the following CSS:
Out of the box, Android 4.1 (and even some newer releases apparently) ship with the Browser app as the default web browser of choice (as opposed to Chrome). Unfortunately, the Browser app has lots of bugs and inconsistencies with CSS in general.
On <select>
elements, the Android stock browser will not display the side controls if there is a border-radius
and/or border
applied. (See this StackOverflow question for details.) Use the snippet of code below to remove the offending CSS and render the <select>
as an unstyled element on the Android stock browser. The user agent sniffing avoids interference with Chrome, Safari, and Mozilla browsers.
Want to see an example? Check out this JS Bin demo.
In order to provide the best possible experience to old and buggy browsers, Bootstrap uses CSS browser hacks in several places to target special CSS to certain browser versions in order to work around bugs in the browsers themselves. These hacks understandably cause CSS validators to complain that they are invalid. In a couple places, we also use bleeding-edge CSS features that aren't yet fully standardized, but these are used purely for progressive enhancement.
These validation warnings don't matter in practice since the non-hacky portion of our CSS does fully validate and the hacky portions don't interfere with the proper functioning of the non-hacky portion, hence why we deliberately ignore these particular warnings.
Our HTML docs likewise have some trivial and inconsequential HTML validation warnings due to our inclusion of a workaround for a certain Firefox bug.
While we don't officially support any third party plugins or add-ons, we do offer some useful advice to help avoid potential issues in your projects.
Some third party software, including Google Maps and Google Custom Search Engine, conflict with Bootstrap due to * { box-sizing: border-box; }
, a rule which makes it so padding
does not affect the final computed width of an element. Learn more about box model and sizing at CSS Tricks.
Depending on the context, you may override as-needed (Option 1) or reset the box-sizing for entire regions (Option 2).
Bootstrap segue padrões web comuns e —com um pouco de esforço— pode ser criado sites acessíveis para aqueles que utilizam TA.
Se seu menu de navegação contém muitos links e vem antes do conteúdo principal, adicione um link Pular para conteúdo principal
antes do menu (para uma explicação simples, consulte este Artigo Projeto A11y - Como usar link pular navegação (em inglês)). Ao usar a classe .sr-only
irá ocultar visualmente o link ancora, e a classe .sr-only-focusable
irá garantir que o elemento só se tornará visível uma vez focada (para usuários com visão de teclado).
Devido a problemas de longa data / bugs no Chrome (veja a issue 262171 in the Chromium bug tracker) e Internet Explorer (veja o artigo in-page links and focus order), Você vai precisar ter certeza de que o elemento de destino do seu link ancora é, esteja preparado para isso, para isso, basta adicionar o código tabindex="-1"
.
Além disso, você pode não querer criar uma indicação explicita de que o elemento destino esteja realmente em foco com #content:focus { outline: none; }
.
Note que este bug também afetará qualquer outro link ancora em seu site possa estar usando, tornando-os inúteis para usuários de teclado.
Quando criamos uma hierarquia de cabeçalho (<h1>
- <h6>
), em seu documento, o cabeçalho principal de ser <h1>
. Em seguida cabeçalhos <h2>
- <h6>
devem vir de forma lógica, de tal modo que os leitores de telas consigam criar uma tabela de conteúdo para suas páginas.
Leia mais sobre Cabeçalhos nível 1, sections e acessibilidade e Entendendo o Outline do HTML.
Atualmente, algumas cores padrão disponíveis no Bootstrap (tais como várias usadas em classes de botões, parte da cor do código destacado em blocos de código básico, a classe .bg-primary
em background contextual nas classes de ajuda, e a cor do link padrão quando usado em um fundo branco) têm uma relação de baixo contraste (abaixo da proporção recomendada de 4.5:1). Isso pode causar problemas para usuários com baixa visão ou que são daltônicos. Estas cores padrão podem precisar ser modificadas para aumentar seu contraste e legibilidade.
Bootstrap esta lançado sob a licença MIT e com direitos autorais (copyright) 2016 Twitter. Cheio de pedaços menores, pode ser descrito com as seguintes condições.
A licença completa do Bootstrap esta localizada em nosso repositório do projeto para mais informações.
Membros da comunidade têm traduzido a documentação do Bootstrap em várias línguas.
Nós não ajudamos a organizar ou hospedar traduções, nós apenas divulgamos eles.
Terminou uma nova tradução? Solicite uma requisição para adicioná-lo à nossa lista.