À propos des modèles Dreamweaver

Un modèle est un type spécial de document que vous utilisez pour concevoir une mise en page « fixe » ; vous pouvez ensuite créer des documents basés sur le modèle qui héritent de sa mise en page. Lorsque vous concevez un modèle, vous spécifiez comme « modifiable » le contenu que les utilisateurs peuvent modifier dans un document basé sur ce modèle. Les modèles permettent aux auteurs de modèles de contrôler quels éléments de page les utilisateurs de modèles — tels que les rédacteurs, les graphistes ou d'autres développeurs web — peuvent modifier.Il existe plusieurs types de zones de modèle que l'auteur du modèle peut inclure dans un document.

L’utilisation de modèles vous permet de mettre à jour plusieurs pages à la fois. Un document créé à partir d'un modèle reste connecté à ce modèle (sauf si vous détachez le document plus tard). Vous pouvez modifier un modèle et mettre immédiatement à jour le design dans tous les documents basés sur celui-ci.

Types de régions de modèle

Lorsque vous enregistrez un document en tant que modèle, la plupart des régions d’un document sont verrouillées. En tant que créateur de modèles, vous devez insérer des régions ou paramètres modifiables dans un modèle pour définir les régions qui pourront être modifiées dans les documents basés sur ce modèle.

Lors de la création du modèle, vous pouvez apporter des modifications aux régions modifiables et aux régions verrouillées. En revanche, dans le cas d’un document créé à partir d’un modèle, seules les régions modifiables peuvent subir des modifications ; les régions verrouillées ne peuvent pas être modifiées.

Il existe quatre types de régions de modèle :

Région non modifiable : région non verrouillée dans un document basé sur un modèle. Ce type de section peut être modifié par l’utilisateur. Le créateur du modèle peut définir toute région du modèle comme modifiable. Pour être fonctionnel, un modèle doit contenir au moins une région modifiable. S’il n’en contient pas, les pages créées à partir du modèle ne pourront pas être modifiées. Pour obtenir des informations détaillées sur les régions modifiables, voir Création de régions modifiables dans les modèles.

Région répétée : section de la mise en forme du document qui est définie de façon à ce que l’utilisateur du modèle puisse ajouter ou supprimer des copies de la région répétée dans un document basé sur le modèle en fonction de ses besoins. Par exemple, vous pouvez définir une ligne de tableau à reproduire. En général, les sections répétées sont modifiables afin que l’utilisateur du modèle puisse modifier le contenu de l’élément répété, tandis que le créateur du modèle contrôle la conception elle-même.

Deux types de régions répétées peuvent être insérées dans un modèle : région répétée et tableau répété. Pour savoir comment utiliser des régions répétées, voir Création de régions répétées et de tables dans Dreamweaver.

Région facultative : section d’un modèle qui renferme un contenu, tel que du texte ou une image, pouvant apparaître ou non dans un document. Sur la page basée sur le modèle, l’utilisateur du modèle décide généralement si le contenu doit être affiché ou non. Pour plus d’informations, voir Région facultative.

Attribut de balise modifiable : permet de déverrouiller un attribut de balise dans un modèle afin que les utilisateurs puissent le modifier dans les pages créées à partir de ce modèle. Par exemple, vous pouvez « verrouiller » les images contenues dans le document tout en permettant à l’utilisateur du modèle d’en définir l’alignement à gauche, à droite ou au centre. Pour en savoir plus, voir Définition d’attributs de balise modifiables dans Dreamweaver.

Liens des modèles

Lorsque vous créez un fichier de modèle en enregistrant une page existante comme modèle, le nouveau modèle dans le dossier Templates, et tous les liens du fichier sont mis à jour afin que leurs chemins d'accès relatifs au document soient corrects. Plus tard, lorsque vous créez un document basé sur ce modèle et l'enregistrez, tous les liens relatifs au document sont à nouveau mis à jour pour continuer à pointer vers les fichiers corrects.

Lorsque vous ajoutez un nouveau lien relatif au document à un fichier de modèle, il est facile de saisir un nom de chemin d'accès incorrect si vous tapez le chemin d'accès dans la zone de texte du lien dans l'Inspecteur de propriétés. Le chemin d'accès correct dans un fichier de modèle est le chemin d'accès du dossier Templates vers le document lié, et non le chemin d'accès du dossier du document basé sur le modèle vers le document lié. Assurez-vous que les chemins d'accès corrects pour les liens existent en utilisant soit l'icône de dossier soit l'icône Pointer vers le fichier dans l'Inspecteur de propriétés lors de la création de liens dans les modèles.

