Holo i ka ʻike nui Holo i ka hoʻokele docs
Check
in English

Scrollspy

Hoʻohou ʻakomi i ka hoʻokele Bootstrap a i ʻole ka papa inoa o nā ʻāpana hui e pili ana i ke kūlana ʻōwili e hōʻike i ka loulou e hana nei i kēia manawa ma ka viewport.

Pehea e hana ai

Hoʻololi ʻo Scrollspy i ka .activepapa ma nā mea heleuma ( <a>) i ka wā e ʻōwili ʻia ai ka mea me ka mea i idkuhikuhi ʻia e ka heleuma href. Hoʻohana maikaʻi ʻia ʻo Scrollspy me kahi ʻāpana Bootstrap nav a i ʻole pūʻulu papa inoa , akā e hana pū me nā mea heleuma ma ka ʻaoʻao o kēia manawa. Penei ka hana ana.

  • No ka hoʻomaka ʻana, koi ʻia ʻo scrollspy i ʻelua mau mea: kahi hoʻokele, pūʻulu papa inoa, a i ʻole kahi hoʻonohonoho maʻalahi o nā loulou, me kahi pahu scrollable. Hiki i ka ipu scrollable ke ʻano a i <body>ʻole kahi mea maʻamau me kahi set heighta me overflow-y: scroll.

  • Ma ka pahu scrollable, hoʻohui data-bs-spy="scroll"a data-bs-target="#navId"ma hea navIdkahi kū hoʻokahi ido ka hoʻokele pili. E hoʻokomo pū i kahi tabindex="0"e hōʻoia i ke komo ʻana i ka papa keyboard.

  • Ke ʻōwili nei ʻoe i ka ipu "spied", .activehoʻohui ʻia kahi papa mai nā loulou heleuma i loko o ka hoʻokele pili. Pono nā loulou e hoʻoholo idi nā pahuhopu, i ʻole e nānā ʻole ʻia lākou. No ka laʻana, <a href="#home">home</a>pono e pili i kekahi mea ma ka DOM like<div id="home"></div>

  • E nānā ʻole ʻia nā mea i ʻike ʻole ʻia. E ʻike i ka ʻāpana ʻAʻole i ʻike ʻia ma lalo nei.

Nā laʻana

E ʻōwili i ka ʻāpana ma lalo o ka navbar a nānā i ka loli o ka papa hana. E wehe i ka papa kuhikuhi a nānā i nā mea hāʻule i hōʻike pū ʻia.

Poʻomanaʻo mua

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

Poʻomanaʻo ʻelua

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

Poʻomanaʻo ʻekolu

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

Poʻomanaʻo ʻehā

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

Poʻomanaʻo ʻelima

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

<nav id="navbar-example2" class="navbar bg-light px-3 mb-3">
  <a class="navbar-brand" href="#">Navbar</a>
  <ul class="nav nav-pills">
    <li class="nav-item">
      <a class="nav-link" href="#scrollspyHeading1">First</a>
    </li>
    <li class="nav-item">
      <a class="nav-link" href="#scrollspyHeading2">Second</a>
    </li>
    <li class="nav-item dropdown">
      <a class="nav-link dropdown-toggle" data-bs-toggle="dropdown" href="#" role="button" aria-expanded="false">Dropdown</a>
      <ul class="dropdown-menu">
        <li><a class="dropdown-item" href="#scrollspyHeading3">Third</a></li>
        <li><a class="dropdown-item" href="#scrollspyHeading4">Fourth</a></li>
        <li><hr class="dropdown-divider"></li>
        <li><a class="dropdown-item" href="#scrollspyHeading5">Fifth</a></li>
      </ul>
    </li>
  </ul>
</nav>
<div data-bs-spy="scroll" data-bs-target="#navbar-example2" data-bs-root-margin="0px 0px -40%" data-bs-smooth-scroll="true" class="scrollspy-example bg-light p-3 rounded-2" tabindex="0">
  <h4 id="scrollspyHeading1">First heading</h4>
  <p>...</p>
  <h4 id="scrollspyHeading2">Second heading</h4>
  <p>...</p>
  <h4 id="scrollspyHeading3">Third heading</h4>
  <p>...</p>
  <h4 id="scrollspyHeading4">Fourth heading</h4>
  <p>...</p>
  <h4 id="scrollspyHeading5">Fifth heading</h4>
  <p>...</p>
</div>

Nested nav

