Les technologies côté serveur telles que ASP, Macromedia ColdFusion, JSP et PHP utilisent du code spécial non HTML au sein des fichiers HTML. Les serveurs créent et servent du contenu HTML basé sur ce code. Lorsque Dreamweaver rencontre des balises non HTML, il les compare aux informations contenues dans les fichiers de balises propriétaires, lesquels définissent comment lire et afficher ces balises non HTML.
Par exemple, les fichiers ASP contiennent (outre le code HTML habituel) du code ASP que le serveur doit interpréter. Le code ASP ressemble à une balise HTML, mais il est signalé par des délimiteurs : il commence par <% et s'arrête par %>. Le dossier Configuration/ThirdPartyTags de Dreamweaver contient un fichier nommé Tags.xml. Ce fichier décrit le format des diverses balises propriétaires, dont le code ASP, et décrit comment Dreamweaver doit afficher ce code. La façon dont le code ASP est spécifié dans le fichier Tags.xml conduit Dreamweaver à ne pas tenter d'interpréter le code situé entre les délimiteurs. A la place, en mode Création, seule une icône indiquant la présence de code ASP s'affiche. Vos propres fichiers de données de balises peuvent définir l'affichage et la lecture de vos balises par Dreamweaver. Créez un nouveau fichier de données de balises pour chaque jeu de balises afin d'indiquer à Dreamweaver comment les afficher.
|
REMARQUE |
|
Cette section vous explique comment définir l'affichage d'une balise personnalisée par Dreamweaver, mais ne décrit pas comment modifier le contenu ou les propriétés d'une balise personnalisée. Pour plus d'informations sur la création d'un inspecteur de propriétés permettant de vérifier et modifier les propriétés d'une balise personnalisée, voir Inspecteurs de propriétés. |
Chaque fichier de données de balises définit le nom, le type, le modèle de contenu, le modèle de rendu et l'icône pour une ou plusieurs balises. Vous pouvez créer un nombre illimité de fichiers de données de balises, mais tous doivent se trouver dans le dossier Configuration/ThirdPartyTags afin d'être consultés et traités par Dreamweaver. Les fichiers de données de balises portent l'extension .xml.
|
CONSEIL |
|
Si vous travaillez sur plusieurs sites distincts à la fois (par exemple, en tant que développeur indépendant), vous pouvez regrouper toutes les spécifications de balises relatives à un site dans un fichier. Il suffit ensuite de remettre ce fichier de données de balises avec les icônes personnalisées et les inspecteurs de propriétés aux responsables qui géreront le site. |
Vous pouvez définir une spécification de balise à l'aide d'une balise XML nommée tagspec. Par exemple, le code suivant décrit les spécifications d'une balise nommée happy :
<tagspec tag_name="happy" tag_type="nonempty" render_contents="false" content_model="marker_model" icon="happy.gif" icon_width="18" icon_height="18"></tagspec>
Vous pouvez définir deux types de balises à l'aide de tagspec :
happy est un exemple de balise de type HTML standard. Elle débute par une balise d'ouverture <happy>, des données sont placées entre les balises d'ouverture et de fermeture, et elle se termine par une balise </happy> de fermeture.
Les balises délimitées par des chaînes débutent par une chaîne et se terminent par une autre chaîne. Elles se comportent comme des balises HTML vides (telle img), car elles n'entourent pas les données de balises et ne comportent pas de balises de fermeture. Si la balise happy était délimitée par des chaînes, les spécifications de balises incluraient les attributs start_string et end_string. Une balise ASP est une balise délimitée par des chaînes. Elle commence par la chaîne <% et se termine par la chaîne %>, sans balise de fermeture.
Les informations suivantes décrivent les attributs et les valeurs valides de la balise tagspec. Les attributs marqués d'un astérisque (*) sont ignorés dans le cadre des balises délimitées par des chaînes. Les attributs optionnels sont définis par des accolades ({}) dans la liste des attributs ; les attributs ne comportant pas d'accolades sont donc requis.
Fournit des informations à propos d'une balise propriétaire.
tag_name, {tag_type}, {render_contents}, {content_model}, {start_string}, {end_string}, {detect_in_attribute}, {parse_attributes}, icon, icon_width, icon_height, {equivalent_tag}, {is_visual}, {server_model}
tag_name est le nom de la balise personnalisée. Pour les balises délimitées par des chaînes, tag_name n'est utilisé que pour déterminer si un inspecteur de propriétés donné peut être utilisé pour la balise. Si la première ligne de l'inspecteur de propriétés contient ce nom de balise encadré par des astérisques, l'inspecteur peut être utilisé pour les balises de ce type. Par exemple, le nom de balise associé au code ASP correspond à ASP. Les inspecteurs de propriétés pouvant examiner le code ASP doivent comporter la mention *ASP* sur la première ligne. Pour plus d'informations sur l'inspecteur de propriétés API, voir Inspecteurs de propriétés.
tag_type détermine si la balise est vide (telle que img) ou si un contenu est présent entre les balises d'ouverture et de fermeture (telles que code). Cet attribut est requis pour les balises normales (non délimitées par des chaînes). Cet élément est ignoré pour les balises délimitées par des chaînes, ces dernières étant toujours vides. Les valeurs valides sont "empty" et "nonempty".
render_contents détermine si le contenu de la balise doit s'afficher en mode Création ou s'il est remplacé par l'icône spécifiée. Cet attribut est requis pour les balises nonempty et n'est pas pris en compte pour les balises empty (les balises empty sont vides de contenu). Cet attribut ne s'applique qu'aux balises affichées hors des attributs. Le contenu des balises imbriquées à l'intérieur des valeurs d'attributs d'autres balises n'est pas affiché. Les valeurs valides sont "true" et "false".
content_model décrit les différents types de contenu que la balise peut contenir et l'emplacement où la balise peut s'afficher dans un fichier HTML. Les valeurs valides sont "block_model", "head_model", "marker_model" et "script_model" :
block_model spécifie que la balise peut contenir des éléments de niveau de bloc comme div et p et que la balise peut apparaître uniquement dans la section body ou dans d'autres balises au contenu body, telles que div, layer et td.head_model spécifie que le contenu de la balise peut être composé de texte et que la balise peut uniquement apparaître dans la section HEAD.marker_model spécifie que la balise peut contenir tout code HTML valide et peut se trouver à tout endroit du fichier HTML. Le validateur HTML de Dreamweaver ignore les balises spécifiées comme marker_model. Néanmoins, le validateur n'ignore pas le contenu de ces balises. En conséquence, même si la balise peut apparaître à n'importe quel emplacement, le contenu de la balise peut corrompre le document HTML à certains endroits. Par exemple, du texte simple ne peut apparaître dans la section head d'un document (à l'exception des éléments head valides). Il est donc impossible de placer une balise marker_model qui contient du texte simple dans la section head. Pour placer une balise personnalisée dans la section head, définissez le modèle de contenu de la balise comme head_model au lieu de marker_model. Utilisez marker_model pour les balises qui doivent s'afficher en ligne (dans un élément de niveau de bloc, comme p ou div, par exemple, dans un paragraphe). N'utilisez pas ce modèle si la balise doit être affichée seule dans un paragraphe, encadrée par des sauts de ligne.script_model permet un emplacement libre de la balise entre les balises d'ouverture et de fermeture d'un document. Lorsque Dreamweaver rencontre une balise de ce modèle, il ignore totalement le contenu de la balise. Ce dernier est utilisé pour le marquage (comme certaines balises ColdFusion) que Dreamweaver ne doit pas analyser.start_string spécifie un délimiteur qui marque le début d'une balise délimitée par des chaînes. Les balises délimitées par des chaînes peuvent être présentes en tout point du document pouvant contenir un commentaire. Dreamweaver n'analyse pas les balises et ne décode pas les entités ou URL comprises entre start_string et end_string. Cet attribut est requis si end_string est spécifié.
end_string spécifie un délimiteur qui marque la fin d'une balise délimitée par une chaîne. Cet attribut est requis si start_string est spécifié.
detect_in_attribute indique si les éléments contenus entre start_string et end_string (ou entre les balises d'ouverture et de fermeture si ces chaînes ne sont pas définies) doivent être ignorés même si ces chaînes apparaissent dans les valeurs ou noms d'attributs. Vous devez généralement régler la valeur sur "true" pour les balises délimitées par des chaînes. La valeur par défaut est "false". Ainsi, les balises ASP sont parfois imbriquées dans des valeurs d'attributs et contiennent parfois des guillemets ("). Parce que la balise ASP spécifie detect_in_attribute="true", Dreamweaver ne tient pas compte des balises ASP, y compris des guillemets internes, lorsqu'elles sont imbriquées dans des valeurs d'attributs.
parse_attributes indique si les attributs de la balise doivent être analysés. Si la valeur définie est "true" (par défaut), Dreamweaver analyse les attributs. Si elle est définie sur "false", Dreamweaver ignore tous les éléments jusqu'au crochet situé hors des guillemets. Par exemple, cet attribut doit être réglé sur "false" pour les balises telles que cfif (par exemple, <cfif a is 1>, que Dreamweaver ne peut pas analyser comme ensemble de paires nom d'attribut/valeur).
icon spécifie le chemin et le nom de fichier de l'icône associée à la balise. Cet attribut est requis pour les balises empty ainsi que pour les balises nonempty dont le contenu ne s'affiche pas dans la fenêtre de document en mode Création.
icon_width spécifie la largeur de l'icône en pixels.
icon_height spécifie la hauteur de l'icône en pixels.
equivalent_tag spécifie des équivalents HTML simples pour certaines balises liées à des formulaires ColdFusion. Ceci ne doit pas être utilisé avec d'autres balises.
is_visual indique si la balise a un impact visuel sur la page. Par exemple, la balise ColdFusion cfgraph ne spécifie aucune valeur pour is_visual ; la valeur par défaut "true" est donc appliquée. La valeur is_visual de la balise ColdFusion cfset est définie sur false. La visibilité des balises de marquage de serveur est contrôlée par la catégorie Eléments invisibles dans la boîte de dialogue Préférences. La visibilité des balises de marquage de serveur visuel peut être définie indépendamment de celle des balises de marquage de serveur non visuel.
server_model, si spécifié, indique que la balise tagspec s'applique uniquement aux pages appartenant au modèle de serveur spécifié. Si server_model n'est pas spécifié, la balise tagspec s'applique à toutes les pages. Par exemple, les délimiteurs des balises ASP et JSP sont identiques, mais la balise tagspec pour JSP spécifie un modèle de serveur "JSP". Par conséquent, lorsque Dreamweaver rencontre ce code avec les délimiteurs adéquats sur une page JSP, il affiche une icône JSP. Lorsque ce code est rencontré sur une page autre qu'une page JSP, une icône ASP s'affiche.
Aucun (balise vide).
Néant
<tagspec tag_name="happy" tag_type="nonempty" render_contents="false" content_model="marker_model" icon="happy.gif" icon_width="18" icon_height="18"></tagspec>
L'affichage des balises personnalisées dans la fenêtre de document en mode Création dépend des valeurs entrées pour les attributs tag_type et render_contents de la balise tagspec. (Voir Personnalisation de l'interprétation de balises propriétaires.) Si la valeur de tag_type est "empty", l'icône spécifiée dans l'attribut icon s'affiche. Si la valeur de tag_type est "nonempty" mais que la valeur de render_contents est "false", l'icône s'affiche de la même façon que pour une balise vide. L'exemple suivant indique comment une instance de la balise happy définie antérieurement peut apparaître dans le code HTML :
<p>This is a paragraph that includes an instance of the <code>happy</code>tag (<happy>Joe</happy>).</p>
Parce que render_contents est réglé sur "false" dans la spécification de balise, le contenu de la balise happy (le mot Joe) ne s'affiche pas. Les balises de début et de fin et leur contenu sont alors remplacés par une icône unique.
Pour les balises nonempty dont la valeur render_contents est réglée sur "true", l'icône ne s'affiche pas dans le mode Création. C'est le contenu inséré entre les balises d'ouverture et de fermeture qui s'affiche (par exemple, le texte contenu entre les balises dans <mytag>Ceci est le contenu inséré entre les balises d'ouverture et de fermeture</mytag>). Si l'option Affichage > Eléments invisibles est activée, le contenu est mis en surbrillance à l'aide de balises propriétaires, comme spécifié dans les préférences de surbrillance (la mise en surbrillance ne s'applique qu'aux balises définies dans les fichiers de données de balises).
Dreamweaver corrige certains types d'erreurs dans le code HTML. Pour plus d'informations, voir Utilisation de Dreamweaver. Par défaut, Dreamweaver évite toute modification du code HTML dans les fichiers portant certaines extensions, comme .asp (ASP), .cfm (ColdFusion), .jsp (JSP) et .php (PHP). Ce paramètre est défini pour éviter toute modification accidentelle du code contenu dans de telles balises non HTML. Vous pouvez modifier le comportement de correction de Dreamweaver par défaut afin que le code HTML soit modifié lors de l'ouverture de tels fichiers. Vous pouvez également ajouter d'autres types de fichiers auxquels Dreamweaver n'apportera pas de modifications.
Dreamweaver encode certains caractères spéciaux en les remplaçant par des valeurs numériques lorsque vous les entrez dans l'inspecteur de propriétés. Il est normalement préférable de laisser Dreamweaver effectuer cet encodage car, ainsi, les caractères spéciaux seront reconnus par un nombre plus important de plates-formes et de navigateurs. Néanmoins, cette opération d'encodage peut interférer avec les balises propriétaires. Vous pouvez donc modifier le comportement de Dreamweaver concernant l'encodage des balises lorsque vous travaillez avec des fichiers comportant des balises propriétaires.
Si le nouveau type de fichier ne s'affiche pas dans le menu contextuel Types de fichiers dans la boîte de dialogue Fichier > Ouvrir, vous pouvez l'ajouter dans le fichier Configuration/Extensions.txt. Pour plus de détails, voir Modification du type de fichier par défaut.
Pour plus d'informations sur les autres préférences de correction de code, voir Utilisation de Dreamweaver.
M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire
Page en cours: http://livedocs.adobe.com/dreamweaver/8_fr/extending/02_cust7.htm