in English

ייַנבראָך

באַשטימען די וויזאַביליטי פון אינהאַלט אין דיין פּרויעקט מיט עטלעכע קלאסן און אונדזער דזשאַוואַסקריפּט פּלוגינס.

וויאזוי עס ארבעט

די ייַנבראָך דזשאַוואַסקריפּט פּלוגין איז געניצט צו ווייַזן און באַהאַלטן אינהאַלט. קנעפּלעך אָדער אַנגקערז זענען געניצט ווי טריגערז וואָס זענען מאַפּט צו ספּעציפיש עלעמענטן איר טאַגאַל. קאַלאַפּסינג אַן עלעמענט וועט ופלעבן די heightפון זיין קראַנט ווערט צו 0. געגעבן ווי CSS כאַנדאַלז אַנאַמיישאַנז, איר קענען נישט נוצן paddingאויף אַ .collapseעלעמענט. אַנשטאָט, נוצן די קלאַס ווי אַ פרייַ ראַפּינג עלעמענט.

די אַנאַמיישאַן ווירקונג פון דעם קאָמפּאָנענט איז אָפענגיק אויף די prefers-reduced-motionמידיאַ אָנפֿרעג. זען די רידוסט באַוועגונג אָפּטיילונג פון אונדזער אַקסעסאַביליטי דאַקיומענטיישאַן .

בייַשפּיל

דריקט אויף די קנעפּלעך אונטן צו ווייַזן און באַהאַלטן אן אנדער עלעמענט דורך קלאַס ענדערונגען:

  • .collapseבאַהאַלט אינהאַלט
  • .collapsingאיז געווענדט בעשאַס טראַנזישאַנז
  • .collapse.showווייזט אינהאַלט

אין אַלגעמיין, מיר רעקאָמענדירן ניצן אַ קנעפּל מיט די data-targetאַטריביוט. כאָטש ניט רעקאַמענדיד פֿון אַ סעמאַנטיק פונט פון מיינונג, איר קענען אויך נוצן אַ לינק מיט די hrefאַטריביוט (און אַ role="button"). אין ביידע קאַסעס, עס data-toggle="collapse"איז פארלאנגט.

Some placeholder content for the collapse component. This panel is hidden by default but revealed when the user activates the relevant trigger.
<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מאָדיפיער קלאַס צו יבערגאַנג די widthאַנשטאָט פון heightאון שטעלן אַ widthאויף די באַלדיק קינד עלעמענט. פילן פריי צו שרייַבן דיין אייגענע מנהג סאַס, נוצן ינלינע סטיילז אָדער נוצן אונדזער ברייט יוטילאַטיז .

ביטע טאָן אַז כאָטש די ביישפּיל אונטן האט אַ min-heightגאַנג צו ויסמיידן יבעריק ריפּיינץ אין אונדזער דאָקומענטן, דאָס איז נישט בפירוש פארלאנגט. בלויז די widthאויף דעם קינד עלעמענט איז פארלאנגט.

This is some placeholder content for a horizontal collapse. It's hidden by default and shown when triggered.
<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>

קייפל טאַרגאַץ

א <button>אָדער <a>קענען ווייַזן און באַהאַלטן קייפל עלעמענטן דורך ריפערינג זיי מיט אַ JQuery סעלעקטאָר אין זיין hrefאָדער data-targetאַטריביוט. קייפל <button>אָדער <a>קענען ווייַזן און באַהאַלטן אַן עלעמענט אויב זיי יעדער דערמאָנען עס מיט זייער hrefאָדער data-targetאַטריביוט

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.
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.
<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קלאַס.

Some placeholder content for the second accordion panel. This panel is hidden by default.

And lastly, the placeholder content for the third and final accordion panel. This panel is hidden by default.
<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 עלעמענט פון די קאָנטראָל עלעמענט איז נישט אַ קנעפּל (למשל, אַן <a>אָדער <div>), די אַטריביוטrole="button"זאָל זיין מוסיף צו די עלעמענט.

אויב דיין קאָנטראָל עלעמענט איז טאַרגאַטינג אַ איין קאַלאַפּסאַבאַל עלעמענט - ד"ה די data-targetאַטריביוט איז ווייזן צו אַ idסעלעקטאָר - איר זאָל לייגן דעם aria-controlsאַטריביוט צו די קאָנטראָל עלעמענט, מיט idדי קאַלאַפּסאַבאַל עלעמענט. מאָדערן סקרין לייענער און ענלעך אַסיסטאַנץ טעקנאַלאַדזשיז נוצן דעם אַטריביוט צו צושטעלן יוזערז נאָך דורכוועג צו נאַוויגירן גלייך צו די קאַלאַפּסאַבאַל עלעמענט זיך.

