ፈረሰ
ኣብ መላእ ፕሮጀክትካ ርኡይነት ትሕዝቶ ብውሑዳት ክፍልታትን ናይ ጃቫስክሪፕት ፕላጊናትናን ምቕያር።
ከመይ ይሰርሕ
እቲ collapse JavaScript plugin ትሕዝቶ ንምርኣይን ንምሕባእን ይጥቀመሉ። መጠወቒታት ወይ መልህቕ ከም መበገሲታት ዝጥቀሙ ኮይኖም ናብ ፍሉያት ባእታታት ትቕይሮም ዝምደብ እዩ። ንሓደ ባእታ ምፍራስ ነቲ height
ካብቲ ሕጂ ዘለዎ ዋጋ ናብ 0
. padding
CSS ንኣኒሜሽን ብኸመይ ከም ዝሕዞ ኣብ ግምት ብምእታው ፡ ኣብ ሓደ .collapse
ባእታ ክትጥቀመሉ ኣይትኽእልን ኢኻ ። ኣብ ክንድኡስ፡ ነቲ ክፍሊ ከም ናጻ መጠቕለሊ ባእታ ተጠቐመሉ።
prefers-reduced-motion
ሚድያ ሕቶ ዝምርኮስ እዩ። ኣብቲ ናይ ተበጻሕነት ሰነድና ኣብቲ ዝተቐነሰ ምንቅስቓስ ዝብል ክፍሊ ርአ
።
ኣብነት
ካልእ ባእታ ብመንገዲ ለውጢ ክፍሊ ንምርኣይን ንምሕባእን ኣብ ታሕቲ ዘለዉ መጠወቒታት ጠውቑ፤
.collapse
ትሕዝቶ ይሓብእ እዩ።.collapsing
ኣብ እዋን ምስግጋር ይትግበር.collapse.show
ትሕዝቶ የርኢ
data-target
ብሓፈሻ፡ ምስቲ ባህሪ ዘለዎ መጠወቒ ክትጥቀም ንመክር ። href
ብዓይኒ ትርጉማዊ ኣረኣእያ እኳ እንተዘይተመከረ፡ ምስቲ ባህሪ (ከምኡ’ውን a role="button"
) ዘለዎ መላግቦ’ውን ክትጥቀም ትኽእል ኢኻ ። ኣብ ክልቲኡ ኩነታት፡ እቲ data-toggle="collapse"
ይድለ።
<p>
<a class="btn btn-primary" data-toggle="collapse" href="#collapseExample" role="button" aria-expanded="false" aria-controls="collapseExample">
Link with href
</a>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
Button with data-target
</button>
</p>
<div class="collapse" id="collapseExample">
<div class="card card-body">
Some placeholder content for the collapse component. This panel is hidden by default but revealed when the user activates the relevant trigger.
</div>
</div>
ንጋድም
እቲ ናይ ምፍራስ ፕላግ-ኢን ንኣግማድ ምፍራስ እውን ይድግፍ እዩ። ነቲ ኣብ ክንዲ .width
ነቲ ንምስግጋር ነቲ መቐየሪ ክፍሊ ወስኸሉ እሞ ኣብቲ ናይ ቀረባ ውላድ ባእታ a ኣቐምጦ ። ናይ ገዛእ ርእስኻ ብሕታዊ Sass ክትጽሕፍ፡ ኣብ መስመር ቅዲታት ክትጥቀም፡ ወይ ድማ ናይ ስፍሓት መገልገሊታትና ክትጥቀም ናጻ ትኸውን ።width
height
width
min-height
ዶክስና ካብ መጠን ንላዕሊ ዳግማይ ቀለም ንኸይፍጠር ዝሕግዝ ስብስብ እኳ እንተሃለዎ፡ እዚ ግን ብግልጺ ኣየድልን እዩ።
እቲ width
ኣብ ውላድ ዘሎ ባእታ ጥራይ እዩ ዘድሊ።
<p>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#collapseWidthExample" aria-expanded="false" aria-controls="collapseWidthExample">
Toggle width collapse
</button>
</p>
<div style="min-height: 120px;">
<div class="collapse width" id="collapseWidthExample">
<div class="card card-body" style="width: 320px;">
This is some placeholder content for a horizontal collapse. It's hidden by default and shown when triggered.
</div>
</div>
</div>
ብዙሕ ዕላማታት
A <button>
ወይ ኣብ ናቱ ወይ ባህርያቱ <a>
ብJQuery መምረጺ ብምውካስ ብዙሓት ባእታታት ከርኢን ክሓብኦምን ይኽእል ። ብዙሕ ወይ ንሓደ ባእታ ከርእይዎን ክሓብእዎን ይኽእሉ ነፍሲ ወከፎም ብናቶም ወይ ባህርይ እንተወከስዎ።href
data-target
<button>
<a>
href
data-target
<p>
<a class="btn btn-primary" data-toggle="collapse" href="#multiCollapseExample1" role="button" aria-expanded="false" aria-controls="multiCollapseExample1">Toggle first element</a>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#multiCollapseExample2" aria-expanded="false" aria-controls="multiCollapseExample2">Toggle second element</button>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target=".multi-collapse" aria-expanded="false" aria-controls="multiCollapseExample1 multiCollapseExample2">Toggle both elements</button>
</p>
<div class="row">
<div class="col">
<div class="collapse multi-collapse" id="multiCollapseExample1">
<div class="card card-body">
Some placeholder content for the first collapse component of this multi-collapse example. This panel is hidden by default but revealed when the user activates the relevant trigger.
</div>
</div>
</div>
<div class="col">
<div class="collapse multi-collapse" id="multiCollapseExample2">
<div class="card card-body">
Some placeholder content for the second collapse component of this multi-collapse example. This panel is hidden by default but revealed when the user activates the relevant trigger.
</div>
</div>
</div>
</div>
ኣኮርድዮን ኣብነት
ነቲ ናይ ካርድ ክፍሊ ብምጥቃም፡ ነቲ ነባሪ ናይ ምዕጻፍ ባህሪ ከተናውሖ ትኽእል ኢኻ ኣኮርድዮን ክትፈጥር። ቅዲ ኣኮርድዮን ብግቡእ ንምዕዋት .accordion
፡ ከም መጠቕለሊ ምጥቃምካ ኣረጋግጽ።
.show
ክፍሊ።
<div class="accordion" id="accordionExample">
<div class="card">
<div class="card-header" id="headingOne">
<h2 class="mb-0">
<button class="btn btn-link btn-block text-left" type="button" data-toggle="collapse" data-target="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
Collapsible Group Item #1
</button>
</h2>
</div>
<div id="collapseOne" class="collapse show" aria-labelledby="headingOne" data-parent="#accordionExample">
<div class="card-body">
Some placeholder content for the first accordion panel. This panel is shown by default, thanks to the <code>.show</code> class.
</div>
</div>
</div>
<div class="card">
<div class="card-header" id="headingTwo">
<h2 class="mb-0">
<button class="btn btn-link btn-block text-left collapsed" type="button" data-toggle="collapse" data-target="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
Collapsible Group Item #2
</button>
</h2>
</div>
<div id="collapseTwo" class="collapse" aria-labelledby="headingTwo" data-parent="#accordionExample">
<div class="card-body">
Some placeholder content for the second accordion panel. This panel is hidden by default.
</div>
</div>
</div>
<div class="card">
<div class="card-header" id="headingThree">
<h2 class="mb-0">
<button class="btn btn-link btn-block text-left collapsed" type="button" data-toggle="collapse" data-target="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
Collapsible Group Item #3
</button>
</h2>
</div>
<div id="collapseThree" class="collapse" aria-labelledby="headingThree" data-parent="#accordionExample">
<div class="card-body">
And lastly, the placeholder content for the third and final accordion panel. This panel is hidden by default.
</div>
</div>
</div>
</div>
ተበጻሕነት
aria-expanded
ኣብቲ ናይ ምቁጽጻር ባእታ ምውሳኽካ ኣረጋግጽ ። እዚ ባህሪ እዚ ህሉው ኩነታት ናይቲ ምስቲ ቁጽጽር ዝተኣሳሰር ዝዕጸፍ ባእታ ብግልጺ ናብ ስክሪን ኣንበብቲን ተመሳሳሊ ሓገዝቲ ቴክኖሎጂታትን የመሓላልፍ። እቲ ዝዕጾ ባእታ ብነባሪ እንተተዓጽዩ፡ እቲ ኣብቲ ናይ ምቁጽጻር ባእታ ዘሎ ባህሪ ዋጋ ክህልዎ ይግባእ aria-expanded="false"
። ነቲ ዝዕጾ ባእታ ብነባሪ show
ንክፍሊ ተጠቒምካ ክፉት ክኸውን እንተ ኣቐሚጥካዮ aria-expanded="true"
፡ ኣብ ክንድኡ ኣብቲ ቁጽጽር ኣቐምጦ። እቲ ፕላግ-ኢን ነዚ ባህሪ ኣብቲ ቁጽጽር ብኣውቶማቲክ ክቕይሮ እዩ እቲ ዝዕጾ ባእታ ተኸፊቱ ወይ ተዓጽዩ ድዩ ኣይተዓጽወን (ብመንገዲ ጃቫስክሪፕት፣ ወይ እቲ ተጠቃሚ ካልእ ናይ ምቁጽጻር ባእታ እውን ምስ ተመሳሳሊ ዝዕጾ ባእታ ዝተኣሳሰር ስለዘበገሰ) መሰረት ብምግባር። ናይቲ ቁጽጽር ባእታ HTML ባእታ መጠወቒ እንተዘይኮይኑ (ንኣብነት፡ an <a>
ወይ <div>
)፡ እቲ ባህሪrole="button"
ኣብቲ ባእታ ክውሰኽ ይግባእ።
ናትካ ናይ ምቁጽጻር ባእታ ንሓደ ዝዕጾ ባእታ ዒላማ ዝገብር እንተኾይኑ – ማለት እቲ data-target
ባህሪ ናብ ሓደ መምረጺ ዘመልክት እንተኾይኑ – ነቲ ባህሪ ኣብቲ ናይ ምቁጽጻር ባእታ id
ክትውስኾ ይግባእ ፣ እቲ ናይቲ ዝዕጾ ባእታ ዝሓዘ። ዘመናውያን ስክሪን ሪደርን ተመሳሳሊ ሓገዝቲ ቴክኖሎጂታትን ነዚ ባህሪ እዚ ተጠቒሞም ተጠቀምቲ ብቐጥታ ናብቲ ዝዕጾ ባእታ ባዕሉ ንኽኸዱ ተወሳኺ ኣቋራጭ መገዲ ይህቡ።aria-controls
id
ኣስተውዕል ናይ Bootstrap ናይ ሕጂ ኣተገባብራ ነቶም ኣብ ARIA Authoring Practices Guide acordion pattern ዝተገልጹ ዝተፈላለዩ ናይ ቁልፊ ሰሌዳ ምትእስሳራት ከምዘይሽፍኖም ኣስተውዕል - ነዚኦም ባዕልኻ ምስ ብሕታዊ ጃቫስክሪፕት ከተካትቶም ከድልየካ እዩ።
ኣጠቓቕማ
እቲ ናይ ምፍራስ ፕላግ-ኢን ነቲ ከቢድ ምልዓል ንምሕላው ውሑዳት ክፍልታት ይጥቀም፤
.collapse
ነቲ ትሕዝቶ ይሓብኦ.collapse.show
ዝብል ትሕዝቶ የርኢ.collapsing
ምስግጋር ምስ ተጀመረ ይውሰኽ፣ ምስተወድአ ድማ ይእለ
እዞም ክፍልታት ኣብ _transitions.scss
.
ብመንገዲ ባህርያት ዳታ
በቃ ኣብቲ ባእታ ምውሳኽን data-toggle="collapse"
a ን ንኣውቶማቲክ ምቁጽጻር ናይ ሓደ ወይ ልዕሊኡ ዝዕጸፍ ባእታታት ንምምዳብ። data-target
እቲ data-target
ባህሪ ነቲ ምዕጻፍ ክትጥቀመሉ እትኽእል CSS መምረጺ ይቕበል። collapse
ነቲ ክፍሊ ኣብቲ ዝዕጾ ባእታ ምውሳኽካ ኣረጋግጽ ። ብነባሪ ክኽፈት እንተደሊኻ፡ ነቲ ተወሳኺ ክፍሊ ወስኸሉ show
።
ኣኮርድዮን ዝመስል ምሕደራ ጉጅለ ኣብ ዝዕጸፍ ቦታ ንምውሳኽ፡ ነቲ ናይ ዳታ ባህሪ ወስኸሉ data-parent="#selector"
። ነዚ ብተግባር ንምርኣይ ኣብቲ ዲሞ ተወከሱ።
ብመንገዲ ጃቫስክሪፕት።
ብኢድካ ምስ ኣንቅሕ፤
$('.collapse').collapse()
ኣማራጺታት
ኣማራጺታት ብመንገዲ ዳታ ባህርያት ወይ ጃቫስክሪፕት ክሓልፉ ይኽእሉ። ንባህርያት ዳታ፡ ስም ኣማራጺ ናብ ምውሳኽ data-
፡ ከምቲ ኣብ data-parent=""
.
ሽም | ዓይነት | ትሑዝ | መግለፂ |
---|---|---|---|
ወላዲ | መምረጺ | jQuery ነገር | DOM ባእታ | ሓሶት | ወላዲ እንተተዋሂቡ፡ ሽዑ ኩሎም ኣብ ትሕቲ እቲ ዝተገልጸ ወላዲ ዝዕጸፉ ባእታታት እዚ ዝዕጸፍ ኣቕሓ ምስ ዝረአ ክዕጸዉ እዮም። card (ምስ ባህላዊ ባህሪ ኣኮርድዮን ዝመሳሰል - እዚ ኣብቲ ክፍሊ ዝምርኮስ እዩ )። እቲ ባህሪ ኣብቲ ዕላማ ዝዕጾ ቦታ ክቕመጥ ኣለዎ። |
toggle ምግባር | ቡልያን ዝብል እዩ። | ሓቂ | ኣብ ምጽዋዕ ነቲ ዝዕጾ ባእታ ይቕይሮ |
ኣገባባት
ዘይተመዓራረዩ ኣገባባትን ምስግጋራትን።
ኩሎም ናይ ኤፒኣይ ሜላታት ዘይተመዓራረዩ ኮይኖም ምስግጋር ይጅምሩ ። እቲ ምስግጋር ምስ ተጀመረ ግን ከኣ ቅድሚ ምውድኡ ናብቲ ደዋሊ ይምለሱ ። ብተወሳኺ፡ ኣብ ሓደ መሰጋገሪ ኣካል ዝግበር ናይ ሜላ ጻውዒት ዕሽሽ ክበሃል እዩ .
.collapse(options)
ትሕዝቶኻ ከም ዝዕጾ ባእታ ይንቀሳቐስ። ሓደ ኣማራጺ ኣማራጺታት ይቕበል object
.
$('#myCollapsible').collapse({
toggle: false
})
.collapse('toggle')
ንሓደ ዝዕጾ ባእታ ናብ ዝተራእየ ወይ ዝተሓብአ ይቕይሮ። እቲ ዝዕጾ ባእታ ብጭቡጥ ቅድሚ ምርኣዩ ወይ ምሕባኡ (ማለት ቅድሚ እቲ shown.bs.collapse
ወይ hidden.bs.collapse
ፍጻመ ምፍጻሙ) ናብቲ ደዋሊ ይምለስ።
.collapse('show')
ዝዕጾ ባእታ የርኢ። እቲ ዝዕጾ ባእታ ብጭቡጥ ቅድሚ ምርኣይ (ማለት ቅድሚ እቲ shown.bs.collapse
ፍጻመ ምፍጻሙ) ናብቲ ደዋሊ ይምለስ።
.collapse('hide')
ዝዕጾ ባእታ ይሓብእ። እቲ ዝዕጾ ባእታ ብጭቡጥ ቅድሚ ምሕባኡ (ማለት ቅድሚ እቲ hidden.bs.collapse
ፍጻመ ምፍጣሩ) ናብቲ ደዋሊ ይምለስ።
.collapse('dispose')
ናይ ሓደ ባእታ ምፍራስ የጥፍእ።
ፍጻሜታት
ናይ ቡትስትራፕ ናይ ምፍራስ ክፍሊ ንውሑዳት ፍጻመታት ንናይ ምፍራስ ተግባር ምትእስሳር የቃልዕ።
ዓይነት ፍጻመ | መግለፂ |
---|---|
show.bs.collapse ዝብል ጽሑፍ ኣሎ። | show እዚ ፍጻመ እዚ እቲ ናይ ምሳሌ ሜላ ምስ ዝጽዋዕ ብቕጽበት ይትኩስ ። |
shown.bs.collapse ዝብል ጽሑፍ ኣሎ። | እዚ ክስተት ዝትኮስ ሓደ ናይ ምፍራስ ባእታ ንተጠቃሚ ርኡይ ምስ ተገይሩ እዩ (ምስግጋር CSS ክሳብ ዝዛዘም ክጽበ እዩ)። |
hide.bs.collapse ዝብል ጽሑፍ ኣሎ። | እዚ ፍጻመ እዚ እቲ hide ሜላ ምስ ተጸውዐ ብቕጽበት ይትኮስ። |
ሕቡእ.bs.collapse ዝብል ጽሑፍ ኣሎ። | እዚ ክስተት ዝትኮስ ሓደ ናይ ምፍራስ ባእታ ካብ ተጠቃሚ ምስ ተሓብአ እዩ (CSS ምስግጋራት ክሳብ ዝዛዘም ክጽበ እዩ)። |
$('#myCollapsible').on('hidden.bs.collapse', function () {
// do something...
})