Sourceመውረድ
የአገናኞች ዝርዝሮችን እና ሌሎችንም በBootstrap ተቆልቋይ ተሰኪ ለማሳየት አውድ ተደራቢዎችን ቀይር።
አጠቃላይ እይታ
ተቆልቋይዎች ሊቀያየሩ የሚችሉ፣ የአገናኞች ዝርዝሮችን ለማሳየት አውድ ተደራቢዎች እና ሌሎችም። ከተካተቱት የቡትስትራፕ ተቆልቋይ ጃቫ ስክሪፕት ተሰኪ ጋር መስተጋብራዊ እንዲሆኑ ተደርገዋል። እነሱ በማንዣበብ ሳይሆን ጠቅ በማድረግ ይቀየራሉ; ይህ ሆን ተብሎ የተደረገ የንድፍ ውሳኔ ነው.
ተቆልቋይዎች በሶስተኛ ወገን ቤተ-መጽሐፍት, Popper.js ላይ የተገነቡ ናቸው , ይህም ተለዋዋጭ አቀማመጥ እና የመመልከቻ ፍለጋን ያቀርባል. ከ Bootstrap ጃቫ ስክሪፕት በፊት popper.min.js ን ማካተትዎን ያረጋግጡ bootstrap.bundle.min.js
ወይም bootstrap.bundle.js
ፖፐር.js የያዘውን ይጠቀሙ። ምንም እንኳን ተለዋዋጭ አቀማመጥ የማያስፈልግ በመሆኑ Popper.js ተቆልቋይ ቦታዎችን በ navbars ውስጥ ለማስቀመጥ አያገለግልም።
የእኛን ጃቫ ስክሪፕት ከምንጩ እየገነቡ ከሆነ ያስፈልገዋልutil.js
።
ተደራሽነት
የ WAI ARIA ስታንዳርድ ትክክለኛ role="menu"
መግብርን ይገልፃል ፣ ነገር ግን ይህ ተግባርን ወይም ተግባርን ለሚቀሰቅሱ እንደ መተግበሪያ ላሉ ምናሌዎች የተወሰነ ነው። የ ARIA ሜኑዎች የምናሌ ንጥሎችን፣ የአመልካች ሳጥን ሜኑ ንጥሎችን፣ የሬዲዮ አዝራሮችን የምናሌ ንጥሎችን፣ የሬዲዮ አዝራር ቡድኖችን እና ንዑስ-ምናሌዎችን ብቻ ነው መያዝ የሚችሉት።
በሌላ በኩል የቡትስትራፕ ተቆልቋይ ቦታዎች ሁሉን አቀፍ እና ለተለያዩ ሁኔታዎች እና የማርክ መስጫ መዋቅሮች ተፈጻሚ እንዲሆኑ የተነደፉ ናቸው። ለምሳሌ፣ ተጨማሪ ግብዓቶችን የያዙ ተቆልቋይዎችን መፍጠር እና እንደ የፍለጋ መስኮች ወይም የመግቢያ ቅጾች ያሉ የቅጽ መቆጣጠሪያዎችን መፍጠር ይቻላል። በዚህ ምክንያት, Bootstrap ለእውነተኛ ARIA ምናሌዎች የሚያስፈልጉትን ማንኛውንም role
ባህሪያት አይጠብቅም (ወይም በራስ-ሰር አይጨምርም) ። ደራሲዎች እነዚህን የበለጠ ልዩ ባህሪያትን ራሳቸው ማካተት አለባቸው።aria-
ሆኖም ቡትስትራፕ አብሮ የተሰራ ድጋፍን ለአብዛኛዎቹ መደበኛ የቁልፍ ሰሌዳ ምናሌ መስተጋብር ይጨምራል፣ ለምሳሌ .dropdown-item
የጠቋሚ ቁልፎችን በመጠቀም በተናጥል አካላት ውስጥ የመንቀሳቀስ ችሎታ እና ሜኑውን ESCበቁልፍ መዝጋት።
ምሳሌዎች
የተቆልቋይ መቀያየርን (የእርስዎን አዝራር ወይም ማገናኛ) እና ተቆልቋይ ሜኑን በ ውስጥ .dropdown
፣ ወይም ሌላ የሚያውጅውን አካል ጠቅልል position: relative;
። የእርስዎን እምቅ ፍላጎቶች በተሻለ ለማስማማት ተቆልቋይ ከ <a>
ወይም ንጥረ ነገሮች ሊነሳ ይችላል ።<button>
ማንኛውም ነጠላ .btn
ከአንዳንድ የማርክ ማድረጊያ ለውጦች ጋር ወደ ተቆልቋይ መቀየሪያ ሊቀየር ይችላል። <button>
ከሁለቱም ንጥረ ነገሮች ጋር እንዲሰሩ እንዴት እንደሚያስቀምጧቸው እነሆ ፡-
እና <a>
ከንጥረ ነገሮች ጋር:
በጣም ጥሩው ክፍል ይህንን በማንኛውም የአዝራር ልዩነት ማድረግ ይችላሉ፡
በተመሳሳይ፣ የተከፈለ አዝራር ተቆልቋይዎችን ይፍጠሩ እንደ ነጠላ የአዝራር ተቆልቋይዎች ተመሳሳይ ምልክት ያደረጉ፣ ነገር ግን .dropdown-toggle-split
በተቆልቋይ ተንከባካቢው ዙሪያ ለትክክለኛ ክፍተት በማከል።
ይህንን ተጨማሪ ክፍል padding
በመንከባከቢያው በሁለቱም በኩል ያለውን አግድም በ25% ለመቀነስ እና margin-left
ለመደበኛ የአዝራሮች ተቆልቋይዎች የተጨመረውን ለማስወገድ እንጠቀማለን። እነዚያ ተጨማሪ ለውጦች ተንከባካቢው በተከፋፈለው ቁልፍ ላይ ያተኩሩታል እና ከዋናው ቁልፍ ቀጥሎ ያለውን ትክክለኛ መጠን ያለው የተመታ ቦታ ያቅርቡ።
መጠናቸው
የአዝራር ተቆልቋይዎች ነባሪ እና የተከፋፈሉ ተቆልቋይ አዝራሮችን ጨምሮ ከሁሉም መጠኖች አዝራሮች ጋር ይሰራሉ።
አቅጣጫዎች
መጣል
.dropup
ወደ ወላጅ ኤለመንት በማከል የተቆልቋይ ምናሌዎችን ከንጥረ ነገሮች በላይ ያስነሱ ።
ተቆልቋይ
.dropright
ወደ ወላጅ ኤለመንት በማከል በንጥረ ነገሮች በስተቀኝ ያሉ ተቆልቋይ ምናሌዎችን ያስነሱ ።
መውደቅ
.dropleft
ወደ ወላጅ ኤለመንት በማከል ከንጥረ ነገሮች በስተግራ ተቆልቋይ ምናሌዎችን ያስነሱ ።
በታሪክ ተቆልቋይ ምናሌ ይዘቶች አገናኞች መሆን ነበረባቸው ፣ ነገር ግን ይህ ከአሁን በኋላ v4 አይደለም። አሁን ከ s <button>
ይልቅ በተቆልቋይዎ ውስጥ እንደ አማራጭ አባሎችን መጠቀም ይችላሉ።<a>
እንዲሁም በይነተገናኝ ያልሆኑ ተቆልቋይ ንጥሎችን መፍጠር ይችላሉ .dropdown-item-text
። በብጁ CSS ወይም የጽሑፍ መገልገያዎች የበለጠ ቅጥ ለማድረግ ነፃነት ይሰማዎ።
ንቁ
እንደ ገባሪ ቅጥ ለማድረግ.active
በተቆልቋዩ ውስጥ ወደ ንጥሎች ያክሉ ።
ተሰናክሏል።
እንደ ተሰናክለው.disabled
ለመምሰል በተቆልቋዩ ውስጥ ወደ ንጥሎች ያክሉ ።
በነባሪ፣ ተቆልቋይ ሜኑ በቀጥታ 100% ከላይ እና በወላጁ በግራ በኩል ይቀመጣል። የተቆልቋይ ምናሌውን .dropdown-menu-right
ወደ .dropdown-menu
ቀኝ አሰላለፍ።
ቀና በል! ለፖpper.js ምስጋና ይግባውና ተቆልቋይ ተቀምጧል (በናቭባር ውስጥ ከተካተቱት በስተቀር)።
ምላሽ ሰጪ አሰላለፍ
ምላሽ ሰጪ አሰላለፍ ለመጠቀም ከፈለጉ ባህሪውን በማከል ተለዋዋጭ አቀማመጥን ያሰናክሉ data-display="static"
እና ምላሽ ሰጪ ልዩነቶች ክፍሎችን ይጠቀሙ።
የተቆልቋይ ምናሌውን ከተሰጠው መግቻ ነጥብ ወይም የበለጠ ጋር ለማቀናጀት ፣ ያክሉ .dropdown-menu{-sm|-md|-lg|-xl}-right
።
የግራ ተቆልቋይ ምናሌውን ከተሰጠው መግቻ ነጥብ ወይም የበለጠ ለማሰለፍ ፣ ያክሉ .dropdown-menu-right
እና .dropdown-menu{-sm|-md|-lg|-xl}-left
.
data-display="static"
Popper.js በ navbars ውስጥ ስለማይጠቀም በ navbars ውስጥ በተቆልቋይ አዝራሮች ላይ ባህሪ ማከል እንደማያስፈልግዎ ልብ ይበሉ ።
በማንኛውም ተቆልቋይ ሜኑ ውስጥ ያሉትን የእርምጃዎች ክፍሎች ለመሰየም ርዕስ ያክሉ።
አከፋፋዮች
ተዛማጅ የምናሌ ንጥሎች ቡድኖች ከአከፋፋይ ጋር።
ጽሑፍ
ማንኛውንም የፍሪፎርም ጽሑፍ በተቆልቋይ ምናሌ ውስጥ ከጽሑፍ ጋር ያስቀምጡ እና የቦታ መገልገያዎችን ይጠቀሙ ። የምናሌውን ስፋት ለመገደብ ተጨማሪ የመጠን ዘይቤዎች እንደሚያስፈልጉዎት ልብ ይበሉ።
ቅጽ በተቆልቋይ ሜኑ ውስጥ ያስቀምጡ ወይም በተቆልቋይ ሜኑ ውስጥ ያድርጉት እና የሚፈልጉትን አሉታዊ ቦታ ለመስጠት ህዳግ ወይም ፓዲንግ መገልገያዎችን ይጠቀሙ።
የማውረድ አማራጮች
የተቆልቋዩ ቦታን ይጠቀሙ data-offset
ወይም data-reference
ለመቀየር።
አጠቃቀም
በመረጃ ባህሪያት ወይም ጃቫስክሪፕት በኩል ተቆልቋይ ተሰኪው የተደበቀ ይዘትን (የተቆልቋይ ምናሌዎችን) .show
በወላጅ ዝርዝር ንጥል ላይ ያለውን ክፍል በመቀያየር ይቀየራል። ባህሪው data-toggle="dropdown"
በመተግበሪያ ደረጃ ተቆልቋይ ምናሌዎችን ለመዝጋት የታመነ ነው፣ ስለዚህ ሁልጊዜ እሱን መጠቀም ጥሩ ነው።
በንክኪ የነቁ መሣሪያዎች ላይ፣ ተቆልቋይ መክፈት ባዶ ( $.noop
) mouseover
ተቆጣጣሪዎችን ለኤለመንቱ የቅርብ ልጆች ይጨምራል <body>
። ይህ ተቀባይነት ያለው አስቀያሚ ጠለፋ በ iOS' ክስተት ውክልና ዙሪያ ለመስራት አስፈላጊ ነው ፣ ይህ ካልሆነ ግን ከተቆልቋዩ ውጭ የትኛውም ቦታ መታ ተቆልቋይ የሚዘጋውን ኮድ እንዳያነሳሳ ይከላከላል። አንዴ ተቆልቋዩ ከተዘጋ፣ እነዚህ ተጨማሪ ባዶ mouseover
ተቆጣጣሪዎች ይወገዳሉ።
በውሂብ ባህሪያት በኩል
data-toggle="dropdown"
ተቆልቋይ ለመቀየር ወደ አገናኝ ወይም አዝራር ያክሉ ።
በጃቫስክሪፕት በኩል
ተቆልቋዮቹን በጃቫስክሪፕት ይደውሉ፡-
data-toggle="dropdown"
አሁንም ያስፈልጋል
ተቆልቋይዎን በጃቫ ስክሪፕት ቢደውሉም ሆነ በምትኩ ዳታ-ኤፒውን ቢጠቀሙ data-toggle="dropdown"
ሁል ጊዜ በተቆልቋዩ ቀስቅሴ ክፍል ላይ መገኘት አለባቸው።
አማራጮች
አማራጮች በመረጃ ባህሪያት ወይም በጃቫስክሪፕት ሊተላለፉ ይችላሉ. ለውሂብ ባህሪያት፣ data-
እንደ ውስጥ ያለውን የአማራጭ ስም ወደ ላይ ጨምር data-offset=""
።
ስም |
ዓይነት |
ነባሪ |
መግለጫ |
ማካካሻ |
ቁጥር | ሕብረቁምፊ | ተግባር |
0 |
ከዒላማው አንጻር የተቆልቋዩ ማካካሻ። አንድ ተግባር ማካካሻውን ለመወሰን ጥቅም ላይ ሲውል የማካካሻ ውሂቡን ከያዘው ዕቃ ጋር እንደ መጀመሪያው መከራከሪያ ይባላል። ተግባሩ አንድ አይነት መዋቅር ያለው ነገር መመለስ አለበት. ቀስቃሽ ኤለመንት DOM ኖድ እንደ ሁለተኛው ነጋሪ እሴት ተላልፏል። ለበለጠ መረጃ የPopper.js ማካካሻ ሰነዶችን ይመልከቱ ። |
መገልበጥ |
ቡሊያን |
እውነት ነው። |
በማጣቀሻው አካል ላይ ተደራራቢ ከሆነ ተቆልቋይ እንዲገለበጥ ፍቀድ። ለበለጠ መረጃ የPopper.js's Flip Docs ይመልከቱ ። |
ወሰን |
ሕብረቁምፊ | ኤለመንት |
'ማሸብለል ወላጅ' |
የተቆልቋይ ምናሌው የትርፍ ፍሰት ገደብ ወሰን። 'viewport' የ , 'window' , 'scrollParent' , ወይም HTMLElement ማጣቀሻ (ጃቫስክሪፕት ብቻ) እሴቶችን ይቀበላል . ለበለጠ መረጃ የPopper.jsን ከመጠን ያለፈ ፍሰትን ይመልከቱ ። |
ማጣቀሻ |
ሕብረቁምፊ | ኤለመንት |
'ቀያይር' |
የተቆልቋይ ምናሌ ማጣቀሻ አካል። 'toggle' የ , 'parent' , ወይም HTMLElement ማጣቀሻ እሴቶችን ይቀበላል ። ለበለጠ መረጃ የPopper.js's referenceObject docs ይመልከቱ ። |
ማሳያ |
ሕብረቁምፊ |
'ተለዋዋጭ' |
በነባሪ፣ ለተለዋዋጭ አቀማመጥ Popper.js እንጠቀማለን። ይህን በ static . |
popperConfig |
ባዶ | ነገር |
ባዶ |
የBootstrapን ነባሪ የPopper.js ውቅር ለመቀየር የPopper.js ን አወቃቀር ይመልከቱ |
boundary
ከ , ወደ ሌላ ማንኛውም እሴት ሲዋቀር 'scrollParent'
, ዘይቤው በመያዣው position: static
ላይ እንደሚተገበር ልብ ይበሉ ..dropdown
ዘዴዎች
ዘዴ |
መግለጫ |
$().dropdown('toggle') |
የተሰጠውን የአሳሽ አሞሌ ወይም የታጠፈ አሰሳ ተቆልቋይ ሜኑ ይቀየራል። |
$().dropdown('show') |
የተሰጠውን የአሳሽ አሞሌ ወይም የታጠፈ አሰሳ ተቆልቋይ ሜኑ ያሳያል። |
$().dropdown('hide') |
የተሰጠውን የአሳሽ አሞሌ ወይም የታረመ አሰሳ ተቆልቋይ ምናሌን ይደብቃል። |
$().dropdown('update') |
የአንድ ንጥረ ነገር ተቆልቋይ ቦታን ያዘምናል። |
$().dropdown('dispose') |
የአንድ ንጥረ ነገር ተቆልቋይ ያጠፋል. |
ክስተቶች
ሁሉም ተቆልቋይ ክስተቶች .dropdown-menu
በወላጅ ኤለመንት ላይ ይቃጠላሉ እና relatedTarget
ንብረት አላቸው፣ እሴታቸው የሚቀያየር መልህቅ አካል ነው። hide.bs.dropdown
እና hidden.bs.dropdown
ክስተቶች clickEvent
ንብረት አላቸው (የመጀመሪያው የክስተት አይነት ሲሆን ብቻ click
) ለጠቅ ክስተቱ የክስተት ነገር የያዘ።
ክስተት |
መግለጫ |
show.bs.dropdown |
የማሳያ ምሳሌ ዘዴ ሲጠራ ይህ ክስተት ወዲያውኑ ይቃጠላል. |
shown.bs.dropdown |
ይህ ክስተት የሚቃጠለው ተቆልቋዩ ለተጠቃሚው እንዲታይ ሲደረግ ነው (የ CSS ሽግግሮችን እስኪጠናቀቅ ድረስ ይጠብቃል)። |
hide.bs.dropdown |
ይህ ክስተት የመደበቅ ምሳሌ ዘዴ ሲጠራ ወዲያውኑ ይቃጠላል። |
hidden.bs.dropdown |
ይህ ክስተት የሚቀጣጠለው ተቆልቋዩ ከተጠቃሚው ተደብቆ ሲጠናቀቅ ነው (የ CSS ሽግግሮችን እስኪጠናቀቅ ድረስ ይጠብቃል)። |