fr   gb


Arbor

Paramètres d'affichage

Ouvrez votre fichier des données de l'arborescence dans un éditeur de texte.

Les paramètres sont représentés par le bloc de lignes précédant l'arborescence. Chaque ligne est de type :

'nom_du_paramètre' => valeur,

Modifiez leurs valeurs en fonction de vos besoins, en fonction des indications de la liste des paramètres ci-dessous.

Ne pas oublier les virgules à la fin des lignes !

up1. [ urlcompact ] Compactage d'url

'urlcompact' => 1, // l'url sera compactée

'urlcompact' => 0, // l'url ne sera pas compactée

Le "compactage d'url" s'applique uniquement à la longue chaîne d'état de l'arborescence qui est passée dans les paramètres de chaque lien de l'arborescence (paramètre &zc=...). Le compactage est très utile dans les cas suivants :

* pour les grosses arborescences aux multiples lignes, dont les liens aux longues url non compactées alourdissent le code Html de la page et pourraient éventuellement dépasser la capacité du navigateur concernant la longueur des url.

* si vous voulez récupérer l'url comme cible d'un lien qui ouvrira l'arborescence dans un état précis. Sans compactage, l'url est vraiment très longue...

Pour de petits menus de quelques lignes, vous pouvez fort bien désactiver le compactage car il augmente (légèrement) la charge du serveur, en effet le script doit décompacter la chaîne pour pouvoir la modifier puis doit la recompacter pour la joindre aux url.

up2. [ icpath ] Répertoire des icônes

Chemin relatif du répertoire de stockage des icônes réactives utilisées par l'affichage en arborescence : icônes de treillis et icônes symboliques (voir plus bas).

ATTENTION, il s'agit du chemin relatif au document incluant l'arborescence et non relatif au script lui-même !

Si vous utilisez les icônes par défaut fournies avec Arbor, ce sera donc :

'icpath' => 'mnu/',

Attention ! utilisez des slashes "/" et non des backslashes "\" pour les chemins.

up3. [ retic ] Affichage du réseau

'retic' => 1, // le réseau sera affiché

'retic' => 0, // le réseau ne sera pas affiché

Le terme "réseau" désigne un ensemble de fines lignes reliant les éléments de l'arborescence.

L'affichage du réseau impose une valeur fixe du pas d'indentation (voir plus bas : [decal]).

up4. [ tree ] [ symb ] Préfixes des icônes dynamiques

Ces icônes ne concernent que l'affichage en menu arborescent.

Arbor gère l'affichage dynamique d'icônes réactives, c'est-à-dire des icônes variant suivant le statut et l'état courant de la ligne (ligne déployée ou non, ligne terminale ou non). Deux icônes sont facultativement présentes en tête de ligne. La première sera, par convention, désigné "icône de treillis", la seconde "icône symbolique".

Classiquement, les icônes de treillis sont représentées par des symboles "plus" ou "moins" ou des triangles basculants et les icônes symboliques par un dossier ou un livre ouvert ou fermé représentant les noeuds intermédiaires et une page représentant les documents terminaux de l'arborescence.

Un jeu d'icônes réactives comprend 3 fichiers *.gif 16×16 ("fermé", "ouvert", et "document") nommés par un préfixe commun associé à un numéro d'ordre. Soit "xxx" le préfixe, les icônes utilisées seront donc xxx1.gif, xxx2.gif, xxx3.gif

Les fichiers graphiques (3 par icône) sont suffixés ainsi :

- 1 : état ouvert/déplié
- 2 : état fermé/replié
- 3 : hors-contexte (page finale ou ligne non dépliable)

NB : ce script est fourni avec plusieurs jeux d'icônes passe-partout :

- Préfixe " p " :

img
img
img

- Préfixe " e " :

img
img
img

- Préfixe " t " :

img
img
img

- Préfixe " b " :

img
img
img

- Préfixe " d " :

img
img
img

- Préfixe " r " :

img
img
img

Vous pouvez confectionner vos propres icônes 16×16 en leur affectant un préfixe de votre choix et en les plaçant dans le répertoire défini par le paramètre [ $this->icpath ] (chemin des icônes). Choisissez des préfixes courts afin d'alléger l'Html produit.

Pour ne pas utiliser un type d'icône, laissez son préfixe vide.

Exemples de syntaxe :

'icpath' => 'mnu/', // les jeux d'icônes sont dans 'mnu/'

'tree' => 'myIc', // afficher le jeu d'icônes de treillis 'myIc'

'tree' => '', // ne pas afficher d'îcône de treillis

'symb' => 'mySymb', // afficher le jeu d'icônes symboliques ' mySymb '

'symb' => '', // ne pas afficher d'îcône symbolique

Nb : En cas d'affichage optionnel du réseau (voir plus haut : [retic]), il est conseillé de placer une icône "e" comme première icône.

up5. [ decal ] Unité de décalage de l'indentation

Ce paramètre ne concerne que l'affichage en menu arborescent.

Les lignes de l'arborescence sont indentées suivant une unité paramétrable, en nombre de pixels :
- profondeur de niveau 0 (racine) = pas de décalage
- profondeur de niveau 1 = 1 fois la valeur unitaire de décalage
- profondeur de niveau 2 = 2 fois la valeur
- etc.

