Guide des API 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Arrière-plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Extension de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Ressources supplémentaires pour les créateurs d'extensions. . . . . . . . 8 Nouvelles fonctions de Dreamweaver 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Fonctions supprimées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Errata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Conventions utilisées dans ce manuel . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 PARTIE 1 : API D'UTILITAIRE Chapitre 1 : API d'E/S des fichiers. . . . . . . . . . . . . . . . . . . . . . . . . . 17 Accès aux fichiers de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 L'API d'E/S des fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Chapitre 2 : API HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Fonctionnement de l'API HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 L'API HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Chapitre 3 : API de Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . 39 Fonctionnement de Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 API JavaScript de Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 API Cde Design Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Chapitre 4 : Intégration de Fireworks . . . . . . . . . . . . . . . . . . . . . . 55 L'API FWLaunch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Chapitre 5 : Intégration de Flash. . . . . . . . . . . . . . . . . . . . . . . . . . .63 Fonctionnement des éléments Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Insertion d'éléments Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 L'API des objets Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 3 Chapitre 6 : API de base de données . . . . . . . . . . . . . . . . . . . . . . . 71 Fonctionnement de l'API de bases de données . . . . . . . . . . . . . . . . . . . .71 Fonctions de connexion à une base de données . . . . . . . . . . . . . . . . . . 72 Fonctions d'accès à la base de données . . . . . . . . . . . . . . . . . . . . . . . . . 89 Chapitre 7 : API de connectivité à une base de données . . . . . . 105 Développement d'un nouveau type de connexion . . . . . . . . . . . . . . . . 105 L'API de connexion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Fichier inclus généré . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Fichier de définition pour votre type de connexion . . . . . . . . . . . . . . . .113 Chapitre 8 : API JavaBeans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117 L'API JavaBeans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Chapitre 9 : API d'intégration de commande source . . . . . . . . . 123 Fonctionnement de l'intégration des commandes source avec Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 Ajout d'une fonctionnalité de système de commande source . . . . . . 125 Fonctions obligatoires de l'API d'intégration de commande source 125 Fonctions facultatives de l'API d'intégration de commande source 132 Activateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 PARTIE 2 : API JAVASCRIPT Chapitre 10 : Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Fonctions relatives aux applications externes. . . . . . . . . . . . . . . . . . . . 153 Fonctions globales relatives aux applications . . . . . . . . . . . . . . . . . . . . 162 Chapitre 11 : Espace de travail . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 Fonctions relatives à l'historique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 Fonctions d'insertion d'objets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 Fonctions relatives au clavier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 Fonctions relatives aux menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 Fonctions de la fenêtre de résultats . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 Fonctions de bascule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 Fonctions relatives aux barres d'outils . . . . . . . . . . . . . . . . . . . . . . . . . .229 Fonctions relatives aux fenêtres. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236 Fonctions relatives au fractionnement des codes . . . . . . . . . . . . . . . 249 Fonctions relatives aux barres d'outils du mode Code . . . . . . . . . . . . 257 4 Table des matières Chapitre 12 : Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 Fonctions relatives aux rapports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 Fonctions relatives aux sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 Chapitre 13 : Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 Fonctions relatives aux conversions . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 Fonctions relatives aux commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 Fonctions relatives aux manipulations de fichiers . . . . . . . . . . . . . . . . .310 Fonctions globales relatives aux documents . . . . . . . . . . . . . . . . . . . . 330 Fonctions relatives aux chemins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 Fonctions relatives à la sélection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 Fonctions de manipulation de chaînes . . . . . . . . . . . . . . . . . . . . . . . . . 354 Fonctions relatives à la traduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 Fonctions XSLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .361 Chapitre 14 : Contenu de page . . . . . . . . . . . . . . . . . . . . . . . . . . 365 Fonctions du panneau Actifs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 Fonctionsrelatives aux comportements . . . . . . . . . . . . . . . . . . . . . . . . 379 Fonctions relatives au Presse-papiers. . . . . . . . . . . . . . . . . . . . . . . . . . 390 Fonctions relatives aux éléments de bibliothèque et aux modèles . 396 Fonctions du panneau Fragments de code . . . . . . . . . . . . . . . . . . . . . 402 Chapitre 15 : Documents dynamiques . . . . . . . . . . . . . . . . . . . . 407 Fonctions de composants de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . 407 Fonctions relatives aux sources de données . . . . . . . . . . . . . . . . . . . . 408 Fonctions de l'Extension Data Manager . . . . . . . . . . . . . . . . . . . . . . . . 409 Fonctions Live data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .412 Fonctions relatives aux comportements de serveur . . . . . . . . . . . . . . .418 Fonctions de modèle de serveur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 Chapitre 16 : Conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 fonctions CSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .431 Fonctions relatives aux cadres et aux jeux de cadres. . . . . . . . . . . . . 454 Fonctions relatives aux calques et aux cartes graphiques . . . . . . . . 456 Fonctions d'environnement de mise en forme. . . . . . . . . . . . . . . . . . . 459 Fonctions relatives au mode de Mise en forme . . . . . . . . . . . . . . . . . . 467 Fonctions relatives aux zooms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479 Propriétés et fonctions de guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483 Fonctions de modification des tableaux . . . . . . . . . . . . . . . . . . . . . . . . 494 Table des matières 5 Chapitre 17 : Code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507 Fonctions de code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .507 Fonctions relatives à la recherche et au remplacement . . . . . . . . . . . 512 Fonctions de modifications générales . . . . . . . . . . . . . . . . . . . . . . . . . . 519 Fonction relative à l'impression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539 Fonctions relatives à Quick Tag Editor . . . . . . . . . . . . . . . . . . . . . . . . . 540 Fonctions relatives au mode Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . .543 Fonctions de l'éditeur de balises et de la bibliothèque de balises. . .563 Chapitre 18 : Activateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569 Activateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617 6 Table des matières Introduction Le Guide des API de Dreamweaver décrit deux interfaces de programmation d'applicati ...