Inclusions ajax
Les inclusions qui possèdent le critère {ajax}
permettent de recharger dans la page seulement la partie incluse. La plupart du temps, il faudra aussi inclure le critère {env}
dès lors qu’il y a une pagination dans l’inclusion.
<INCLURE{fond=inclure/fichier}{env}{ajax} />
Dans l’inclusion, le rechargement ajax peut se faire au moyen d’un lien (voir Liens AJAX), d’un #BOUTON_ACTION (voir https://spip.net/4583) ou d’un formulaire ajax (voir https://spip.net/3800).
Par défaut, le rechargement ajax provoque un scroll en haut du bloc ajax. On peut toutefois modifier ce comportement :
- définir la destination de ce scroll au moyen d’une ancre dédiée à l’intérieur du bloc rechargé :
<a name="ajax_ancre" href="#truc"></a>
- désactiver le scroll en utilisant une classe "noscroll" sur les liens, les #BOUTON_ACTION ou les submit des formulaires ajax qui provoquent ce rechargement.
Pour un formulaire, on peut activer ajax pour les étapes de saisies et de vérifications de la conformité des données saisies, mais le désactiver pour l’affichage qui suit la validation : voir « Traitement sans AJAX ».
Inclusions ajax avec pagination
Lorsque l’on couple ce critère d’inclusion avec la balise #PAGINATION
, les liens de pagination deviennent alors automatiquement AJAX. Plus précisément, tous les liens du squelette inclus contenus dans une classe CSS pagination
.
<p class="pagination">#PAGINATION</p>