Popovers

మీ సైట్‌లోని ఏదైనా ఎలిమెంట్‌కి iOSలో కనిపించేలా బూట్‌స్ట్రాప్ పాప్‌ఓవర్‌లను జోడించడానికి డాక్యుమెంటేషన్ మరియు ఉదాహరణలు.

అవలోకనం

పాప్‌ఓవర్ ప్లగ్‌ఇన్‌ని ఉపయోగిస్తున్నప్పుడు తెలుసుకోవలసిన విషయాలు:

• Popovers స్థానాల కోసం 3వ పార్టీ లైబ్రరీ Popper పై ఆధారపడతాయి . మీరు bootstrap.jsకి ముందు తప్పనిసరిగా popper.min.jsbootstrap.bundle.min.js ని చేర్చాలి లేదా popovers పని చేయడానికి Popperని కలిగి ఉన్న / ఉపయోగించాలి bootstrap.bundle.js!
• Popovers టూల్‌టిప్ ప్లగ్ఇన్ డిపెండెన్సీగా అవసరం.
• మీరు మూలం నుండి మా జావాస్క్రిప్ట్‌ని రూపొందిస్తున్నట్లయితే, దీనికి అవసరంutil.js .
• పనితీరు కారణాల దృష్ట్యా Popovers ఎంపిక చేయబడ్డాయి, కాబట్టి మీరు వాటిని మీరే ప్రారంభించాలి .
• జీరో-లెంగ్త్ titleమరియు contentవిలువలు ఎప్పటికీ పాప్‌ఓవర్‌ను చూపించవు.
• container: 'body'మరింత సంక్లిష్టమైన భాగాలలో (మా ఇన్‌పుట్ సమూహాలు, బటన్ సమూహాలు మొదలైనవి) రెండరింగ్ సమస్యలను నివారించడానికి పేర్కొనండి .
• దాచిన మూలకాలపై పాపోవర్‌లను ప్రేరేపించడం పని చేయదు.
• ర్యాపర్ ఎలిమెంట్‌పై పాపోవర్‌లు .disabledలేదా disabledఎలిమెంట్స్ తప్పనిసరిగా ట్రిగ్గర్ చేయబడాలి.
• బహుళ పంక్తులలో చుట్టబడిన యాంకర్‌ల నుండి ప్రేరేపించబడినప్పుడు, యాంకర్‌ల మొత్తం వెడల్పు మధ్య పాపోవర్‌లు కేంద్రీకృతమై ఉంటాయి. ఈ ప్రవర్తనను నివారించడానికి .text-nowrapమీ sలో ఉపయోగించండి .<a>
• DOM నుండి సంబంధిత మూలకాలను తీసివేయడానికి ముందు Popovers తప్పనిసరిగా దాచబడాలి.
• షాడో DOM లోపల ఉన్న మూలకం కారణంగా పాపోవర్‌లు ప్రేరేపించబడతాయి.

కొన్ని ఉదాహరణలతో పాపోవర్‌లు ఎలా పని చేస్తాయో చూడటానికి చదువుతూ ఉండండి.

ఉదాహరణ: ప్రతిచోటా పాపవర్‌లను ప్రారంభించండి

పేజీలోని అన్ని పాప్‌ఓవర్‌లను ప్రారంభించేందుకు ఒక మార్గం ఏమిటంటే, వాటిని వాటి data-toggleలక్షణం ద్వారా ఎంచుకోవడం:

$(function () {
  $('[data-toggle="popover"]').popover()
})

ఉదాహరణ: containerఎంపికను ఉపయోగించడం

మీరు పాప్‌ఓవర్‌కు ఆటంకం కలిగించే పేరెంట్ ఎలిమెంట్‌లో కొన్ని స్టైల్‌లను కలిగి ఉన్నప్పుడు, మీరు కస్టమ్‌ను పేర్కొనాలి, containerతద్వారా ఆ ఎలిమెంట్‌లో పాప్‌ఓవర్ యొక్క HTML కనిపిస్తుంది.

$(function () {
  $('.example-popover').popover({
    container: 'body'
  })
})

ఉదాహరణ

<button type="button" class="btn btn-lg btn-danger" data-toggle="popover" title="Popover title" data-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>

నాలుగు దిక్కులు

నాలుగు ఎంపికలు అందుబాటులో ఉన్నాయి: ఎగువ, కుడి, దిగువ మరియు ఎడమకు సమలేఖనం చేయబడింది.

<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="top" data-content="Top popover">
  Popover on top
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="right" data-content="Right popover">
  Popover on right
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Bottom popover">
  Popover on bottom
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="left" data-content="Left popover">
  Popover on left
</button>

తదుపరి క్లిక్‌లో తీసివేయండి

focusటోగుల్ ఎలిమెంట్ కాకుండా వేరొక మూలకం యొక్క వినియోగదారు తదుపరి క్లిక్‌లో పాప్‌ఓవర్‌లను తీసివేయడానికి ట్రిగ్గర్‌ను ఉపయోగించండి .

<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-toggle="popover" data-trigger="focus" title="Dismissible popover" data-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>

$('.popover-dismiss').popover({
  trigger: 'focus'
})

డిసేబుల్ ఎలిమెంట్స్

