JavaScript
Alerte
Afficher une boîte de dialogue personnalisée.
<div class="modal-overlay">
<div class="modal">
<div class="modal-heading">
<span class="modal-title">Titre de la boîte de dialogue</span>
</div>
<div class="modal-body">
<p>Contenu de la boîte de dialogue</p>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-default" data-role="modal-cancel">Fermer</button>
<button type="button" class="btn btn-primary" data-role="modal-confirm">Confirmer</button>
</div>
</div>
</div>
Usage via JavaScript
Options
Nom | Type | Défaut | Description |
---|---|---|---|
buttonCancel |
string | 'Fermer' | Label du bouton de fermeture de la fenêtre d'alerte |
buttonConfirm |
string | null | Label du bouton de confirmation |
classname |
string | null | Classe appliquée sur la zone de contenu de la fenêtre d'alerte. |
content |
string|object | null | Contenu de la fenêtre d'alerte. Il peut s'agir d'une chaîne de caractère ou d'un objet jQuery. Option obligatoire ! |
height |
number| 'auto' | null | Hauteur de la zone de contenu (.modal-body ) de la fenêtre d'alerte. Si la valeur est définie sur 'auto' , la hauteur s'ajustera sur la hauteur du contenu. |
id |
string | null | ID de la fenêtre d'alerte |
title |
string | null | Titre de la fenêtre d'alerte |
type |
string | null | Customisation de la fenêtre. valeur possible : error|primary|success|warning |
width |
number | null | Largeur de la fenêtre d'alerte. |
Méthodes
$.modal(options)
Afficher une fenêtre d'alerte par défaut et définir ses options.
$.modal({content: 'Contenu'});
$.modal('hide')
Fermer la fenêtre d'alerte
Événements
Événement | Description |
---|---|
on.cancel.modal |
Cet événement est appelé au clic sur le bouton de fermeture et entraîne la fermeture de la fenêtre. |
on.confirm.modal |
Cet événement est appelé au clic sur le bouton de confirmation et entraîne par défaut la fermeture de la fenêtre. Renvoyer false empêchera la fermeture de la fenêtre. |
<p>
<a href="javascript:void(0)" id="launchAlert" class="btn btn-primary btn-large">Démonstration</a>
</p>
<script>
$('#launchAlert').click(function(){
$.modal({
buttonCancel: 'Annuler',
buttonConfirm: 'Confirmer',
content: '<p class="text-center">Voici le contenu centré de la fenêtre d\'alerte</p>'
})
.on({
'on.confirm.modal': function(){
alert('confirmed !');
},
'on.cancel.modal': function(){
alert('canceled !');
}
});
});
</script>
Accordéon
Simple
Afficher / masquer un élément .collapse
.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin eget eros turpis. Mauris pellentesque accumsan gravida. Pellentesque sit amet turpis lorem.
Suspendisse varius mollis rutrum. Suspendisse sed venenatis tellus. Suspendisse feugiat tortor ac purus maximus, quis tempor ipsum pretium. Cras volutpat, nisi viverra semper ultricies, sem urna faucibus nunc, in varius arcu orci ac lectus.
<p>
<button class="btn btn-large btn-primary" data-target="#collapseExample" data-toggle="collapse">Démonstration</button>
</p>
<div class="collapse" id="collapseExample">
...
</div>
Multiple
Afficher / masquer un élément .collapse
au sein d'un groupe d'éléments.
<div class="panel-group" id="accordion">
<div class="panel open">
<div class="panel-heading">
<a class="panel-control" data-accordion="#accordion" data-parent=".panel" data-toggle="collapse" href="#panel1">Panel 1</a>
</div>
<div class="panel-body collapse in" id="panel1">...</div>
</div>
<div class="panel">
<div class="panel-heading">
<a class="panel-control" data-accordion="#accordion" data-parent=".panel" data-toggle="collapse" href="#panel2">Panel 2</a>
</div>
<div class="panel-body collapse" id="panel2">...</div>
</div>
<div class="panel">
<div class="panel-heading">
<a class="panel-control" data-accordion="#accordion" data-parent=".panel" data-toggle="collapse" href="#panel3">Panel 3</a>
</div>
<div class="panel-body collapse" id="panel3">...</div>
</div>
</div>
Usage
Via attributs data
Appel du plugin Collapse via data-toggle="collapse"
sur l'élément défini par data-target
ou href
.
Via JavaScript
$('.collapse').collapse();
Options
Nom | Type | Défaut | Description |
---|---|---|---|
accordion |
selecteurCSS | null | Identifiant CSS du groupe d'éléments. |
orientation |
'vertical'|'horizontal' | 'vertical' | Si accordion est défini sur null , permet d'ouvrir l'élément horizontalement. Conçu pour un menu de navigation. |
parent |
selecteurCSS | null | Identifiant CSS de l'élément parent sur lequel sera reporté la class .open après ouverture de l'élément. |
show |
boolean | true | Afficher / masquer l'élément. |
Méthodes
.collapse(options)
Appel du plugin Collapse en JavaScript :
$('.collapse').collapse({
accordion: '#accordion',
parent: '.panel'
});
.collapse('show')
Ouvrir en accordéon un élément .collapse
.
.collapse('hide')
Fermer en accordéon un élément .collapse
.
.collapse('toggle')
Ouvrir / Fermer un élément .collapse
en accordéon.
Événements
Événement | Description |
---|---|
on.show.collapse |
Cet événement se déclenche avant l'ouverture de l'élément. |
on.shown.collapse |
Cet événement se déclenche dès que l'élément est complètement ouvert. |
on.hide.collapse |
Cet événement se déclenche avant la fermeture de l'élément. |
on.hidden.collapse |
Cet événement se déclenche dès que l'élément est complètement fermé. |
$('.collapse').on('on.show.collapse', function(){
//action…
});
Carousel
Créer un diaporama d'images.
Si Jquery Mobile est disponible, sur les terminaux mobiles, le passage d'une image à l'autre s'effectuera d'un mouvement de doigt vers la gauche ou la droite.
<div class="carousel" id="carouselExample">
<ol class="carousel-indicators">
<li data-slide-to="0" data-target="#carouselExample" class="active"></li>
<li data-slide-to="1" data-target="#carouselExample"></li>
<li data-slide-to="2" data-target="#carouselExample"></li>
</ol>
<div class="carousel-inner">
<div class="item active">
<img src="...">
<div class="carousel-caption">
<h3>Titre de l'image 1</h3>
<p>Courte description de l'image 1</p>
</div>
</div>
<div class="item">...</div>
<div class="item">...</div>
</div>
<a class="left carousel-control" href="#carouselExample" data-slide="prev">
<i class="fa fa-chevron-left"></i>
</a>
<a class="right carousel-control" href="#carouselExample" data-slide="next">
<i class="fa fa-chevron-right"></i>
</a>
</div>
Usage
Via attributs data
Utiliser des attributs data
pour contrôler la position du caroussel. data-slide
accepte les valeurs prev
ou next
, permettant respectivement le passage à l'image précédente ou suivante. Alternativement, utiliser data-slide-to
pour définir l'index de l'image à afficher, la première ayant 0
pour index.
Via JavaScript
Appel du plugin Carousel en JavaScript :
$(window).on('load', function(){
$('.carousel').carousel();
});
Options
Les options peuvent être définies via des attributs data
ou lors de l'appel du plugin Carousel en JavaScript.
Nom | Type | Par défaut | Description |
---|---|---|---|
cycling |
number | false | Laps de temps entre deux images, exprimé en millisecondes. Si la valeur est définie sur false , le passage à l'image suivante ne sera pas automatique. |
height |
number | 'auto' | false | Hauteur du carousel en pixels. Si la valeur est définie sur 'auto' , la hauteur du carousel s'ajustera sur la plus haute image. |
heightfrom |
number | false | Résolution minimale à partir de laquelle la hauteur height est appliquée. |
heightto |
number | false | Résolution maximale jusqu'à laquelle la hauteur height est appliquée. |
hidecaption |
boolean | false | Afficher la légende uniquement lors du survol du carousel. |
pauseonhover |
boolean | false | Suspendre le déroulement du diaporama lors de son survol. |
thumbnails |
boolean | false | Contrôle du diaporama à partir de vignettes. |
transition |
string | 'slide' | Type de transition entre deux images. valeurs possibles : 'slide' | 'fade' |
Méthodes
.carousel(options)
Initialiser le caroussel et définir ses options.
$('.carousel').carousel({cycling: 5000});
.carousel('play')
Lancer la lecture du caroussel.
.carousel('pause')
Stopper la lecture du caroussel.
.carousel(number)
Afficher une image spécifique du caroussel, via son index.
.carousel('prev')
Passer à l'image précédente.
.carousel('next')
Passer à l'image suivante.
.carousel('current')
Récupérer l'index de l'image affichée dans le carousel.
Événements
Événement | Description |
---|---|
on.afterSlide.carousel |
Cet événement se déclenche après le changement d'image. |
on.beforeSlide.carousel |
Cet événement se déclenche avant le changement d'image. |
on.thumbnailsLoaded.carousel |
Cet événement se déclenche lorsque le chargement des vignettes est effectué. |
$('.carousel').on('on.beforeSlide.carousel', function(){
// action…
});
Avec vignettes
<div class="carousel" data-thumbnails="true" data-transition="fade">
...
</div>
Clickable
Rendre cliquable la surface totale d'un élément.
- Publié le 10/04/2016
- Dans Voyages
<div class="media-list media-stacked">
<div class="media" data-provide="clickable" data-classname="pointer">
<div class="media-object">
<a href="http://www.e-monsite.com">
<img alt="Img" height="140" width="140" src="...">
</a>
</div>
<div class="media-body">
<p class="h4 media-heading"><a href="http://www.e-monsite.com">Titre de l'élément</a></p>
...
</div>
</div>
</div>
Usage
Via attributs data
Activation automatique sur tout élément disposant de l'attribut data-provide="clickable"
.
Via JavaScript
Appel de l'effet clickable sur tout élément via JavaScript.
$('.media').clickable({classname:'pointer'});
Options
Les options peuvent être définies via des attributs data
ou lors de l'appel du plugin en JavaScript.
Nom | Type | Défault | Description |
---|---|---|---|
classname |
string | null | Classe appliquée sur l'élément lors du survol. |
maxwidth |
number | 991 | Résolution maximale en pixels jusqu'à laquelle la surface totale de l'élément sera cliquable. |
target |
selecteur CSS | null | Sélecteur CSS permettant de cibler le lien contenant l'url de destination. Si non définie, l'url de destination sera celle du premier lien rencontré dans l'élément. |
Fix
Fixer la position verticale d'un élément, comme par exemple le menu de navigation sur cette page.
Usage
Via attributs data
Activation automatique sur tout élément doté de l'attribut data-provide="fix"
.
<div data-provide="fix" data-from="50">...</div>
Via JavaScript
Appel du plugin Fix en JavaScript.
$('#sidebar').find('.nav').fix();
Options
Les options peuvent être définies via des attributs data
ou lors de l'appel du plugin en JavaScript.
Nom | Type | Défaut | Description |
---|---|---|---|
classname |
string | null | Nom de la classe appliquée à l'élément lorsqu'il est fixé. |
from |
number | sélecteur CSS | 0 | Valeur de défilement de la page en pixels à partir de laquelle l'élément sera fixé. Si un sélecteur CSS est défini, l'élément sera fixé dès que le bord supérieur de l'élément ciblé atteindra le bord supérieur de la page. |
offset |
number | 0 | Valeur de compensation en pixels, permettant d'anticiper la fixation de l'élément. |
to |
number | sélecteur CSS | null | Valeur de défilement de la page en pixels jusqu'à laquelle l'élément sera fixé. Si un sélecteur CSS est défini, l'élément sera fixé tant que le bord inférieur de l'élément ciblé ne sera pas aligné avec la bord inférieur de l'élément fixé. |
viewportmax |
number | null | Largeur maximale de la fenêtre du navigateur jusqu'à laquelle l'élément sera fixé. |
viewportmin |
number | null | Largeur minimale de la fenêtre du navigateur à partir de laquelle l'élément sera fixé. |
width |
number | sélecteur CSS | null | Largeur en pixels de l'élément fixé. Si un sélecteur CSS est défini, la largeur de l'élément fixé sera celle de l'élément ciblé par le sélecteur. |
Méthodes
.fix(options)
Initialiser le plugin Fix et définir ses options.
$('#sidebar').find('.nav').fix({from:50});
.fix('refresh'[, options])
Actualiser les paramètres de positionnement de l'élément fixé (par exemple, suite à un redimensionnement de la page).
Un objet passé en second argument permet de forcer la valeur d'un ou plusieurs paramètres définis lors de l'instanciation du plugin.
$(window).on({
'load' : function(){
//Instanciation du plugin
var $offset = $('header').height();
$('#sidebar').find('.nav').fix({offset : $offset});
},
'resize' : function(){
//Actualisation du plugin
var $offset = $('header').height();
$('#sidebar').find('.nav').fix('refresh', {offset : $offset});
}
});
.fix('reset')
Supprime le plugin de l'élément.
Événements
Événement | Description |
---|---|
on.end.fix |
Cet événement se déclenche dès que l'élément n'est plus fixé. |
on.refresh.fix |
Cet événement se déclenche dès que la position de l'élément est actualisée. |
on.start.fix |
Cet événement se déclenche dès que l'élément est fixé. |
$('#sidebar').find('.nav').on('on.start.fix', function(){
// action…
});
Form validation
Évaluer les éléments d'un formulaire avant validation.
Ajouter la classe .has-required
sur .control-group
pour évaluer le champ correspondant.
<form action="#" data-provide="validate">
<div class="control-group control-type-text has-required">
<label for="requiredInput">Champ requis</label>
<div class="controls">
<input id="requiredInput" placeholder="Champ requis" type="text">
</div>
</div>
<div class="control-group control-type-checkbox has-required">
<span class="as-label">Choix de cases à cocher requis</span>
<div class="controls">
<label class="checkbox">
<input name="requiredChekboxes" type="checkbox" value="1"> Cochez-moi
</label>
<label class="checkbox">
<input name="requiredChekboxes" type="checkbox" value="2"> Cochez-moi
</label>
</div>
</div>
<div class="control-group control-type-radio has-required">
<span class="as-label">Choix de bouton radio requis</span>
<div class="controls">
<label class="radio">
<input name="requiredRadios" type="radio" value="option1"> Option 1
</label>
<label class="radio">
<input name="requiredRadios" type="radio" value="option2"> Option 2
</label>
</div>
</div>
<div class="control-group form-actions">
<div class="controls">
<input class="btn btn-primary" type="submit" value="Valider">
</div>
</div>
</form>
Usage
Via attributs data
Activation automatique sur tout formulaire doté de l'attribut data-provide="validate"
.
Via JavaScript
Appel du plugin Validate en JavaScript.
$('form').validate();
Événements
Événement | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
on.submit.validate(e, ins[object]) |
Cet événement se déclenche dès la soumission du formulaire.
|
||||||||||||
on.success.validate(e, ins[object]) |
Cet événement se déclenche avant l'envoi du formulaire.
|
||||||||||||
on.error.validate(e, controls[object]) |
Cet événement se déclenche en cas d'erreur dans le formulaire.
|
$('form').on({'on.error.validate': function(e, controls){
var errorMsg = '';
for(var i = 0; i < controls.length; i++){
if(!controls[i].isvalid)
errorMsg += '<li>' + controls[i].label + '</li>';
}
$.modal({
buttonCancel: 'Fermer',
content: '<ul class="list-unstyled">' + errorMsg + '</ul>',
title: 'Merci de compléter les champs suivants :',
type: 'error'
});
});
Menus déroulants
Ajouter un menu déroulant à un bouton.
<div class="dropdown">
<button class="btn btn-default" data-toggle="dropdown" type="button">Menu déroulant</button>
<ul class="dropdown-menu">
<li><a href="#">Élément de menu</a></li>
<li><a href="#">Élément de menu</a></li>
<li><a href="#">Élément de menu</a></li>
</ul>
</div>
Définir une méthode d'ouverture du menu
Usage
Via attributs data
Activation automatique sur tout élément disposant de l'attribut data-toggle="dropdown"
.
Via JavaScript
Appel du plugin Dropdown en JavaScript.
$('button').dropdown({animation:'fade'});
Options
Les options peuvent être définies via des attributs data
ou lors de l'appel du plugin en JavaScript.
Nom | Type | Défaut | Description |
---|---|---|---|
animation |
string | false | Méthode d'ouverture du menu déroulant. Valeur possible : fade|slide |
Méthodes
.dropdown(options)
Initialiser le plugin Dropdown et définir ses options.
.dropdown('show')
Affiche un menu déroulant.
.dropdown('hide')
Cache un menu déroulant.
.dropdown('toggle')
Affiche ou cache un menu déroulant.
.dropdown('reset')
Supprime le plugin de l'élément.
Événements
Événement | Description |
---|---|
on.hide.dropdown |
Cet événement se déclenche avant la disparition du menu déroulant. |
on.hidden.dropdown |
Cet événement se déclenche après la disparition du menu déroulant. |
on.show.dropdown |
Cet événement se déclenche avant l'apparition du menu déroulant. |
on.shown.dropdown |
Cet événement se déclenche après l'apparition du menu déroulant. |
$('button').on('on.hide.dropdown', function(){
// action…
});
Parallax
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Mauris sed lectus ut tortor efficitur dignissim ac sit amet ante. Morbi sit amet ligula dui. Sed sed tellus non arcu elementum dignissim. In elementum placerat aliquam. Fusce dapibus ultrices justo. Aliquam consectetur nunc tortor, et facilisis diam eleifend a. Vivamus tellus turpis, condimentum eu nisi tempor, semper dictum est.
Morbi sit amet ligula dui. Sed sed tellus non arcu elementum dignissim. In elementum placerat aliquam. Fusce dapibus ultrices justo. Vivamus tellus turpis, condimentum eu nisi tempor, semper dictum est.
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Mauris sed lectus ut tortor efficitur dignissim ac sit amet ante. Morbi sit amet ligula dui. Sed sed tellus non arcu elementum dignissim. In elementum placerat aliquam. Fusce dapibus ultrices justo. Aliquam consectetur nunc tortor, et facilisis diam eleifend a. Vivamus tellus turpis, condimentum eu nisi tempor, semper dictum est.
Proin est urna, sollicitudin vel sodales in, laoreet vitae diam.
<div id="parallax1"></div>
<div class="bg-primary">...</div>
<div id="parallax2"></div>
<div class="bg-success">...</div>
<script>
$('#parallax1').parallax({
background: 'http://ems-framework.e-monsite.com/medias/images/parallax01.jpg',
height: '70%',
scroller: 'parent'
});
$('#parallax2').parallax({
background: 'http://ems-framework.e-monsite.com/medias/images/parallax02.jpg',
height: '50%',
inertia: .3,
posy: 'bottom',
scroller: 'parent'
});
</script>
Usage
Via attributs data
Activation automatique sur tout élément de type block disposant de l'attribut data-provide="parallax"
.
Via JavaScript
Appel de l'effet Parallax sur tout élément de type block via JavaScript.
$('#parallaxExample2').parallax({background:'img02.jpg'});
Options
Les options peuvent être définies via des attributs data
ou lors de l'appel du plugin en JavaScript.
Nom | Type | Défaut | Description |
---|---|---|---|
background |
string | null | Url de l'image de fond. Option obligatoire ! |
height |
string | null | Hauteur de l'élément. |
inertia |
number | .5 | Vitesse en fonction du scroll. Exemple: .1 = 1/10 ème de la vitesse du scroll. |
posx |
string | 'center' | Position horizontale de l'image. Valeur possible : left|center|right |
posy |
string | 'center' | Position verticale de l'image. Valeur possible : top|center|bottom |
responsive |
boolean | true | Ajustement de la largeur de l'image à la largeur de l'écran |
scroller |
string | 'window' | Élément rattaché au scroll. Valeur possible : parent|window |
viewportmin |
number | null | Largeur minimale de la fenêtre du navigateur à partir de laquelle l'effet Parallax sera appliqué. |
Recommandations
Images utilisées
- Privilégier un format horizontal, un ratio de 3tiers/2tiers est un bon compromis. Exemple : 1920 x 1280px.
- La taille des images doit être conséquente afin d'éviter une perte de qualité sur grand écran. Une largeur de 1920px est un bon compromis.
- Préférer le format .jpg pour les photographies et le format .png pour les illustrations.
- Afin d'optimiser le temps de chargement, compressez vos images à l'aide d'un service en ligne comme par exemple Tinyjpg.
Scrollspy
Application automatique d'une classe classname
sur un élément de navigation en fonction de la position de défilement. Un click sur le lien de navigation active le défilement jusqu'à l'élément correspondant.
L'attribut href
des liens de navigation doit reprendre l'attribut id
de l'élément correspondant.
Partie 1
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam non elit diam. Aenean ultrices vel sapien ut pellentesque. Praesent cursus venenatis nulla, convallis molestie libero placerat ac. Praesent varius sapien sollicitudin, dictum ligula vitae, euismod tortor. Cras egestas, mauris in dictum faucibus, turpis velit tristique nisi, nec pretium magna massa quis lorem. Sed nec tristique leo. Donec a dui erat. Nam sagittis, velit non pellentesque porta, lacus nisl euismod neque, et egestas nisi nibh sit amet augue. Aenean a posuere tellus. Proin viverra rhoncus eleifend. Sed eu nulla dapibus, tristique velit vel, rutrum sapien. Curabitur a turpis nisi. Vestibulum pretium vitae lorem in lacinia. Donec non ipsum in felis faucibus viverra.
Partie 2
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam non elit diam. Aenean ultrices vel sapien ut pellentesque. Praesent cursus venenatis nulla, convallis molestie libero placerat ac. Praesent varius sapien sollicitudin, dictum ligula vitae, euismod tortor. Cras egestas, mauris in dictum faucibus, turpis velit tristique nisi, nec pretium magna massa quis lorem. Sed nec tristique leo. Donec a dui erat. Nam sagittis, velit non pellentesque porta, lacus nisl euismod neque, et egestas nisi nibh sit amet augue. Aenean a posuere tellus. Proin viverra rhoncus eleifend. Sed eu nulla dapibus, tristique velit vel, rutrum sapien. Curabitur a turpis nisi. Vestibulum pretium vitae lorem in lacinia. Donec non ipsum in felis faucibus viverra.
Partie 3
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam non elit diam. Aenean ultrices vel sapien ut pellentesque. Praesent cursus venenatis nulla, convallis molestie libero placerat ac. Praesent varius sapien sollicitudin, dictum ligula vitae, euismod tortor. Cras egestas, mauris in dictum faucibus, turpis velit tristique nisi, nec pretium magna massa quis lorem. Sed nec tristique leo. Donec a dui erat. Nam sagittis, velit non pellentesque porta, lacus nisl euismod neque, et egestas nisi nibh sit amet augue. Aenean a posuere tellus. Proin viverra rhoncus eleifend. Sed eu nulla dapibus, tristique velit vel, rutrum sapien. Curabitur a turpis nisi. Vestibulum pretium vitae lorem in lacinia. Donec non ipsum in felis faucibus viverra.
Partie 4
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam non elit diam. Aenean ultrices vel sapien ut pellentesque. Praesent cursus venenatis nulla, convallis molestie libero placerat ac. Praesent varius sapien sollicitudin, dictum ligula vitae, euismod tortor. Cras egestas, mauris in dictum faucibus, turpis velit tristique nisi, nec pretium magna massa quis lorem. Sed nec tristique leo. Donec a dui erat. Nam sagittis, velit non pellentesque porta, lacus nisl euismod neque, et egestas nisi nibh sit amet augue. Aenean a posuere tellus. Proin viverra rhoncus eleifend. Sed eu nulla dapibus, tristique velit vel, rutrum sapien. Curabitur a turpis nisi. Vestibulum pretium vitae lorem in lacinia. Donec non ipsum in felis faucibus viverra.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam non elit diam. Aenean ultrices vel sapien ut pellentesque. Praesent cursus venenatis nulla, convallis molestie libero placerat ac. Praesent varius sapien sollicitudin, dictum ligula vitae, euismod tortor. Cras egestas, mauris in dictum faucibus, turpis velit tristique nisi, nec pretium magna massa quis lorem. Sed nec tristique leo.
Donec a dui erat. Nam sagittis, velit non pellentesque porta, lacus nisl euismod neque, et egestas nisi nibh sit amet augue. Aenean a posuere tellus. Proin viverra rhoncus eleifend. Sed eu nulla dapibus, tristique velit vel, rutrum sapien. Curabitur a turpis nisi. Vestibulum pretium vitae lorem in lacinia. Donec non ipsum in felis faucibus viverra.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam non elit diam. Aenean ultrices vel sapien ut pellentesque. Praesent cursus venenatis nulla, convallis molestie libero placerat ac. Praesent varius sapien sollicitudin, dictum ligula vitae, euismod tortor. Cras egestas, mauris in dictum faucibus, turpis velit tristique nisi, nec pretium magna massa quis lorem.
<ul class="nav nav-tabs" id="scrollspy-target">
<li><a href="#part1">Partie 1</a></li>
...
</ul>
<div data-provide="scrollspy" data-target="#scrollspy-target" >
<div id="part1">...</div>
...
</div>
Usage
Via attributs data
Activation automatique sur tout élément disposant de l'attribut data-provide="scrollspy"
.
Via JavaScript
Appel de l'effet Scrollspy sur cette page et définition de la navigation contenue dans <div id="sidebar">
en tant que cible :
$('body').scrollspy({
target: '#sidebar',
speed: 1000
});
Options
Les options peuvent être définies via des attributs data
ou lors de l'appel du plugin en JavaScript.
Nom | Type | Défaut | Description |
---|---|---|---|
classname |
string | 'active' | Classe appliquée sur l'élément de navigation. |
offset |
number | 0 | Valeur de compensation en pixels, permettant d'anticiper l'application de la classe classname . |
speed |
number | 240 | Vitesse du défilement en millisecondes lors du clique sur un élément de navigation. |
target |
Sélecteur CSS | null | Sélecteur CSS permettant de cibler l'élément contenant la navigation. Option obligatoire ! |
Méthodes
.scrollspy(options)
Initialiser l'effet et définir ses options.
$('body').scrollspy();
Événements
Événement | Description |
---|---|
on.beforeScroll.scrollspy |
Cet événement se déclenche avant le défilement de l'élément. |
on.afterScroll.scrollspy |
Cet événement se déclenche après le défilement de l'élément. |
$('body').on('on.beforeScroll.scrollspy', function(){
// action…
});
Sur les éléments de navigation.
Événement | Description |
---|---|
on.start.scrollspy |
Cet événement se déclenche dès que la classe classname est appliquée sur l'élément. |
on.stop.scrollspy |
Cet événement se déclenche dès que la classe classname est supprimée de l'élément. |
$('#sidebar').find('a').on('on.start.scrollspy', function(){
// action…
});
Tooltip
Afficher du contenu dans une info-bulle.
<ul class="list-inline">
<li><a href="#" data-toggle="tooltip" title="Tooltip au-dessus">Au dessus</a></li>
<li><a href="#" data-toggle="tooltip" title="Tooltip au dessous" data-position="bottom">Au dessous</a></li>
<li><a href="#" data-toggle="tooltip" title="Tooltip à gauche" data-position="left">À gauche</a></li>
<li><a href="#" data-toggle="tooltip" title="Tooltip à droite" data-position="right">À droite</a></li>
</ul>
Positionnement relatif à la souris
<p>
<a href="#" data-toggle="tooltip" title="Tooltip au dessus" data-origin="mouse" data-container="body">Relatif à la souris</a>
</p>
Usage
Via attributs data
Activation automatique sur tout élément disposant de l'attribut data-toggle="tooltip"
.
Via JavaScript
Appel du plugin Tooltip en JavaScript :
$('.btn').tooltip();
Options
Les options peuvent être définies via des attributs data
ou lors de l'appel du plugin Tooltip en JavaScript.
Nom | Type | Par défaut | Description |
---|---|---|---|
animation |
boolean | true | Animer l'infobulle lors de son apparition. |
bgcolor |
string | null | Couleur de fond de l'infobulle. |
classname |
string | null | Classe appliquée sur l'infobulle. |
color |
string | null | Couleur du texte de l'infobulle. |
container |
string|false | false | Élément à la fin duquel l'infobulle sera ajoutée via append . Par défaut l'infobulle est insérée directement après l'élément. |
content |
string | [title] | Contenu de l'infobulle. Si non renseigné, la valeur de l'attribut title est repris. |
event |
string | 'hover focus' | Évènement déclenchant l'apparition de l'infobulle. Valeurs possibles : 'hover'|'focus'|'click'|'manual' . |
html |
boolean | false | Définir le contenu de l'infobulle en tant que code HTML. |
id |
string | null | Id assigné à l'infobulle. |
origin |
string | 'default' | Point d'origine de l'infobulle. Valeurs possibles : 'default' | 'center' | 'mouse' . |
position |
string | 'top' | Position de l'infobulle par rapport à l'élément. Valeurs possibles : 'top' | 'right' | 'bottom' | 'left' . |
Méthodes
.tooltip(options)
Initialiser l'infobulle et définir ses options.
$('.btn').tooltip({html: true});
.tooltip('show')
Affiche une infobulle.
.tooltip('hide')
Cache une infobulle.
.tooltip('toggle')
Affiche ou cache une infobulle.
.tooltip('reset')
Supprime une infobulle rattachée à un élément.
Événements
Événement | Description |
---|---|
on.show.tooltip |
Cet événement se déclenche avant l'apparition de l'infobulle. |
on.shown.tooltip |
Cet événement se déclenche après l'apparition de l'infobulle. |
on.hide.tooltip |
Cet événement se déclenche avant la disparition de l'infobulle. |
on.hidden.tooltip |
Cet événement se déclenche après la disparition de l'infobulle. |
$('[data-toggle="tooltip"]').on('on.shown.tooltip', function(){
// action…
});
Utiles
$.isMobile()
Détecter si le terminal est un appareil mobile.
if($.isMobile())
{
//it's a mobile terminal
}
else
{
//it's not a mobile terminal
}
$.browser()
Détecter le navigateur.
Méthodes
$.browser('version')
Détecter la version du navigateur.