Početak rada
Pregled Bootstrapa, kako preuzeti i koristiti, osnovni predlošci i primjeri i više.
Pregled Bootstrapa, kako preuzeti i koristiti, osnovni predlošci i primjeri i više.
Bootstrap (trenutno v3.3.7) ima nekoliko jednostavnih načina za brzi početak, od kojih je svaki privlačan različitoj razini vještina i slučaju korištenja. Pročitajte kako biste vidjeli što odgovara vašim posebnim potrebama.
Prevedeni i umanjeni CSS, JavaScript i fontovi. Nisu uključeni nikakvi dokumenti niti originalne izvorne datoteke.
Source Less, JavaScript i datoteke fontova, zajedno s našim dokumentima. Zahtijeva Less prevodilac i neke postavke.
Bootstrap prenesen s Lessa na Sass za jednostavno uključivanje u Rails, Compass ili samo Sass projekte.
Ljudi iz jsDelivr-a ljubazno pružaju CDN podršku za Bootstrapov CSS i JavaScript. Samo koristite ove Bootstrap CDN veze.
Također možete instalirati i upravljati Bootstrapovim Lessom, CSS-om, JavaScriptom i fontovima koristeći Bower :
Također možete instalirati Bootstrap koristeći npm :
require('bootstrap')
će učitati sve Bootstrapove jQuery dodatke na jQuery objekt. Sam bootstrap
modul ne izvozi ništa. Možete pojedinačno ručno učitati Bootstrapove jQuery dodatke učitavanjem /js/*.js
datoteka u direktoriju najviše razine paketa.
Bootstrap package.json
sadrži neke dodatne metapodatke pod sljedećim ključevima:
less
- put do Bootstrapove glavne izvorne datoteke Lessstyle
- put do Bootstrapovog neminificiranog CSS-a koji je unaprijed kompajliran korištenjem zadanih postavki (bez prilagodbe)Također možete instalirati i upravljati Bootstrapovim Lessom, CSS-om, JavaScriptom i fontovima koristeći Composer :
Bootstrap koristi Autoprefixer za rješavanje prefiksa dobavljača CSS- a . Ako kompajlirate Bootstrap iz Less/Sass izvora i ne koristite našu Gruntfile, morat ćete sami integrirati Autoprefixer u svoj proces izgradnje. Ako koristite unaprijed kompajlirani Bootstrap ili koristite našu Gruntfile, ne morate brinuti o tome jer je Autoprefixer već integriran u našu Gruntfile.
Bootstrap je moguće preuzeti u dva oblika, unutar kojih ćete pronaći sljedeće direktorije i datoteke, logički grupirajući zajedničke resurse i pružajući kompajlirane i umanjene varijacije.
Imajte na umu da svi JavaScript dodaci zahtijevaju da jQuery bude uključen, kao što je prikazano u početnom predlošku . Posavjetujte se s našimbower.json
da biste vidjeli koje su verzije jQueryja podržane.
Nakon preuzimanja, raspakirajte komprimiranu mapu da vidite strukturu (kompiliranog) Bootstrapa. Vidjet ćete nešto poput ovoga:
Ovo je najosnovniji oblik Bootstrapa: unaprijed kompilirane datoteke za brzu upotrebu u gotovo svakom web projektu. Nudimo kompilirani CSS i JS ( bootstrap.*
), kao i kompilirani i umanjeni CSS i JS ( bootstrap.min.*
). Izvorne karte CSS -a ( bootstrap.*.map
) dostupne su za korištenje s razvojnim alatima određenih preglednika. Uključeni su fontovi iz Glyphiconsa, kao i izborna Bootstrap tema.
Preuzimanje Bootstrap izvornog koda uključuje unaprijed kompajlirani CSS, JavaScript i elemente fonta, zajedno s izvornim Lessom, JavaScriptom i dokumentacijom. Točnije, uključuje sljedeće i više od toga:
, less/
, js/
i fonts/
izvorni su kod za naše CSS, JS i fontove ikona (respektivno). dist/
Mapa uključuje sve što je navedeno u prethodno kompiliranom odjeljku za preuzimanje . docs/
Mapa uključuje izvorni kod za našu dokumentaciju i korištenje examples/
Bootstrapa. Osim toga, svaka druga uključena datoteka pruža podršku za pakete, podatke o licenci i razvoj.
Bootstrap koristi Grunt za svoj sustav izrade, s prikladnim metodama za rad s okvirom. To je način na koji kompajliramo naš kod, izvodimo testove i još mnogo toga.
Da biste instalirali Grunt, prvo morate preuzeti i instalirati node.js (koji uključuje npm). npm je kratica za node packaged modules i način je upravljanja razvojnim ovisnostima putem node.js.
Zatim iz naredbenog retka:grunt-cli
globalno s npm install -g grunt-cli
./bootstrap/
direktorija, zatim pokrenite npm install
. npm će pogledati package.json
datoteku i automatski instalirati tamo navedene potrebne lokalne ovisnosti.Kada završite, moći ćete pokrenuti razne Grunt naredbe iz naredbenog retka.
grunt dist
(Samo prevedite CSS i JavaScript)Regenerira /dist/
direktorij s kompajliranim i umanjenim CSS i JavaScript datotekama. Kao korisnik Bootstrapa, ovo je obično naredba koju želite.
grunt watch
(Gledati)Promatra izvorne datoteke Less i automatski ih ponovno kompajlira u CSS kad god spremite promjenu.
grunt test
(Pokreni testove)Pokreće JSHint i bezglavo pokreće QUnit testove u PhantomJS- u .
grunt docs
(Izradite i testirajte sredstva dokumenata)Gradi i testira CSS, JavaScript i druga sredstva koja se koriste prilikom pokretanja dokumentacije lokalno putem bundle exec jekyll serve
.
grunt
(Izgradite apsolutno sve i pokrenite testove)Sastavlja i minimizira CSS i JavaScript, izrađuje web stranicu s dokumentacijom, pokreće HTML5 validator prema dokumentima, regenerira sredstva Customizer-a i još mnogo toga. Zahtijeva Jekylla . Obično je potrebno samo ako hakirate sam Bootstrap.
Ako naiđete na probleme s instaliranjem ovisnosti ili izvođenjem Grunt naredbi, prvo izbrišite /node_modules/
direktorij koji je generirao npm. Zatim ponovite npm install
.
Započnite s ovim osnovnim HTML predloškom ili izmijenite ove primjere . Nadamo se da ćete naše predloške i primjere prilagoditi svojim potrebama.
Kopirajte HTML u nastavku da biste započeli rad s minimalnim Bootstrap dokumentom.
Izgradite na osnovnom predlošku iznad s mnogim komponentama Bootstrapa. Potičemo vas da prilagodite i prilagodite Bootstrap kako bi odgovarao potrebama vašeg individualnog projekta.
Preuzmite izvorni kod za svaki primjer u nastavku preuzimanjem repozitorija Bootstrap . Primjeri se mogu naći u docs/examples/
imeniku.
Super osnovni predložak koji uključuje navigacijsku traku zajedno s dodatnim sadržajem.
Osnovna struktura za nadzornu ploču administratora s fiksnom bočnom i navigacijskom trakom.
Stvorite prilagođenu navigacijsku traku s poravnatim vezama. Glavu gore! Nije baš prilagođen Safariju.
Bootlint je službenialat Bootstrap HTML linter . Automatski provjerava nekoliko uobičajenih HTML pogrešaka na web stranicama koje koriste Bootstrap na prilično "vanilla" način. Komponente/widgeti Vanilla Bootstrapa zahtijevaju da se njihovi dijelovi DOM-a prilagode određenim strukturama. Bootlint provjerava imaju li instance komponenti Bootstrapa ispravno strukturiran HTML. Razmislite o dodavanju Bootlinta u svoj lanac alata za web razvoj Bootstrap kako nijedna uobičajena pogreška ne bi usporila razvoj vašeg projekta.
Budite u tijeku s razvojem Bootstrapa i obratite se zajednici pomoću ovih korisnih resursa.
irc.freenode.net
poslužitelju, na ##bootstrap kanalu .twitter-bootstrap-3
.bootstrap
na paketima koji mijenjaju ili dodaju funkcionalnost Bootstrapa kada distribuiraju putem npm- a ili sličnih mehanizama isporuke za maksimalnu vidljivost.Također možete pratiti @getbootstrap na Twitteru za najnovije tračeve i sjajne glazbene videe.
Bootstrap automatski prilagođava vaše stranice različitim veličinama zaslona. Evo kako onemogućiti ovu značajku tako da vaša stranica radi kao u ovom primjeru koji ne reagira .
<meta>
se spominje u CSS dokumentimawidth
na .container
za svaku razinu rešetke s jednom širinom, na primjer width: 970px !important;
Provjerite dolazi li ovo nakon zadanog Bootstrap CSS-a. Po želji možete izbjeći !important
s medijskim upitima ili nekim selektorom..col-xs-*
klase uz srednje/velike ili umjesto njih. Ne brinite, izuzetno mala mreža uređaja skalira se na sve rezolucije.I dalje ćete trebati Respond.js za IE8 (budući da su naši medijski upiti još uvijek tu i treba ih obraditi). Ovo onemogućuje aspekte "mobilne stranice" Bootstrapa.
Primijenili smo ove korake na primjer. Pročitajte njegov izvorni kod da vidite implementirane specifične promjene.
Želite migrirati sa starije verzije Bootstrapa na v3.x? Provjerite naš vodič za migraciju .
Bootstrap je napravljen da najbolje radi u najnovijim preglednicima za stolna i mobilna računala, što znači da bi stariji preglednici mogli prikazati drugačije stilizirane, iako potpuno funkcionalne, prikaze određenih komponenti.
Točnije, podržavamo najnovije verzije sljedećih preglednika i platformi.
Alternativni preglednici koji koriste najnoviju verziju WebKita, Blinka ili Gecka, bilo izravno ili putem API-ja za web pregled platforme, nisu izričito podržani. Međutim, Bootstrap bi se (u većini slučajeva) trebao ispravno prikazivati i funkcionirati iu ovim preglednicima. Konkretnije informacije o podršci navedene su u nastavku.
Općenito govoreći, Bootstrap podržava najnovije verzije zadanih preglednika svake glavne platforme. Imajte na umu da proxy preglednici (kao što su Opera Mini, Turbo način rada Opera Mobile, UC Browser Mini, Amazon Silk) nisu podržani.
Krom | Firefox | Safari | |
---|---|---|---|
Android | Podržano | Podržano | N/A |
iOS | Podržano | Podržano | Podržano |
Slično tome, podržane su najnovije verzije većine preglednika stolnih računala.
Krom | Firefox | Internet Explorer | Opera | Safari | |
---|---|---|---|---|---|
Mac | Podržano | Podržano | N/A | Podržano | Podržano |
Windows | Podržano | Podržano | Podržano | Podržano | Nije podržano |
U sustavu Windows podržavamo Internet Explorer 8-11 .
Za Firefox, uz najnovije normalno stabilno izdanje, također podržavamo najnoviju verziju Firefoxa s proširenom podrškom (ESR) .
Neslužbeno, Bootstrap bi trebao izgledati i ponašati se dovoljno dobro u Chromiumu i Chromeu za Linux, Firefoxu za Linux i Internet Exploreru 7, kao i Microsoft Edgeu, iako nisu službeno podržani.
Za popis nekih grešaka u pregledniku s kojima se Bootstrap mora uhvatiti u koštac, pogledajte naš Zid grešaka u pregledniku .
Internet Explorer 8 i 9 također su podržani, međutim, imajte na umu da ovi preglednici ne podržavaju u potpunosti neka svojstva CSS3 i HTML5 elemente. Osim toga, Internet Explorer 8 zahtijeva korištenje Respond.js za omogućavanje podrške za medijske upite.
Značajka | Internet Explorer 8 | Internet Explorer 9 |
---|---|---|
border-radius |
Nije podržano | Podržano |
box-shadow |
Nije podržano | Podržano |
transform |
Nije podržano | Podržano, s -ms prefiksom |
transition |
Nije podržano | |
placeholder |
Nije podržano |
Posjetite Mogu li koristiti... za detalje o podršci preglednika za značajke CSS3 i HTML5.
Pripazite na sljedeća upozorenja kada koristite Respond.js u svojim razvojnim i proizvodnim okruženjima za Internet Explorer 8.
Korištenje Respond.js s CSS-om hostiranim na drugoj (pod)domeni (na primjer, na CDN-u) zahtijeva dodatna podešavanja. Pojedinosti potražite u dokumentima Respond.js .
file://
Zbog sigurnosnih pravila preglednika, Respond.js ne radi sa stranicama koje se gledaju putem file://
protokola (kao kod otvaranja lokalne HTML datoteke). Za testiranje responzivnih značajki u IE8 pregledajte svoje stranice putem HTTP(S-a). Pojedinosti potražite u dokumentima Respond.js .
@import
Respond.js ne radi s CSS-om koji je referenciran putem @import
. Konkretno, poznato je da neke Drupal konfiguracije koriste @import
. Pojedinosti potražite u dokumentima Respond.js .
IE8 ne podržava u potpunosti box-sizing: border-box;
u kombinaciji s min-width
, max-width
, min-height
ili max-height
. Iz tog razloga, od v3.0.1, više ne koristimo max-width
na .container
s.
IE8 ima nekih problema @font-face
kada se kombinira s :before
. Bootstrap koristi tu kombinaciju sa svojim Glyphiconsima. Ako je stranica spremljena u predmemoriju i učitana bez prelaska miša preko prozora (tj. pritisnite gumb za osvježavanje ili učitajte nešto u iframe), tada se stranica renderira prije učitavanja fonta. Postavljanje pokazivača miša iznad stranice (tijela) prikazat će neke od ikona, a zadržavanje pokazivača iznad preostalih ikona također će ih prikazati. Vidi problem #13863 za detalje.
Bootstrap nije podržan u starim načinima kompatibilnosti Internet Explorera. Kako biste bili sigurni da koristite najnoviji način prikazivanja za IE, razmislite o uključivanju odgovarajuće <meta>
oznake na svoje stranice:
Potvrdite način dokumenta otvaranjem alata za otklanjanje pogrešaka: pritisnite F12i označite "Način dokumenta".
Ova je oznaka uključena u svu Bootstrapovu dokumentaciju i primjere kako bi se osiguralo najbolje moguće prikazivanje u svakoj podržanoj verziji Internet Explorera.
Pogledajte ovo StackOverflow pitanje za više informacija.
Internet Explorer 10 ne razlikuje širinu uređaja od širine okvira za prikaz i stoga ne primjenjuje ispravno medijske upite u Bootstrapovom CSS-u. Obično biste samo dodali brzi isječak CSS-a da to popravite:
Međutim, to ne radi za uređaje koji pokreću verzije Windows Phone 8 starije od Ažuriranja 3 (aka GDR3) , jer uzrokuje da takvi uređaji prikazuju uglavnom prikaz radne površine umjesto uskog "telefonskog" prikaza. Da biste to riješili, morat ćete uključiti sljedeći CSS i JavaScript kako biste zaobišli pogrešku .
Za više informacija i smjernice za korištenje pročitajte Windows Phone 8 i Device-Width .
Kao napomenu, ovo uključujemo u svu Bootstrapovu dokumentaciju i primjere kao demonstraciju.
Motor za renderiranje verzija Safarija prije v7.1 za OS X i Safarija za iOS v8.0 imao je problema s brojem decimalnih mjesta korištenih u našim .col-*-1
klasama mreže. Dakle, ako imate 12 pojedinačnih stupaca rešetke, primijetili biste da su bili manji u usporedbi s drugim redovima stupaca. Osim nadogradnje Safarija/iOS-a, imate nekoliko opcija za zaobilazna rješenja:
.pull-right
svom zadnjem stupcu rešetke da biste dobili oštro desno poravnanjePodrška za overflow: hidden
on <body>
element prilično je ograničena u iOS-u i Androidu. U tu svrhu, kada se pomaknete preko vrha ili dna modala u bilo kojem od preglednika tih uređaja, <body>
sadržaj će se početi pomicati. Pogledajte Chrome bug #175502 (ispravljen u Chrome v40) i WebKit bug #153852 .
Od iOS-a 9.3, dok je modal otvoren, ako je početni dodir geste pomicanja unutar granice teksta <input>
ili <textarea>
, <body>
sadržaj ispod modala će se pomicati umjesto samog modala. Pogledajte WebKit bug #153856 .
Također imajte na umu da ako koristite fiksnu navigacijsku traku ili unose unutar modala, iOS ima grešku u renderiranju koja ne ažurira položaj fiksnih elemenata kada se aktivira virtualna tipkovnica. Nekoliko rješenja za to uključuje pretvaranje vaših elemenata u position: absolute
ili pozivanje mjerača vremena u fokusu kako biste pokušali ručno ispraviti pozicioniranje. Time se ne bavi Bootstrap, pa je na vama da odlučite koje je rješenje najbolje za vašu aplikaciju.
Element .dropdown-backdrop
se ne koristi na iOS-u u navigaciji zbog složenosti z-indeksiranja. Stoga, da biste zatvorili padajuće izbornike u navigacijskim trakama, morate izravno kliknuti element padajućeg izbornika (ili bilo koji drugi element koji će aktivirati događaj klika u iOS -u ).
Zumiranje stranice neizbježno predstavlja artefakte renderiranja u nekim komponentama, kako u Bootstrapu tako i na ostatku weba. Ovisno o problemu, možda ćemo ga moći riješiti (prvo pretražite, a zatim otvorite problem ako je potrebno). Međutim, skloni smo ih ignorirati jer često nemaju izravno rješenje osim hakiranih rješenja.
:hover
/ :focus
na mobiteluIako stvarno lebdenje nije moguće na većini zaslona osjetljivih na dodir, većina mobilnih preglednika emulira podršku za lebdenje i čini ga :hover
"ljepljivim". Drugim riječima, :hover
stilovi se počinju primjenjivati nakon dodirivanja elementa i prestaju se primjenjivati tek nakon što korisnik dodirne neki drugi element. To može uzrokovati nepoželjno "zaglavljivanje" stanja Bootstrapa :hover
na takvim preglednicima. Neki mobilni preglednici također čine :focus
slično ljepljivim. Trenutačno ne postoji jednostavno rješenje za te probleme osim potpunog uklanjanja takvih stilova.
Čak iu nekim modernim preglednicima ispis može biti neobičan.
Konkretno, od Chrome v32 i bez obzira na postavke margina, Chrome koristi širinu okvira za prikaz znatno užu od fizičke veličine papira prilikom rješavanja medijskih upita tijekom ispisa web stranice. To može rezultirati neočekivanom aktivacijom Bootstrapove ekstra male rešetke prilikom ispisa. Pogledajte problem #12078 i Chrome bug #273306 za neke pojedinosti. Predložena rješenja:
@screen-*
varijabli Less tako da se vaš papir za pisač smatra većim od ekstra malog.Također, od Safarija v8.0, .container
s fiksne širine može uzrokovati da Safari koristi neuobičajeno malu veličinu slova prilikom ispisa. Pogledajte #14868 i WebKit bug #138192 za više detalja. Jedno potencijalno rješenje za to je dodavanje sljedećeg CSS-a:
Izvan kutije, Android 4.1 (a čak i neka novija izdanja očito) isporučuju se s aplikacijom Browser kao zadanim web preglednikom po izboru (za razliku od Chromea). Nažalost, aplikacija Preglednik općenito ima puno grešaka i nedosljednosti s CSS-om.
Na <select>
elementima, Android dionički preglednik neće prikazati bočne kontrole ako postoji border-radius
i/ili border
primijenjeno. (Pogledajte ovo StackOverflow pitanje za detalje.) Upotrijebite isječak koda u nastavku da biste uklonili CSS koji vrijeđa i prikazali <select>
kao nestilizirani element u Androidovom pregledniku. Njuškanje korisničkog agenta izbjegava smetnje s preglednicima Chrome, Safari i Mozilla.
Želite li vidjeti primjer? Pogledajte ovaj demo JS Bin.
Kako bi pružio najbolje moguće iskustvo starim preglednicima s greškama, Bootstrap koristi hakove CSS preglednika na nekoliko mjesta kako bi ciljao poseban CSS na određene verzije preglednika kako bi zaobišao pogreške u samim preglednicima. Ovi hakovi razumljivo uzrokuju da se CSS validatori žale da su nevažeći. Na nekoliko mjesta također koristimo najnovije CSS značajke koje još nisu u potpunosti standardizirane, ali se koriste isključivo za progresivno poboljšanje.
Ova upozorenja za provjeru valjanosti nisu važna u praksi budući da nehakirani dio našeg CSS-a u potpunosti provjerava valjanost i hakirani dijelovi ne ometaju ispravno funkcioniranje nehakiranog dijela, stoga namjerno ignoriramo ova posebna upozorenja.
Naši HTML dokumenti također imaju neka trivijalna i beznačajna upozorenja o provjeri valjanosti HTML-a zbog našeg uključivanja rješenja za određenu pogrešku Firefoxa .
Iako službeno ne podržavamo dodatke ili dodatke trećih strana, nudimo neke korisne savjete koji će vam pomoći u izbjegavanju potencijalnih problema u vašim projektima.
Neki softveri treće strane, uključujući Google karte i Google Custom Search Engine, sukobljavaju se s Bootstrapom zbog * { box-sizing: border-box; }
, pravila prema kojem padding
ne utječe na konačnu izračunatu širinu elementa. Saznajte više o modelu okvira i dimenzioniranju na CSS Tricks .
Ovisno o kontekstu, možete nadjačati prema potrebi (Opcija 1) ili poništiti veličinu okvira za cijele regije (Opcija 2).
Bootstrap slijedi uobičajene web standarde i—uz minimalan dodatni napor—može se koristiti za stvaranje stranica koje su dostupne onima koji koriste AT .
Ako vaša navigacija sadrži mnogo veza i dolazi prije glavnog sadržaja u DOM-u, dodajte Skip to main content
vezu prije navigacije (za jednostavno objašnjenje pogledajte ovaj članak projekta A11Y o vezama za preskakanje navigacije ). Korištenje .sr-only
klase vizualno će sakriti vezu za preskakanje, a .sr-only-focusable
klasa će osigurati da veza postane vidljiva nakon fokusiranja (za korisnike tipkovnice koji vide).
Zbog dugotrajnih nedostataka/bugova u pregledniku Chrome (pogledajte problem 262171 u alatu za praćenje programskih pogrešaka Chromium ) i Internet Exploreru (pogledajte ovaj članak o vezama na stranici i redoslijedu fokusa ), morat ćete se uvjeriti da je cilj vaše veze za preskakanje može se barem programski fokusirati dodavanjem tabindex="-1"
.
Osim toga, možda ćete htjeti eksplicitno potisnuti vidljivu indikaciju fokusa na meti (osobito zato što Chrome trenutno također postavlja fokus na elemente s tabindex="-1"
kada se na njih klikne mišem) pomoću #content:focus { outline: none; }
.
Imajte na umu da će ova pogreška također utjecati na sve druge veze unutar stranice koje vaša web lokacija možda koristi, čineći ih beskorisnim za korisnike tipkovnice. Možete razmisliti o dodavanju sličnog popravka stop-gap-a za sva druga imenovana sidra/ identifikatore fragmenata koji djeluju kao ciljevi veza.
Prilikom ugniježđivanja naslova ( <h1>
- <h6>
), zaglavlje vašeg primarnog dokumenta treba biti <h1>
. Sljedeći naslovi trebali bi se koristiti logično <h2>
- <h6>
tako da čitači zaslona mogu sastaviti tablicu sadržaja za vaše stranice.
Saznajte više na HTML CodeSniffer i AccessAbility Penn Statea .
Trenutačno su neke od zadanih kombinacija boja dostupne u Bootstrapu (kao što su različite stilizirane klase gumba, neke od boja za isticanje koda koje se koriste za osnovne blokove koda , .bg-primary
kontekstualna pomoćna klasa pozadine i zadana boja veze kada se koristi na bijeloj pozadini) imaju nizak omjer kontrasta (ispod preporučenog omjera od 4,5:1 ). To može uzrokovati probleme slabovidnim korisnicima ili onima koji su slijepi za boje. Ove zadane boje možda će trebati izmijeniti kako bi se povećao njihov kontrast i čitljivost.
Bootstrap je objavljen pod licencom MIT-a i zaštićen je autorskim pravima Twittera 2016. Svedeno na manje komade, može se opisati sljedećim uvjetima.
Puna Bootstrap licenca nalazi se u repozitoriju projekta za više informacija.
Članovi zajednice preveli su Bootstrapovu dokumentaciju na razne jezike. Nijedan nije službeno podržan i možda neće uvijek biti ažuran.
Ne pomažemo organizirati niti ugošćujemo prijevode, samo se povezujemo s njima.
Jeste li završili novi ili bolji prijevod? Otvorite zahtjev za povlačenje da biste ga dodali na naš popis.