Scripts serveur dans les modèles et les documents basés sur des modèles

Certains scripts serveur sont insérés au tout début ou à la fin du document (avant la balise <html> ou après la balise </html>). De tels scripts nécessitent un traitement spécial dans les modèles et les documents basés sur des modèles. Normalement, si vous apportez des modifications au code de script avant la balise <html> ou après la balise </html> dans un modèle, les modifications ne sont pas copiées vers les documents basés sur ce modèle. Cela peut provoquer des erreurs serveur si d'autres scripts serveur, dans le corps principal du modèle, dépendaient des scripts qui ne sont pas copiés. Une alerte vous avertit si vous modifiez des scripts avant la balise <html> ou après la balise </html> dans un modèle.

Pour éviter ce problème, vous pouvez insérer le code suivant dans la section head du modèle :

<!-- TemplateInfo codeOutsideHTMLIsLocked="true" -->

Lorsque ce code est dans un modèle, les modifications apportées aux scripts avant la balise <html> ou après la balise </html> sont copiées vers les documents basés sur ce modèle. Cependant, vous ne pourrez plus modifier ces scripts dans les documents basés sur le modèle. Ainsi, vous pouvez choisir de modifier ces scripts soit dans le modèle, soit dans les documents basés sur le modèle, mais pas les deux.

Paramètres de modèle

Les paramètres de modèle indiquent des valeurs pour contrôler le contenu dans les documents basés sur un modèle. Utilisez les paramètres de modèle pour les régions facultatives ou les attributs de balise modifiables, ou pour définir les valeurs que vous souhaitez transmettre à un document joint.Pour chaque paramètre, vous sélectionnez un nom, un type de données et une valeur par défaut. Chaque paramètre doit avoir un nom unique qui respecte la casse. Ils doivent être l'un des cinq types de données autorisés : texte, booléen, couleur, URL ou nombre.

Les paramètres de modèle sont transmis au document sous forme de paramètres d’instance. Dans la plupart des cas, un utilisateur de modèle peut modifier la valeur par défaut du paramètre pour personnaliser ce qui apparaît dans un document basé sur un modèle.Dans d'autres cas, l'auteur du template peut déterminer ce qui apparaît dans le document, en fonction de la valeur d'une expression de template.

Expressions de modèle

Les expressions de modèles sont des instructions qui calculent ou évaluent une valeur.

Vous pouvez utiliser une expression pour stocker une valeur et l'afficher dans un document. Par exemple, une expression peut être aussi simple que la valeur d'un paramètre, comme @@(Param)@@, ou suffisamment complexe pour calculer des valeurs qui alternent la couleur d'arrière-plan dans une ligne de tableau, comme @@((_index & 1) ? red : blue)@@.

Vous pouvez aussi rédiger des expressions de modèle pour définir des conditions If et MultipleIf. Lorsqu’une instruction conditionnelle contient une expression, Dreamweaver évalue si celle-ci est vraie ou fausse. Si la condition est vraie, la zone géographique facultative apparaît dans le document basé sur le template ; si elle est fausse, elle n'apparaît pas.

Vous pouvez définir des expressions en vue Code ou dans la boîte de dialogue Région facultative lorsque vous insérez une région facultative.

En mode Code, il existe deux façons de définir les expressions de modèle : utilisez le commentaire <!-- TemplateExpr expr=&quot;your expresson&quot;--> ou @@(your expression)@@.Lorsque vous insérez l'expression dans le code du modèle, un marqueur d'expression apparaît en vue Création.Lorsque vous appliquez le modèle, Dreamweaver évalue l'expression et affiche la valeur dans le document basé sur le modèle.

Langage d’expression de modèle

Le langage d'expression de template est un petit sous-ensemble de JavaScript, et utilise la syntaxe et les règles de priorité JavaScript. Utilisez les opérateurs JavaScript pour écrire une expression comme celle-ci :

@@(firstName+lastName)@@

Les fonctions et opérateurs suivants sont pris en charge :

• littéraux numériques, littéraux de chaîne (syntaxe à guillemets doubles uniquement), littéraux booléens (vrai ou faux)

• référence de variable (voir la liste des variables définies plus loin dans cette section)

• référence à un champ (opérateur « point »)

• opérateurs unaires : +, -, ~, !

• opérateurs binaires : +, -, *, /, %, &, |, ^, &&, ||, <, <=, >, >=, ==, !=, <<, >>

