ప్రధాన కంటెంట్‌కి దాటవేయి డాక్స్ నావిగేషన్‌కు దాటవేయి
in English

ఆఫ్కాన్వాస్

కొన్ని తరగతులు మరియు మా 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"ఇది అవసరం.

hrefతో లింక్ చేయండి
ఆఫ్కాన్వాస్
ప్లేస్‌హోల్డర్‌గా కొంత వచనం. నిజ జీవితంలో మీరు ఎంచుకున్న అంశాలను కలిగి ఉండవచ్చు. ఇష్టం, వచనం, చిత్రాలు, జాబితాలు మొదలైనవి.
<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...
})