ఆఫ్కాన్వాస్
కొన్ని తరగతులు మరియు మా JavaScript ప్లగిన్తో నావిగేషన్, షాపింగ్ కార్ట్లు మరియు మరిన్నింటి కోసం మీ ప్రాజెక్ట్లో దాచిన సైడ్బార్లను రూపొందించండి.
అది ఎలా పని చేస్తుంది
ఆఫ్కాన్వాస్ అనేది వ్యూపోర్ట్ యొక్క ఎడమ, కుడి లేదా దిగువ అంచు నుండి కనిపించేలా జావాస్క్రిప్ట్ ద్వారా టోగుల్ చేయగల సైడ్బార్ భాగం. బటన్లు లేదా యాంకర్లు మీరు టోగుల్ చేసే నిర్దిష్ట మూలకాలకు జోడించబడే ట్రిగ్గర్లుగా data
ఉపయోగించబడతాయి మరియు మా JavaScriptను అమలు చేయడానికి గుణాలు ఉపయోగించబడతాయి.
- Offcanvas అదే JavaScript కోడ్లో కొన్నింటిని మోడల్ల వలె భాగస్వామ్యం చేస్తుంది. సంభావితంగా, అవి చాలా పోలి ఉంటాయి, కానీ అవి ప్రత్యేక ప్లగిన్లు.
- అదేవిధంగా, ఆఫ్కాన్వాస్ స్టైల్స్ మరియు డైమెన్షన్ల కోసం కొన్ని సోర్స్ సాస్ వేరియబుల్స్ మోడల్ వేరియబుల్స్ నుండి వారసత్వంగా పొందబడతాయి.
- చూపబడినప్పుడు, ఆఫ్కాన్వాస్ ఆఫ్కాన్వాస్ను దాచడానికి క్లిక్ చేయగల డిఫాల్ట్ బ్యాక్డ్రాప్ను కలిగి ఉంటుంది.
- మోడల్ల మాదిరిగానే, ఒకేసారి ఒక ఆఫ్కాన్వాస్ మాత్రమే చూపబడుతుంది.
హెడ్ అప్! CSS యానిమేషన్లను ఎలా నిర్వహిస్తుందో, మీరు ఒక మూలకాన్ని ఉపయోగించలేరు margin
లేదా ఉపయోగించలేరు. బదులుగా, తరగతిని స్వతంత్ర చుట్టే మూలకం వలె ఉపయోగించండి.translate
.offcanvas
prefers-reduced-motion
మీడియా ప్రశ్నపై ఆధారపడి ఉంటుంది. మా యాక్సెసిబిలిటీ డాక్యుమెంటేషన్ యొక్క తగ్గిన చలన విభాగాన్ని చూడండి
.
ఉదాహరణలు
ఆఫ్కాన్వాస్ భాగాలు
డిఫాల్ట్గా చూపబడే ఆఫ్కాన్వాస్ ఉదాహరణ క్రింద ఉంది ( .show
న ద్వారా .offcanvas
). ఆఫ్కాన్వాస్లో క్లోజ్ బటన్తో హెడర్కు మద్దతు మరియు కొంత ప్రారంభానికి ఐచ్ఛిక బాడీ క్లాస్ ఉన్నాయి padding
. మీరు వీలైనప్పుడల్లా తొలగింపు చర్యలతో ఆఫ్కాన్వాస్ హెడర్లను చేర్చాలని లేదా స్పష్టమైన తొలగింపు చర్యను అందించాలని మేము సూచిస్తున్నాము.
ఆఫ్కాన్వాస్
<div class="offcanvas offcanvas-start" tabindex="-1" id="offcanvas" aria-labelledby="offcanvasLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="offcanvasLabel">Offcanvas</h5>
<button type="button" class="btn-close text-reset" data-bs-dismiss="offcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body">
Content for the offcanvas goes here. You can place just about any Bootstrap component or custom elements here.
</div>
</div>
ప్రత్యక్ష ప్రదర్శన
.show
క్లాస్తో ఎలిమెంట్పై క్లాస్ను టోగుల్ చేసే జావాస్క్రిప్ట్ ద్వారా ఆఫ్కాన్వాస్ ఎలిమెంట్ను చూపించడానికి మరియు దాచడానికి దిగువ బటన్లను ఉపయోగించండి .offcanvas
.
.offcanvas
కంటెంట్ను దాచిపెడుతుంది (డిఫాల్ట్).offcanvas.show
కంటెంట్ చూపిస్తుంది
మీరు href
అట్రిబ్యూట్తో లింక్ని లేదా లక్షణంతో బటన్ను ఉపయోగించవచ్చు data-bs-target
. రెండు సందర్భాల్లో, data-bs-toggle="offcanvas"
ఇది అవసరం.
ఆఫ్కాన్వాస్
<a class="btn btn-primary" data-bs-toggle="offcanvas" href="#offcanvasExample" role="button" aria-controls="offcanvasExample">
Link with href
</a>
<button class="btn btn-primary" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasExample" aria-controls="offcanvasExample">
Button with data-bs-target
</button>
<div class="offcanvas offcanvas-start" tabindex="-1" id="offcanvasExample" aria-labelledby="offcanvasExampleLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="offcanvasExampleLabel">Offcanvas</h5>
<button type="button" class="btn-close text-reset" data-bs-dismiss="offcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body">
<div>
Some text as placeholder. In real life you can have the elements you have chosen. Like, text, images, lists, etc.
</div>
<div class="dropdown mt-3">
<button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuButton" data-bs-toggle="dropdown">
Dropdown button
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenuButton">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else here</a></li>
</ul>
</div>
</div>
</div>
ప్లేస్మెంట్
ఆఫ్కాన్వాస్ కాంపోనెంట్ల కోసం డిఫాల్ట్ ప్లేస్మెంట్ లేదు, కాబట్టి మీరు తప్పనిసరిగా దిగువ మాడిఫైయర్ క్లాస్లలో ఒకదాన్ని జోడించాలి;
.offcanvas-start
వీక్షణపోర్ట్కు ఎడమవైపు ఆఫ్కాన్వాస్ను ఉంచుతుంది (పైన చూపబడింది).offcanvas-end
వీక్షణపోర్ట్ కుడివైపు ఆఫ్కాన్వాస్ను ఉంచుతుంది.offcanvas-top
వీక్షణపోర్ట్ పైభాగంలో ఆఫ్కాన్వాస్ను ఉంచుతుంది.offcanvas-bottom
వీక్షణపోర్ట్ దిగువన ఆఫ్కాన్వాస్ను ఉంచుతుంది
దిగువన ఎగువ, కుడి మరియు దిగువ ఉదాహరణలను ప్రయత్నించండి.
ఆఫ్కాన్వాస్ టాప్
<button class="btn btn-primary" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasTop" aria-controls="offcanvasTop">Toggle top offcanvas</button>
<div class="offcanvas offcanvas-top" tabindex="-1" id="offcanvasTop" aria-labelledby="offcanvasTopLabel">
<div class="offcanvas-header">
<h5 id="offcanvasTopLabel">Offcanvas top</h5>
<button type="button" class="btn-close text-reset" data-bs-dismiss="offcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body">
...
</div>
</div>
ఆఫ్కాన్వాస్ కుడివైపు
<button class="btn btn-primary" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasRight" aria-controls="offcanvasRight">Toggle right offcanvas</button>
<div class="offcanvas offcanvas-end" tabindex="-1" id="offcanvasRight" aria-labelledby="offcanvasRightLabel">
<div class="offcanvas-header">
<h5 id="offcanvasRightLabel">Offcanvas right</h5>
<button type="button" class="btn-close text-reset" data-bs-dismiss="offcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body">
...
</div>
</div>
ఆఫ్కాన్వాస్ దిగువన
<button class="btn btn-primary" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasBottom" aria-controls="offcanvasBottom">Toggle bottom offcanvas</button>
<div class="offcanvas offcanvas-bottom" tabindex="-1" id="offcanvasBottom" aria-labelledby="offcanvasBottomLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="offcanvasBottomLabel">Offcanvas bottom</h5>
<button type="button" class="btn-close text-reset" data-bs-dismiss="offcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body small">
...
</div>
</div>
బ్యాక్డ్రాప్
ఆఫ్కాన్వాస్ <body>
మరియు దాని బ్యాక్డ్రాప్ కనిపించినప్పుడు మూలకాన్ని స్క్రోల్ చేయడం నిలిపివేయబడుతుంది. స్క్రోలింగ్ను టోగుల్ చేయడానికి మరియు బ్యాక్డ్రాప్ను టోగుల్ చేయడానికి data-bs-scroll
లక్షణాన్ని ఉపయోగించండి .<body>
data-bs-backdrop
స్క్రోలింగ్ తో రంగు
ఈ ఎంపికను చర్యలో చూడటానికి మిగిలిన పేజీని స్క్రోల్ చేయడానికి ప్రయత్నించండి.
బ్యాక్డ్రాప్తో ఆఫ్కాన్వాస్
.....
స్క్రోలింగ్తో బ్యాక్డ్రాప్ చేయబడింది
ఈ ఎంపికను చర్యలో చూడటానికి మిగిలిన పేజీని స్క్రోల్ చేయడానికి ప్రయత్నించండి.
<button class="btn btn-primary" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasScrolling" aria-controls="offcanvasScrolling">Enable body scrolling</button>
<button class="btn btn-primary" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasWithBackdrop" aria-controls="offcanvasWithBackdrop">Enable backdrop (default)</button>
<button class="btn btn-primary" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasWithBothOptions" aria-controls="offcanvasWithBothOptions">Enable both scrolling & backdrop</button>
<div class="offcanvas offcanvas-start" data-bs-scroll="true" data-bs-backdrop="false" tabindex="-1" id="offcanvasScrolling" aria-labelledby="offcanvasScrollingLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="offcanvasScrollingLabel">Colored with scrolling</h5>
<button type="button" class="btn-close text-reset" data-bs-dismiss="offcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body">
<p>Try scrolling the rest of the page to see this option in action.</p>
</div>
</div>
<div class="offcanvas offcanvas-start" tabindex="-1" id="offcanvasWithBackdrop" aria-labelledby="offcanvasWithBackdropLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="offcanvasWithBackdropLabel">Offcanvas with backdrop</h5>
<button type="button" class="btn-close text-reset" data-bs-dismiss="offcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body">
<p>.....</p>
</div>
</div>
<div class="offcanvas offcanvas-start" data-bs-scroll="true" tabindex="-1" id="offcanvasWithBothOptions" aria-labelledby="offcanvasWithBothOptionsLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="offcanvasWithBothOptionsLabel">Backdroped with scrolling</h5>
<button type="button" class="btn-close text-reset" data-bs-dismiss="offcanvas" aria-label="Close"></button>
</div>
<div class="offcanvas-body">
<p>Try scrolling the rest of the page to see this option in action.</p>
</div>
</div>
సౌలభ్యాన్ని
ఆఫ్కాన్వాస్ ప్యానెల్ సంభావితంగా మోడల్ డైలాగ్ aria-labelledby="..."
అయినందున, ఆఫ్కాన్వాస్ టైటిల్ను సూచిస్తూ- కు జోడించాలని నిర్ధారించుకోండి .offcanvas
. role="dialog"
మేము ఇప్పటికే జావాస్క్రిప్ట్ ద్వారా జోడించినందున మీరు జోడించాల్సిన అవసరం లేదని గుర్తుంచుకోండి.
సాస్
వేరియబుల్స్
$offcanvas-padding-y: $modal-inner-padding;
$offcanvas-padding-x: $modal-inner-padding;
$offcanvas-horizontal-width: 400px;
$offcanvas-vertical-height: 30vh;
$offcanvas-transition-duration: .3s;
$offcanvas-border-color: $modal-content-border-color;
$offcanvas-border-width: $modal-content-border-width;
$offcanvas-title-line-height: $modal-title-line-height;
$offcanvas-bg-color: $modal-content-bg;
$offcanvas-color: $modal-content-color;
$offcanvas-box-shadow: $modal-content-box-shadow-xs;
వాడుక
ఆఫ్కాన్వాస్ ప్లగ్ఇన్ హెవీ లిఫ్టింగ్ను నిర్వహించడానికి కొన్ని తరగతులు మరియు లక్షణాలను ఉపయోగిస్తుంది:
.offcanvas
కంటెంట్ను దాచిపెడుతుంది.offcanvas.show
కంటెంట్ని చూపుతుంది.offcanvas-start
ఎడమవైపు ఆఫ్కాన్వాస్ను దాచిపెడుతుంది.offcanvas-end
కుడివైపు ఆఫ్కాన్వాస్ను దాచిపెడుతుంది.offcanvas-bottom
దిగువన ఆఫ్కాన్వాస్ను దాచిపెడుతుంది
data-bs-dismiss="offcanvas"
జావాస్క్రిప్ట్ ఫంక్షనాలిటీని ట్రిగ్గర్ చేసే లక్షణంతో డిస్మిస్ బటన్ను జోడించండి . <button>
అన్ని పరికరాలలో సరైన ప్రవర్తన కోసం దానితో ఎలిమెంట్ని ఉపయోగించాలని నిర్ధారించుకోండి .
డేటా లక్షణాల ద్వారా
ఒక ఆఫ్కాన్వాస్ మూలకం యొక్క నియంత్రణను స్వయంచాలకంగా కేటాయించడానికి మూలకానికి జోడించు data-bs-toggle="offcanvas"
మరియు ఒక data-bs-target
లేదా . href
ఆఫ్కాన్వాస్ను data-bs-target
వర్తింపజేయడానికి లక్షణం CSS సెలెక్టర్ను అంగీకరిస్తుంది. offcanvas
ఆఫ్కాన్వాస్ ఎలిమెంట్కు క్లాస్ని జోడించాలని నిర్ధారించుకోండి . మీరు దీన్ని డిఫాల్ట్గా తెరవాలనుకుంటే, అదనపు తరగతిని జోడించండి show
.
జావాస్క్రిప్ట్ ద్వారా
దీనితో మాన్యువల్గా ప్రారంభించండి:
var offcanvasElementList = [].slice.call(document.querySelectorAll('.offcanvas'))
var offcanvasList = offcanvasElementList.map(function (offcanvasEl) {
return new bootstrap.Offcanvas(offcanvasEl)
})
ఎంపికలు
ఎంపికలు డేటా లక్షణాలు లేదా జావాస్క్రిప్ట్ ద్వారా పంపబడతాయి. డేటా అట్రిబ్యూట్ల కోసం, ఎంపిక పేరును data-bs-
, లో వలె జత చేయండి data-bs-backdrop=""
.
పేరు | టైప్ చేయండి | డిఫాల్ట్ | వివరణ |
---|---|---|---|
backdrop |
బూలియన్ | true |
ఆఫ్కాన్వాస్ తెరిచి ఉన్నప్పుడు బాడీపై బ్యాక్డ్రాప్ను వర్తింపజేయండి |
keyboard |
బూలియన్ | true |
ఎస్కేప్ కీ నొక్కినప్పుడు ఆఫ్కాన్వాస్ను మూసివేస్తుంది |
scroll |
బూలియన్ | false |
ఆఫ్కాన్వాస్ తెరిచి ఉన్నప్పుడు బాడీ స్క్రోలింగ్ను అనుమతించండి |
పద్ధతులు
అసమకాలిక పద్ధతులు మరియు పరివర్తనాలు
అన్ని API పద్ధతులు అసమకాలికమైనవి మరియు పరివర్తనను ప్రారంభిస్తాయి . వారు పరివర్తన ప్రారంభమైన వెంటనే కానీ అది ముగిసేలోపు కాలర్ వద్దకు తిరిగి వస్తారు . అదనంగా, పరివర్తన భాగంపై పద్ధతి కాల్ విస్మరించబడుతుంది .
మరింత సమాచారం కోసం మా జావాస్క్రిప్ట్ డాక్యుమెంటేషన్ చూడండి .
మీ కంటెంట్ని ఆఫ్కాన్వాస్ ఎలిమెంట్గా యాక్టివేట్ చేస్తుంది. ఐచ్ఛిక ఎంపికలను అంగీకరిస్తుంది object
.
మీరు కన్స్ట్రక్టర్తో ఆఫ్కాన్వాస్ ఉదాహరణను సృష్టించవచ్చు, ఉదాహరణకు:
var myOffcanvas = document.getElementById('myOffcanvas')
var bsOffcanvas = new bootstrap.Offcanvas(myOffcanvas)
పద్ధతి | వివరణ |
---|---|
toggle |
ఆఫ్కాన్వాస్ మూలకాన్ని చూపడానికి లేదా దాచడానికి టోగుల్ చేస్తుంది. ఆఫ్కాన్వాస్ మూలకం వాస్తవంగా చూపబడటానికి లేదా దాచబడటానికి ముందు (అంటే shown.bs.offcanvas లేదా hidden.bs.offcanvas ఈవెంట్ జరగడానికి ముందు) కాలర్కి తిరిగి వస్తుంది. |
show |
ఆఫ్కాన్వాస్ మూలకాన్ని చూపుతుంది. ఆఫ్కాన్వాస్ మూలకం వాస్తవంగా చూపబడక ముందే కాలర్కి తిరిగి వస్తుంది (అంటే shown.bs.offcanvas ఈవెంట్ జరగడానికి ముందు). |
hide |
ఆఫ్కాన్వాస్ మూలకాన్ని దాచిపెడుతుంది. ఆఫ్కాన్వాస్ మూలకం వాస్తవంగా దాచబడకముందే (అంటే hidden.bs.offcanvas ఈవెంట్ జరగడానికి ముందు) కాలర్కి తిరిగి వస్తుంది. |
getInstance |
DOM మూలకంతో అనుబంధించబడిన ఆఫ్కాన్వాస్ ఉదాహరణను పొందడానికి మిమ్మల్ని అనుమతించే స్టాటిక్ పద్ధతి |
getOrCreateInstance |
DOM ఎలిమెంట్తో అనుబంధించబడిన ఆఫ్కాన్వాస్ ఉదాహరణను పొందడానికి మిమ్మల్ని అనుమతించే స్టాటిక్ మెథడ్ లేదా అది ప్రారంభించబడనట్లయితే కొత్తదాన్ని సృష్టించండి |
ఈవెంట్స్
బూట్స్ట్రాప్ యొక్క ఆఫ్కాన్వాస్ క్లాస్ ఆఫ్కాన్వాస్ ఫంక్షనాలిటీకి హుక్ చేయడానికి కొన్ని ఈవెంట్లను బహిర్గతం చేస్తుంది.
ఈవెంట్ రకం | వివరణ |
---|---|
show.bs.offcanvas |
ఇన్స్టెన్స్ మెథడ్ని పిలిచినప్పుడు ఈ ఈవెంట్ వెంటనే ఫైర్ అవుతుంది show . |
shown.bs.offcanvas |
ఆఫ్కాన్వాస్ మూలకం వినియోగదారుకు కనిపించినప్పుడు ఈ ఈవెంట్ తొలగించబడుతుంది (CSS పరివర్తనలు పూర్తయ్యే వరకు వేచి ఉంటుంది). |
hide.bs.offcanvas |
hide పద్ధతిని పిలిచినప్పుడు ఈ సంఘటన వెంటనే తొలగించబడుతుంది . |
hidden.bs.offcanvas |
వినియోగదారు నుండి ఆఫ్కాన్వాస్ మూలకం దాచబడినప్పుడు ఈ ఈవెంట్ తొలగించబడుతుంది (CSS పరివర్తనాలు పూర్తయ్యే వరకు వేచి ఉంటుంది). |
var myOffcanvas = document.getElementById('myOffcanvas')
myOffcanvas.addEventListener('hidden.bs.offcanvas', function () {
// do something...
})