'decal' => 12, // 12 est une valeur d'indentation correcte pour un menu latéral

Nb : En cas d'affichage optionnel du réseau (voir plus haut : [retic]), l'unité de décalage de l'indentation sera de 16 pixels quel que soit la valeur donnée à decal.

up6. [ hilight ] Couleur du surlignage de la ligne cliquée

Dans une arborescence complexe largement déployée, il est parfois difficile de retrouver la ligne antérieurement cliquée. En renseignant ce paramètre avec un code de couleur HTML de votre choix, la ligne cliquée sera surlignée de cette couleur.

Pour supprimer le surlignage, utilisez une valeur vide.

'hilight' => '#FFFFCC', // ligne cliquée surlignée avec la couleur #FFFFCC

'hilight = '', // aucun surlignage

up7. [ typstyl ] Type de gestion des styles CSS

La gestion des styles CSS diffère suivant le mode d'affichage de l'arborescence.

Ce paramètre ne concerne que l'affichage en menu arborescent et est relativement complexe.

Principes de base :

* Les lignes d'arborescence générées par Arbor sont toujours muni d'un style (attribut class="...") par défaut, sauf pour l'affichage en balise de lien dynamique.

* Les noms de style automatiquement générés par Arbor sont tous préfixés par "z" et encapsulé dans un style conteneur nommé "arbor". Une feuille de style associée est fournie avec le script. Les noms des styles imposés par l'utilisateur sont libres..

* Les noms de styles se réfèrent à une feuille de styles CSS séparée. Le paramètre de gestion des styles est donc sans effet visuel avant la confection de cette feuille et la liaison de votre page à celle-ci... Le script est fourni avec une feuille de style exemple : arbor.css, à adapter si besoin à la charte graphique de votre site.

up7.1. Affichage en fil d'Ariane

Quelle que soit la valeur de 'typstyl', le bloc ligne de navigation (<div>) est muni du style nommé "za1" et chaque élément du chemin est muni du style nommé "za2" et cela que ce soit sous forme de ligne de navigation ou d'arbre de navigation

up7.2. Affichage en structure arborescente

Dans ce cas, Arbor gère les styles de l'arborescence de diverses manières, en fonction du paramètre de gestion des styles.

Vous pouvez laisser le script affecter automatiquement des styles hiérarchisés aux lignes de votre arborescence ou imposer le ou les styles.

(o) Aucun style, utilisation du style par défaut

'typstyl' => '',

Le style par défaut nommé "z" sera appliqué à chaque ligne de l'arborescence. C'est le même style que celui utilisé pour l'affichage en sommaire de pages subordonnées.

(o) Style unique imposé

'typstyl' => 'monStyleDeLigne',

Ce style "monStyleDeLigne" (ou toute autre appellation), sera appliqué à chaque ligne de votre arborescence.

(o) Styles automatiques

'typstyl' => 'auto',

En utilisant le mot-clé 'auto', des styles automatiques hiérarchisés sont appliqués aux lignes de l'arborescence. Ces styles automatiques se nomment z0, z1, z2, z3... etc., chaque style correspondant à une profondeur d'indentation (racine : z0, niveau 1 : z1, etc.).

N'oubliez pas de définir autant de noms de styles dans votre feuille de style qu'il y a de profondeurs dans votre arborescence !

(o) Styles manuels

'typstyl' => 'manuel',

En utilisant le mot-clé 'manuel', vous pouvez affecter manuellement des noms de styles à certaines lignes de votre arborescence directement dans le fichier de menu. Les lignes de l'arborescence sans style explicite seront munies du style par défaut nommé "z".

Syntaxe de l'arborescence en mode "style manuel" :
Inscrivez le nom du style en fin de ligne et en le faisant précéder de " ^ " (circonflexe), à ajouter après le lien s'il existe.

"++Mon Libellé^monStyle", // style appliqué à une ligne sans lien

"++Mon Libellé|maPage.php^monStyle", // style appliqué à une ligne avec lien

up7.3. Affichage en plan de site

Quelle que soit la valeur de 'typstyl', le plan de site sera muni du style nommé "zpl" en mode 'plan' et reprendra les styles du menu arborescent en mode 'plan2'.

up7.4. Affichage en sommaire de pages subordonnées

Quelle que soit la valeur de 'typstyl', le sommaire subordonné sera muni du style nommé "z".

up7.5. Affichage en barre des essentiels

Quelle que soit la valeur de 'typstyl', la barre des essentiels sera muni du style nommé "zm".

up7.6. Affichage en lien vers page précédente/suivante

Quelle que soit la valeur de 'typstyl', le lien sera muni du style nommé "zpn".

up7.7. Affichage en balise de lien dynamique

Aucun style n'est affecté à cette balise <a ... > qui reprend donc le style du bloc dans lequel elle apparaît.

 

Editer les liens de menu <> Intégrer une arborescence

 

 

Arbor Home

 

Home Accueil

Contact Chercher

Contact Contact

Site Plan Plan du site

Page top Haut de page

Valid XHTML 1.0 Strict