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-top
i
.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;
}