ፖፖቨርስ
በiOS ውስጥ እንዳሉት የBootstrap popovers በጣቢያዎ ላይ ወዳለ ማንኛውም አካል ለመጨመር ሰነዶች እና ምሳሌዎች።
አጠቃላይ እይታ
የፖፖቨር ፕለጊን ሲጠቀሙ ማወቅ ያለባቸው ነገሮች፡-
- ፖፖቨር ለቦታ አቀማመጥ በ 3 ኛ ወገን ቤተ-መጽሐፍት ፖፐር ላይ ይተማመናሉ ።
bootstrap.bundle.min.js
bootstrap.bundle.js
- ፖፖቨርስ እንደ ጥገኝነት የመሳሪያ ቲፕ ፕለጊን ያስፈልገዋል።
- የእኛን ጃቫ ስክሪፕት ከምንጩ እየገነቡ ከሆነ ያስፈልገዋል
util.js
። - ፖፖቨር በአፈጻጸም ምክንያቶች መርጠው የገቡ ናቸው፣ ስለዚህ እርስዎ እራስዎ ማስጀመር አለብዎት ።
- ዜሮ-ርዝመት
title
እናcontent
እሴቶች መቼም ብቅ-ባይ አያሳዩም። container: 'body'
ይበልጥ ውስብስብ በሆኑ ክፍሎች (እንደ የግቤት ቡድኖቻችን፣ የአዝራር ቡድኖች፣ ወዘተ) ያሉ ችግሮችን ከመስጠት ለመዳን ይግለጹ ።- በተደበቁ አካላት ላይ ብቅ-ባይ ማነሳሳት አይሰራም።
- ፖፖቨርስ
.disabled
ወይምdisabled
ኤለመንቶች በአንድ ጥቅል አካል ላይ መቀስቀስ አለባቸው። - በበርካታ መስመሮች ላይ የሚጠቅሱ መልሕቆች ከተነሳ ፖፖዎች በአንደኛ ደረጃ አጠቃላይ ስፋት መካከል ማዕከላዊ ይሆናል. ይህንን ባህሪ ለማስወገድ
.text-nowrap
በእርስዎ s ላይ ይጠቀሙ ።<a>
- ፖፖቨር ተጓዳኝ ክፍሎቻቸው ከDOM ከመወገዳቸው በፊት መደበቅ አለባቸው።
- በጥላ DOM ውስጥ ላለ አካል ምስጋና ይግባው ፖፖቨርስ ሊነቃ ይችላል።
prefers-reduced-motion
በመገናኛ ብዙሃን ጥያቄ ላይ የተመሰረተ ነው. የእኛን የተደራሽነት ሰነድ የተቀነሰውን እንቅስቃሴ ክፍል ይመልከቱ
።
ብቅ-ባይ ከአንዳንድ ምሳሌዎች ጋር እንዴት እንደሚሰራ ለማየት ማንበብዎን ይቀጥሉ።
ምሳሌ፡ በሁሉም ቦታ ብቅ-ባይን ያንቁ
በአንድ ገጽ ላይ ሁሉንም ብቅ-ባዮችን የማስጀመር አንዱ መንገድ እነሱን በባህሪያቸው መምረጥ data-toggle
ነው፡-
$(function () {
$('[data-toggle="popover"]').popover()
})
ምሳሌ container
፡ አማራጩን መጠቀም
ብቅ-ባይን የሚያስተጓጉሉ አንዳንድ የወላጅ ኤለመንት ቅጦች ሲኖርዎት፣ container
በምትኩ የፖፖቨር ኤችቲኤምኤል በዚያ አካል ውስጥ እንዲታይ ብጁ መግለጽ ያስፈልግዎታል።
$(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>
እና እንዲሁም<button>
ባህሪን ማካተት አለብዎት tabindex
።
<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)
የጂፒዩ ማፋጠን
በጂፒዩ ማጣደፍ እና በተሻሻለው ዲፒአይ ምክንያት ፖፖቨር በዊንዶውስ 10 መሳሪያዎች ላይ አንዳንድ ጊዜ ብዥታ ይታያል። ለዚህ በv4 ውስጥ ያለው መፍትሔ በእርስዎ ፖፖቨርስ ላይ እንደ አስፈላጊነቱ የጂፒዩ ማጣደፍን ማሰናከል ነው።
የሚመከር ጥገና፡-
Popper.Defaults.modifiers.computeStyle.gpuAcceleration = !(window.devicePixelRatio < 1.5 && /Win/.test(navigator.platform))
ፖፖቨር ለቁልፍ ሰሌዳ እና አጋዥ ቴክኖሎጂ ተጠቃሚዎች እንዲሰራ ማድረግ
የቁልፍ ሰሌዳ ተጠቃሚዎች የእርስዎን ፖፖቨር እንዲያነቁ ለማድረግ፣ ወደ ኤችቲኤምኤል አባላት ማከል ያለብዎት በተለምዶ በቁልፍ ሰሌዳ-ተኮር እና በይነተገናኝ (እንደ ማገናኛዎች ወይም የቅጽ መቆጣጠሪያዎች)። ምንም እንኳን የዘፈቀደ የኤችቲኤምኤል ኤለመንቶች (እንደ <span>
ዎች) ባህሪውን በማከል ትኩረት እን���ደረግ ማድረግ ቢቻልም tabindex="0"
፣ ይህ ምናልባት ለቁልፍ ሰሌዳ ተጠቃሚዎች መስተጋብራዊ ባልሆኑ አካላት ላይ የሚያበሳጭ እና ግራ የሚያጋቡ የትር ማቆሚያዎችን ይጨምራል፣ እና አብዛኛዎቹ አጋዥ ቴክኖሎጂዎች በአሁኑ ጊዜ በዚህ ሁኔታ ውስጥ የፖፖቨርን ይዘት አያስተዋውቁም። . በተጨማሪም፣ hover
ለፖፖቨርዎ ቀስቅሴ ብቻ አትመኑ፣ ይህ ደግሞ ለቁልፍ ሰሌዳ ተጠቃሚዎች መቀስቀስ እንዳይችሉ ያደርጋቸዋል።
የበለጸገ፣ የተዋቀረ HTML በፖፖቨርስ ውስጥ ከአማራጩ ጋር ማስገባት ቢችሉም፣ html
ከመጠን በላይ የሆነ ይዘት ከመጨመር እንዲቆጠቡ አበክረን እንመክራለን። በአሁኑ ጊዜ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ብቅ ማለት ነው aria-describedby
. በዚህ ምክንያት የፖፖቨር ይዘቱ ሙሉ በሙሉ ለረዳት ቴክኖሎጂ ተጠቃሚዎች እንደ አንድ ረጅም እና ያልተቋረጠ ዥረት ይገለጻል።
በተጨማሪም፣ በፖፖቨርዎ ውስጥ በይነተገናኝ መቆጣጠሪያዎችን (እንደ ቅጽ ኤለመንቶች ወይም አገናኞች ያሉ) ማካተት ቢቻልም (እነዚህን ንጥረ ነገሮች ወደ whiteList
ወይም የተፈቀዱ ባህሪያት እና መለያዎች በማከል) በአሁኑ ጊዜ ብቅ-over የቁልፍ ሰሌዳ የትኩረት ቅደም ተከተልን እንደማያስተዳድር ይወቁ። የቁልፍ ሰሌዳ ተጠቃሚ ፖፖቨርን ሲከፍት ትኩረቱ ቀስቅሴው አካል ላይ ነው፣ እና ፖፖቨር አብዛኛውን ጊዜ በሰነዱ መዋቅር ውስጥ ያለውን ቀስቅሴ ስለማይከተል፣ ወደፊት ለመራመዱ/ለመጫኑ ምንም ዋስትና የለም።TABየቁልፍ ሰሌዳ ተጠቃሚን ራሱ ወደ ፖፖቨር ያንቀሳቅሰዋል። በአጭሩ፣ በቀላሉ በይነተገናኝ መቆጣጠሪያዎችን ወደ ፖፖቨር ማከል እነዚህ መቆጣጠሪያዎች ለቁልፍ ሰሌዳ ተጠቃሚዎች እና አጋዥ ቴክኖሎጂዎች ተጠቃሚዎች የማይደረስ/የማይጠቀሙ ያደርጋቸዋል ወይም ቢያንስ አመክንዮአዊ ያልሆነ አጠቃላይ የትኩረት ቅደም ተከተል እንዲፈጠር ያደርጋል። በእነዚህ አጋጣሚዎች በምትኩ የሞዳል ንግግር መጠቀም ያስቡበት።
አማራጮች
አማራጮች በመረጃ ባህሪያት ወይም በጃቫስክሪፕት ሊተላለፉ ይችላሉ. ለውሂብ ባህሪያት፣ data-
እንደ ውስጥ ያለውን የአማራጭ ስም ወደ ላይ ጨምር data-animation=""
።
sanitize
,
sanitizeFn
እና
whiteList
አማራጮች የውሂብ ባህሪያትን በመጠቀም ሊቀርቡ እንደማይችሉ ልብ ይበሉ.
ስም | ዓይነት | ነባሪ | መግለጫ |
---|---|---|---|
አኒሜሽን | ቡሊያን | እውነት ነው። | የ CSS ደብዝዝ ሽግግር ወደ ፖፖቨር ይተግብሩ |
መያዣ | ሕብረቁምፊ | ኤለመንት | የውሸት | የውሸት | ፖፖውን ከአንድ የተወሰነ አካል ጋር ያያይዘዋል። ምሳሌ |
ይዘት | ሕብረቁምፊ | ኤለመንት | ተግባር | '' | ባህሪው ከሌለ ነባሪ የይዘት ዋጋ አንድ ተግባር ከተሰጠ |
መዘግየት | ቁጥር | ነገር | 0 | Pooover (MSON) መደበቅ እና መደበቅ - ለትላልቅ የመርከብ አይነት አይተገበርም ቁጥር ከቀረበ፣ መዘግየት በሁለቱም መደበቅ/ማሳየት ላይ ይተገበራል። የእቃው መዋቅር የሚከተለው ነው- |
html | ቡሊያን | የውሸት | ኤችቲኤምኤልን ወደ ፖፖቨር አስገባ። ውሸት ከሆነ፣ የjQuery text ዘዴ ይዘትን ወደ DOM ለማስገባት ስራ ላይ ይውላል። ስለ XSS ጥቃቶች የሚጨነቁ ከሆነ ጽሑፍ ይጠቀሙ። |
አቀማመጥ | ሕብረቁምፊ | ተግባር | 'ቀኝ' | ፖፖቨርን እንዴት ማስቀመጥ እንደሚቻል - ራስ-ሰር | ከላይ | የታችኛው | ግራ | ቀኝ. አንድ ተግባር ቦታውን ለመወሰን ጥቅም ላይ በሚውልበት ጊዜ በፖፖቨር DOM ኖድ እንደ መጀመሪያው ክርክር እና ቀስቃሽ ኤለመንት DOM ኖድ እንደ ሁለተኛው ይባላል። |
መራጭ | ሕብረቁምፊ | የውሸት | የውሸት | መራጭ ከተሰጠ፣ ብቅ ያሉ ነገሮች ለተገለጹት ኢላማዎች ይላካሉ። በተግባር፣ ይህ ተለዋዋጭ የኤችቲኤምኤል ይዘት ብቅ-ባይ ታክሏል እንዲኖረው ለማድረግ ይጠቅማል። ይህንን እና ጠቃሚ ምሳሌ ይመልከቱ ። |
አብነት | ሕብረቁምፊ | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
ብቅ-ባይ ሲፈጥሩ ለመጠቀም ኤችቲኤምኤልን መሠረት ያድርጉ። ፖፖቨርስ ፖፖቨርስ
በጣም ውጫዊው የመጠቅለያ አካል ክፍሉ ሊኖረው ይገባል |
ርዕስ | ሕብረቁምፊ | ኤለመንት | ተግባር | '' | ባህሪው ከሌለ ነባሪ የርዕስ ዋጋ አንድ ተግባር ከተሰጠ |
ቀስቅሴ | ሕብረቁምፊ | 'ጠቅ አድርግ' | ብቅ-ባይ እንዴት እንደሚቀሰቀስ - ጠቅ ያድርጉ | ማንዣበብ | ትኩረት | መመሪያ. ብዙ ቀስቅሴዎችን ማለፍ ይችላሉ; ከቦታ ጋር ይለያዩዋቸው. manual ከማንኛውም ሌላ ቀስቅሴ ጋር ሊጣመር አይችልም. |
ማካካሻ | ቁጥር | ሕብረቁምፊ | 0 | ከዒላማው አንጻር የፖፖቨር ማካካሻ። ለበለጠ መረጃ የፖፐር ማካካሻ ሰነዶችን ይመልከቱ ። |
fallbackPlacement | ሕብረቁምፊ | ድርድር | 'ግልብጥ' | ፖፐር በመውደቅ ላይ የትኛውን ቦታ እንደሚጠቀም እንዲገልጽ ፍቀድ። ለበለጠ መረጃ የፖፐር ባህሪ ሰነዶችን ይመልከቱ |
ብጁ ክፍል | ሕብረቁምፊ | ተግባር | '' | በሚታይበት ጊዜ ክፍሎችን ወደ ፖፖቨር ያክሉ። እነዚህ ክፍሎች በአብነት ውስጥ ከተገለጹት ክፍሎች በተጨማሪ እንደሚጨመሩ ልብ ይበሉ። ብዙ ክፍሎችን ለመጨመር በክፍተቶች ይለያቸዋል እንዲሁም ተጨማሪ የክፍል ስሞችን የያዘ ነጠላ ሕብረቁምፊ መመለስ ያለበትን ተግባር ማለፍ ይችላሉ። |
ወሰን | ሕብረቁምፊ | ኤለመንት | 'ማሸብለል ወላጅ' | የፖፑቨር ከመጠን ያለፈ ገደብ ገደብ። 'viewport' የ , 'window' , 'scrollParent' , ወይም HTMLElement ማጣቀሻ (ጃቫስክሪፕት ብቻ) እሴቶችን ይቀበላል . ለበለጠ መረጃ የፖፐርን ከመጠን በላይ ፍሰትን የሚከላከሉ ሰነዶችን ይመልከቱ ። |
ማጽዳት | ቡሊያን | እውነት ነው። | ንጽህናን አንቃ ወይም አሰናክል። ከነቃ 'template' እና አማራጮች ይጸዳሉ 'content' ። በእኛ ጃቫስክሪፕት ሰነድ ውስጥ የንፅህና መጠበቂያ ክፍልን'title' ይመልከቱ ። |
ነጭ ዝርዝር | ነገር | ነባሪ እሴት | የተፈቀዱ ባህሪያትን እና መለያዎችን የያዘ ነገር |
sanitizeFn | ባዶ | ተግባር | ባዶ | እዚህ የራስዎን የንፅህና አገልግሎት መስጠት ይችላሉ. የንፅህና አጠባበቅን ለማከናወን የተለየ ቤተ-መጽሐፍት ለመጠቀም ከመረጡ ይህ ጠቃሚ ሊሆን ይችላል። |
popperConfig | ባዶ | ነገር | ባዶ | የ Bootstrapን ነባሪ የፖፐር ውቅረት ለመቀየር የፖፐርን አወቃቀር ይመልከቱ |
ለግለሰብ ብቅ-ባዮች የውሂብ ባህሪዎች
ከላይ እንደተገለፀው ለግለሰብ ብቅ-ባይ አማራጮች በአማራጭ የውሂብ ባህሪያትን በመጠቀም ሊገለጹ ይችላሉ።
ዘዴዎች
ያልተመሳሰሉ ዘዴዎች እና ሽግግሮች
ሁሉም የኤፒአይ ዘዴዎች ያልተመሳሰሉ ናቸው እና ሽግግር ይጀምራሉ ። ሽግግሩ እንደተጀመረ ግን ከማለቁ በፊት ወደ ደዋዩ ይመለሳሉ ። በተጨማሪም, በመሸጋገሪያ አካል ላይ የሚደረግ ዘዴ ጥሪ ችላ ይባላል .
$().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')
የአንድ ንጥረ ነገር ብቅ-ባይ የመታየት ችሎታን ይሰጣል። ፖፖቨር በነባሪነት ነቅቷል።
$('#element').popover('enable')
.popover('disable')
የአንድ ንጥረ ነገር ብቅ-ባይ የመታየት ችሎታን ያስወግዳል። ብቅ-ባይ መታየት የሚቻለው እንደገና ከነቃ ብቻ ነው።
$('#element').popover('disable')
.popover('toggleEnabled')
የአንድ ንጥረ ነገር ብቅ-ባይ የመታየት ወይም የመደበቅ ችሎታን ይቀያይራል።
$('#element').popover('toggleEnabled')
.popover('update')
የአንድ ንጥረ ነገር ብቅ-ባይ ቦታን ያዘምናል።
$('#element').popover('update')
ክስተቶች
የክስተት አይነት | መግለጫ |
---|---|
አሳይ.bs.popover | show የምሳሌው ዘዴ ሲጠራ ይህ ክስተት ወዲያውኑ ይቃጠላል . |
የሚታየው.bs.popover | ይህ ክስተት የሚቀጣጠለው ብቅ-ባይ ለተጠቃሚው እንዲታይ ሲደረግ ነው (የ CSS ሽግግሮች እስኪጠናቀቁ ድረስ ይጠብቃል)። |
ደብቅ.bs.popover | hide የምሳሌው ዘዴ ሲጠራ ይህ ክስተት ወዲያውኑ ይቃጠላል . |
የተደበቀ.bs.popover | ይህ ክስተት የሚቀጣጠለው ብቅ-ባይ ከተጠቃሚው ተደብቆ ሲያልቅ ነው (የ CSS ሽግግሮች እስኪጠናቀቁ ድረስ ይጠብቃል)። |
ገብቷል.bs.popover | show.bs.popover የፖፖቨር አብነት ወደ DOM ከተጨመረ ይህ ክስተት ከክስተቱ በኋላ ተቃጥሏል። |
$('#myPopover').on('hidden.bs.popover', function () {
// do something...
})