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. Informations de tiers Ce manuel contient des liens vers des sites Web tiers qui ne sont pas contrôlés par Macromedia et Macromedia ne peut en aucun cas être tenu responsable du contenu de ces sites. Si vous accédez à l'un de ces sites, vous le faites à vos propres risques. Macromedia propose ces liens dans un but pratique uniquement et ne peut en aucun cas endosser ou accepter la responsabilité du contenu de ces sites tiers. Navigateur Opera ® Copyright © 1995-2002 Opera Software ASA et ses fournisseurs. Tous droits réservés. Copyright © 2005 Macromedia, Inc. Tous droits réservés. Le présent manuel ne doit faire l'objet d'aucune copie, photocopie, reproduction, traduction ou conversion sous quelque forme que ce soit, électronique ou lisible par machine, sans le consentement écrit de Macromedia, Inc. Nonobstant ce qui précède, le propriétaire ou l'utilisateur autorisé d'une copie valide du logiciel avec lequel le présent manuel a été fourni peut imprimer un exemplaire de ce manuel, à partir d'une version électronique de celui-ci, aux fins exclusives d'apprendre à utiliser ledit logiciel, pour autant qu'aucune partie du manuel ne soit imprimée, reproduite, distribuée, revendue ou transmise à toute autre fin, y compris de manière non exhaustive des fins commerciales telles que la vente d'exemplaires de cette documentation ou la fourniture de services d'assistance payants. Remerciements Gestion de projet : Charles Nadeau, Robert Berry Rédaction : Anne Sandstrom Mise en forme : Anne Szabla, John Hammett Gestion de la production et de l'édition : Patrice O'Neill et Rosana Francescato Conception et production : Adam Barnett, Aaron Begley, Paul Benkman, John Francis, Geeta Karmarkar, Paul Rangel, Arena Reed, Mario Reynoso Gestion de la localisation : Melissa Baerwald Remerciements particuliers à Jay London, Raymond Lim, Alain Dumesny, Masayo Noda, Kristin Conradi, Yuko Yagi, ainsi qu'à tous les membres des équipes techniques et d'assurance qualité de Dreamweaver. Première édition : Septembre 2005 Macromedia, Inc. 601 Townsend St. San Francisco, CA 94103 Table des matières Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Arrière-plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Installation d'une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Création d'une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Ressources supplémentaires pour les créateurs d'extensions. . . . . . . .11 Nouveautés de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Conventions utilisées dans ce manuel . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 PARTIE 1 : PERSONNALISATION DE DREAMWEAVER Chapitre 1 : Personnalisation de Dreamweaver. . . . . . . . . . . . . . . 17 Techniques de personnalisation de Dreamweaver . . . . . . . . . . . . . . . . . 17 Personnalisation de Dreamweaver dans un environnement multi-utilisateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Utilisation des profils de navigateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Modification des mappages FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Types de documents extensibles dans Dreamweaver . . . . . . . . . . . . . .37 Chapitre 2 : Personnalisation du mode Code . . . . . . . . . . . . . . . 59 Indicateurs de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Coloration du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67 Validation du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Modification du formatage HTML par défaut. . . . . . . . . . . . . . . . . . . . . 101 PARTIE 2 : PRÉSENTATION DE EXTENSION DE DREAMWEAVER Chapitre 3 : Extension de Dreamweaver . . . . . . . . . . . . . . . . . . . 105 Types d'extensions Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106 Extensions et dossiers de configuration . . . . . . . . . . . . . . . . . . . . . . . . .109 API d'extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Localisation d'une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 3 Utilisation de Extension Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116 Chapitre 4 : Interfaces utilisateur destinées aux extensions . . . .117 Conception d'une interface utilisateur d'extension . . . . . . . . . . . . . . . . 117 Commande de rendu HTML de Dreamweaver. . . . . . . . . . . . . . . . . . . . 118 Utilisation de commandes d'interface utilisateur personnalisées dans les extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Ajout de contenu Flash à Dreamweaver. . . . . . . . . . . . . . . . . . . . . . . . . 130 Chapitre 5 : Modèle d'objet de document (DOM) Dreamweaver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 De quel DOM de document parlons-nous ? . . . . . . . . . . . . . . . . . . . . . 134 DOM Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 PARTIE 3 : API D'EXTENSION Chapitre 6 : Objets de la barre Insérer . . . . . . . . . . . . . . . . . . . . . 147 Fonctionnement des fichiers d'objet . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 Fichier de définition de la barre Insérer. . . . . . . . . . . . . . . . . . . . . . . . . . 149 Modification de la barre Insérer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 Exemple simple d'insertion d'un objet. . . . . . . . . . . . . . . . . . . . . . . . . . . 159 API des objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 Chapitre 7 : Commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 Fonctionnement des commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ajout de commandes au menu Commandes. . . . . . . . . . . . . . . . . . . . . Exemple de commande simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . API des commandes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 178 179 186 Chapitre 8 : Menus et commandes de menu . . . . . . . . . . . . . . . . 191 A propos du fichier menus.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Modification des menus et commandes de menu . . . . . . . . . . . . . . . . 201 Commandes de menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 Exemple de commande de menu simple . . . . . . . . . . . . . . . . . . . . . . . 209 Exemple de menu dynamique. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 API des commandes de menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 Chapitre 9 : Barres d'outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 Fonctionnement des barres d'outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 Fichier de commandes de barre d'outils simple . . . . . . . . . . . . . . . . . 230 4 Table des matières Fichier de définition de la barre d'outils . . . . . . . . . . . . . . . . . . . . . . . . . 233 Balises d'éléments de barre d'outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 Attributs de balises d'éléments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 API de commande de la barre d'outils . . . . . . . . . . . . . . . . . . . . . . . . . . .251 Chapitre 10 : Rapports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 Rapports de site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .261 Rapports autonomes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 API de rapports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268 Chapitre 11 : Bibliothèques et éditeurs de balises . . . . . . . . . . . 273 Format de fichier bibliothèque de balises . . . . . . . . . . . . . . . . . . . . . . . 274 Sélecteur de balises. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 Exemple simple de création d'un éditeur de balise . . . . . . . . . . . . . . . 282 API de l'éditeur de balises. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 Chapitre 12 : Inspecteurs de propriétés . . . . . . . . . . . . . . . . . . . . 291 Fonctionnement des fichiers d'inspecteur de propriétés. . . . . . . . . . 293 Exemple simple d'inspecteur de propriétés . . . . . . . . . . . . . . . . . . . . . 294 API de l'inspecteur de propriétés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 Chapitre 13 : Panneaux flottants . . . . . . . . . . . . . . . . . . . . . . . . . . 301 Fonctionnement des fichiers de panneau flottant. . . . . . . . . . . . . . . . 302 Exemple de panneau flottant simple . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 API du panneau flottant. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 Chapitre 14 : Comportements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 Fonctionnement des comportements . . . . . . . . . . . . . . . . . . . . . . . . . . .318 Exemple de comportement simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320 API de comportements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 Chapitre 15 : Comportements de serveur. . . . . . . . . . . . . . . . . . 335 Architecture de Dreamweaver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 Exemple de comportement de serveur simple. . . . . . . . . . . . . . . . . . . 339 Comment appeler les fonctions de l'API de comportement de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .341 API de comportement de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344 Fonctions d'implémentation des comportements de serveur . . . . . 350 Modification des fichiers EDML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 Balises de fichiers EDML Groupe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 Table des matières 5 Fichiers EDML Participant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .363 Techniques de comportements de serveur . . . . . . . . . . . . . . . . . . . . . . 387 Chapitre 16 : Sources de données . . . . . . . . . . . . . . . . . . . . . . . 397 Fonctionnement des sources de données . . . . . . . . . . . . . . . . . . . . . .398 Exemple simple de source de données . . . . . . . . . . . . . . . . . . . . . . . . 400 API des sources de données. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 Chapitre 17 : Formats de serveur . . . . . . . . . . . . . . . . . . . . . . . . . 417 Fonctionnement du formatage de données . . . . . . . . . . . . . . . . . . . . . 418 Mise en service des fonctions de formatage de données. . . . . . . . . 420 API de formats de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 Chapitre 18 : Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 Composants de base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 Extension du panneau Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . .426 Personnalisation du panneau Composants . . . . . . . . . . . . . . . . . . . . . .427 Fichiers du panneau Composants . . . ...