Komma igång
En översikt över Bootstrap, hur man laddar ner och använder, grundläggande mallar och exempel med mera.
En översikt över Bootstrap, hur man laddar ner och använder, grundläggande mallar och exempel med mera.
Bootstrap (för närvarande v3.3.7) har några enkla sätt att snabbt komma igång, var och en tilltalar olika färdighetsnivåer och användningsfall. Läs igenom för att se vad som passar just dina behov.
Sammanställd och minifierad CSS, JavaScript och typsnitt. Inga dokument eller originalkällfiler ingår.
Källa Less, JavaScript och teckensnittsfiler, tillsammans med våra dokument. Kräver en mindre kompilator och en del inställningar.
Bootstrap portad från Less till Sass för enkel inkludering i Rails, Compass eller Sass-bara projekt.
Folket på jsDelivr tillhandahåller nådigt CDN-stöd för Bootstraps CSS och JavaScript. Använd bara dessa Bootstrap CDN- länkar.
Du kan också installera och hantera Bootstraps Less, CSS, JavaScript och teckensnitt med hjälp av Bower :
Du kan också installera Bootstrap med npm :
require('bootstrap')
kommer att ladda alla Bootstraps jQuery-plugin-program till jQuery-objektet. Modulen bootstrap
själv exporterar ingenting. Du kan manuellt ladda Bootstraps jQuery-plugins individuellt genom att ladda /js/*.js
filerna under paketets översta katalog.
Bootstraps package.json
innehåller ytterligare metadata under följande nycklar:
less
- sökväg till Bootstraps huvudsakliga Less -källfilstyle
- sökväg till Bootstraps icke-minifierade CSS som har förkompilerats med standardinställningarna (ingen anpassning)Du kan också installera och hantera Bootstraps Less, CSS, JavaScript och teckensnitt med hjälp av Composer :
Bootstrap använder Autoprefixer för att hantera CSS-leverantörsprefix . Om du kompilerar Bootstrap från dess Less/Sass-källa och inte använder vår Gruntfile, måste du själv integrera Autoprefixer i din byggprocess. Om du använder förkompilerad Bootstrap eller använder vår Gruntfil, behöver du inte oroa dig för detta eftersom Autoprefixer redan är integrerad i vår Gruntfil.
Bootstrap är nedladdningsbart i två former, inom vilka du hittar följande kataloger och filer, logiskt grupperar gemensamma resurser och tillhandahåller både kompilerade och minifierade varianter.
Observera att alla JavaScript-plugins kräver att jQuery inkluderas, som visas i startmallen . Konsultera vårbower.json
för att se vilka versioner av jQuery som stöds.
När du har laddat ner, packa upp den komprimerade mappen för att se strukturen för (den kompilerade) Bootstrap. Du kommer att se något sånt här:
Detta är den mest grundläggande formen av Bootstrap: förkompilerade filer för snabb drop-in-användning i nästan alla webbprojekt. Vi tillhandahåller kompilerad CSS och JS ( bootstrap.*
), samt kompilerad och minifierad CSS och JS ( bootstrap.min.*
). CSS -källkartor ( bootstrap.*.map
) är tillgängliga för användning med vissa webbläsares utvecklarverktyg. Typsnitt från Glyphicons ingår, liksom det valfria Bootstrap-temat.
Nedladdningen av Bootstrap-källkoden inkluderar de förkompilerade CSS-, JavaScript- och teckensnittstillgångarna, tillsammans med source Less, JavaScript och dokumentation. Mer specifikt inkluderar den följande och mer:
less/
, js/
, och fonts/
är källkoden för våra CSS-, JS- och ikonteckensnitt (respektive) . Mappen dist/
innehåller allt som anges i den förkompilerade nedladdningssektionen ovan. Mappen docs/
innehåller källkoden för vår dokumentation och examples/
Bootstrap-användning. Utöver det ger alla andra inkluderade filer stöd för paket, licensinformation och utveckling.
Bootstrap använder Grunt för sitt byggsystem, med bekväma metoder för att arbeta med ramverket. Det är hur vi kompilerar vår kod, kör tester och mer.
För att installera Grunt måste du först ladda ner och installera node.js (som inkluderar npm). npm står för node packed modules och är ett sätt att hantera utvecklingsberoenden genom node.js.
Sedan, från kommandoraden:grunt-cli
globalt med npm install -g grunt-cli
./bootstrap/
och kör sedan npm install
. npm kommer att titta på package.json
filen och automatiskt installera nödvändiga lokala beroenden som anges där.När du är klar kommer du att kunna köra de olika Grunt-kommandon som tillhandahålls från kommandoraden.
grunt dist
(Kompilera bara CSS och JavaScript)Återskapar /dist/
katalogen med kompilerade och minifierade CSS- och JavaScript-filer. Som Bootstrap-användare är detta normalt kommandot du vill ha.
grunt watch
(Kolla på)Tittar på Less-källfilerna och kompilerar dem automatiskt till CSS när du sparar en ändring.
grunt test
(Kör tester)Kör JSHint och kör QUnit- testerna huvudlöst i PhantomJS .
grunt docs
(Skapa och testa dokumenttillgångarna)Bygger och testar CSS, JavaScript och andra tillgångar som används när dokumentationen körs lokalt via bundle exec jekyll serve
.
grunt
(Bygg absolut allt och kör tester)Kompilerar och förminskar CSS och JavaScript, bygger dokumentationswebbplatsen, kör HTML5-valideraren mot dokumenten, återskapar Customizer-tillgångarna och mer. Kräver Jekyll . Vanligtvis bara nödvändigt om du hackar på Bootstrap själv.
Skulle du stöta på problem med att installera beroenden eller köra Grunt-kommandon, ta först bort /node_modules/
katalogen som genereras av npm. Kör sedan igen npm install
.
Börja med denna grundläggande HTML-mall eller ändra dessa exempel . Vi hoppas att du kommer att anpassa våra mallar och exempel så att de passar dina behov.
Kopiera HTML-koden nedan för att börja arbeta med ett minimalt Bootstrap-dokument.
Bygg på grundmallen ovan med Bootstraps många komponenter. Vi uppmuntrar dig att anpassa och anpassa Bootstrap för att passa ditt individuella projekts behov.
Få källkoden för varje exempel nedan genom att ladda ner Bootstrap-förvaret . Exempel finns i docs/examples/
katalogen.
Super grundläggande mall som inkluderar navigeringsfältet tillsammans med lite extra innehåll.
Grundläggande struktur för en admin-dashboard med fast sidofält och navigeringsfält.
Skapa ett anpassat navigeringsfält med motiverade länkar. Se upp! Inte alltför safarivänlig.
Bootlint är det officiella Bootstrap HTML linter- verktyget. Den letar automatiskt efter flera vanliga HTML-fel på webbsidor som använder Bootstrap på ett ganska "vanilj" sätt. Vanilla Bootstraps komponenter/widgets kräver att deras delar av DOM överensstämmer med vissa strukturer. Bootlint kontrollerar att instanser av Bootstrap-komponenter har korrekt strukturerad HTML. Överväg att lägga till Bootlint till din Bootstrap webbutvecklingsverktygskedja så att inget av de vanliga misstagen saktar ner ditt projekts utveckling.
Håll dig uppdaterad om utvecklingen av Bootstrap och nå ut till samhället med dessa användbara resurser.
irc.freenode.net
servern, i ##bootstrap-kanalen .twitter-bootstrap-3
.bootstrap
på paket som modifierar eller lägger till funktionaliteten i Bootstrap när de distribuerar via npm eller liknande leveransmekanismer för maximal upptäckbarhet.Du kan också följa @getbootstrap på Twitter för det senaste skvallret och fantastiska musikvideor.
Bootstrap anpassar automatiskt dina sidor för olika skärmstorlekar. Så här inaktiverar du den här funktionen så att din sida fungerar som det här icke-responsiva exemplet .
<meta>
som nämns i CSS-dokumentenwidth
på .container
för varje rutnätsnivå med en enda bredd, till exempel width: 970px !important;
Se till att detta kommer efter standard Bootstrap CSS. Du kan valfritt undvika !important
med mediefrågor eller någon selector-fu..col-xs-*
klasser utöver eller i stället för de medelstora/stora. Oroa dig inte, det extra lilla enhetens rutnät skalas till alla upplösningar.Du behöver fortfarande Respond.js för IE8 (eftersom våra mediefrågor fortfarande finns där och behöver bearbetas). Detta inaktiverar "mobilwebbplats"-aspekterna av Bootstrap.
Vi har tillämpat dessa steg på ett exempel. Läs dess källkod för att se de specifika förändringarna som genomförts.
Vill du migrera från en äldre version av Bootstrap till v3.x? Kolla in vår migreringsguide .
Bootstrap är byggd för att fungera bäst i de senaste stationära och mobila webbläsarna, vilket innebär att äldre webbläsare kan visa olika stil, men fullt fungerande, renderingar av vissa komponenter.
Specifikt stöder vi de senaste versionerna av följande webbläsare och plattformar.
Alternativa webbläsare som använder den senaste versionen av WebKit, Blink eller Gecko, antingen direkt eller via plattformens webbvy-API, stöds inte uttryckligen. Bootstrap bör dock (i de flesta fall) visa och fungera korrekt även i dessa webbläsare. Mer specifik supportinformation finns nedan.
Generellt sett stöder Bootstrap de senaste versionerna av varje större plattforms standardwebbläsare. Observera att proxywebbläsare (som Opera Mini, Opera Mobiles Turbo-läge, UC Browser Mini, Amazon Silk) inte stöds.
Krom | Firefox | Safari | |
---|---|---|---|
Android | Stöds | Stöds | N/A |
iOS | Stöds | Stöds | Stöds |
På samma sätt stöds de senaste versionerna av de flesta stationära webbläsare.
Krom | Firefox | Internet Explorer | Opera | Safari | |
---|---|---|---|---|---|
Mac | Stöds | Stöds | N/A | Stöds | Stöds |
Windows | Stöds | Stöds | Stöds | Stöds | Stöds inte |
På Windows stöder vi Internet Explorer 8-11 .
För Firefox stöder vi, förutom den senaste normala stabila versionen, även den senaste versionen av Firefox (Extended Support Release) (ESR) .
Inofficiellt borde Bootstrap se ut och bete sig tillräckligt bra i Chromium och Chrome för Linux, Firefox för Linux och Internet Explorer 7, såväl som Microsoft Edge, även om de inte stöds officiellt.
För en lista över några av webbläsarbuggarna som Bootstrap måste brottas med, se vår Wall of browser bugs .
Internet Explorer 8 och 9 stöds också, men tänk på att vissa CSS3-egenskaper och HTML5-element inte stöds fullt ut av dessa webbläsare. Dessutom kräver Internet Explorer 8 användning av Respond.js för att möjliggöra stöd för mediefrågor.
Funktion | Internet Explorer 8 | Internet Explorer 9 |
---|---|---|
border-radius |
Stöds inte | Stöds |
box-shadow |
Stöds inte | Stöds |
transform |
Stöds inte | Stöds, med -ms prefix |
transition |
Stöds inte | |
placeholder |
Stöds inte |
Besök Kan jag använda... för information om webbläsarstöd för CSS3- och HTML5-funktioner.
Se upp för följande varningar när du använder Respond.js i dina utvecklings- och produktionsmiljöer för Internet Explorer 8.
Att använda Respond.js med CSS på en annan (under)domän (till exempel på ett CDN) kräver ytterligare inställningar. Se Respond.js-dokumentationen för mer information.
file://
På grund av webbläsarens säkerhetsregler fungerar inte Respond.js med sidor som visas via file://
protokollet (som när du öppnar en lokal HTML-fil). För att testa responsiva funktioner i IE8, visa dina sidor via HTTP(S). Se Respond.js-dokumentationen för mer information.
@import
Respond.js fungerar inte med CSS som refereras via @import
. I synnerhet är det känt att vissa Drupal-konfigurationer använder @import
. Se Respond.js-dokumentationen för mer information.
IE8 stöder inte fullt ut box-sizing: border-box;
när det kombineras med min-width
, max-width
, min-height
, eller max-height
. Av den anledningen, från och med v3.0.1, använder vi inte längre max-width
på .container
s.
IE8 har vissa problem med @font-face
när den kombineras med :before
. Bootstrap använder den kombinationen med sina Glyphicons. Om en sida är cachad och laddas utan musen över fönstret (dvs. tryck på uppdateringsknappen eller ladda något i en iframe) så renderas sidan innan typsnittet laddas. Håller du muspekaren över sidan (brödtexten) visas några av ikonerna och om du håller muspekaren över de återstående ikonerna visas dessa också. Se nummer #13863 för detaljer.
Bootstrap stöds inte i de gamla Internet Explorer-kompatibilitetslägena. För att vara säker på att du använder det senaste renderingsläget för IE, överväg att inkludera lämplig <meta>
tagg på dina sidor:
Bekräfta dokumentläget genom att öppna felsökningsverktygen: tryck F12och kontrollera "Dokumentläge".
Denna tagg ingår i all Bootstraps dokumentation och exempel för att säkerställa bästa möjliga rendering i varje version av Internet Explorer som stöds.
Se den här StackOverflow-frågan för mer information.
Internet Explorer 10 skiljer inte enhetens bredd från visningsportens bredd och tillämpar därför inte mediefrågorna i Bootstraps CSS korrekt. Normalt lägger du bara till ett snabbt utdrag av CSS för att fixa detta:
Detta fungerar dock inte för enheter som kör Windows Phone 8-versioner äldre än Update 3 (alias GDR3) , eftersom det får sådana enheter att visa en mestadels skrivbordsvy istället för en smal "telefonvy". För att lösa detta måste du inkludera följande CSS och JavaScript för att komma runt buggen .
För mer information och användningsriktlinjer, läs Windows Phone 8 och Device-Width .
Som en heads up inkluderar vi detta i all Bootstraps dokumentation och exempel som en demonstration.
Återgivningsmotorn för versioner av Safari före v7.1 för OS X och Safari för iOS v8.0 hade vissa problem med antalet decimaler som användes i våra .col-*-1
rutnätsklasser. Så om du hade 12 individuella rutkolumner, skulle du märka att de blev korta jämfört med andra rader med kolumner. Förutom att uppgradera Safari/iOS, har du några alternativ för lösningar:
.pull-right
till i din sista rutnätskolumn för att få hård-högerjusteringenStödet för overflow: hidden
elementet <body>
är ganska begränsat i iOS och Android. För detta ändamål, när du rullar förbi toppen eller botten av en modal i någon av dessa enheters webbläsare, <body>
kommer innehållet att börja rulla. Se Chrome bugg #175502 (fixad i Chrome v40) och WebKit bugg #153852 .
Från och med iOS 9.3, medan en modal är öppen, om den första beröringen av en rullningsgest är inom gränsen för en text <input>
eller en <textarea>
, kommer <body>
innehållet under modalen att rullas istället för själva modalen. Se WebKit-fel #153856 .
Observera också att om du använder en fast navbar eller använder ingångar inom en modal, har iOS en renderingsbugg som inte uppdaterar positionen för fasta element när det virtuella tangentbordet utlöses. Några lösningar för detta inkluderar att omvandla dina element till position: absolute
eller anropa en timer på fokus för att försöka korrigera positioneringen manuellt. Detta hanteras inte av Bootstrap, så det är upp till dig att bestämma vilken lösning som är bäst för din applikation.
Elementet .dropdown-backdrop
används inte på iOS i nav på grund av komplexiteten i z-indexering. För att stänga rullgardinsmenyn i navigeringsfält måste du alltså direkt klicka på rullgardinselementet (eller något annat element som kommer att utlösa en klickhändelse i iOS ).
Sidzoomning presenterar oundvikligen renderingsartefakter i vissa komponenter, både i Bootstrap och resten av webben. Beroende på problemet kan vi kanske åtgärda det (sök först och öppna sedan ett problem om det behövs). Vi tenderar dock att ignorera dessa eftersom de ofta inte har någon direkt lösning förutom hackiga lösningar.
:hover
/ :focus
på mobilÄven om riktig svävning inte är möjlig på de flesta pekskärmar, emulerar de flesta mobila webbläsare stöd för svävning och gör :hover
"klibbig". Med andra ord, :hover
stilar börjar tillämpas efter att ha tryckt på ett element och slutar tillämpas först efter att användaren tryckt på något annat element. Detta kan göra att Bootstraps :hover
tillstånd oönskat "fastnar" på sådana webbläsare. Vissa mobila webbläsare gör också :focus
liknande klibbiga. Det finns för närvarande ingen enkel lösning för dessa problem förutom att ta bort sådana stilar helt och hållet.
Även i vissa moderna webbläsare kan utskrift vara knäppt.
I synnerhet, från och med Chrome v32 och oavsett marginalinställningar, använder Chrome en visningsportbredd som är betydligt smalare än den fysiska pappersstorleken när man löser mediefrågor när man skriver ut en webbsida. Detta kan resultera i att Bootstraps extra lilla rutnät oväntat aktiveras vid utskrift. Se nummer #12078 och Chrome-fel #273306 för mer information. Föreslagna lösningar:
@screen-*
Less-variablerna så att ditt skrivarpapper anses vara större än extra litet.Från och med Safari v8.0 kan .container
s med fast bredd göra att Safari använder en ovanligt liten teckenstorlek vid utskrift. Se #14868 och WebKit bugg #138192 för mer information. En möjlig lösning för detta är att lägga till följande CSS:
Utanför förpackningen levereras Android 4.1 (och till och med några nyare versioner tydligen) med webbläsarappen som standardwebbläsare (i motsats till Chrome). Tyvärr har webbläsarappen massor av buggar och inkonsekvenser med CSS i allmänhet.
På <select>
element visar Android aktiewebbläsaren inte sidokontrollerna om det finns en border-radius
och/eller border
tillämpas. (Se den här StackOverflow-frågan för mer information.) Använd kodavsnittet nedan för att ta bort den stötande CSS-en och rendera den <select>
som ett oformaterat element i Androids aktiewebbläsare. Användaragenten som sniffar undviker störningar i webbläsarna Chrome, Safari och Mozilla.
Vill du se ett exempel? Kolla in den här JS Bin-demon.
För att ge bästa möjliga upplevelse till gamla och buggiga webbläsare använder Bootstrap CSS-webbläsarhack på flera ställen för att rikta speciell CSS till vissa webbläsarversioner för att komma runt buggar i själva webbläsarna. Dessa hack får förståeligt nog CSS-validerare att klaga på att de är ogiltiga. På ett par ställen använder vi också avancerade CSS-funktioner som ännu inte är helt standardiserade, men dessa används enbart för progressiv förbättring.
Dessa valideringsvarningar spelar ingen roll i praktiken eftersom den icke-hackiga delen av vår CSS valideras fullt ut och de hackiga delarna inte stör den korrekta funktionen av den icke-hackiga delen, varför vi medvetet ignorerar dessa varningar.
Våra HTML-dokument har också några triviala och oviktiga HTML-valideringsvarningar på grund av att vi inkluderade en lösning för en viss Firefox-bugg .
Även om vi inte officiellt stöder några plugins eller tillägg från tredje part, erbjuder vi några användbara råd för att undvika potentiella problem i dina projekt.
Viss programvara från tredje part, inklusive Google Maps och Google Custom Search Engine, kommer i konflikt med Bootstrap på grund av * { box-sizing: border-box; }
, en regel som gör att det padding
inte påverkar den slutgiltiga beräknade bredden på ett element. Lär dig mer om lådmodell och storlek på CSS Tricks .
Beroende på sammanhanget kan du åsidosätta vid behov (alternativ 1) eller återställa boxstorleken för hela regioner (alternativ 2).
Bootstrap följer vanliga webbstandarder och kan – med minimal extra ansträngning – användas för att skapa webbplatser som är tillgängliga för dem som använder AT .
Om din navigering innehåller många länkar och kommer före huvudinnehållet i DOM, lägg till en Skip to main content
länk före navigeringen (för en enkel förklaring, se denna A11Y-projektartikel om hoppa över navigeringslänkar ). Genom att använda .sr-only
klassen döljs överhoppningslänken visuellt, och .sr-only-focusable
klassen ser till att länken blir synlig när den är fokuserad (för seende tangentbordsanvändare).
På grund av långvariga brister/buggar i Chrome (se nummer 262171 i Chromium bug tracker ) och Internet Explorer (se den här artikeln om länkar på sidan och fokusordning ), måste du se till att målet för din hoppa över länken är åtminstone programmatiskt fokuserbar genom att lägga till tabindex="-1"
.
Dessutom kanske du explicit vill undertrycka en synlig fokusindikation på målet (särskilt eftersom Chrome för närvarande också sätter fokus på element med tabindex="-1"
när de klickas med musen) med #content:focus { outline: none; }
.
Observera att det här felet också kommer att påverka alla andra länkar på sidan som din webbplats använder, vilket gör dem oanvändbara för tangentbordsanvändare. Du kan överväga att lägga till en liknande stop-gap fix till alla andra namngivna ankare/fragmentidentifierare som fungerar som länkmål.
När du kapslar rubriker ( <h1>
- <h6>
) ska din primära dokumentrubrik vara en <h1>
. Efterföljande rubriker bör göra logisk användning av <h2>
- <h6>
så att skärmläsare kan konstruera en innehållsförteckning för dina sidor.
Läs mer på HTML CodeSniffer och Penn State's AccessAbility .
För närvarande är några av standardfärgkombinationerna tillgängliga i Bootstrap (såsom de olika formaterade knappklasserna , några av kodmarkeringsfärgerna som används för grundläggande kodblock , den .bg-primary
kontextuella bakgrundshjälparklassen och standardlänkfärgen när den används på en vit bakgrund) har ett lågt kontrastförhållande (under det rekommenderade förhållandet 4,5:1 ). Detta kan orsaka problem för användare med nedsatt syn eller som är färgblinda. Dessa standardfärger kan behöva ändras för att öka deras kontrast och läsbarhet.
Bootstrap släpps under MIT-licensen och är copyright 2016 Twitter. Kokt ner till mindre bitar kan det beskrivas med följande förutsättningar.
Den fullständiga Bootstrap-licensen finns i projektförrådet för mer information.
Community-medlemmar har översatt Bootstraps dokumentation till olika språk. Ingen stöds officiellt och de kanske inte alltid är uppdaterade.
Vi hjälper inte till att organisera eller vara värd för översättningar, vi länkar bara till dem.
Har du slutfört en ny eller bättre översättning? Öppna en pull-begäran för att lägga till den i vår lista.