Extension de Dreamweaver Marques commerciales Add Life to the Web, Afterburner, Aftershock, Andromedia, Allaire, Animation PowerPack, Aria, Attain, Authorware, Authorware Star, Backstage, Bright Tiger, Clustercats, Cold Fusion, Contribute, Design in Motion, Director, Dream Templates, Dreamweaver, Drumbeat 2000, EDJE, EJIPT, Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, Generator, HomeSite, JFusion, JRun, Kawa, Know Your Site, Knowledge Objects, Knowledge Stream, Knowledge Track, LikeMinds, Lingo, Live Effects, MacRecorder Logo and Design, Macromedia, Macromedia Action!, Macromedia Flash, Macromedia M Logo & Design, Macromedia Spectra, Macromedia xRes Logo and Design, MacroModel, Made with Macromedia, Made with Macromedia Logo and Design, MAGIC Logo and Design, Mediamaker, Movie Critic, Open Sesame!, Roundtrip HTML, Shockwave, Sitespring, SoundEdit, Titlemaker, UltraDev, Web Design 101, what the web can be et Xtra sont des marques ou des marques déposées de Macromedia, Inc. et peuvent être déposées aux Etats-Unis ou dans d'autres pays. Les autres noms de produit, logos, concepts, titres, mots ou phrases mentionnés dans cette publication peuvent être des marques commerciales, des marques de service ou des noms commerciaux de Macromedia, Inc. ou d'autres entités et peuvent être déposés dans certaines juridictions ou certains pays. 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. Vous trouverez des informations sur les logiciels tiers et/ou d'autres conditions générales à l'adresse suivante : http://www.macromedia.com/go/thirdparty_fr/. Navigateur Opera ® Copyright © 1995-2002 Opera Software ASA et ses fournisseurs. Tous droits réservés. Dénégation de responsabilité d'Apple APPLE COMPUTER, INC. N'ASSUME AUCUNE GARANTIE, IMPLICITE OU EXPLICITE, SUR LE LOGICIEL INFORMATIQUE CI-INCLUS, SA COMMERCIABILITE OU SON ADEQUATION A UN OBJECTIF PARTICULIER. L'EXCLUSION DES GARANTIES IMPLICITES N'ETANT PAS AUTORISEE DANS CERTAINS ETATS, L'EXCLUSION CI-DESSUS PEUT DONC NE PAS S'APPLIQUER A VOTRE CAS. CETTE GARANTIE VOUS OFFRE DES DROITS JURIDIQUES SPECIFIQUES. VOUS POUVEZ DISPOSER DE CERTAINS AUTRES DROITS, QUI VARIENT SELON LES ETATS. Copyright © 1997-2003 Macromedia, Inc et ses bailleurs de licence. Tous droits réservés. Ce manuel ne peut pas être copié, photocopié, reproduit, traduit ou converti sous forme électronique ou informatique, en partie ou en totalité, sans l'autorisation écrite préalable de Macromedia, Inc. Numéro de référence ZDW70M300F Remerciements Direction : Sheila McGinn Gestion de projet : Robert Berry Rédaction : Robert Berry, David Jacowitz Responsable édition : Lisa Stanziano Mise en forme : Mary Kraemer, Noreen Maher Gestion de la production : Patrice O'Neill Conception et production : Adam Barnett, Aaron Begley, Chris Basmajian, John Francis, Jeff Harmon Remerciements particuliers à Jay London, Jeff Schang, Lori Hylan-Cho, Hisami Scott, Sam Mathews, Jake Cockrell, Russ Helfand, Randy Edmunds, George Comninos, Rosana Francescato, Charles Nadeau, Bonnie Loo, Gwenael Cossoul, Luciano Arruda, Masayo Noda, Richard Clairicia, Scott Richards, Seungmin Lee, Vincent Truong, Birnou Sébarte et les équipes d'ingénierie et de contrôle qualité de Dreamweaver. Première édition : Septembre 2003 Macromedia, Inc. 600 Townsend St. San Francisco, CA 94103 Etats-Unis TABLE DES MATIERES CHAPITRE 1 : Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 14 14 14 15 15 16 16 16 17 Arrière-plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation d'une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ressources supplémentaires pour les créateurs d'extensions . . . . . . . . . . . . . . . . . . Nouveautés du manuel Extension de Dreamweaver. . . . . . . . . . . . . . . . . . . . . . . . Modifications de la documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Macromedia Press. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fonctionnalités supprimées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Errata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conventions utilisées dans ce manuel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PARTIE I : Présentation CHAPITRE 2 : Extension de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Types d'extensions de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Autres méthodes d'extension pour Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . 23 Extensions et dossiers de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Dossiers de configuration multiutilisateur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Exécution des scripts au démarrage ou à la fermeture . . . . . . . . . . . . . . . . . . . . 25 API d'extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Traitement de JavaScript dans les extensions par Dreamweaver . . . . . . . . . . . . . 25 Affichage de l'aide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Localisation d'une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Fichiers de chaîne XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Chaînes localisables avec valeurs intégrées. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Utilisation de Extension Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Personnalisation de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 A propos de la personnalisation de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . 29 A propos de la personnalisation de Dreamweaver dans un environnement multiutilisateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 A propos de la syntaxe des balises mm_deleted_files.xml . . . . . . . . . . . . . . . . . 31 Réinstallation et désinstallation de Dreamweaver dans un environnement multiutilisateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Personnalisation de documents par défaut . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Personnalisation de conceptions de pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 3 Personnalisation de l'aspect des boîtes de dialogue . . . . . . . . . . . . . . . . . . . . . . 32 Modification du type de fichier par défaut . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Personnalisation de l'interprétation de balises propriétaires . . . . . . . . . . . . . . . . 34 Utilisation des profils de navigateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 A propos de la mise en forme des profils de navigateurs . . . . . . . . . . . . . . . . . . 40 Création et modification d'un profil de navigateur . . . . . . . . . . . . . . . . . . . . . . 42 Modification des mappages FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Types de documents extensibles dans Dreamweaver. . . . . . . . . . . . . . . . . . . . . . . . 43 Ouverture d'un document dans Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . 53 CHAPITRE 3 : Interfaces utilisateur destinées aux extensions . . . . . . . . . . . . . . . 55 Conception d'une interface utilisateur d'extension . . . . . . . . . . . . . . . . . . . . . . . . 55 Commande de rendu HTML de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Utilisation de commandes d'interface utilisateur personnalisées dans les extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Listes de sélection modifiables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Contrôles de base de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Ajout d'une commande de grille de variables . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Ajout de commandes d'arborescence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Manipulation du contenu d'une commande d'arborescence . . . . . . . . . . . . . . . 64 Commande de bouton couleur pour les extensions . . . . . . . . . . . . . . . . . . . . . 65 Ajout de contenu Flash à Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Exemple d'une boîte de dialogue Flash simple . . . . . . . . . . . . . . . . . . . . . . . . . 66 CHAPITRE 4 : Modèle d'objet de document (DOM) Dreamweaver . . . . . . . . . . . 69 De quel DOM de document parlons-nous ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 DOM Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Objets, propriétés et méthodes du DOM Dreamweaver . . . . . . . . . . . . . . . . . . 70 Propriétés et méthodes de l'objet document . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Propriétés et méthodes des objets de balise HTML . . . . . . . . . . . . . . . . . . . . . 74 Propriétés et méthodes des objets texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Propriétés et méthodes des objets de commentaire . . . . . . . . . . . . . . . . . . . . . . 76 Objets dreamweaver et site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 CHAPITRE 5 : Personnalisation du mode Code . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Indicateurs de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Fichier CodeHints.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Balises des indicateurs de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Coloration du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Fichiers de coloration du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Coloration des délimiteurs de bloc de modèle. . . . . . . . . . . . . . . . . . . . . . . . . 101 Traitement des modèles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Modification des modèles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Exemples de coloration du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 4 Table des matières Validation du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modification du formatage HTML par défaut . . . . . . . . . . . . . . . . . . . . . . . . . . 111 112 112 113 114 PARTIE II : API d'extension CHAPITRE 6 : Objets de la barre Insérer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Fonctionnement des fichiers d'objet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Fichier de définition de la barre Insérer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 Hiérarchie des balises du fichier Insertbar.xml . . . . . . . . . . . . . . . . . . . . . . . . 118 Balises de définition de la barre Insérer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Attributs des balises de définition de la barre Insérer. . . . . . . . . . . . . . . . . . . . 121 Modification de la barre Insérer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 Ajout d'objets à la barre Insérer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 Ajout d'objets au menu Insertion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 API des objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...