באַמערקונג אַז די קראַנט ימפּלאַמענטיישאַן פון Bootstrap טוט נישט דעקן די פאַרשידן קלאַוויאַטור ינטעראַקשאַנז דיסקרייבד אין די ARIA Authoring Practices Guide אַקאָרדיאַן מוסטער - איר וועט דאַרפֿן צו אַרייַננעמען די זיך מיט מנהג דזשאַוואַסקריפּט.

באַניץ

די ייַנבראָך פּלוגין ניצט אַ ביסל קלאסן צו שעפּן די שווער ליפטינג:

  • .collapseבאַהאַלט דעם אינהאַלט
  • .collapse.showווייזט די אינהאַלט
  • .collapsingאיז מוסיף ווען די יבערגאַנג סטאַרץ, און אַוועקגענומען ווען עס ענדיקן

די קלאסן קענען זיין געפֿונען אין _transitions.scss.

דורך דאַטן אַטריביוץ

נאָר לייגן data-toggle="collapse"און אַ data-targetצו דעם עלעמענט צו אויטאָמאַטיש באַשטימען קאָנטראָל פון איינער אָדער מער קאַלאַפּסאַבאַל עלעמענטן. דער data-targetאַטריביוט אַקסעפּץ אַ CSS סעלעקטאָר צו צולייגן די ייַנבראָך. זייט זיכער צו לייגן די קלאַס collapseצו די קאַלאַפּסאַבאַל עלעמענט. אויב איר ווילט אַז עס זאָל זיין פעליקייַט עפענען, לייגן די נאָך קלאַס show.

צו לייגן אַקאָרדיאַן-ווי גרופּע פאַרוואַלטונג צו אַ קאַלאַפּסאַבאַל געגנט, לייגן די דאַטן אַטריביוט data-parent="#selector". אָפּשיקן צו די דעמאָ צו זען דעם אין קאַמף.

דורך דזשאַוואַסקריפּט

געבן מאַניואַלי מיט:

$('.collapse').collapse()

אָפּציעס

אָפּציעס קענען זיין דורכגעגאנגען דורך דאַטן אַטריביוץ אָדער דזשאַוואַסקריפּט. פֿאַר דאַטן אַטריביוץ, צולייגן די אָפּציע נאָמען צו data-, ווי אין data-parent="".

נאָמען טיפּ פעליקייַט באַשרייַבונג
פאָטער סעלעקטאָר | דזשקווערי כייפעץ | DOM עלעמענט פאַלש אויב דער פאָטער איז צוגעשטעלט, אַלע קאַלאַפּסאַבאַל עלעמענטן אונטער די ספּעסיפיעד פאָטער וועט זיין פארמאכט ווען דעם קאַלאַפּסאַבאַל נומער איז געוויזן. (ענלעך צו טראדיציאנעלן אַקאָרדיאַן נאַטור - דאָס איז אָפענגיק אויף די cardקלאַס). די אַטריביוט זאָל זיין באַשטימט אויף דער ציל קאַלאַפּסאַבאַל געגנט.
טאַגאַל בוליאַן אמת טאָגלעס די קאַלאַפּסאַבאַל עלעמענט אויף ינוואָקאַטיאָן

מעטהאָדס

אַסינטשראָנאָוס מעטהאָדס און טראַנזישאַנז

אַלע אַפּי מעטהאָדס זענען ייסינגקראַנאַס און אָנהייבן אַ יבערגאַנג . זיי צוריקקומען צו די קאַללער ווי באַלד ווי די יבערגאַנג איז סטאַרטעד אָבער איידער עס ענדס . אין אַדישאַן, אַ מעטאָד רופן אויף אַ יבערגאַנג קאָמפּאָנענט וועט זיין איגנאָרירט .

זען אונדזער דזשאַוואַסקריפּט דאַקיומענטיישאַן פֿאַר מער אינפֿאָרמאַציע .

.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')

דיסטרויז אַן עלעמענט ס ייַנבראָך.

געשעענישן

Bootstrap ס ייַנבראָך קלאַס יקספּאָוזיז עטלעכע געשעענישן פֿאַר כוקינג אין ייַנבראָך פאַנגקשאַנאַליטי.

געשעעניש טיפּ באַשרייַבונג
show.bs.collapse דער געשעעניש פירט גלייך ווען דער showבייַשפּיל אופֿן איז גערופן.
געוויזן.בס.ייַנבראָך דער געשעעניש איז פייערד ווען אַ ייַנבראָך עלעמענט איז געווען קענטיק צו דער באַניצער (וועט וואַרטן פֿאַר CSS טראַנזישאַנז צו פאַרענדיקן).
hide.bs.collapse דעם געשעעניש איז פייערד מיד ווען דער hideאופֿן איז גערופן.
פאַרבאָרגן.בס.ייַנבראָך דער געשעעניש איז פייערד ווען אַ ייַנבראָך עלעמענט איז פאַרבאָרגן פון דער באַניצער (וועט וואַרטן פֿאַר CSS טראַנזישאַנז צו פאַרענדיקן).
$('#myCollapsible').on('hidden.bs.collapse', function () {
  // do something...
})