Hana pū ʻo Scrollspy me nā nested .navs. Inā he pūnana .nav, ʻo .activekona mau mākua pū kekahi .active. E ʻōwili i ka ʻāpana ma ka ʻaoʻao o ka navbar a nānā i ka hoʻololi ʻana o ka papa hana.

'ikamu 1

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

E hoʻomanaʻo e hoʻāʻo ka plugin JavaScript e koho i ka mea kūpono i waena o nā mea āpau i ʻike ʻia. Hiki i nā pahuhopu scrollspy ʻike ʻia i ka manawa like ke kumu i kekahi pilikia.

'ikamu 1-1

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

E hoʻomanaʻo e hoʻāʻo ka plugin JavaScript e koho i ka mea kūpono i waena o nā mea āpau i ʻike ʻia. Hiki i nā pahuhopu scrollspy ʻike ʻia i ka manawa like ke kumu i kekahi pilikia.

'ikamu 1-2

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

E hoʻomanaʻo e hoʻāʻo ka plugin JavaScript e koho i ka mea kūpono i waena o nā mea āpau i ʻike ʻia. Hiki i nā pahuhopu scrollspy ʻike ʻia i ka manawa like ke kumu i kekahi pilikia.

'ikamu 2

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

E hoʻomanaʻo e hoʻāʻo ka plugin JavaScript e koho i ka mea kūpono i waena o nā mea āpau i ʻike ʻia. Hiki i nā pahuhopu scrollspy ʻike ʻia i ka manawa like ke kumu i kekahi pilikia.

'ikamu 3

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

E hoʻomanaʻo e hoʻāʻo ka plugin JavaScript e koho i ka mea kūpono i waena o nā mea āpau i ʻike ʻia. Hiki i nā pahuhopu scrollspy ʻike ʻia i ka manawa like ke kumu i kekahi pilikia.

Kumuhana 3-1

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

E hoʻomanaʻo e hoʻāʻo ka plugin JavaScript e koho i ka mea kūpono i waena o nā mea āpau i ʻike ʻia. Hiki i nā pahuhopu scrollspy ʻike ʻia i ka manawa like ke kumu i kekahi pilikia.

'ikamu 3-2

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

E hoʻomanaʻo e hoʻāʻo ka plugin JavaScript e koho i ka mea kūpono i waena o nā mea āpau i ʻike ʻia. Hiki i nā pahuhopu scrollspy ʻike ʻia i ka manawa like ke kumu i kekahi pilikia.

<div class="row">
  <div class="col-4">
    <nav id="navbar-example3" class="h-100 flex-column align-items-stretch pe-4 border-end">
      <nav class="nav nav-pills flex-column">
        <a class="nav-link" href="#item-1">Item 1</a>
        <nav class="nav nav-pills flex-column">
          <a class="nav-link ms-3 my-1" href="#item-1-1">Item 1-1</a>
          <a class="nav-link ms-3 my-1" href="#item-1-2">Item 1-2</a>
        </nav>
        <a class="nav-link" href="#item-2">Item 2</a>
        <a class="nav-link" href="#item-3">Item 3</a>
        <nav class="nav nav-pills flex-column">
          <a class="nav-link ms-3 my-1" href="#item-3-1">Item 3-1</a>
          <a class="nav-link ms-3 my-1" href="#item-3-2">Item 3-2</a>
        </nav>
      </nav>
    </nav>
  </div>

  <div class="col-8">
    <div data-bs-spy="scroll" data-bs-target="#navbar-example3" data-bs-smooth-scroll="true" class="scrollspy-example-2" tabindex="0">
      <div id="item-1">
        <h4>Item 1</h4>
        <p>...</p>
      </div>
      <div id="item-1-1">
        <h5>Item 1-1</h5>
        <p>...</p>
      </div>
      <div id="item-1-2">
        <h5>Item 1-2</h5>
        <p>...</p>
      </div>
      <div id="item-2">
        <h4>Item 2</h4>
        <p>...</p>
      </div>
      <div id="item-3">
        <h4>Item 3</h4>
        <p>...</p>
      </div>
      <div id="item-3-1">
        <h5>Item 3-1</h5>
        <p>...</p>
      </div>
      <div id="item-3-2">
        <h5>Item 3-2</h5>
        <p>...</p>
      </div>
    </div>
  </div>
</div>

Papa papa inoa

Hana pū ʻo Scrollspy me .list-groups. E ʻōwili i ka ʻāpana ma ka ʻaoʻao o ka pūʻulu papa inoa a nānā i ka hoʻololi ʻana o ka papa hana.

'ikamu 1

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

'ikamu 2

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

'ikamu 3

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

