Fonctions de l’éditeur de balises et de la bibliothèque de balises

Vous pouvez utiliser les éditeurs de balises pour insérer de nouvelles balises, modifier des balises existantes ou accéder à des informations de référence sur les balises. Le sélecteur de balises permet aux utilisateurs d’organiser leurs balises afin de pouvoir sélectionner facilement celles qui sont le plus fréquemment utilisées. Les bibliothèques de balises fournies avec Dreamweaver stockent des informations concernant les balises utilisées dans les langages de marquage standard et dans les langages de script et de balise fréquemment utilisés. Vous pouvez utiliser les fonctions de l’éditeur de balises JavaScript, du sélecteur de balises, de la bibliothèque de balises lorsque vous devez utiliser les éditeurs et bibliothèques de balises dans vos extensions.

dom.getTagSelectorTag()

Disponibilité

Dreamweaver MX.

Description

Cette fonction affiche le nœud DOM de la balise sélectionnée dans la barre du sélecteur de balises, au bas de la fenêtre de document.

Arguments

Aucun.

Valeurs renvoyées

Nœud DOM de la balise sélectionnée ; renvoie la valeur null si aucune balise n’est sélectionnée.

dreamweaver.popupInsertTagDialog()

Disponibilité

Dreamweaver MX.

Description

Cette fonction vérifie les fichiers VTM pour s’assurer qu’un éditeur a été défini pour la balise. Si c’est le cas, l’éditeur de cette balise apparaît et accepte la balise de début. Si ce n’est pas le cas, la balise de début est insérée telle quelle dans le document de l’utilisateur.

Arguments

start_tag_string

Chaîne de balise de début qui comprend l’un des types suivants de valeurs initiales :

  • une balise, comme <input> ;

  • une balise avec des attributs, comme <input type='text'> ;

  • une directive, comme <%= %>.

Valeurs renvoyées

Valeur booléenne : true si un élément est inséré dans le document et false dans le cas contraire.

dreamweaver.popupEditTagDialog()

Disponibilité

Dreamweaver MX.

Description

Si une balise est sélectionnée, cette fonction ouvre l’éditeur correspondant à cette balise pour vous permettre de la modifier.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

Activateur

dreamweaver.showTagChooser()

Disponibilité

Dreamweaver MX (déconseillé depuis Dreamweaver CS5.5)

Description

Cette fonction affiche la boîte de dialogue Sélecteur de balises, la fait apparaître au premier plan et la rend active.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

dreamweaver.showTagLibraryEditor()

Disponibilité

Dreamweaver MX.

Description

Cette fonction ouvre l’éditeur de la bibliothèque de balises.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

dreamweaver.tagLibrary.getTagLibraryDOM()

Disponibilité

Dreamweaver MX.

Description

Associée à l’URL d’un fichier filename.vtm, cette fonction renvoie le DOM de ce fichier afin que son contenu puisse être modifié. Cette fonction ne doit être appelée que lorsque l’éditeur de la bibliothèque de balises est actif.

Arguments

fileURL

  • L’argument fileURL correspond à l’URL d’un fichier filename.vtm, relatif au dossier Configuration/Tag Libraries, comme illustré dans l’exemple suivant : "HTML/img.vtm"

Valeurs renvoyées

Un pointeur DOM désignant un nouveau ou un ancien fichier du dossier TagLibraries.

dreamweaver.tagLibrary.getSelectedLibrary()

Disponibilité

Dreamweaver MX.

Description

Si un nœud de bibliothèque est sélectionné dans l’éditeur de la bibliothèque de balises, cette fonction renvoie le nom de la bibliothèque.

Arguments

Aucun.

Valeurs renvoyées

Chaîne correspondant au nom de la bibliothèque actuellement sélectionnée dans l’éditeur de la bibliothèque de balises ; renvoie une chaîne vide si aucune bibliothèque n’est sélectionnée.

dreamweaver.tagLibrary.getSelectedTag()

Disponibilité

Dreamweaver MX.

Description

Si un nœud d’attribut est sélectionné, cette fonction renvoie le nom de la balise qui contient l’attribut.

Arguments

Aucun.

Valeurs renvoyées

Chaîne correspondant au nom de la balise actuellement sélectionnée dans l’éditeur de la bibliothèque de balises ; renvoie une chaîne vide si aucune balise n’est sélectionnée.

dreamweaver.tagLibrary.importDTDOrSchema()

Disponibilité

Dreamweaver MX.

Description

Cette fonction importe un fichier DTD/schéma à partir d’un serveur distant dans la bibliothèque de balises.

Arguments

fileURL, Prefix

  • L’argument fileURL correspond au chemin du fichier DTD ou schéma, au format URL local.

  • L’argument Prefix correspond à la chaîne de préfixe qui doit être ajoutée à toutes les balises de cette bibliothèque.

Valeurs renvoyées

Nom de la bibliothèque de balises importées.

dreamweaver.tagLibrary.getImportedTagList()

Disponibilité

Dreamweaver MX.

Description

Cette fonction génère une liste d’objets tagInfo à partir d’une bibliothèque de balises importées.

Arguments

libname

  • L’argument libname correspond au nom de la bibliothèque de balises importées.

Valeurs renvoyées

Tableau d’objets tagInfo.

Un objet tagInfo contient des informations concernant une balise spécifique de la bibliothèque de balises. Les propriétés suivantes sont définies dans un objet tagInfo :

  • La propriété tagName, qui est une chaîne.

  • La propriété attributes, qui est un tableau de chaînes. Chaque chaîne correspond au nom d’un attribut défini pour cette balise.

Exemple :

L’exemple suivant montre que la fonction dw.tagLibrary.getImportedTagList() peut renvoyer un tableau de balises de la bibliothèque libName :

     // "fileURL" and "prefix" have been entered by the user. 
    // tell the Tag Library to Import the DTD/Schema 
var libName = dw.tagLibrary.importDTDOrSchema(fileURL, prefix); 
 
    // get the array of tags for this library 
    // this is the TagInfo object 
var tagArray = dw.tagLibrary.getImportedTagList(libName); 
 
    // now I have an array of tagInfo objects. 
    // I can get info out of them. This gets info out of the first one. 
    // note: this assumes there is at least one TagInfo in the array. 
var firstTagName = tagArray[0].name; 
var firstTagAttributes = tagArray[0].attributes; 
    // note that firstTagAttributes is an array of attributes. 
 

 Adobe

Recevez de l’aide plus rapidement et plus facilement

Nouvel utilisateur ?