Fonctions générales d’édition

Les fonctions d’édition sont accessibles depuis la fenêtre de document. Elles permettent d’insérer du texte, du code HTML et des objets, d’appliquer, de modifier et de supprimer des marqueurs de police et de caractère, de modifier des balises et des attributs, etc.

Disponibilité

Dreamweaver 3.

Description

Applique à la sélection le type de marqueur de caractère spécifié. Si la sélection est un point d’insertion, la fonction applique les marqueurs de caractère spécifiés au texte saisi après le point d’insertion.

Arguments

tagName

• L’argument tagName correspond au nom de balise associé au marqueur de caractère. Il doit s’agir de l’une des chaînes suivantes : "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" ou "var".

Valeurs renvoyées

Aucune.

dom.applyFontMarkup()

Disponibilité

Dreamweaver 3.

Description

Applique à la sélection en cours la balise FONT, ainsi que l’attribut spécifié et sa valeur.

Arguments

attribute, value

• L’argument attribute doit être "face", "size" ou "color".

• L’argument value correspond à la valeur à affecter à l’attribut, comme "Arial, Helvetica, sans-serif", "5" ou "#FF0000".

Valeurs renvoyées

Aucune.

dom.deleteSelection()

Disponibilité

Dreamweaver 3.

Description

Supprime la sélection du document.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

dom.editAttribute()

Disponibilité

Dreamweaver 3.

Description

Affiche l’interface permettant de modifier l’attribut de document spécifié. Dans la plupart des cas, il s’agit d’une boîte de dialogue. Cette fonction n’est valide que pour le document actif.

Arguments

attribute

• L’argument attribute est une chaîne qui spécifie l’attribut de balise à modifier.

Valeurs renvoyées

Aucune.

dom.exitBlock()

Disponibilité

Dreamweaver 3.

Description

Quitte le bloc de paragraphe ou d’en-tête en cours et place le point d’insertion à l’extérieur de tous les éléments de bloc.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

dom.getCharSet()

Disponibilité

Dreamweaver 4.

Description

Renvoie l’attribut charset dans la balise meta du document.

Arguments

Aucun.

Valeurs renvoyées

Identité de codage du document. Par exemple, pour un document Latin1, la fonction renvoie iso-8859-1.

dom.getFontMarkup()

Disponibilité

Dreamweaver 3.

Description

Affiche la valeur de l’attribut spécifié de la balise FONT pour la sélection en cours.

Arguments

attribute

• L’argument attribute doit être "face", "size" ou "color".

Valeurs renvoyées

Soit une chaîne contenant la valeur de l’attribut spécifié, soit une chaîne vide si l’attribut n’est pas défini.

dom.getLineFromOffset()

Disponibilité

Dreamweaver MX.

Description

Trouve le numéro de ligne d’un décalage de caractère précis dans le texte (le code HTML ou JavaScript) du fichier.

Arguments

offset

• L’argument offset est un nombre entier qui représente l’emplacement du caractère à partir du début du fichier.

Valeurs renvoyées

Nombre entier qui représente le numéro de la ligne dans le document.

dom.getLinkHref()

Disponibilité

Dreamweaver 3.

Description

Affiche le lien qui entoure la sélection en cours. Cette fonction revient à effectuer une boucle sur les parents et les grands-parents du nœud en cours jusqu’à ce qu’un lien soit détecté, puis à appeler la fonction getAttribute('HREF') sur ce lien.

Arguments

Aucun.

Valeurs renvoyées

Chaîne qui contient le nom du fichier lié, exprimé sous la forme d’une URL de type file://.

dom.getLinkTarget()

Disponibilité

Dreamweaver 3.

Description

Affiche la cible du lien qui entoure la sélection en cours. Cette fonction revient à effectuer une boucle sur les parents et les grands-parents du nœud en cours jusqu’à ce qu’un lien soit détecté, puis à appeler la fonction getAttribute('TARGET') sur ce lien.

Arguments

Aucun.

Valeurs renvoyées

Soit une chaîne contenant la valeur de l’attribut TARGET spécifié pour le lien, soit une chaîne vide si aucune cible n’est définie.

dom.getListTag()

Disponibilité

Dreamweaver 3.

Description

Renvoie le style de la liste sélectionnée.

Arguments

Aucun.

Valeurs renvoyées

Soit une chaîne contenant la balise associée à la liste ("ul", "ol" ou "dl"), soit une chaîne vide si aucune balise n’est associée à la liste. Cette valeur est toujours renvoyée en minuscules.

dom.getTextAlignment()

Disponibilité

