Przyrostek Bootstrap JS


Afiks JS (affix.js)

Wtyczka Affix umożliwia przymocowanie (zablokowanie) elementu do obszaru na stronie. Jest to często używane z menu nawigacyjnymi lub przyciskami ikon społecznościowych, aby „przykleić” je do określonego obszaru podczas przewijania strony w górę iw dół.

Wtyczka włącza i wyłącza to zachowanie (zmienia wartość pozycji CSS ze statycznej na stałą) w zależności od pozycji przewijania.

Wtyczka afiksu przełącza między trzema klasami: .affix, .affix-topi .affix-bottom. Każda klasa reprezentuje określony stan. Musisz dodać właściwości CSS, aby obsłużyć rzeczywiste pozycje, z wyjątkiem position:fixed klasy .affix.

Aby uzyskać więcej informacji, przeczytaj nasz samouczek dotyczący afiksu Bootstrap .

Wskazówka: Wtyczka Affix jest często używana razem z wtyczką Scrollspy .


Przez dane-* Atrybuty

Dodaj data-spy="affix"do elementu, który chcesz szpiegować, oraz atrybut, aby obliczyć pozycję zwoju.data-offset-top|bottom="number"

Przykład

<ul class="nav nav-pills nav-stacked" data-spy="affix" data-offset-top="205">

Przez JavaScript

Włącz ręcznie za pomocą:

Przykład

$('.nav').affix({offset: {top: 150} });


Opcje przyklejania

Opcje można przekazywać za pomocą atrybutów danych lub JavaScript. W przypadku atrybutów danych dołącz nazwę opcji do data-, tak jak w data-offset="".

Name Type Default Description
offset number | object | function 10 Specifies the number of pixels to offset from screen when calculating position of scroll. When using a single number, the offset is added to both top and bottom directions. If you only want to control the top or the bottom, use an object, like offset: {top:25}

For multiple offsets, use offset: {top:25, bottom:50}

Tip: Use a function to dynamically provide an offset (can be useful for responsive designs)
target selector | node | element the window object Specifies the target element of the affix

Przymocuj wydarzenia

W poniższej tabeli wymieniono wszystkie dostępne zdarzenia afiksów.

Event Description Try it
affix.bs.affix Occurs before fixed positioning is added to the element (e.g, when the .affix-top class is about to be replaced with the .affix class)
affixed.bs.affix Occurs after fixed positioning is added to the element (e.g., after the .affix-top class is replaced with the .affix class)
affix-top.bs.affix Occurs before the top element returns to its original (non-fixed) position (e.g., the .affix class is about to be replaced with .affix-top)
affixed-top.bs.affix Occurs after the top element returns to its original (non-fixed) position (e.g., the .affix class has been replaced with .affix-top)
affix-bottom.bs.affix Occurs before the bottom element returns to its original (non-fixed) position (e.g., the .affix class is about to be replaced with .affix-bottom)
affixed-bottom.bs.affix Occurs after the bottom element returns to its original (non-fixed) position (e.g., the .affix class has been replaced with .affix-bottom)

Więcej przykładów

Umieszczony pasek nawigacyjny

Utwórz umieszczone poziome menu nawigacyjne:

Przykład

<nav class="navbar navbar-inverse" data-spy="affix" data-offset-top="197">

Używanie jQuery do automatycznego umieszczania paska nawigacyjnego

Użyj metody outerHeight() jQuery, aby umieścić pasek nawigacyjny po przewinięciu przez użytkownika określonego elementu (<header>):

Przykład

$(".navbar").affix({offset: {top: $("header").outerHeight(true)} });

Scrollspy i afiks

Korzystanie z wtyczki Affix razem z wtyczką Scrollspy :

Menu poziome (pasek nawigacyjny)

<body data-spy="scroll" data-target=".navbar" data-offset="50">

<nav class="navbar navbar-inverse" data-spy="affix" data-offset-top="197">
...
</nav>

</body>

Menu pionowe (Sidenav)

<body data-spy="scroll" data-target="#myScrollspy" data-offset="15">

<nav class="col-sm-3" id="myScrollspy">
  <ul class="nav nav-pills nav-stacked" data-spy="affix" data-offset-top="205">
  ...
</nav>

</body>

Animowany pasek nawigacyjny na afiksie

Użyj CSS do manipulowania różnymi klasami .affix:

Przykład — zmiana koloru tła i wypełnienia paska nawigacyjnego podczas przewijania

.affix {
  top: 0;
  width: 100%;
  -webkit-transition: all .5s ease-in-out;
  transition: all .5s ease-in-out;
  background-color: #F44336;
  border-color: #F44336;
}

.affix a {
  color: #fff !important;
  padding: 15px !important;
  -webkit-transition: all .5s ease-in-out;
  transition: all .5s ease-in-out;
}

.affix-top a {
  padding: 25px !important;
}

Przykład — wsuń pasek nawigacyjny

.affix {
  top: 0;
  width: 100%;
  -webkit-transition: all .5s ease-in-out;
  transition: all .5s ease-in-out;
}

.affix-top {
  position: static;
  top: -35px;
}