• opérateurs conditionnels : ?:

• parenthèses : ()

  Les types de données suivants sont utilisés : booléen, nombre flottant IEEE 64‑bpc, chaîne et objet.Les templates Dreamweaver ne prennent pas en charge l'utilisation des types JavaScript « null » ou « undefined ». Ils ne permettent pas non plus la conversion implicite des types scalaires en objet ; ainsi, l'expression "abc".length déclencherait une erreur, au lieu de donner la valeur 3.

  Les seuls objets disponibles sont ceux définis par le modèle objet d'expression. Les variables suivantes sont définies :

  _document

  Contient les données de modèle au niveau du document avec un champ pour chaque paramètre du modèle.

  _repeat

  Défini uniquement pour les expressions qui apparaissent dans une région répétitive.Fournit des informations prédéfinies sur la région

  _index

  L’index numérique (à partir de 0) de l’entrée en cours.

  _numRows

  Nombre total d’entrées dans la région répétée.

  _isFirst

  Vrai si l'entrée actuelle est la première entrée de sa région répétitive

  _isLast

  Vrai si l'entrée actuelle est la dernière entrée de sa région répétitive

  _prevRecord

  L’objet _repeat de l’entrée précédente. C'est une erreur d'accéder à cette propriété pour la première entrée de la zone géographique.

  _nextRecord

  L’objet _repeat de l’entrée suivante. C'est une erreur d'accéder à cette propriété pour la dernière entrée de la zone géographique.

  _parent

  Dans une zone géographique répétée imbriquée, ceci donne l'objet _repeat pour la zone géographique répétée englobante (externe). C'est une erreur d'accéder à cette propriété en dehors d'une zone géographique répétée imbriquée.

  Pendant l'évaluation d'expression, tous les champs de l'objet _document et de l'objet _repeat sont implicitement disponibles. Par exemple, vous pouvez entrer title au lieu de _document.title pour accéder au paramètre de titre du document.

  Dans les cas où il y a un conflit de champ, les champs de l'objet _repeat ont la priorité sur les champs de l'objet _document. Par conséquent, vous ne devriez pas avoir besoin de référencer explicitement _document ou _repeat sauf que _document pourrait être nécessaire dans une zone géographique répétitive pour référencer les paramètres de document qui sont masqués par les paramètres de zone géographique répétée.

  Lorsque des zones géographiques répétées imbriquées sont utilisées, seuls les champs des zones géographiques répétées les plus internes sont disponibles implicitement. Les régions extérieures doivent être référencées explicitement à l’aide de _parent.

Condition If multiple dans le code template

Vous pouvez définir des expressions template pour les conditions if et multiple-if. Cet exemple démontre la définition d'un paramètre nommé « Dept », la définition d'une Valeur initiale, et la définition d'une condition multiple-if qui détermine quel logo afficher.

Voici un exemple du code que vous pourriez saisir dans la section head du modèle :

<!-- TemplateParam name="Dept" type="number" value="1" -->

L'instruction de condition suivante vérifie la valeur attribuée au paramètre Dept.Lorsque la condition est vraie ou correspond, l'image appropriée est affichée.

<!-- TemplateBeginMultipleIf -->

<!-- vérifie la valeur de Dept et affiche l'image appropriée -->

<!-- TemplateBeginIfClause cond="Dept == 1" --> <img src=".../sales.gif"> <!-- TemplateEndIfClause -->

<!-- TemplateBeginIfClause cond="Dept == 2" --> <img src=".../support.gif"> <!-- TemplateEndIfClause-->

<!-- TemplateBeginIfClause cond="Dept == 3" --> <img src=".../hr.gif"> <!-- TemplateEndIfClause -->

<!-- TemplateBeginIfClause cond="Dept != 3" --> <img src=".../spacer.gif"> <!-- TemplateEndIfClause -->

<!-- TemplateEndMultipleIf -->

Quand vous créez un document basé sur un modèle, les paramètres du modèle lui sont automatiquement transmis.L'utilisateur du modèle détermine quelle image afficher.

Articles connexes

• Création d’un modèle Dreamweaver
• Modification du contenu d’un document basé sur un modèle
• Création de régions modifiables dans des modèles
• Création de régions répétées dans des modèles
• Utilisation de régions facultatives dans des modèles
• Définition des attributs de balises modifiables dans les modèles
• Chemins relatifs à un document
• Modification des propriétés d’un modèle