Dreamweaver 3.

Description

Renvoie l’alignement du bloc contenant la sélection.

Arguments

Aucun.

Valeurs renvoyées

Soit une chaîne contenant la valeur de l’attribut ALIGN de la balise associée au bloc, soit une chaîne vide si l’attribut ALIGN n’est pas défini. Cette valeur est toujours renvoyée en minuscules.

dom.getTextFormat()

Disponibilité

Dreamweaver 3.

Description

Affiche le format de bloc du texte sélectionné.

Arguments

Aucun.

Valeurs renvoyées

Soit une chaîne contenant la balise de bloc associée au texte (comme "p", "h1", "pre", etc.), soit une chaîne vide si aucune balise de bloc n’est associée à la sélection. Cette valeur est toujours renvoyée en minuscules.

dom.hasCharacterMarkup()

Disponibilité

Dreamweaver 3.

Description

Vérifie si le marqueur de caractère spécifié est déjà associé à la sélection.

Arguments

markupTagName

• L’argument markupTagName correspond au nom de la balise à vérifier. Il doit s’agir de l’une des chaînes suivantes : "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" ou "var".

Valeurs renvoyées

Valeur booléenne qui indique si le marqueur de caractère spécifié est associé à la sélection entière. Cette fonction renvoie la valeur false si le marqueur spécifié n’est associé qu’à une partie de la sélection.

dom.indent()

Disponibilité

Dreamweaver 3.

Description

Applique un retrait à la sélection à l’aide de balises BLOCKQUOTE. Si la sélection est un élément de liste, cette fonction lui applique un retrait en convertissant l’élément sélectionné en liste imbriquée. La liste imbriquée est du même type que la liste externe et contient un seul élément (la sélection d’origine).

Arguments

Aucun.

Valeurs renvoyées

Aucune.

dom.insertHTML()

Disponibilité

Dreamweaver 3.

Description

Insère un contenu HTML dans le document, au niveau du point d’insertion en cours.

Arguments

contentToInsert, {bReplaceCurrentSelection}

• L’argument contentToInsert correspond au contenu à insérer.

• L’argument facultatif bReplaceCurrentSelection est une valeur booléenne qui indique si le contenu spécifié doit remplacer la sélection en cours. Si la valeur de l’argument bReplaceCurrentSelection est true, le contenu remplace la sélection actuelle. Si sa valeur est false, le contenu est inséré à la suite de la sélection actuelle.

Valeurs renvoyées

Aucune.

Exemple

Le code suivant insère la chaîne HTML <b>130</b> dans le document en cours :

Le résultat s’affiche dans la fenêtre de document.

dom.insertObject()

Disponibilité

Dreamweaver 3.

Description

Insère l’objet spécifié et invite l’utilisateur à définir des paramètres, le cas échéant.

Arguments

objectName

• L’argument objectName est le nom d’un objet dans le dossier Configuration/Objects.

Valeurs renvoyées

Aucune.

Exemple

Un appel à la fonction dom.insertObject('Button') insère un bouton de formulaire dans le document actif, après la sélection en cours. Si aucun élément n’est sélectionné, cette fonction insère le bouton au niveau du point d’insertion en cours.

dom.insertText()

Disponibilité

Dreamweaver 3.

Description

Insère un contenu dans le document, au niveau du point d’insertion en cours.

Arguments

contentToInsert, {bReplaceCurrentSelection}

• L’argument contentToInsert correspond au contenu à insérer.

• L’argument facultatif bReplaceCurrentSelection est une valeur booléenne qui indique si le contenu spécifié doit remplacer la sélection en cours. Si la valeur de l’argument bReplaceCurrentSelection est true, le contenu remplace la sélection actuelle. Si sa valeur est false, le contenu est inséré à la suite de la sélection actuelle.

Valeurs renvoyées

Aucune.

Exemple

Le code ci-dessous suivant insère le texte &lt;b&gt;130&lt;/b&gt; dans le document en cours :

Les résultats s’affichent dans la fenêtre de document.

dom.newBlock()

Disponibilité

Dreamweaver 3.

Description

Crée un bloc doté de la même balise et des mêmes attributs que le bloc contenant la sélection en cours ou, si le pointeur se trouve à l’extérieur de tous les blocs, crée un paragraphe.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

Exemple

Si la sélection en cours se trouve à l’intérieur d’un paragraphe centré, un appel à la fonction dom.newBlock() insère <p align="center"> après le paragraphe en cours.

dom.notifyFlashObjectChanged()

Disponibilité

Dreamweaver 4.

Description

Indique à Dreamweaver que l’objet Flash en cours a été modifié. Dreamweaver met à jour la fenêtre d’aperçu en la redimensionnant, le cas échéant, et en veillant à conserver le rapport hauteur/largeur d’origine.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

dom.outdent()

Disponibilité

Dreamweaver 3.

Description

Applique un retrait négatif à la sélection.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

dom.removeCharacterMarkup()

Disponibilité

Dreamweaver 3.

Description

Supprime de la sélection le type de marqueur de caractère spécifié.

Arguments

tagName

• L’argument tagName correspond au nom de balise associé au marqueur de caractère. Il doit s’agir de l’une des chaînes suivantes : "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" ou "var".

Valeurs renvoyées

Aucune.

dom.removeFontMarkup()

Disponibilité

Dreamweaver 3.

Description

Supprime d’une balise FONT l’attribut spécifié, ainsi que sa valeur. Si, après suppression de l’attribut, il ne reste que la balise FONT, celle-ci est également supprimée.

Arguments

attribute

• L’argument attribute doit être "face", "size" ou "color".

Valeurs renvoyées

Aucune.

dom.resizeSelection()

Disponibilité

Dreamweaver 3.

Description

Redimensionne l’objet sélectionné selon les nouvelles dimensions spécifiées.

Arguments

newWidth, newHeight

• L’argument newWidth spécifie la nouvelle largeur que la fonction doit appliquer à l’objet sélectionné.

• L’argument newHeight spécifie la nouvelle hauteur que la fonction doit appliquer à l’objet sélectionné.

Valeurs renvoyées

Aucune.

dom.setAttributeWithErrorChecking()

Disponibilité

Dreamweaver 3.

Description

Définit l’attribut spécifié sur la valeur indiquée pour la sélection en cours et affiche une invite utilisateur si le type de valeur est incorrect ou si la valeur n’est pas comprise dans la plage spécifiée. Cette fonction n’est valide que pour le document actif.

Arguments

attribute, value

• L’argument attribute spécifie l’attribut à définir pour la sélection en cours.

• L’argument value spécifie la valeur à définir pour l’attribut.

Valeurs renvoyées

Aucune.

dom.setLinkHref()

Disponibilité

Dreamweaver 3.

Description

Transforme la sélection en lien hypertexte ou modifie la valeur d’URL de la balise HREF qui entoure la sélection en cours.

Arguments

linkHREF

• L’argument linkHREF est une URL (chemin relatif au document ou à la racine, ou URL absolue) contenant le lien. Si cet argument n’est pas défini, la boîte de dialogue Sélectionner un fichier HTML s’affiche.

Valeurs renvoyées

Aucune.

Activateur

Voir dom.canSetLinkHref().

dom.setLinkTarget()

Disponibilité

Dreamweaver 3.

Description

Définit la cible du lien qui entoure la sélection en cours. Cette fonction revient à effectuer une boucle sur les parents et les grands-parents du nœud en cours jusqu’à ce qu’un lien soit détecté, puis à appeler la fonction setAttribute('TARGET') sur ce lien.

Arguments

{linkTarget}

• L’argument facultatif linkTarget est une chaîne qui représente le nom d’un cadre ou d’une fenêtre, ou bien l’une des cibles réservées ("_self", "_parent", "_top" ou "_blank"). Si cet argument n’est pas défini, la boîte de dialogue Définir la cible s’affiche.

Valeurs renvoyées

Aucune.

dom.setListBoxKind()

Disponibilité

Dreamweaver 3.

Description

Modifie le type du menu SELECT sélectionné.

Arguments

kind

• L’argument kind doit correspondre à "menu" ou "list box".

Valeurs renvoyées

Aucune.

dom.showListPropertiesDialog()

Disponibilité

Dreamweaver 3.

Description

Ouvre la boîte de dialogue Propriétés de la liste.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

Activateur

Voir dom.canShowListPropertiesDialog().

dom.setListTag()

Disponibilité

Dreamweaver 3.

Description

Définit le style de la liste sélectionnée.

Arguments

listTag

• L’argument listTag correspond à la balise associée à la liste. Il doit s’agir de "ol", "ul", "dl" ou d’une chaîne vide.

Valeurs renvoyées

Aucune.

dom.setTextAlignment()

Disponibilité

Dreamweaver 3.

Description

Affecte la valeur spécifiée à l’attribut ALIGN du bloc contenant la sélection.

Arguments

alignValue

• L’argument alignValue doit être "left", "center" ou "right".

Valeurs renvoyées

Aucune.

dom.setTextFieldKind()

Disponibilité

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

