Principe
Le précédent plugin mélangeait deux choses :
- le contenu du menu
- l’effet accordéon qui y était associé, c’est à dire la présentation « en tiroir ».
Cette nouvelle version du plugin s’occupe uniquement de l’effet accordéon. Il ne s’occupe pas du contenu de ce menu. Le travail peut-être délégué au plugin Menus ou à une noisette Aveline par exemple ou même géré indépendamment en squelette. Il suffira de donner au ul principal du menu la classe accordeon
ou bien de remplir le champ par votre class ou votre identifiant dans la configuration du plugin (ajout du 14 aout 2012).
Il ne s’occupe pas non plus de l’apparence (CSS).
Installation
Le plugin s’installe comme n’importe quel plugin.
Il nécessite toutefois le plugin JQueryUi, qui est livré en standard avec SPIP 3.
À noter qu’il peut évidemment s’installer avec STEP
Création du menu
On peut créer le menu avec le plugin Menus, et l’installer dans son squelette à l’endroit souhaité. Je renvoie donc à la documentation du plugin Menus.
Pour que le menu créé ait un effet accordéon, il suffit de lui accorder la classe accordeon
dans le champ correspondant du plugin Menus.
Attention : pour que l’effet accordéon fonctionne, le menu ne doit pas avoir plus de 2 niveaux.
Exemple
Je souhaite avec un menu accordéon qui « accordéonne » sur les rubriques de premiers niveaux, en affichant le cas échéant les rubriques du niveau inférieur.
Suivant la documentation du plugin Menus :
- j’insère dans mon squelette le code suivant :#INCLURE{fond=inclure/menu, env, identifiant=menu}
- Je crée un menu dont l’identifiant est menu
et auquel j’accorde la classe CSS accordeon
- Dedans je crée une entrée de type « Liste ou arborescence de rubriques » que je limite à 2 niveau.
Un dessin vaut mieux qu’un discours :
Configuration avancée
La configuration permet d’ajouter des options, en suivant la syntaxe : option:valeur,option2:valeur
etc. La liste des options se trouve sur le site de Jquery.
Le panneau de configuration du plugin permet aussi de préciser votre identifiant ou votre class, laissez le à .accordeon
soit sa valeur par défaut si vous ne comprenez pas !
Le panneau de configuration est accessible via :
- Configuration->Accordéon sous SPIP 2.1.
- Squelettes->Menu JQuery Accordéon sous SPIP 3 ou SPIP 2.1 avec le plugin bandeau
Verrouillage de la configuration
Depuis la version 3.2, un webmestre peut verrouiller la configuration du plugin en créant dans son dossier squelettes :
- un fichier accordeon/identifiant.html
contenant l’identifiant du menu et remplaçant le champ « identifiant » du formulaire de configuration.
- un fichier accordeon/options.html
contenant les options du menu (sans les {}
, et remplaçant le champ « options » du formulaire de configuration.
Exemple d’option simple
Il s’agit de demander au menu accordéon de s’ouvrir sur la rubrique courante.
Dans le panneau de configuration, on met
active:'.on a'
En effet, le plugin Menu marque d’une class .on
la rubrique courante.
Exemple d’options complexe
Dans cette illustration, le code demande à déplier en accordéon le menu qui a l’identifiant #listmenu
, il s’applique ici sur un menu fermé de rubriques à 2 niveaux qui se dépliera d’un clic, tandis qu’on accède aux liens de premier niveau par un double-clic. Lorsque la rubrique parente est active, le menu est ouvert sur celle-ci. D’autre part autoHeight: false,
permet de laisser le plugin calculer la hauteur à déplier, évitant de grands blancs si vous n’avez un nombre de sous-rubriques égales…
Voici un exemple de ce code particulier à coller dans les options de la configuration, sans ajout de parenthèses ou d’accolades.
event: 'click',
collapsible:true, // to close all
header: 'a.hac',
active: 'a.hac.on',
autoHeight: false,
navigation: true,
navigationFilter: function(){
$('#listmenu a.hac').dblclick(function(){
lien=$(this).attr('href');
document.location = lien;
return true;
});
}
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |