JavaScript
Կյանքի կոչեք Bootstrap-ի բաղադրիչները մեկ տասնյակից ավելի հատուկ jQuery հավելվածների միջոցով: Հեշտությամբ ներառեք դրանք բոլորը կամ մեկ առ մեկ:
Կյանքի կոչեք Bootstrap-ի բաղադրիչները մեկ տասնյակից ավելի հատուկ jQuery հավելվածների միջոցով: Հեշտությամբ ներառեք դրանք բոլորը կամ մեկ առ մեկ:
Փլագինները կարող են ներառվել առանձին (օգտագործելով Bootstrap-ի անհատական *.js
ֆայլերը), կամ միանգամից (օգտագործելով bootstrap.js
կամ փոքրացված bootstrap.min.js
):
Երկուսն էլ bootstrap.js
և bootstrap.min.js
պարունակում են բոլոր պլագինները մեկ ֆայլում: Ներառեք միայն մեկը:
Որոշ պլագիններ և CSS բաղադրիչներ կախված են այլ պլագիններից: Եթե դուք ներառում եք պլագիններ առանձին-առանձին, համոզվեք, որ ստուգեք այս կախվածությունները փաստաթղթերում: Նկատի ունեցեք նաև, որ բոլոր հավելումները կախված են jQuery-ից (սա նշանակում է, որ jQuery-ն պետք է ներառված լինի plugin ֆայլերից առաջ): Խորհրդակցեք մեզbower.json
՝ տեսնելու, թե jQuery-ի որ տարբերակներն են աջակցվում:
Դուք կարող եք օգտագործել բոլոր Bootstrap հավելվածները զուտ նշագրման API-ի միջոցով՝ առանց JavaScript-ի մեկ տող գրելու: Սա Bootstrap-ի առաջին կարգի API-ն է և պետք է լինի ձեր առաջին ուշադրությունը plugin օգտագործելիս:
Այնուամենայնիվ, որոշ իրավիճակներում կարող է ցանկալի լինել անջատել այս գործառույթը: Հետևաբար, մենք նաև հնարավորություն ենք տալիս անջատել տվյալների հատկանիշը API-ն՝ անջատելով բոլոր իրադարձությունները փաստաթղթի անվանատարածքով data-api
: Սա այսպիսի տեսք ունի.
Որպես այլընտրանք, հատուկ պլագին թիրախավորելու համար պարզապես ներառեք հավելվածի անունը որպես անվանատարածք տվյալների api անվանատարածքի հետ միասին, ինչպես հետևյալը.
Մի օգտագործեք տվյալների ատրիբուտները մի քանի պլագիններից միևնույն տարրի վրա: Օրինակ, կոճակը չի կարող և՛ գործիքի հուշում ունենալ, և՛ միացնել մոդալը: Դա անելու համար օգտագործեք փաթաթման տարր:
Մենք նաև կարծում ենք, որ դուք պետք է կարողանաք օգտագործել բոլոր Bootstrap հավելվածները զուտ JavaScript API-ի միջոցով: Բոլոր հանրային API-ները միայնակ, շղթայական մեթոդներ են և վերադարձնում են գործածված հավաքածուն:
Բոլոր մեթոդները պետք է ընդունեն կամընտիր ընտրանքների օբյեկտ, տող, որն ուղղված է որոշակի մեթոդին կամ ոչինչ (որը սկսում է լռելյայն վարքագիծ ունեցող պլագին).
Յուրաքանչյուր փլագին նաև բացահայտում է իր չմշակված կոնստրուկտորը մի Constructor
հատկության վրա՝ $.fn.popover.Constructor
. Եթե ցանկանում եք ստանալ հատուկ plugin-ի օրինակ, առբերեք այն անմիջապես տարրից՝ $('[rel="popover"]').data('popover')
.
Դուք կարող եք փոխել plugin-ի լռելյայն կարգավորումները՝ փոփոխելով plugin-ի Constructor.DEFAULTS
օբյեկտը.
Երբեմն անհրաժեշտ է լինում օգտագործել Bootstrap պլագիններ այլ UI շրջանակների հետ: Այս հանգամանքներում երբեմն կարող են տեղի ունենալ անունների տարածության բախումներ: Եթե դա տեղի ունենա, դուք կարող եք զանգահարել .noConflict
այն պլագինին, որի արժեքը ցանկանում եք վերադարձնել:
Bootstrap-ն ապահովում է հարմարեցված իրադարձություններ փլագինների մեծ մասի եզակի գործողությունների համար: Ընդհանրապես, դրանք գալիս են ինֆինիտիվ և անցյալ մասնակցային ձևով, որտեղ ինֆինիտիվը (նախ. show
) գործարկվում է իրադարձության սկզբում, իսկ նրա անցյալ մասնակցային ձևը ( նախ. shown
) գործարկվում է գործողության ավարտից հետո:
3.0.0-ի դրությամբ Bootstrap-ի բոլոր իրադարձությունները անվանատարածված են:
Բոլոր անվերջ իրադարձությունները ապահովում են preventDefault
ֆունկցիոնալություն: Սա հնարավորություն է տալիս դադարեցնել գործողությունների կատարումը նախքան այն սկսելը:
Bootstrap-ի jQuery պլագիններից յուրաքանչյուրի տարբերակը հասանելի VERSION
է plugin-ի կոնստրուկտորի սեփականության միջոցով: Օրինակ, Tooltip plugin-ի համար.
Bootstrap-ի պլագինները առանձնապես նրբագեղորեն չեն զիջում, երբ JavaScript-ն անջատված է: Եթե այս դեպքում ձեզ հետաքրքրում է օգտատերերի փորձը, օգտագործեք <noscript>
ձեր օգտատերերին իրավիճակը (և ինչպես կրկին ակտիվացնել JavaScript-ը) բացատրելու համար և/կամ ավելացրեք ձեր սեփական հետադարձ կապերը:
Bootstrap-ը պաշտոնապես չի աջակցում երրորդ կողմի JavaScript գրադարաններին , ինչպիսիք են Prototype-ը կամ jQuery UI-ը: Չնայած .noConflict
անվանատարածք ունեցող իրադարձություններին, կարող են լինել համատեղելիության խնդիրներ, որոնք դուք պետք է ինքնուրույն շտկեք:
Պարզ անցումային էֆեկտների համար ներառեք transition.js
մեկ անգամ մյուս JS ֆայլերի կողքին: Եթե դուք օգտագործում եք կազմված (կամ փոքրացված) bootstrap.js
, կարիք չկա ներառել սա. այն արդեն կա:
Transition.js-ը իրադարձությունների հիմնական օգնական է, transitionEnd
ինչպես նաև CSS անցումային էմուլյատոր: Այն օգտագործվում է այլ պլագինների կողմից՝ ստուգելու CSS անցումային աջակցությունը և կախված անցումները բռնելու համար:
Անցումները կարող են գլոբալ անջատվել՝ օգտագործելով հետևյալ JavaScript հատվածը, որը պետք է գա բեռնվելուց հետո transition.js
(կամ bootstrap.js
կամ bootstrap.min.js
, ըստ դեպքի).
Մոդալները պարզեցված են, բայց ճկուն, երկխոսության հուշումներ՝ նվազագույն պահանջվող ֆունկցիոնալությամբ և խելացի լռելյայններով:
Համոզվեք, որ մի բացեք մոդալ, քանի դեռ մյուսը դեռ տեսանելի է: Միաժամանակ մեկից ավելի մոդալ ցուցադրելու համար պահանջվում է հատուկ կոդ:
Միշտ փորձեք տեղադրել մոդալի HTML կոդը ձեր փաստաթղթում վերին մակարդակում, որպեսզի խուսափեք այլ բաղադրիչներից, որոնք կազդեն մոդալի տեսքի և/կամ ֆունկցիոնալության վրա:
Բջջային սարքերում մոդալների օգտագործման վերաբերյալ կան որոշ նախազգուշացումներ: Մանրամասների համար տես մեր դիտարկիչի աջակցության փաստաթղթերը :
Քանի որ HTML5-ը սահմանում է իր իմաստաբանությունը, autofocus
HTML հատկանիշը որևէ ազդեցություն չունի Bootstrap մոդալներում: Նույն էֆեկտին հասնելու համար օգտագործեք որոշ հատուկ JavaScript.
Վերարտադրված մոդալ՝ վերնագրի, հիմնականի և ներքևում գտնվող գործողությունների հավաքածուով:
Փոխեք մոդալը JavaScript-ի միջոցով՝ սեղմելով ստորև նշված կոճակը: Այն կսահի ներքև և կխամրի էջի վերևից:
Համոզվեք, որ ավելացրեք role="dialog"
և aria-labelledby="..."
, հղում կատարելով մոդալ վերնագրին, դեպի և .modal
ինքնին :role="document"
.modal-dialog
Բացի այդ, դուք կարող եք տալ ձեր մոդալ երկխոսության նկարագրությունը aria-describedby
on-ի հետ .modal
:
YouTube-ի տեսանյութերը մոդալներում զետեղելու համար պահանջվում է լրացուցիչ JavaScript, որը չի Bootstrap-ում՝ ավտոմատ կերպով դադարեցնելու նվագարկումը և ավելին: Լրացուցիչ տեղեկությունների համար տես Stack Overflow-ի այս օգտակար գրառումը :
Մոդալներն ունեն երկու ընտրովի չափեր, որոնք հասանելի են մոդիֆիկատորների դասերի միջոցով, որոնք տեղադրվելու են .modal-dialog
.
Մոդալների համար, որոնք պարզապես հայտնվում են, այլ ոչ թե խամրում, հեռացրեք .fade
դասը ձեր մոդալ նշումից:
Մոդալի շրջանակներում Bootstrap ցանցային համակարգի առավելություններից օգտվելու համար պարզապես տեղադրեք .row
s-ը .modal-body
և այնուհետև օգտագործեք սովորական ցանցային համակարգի դասերը:
Ունե՞ք մի փունջ կոճակներ, որոնք բոլորն էլ գործարկում են նույն մոդալը, պարզապես մի փոքր տարբեր բովանդակությամբ: Օգտագործեք event.relatedTarget
և HTML data-*
ատրիբուտներ (հնարավոր է jQuery-ի միջոցով )՝ մոդալի բովանդակությունը փոխելու համար՝ կախված նրանից, թե որ կոճակն է սեղմված: Մանրամասների համար տե՛ս Modal Events փաստաթղթերը relatedTarget
,
Մոդալ հավելվածը փոխում է ձեր թաքնված բովանդակությունը ըստ պահանջի՝ տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Այն նաև ավելացնում .modal-open
է <body>
լռելյայն ոլորման վարքագիծը վերացնելու համար և առաջացնում է .modal-backdrop
սեղմման տարածք՝ մոդալից դուրս սեղմելիս ցուցադրված մոդալները հեռացնելու համար:
Ակտիվացրեք մոդալ առանց JavaScript գրելու: Սահմանել data-toggle="modal"
կարգավորիչի տարրը, ինչպես կոճակը, a-ի հետ մեկտեղ data-target="#foo"
կամ href="#foo"
թիրախավորել որոշակի մոդալ՝ փոխարկելու համար:
Զանգահարեք մոդալ id- myModal
ով JavaScript-ի մեկ տողով.
Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-
, ինչպես data-backdrop=""
.
Անուն | տիպ | լռելյայն | նկարագրությունը |
---|---|---|---|
ֆոն | բուլյան կամ լարային'static' |
ճիշտ | Ներառում է մոդալ-ֆոնային տարր: Որպես այլընտրանք, նշեք static ֆոն, որը չի փակում մոդալը սեղմելով: |
ստեղնաշար | բուլյան | ճիշտ | Փակում է մոդալը, երբ սեղմված է escape ստեղնը |
ցուցադրում | բուլյան | ճիշտ | Ցույց է տալիս մոդալը, երբ սկզբնավորվում է: |
հեռավոր | ուղին | կեղծ | Այս տարբերակը հնացած է v3.3.0-ից և հեռացվել է v4-ում: Փոխարենը խորհուրդ ենք տալիս օգտագործել հաճախորդի կողմի ձևանմուշը կամ տվյալների պարտադիր շրջանակը կամ ինքներդ զանգահարել jQuery.load : Եթե տրամադրվի հեռավոր URL, բովանդակությունը մեկ անգամ կբեռնվի jQuery-ի |
.modal(options)
Ակտիվացնում է ձեր բովանդակությունը որպես մոդալ: Ընդունում է ընտրովի տարբերակներ object
:
.modal('toggle')
Ձեռքով փոխում է մոդալը: Վերադառնում է զանգահարողին մինչև մոդալն իրականում ցուցադրվել կամ թաքցվել է (այսինքն՝ նախքան իրադարձությունը shown.bs.modal
կամ hidden.bs.modal
իրադարձությունը տեղի ունենալը):
.modal('show')
Ձեռքով բացում է մոդալ: Վերադառնում է զանգահարողին մինչև մոդալը փաստացի ցուցադրվելը (այսինքն՝ նախքան shown.bs.modal
իրադարձությունը տեղի ունենալը):
.modal('hide')
Ձեռքով թաքցնում է մոդալը: Վերադառնում է զանգահարողին նախքան մոդալն իրականում թաքցվել է (այսինքն՝ նախքան hidden.bs.modal
իրադարձությունը տեղի ունենալը):
.modal('handleUpdate')
Նորից կարգավորում է մոդալի դիրքը, որպեսզի հակադարձի ոլորման տողը, եթե այն հայտնվի, ինչը կստիպի մոդալը ցատկել դեպի ձախ:
Անհրաժեշտ է միայն այն դեպքում, երբ մոդալի բարձրությունը փոխվում է, երբ այն բաց է:
Bootstrap-ի մոդալ դասը բացահայտում է մի քանի իրադարձություն՝ մոդալ ֆունկցիոնալությանը միանալու համար:
Բոլոր մոդալ իրադարձությունները կրակվում են հենց մոդալի վրա (այսինքն ՝ <div class="modal">
).
Միջոցառման տեսակը | Նկարագրություն |
---|---|
շոու.բս.մոդալ | Այս իրադարձությունը գործարկվում է անմիջապես, երբ show կանչվում է օրինակի մեթոդը: Եթե կտտոցով է պայմանավորված, սեղմված տարրը հասանելի է որպես relatedTarget իրադարձության հատկություն: |
ցուցադրված.բս.մոդալ | Այս իրադարձությունը գործարկվում է, երբ մոդալը տեսանելի է դառնում օգտատիրոջը (կսպասի CSS անցումների ավարտին): Եթե կտտոցով է պայմանավորված, սեղմված տարրը հասանելի է որպես relatedTarget իրադարձության հատկություն: |
hide.bs.modal | Այս իրադարձությունը գործարկվում է անմիջապես, երբ hide կանչվում է օրինակի մեթոդը: |
թաքնված.բս.մոդալ | Այս իրադարձությունը գործարկվում է, երբ մոդալն ավարտում է օգտագործողից թաքցված լինելը (կսպասի CSS անցումների ավարտին): |
loaded.bs.modal | Այս իրադարձությունը գործարկվում է, երբ մոդալը բեռնում է բովանդակությունը՝ օգտագործելով remote ընտրանքը: |
Ավելացրեք բացվող ընտրացանկերը գրեթե ցանկացած բանի այս պարզ հավելվածի միջոցով, ներառյալ նավարկղը, ներդիրները և հաբերը:
Տվյալների ատրիբուտների կամ JavaScript-ի միջոցով բացվող հավելվածը փոխում է թաքնված բովանդակությունը (բացվող ընտրացանկերը)՝ փոխելով .open
դասը մայր ցանկի տարրի վրա:
Բջջային սարքերում բացվող ցանկը բացելով ավելացնում է .dropdown-backdrop
որպես հպման տարածք՝ մենյուից դուրս սեղմելիս բացվող ընտրացանկերը փակելու համար, ինչը iOS-ի պատշաճ աջակցության պահանջ է: Սա նշանակում է, որ բաց բացվող ընտրացանկից այլ բացվող ընտրացանկից անցնելը պահանջում է լրացուցիչ հպում բջջայինի վրա:
Նշում. data-toggle="dropdown"
հատկանիշը հիմնվում է հավելվածի մակարդակով բացվող ընտրացանկերը փակելու համար, ուստի լավ գաղափար է միշտ օգտագործել այն:
Ավելացրեք data-toggle="dropdown"
հղմանը կամ կոճակին՝ բացվող ցանկը փոխարկելու համար:
Հղման կոճակներով URL-ները անձեռնմխելի պահելու համար օգտագործեք data-target
հատկանիշը .-ի փոխարեն href="#"
:
Զանգահարեք բացվող ցանկերը JavaScript-ի միջոցով.
data-toggle="dropdown"
դեռ պահանջվում էԱնկախ նրանից՝ դուք կանչում եք ձեր բացվող ցանկը JavaScript-ի միջոցով, թե փոխարենը օգտագործում եք տվյալների api-ն, data-toggle="dropdown"
միշտ պահանջվում է ներկա լինել բացվող ցանկի գործարկման տարրում:
Ոչ ոք
$().dropdown('toggle')
Անջատում է տվյալ նավագոտու կամ ներդիրներով նավիգացիայի բացվող ընտրացանկը:
Բոլոր իջնող իրադարձությունները գործարկվում են .dropdown-menu
ծնողական տարրի վրա:
Բոլոր բացվող իրադարձություններն ունեն relatedTarget
հատկություն, որի արժեքը փոխարկվող խարիսխի տարրն է:
Միջոցառման տեսակը | Նկարագրություն |
---|---|
show.bs.dropdown | Այս իրադարձությունն անմիջապես գործարկվում է, երբ կանչվում է ցուցադրման օրինակի մեթոդը: |
ցուցադրված.bs.բացվող պատուհան | Այս իրադարձությունը գործարկվում է, երբ բացվող ցանկը տեսանելի է դառնում օգտատիրոջը (կսպասի CSS անցումների ավարտին): |
hide.bs.dropdown | Այս իրադարձությունը գործարկվում է անմիջապես, երբ կանչվում է թաքցնել օրինակի մեթոդը: |
hidden.bs.dropdown | Այս իրադարձությունը գործարկվում է, երբ բացվող ցանկն ավարտվում է օգտագործողից թաքցնելու համար (կսպասի CSS անցումների ավարտին): |
ScrollSpy հավելվածը նախատեսված է նավի թիրախների ավտոմատ թարմացման համար՝ հիմնվելով ոլորման դիրքի վրա: Ոլորեք նավագոտի տակ գտնվող տարածքը և դիտեք ակտիվ դասի փոփոխությունը: Բացվող ենթակետերը նույնպես ընդգծված կլինեն:
Գովազդային սռնապաններ keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi նախքան նրանք վաճառվել են qui. Tumblr ֆերմա-սեղան հեծանիվների իրավունքներն ինչ էլ որ լինեն: Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby սվիտեր Lomo Jean Shorts, Wiliamsburg Hoodie Minim qui, որոնց մասին դուք հավանաբար չեք լսել և բրդե հյուսված բրդե հյուսված ֆոնդ culpa biodiesel Wes Anderson էսթետիկ: Nihil դաջված accusamus, cred հեգնանք biodiesel keffiyeh artisan ullamco consequat.
Veniam marfa բեղավոր սքեյթբորդ, դիպչող ֆուգիաթ թավշյա մորուք: Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat չորս loko nisi, ea helvetica nulla carles. Դաջված Cosby սվիտեր սննդի բեռնատար, mcsweeney's quis non freegan վինիլ: Lo-fi wes anderson +1 sartorial. Կառլեսը ոչ էսթետիկ վարժություն quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap craft գարեջուր deserunt skateboard ea. Lomo հեծանիվների իրավունքները adipisicing banh mi, velit ea sunt հաջորդ մակարդակի locavore մեկ ծագման սուրճ է magna veniam. Բարձր կյանքի id վինիլային, էխո պարկի հետևանքով quis aliquip banh mi pitchfork: Vero VHS-ը դիպչող է: Կառուցեք DIY նվազագույն մեսենջերի պայուսակ: Cred ex in, կայուն ելեկտրական կոնսեկտոր Fanny փաթեթ iPhone.
In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
Keytar twee բլոգ, culpa մեսենջեր պայուսակ marfa, ինչ էլ որ լինի դելեկտուս սննդի մեքենա: Sapiente synth id assumenda. Locavore sed helvetica կլիշե հեգնանք, ամպրոպային կատուներ, որոնց մասին դուք հավանաբար չեք լսել, հետևում են hoodie առանց սնձան lo-fi fap aliquip-ի: Labore elit placeat նախքան նրանք վաճառվել են, Terry richardson proident brunch nesciunt quis cosby սվիտեր pariatur keffiyeh ut helvetica artisan. Cardigan craft գարեջուր seitan պատրաստի թել. VHS chambray laboris tempor veniam. Anim mollit minim commodo ulamco thundercats.
Navbar-ի հղումները պետք է ունենան լուծելի ID թիրախներ: Օրինակ, a-ն <a href="#home">home</a>
պետք է համապատասխանի DOM-ում ինչ-որ բանի, ինչպիսին է <div id="home"></div>
.
:visible
նպատակային տարրերը անտեսվել ենԹիրախային տարրերը, որոնք չեն :visible
համապատասխանում jQuery-ին , անտեսվելու են, և դրանց համապատասխան նավային տարրերը երբեք չեն ընդգծվի:
Անկախ իրականացման եղանակից, scrollspy-ը պահանջում է օգտագործել position: relative;
այն տարրի վրա, որը դուք լրտեսում եք: Շատ դեպքերում սա է <body>
. Երբ պտտվում եք այլ տարրերի վրա, քան <body>
, համոզվեք, որ ունեք height
հավաքածու և կիրառեք overflow-y: scroll;
:
Ձեր վերին տողում նավիգացիայի մեջ հեշտությամբ ավելացնելու սկոլսպի վարքագիծը, ավելացրեք data-spy="scroll"
այն տարրին, որը ցանկանում եք լրտեսել (առավել սովորաբար սա կլինի <body>
): Այնուհետև ավելացրեք հատկանիշը Bootstrap-ի որևէ բաղադրիչի data-target
ծնող տարրի ID-ով կամ դասով :.nav
Ձեր CSS-ն ավելացնելուց հետո position: relative;
զանգահարեք scrollspy-ը JavaScript-ի միջոցով.
.scrollspy('refresh')
Երբ օգտագործում եք scrollspy-ը DOM-ից տարրեր ավելացնելու կամ հեռացնելու հետ մեկտեղ, դուք պետք է զանգահարեք թարմացման մեթոդը այսպես.
Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-
, ինչպես data-offset=""
.
Անուն | տիպ | լռելյայն | նկարագրությունը |
---|---|---|---|
օֆսեթ | թիվ | 10 | Փիքսելներ, որոնք պետք է շրջվեն վերևից՝ ոլորման դիրքը հաշվարկելիս: |
Միջոցառման տեսակը | Նկարագրություն |
---|---|
activate.bs.scrollspy | Այս իրադարձությունը գործարկվում է, երբ նոր տարր ակտիվանում է scrollspy-ի կողմից: |
Ավելացրեք արագ, դինամիկ ներդիրների ֆունկցիոնալությունը տեղական բովանդակության վահանակների միջով անցնելու համար, նույնիսկ բացվող ընտրացանկերի միջոցով: Ներդիր ներդիրները չեն աջակցվում:
Հում ջինսե, դուք, հավանաբար, չեք լսել դրանց մասին Jean Shorts Austin: Nesciunt tofu stumptown aliqua, ռետրո սինթետիկ վարպետ մաքրում: Բեղերի կլիշե ժամանակավոր, Wiliamsburg carles vegan helvetica. Reprehenderit մսագործ ռետրո keffiyeh Dreamcatcher synth. Cosby սվիտեր eu banh mi, qui irure terry richardson նախկին կաղամար. Այն կարող է օգտագործվել iPhone-ի համար: Seitan aliquip quis cardigan ամերիկյան հագուստ, մսագործ voluptate nisi qui.
Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
Այս փլագինը ընդլայնում է ներդիրներով նավիգացիոն բաղադրիչը ՝ ներդիրներով տարածքներ ավելացնելու համար:
Միացնել ներդիրների ներդիրները JavaScript-ի միջոցով (յուրաքանչյուր ներդիր պետք է առանձին ակտիվացվի).
Դուք կարող եք ակտիվացնել առանձին ներդիրները մի քանի եղանակով.
Դուք կարող եք ակտիվացնել ներդիրի կամ հաբերի նավարկությունը՝ առանց որևէ JavaScript գրելու՝ պարզապես նշելով data-toggle="tab"
կամ data-toggle="pill"
որևէ տարրի վրա: Եթե ավելացնելով nav
և nav-tabs
դասերը ներդիրին ul
, կկիրառվի Bootstrap ներդիրի ոճավորումը , մինչդեռ nav
և nav-pills
դասերի ավելացումը կկիրառի հաբերի ոճավորում :
Ներդիրները խամրելու համար ավելացրեք .fade
յուրաքանչյուրին .tab-pane
: Առաջին ներդիրի վահանակը նույնպես պետք .in
է տեսանելի դարձնի սկզբնական բովանդակությունը:
$().tab
Ակտիվացնում է ներդիրի տարրը և բովանդակության կոնտեյները: Ներդիրը պետք է ունենա DOM-ում կամ a data-target
կամ href
թիրախավորող կոնտեյներային հանգույց: Վերոնշյալ օրինակներում ներդիրները ատրիբուտներով <a>
s են :data-toggle="tab"
.tab('show')
Ընտրում է տվյալ ներդիրը և ցուցադրում դրա հետ կապված բովանդակությունը: Նախկինում ընտրված ցանկացած այլ ներդիր դառնում է չընտրված, և դրա հետ կապված բովանդակությունը թաքցվում է: Վերադառնում է զանգահարողին՝ նախքան ներդիրի վահանակի ցուցադրումը (այսինքն՝ նախքան shown.bs.tab
իրադարձությունը տեղի ունենալը):
Նոր ներդիր ցուցադրելիս իրադարձությունները բացվում են հետևյալ հաջորդականությամբ.
hide.bs.tab
(ներկայիս ակտիվ ներդիրում)show.bs.tab
(ցուցադրվող ներդիրում)hidden.bs.tab
(նախորդ ակտիվ ներդիրում, նույնը, ինչ hide.bs.tab
միջոցառման համար)shown.bs.tab
(նոր ակտիվ ցուցադրված ներդիրում, նույնը, ինչ show.bs.tab
միջոցառման համար)Եթե ոչ մի ներդիր արդեն ակտիվ չի եղել, ապա hide.bs.tab
և hidden.bs.tab
իրադարձությունները չեն գործարկվի:
Միջոցառման տեսակը | Նկարագրություն |
---|---|
show.bs.tab | Այս իրադարձությունը բացվում է ներդիրների ցուցադրման վրա, բայց մինչ նոր ներդիրը կցուցադրվի: Օգտագործեք event.target և event.relatedTarget թիրախավորեք համապատասխանաբար ակտիվ ներդիրը և նախորդ ակտիվ ներդիրը (եթե առկա է): |
ցուցադրված.bs.ներդիր | Այս իրադարձությունը բացվում է ներդիրների ցուցադրումից հետո ներդիրի ցուցադրումից հետո: Օգտագործեք event.target և event.relatedTarget թիրախավորեք համապատասխանաբար ակտիվ ներդիրը և նախորդ ակտիվ ներդիրը (եթե առկա է): |
hide.bs.tab | Այս իրադարձությունը բացվում է, երբ պետք է ցուցադրվի նոր ներդիր (և այդպիսով, նախորդ ակտիվ ներդիրը պետք է թաքցվի): Օգտագործեք event.target և event.relatedTarget թիրախավորեք համապատասխանաբար ընթացիկ ակտիվ ներդիրը և նոր շուտով ակտիվանալու ներդիրը: |
hidden.bs.tab | Այս իրադարձությունը բացվում է նոր ներդիրի ցուցադրումից հետո (և այդպիսով նախորդ ակտիվ ներդիրը թաքցվում է): Օգտագործեք event.target և event.relatedTarget թիրախավորեք նախորդ ակտիվ ներդիրը և նոր ակտիվ ներդիրը, համապատասխանաբար: |
Ոգեշնչված է հիանալի jQuery.tipsy հավելվածով, որը գրվել է Ջեյսոն Ֆրեյմի կողմից; Tooltips-ը թարմացված տարբերակ է, որը չի հիմնվում պատկերների վրա, օգտագործում է CSS3 անիմացիաների համար, իսկ տվյալների ատրիբուտները տեղական վերնագրերի պահպանման համար:
Գործիքների հուշումները զրոյական երկարությամբ վերնագրերով երբեք չեն ցուցադրվում:
Գործիքների հուշումները տեսնելու համար սավառնեք ստորև նշված հղումների վրա.
Նիհար տաբատ հաջորդ մակարդակի keffiyeh դուք հավանաբար չեք լսել նրանց մասին: Ֆոտո խցիկ մորուք հում ջինսե տառատեսակ Vegan Messenger պայուսակ stumptown. Ֆերմայից սեղան սեյթան, Mcsweeney's fixie-ի կայուն քինոա 8-բիթանոց ամերիկյան հագուստն ունի Թերի Ռիչարդսոնի վինիլային շամպրե: Մորուքի ստամպթաուն, կարդիգաններ բանհ մի լոմո ամպրոպ. Tofu բիոդիզել Ուիլյամսբուրգ Մարֆա, չորս Loko Mcsweeney's cleanse vegan chambray. Իսկապես հեգնական արհեստավոր , ինչ էլ որ լինի keytar-ը, սկեսնթեր ֆերմայից-սեղան Banksy Austin twitter handle freegan cred raw denim single-origin սուրճ վիրուսային:
Հասանելի է չորս տարբերակ՝ վերև, աջ, ներքև և ձախ հավասարեցված:
Արդյունավետության նկատառումներից ելնելով, Tooltip-ը և Popover data-apis-ը միացված են, ինչը նշանակում է, որ դուք պետք է նախաստորագրեք դրանք ինքներդ :
Էջի բոլոր գործիքների հուշումները սկզբնավորելու եղանակներից մեկը կլինի դրանք ընտրելն իրենց data-toggle
հատկանիշով.
Tooltip plugin-ը ստեղծում է բովանդակություն և նշում ըստ պահանջի, և լռելյայն տեղադրում է գործիքի հուշումները դրանց գործարկիչի տարրից հետո:
Գործարկեք գործիքի հուշումը JavaScript-ի միջոցով.
Գործիքների հուշման համար անհրաժեշտ նշումը միայն data
հատկանիշ title
է, և HTML տարրի վրա դուք ցանկանում եք ունենալ գործիքի հուշում: Գործիքների հուշման ստեղծվող նշումը բավականին պարզ է, թեև այն պահանջում է դիրք (լռելյայն սահմանվել է top
հավելվածի կողմից):
Երբեմն դուք ցանկանում եք գործիքի հուշում ավելացնել հիպերհղմանը, որը փաթաթում է բազմաթիվ տողեր: Tooltip plugin-ի լռելյայն վարքագիծն այն է կենտրոնացնել այն հորիզոնական և ուղղահայաց: Ավելացրեք white-space: nowrap;
ձեր խարիսխներին՝ դրանից խուսափելու համար:
Գործիքների հուշումներ a-ի .btn-group
կամ an- .input-group
ի կամ աղյուսակի հետ կապված տարրերի վրա ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), օգտագործելիս դուք պետք է նշեք տարբերակը container: 'body'
(ստորև փաստաթղթավորված)՝ անցանկալի կողմնակի ազդեցություններից խուսափելու համար (օրինակ՝ տարրի լայնացումը և/ կամ կորցնելով իր կլորացված անկյունները, երբ գործարկվում է գործիքի հուշումը):
Ստեղնաշարով նավարկող օգտատերերի և, մասնավորապես, օժանդակ տեխնոլոգիաների օգտագործողների համար, դուք պետք է միայն գործիքի հուշումներ ավելացնեք ստեղնաշարի վրա կենտրոնացված տարրերին, ինչպիսիք են հղումները, ձևի կառավարումը կամ tabindex="0"
հատկանիշ ունեցող ցանկացած կամայական տարր:
a-ին disabled
կամ .disabled
տարրին գործիքի հուշում ավելացնելու համար տարրը դրեք a-ի ներսում և դրա փոխարեն <div>
կիրառեք գործիքի հուշումը :<div>
Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-
, ինչպես data-animation=""
.
Անուն | Տիպ | Կանխադրված | Նկարագրություն |
---|---|---|---|
անիմացիա | բուլյան | ճիշտ | Կիրառեք CSS fade անցում դեպի գործիքի հուշում |
կոնտեյներ | լարային | կեղծ | կեղծ | Կցում է գործիքի հուշումը կոնկրետ տարրին: Օրինակ՝ |
ուշացում | համարը | օբյեկտ | 0 | Գործիքների հուշումը (ms) ցուցադրելու և թաքցնելու ուշացում - չի կիրառվում ձեռքով ձգանման տեսակի համար Եթե համարը տրվում է, ապա ուշացումը կիրառվում է ինչպես թաքցնել/ցուցադրել Օբյեկտի կառուցվածքը հետևյալն է. |
html | բուլյան | կեղծ | Տեղադրեք HTML գործիքի հուշում: Եթե կեղծ է, jQuery-ի text մեթոդը կօգտագործվի DOM-ում բովանդակություն մտցնելու համար: Օգտագործեք տեքստ, եթե ձեզ անհանգստացնում են XSS հարձակումները: |
տեղաբաշխում | լարային | ֆունկցիան | 'գագաթ' | Ինչպես տեղադրել գործիքի հուշումը - վերև | ստորին | ձախ | ճիշտ | ավտո. Երբ ֆունկցիան օգտագործվում է տեղաբաշխումը որոշելու համար, այն կանչվում է գործիքի հուշումով DOM հանգույցը որպես առաջին արգումենտ և գործարկող տարրը՝ DOM հանգույցը որպես երկրորդ: Համատեքստը |
ընտրիչ | լար | կեղծ | Եթե ընտրիչ է տրամադրվում, գործիքի հուշման օբյեկտները կփոխանցվեն նշված թիրախներին: Գործնականում սա օգտագործվում է դինամիկ HTML բովանդակության համար գործիքի հուշումներ ավելացնելու համար: Տեսեք սա և տեղեկատվական օրինակ : |
կաղապար | լար | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
Հիմք HTML-ը, որը պետք է օգտագործվի գործիքի հուշում ստեղծելիս: Գործիքների հուշումները
Ամենաարտաքին փաթաթման տարրը պետք է ունենա |
կոչում | լարային | ֆունկցիան | '' | Վերնագրի կանխադրված արժեքը, եթե Եթե տրված է ֆունկցիա, այն կկանչվի իր |
ձգան | լար | «սավառել ֆոկուս» | Ինչպես է գործարկվում գործիքի հուշումը - սեղմեք | սավառնել | կենտրոնացում | ձեռնարկ. Դուք կարող եք անցնել մի քանի ձգան; առանձնացրեք դրանք բացատով: manual չի կարող համակցվել որևէ այլ ձգանի հետ: |
տեսադաշտ | լարային | օբյեկտ | ֆունկցիան | {ընտրիչ՝ «մարմին», լիցք՝ 0 } | Գործիքների հուշումը պահում է այս տարրի սահմաններում: Օրինակ՝ Եթե տրված է ֆունկցիա, այն կանչվում է՝ որպես միակ արգումենտ DOM հանգույցի գործարկման տարրը: Համատեքստը |
Գործիքների առանձին հուշումների տարբերակները կարող են այլընտրանքային կերպով սահմանվել տվյալների ատրիբուտների օգտագործման միջոցով, ինչպես բացատրվեց վերևում:
$().tooltip(options)
Կցում է գործիքի հուշման կարգավորիչը տարրերի հավաքածուին:
.tooltip('show')
Բացահայտում է տարրի գործիքի հուշումը: Վերադառնում է զանգահարողին՝ նախքան գործիքի հուշումը փաստացի ցուցադրելը (այսինքն՝ նախքան shown.bs.tooltip
իրադարձությունը տեղի ունենալը): Սա համարվում է գործիքի հուշման «ձեռքով» գործարկում: Գործիքների հուշումները զրոյական երկարությամբ վերնագրերով երբեք չեն ցուցադրվում:
.tooltip('hide')
Թաքցնում է տարրի գործիքի հուշումը: Վերադառնում է զանգահարողին՝ նախքան գործիքի հուշումը փաստացի թաքցվելը (այսինքն՝ նախքան hidden.bs.tooltip
իրադարձությունը տեղի ունենալը): Սա համարվում է գործիքի հուշման «ձեռքով» գործարկում:
.tooltip('toggle')
Փոխում է տարրի գործիքի հուշումը: Վերադառնում է զանգահարողին նախքան գործիքի հուշումը իրականում ցուցադրվել կամ թաքցվել է (այսինքն՝ նախքան իրադարձությունը shown.bs.tooltip
կամ hidden.bs.tooltip
իրադարձությունը տեղի ունենալը): Սա համարվում է գործիքի հուշման «ձեռքով» գործարկում:
.tooltip('destroy')
Թաքցնում և ոչնչացնում է տարրի գործիքի հուշումը: Գործիքների հուշումները, որոնք օգտագործում են պատվիրակում (որոնք ստեղծվել են selector
տարբերակի միջոցով ) չեն կարող անհատապես ոչնչացվել հետնորդ ձգան տարրերի վրա:
Միջոցառման տեսակը | Նկարագրություն |
---|---|
show.bs.tooltip | Այս իրադարձությունը գործարկվում է անմիջապես, երբ show կանչվում է օրինակի մեթոդը: |
ցուցադրված.bs.tooltip | Այս իրադարձությունը գործարկվում է, երբ գործիքի հուշումը տեսանելի է դառնում օգտատիրոջը (կսպասի CSS անցումների ավարտին): |
hide.bs.tooltip | Այս իրադարձությունը գործարկվում է անմիջապես, երբ hide կանչվում է օրինակի մեթոդը: |
hidden.bs.tooltip | Այս իրադարձությունը գործարկվում է, երբ գործիքի հուշումն ավարտվի օգտագործողից թաքցնելու համար (կսպասի CSS-ի անցումների ավարտին): |
տեղադրված.bs.tooltip | Այս իրադարձությունը գործարկվում է այն show.bs.tooltip իրադարձությունից հետո, երբ գործիքի հուշման ձևանմուշը ավելացվի DOM-ում: |
Ավելացրեք բովանդակության փոքր ծածկույթներ, ինչպիսիք են iPad-ի բովանդակությունը, ցանկացած տարրի վրա՝ երկրորդական տեղեկատվության պահպանման համար:
Փոփերները, որոնց վերնագիրը և բովանդակությունը զրոյական երկարություն ունեն, երբեք չեն ցուցադրվում:
Popover-ները պահանջում են Tooltip plugin- ը ներառել Bootstrap-ի ձեր տարբերակում:
Արդյունավետության նկատառումներից ելնելով, Tooltip-ը և Popover data-apis-ը միացված են, ինչը նշանակում է, որ դուք պետք է նախաստորագրեք դրանք ինքներդ :
Էջի բոլոր popover-ները սկզբնավորելու եղանակներից մեկը կլինի դրանք ընտրելն իրենց data-toggle
հատկանիշով.
.btn-group
a-ի կամ an- ի տարրերի վրա .input-group
կամ աղյուսակի հետ կապված տարրերի վրա ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, ) օգտագործելով popovers <tfoot>
, դուք պետք է նշեք տարբերակը container: 'body'
(ստորև փաստաթղթավորված)՝ խուսափելու համար անցանկալի կողմնակի ազդեցություններից (օրինակ՝ տարրի լայնացումը և/ կամ կորցնելով իր կլորացված անկյունները, երբ պոպովերը գործարկվում է):
disabled
A-ին կամ տարրին փոփով ավելացնելու համար .disabled
տարրը դրեք a-ի ներսում <div>
և դրա փոխարեն կիրառեք popover- <div>
ը:
Երբեմն դուք ցանկանում եք ավելացնել popover մի հիպերհղում, որը փաթաթում է բազմաթիվ տողեր: Popover plugin-ի լռելյայն վարքագիծն այն է կենտրոնացնել այն հորիզոնական և ուղղահայաց: Ավելացրեք white-space: nowrap;
ձեր խարիսխներին՝ դրանից խուսափելու համար:
Հասանելի է չորս տարբերակ՝ վերև, աջ, ներքև և ձախ հավասարեցված:
Այն կարող է կառուցվել: Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Այն կարող է կառուցվել: Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Այն կարող է կառուցվել: Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Այն կարող է կառուցվել: Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Օգտագործեք focus
գործարկիչը՝ օգտագործողի կատարած հաջորդ սեղմումով popover-ները հեռացնելու համար:
Բրաուզերի և միջպլատֆորմի պատշաճ վարքագծի համար դուք պետք է օգտագործեք <a>
պիտակը, ոչ թե <button>
պիտակը, ինչպես նաև պետք է ներառեք role="button"
և tabindex
ատրիբուտները:
Միացնել popover-ները JavaScript-ի միջոցով.
Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-
, ինչպես data-animation=""
.
Անուն | Տիպ | Կանխադրված | Նկարագրություն |
---|---|---|---|
անիմացիա | բուլյան | ճիշտ | Կիրառեք CSS fade անցում դեպի popover |
կոնտեյներ | լարային | կեղծ | կեղծ | Ավելացնում է popover-ը կոնկրետ տարրի վրա: Օրինակ՝ |
բովանդակությունը | լարային | ֆունկցիան | '' | Բովանդակության կանխադրված արժեքը, եթե Եթե տրված է ֆունկցիա, այն կկանչվի իր |
ուշացում | համարը | օբյեկտ | 0 | Պոպովերի ցուցադրման և թաքցման հետաձգումը (ms) - չի տարածվում ձեռքով ձգանման տեսակի վրա Եթե համարը տրվում է, ապա ուշացումը կիրառվում է ինչպես թաքցնել/ցուցադրել Օբյեկտի կառուցվածքը հետևյալն է. |
html | բուլյան | կեղծ | Տեղադրեք HTML-ը popover-ի մեջ: Եթե կեղծ է, jQuery-ի text մեթոդը կօգտագործվի DOM-ում բովանդակություն մտցնելու համար: Օգտագործեք տեքստ, եթե ձեզ անհանգստացնում են XSS հարձակումները: |
տեղաբաշխում | լարային | ֆունկցիան | 'ճիշտ' | Ինչպես տեղադրել popover - վերև | ստորին | ձախ | ճիշտ | ավտո. Երբ ֆունկցիան օգտագործվում է տեղաբաշխումը որոշելու համար, այն կանչվում է՝ որպես առաջին արգումենտ popover DOM հանգույցը, իսկ երկրորդը՝ DOM հանգույցը՝ գործարկող տարրը: Համատեքստը |
ընտրիչ | լար | կեղծ | Եթե ընտրիչ է տրամադրվում, popover օբյեկտները կփոխանցվեն նշված թիրախներին: Գործնականում սա օգտագործվում է դինամիկ HTML բովանդակության համար, որպեսզի ավելացվեն popovers: Տեսեք սա և տեղեկատվական օրինակ : |
կաղապար | լար | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>' |
Բազային HTML-ն օգտագործելու համար popover-ը ստեղծելիս: The popover- The popover-
Ամենաարտաքին փաթաթման տարրը պետք է ունենա |
կոչում | լարային | ֆունկցիան | '' | Վերնագրի կանխադրված արժեքը, եթե Եթե տրված է ֆունկցիա, այն կկանչվի իր |
ձգան | լար | 'սեղմել' | Ինչպես է առաջանում popover-ը - սեղմեք | սավառնել | կենտրոնացում | ձեռնարկ. Դուք կարող եք անցնել մի քանի ձգան; առանձնացրեք դրանք բացատով: manual չի կարող համակցվել որևէ այլ ձգանի հետ: |
տեսադաշտ | լարային | օբյեկտ | ֆունկցիան | {ընտրիչ՝ «մարմին», լիցք՝ 0 } | Պոպովերը պահում է այս տարրի սահմաններում: Օրինակ՝ Եթե տրված է ֆունկցիա, այն կանչվում է՝ որպես միակ արգումենտ DOM հանգույցի գործարկման տարրը: Համատեքստը |
Անհատական պոպովերի տարբերակները կարող են այլընտրանքային կերպով սահմանվել տվյալների ատրիբուտների օգտագործման միջոցով, ինչպես բացատրվեց վերևում:
$().popover(options)
Նախաձեռնում է popovers տարրերի հավաքածուի համար:
.popover('show')
Բացահայտում է տարրի պոպովեր: Վերադառնում է զանգահարողին նախքան փոփերի փաստացի ցուցադրումը (այսինքն՝ նախքան shown.bs.popover
իրադարձությունը տեղի ունենալը): Սա համարվում է պոպովերի «ձեռնարկ» հրահրում: Փոփերները, որոնց վերնագիրը և բովանդակությունը զրոյական երկարություն ունեն, երբեք չեն ցուցադրվում:
.popover('hide')
Թաքցնում է տարրի պոպովերը: Վերադառնում է զանգահարողին նախքան popover-ը իրականում թաքցվել է (այսինքն՝ նախքան hidden.bs.popover
իրադարձությունը տեղի ունենալը): Սա համարվում է պոպովերի «ձեռնարկ» հրահրում:
.popover('toggle')
Անջատում է տարրի popover-ը: Վերադառնում է զանգահարողին նախքան popover-ն իրականում ցուցադրվել կամ թաքցվել է (այսինքն՝ նախքան իրադարձությունը shown.bs.popover
կամ hidden.bs.popover
իրադարձությունը տեղի ունենալը): Սա համարվում է պոպովերի «ձեռնարկ» հրահրում:
.popover('destroy')
Թաքցնում և ոչնչացնում է տարրի պոպովերը: Պոպովերը, որոնք օգտագործում են պատվիրակում (որոնք ստեղծվում են selector
տարբերակի միջոցով ) չեն կարող անհատապես ոչնչացվել հետնորդ ձգան տարրերի վրա:
Միջոցառման տեսակը | Նկարագրություն |
---|---|
show.bs.popover | Այս իրադարձությունը գործարկվում է անմիջապես, երբ show կանչվում է օրինակի մեթոդը: |
ցուցադրված.bs.popover | Այս իրադարձությունը գործարկվում է, երբ popover-ը տեսանելի է դառնում օգտատիրոջը (կսպասի CSS անցումների ավարտին): |
hide.bs.popover | Այս իրադարձությունը գործարկվում է անմիջապես, երբ hide կանչվում է օրինակի մեթոդը: |
թաքնված.bs.popover | Այս իրադարձությունը գործարկվում է, երբ popover-ն ավարտում է օգտագործողից թաքցնելը (կսպասի CSS անցումների ավարտին): |
տեղադրված.bs.popover | Այս միջոցառումը գործարկվում է այն show.bs.popover իրադարձությունից հետո, երբ popover ձևանմուշը ավելացվի DOM-ում: |
Այս փլագինով ավելացրեք անջատման գործառույթը բոլոր ահազանգերի հաղորդագրություններին:
Կոճակ օգտագործելիս .close
այն պետք է լինի առաջին զավակը .alert-dismissible
և նշագծման մեջ չպետք է լինի տեքստային բովանդակություն:
Փոխեք սա և այն և նորից փորձեք: Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Պարզապես ավելացրեք data-dismiss="alert"
ձեր փակման կոճակին, որպեսզի ավտոմատ կերպով ազդանշան փակման գործառույթը տրամադրվի: Զգուշացումը փակելով այն կհեռացվի DOM-ից:
Որպեսզի ձեր ծանուցումները փակելիս օգտագործեն անիմացիա, համոզվեք, որ դրանք ունեն .fade
և.in
դասերն արդեն կիրառված են դրանց համար:
$().alert()
data-dismiss="alert"
Կատարում է ազդանշան, որը լսում է ատրիբուտ ունեցող ժառանգական տարրերի վրա սեղմումների իրադարձությունները : (Պետք չէ data-api-ի ավտոմատ սկզբնավորումն օգտագործելիս):
$().alert('close')
Փակում է ահազանգը՝ հեռացնելով այն DOM-ից: Եթե .fade
և .in
դասերը առկա են տարրի վրա, նախքան այն հեռացնելը զգուշացումը կթուլանա:
Bootstrap-ի նախազգուշացման հավելվածը բացահայտում է մի քանի իրադարձություններ՝ ազդանշանային գործառույթին միանալու համար:
Միջոցառման տեսակը | Նկարագրություն |
---|---|
փակել.բս.զգոն | Այս իրադարձությունը գործարկվում է անմիջապես, երբ close կանչվում է օրինակի մեթոդը: |
փակված.բս.զգոն | Այս իրադարձությունը գործարկվում է, երբ ահազանգը փակված է (կսպասի CSS-ի անցումների ավարտին): |
Կատարեք ավելին կոճակներով: Կառավարեք կոճակի վիճակը կամ ստեղծեք կոճակների խմբեր ավելի շատ բաղադրիչների համար, ինչպիսիք են գործիքների տողերը:
Firefox-ը պահպանում է վերահսկման վիճակները (հաշմանդամություն և ստուգվածություն) էջի բեռնվածության ընթացքում : Դրա լուծումը օգտագործելն է autocomplete="off"
: Տես Mozilla-ի սխալ #654072 :
Ավելացնել data-loading-text="Loading..."
կոճակի վրա բեռնման վիճակ օգտագործելու համար:
Այս հատկությունը հնացած է v3.3.5-ից և հեռացվել է v4-ում:
Հանուն այս ցույցի, մենք օգտագործում ենք data-loading-text
և $().button('loading')
, բայց դա միակ վիճակը չէ, որ դուք կարող եք օգտագործել: Այս մասին ավելին տես ստորև $().button(string)
փաստաթղթերում :
Ավելացրեք data-toggle="button"
՝ մեկ կոճակի վրա փոխարկումն ակտիվացնելու համար:
.active
ևaria-pressed="true"
Նախապես փոխարկված կոճակների համար դուք պետք է ինքներդ ավելացնեք .active
դասը և aria-pressed="true"
հատկանիշը :button
Ավելացրե՛ք data-toggle="buttons"
պարունակող .btn-group
վանդակում կամ ռադիո մուտքագրումներ՝ դրանց համապատասխան ոճերի փոխարկումը հնարավոր դարձնելու համար:
.active
Նախապես ընտրված տարբերակների համար դուք պետք .active
է ինքներդ ավելացնեք դասը մուտքագրման մեջ label
:
Եթե վանդակի կոճակի ստուգված վիճակը թարմացվում է առանց կոճակի click
վրա իրադարձություն գործարկելու (օրինակ ՝ մուտքագրման հատկությունը <input type="reset">
սահմանելու միջոցով կամ միջոցով checked
), դուք պետք է ինքներդ փոխեք .active
դասը մուտքագրման վրա :label
$().button('toggle')
Անջատում է մղման վիճակը: Կոճակին տալիս է այն տեսքը, որ այն ակտիվացված է:
$().button('reset')
Վերականգնում է կոճակի վիճակը - տեքստը փոխում է բնօրինակ տեքստի: Այս մեթոդը ասինխրոն է և վերադառնում է մինչև վերակայման փաստացի ավարտը:
$().button(string)
Փոխում է տեքստը ցանկացած տվյալների սահմանված տեքստային վիճակի:
Ճկուն փլագին, որն օգտագործում է մի քանի դասեր՝ հեշտ փոխակերպման վարքագծի համար:
Collapse-ը պահանջում է, որ transitions plugin- ը ներառվի Bootstrap-ի ձեր տարբերակում:
Սեղմեք ստորև բերված կոճակները՝ դասի փոփոխությունների միջոցով մեկ այլ տարր ցուցադրելու և թաքցնելու համար.
.collapse
թաքցնում է բովանդակությունը.collapsing
կիրառվում է անցումների ժամանակ.collapse.in
ցույց է տալիս բովանդակությունըԴուք կարող եք օգտագործել href
ատրիբուտով հղում կամ հատկանիշով կոճակ data-target
: Երկու դեպքում data-toggle="collapse"
էլ պահանջվում է.
Ընդլայնել լռելյայն փլուզման վարքագիծը՝ վահանակի բաղադրիչով ակորդեոն ստեղծելու համար:
Հնարավոր է նաև s-ը փոխանակել .panel-body
s-ի հետ .list-group
:
Համոզվեք, որ ավելացրեք aria-expanded
կառավարման տարրին: Այս հատկանիշը հստակորեն սահմանում է ծալվող տարրի ներկայիս վիճակը էկրանի ընթերցիչների և նմանատիպ օժանդակ տեխնոլոգիաների համար: Եթե ծալվող տարրը լռելյայն փակ է, այն պետք է ունենա aria-expanded="false"
. Եթե դուք կարգադրել եք, որ ծալվող տարրը բաց լինի լռելյայն՝ օգտագործելով in
դասը, aria-expanded="true"
փոխարենը դրեք կառավարում: Փլագինը ավտոմատ կերպով կփոխի այս հատկանիշը՝ հիմնվելով ծալվող տարրի բացման կամ փակման վրա, թե ոչ:
Բացի այդ, եթե ձեր կառավարման տարրը թիրախավորում է մեկ ծալվող տարր, այսինքն՝ data-target
հատկանիշը մատնացույց է անում id
ընտրիչին, դուք կարող եք լրացուցիչ aria-controls
հատկանիշ ավելացնել կառավարման տարրին, որը պարունակում id
է ծալվող տարրը: Էկրանի ժամանակակից ընթերցիչները և նմանատիպ օժանդակ տեխնոլոգիաները օգտագործում են այս հատկանիշը՝ օգտատերերին լրացուցիչ դյուրանցումներ տրամադրելու համար՝ անմիջապես դեպի ծալվող տարրը նավարկելու համար:
Փլուզման պլագինը օգտագործում է մի քանի դասեր՝ ծանր բարձրացնելու համար.
.collapse
թաքցնում է բովանդակությունը.collapse.in
ցույց է տալիս բովանդակությունը.collapsing
ավելացվում է, երբ անցումը սկսվում է, և հեռացվում է, երբ այն ավարտվում էԱյս դասերը կարելի է գտնել component-animations.less
.
Պարզապես ավելացրեք data-toggle="collapse"
և a data-target
տարրին, որպեսզի ինքնաբերաբար նշանակվի ծալվող տարրի կառավարումը: Հատկանիշն data-target
ընդունում է CSS ընտրիչ՝ կիրառման համար փլուզումը: Համոզվեք, որ դասը ավելացրե՛ք collapse
ծալվող տարրին: Եթե ցանկանում եք, որ այն լռելյայն բացվի, ավելացրեք լրացուցիչ դասը in
:
Ակորդեոնի նման խմբի կառավարում ավելացնելու համար ծալվող կառավարում ավելացրեք տվյալների հատկանիշը data-parent="#selector"
: Տեսեք ցուցադրությունը՝ սա գործողության մեջ տեսնելու համար:
Ձեռքով միացնել՝
Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-
, ինչպես data-parent=""
.
Անուն | տիպ | լռելյայն | նկարագրությունը |
---|---|---|---|
ծնող | ընտրիչ | կեղծ | Եթե ապահովված է ընտրիչ, ապա նշված ծնողի տակ գտնվող բոլոր ծալվող տարրերը կփակվեն, երբ ցուցադրվի այս ծալվող տարրը: (նման է ավանդական ակորդեոնի վարքագծին. սա կախված է panel դասից) |
փոխարկել | բուլյան | ճիշտ | Անջատում է ծալվող տարրը կանչի ժամանակ |
.collapse(options)
Ակտիվացնում է ձեր բովանդակությունը որպես ծալովի տարր: Ընդունում է ընտրովի տարբերակներ object
:
.collapse('toggle')
Անջատում է ծալվող տարրը ցուցադրված կամ թաքցվածի: Վերադառնում է զանգահարողին մինչև ծալվող տարրը իրականում ցուցադրվել կամ թաքցվել է (այսինքն՝ նախքան իրադարձությունը shown.bs.collapse
կամ hidden.bs.collapse
իրադարձությունը տեղի ունենալը):
.collapse('show')
Ցույց է տալիս ծալվող տարր: Վերադառնում է զանգահարողին նախքան ծալվող տարրը փաստացի ցուցադրվելը (այսինքն՝ նախքան shown.bs.collapse
իրադարձությունը տեղի ունենալը):
.collapse('hide')
Թաքցնում է ծալվող տարրը: Վերադառնում է զանգահարողին նախքան ծալվող տարրը իրականում թաքցվել է (այսինքն՝ նախքան hidden.bs.collapse
իրադարձությունը տեղի ունենալը):
Bootstrap-ի փլուզման դասը բացահայտում է մի քանի իրադարձություններ՝ փլուզման գործառույթին միանալու համար:
Միջոցառման տեսակը | Նկարագրություն |
---|---|
show.bs.collapse | Այս իրադարձությունը գործարկվում է անմիջապես, երբ show կանչվում է օրինակի մեթոդը: |
ցուցադրված.bs.collapse | Այս իրադարձությունը գործարկվում է, երբ ծալման տարրը տեսանելի է դառնում օգտատիրոջը (կսպասի CSS անցումների ավարտին): |
hide.bs.collapse | Այս իրադարձությունը գործարկվում է անմիջապես, երբ hide մեթոդը կանչվում է: |
hidden.bs.collapse | Այս միջոցառումը գործարկվում է, երբ օգտատերից թաքցված է կոծկման տարրը (կսպասի CSS անցումների ավարտին): |
Սլայդերի ցուցադրման բաղադրիչ տարրերի միջով հեծանվով անցնելու համար, ինչպես կարուսելը: Ներդրված կարուսելները չեն աջակցվում:
Կարուսելի բաղադրիչը հիմնականում չի համապատասխանում մատչելիության չափանիշներին: Եթե դուք պետք է համապատասխանեք, խնդրում ենք դիտարկել ձեր բովանդակությունը ներկայացնելու այլ տարբերակներ:
Bootstrap-ը բացառապես օգտագործում է CSS3 իր անիմացիաների համար, սակայն Internet Explorer 8-ը և 9-ը չեն աջակցում անհրաժեշտ CSS հատկություններին: Այսպիսով, այս բրաուզերներն օգտագործելիս սլայդների անցումային անիմացիաներ չկան: Մենք միտումնավոր որոշել ենք չներառել jQuery-ի վրա հիմնված հետադարձ կապեր անցումների համար:
Դասը .active
պետք է ավելացվի սլայդներից մեկում: Հակառակ դեպքում կարուսելը չի երևա։
The .glyphicon .glyphicon-chevron-left
և .glyphicon .glyphicon-chevron-right
դասերը պարտադիր չէ, որ անհրաժեշտ լինեն վերահսկման համար: Bootstrap-ն ապահովում է .icon-prev
և .icon-next
որպես պարզ Unicode այլընտրանքներ:
Հեշտությամբ ավելացրեք ենթագրեր ձեր սլայդներին՝ օգտագործելով .carousel-caption
որևէ տարր .item
: Տեղադրեք գրեթե ցանկացած ընտրովի HTML այնտեղ, և այն ավտոմատ կերպով կհավասարեցվի և ձևաչափվի:
Կարուսելների համար անհրաժեշտ է օգտագործել id
ամենաարտաքին կոնտեյների վրա (the .carousel
), որպեսզի կարուսելի հսկիչները ճիշտ աշխատեն: Բազմաթիվ կարուսելներ ավելացնելիս կամ կարուսելները փոխելիս id
համոզվեք, որ թարմացնեք համապատասխան հսկիչները:
Օգտագործեք տվյալների ատրիբուտներ՝ կարուսելի դիրքը հեշտությամբ կառավարելու համար: data-slide
ընդունում է հիմնաբառերը prev
կամ next
, որը փոխում է սլայդի դիրքը ներկայիս դիրքի համեմատ: Որպես այլընտրանք, օգտագործեք data-slide-to
՝ չմշակված սլայդի ինդեքսը կարուսելին փոխանցելու համար data-slide-to="2"
, որը սլայդի դիրքը տեղափոխում է որոշակի ինդեքսի՝ սկսած 0
.
Հատկանիշն data-ride="carousel"
օգտագործվում է կարուսելը որպես աշխույժ նշելու համար՝ սկսած էջի բեռնումից: Այն չի կարող օգտագործվել նույն կարուսելի (ավելորդ և անհարկի) բացահայտ JavaScript սկզբնավորման հետ համատեղ:
Ձեռքով զանգահարեք կարուսել՝
Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-
, ինչպես data-interval=""
.
Անուն | տիպ | լռելյայն | նկարագրությունը |
---|---|---|---|
ընդմիջում | թիվ | 5000 | Ժամանակի չափը, որը հետաձգվում է ապրանքի ինքնաբերաբար հեծանիվ վարելու միջև: Եթե կեղծ է, կարուսելը ինքնաբերաբար չի շրջվի: |
դադար | լարային | դատարկ | "սավառնել" | Եթե դրված է "hover" , ապա դադարեցնում է կարուսելի հեծանիվը միացված mouseenter և վերսկսում է կարուսելի հեծանիվը միացված mouseleave : Եթե դրված է null , ապա սավառնելով կարուսելի վրա այն չի դադարեցնի: |
պատել | բուլյան | ճիշտ | Արդյոք կարուսելը պետք է անընդհատ պտտվի, թե կոշտ կանգառներ ունենա: |
ստեղնաշար | բուլյան | ճիշտ | Արդյոք կարուսելը պետք է արձագանքի ստեղնաշարի իրադարձություններին: |
.carousel(options)
Նախաձեռնում է կարուսելը կամընտիր ընտրանքներով object
և սկսում հեծանվով անցնել իրերի միջով:
.carousel('cycle')
Շրջում է կարուսելի տարրերի միջով ձախից աջ:
.carousel('pause')
Դադարեցնում է կարուսելը իրերի միջով հեծանիվ անցնելուց:
.carousel(number)
Կարուսելը տեղափոխում է որոշակի շրջանակ (0-ի վրա հիմնված, զանգվածի նման):
.carousel('prev')
Ցիկլեր դեպի նախորդ կետը:
.carousel('next')
Շրջագայություններ դեպի հաջորդ կետ:
Bootstrap-ի կարուսելի դասը բացահայտում է երկու իրադարձություն՝ կարուսելի ֆունկցիոնալությանը միանալու համար:
Երկու իրադարձություններն ունեն հետևյալ լրացուցիչ հատկությունները.
direction
Ուղղությունը, որով սահում է կարուսելը (կամ "left"
կամ "right"
):relatedTarget
DOM տարրը, որը սահում է իր տեղը որպես ակտիվ տարր:Կարուսելի բոլոր իրադարձությունները կրակում են հենց կարուսելի վրա (այսինքն՝ <div class="carousel">
):
Միջոցառման տեսակը | Նկարագրություն |
---|---|
slide.bs.կարուսել | Այս իրադարձությունն անմիջապես գործարկվում է, երբ գործարկվում է slide օրինակի մեթոդը: |
slid.bs.կարուսել | Այս միջոցառումը գործարկվում է, երբ կարուսելը ավարտում է իր սլայդային անցումը: |
Affix plugin- position: fixed;
ը միանում և անջատվում է՝ ընդօրինակելով հայտնաբերված էֆեկտը position: sticky;
: Աջ կողմում գտնվող ենթանավիգացիան affix plugin-ի կենդանի ցուցադրությունն է:
Օգտագործեք հավելվածի հավելվածը տվյալների ատրիբուտների միջոցով կամ ձեռքով ձեր սեփական JavaScript-ով: Երկու իրավիճակներում էլ դուք պետք է տրամադրեք CSS ձեր ամրացված բովանդակության դիրքավորման և լայնության համար:
Նշում․ մի օգտագործեք կցման պլագինը համեմատաբար տեղակայված տարրում պարունակվող տարրի վրա, օրինակ՝ ձգված կամ հրված սյունակում, Safari-ի մատուցման սխալի պատճառով :
Affix plugin-ը փոխվում է երեք դասերի միջև, որոնցից յուրաքանչյուրը ներկայացնում է որոշակի վիճակ .affix
՝ .affix-top
, և .affix-bottom
: Դուք պետք է տրամադրեք ոճերը, բացառությամբ position: fixed;
on-ի .affix
, այս դասերի համար (անկախ այս հավելվածից)՝ իրական դիրքերը կարգավորելու համար:
Ահա թե ինչպես է աշխատում աֆիքս հավելվածը.
.affix-top
է՝ ցույց տալու համար, որ տարրը գտնվում է ամենաբարձր դիրքում: Այս պահին ոչ մի CSS դիրքավորում չի պահանջվում:.affix
փոխարինվում .affix-top
և position: fixed;
տեղադրվում է (տրամադրվում է Bootstrap-ի CSS-ի կողմից):.affix
Եթե ներքևի շեղումը սահմանված է, ոլորելով դրա կողքով պետք է փոխարինվի .affix-bottom
. Քանի որ օֆսեթները կամընտիր են, մեկի կարգավորումը պահանջում է, որ դուք սահմանեք համապատասխան CSS: Այս դեպքում position: absolute;
անհրաժեշտության դեպքում ավելացրեք: Փլագինը օգտագործում է տվյալների հատկանիշը կամ JavaScript տարբերակը՝ որոշելու, թե որտեղից պետք է տեղավորել տարրը:Հետևեք վերը նշված քայլերին՝ ձեր CSS-ը ստորև նշված օգտագործման տարբերակներից որևէ մեկի համար սահմանելու համար:
Ցանկացած տարրի վրա կցելու վարքագիծը հեշտությամբ ավելացնելու համար պարզապես ավելացրեք data-spy="affix"
այն տարրին, որը ցանկանում եք լրտեսել: Օգտագործեք շեղումներ՝ որոշելու համար, թե երբ պետք է միացնել տարրի ամրացումը:
Զանգահարեք հավելվածի հավելվածը JavaScript-ի միջոցով.
Ընտրանքները կարող են փոխանցվել տվյալների ատրիբուտների կամ JavaScript-ի միջոցով: Տվյալների ատրիբուտների համար ավելացրեք տարբերակի անունը data-
, ինչպես data-offset-top="200"
.
Անուն | տիպ | լռելյայն | նկարագրությունը |
---|---|---|---|
օֆսեթ | համարը | ֆունկցիա | օբյեկտ | 10 | Փիքսելներ, որոնք պետք է շրջվեն էկրանից ոլորման դիրքը հաշվարկելիս: Եթե տրամադրվում է մեկ համար, ապա շեղումը կկիրառվի ինչպես վերևի, այնպես էլ ներքևի ուղղություններով: Եզակի, ներքևի և վերին օֆսեթ ապահովելու համար պարզապես տրամադրեք օբյեկտ offset: { top: 10 } կամ offset: { top: 10, bottom: 5 } . Օգտագործեք ֆունկցիա, երբ անհրաժեշտ է դինամիկ կերպով հաշվարկել օֆսեթը: |
թիրախ | ընտրիչ | հանգույց | jQuery տարր | window օբյեկտը _ |
Նշում է աֆիքսի թիրախային տարրը: |
.affix(options)
Ակտիվացնում է ձեր բովանդակությունը որպես ամրացված բովանդակություն: Ընդունում է ընտրովի տարբերակներ object
:
.affix('checkPosition')
Վերահաշվում է կցորդի վիճակը՝ հիմնվելով համապատասխան տարրերի չափերի, դիրքի և ոլորման դիրքի վրա: Այն.affix
, .affix-top
և .affix-bottom
դասերը ավելացվում են կամ հեռացվում կցված բովանդակությունից՝ համաձայն նոր վիճակի: Այս մեթոդը պետք է կանչվի ամեն անգամ, երբ կցված բովանդակության կամ թիրախային տարրի չափերը փոխվում են՝ ամրացված բովանդակության ճիշտ դիրքավորումն ապահովելու համար:
Bootstrap-ի affix plugin-ը բացահայտում է մի քանի իրադարձություններ՝ կցելու գործառույթին միանալու համար:
Միջոցառման տեսակը | Նկարագրություն |
---|---|
affix.bs.affix | Այս իրադարձությունը գործարկվում է տարրը կցվելուց անմիջապես առաջ: |
affixed.bs.affix | Այս միջոցառումը գործարկվում է տարրը ամրացնելուց հետո: |
affix-top.bs.affix | Այս իրադարձությունը գործարկվում է անմիջապես տարրը վերևում ամրացնելուց առաջ: |
affixed-top.bs.affix | Այս միջոցառումը գործարկվում է այն բանից հետո, երբ տարրը կցվում է վերևում: |
affix-bottom.bs.affix | Այս իրադարձությունը գործարկվում է անմիջապես նախքան տարրը կցվել է ներքևում: |
affixed-bottom.bs.affix | Այս միջոցառումը գործարկվում է այն բանից հետո, երբ տարրը կցվել է ներքևում: |