Description

Définit le format du champ de texte sélectionné.

Arguments

fieldType

• L’argument fieldType doit être "input", "textarea" ou "password".

Valeurs renvoyées

Aucune.

dom.setTextFormat()

Disponibilité

Dreamweaver 4.

Description

Définit le format de bloc du texte sélectionné.

Arguments

blockFormat

• L’argument blockFormat est une chaîne qui spécifie l’un des formats suivants : "" (aucun format), "p", "h1", "h2", "h3", "h4", "h5", "h6" ou "pre".

Valeurs renvoyées

Aucune.

dom.showFontColorDialog()

Disponibilité

Dreamweaver 3.

Description

Ouvre la boîte de dialogue Sélecteur de couleurs.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

dreamweaver.deleteSelection()

Disponibilité

Dreamweaver 3.

Description

Supprime la sélection du document actif, du panneau Site ou, sous Macintosh, supprime la zone de texte active dans une boîte de dialogue ou un panneau flottant.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

Activateur

Voir dreamweaver.canDeleteSelection().

dreamweaver.editFontList()

Disponibilité

Dreamweaver 3.

Description

Ouvre la boîte de dialogue Modifier la liste des polices.

Arguments

Aucun.

Valeurs renvoyées

Aucune.

dreamweaver.getFontList()

Disponibilité

Dreamweaver 3.

Description

Affiche la liste de tous les groupes de polices apparaissant dans l’inspecteur Propriétés de texte et la boîte de dialogue Définition du style.

Arguments

Aucun.

Valeurs renvoyées

Tableau de chaînes représentant chacune un élément de la liste des polices.

Exemple

Si vous avez effectué une installation par défaut de Dreamweaver, un appel à la fonction dreamweaver.getFontList() renvoie un tableau contenant les éléments suivants :

• "Arial, Helvetica, sans-serif"

• "Times New Roman, Times, serif"

• "Courier New, Courier, mono"

• "Georgia, Times New Roman, Times, serif"

• "Verdana, Arial, Helvetica, sans-serif"

dreamweaver.getFontStyles()

Disponibilité

Dreamweaver 4.

Description

Renvoie les styles pris en charge par la police TrueType spécifiée.

Arguments

fontName

• L’argument fontName est une chaîne contenant le nom de la police.

Valeurs renvoyées

Tableau de trois valeurs booléennes qui indique les styles pris en charge par la police. La première valeur indique si la police prend en charge le style Gras, la deuxième le style Italique et la troisième les styles Gras et Italique.

dreamweaver.getKeyState()

Disponibilité

Dreamweaver 3.

Description

Détermine si la touche de modification spécifiée est enfoncée.

Arguments

key

• L’argument key doit avoir l’une des valeurs suivantes : "Cmd", "Ctrl", "Alt" ou "Shift". Sous Windows, "Cmd" et "Ctrl" désignent la touche Contrôle ; sous Macintosh, "Alt" désigne la touche Option.

Valeurs renvoyées

Valeur booléenne qui indique si la touche est enfoncée.

Exemple

Le code suivant vérifie que les touches Maj et Ctrl (Windows) ou Maj et Commande (Macintosh) sont enfoncées avant d’effectuer une opération :

dreamweaver.getNaturalSize()

Disponibilité

Dreamweaver 4.

Description

Renvoie la largeur et la hauteur d’un objet graphique.

Arguments

url

• L’argument url pointe vers un objet graphique dont les dimensions sont requises. Dreamweaver doit prendre en charge cet objet (GIF, JPEG, PNG, Flash ou Shockwave). L’URL fournie comme argument de la fonction getNaturalSize() doit correspondre à une URL absolue pointant vers un fichier local ; il ne peut pas s’agir d’une URL relative.

Valeurs renvoyées

Tableau contenant deux nombres entiers, le premier définissant la largeur de l’objet et le second, sa hauteur.

dreamweaver.getSystemFontList()

Disponibilité

Dreamweaver 4.

Description

Renvoie une liste de polices à utiliser pour le système. Cette fonction peut appeler toutes les polices ou uniquement les polices TrueType.

Arguments

fontTypes

• L’argument fontTypes est une chaîne qui contient soit all, soit TrueType.

Valeurs renvoyées

Tableau de chaînes qui contient le nom de toutes les polices ; renvoie la valeur null si aucune police n’est trouvée.

dreamweaver.getSystemFontName()

Disponibilité

Dreamweaver CS5.

Description

Renvoie le nom de la police système.

Arguments

Aucune.

Valeurs renvoyées

Chaîne contenant le nom de la police système.