అట్రిబ్యూట్‌తో కూడిన ఎలిమెంట్‌లు disabledఇంటరాక్టివ్‌గా ఉండవు, అంటే వినియోగదారులు పాప్‌ఓవర్ (లేదా టూల్‌టిప్)ని ట్రిగ్గర్ చేయడానికి వాటిని హోవర్ చేయలేరు లేదా క్లిక్ చేయలేరు. ప్రత్యామ్నాయంగా, మీరు రేపర్ నుండి పాప్‌ఓవర్‌ని ట్రిగ్గర్ చేయాలనుకుంటున్నారు <div>లేదా డిసేబుల్ ఎలిమెంట్‌పై <span>ఓవర్‌రైడ్ చేయాలి .pointer-events

డిసేబుల్ పాప్‌ఓవర్ ట్రిగ్గర్‌ల కోసం, మీ యూజర్‌లు డిసేబుల్ ఎలిమెంట్‌పై క్లిక్data-trigger="hover" చేయాలని ఆశించనందున పాప్‌ఓవర్ తక్షణ దృశ్యమాన అభిప్రాయంగా కనిపించేలా మీరు కూడా ఇష్టపడవచ్చు.

<span class="d-inline-block" data-toggle="popover" data-content="Disabled popover">
  <button class="btn btn-primary" style="pointer-events: none;" type="button" disabled>Disabled button</button>
</span>

వాడుక

జావాస్క్రిప్ట్ ద్వారా పాపవర్‌లను ప్రారంభించండి:

$('#example').popover(options)

Popper.Defaults.modifiers.computeStyle.gpuAcceleration = !(window.devicePixelRatio < 1.5 && /Win/.test(navigator.platform))

ఎంపికలు

ఎంపికలు డేటా లక్షణాలు లేదా జావాస్క్రిప్ట్ ద్వారా పంపబడతాయి. డేటా అట్రిబ్యూట్‌ల కోసం, ఎంపిక పేరును data-, లో వలె జత చేయండి data-animation="".

పద్ధతులు

$().popover(options)

మూలకాల సేకరణ కోసం పాప్‌ఓవర్‌లను ప్రారంభిస్తుంది.

.popover('show')

మూలకం యొక్క పాప్‌ఓవర్‌ను వెల్లడిస్తుంది. పాప్‌ఓవర్ వాస్తవంగా చూపబడక ముందే (అంటే shown.bs.popoverఈవెంట్ జరగడానికి ముందు) కాలర్‌కి తిరిగి వస్తుంది. ఇది పాప్‌ఓవర్ యొక్క "మాన్యువల్" ట్రిగ్గర్‌గా పరిగణించబడుతుంది. టైటిల్ మరియు కంటెంట్ రెండూ సున్నా-పొడవు ఉన్న పాపవర్‌లు ఎప్పుడూ ప్రదర్శించబడవు.

$('#element').popover('show')

.popover('hide')

మూలకం యొక్క పాప్‌ఓవర్‌ను దాచిపెడుతుంది. పాప్‌ఓవర్ వాస్తవంగా దాచబడక ముందే (అంటే hidden.bs.popoverఈవెంట్ జరగడానికి ముందు) కాలర్‌కి తిరిగి వస్తుంది. ఇది పాప్‌ఓవర్ యొక్క "మాన్యువల్" ట్రిగ్గర్‌గా పరిగణించబడుతుంది.

$('#element').popover('hide')

.popover('toggle')

మూలకం యొక్క పాప్‌ఓవర్‌ను టోగుల్ చేస్తుంది. పాప్‌ఓవర్ వాస్తవంగా చూపబడటానికి లేదా దాచబడటానికి ముందు కాలర్‌కి తిరిగి వస్తుంది (అంటే shown.bs.popoverలేదా hidden.bs.popoverసంఘటన జరగడానికి ముందు). ఇది పాప్‌ఓవర్ యొక్క "మాన్యువల్" ట్రిగ్గర్‌గా పరిగణించబడుతుంది.

$('#element').popover('toggle')

.popover('dispose')

మూలకం యొక్క పాప్‌ఓవర్‌ను దాచి, నాశనం చేస్తుంది. డెలిగేషన్‌ను ఉపయోగించే పాపోవర్‌లు (అవి ఎంపికను ఉపయోగించి సృష్టించబడతాయి ) selectorడిసెండెంట్ ట్రిగ్గర్ మూలకాలపై వ్యక్తిగతంగా నాశనం చేయబడవు.

$('#element').popover('dispose')

.popover('enable')

మూలకం యొక్క పాప్‌ఓవర్‌కు చూపబడే సామర్థ్యాన్ని అందిస్తుంది. Popovers డిఫాల్ట్‌గా ప్రారంభించబడ్డాయి.

$('#element').popover('enable')

.popover('disable')

ఎలిమెంట్ యొక్క పాప్‌ఓవర్ చూపబడే సామర్థ్యాన్ని తొలగిస్తుంది. పాప్‌ఓవర్ మళ్లీ ప్రారంభించబడితే మాత్రమే చూపబడుతుంది.

$('#element').popover('disable')

.popover('toggleEnabled')

మూలకం యొక్క పాప్‌ఓవర్ చూపబడే లేదా దాచబడే సామర్థ్యాన్ని టోగుల్ చేస్తుంది.

$('#element').popover('toggleEnabled')

.popover('update')

మూలకం యొక్క పాప్‌ఓవర్ స్థానాన్ని నవీకరిస్తుంది.

$('#element').popover('update')

ఈవెంట్స్

$('#myPopover').on('hidden.bs.popover', function () {
  // do something...
})