Les instructions détaillées pour l'utilisation figurent dans le Guide de l'utilisateur.
[. . . ] Extension de Dreamweaver
Marques commerciales 1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central, ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite, FlashPaper, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder, Macromedia, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit, Studio MX, UltraDev et WebHelp sont soit des marques de commerce, soit des marques déposées de Macromedia, Inc. qui peuvent être déposées aux Etats-Unis ou sous toute autre juridiction. Les autres noms de produits, logos, graphiques, mises en page, titres, mots ou phrases mentionnés dans cette publication peuvent être des marques, des marques de service ou des noms de marque appartenant à Macromedia, Inc. ou à d'autres entités et peuvent être déposés dans certains pays, états ou provinces. [. . . ] L'attribut showIf est l'équivalent de la fonction showIf() dans un fichier de commandes.
Contenu
Néant
Fichier de définition de la barre d'outils
237
Contenant
La balise toolbar ou toolbarset.
Exemple
<itemref id="strikeout_button">
<separator/>
Description
Insère un séparateur à l'emplacement en cours dans la barre d'outils.
Attributs
{showIf}
L'attribut showif indique que le séparateur ne doit apparaître sur la barre d'outils que si le script donné renvoie la valeur true. Par exemple, vous pouvez utiliser l'attribut showIf pour afficher le séparateur uniquement dans une application donnée ou uniquement lorsque la page contient un certain type de document. Si l'attribut showIf n'est pas spécifié, le séparateur s'affiche systématiquement.
Contenu
Néant
Contenant
La balise toolbar.
Exemple
<separator/>
Balises d'éléments de barre d'outils
Chaque type d'éléments de barre d'outils possède sa propre balise et son propre ensemble d'attributs obligatoires et facultatifs. Vous pouvez définir des éléments toolbar à l'intérieur ou à l'extérieur des barres d'outils. En général, il est préférable de les définir à l'extérieur et de les référencer à partir des barres d'outils à l'aide de la balise itemref. Vous pouvez définir les types d'éléments suivants dans une barre d'outils.
238
Barres d'outils
<button>
Description
Ce bouton-poussoir exécute une commande spécifique lorsque vous cliquez dessus. Il ressemble au bouton Référence de la barre d'outils de Dreamweaver et se comporte comme tel.
Attributs
id, image, tooltip, command, {showIf}, {disabledImage}, {overImage}, {label}, {file}, {domRequired}, {enabled}, {update}, {arguments}
Pour obtenir une description de chaque attribut, voir Attributs de balises d'éléments, page 244.
Contenu
Néant
Contenant
La balise toolbar ou toolbarset.
Exemple
<BUTTON ID="DW_DocRefresh" image="Toolbars/images/MM/refresh. gif" disabledImage="Toolbars/images/MM/refresh_dis. gif" tooltip="Refresh Design View (F5)" enabled="((dw. getDocumentDOM() != null) && (dw. getDocumentDOM(). getView() != 'browse') && (!dw. getDocumentDOM(). isDesignViewUpdated()))" command="dw. getDocumentDOM(). synchronizeDocument()" update="onViewChange, onCodeViewSyncChange"/>
<checkbutton>
Description
Un bouton-poussoir est un bouton qui peut être activé ou désactivé et qui exécute une commande spécifique lorsqu'il est activé. Lorsqu'il est activé, il apparaît enfoncé et en surbrillance. Lorsqu'il est désactivé, il apparaît plat. Dreamweaver implémente les états suivants pour les boutons-poussoirs : au passage de la souris ; enfoncé ; au passage de la souris si enfoncé ; désactivé si enfoncé. Le gestionnaire spécifié par l'attribut checked ou par la fonction isCommandChecked() doit garantir que le fait de cliquer sur ce bouton modifie son état.
Attributs
id, {showIf}, image, {disabledImage}, {overImage}, tooltip, {label}, {file}, {domRequired}, {enabled}, checked, {update}, command, {arguments}
Balises d'éléments de barre d'outils
239
Pour obtenir une description de chaque attribut, voir Attributs de balises d'éléments, page 244.
Contenu
Néant
Contenant
La balise toolbar ou toolbarset.
Exemple
<CHECKBUTTON ID="DW_LiveDebug" image="Toolbars/images/MM/debugview. gif" disabledImage="Toolbars/images/MM/globe_dis. gif" tooltip="Live Debug" enabled="dw. canLiveDebug()" checked="dw. getDocumentDOM() != null && dw. getDocumentDOM(). getView() == 'browse'" command="dw. toggleLiveDebug()" showIf="dw. canLiveDebug()" update="onViewChange"/>
<radiobutton>
Description
Le bouton radio se comporte comme le bouton-poussoir, mais apparaît en relief lorsqu'il est désactivé. Dreamweaver implémente les états suivants pour les boutons radio : au passage de la souris ; enfoncé ; au passage de la souris si enfoncé ; désactivé si enfoncé. Dreamweaver ne force pas l'exclusion mutuelle entre les boutons radio. Le gestionnaire spécifié par l'attribut checked ou par la fonction isCommandChecked() doit garantir que les états activé et désactivé des boutons radio sont cohérents. Les boutons radio fonctionnent comme les boutons des modes Code, Création et affichage à deux volets de la barre d'outils de document de Dreamweaver.
Attributs
id, image, tooltip, checked, command, {showIf}, {disabledImage}, {overImage}, {label}, {file}, {domRequired}, {enabled}, {update}, {arguments}
Pour obtenir une description de chaque attribut, voir Attributs de balises d'éléments, page 244.
Contenu
Néant
240
Barres d'outils
Contenant
La balise toolbar ou toolbarset.
Exemple
<RADIOBUTTON ID="DW_CodeView" image="Toolbars/images/MM/codeView. gif" disabledImage="Toolbars/images/MM/codeView_dis. gif" tooltip="Show Code View" domRequired="false" enabled="dw. getDocumentDOM() != null" checked="dw. getDocumentDOM() != null && dw. getDocumentDOM(). getView() == 'code'" command="dw. getDocumentDOM(). setView('code')" update="onViewChange"/>
<menubutton>
Description
Un bouton de menu est un bouton qui invoque le menu contextuel spécifié par l'attribut menuid. Dreamweaver implémente les états survol de souris et pression pour les boutons de menu. Dreamweaver ne dessine pas la flèche du menu (la flèche pointant vers le bas qui indique que les éléments de menu sont attachés au bouton) ; vous devez l'inclure dans votre icône. Les boutons Gestion de fichiers et Navigation dans le code sur la barre d'outils de document de Dreamweaver sont des exemples de boutons de menu.
Attributs
id, image, tooltip, menuID, domRequired, enabled, {showIf}, {disabledImage}, {overImage}, {label}, {file}, {update}
Pour obtenir une description de chaque attribut, voir Attributs de balises d'éléments, page 244.
Contenu
Néant
Contenant
La balise toolbar ou toolbarset.
Exemple
<MENUBUTTON ID="DW_CodeNav" image="Toolbars/images/MM/codenav. gif" disabledImage="Toolbars/images/MM/codenav_dis. gif" tooltip="Code Navigation" enabled="dw. getFocus() == 'textView' || dw. getFocus() == 'html'"
Balises d'éléments de barre d'outils
241
menuID="DWCodeNavPopup" update="onViewChange"/>
<dropdown>
Description
Un menu déroulant est un menu non modifiable qui exécute une commande spécifique attachée à une fonction JavaScript lorsque vous sélectionnez une entrée et que le menu se met à jour. Ce menu ressemble à l'option Format de l'inspecteur de propriétés de texte et fonctionne de la même manière, mais s'affiche en taille standard et non en taille réduite comme dans l'inspecteur de propriétés.
Attributs
id, tooltip, file, enabled, checked, value, command, {showIf}, {label}, {width}, {domRequired}, {update}, {arguments}
Pour obtenir une description de chaque attribut, voir Attributs de balises d'éléments, page 244.
Contenu
Néant
Contenant
La balise toolbar ou toolbarset.
Exemple
<dropdown id="Font_Example" width="115" tooltip="Font" domRequired="false" file="Toolbars/mine/fontExample. htm" update="onSelChange"/>
<combobox>
Description
Une zone de liste est un menu déroulant modifiable qui exécute une commande lorsque vous sélectionnez une entrée ou que vous apportez une modification dans la zone de texte, puis changez la sélection. Le menu ressemble à l'option Police de l'inspecteur de propriétés de texte et fonctionne de la même manière, mais s'affiche en taille standard et non en taille réduite comme dans l'inspecteur de propriétés.
242
Barres d'outils
Attributs
id, file, tooltip, enabled, value, command, {showiI}, {label}, {width}, {domRequired}, {update}, {arguments}
Pour obtenir une description de chaque attribut, voir Attributs de balises d'éléments, page 244.
Contenu
Néant
Contenant
La balise toolbar ou toolbarset.
Exemple
<COMBOBOX ID="Address_URL" width="300" tooltip="Address" label="Address: " file="Toolbars/MM/AddressURL. htm" update="onBrowserPageBusyChange"/>
<editcontrol>
Description
Une zone de contrôle d'édition est une zone de texte modifiable qui exécute une commande lorsque vous apportez une modification dans la zone de texte et changez la sélection.
Attributs
id, tooltip, file, value, command, {showIf}, {label}, {width}, {domRequired}, {enabled}, {update}, {arguments}
Pour obtenir une description de chaque attribut, voir Attributs de balises d'éléments, page 244.
Contenu
Néant
Contenant
La balise toolbar ou toolbarset.
Exemple
<EDITCONTROL ID="DW_SetTitle" label="Title: " tooltip="Document Title" width="150" file="Toolbars/MM/EditTitle. htm"/>
Balises d'éléments de barre d'outils
243
<colorpicker>
Description
Un sélecteur de couleur est un panneau de couleurs, sans zone de texte associée, qui exécute une commande lorsque l'utilisateur sélectionne une nouvelle couleur. Ce panneau ressemble au sélecteur de couleur de l'inspecteur de propriétés de Dreamweaver et se comporte de la même manière. Vous pouvez choisir une autre icône pour remplacer l'icône par défaut.
Attributs
id, tooltip, value, command, {showIf}, {image}, {disabledImage}, {overImage}, {label}, {colorRect}, {file}, {domRequired}, {enabled}, {update}, {arguments}
Pour obtenir une description de chaque attribut, voir Attributs de balises d'éléments, page 244.
Contenu
Néant
Contenant
La balise toolbar ou toolbarset.
Exemple
<colorpicker id="Color_Example" image="Toolbars/images/colorpickerIcon. gif" disabledImage="Toolbars/images/colorpickerIconD. gif" colorRect="0 12 16 16" tooltip="Text Color" domRequired="false" file="Toolbars/mine/colorExample. htm" update="onSelChange"/>
Attributs de balises d'éléments
Les attributs de balises d'éléments de barre d'outils ont les significations suivantes :
id="unique_id"
Obligatoire. [. . . ] La fonction getHigherBlockTag() permet d'obtenir le prochain blockTag le plus élevé, comme défini dans le tableau blockTags. La fonction arrCon() permet de localiser un élément spécifié dans un tableau. Variables réservées, non destinées à un usage général. Utilisez Startup/mminit. htm à la place ou utilisez les chaînes provenant des fichiers Dreamweaver Configuration/Strings/*. xml. [. . . ]