Kumuhana 4

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

<div class="row">
  <div class="col-4">
    <div id="list-example" class="list-group">
      <a class="list-group-item list-group-item-action" href="#list-item-1">Item 1</a>
      <a class="list-group-item list-group-item-action" href="#list-item-2">Item 2</a>
      <a class="list-group-item list-group-item-action" href="#list-item-3">Item 3</a>
      <a class="list-group-item list-group-item-action" href="#list-item-4">Item 4</a>
    </div>
  </div>
  <div class="col-8">
    <div data-bs-spy="scroll" data-bs-target="#list-example" data-bs-smooth-scroll="true" class="scrollspy-example" tabindex="0">
      <h4 id="list-item-1">Item 1</h4>
      <p>...</p>
      <h4 id="list-item-2">Item 2</h4>
      <p>...</p>
      <h4 id="list-item-3">Item 3</h4>
      <p>...</p>
      <h4 id="list-item-4">Item 4</h4>
      <p>...</p>
    </div>
  </div>
</div>

Nā heleuma maʻalahi

ʻAʻole kaupalena ʻia ʻo Scrollspy i nā ʻāpana nav a me nā pūʻulu papa inoa, no laila e hana ia ma nā mea <a>heleuma o ka palapala o kēia manawa. E ʻōwili i ka ʻāpana a nānā i ka .activeloli o ka papa.

'ikamu 1

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

'ikamu 2

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

'ikamu 3

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

Kumuhana 4

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

'ikamu 5

ʻO kēia kekahi maʻiʻo placeholder no ka ʻaoʻao scrollspy. E hoʻomanaʻo i ka wā e kaomi ai ʻoe i lalo o ka ʻaoʻao, ua hōʻike ʻia ka loulou hoʻokele kūpono. Hoʻopuka hou ʻia i loko o ka laʻana ʻāpana. Hoʻohui mākou i kekahi kope kope hou aʻe ma ʻaneʻi e hoʻoikaika i ka ʻōwili ʻana a me ka hōʻailona.

<div class="row">
  <div class="col-4">
    <div id="simple-list-example" class="d-flex flex-column gap-2 simple-list-example-scrollspy text-center">
      <a class="p-1 rounded" href="#simple-list-item-1">Item 1</a>
      <a class="p-1 rounded" href="#simple-list-item-2">Item 2</a>
      <a class="p-1 rounded" href="#simple-list-item-3">Item 3</a>
      <a class="p-1 rounded" href="#simple-list-item-4">Item 4</a>
      <a class="p-1 rounded" href="#simple-list-item-5">Item 5</a>
    </div>
  </div>
  <div class="col-8">
    <div data-bs-spy="scroll" data-bs-target="#simple-list-example" data-bs-offset="0" data-bs-smooth-scroll="true" class="scrollspy-example" tabindex="0">
      <h4 id="simple-list-item-1">Item 1</h4>
      <p>...</p>
      <h4 id="simple-list-item-2">Item 2</h4>
      <p>...</p>
      <h4 id="simple-list-item-3">Item 3</h4>
      <p>...</p>
      <h4 id="simple-list-item-4">Item 4</h4>
      <p>...</p>
      <h4 id="simple-list-item-5">Item 5</h4>
      <p>...</p>
    </div>
  </div>
</div>

Nā mea ʻike ʻole ʻia

E nānā ʻole ʻia nā mea i ʻike ʻole ʻia a ʻaʻole e loaʻa kahi papa i kā lākou mau mea nav pili .active. ʻO nā hiʻohiʻona Scrollspy i hoʻomaka ʻia i loko o kahi wahī ʻike ʻole ʻia e haʻalele i nā mea kikoʻī āpau. E hoʻohana i ke refreshʻano e nānā ai i nā mea ʻike maka ke ʻike ʻia ka ʻōwili.

document.querySelectorAll('#nav-tab>[data-bs-toggle="tab"]').forEach(el => {
  el.addEventListener('shown.bs.tab', () => {
    const target = el.getAttribute('data-bs-target')
    const scrollElem = document.querySelector(`${target} [data-bs-spy="scroll"]`)
    bootstrap.ScrollSpy.getOrCreateInstance(scrollElem).refresh()
  })
})

Hoʻohana

Ma o nā hiʻohiʻona ʻikepili

No ka hoʻohui maʻalahi i ka hana scrollspy i kāu hoʻokele topbar, e hoʻohui data-bs-spy="scroll"i ka mea āu e makemake ai e kiu (ʻo ka mea maʻamau ʻo ia ka <body>). A laila e hoʻohui i ka data-bs-targetʻano me ka inoa a i idʻole ka papa inoa o ka mea makua o kekahi ʻāpana Bootstrap .nav.

<body data-bs-spy="scroll" data-bs-target="#navbar-example">
  ...
  <div id="navbar-example">
    <ul class="nav nav-tabs" role="tablist">
      ...
    </ul>
  </div>
  ...
</body>

Ma o JavaScript

const scrollSpy = new bootstrap.ScrollSpy(document.body, {
  target: '#navbar-example'
})

Nā koho

Hiki ke hāʻawi ʻia nā koho ma o nā ʻikepili a i ʻole JavaScript, hiki iā ʻoe ke hoʻohui i kahi inoa koho i data-bs-, e like me ka data-bs-animation="{value}". E hōʻoia e hoʻololi i ke ʻano hihia o ka inoa koho mai " CamelCase " i " kebab-case " i ka wā e hāʻawi ai i nā koho ma o nā ʻano ʻikepili. No ka laʻana, hoʻohana data-bs-custom-class="beautifier"ma kahi o data-bs-customClass="beautifier".

E like me Bootstrap 5.2.0, kākoʻo nā ʻāpana āpau i kahi hiʻohiʻona ʻikepili i mālama ʻiadata-bs-config i hiki ke mālama i ka hoʻonohonoho ʻāpana maʻalahi ma ke ʻano he kaula JSON. Ke loaʻa nā ʻano mea data-bs-config='{"delay":0, "title":123}'a me data-bs-title="456"nā ʻano, ʻo ka titlewaiwai hope loa 456a na nā ʻano ʻikepili kaʻawale e kāpae i nā waiwai i hāʻawi ʻia ma data-bs-config. Eia kekahi, hiki i nā ʻikepili ʻikepili ke hoʻopaʻa i nā waiwai JSON e like me data-bs-delay='{"show":0,"hide":150}'.

inoa ʻAno Default wehewehe
rootMargin kaulahao 0px 0px -25% Intersection Observer rootMargin mau ʻāpana kūpono, i ka helu ʻana i ke kūlana ʻōwili.
smoothScroll boolean false Hiki i ka ʻōwili maʻemaʻe ke kaomi ʻana o ka mea hoʻohana i kahi loulou e pili ana i ka ScrollSpy observables.
target kaula, mea DOM null Hōʻike i ka mea e hoʻopili ai i ka plugin Scrollspy.
threshold pūʻulu [0.1, 0.5, 1] IntersectionObserver paepae komo kūpono, i ka helu ʻana i ke kūlana ʻōwili.

Nā koho i hoʻopau ʻia

A hiki i ka v5.1.3 ke hoʻohana nei mākou i nā koho offset& methodnā koho, i kēia manawa i hoʻopau ʻia a pani ʻia e rootMargin. No ka hoʻopaʻa ʻana i hope, e hoʻomau mākou i ka paʻi ʻana i kahi i hāʻawi ʻia offsetrootMargin, akā e wehe ʻia kēia hiʻohiʻona ma v6 .

Nā ʻano hana

Kaʻina hana wehewehe
dispose Hoʻopau i ka scrollspy o kekahi mea. (Wehe i ka ʻikepili i mālama ʻia ma ka mea DOM)
getInstance ʻO ke ʻano static e loaʻa ai ka laʻana scrollspy pili me kahi mea DOM.
getOrCreateInstance ʻO ke ʻano static e loaʻa ai ka laʻana scrollspy e pili ana me kahi mea DOM, a i ʻole e hana i kahi mea hou inā ʻaʻole i hoʻomaka ʻia.
refresh Ke hoʻohui a wehe paha i nā mea i loko o ka DOM, pono ʻoe e kāhea i ke ʻano hoʻomaha.

Eia kekahi laʻana e hoʻohana ana i ke ʻano hoʻomaha:

const dataSpyList = document.querySelectorAll('[data-bs-spy="scroll"]')
dataSpyList.forEach(dataSpyEl => {
  bootstrap.ScrollSpy.getInstance(dataSpyEl).refresh()
})

Nā hanana

Hanana wehewehe
activate.bs.scrollspy Hoʻomaka kēia hanana i ka mea scroll i ka wā e hoʻāla ʻia ai kahi heleuma e ka scrollspy.
const firstScrollSpyEl = document.querySelector('[data-bs-spy="scroll"]')
firstScrollSpyEl.addEventListener('activate.bs.scrollspy', () => {
  // do something...
})