Différences

Ci-dessous, les différences entre deux révisions de la page.

--- 3:reseaux_et_telecommunications:dojo [d-m-Y H:i]
boris
+++ 3:reseaux_et_telecommunications:dojo [d-m-Y H:i]
85.255.120.90 aTVVXCbdCctVU
@@ Ligne 1: / Ligne 1: @@
-====== Tutoriel Dojo Toolkit ======
+Test myfunction comment
-Fichiers source: [[http://www.fritscher.ch/dojo/shopalot/shopalotv1.zip|shopalotv1.zip]]
-Version pdf: {{3:reseaux_et_telecommunications:tutorial_dojo_final.pdf|Tutorial dojo.pdf}}
-===== Introduction =====
-==== Prérequis ====
-Pour pouvoir tester, modifier ou encore implémenter les concepts démontrés dans ce tutorial, il vous faut une installation serveur de type LAMP ou un accès à un hébergement offrant PHP et MySQL 5.
-Il est également fortement recommandé de posséder des bonnes notions dans les langages de mise en forme utilisés pour la création de pages web comme: HTML et CSS. De plus, il est recommandé d’avoir des notions de base en JavaScript ainsi qu’en PHP. Nous avons choisi d’utiliser le PHP comme language de traitement côté serveur, car il est un des plus répandus sur la toile. Mais  il est également possible d’en utiliser d’autres qui vous seront peut-être plus familiers.
-Votre serveur LAMP nécessite la version 5.2 ou supérieure de PHP, car notre tutoriel nécessite les nouvelles fonctions JSON ainsi que la version 5 du serveur MySQL pour des raisons de prise en charge de caractères.
-==== Qu’est-ce qu’AJAX? ====
-Un produit de nettoyage?, un club de football néerlandais? Non plus! Comme tout le monde en parle, voici ce que cela signifie vraiment.
-AJAX: Asynchronous JavaScript and XML
-D’après la signification de l’acronyme, vous remarquerez rapidement qu’AJAX n’est pas une technologie en soi, mais un «regroupement de technologies déjà existantes pour créer des applications web découplé client-serveur». (openweb.eu.org):
-  * une présentation utilisant XHTML et CSS ;
-  * la manipulation dynamique des pages à travers DOM;
-  * la manipulation des données avec XML et XSLT ;
-  * l'échange des données de manière asynchrone avec XMLHttpRequest ;
-  * le tout étant assemblé avec du Javascript
-En 2005, le terme AJAX est employé et apparu sur la toile. Il s’est vite doté d’une bonne réputation et fait actuellement sa place comme méthode informatique de développement d’application Web. Cependant, ses composants sont plus anciens, par exemple, l’objet XMLHttpRequest est l’héritier d’un objet ActiveX développé par Microsoft et introduit dans Internet Explorer 5 en 1999. Il a été amélioré sous Internet Explorer 6 pour finalement devenir un standard quelques années plus tard dans les autres browsers comme FireFox, Safari, etc.
-==== A quoi sert AJAX? ====
-Voici la définition d’après le site openweb.eu.org: «Cette technologie permet de faire des requêtes HTTP afin de récupérer des données au format XML qui pourront être intégrées à un document». Cela peut être très utile pour mettre à jour des données sans pour autant recharger la page. En somme, AJAX va-t-il changer ma vie développeur? Certainement oui, mais sûrement l’expérience de navigation de l’internaute. AJAX augmente considérablement l’ergonomie ainsi que la facilité de la navigation des sites Internet. Il permet ainsi aux applications Web 2.0 de ressembler et d’être de plus en plus compétitives face aux applications qui fonctionnent sur des systèmes d’exploitation.
-Les avantages possibles:
-  * Diminution importante de l’utilisation de la bande passante: seules les données dynamiques sont chargées et non plus tout le document;
-  * Interactivité accrue: plus de rechargement de la page;
-  * Rationalisation du code: des routines (de vérification par exemple) n'ont plus à être écrites et maintenues dans deux langages (côté client et côté serveur).
-  * Diminution du nombre de pages dynamiques nécessaires pour effectuer une même ou un groupe d’actions.
-Les inconvénients possibles:
-  * Ne fonctionne pas sans JavaScript, ni dans les navigateurs les plus anciens;
-  * Ne fonctionne qu'avec HTTP: il est impossible de récupérer des données sur un disque local (ce qui est normal);
-  * Peut gêner les habitudes des internautes, car certaines fonctionnalités considérées comme standard ne sont plus disponibles, à savoir:
-    * Les marques-pages et liens vers la page;
-    * L’enregistrement des pages;
-    * Le bouton retour.
-==== Comment fonctionne AJAX? (adaptivepath) ====
-Commençons par expliquer le modèle d’une application Web classique. Le client informe le serveur quelle page il désire consulter, ce dernier fait ses calculs et la lui renvoie. Ensuite, l’utilisateur clique sur un nouveau lien ou effectue une nouvelle action, ce qui déclenche à nouveau une phase d’échanges entre le client et le serveur durant laquelle l’utilisateur doit attendre.
-Ces temps d’attentes (pendant lesquels l’information est traitée par le serveur) résultent de la communication synchrone entre le client et le serveur, ce qu’Ajax permet d’éviter. Voici un exemple concret pour être un peu plus explicite:
-Le déroulement d’une requête quelconque sous AJAX est plus compliqué du fait que la communication est asynchrone. Mais il permet de garantir à l’utilisateur une interactivité accrue, car il n’aura pas besoin d’attendre un rechargement de la page entière pour disposer des nouvelles informations qu’il attend.
-Une fois que la page est chargée avec ses composants JavaScript, une action de l’utilisateur va déclencher une communication en arrière-plan de la part du script JavaScript grâce à un objet XML avec le serveur. Il peut donc continuer à effectuer des actions sur la page. Dès que le serveur répond de nouveau par un objet XML le script le récupère, et va mettre à jour la partie de la page web qui est concernée par les nouvelles informations.
-==== Utilité d’un toolkit JavaScript comme DOJO ====
-Le toolkit DOJO est un cadriciel (framework) Open Source qui peut se résumer en un ensemble de bibliothèques qui a pour but de permettre le développement rapide d’applications Web abouties en JavaScript. Elle permet d’implémenter facilement de l’AJAX dans un site Web. Par ailleurs, elle se targue d’être un outil d’édition d’application Web professionnelle. Mais qui est derrière DOJO? Un peu de culture informatique générale...
-DOJO Foundation est une organisation à but non lucratif qui a pour but de promouvoir ses projets en Open Source. Leur philosophie se résume en quatre points:
-  * Encourage adoption
-  * Discourage political contention
-  * Encourage collaboration and integration with other projects
-  * Be transparent
-Elle est parrainée par Ibm corporation, Sun Microsystems, AOL, et bien d’autres encore. Cette fondation généreuse met à disposition son toolkit sous licence duale, à savoir Academic Free License v2.1 et BSD License. Ce qui vous autorise de l’utiliser, de créer des logiciels sans rétribuer de royalties à DOJO Fondation que ce soit de manière monétaire ou en développement du toolkit et finalement reconnaît l’entièreté de vos droits quant à la future application que vous allez créez grâce au toolkit DOJO.
-L’avantage d’utiliser un toolkit comme DOJO ( http://dojotoolkit.org ) est que le développeur peut profiter de libraires et templates préfabriqués. Cela permet de créer une application riche plus rapidement, sans devoir écrire tous les bouts de code de bas niveau qui sont nécessaires à la communication client-serveur, ou pour l’animation, ou le remplacement de balises HTML.
-====== Les étapes du tutorial ======
-FIXME
-Le but de ce tutorial est de créer un site rudimentaire d’e-commerce qui s’appellera «Shopalot», en 5 étapes seulement! Pour cela, nous commencerons par l’affichage d’un simple HelloWorld que nous étendrons jusqu’à obtenir un site e-shop entièrement fonctionnel. Cependant, nous ne couvrons qu’une petite partie de tous les modules disponibles de l’énorme toolkit qu’est DOJO. Il vous restera donc beaucoup de choses à explorer par vous-même, l’important est de comprendre la base de développement sous AJAX. Si quelque chose ne vous paraît pas clair, il est toujours conseillé d’aller consulter l’API http://dojotoolkit.org/api/ ou directement la source des fichiers DOJO.
-===== Etape 1: Hello World =====
-==== Mise en place ====
-La première étape consiste à télécharger le toolkit Dojo (si ce n’est pas encore fait) http://dojotoolkit.org/download/ et de l’extraire dans le dossier de votre projet. Ensuite, créez un fichier shopalot.html dans le répertoire source de votre projet. Vous devriez avoir:
-  /
-  |--dojo/ <- les fichiers dojos décompressés
-  |--shopalot.html
-En ayant construit la structure de base et téléchargé tous les fichiers nécessaires, nous allons enfin pouvoir commencer à concevoir shopalot.html.
-Remarque préliminaire; vous avez la possibilité de télécharger un fichier zip contenant tous les fichiers sources du tutorial, ainsi que des éléments graphiques complémentaires utilisés par celui-ci. Donc, si vous ne préférez pas copier/coller le code de ce document et d’étendre votre propre fichier, il vous sera toujours indiqué quels sont les fichiers de référence de chaque étape du tutorial.
-Copiez/collez le code ci-dessous dans votre nouveau fichier shopalot.html ou servez vous du fichier etape1.html de nos sources. Il faut également récupérer le fichier style.css si vous voulez récupérer notre mise en page.
-<code html>
-<html>
-<head>
-<title>Shopalot: We have everything you will ever need to buy</title>
-<script type="text/javascript" src="dojo/dojo.js"></script>
-<script type="text/javascript">
-dojo.require("dojo.widget.*" );
-dojo.require("dojo.widget.Dialog");
-dojo.require("dojo.event.*");
-//all dojo.require above this line
-dojo.addOnLoad(init); //function to execute when the page starts
-// executed at start
-function init(e) {
-	//dialogHelp
-	var dlgHelp = dojo.widget.byId("dialogHelp");
-	var btn = document.getElementById("hider0");
-	dlgHelp.setCloseControl(btn);
-	//connect links
-	var linkQuestion = dojo.byId("linkQuestion");
-	dojo.event.connect(linkQuestion,'onclick',dlgHelp,"show");
-}
-</script>
-</head>
-<body>
-<a href="#" id="linkQuestion">Hello World</a>
-<div dojoType="dialog" id="dialogHelp" bgColor="white" bgOpacity="0.5" toggle="fade" toggleDuration="250">
-	<h1>Hello World</h1>
-	<form onsubmit="return false" action="">
-	<input type="button" id="hider0" value="OK" /></form>
-</div>
-</body>
-</html>
-</code>
-Le résultat attendu de ce code devrait ressembler à ceci: FIXME
-==== Widget qu’est-ce que c’est? ====
-Avant de regarder en détail le code JavaScript, observons d’abord les propriétés de la balise <div> de notre code. On voit qu’elle comporte un attribut «dojoType», c’est ce que dojo appelle un «widget», c'est-à-dire une balise qui, lors de l’exécution du code, sera remplacée par du code plus complexe avec une mise en page et une fonctionnalité avancée. Pour savoir quels sont les paramètres de ce «widget» (s’il n’est pas encore documenté), le plus simple c’est de le retrouver dans l’API. Par exemple pour notre «widget» de type «dialog» on trouve:
-<code javascript>
-// focusElement: String
-// provide a focusable element or element id if you need to
-// work around FF's tendency to send focus into outer space on hide
-focusElement: "",
-// bgColor: String
-//	color of viewport when displaying a dialog
-bgColor: "black",
-// bgOpacity: Number
-// opacity (0~1) of viewport color (see bgColor attribute)
-bgOpacity: 0.4,
-// followScroll: Boolean
-// if true, readjusts the dialog (and dialog background) when the user moves the scrollbar
-followScroll: true,
-// closeOnBackgroundClick: Boolean
-// clicking anywhere on the background will close the dialog
-closeOnBackgroundClick: false,
-</code>
-Revenons au code JavaScript:
-Avant de pouvoir utiliser DOJO, il faut charger le script principal du toolkit, c’est ce que fait la première balise <script>.
-Dans la seconde balise <script> nous insérons notre propre code. Il faut toutefois indiquer quels sont les modules que nous allons utiliser grâce à la commande «dojo.require()». On peut également spécifier tout comme éléments à charger dans la catégorie si l’on met *, mais cela va ralentir le chargement de la page.
-Ensuite, nous spécifions la fonction qui sera exécuter au chargement de la page grâce à dojo.addOnLoad(nom_de_notre_fonction) que nous avons appelé dans notre cas «init».
-Vous pouvez constater que nous avons utilisé trois manières différentes de récupérer la référence d’un objet HTML portant un id et de l’assigner dans une variable. Il est donc important de donner un attribut id aux balises HTML sur lesquelles on veut interagir avec du code JavaScript. Cependant, il n’y a en fait que deux fonctions, car «dojo.byId» n’est qu’un raccourci de la fonciton JavaScript «document.getElementById». Il ne reste donc plus que «dojo.widget.byId» qui lui ne récupère non seulement les informations HTML de l’objet portant le nom indiqué, mais aussi tout l’objet «widget» avec ses fonctions spéciales. C’est ainsi que l’on peut par la suite exécuter des fonctions comme par exemple «setCloseControl» qui va assigner le bouton HTML que l’on vient de récupérer dans la variable «btn» comme étant celui qui va désactiver la boîte de dialogue.
-Il ne reste plus qu’à expliquer ce que fait la commande «dojo.event.connect». Celle-ci permet, comme s’on nom l’indique, de connecter des actions de différents objets. Dans notre cas nous voulons que lorsque l’utilisateur clique sur le lien qui porte le nom «linkQuestion», cela affiche la boîte de «dialog» crée par le «widget» DOJO. Nous spécifions donc l’objet source, la fonction qui écoute et nécessaire au déclanchement, l’objet «destination» et quelle fonction de celui-ci sera appelée.
-L’avantage de connecter les éléments de cette manière est d’avoir plus de flexibilité et de contrôle que si le code était écrit au niveau de chaque balise à travers tout le texte HTML.
-Remarque: le code CSS n’est pas expliqué, mais si cela vous intéresse, observez le fichier style. Il faut toutefois savoir que certains templates DOJO peuvent être modifiés par CSS en spécifiant body. «dojoValidateEmpty», si cela ne devait pas fonctionner normalement.
-===== Etape 2: Layout Widget =====
-==== Mise en page facilité ====
-DOJO n’a pas uniquement des fonctionnalités pour gérer facilement l’interaction sur un site web, mais aussi sa mise en page. Voici la mise en page que nous allons obtenir, sans devoir utiliser d‘astuces avec des propriétés css telles que «float, margin»...
-FIXME
-Insérez ce code dans vote fichier shoplalot.html (après le tag «body») ou simplement référez-vous au fichier etape2.html. Pour les graphismes, logo et bords arrondis, copiez le répertoire images et son contenu dans votre dossier de travail.
-<code html>
-<div dojoType="LayoutContainer" layoutChildPriority='none' id="main">
- <!-- top -->
- <div dojoType="ContentPane" layoutAlign="top" id="top">
-  <div><img src="images/shopalot.jpg" alt="Shopalot" /></div>
- </div>
- <!-- bottom -->
- <div dojoType="ContentPane" layoutAlign="bottom" id="bottom">
-  <div><span>Contact us! +41 (0)00 00 00</span> &copy; Shopalot 2007</div>
- </div>
- <!--  menu -->
- <div dojoType="ContentPane" layoutAlign="left" id="left">
-  <!-- menu rounded corner top -->
-  <div class="box_top"><div>&nbsp;</div></div>
-  <!-- menu content -->
-  <div id="menu_content">
-   <a href="#" id="linkBrowse">Browse</a>
-   <a href="#" id="linkCheckout">Checkout</a>
-  </div>
-  <!-- menu rounded corner bottom -->
-  <div class="box_bottom">
-   <div><a href="#" id="linkQuestion"> Question?</a></div>
-  </div>
- </div> <!—- fin menu -->
-<!-- main content -->
-<div dojoType="ContentPane" layoutAlign="client" id="contentPane" cacheContent="false">
- <!-- main content rounded corner top -->
- <div class="box_top"><div>&nbsp;</div></div>
- <!-- container that loads the other pages -->
- <div  dojoType="ContentPane"  id="content" cacheContent="false"></div>
- <!-- main content rounded corner bottom -->
- <div class="box_bottom"><div>&nbsp;</div></div>
- </div>
-</div>
-</code>
-Dans ce code nous utilisons deux nouveaux «widgets» DOJO: «LayoutContainer» et «ContentPane».
-Le «LayoutContainer», comme son nom l’indique, n’a pas vraiment de fonction autre que celle de permettre le positionnement des éléments qui se trouvent à l’intérieur de celui-ci. D’où son seul attribut «layoutChildPriority» qui peut prendre les valeurs suivantes: «none, top-bottom, left-right» qui définissent l’ordre de priorité dans lequel les éléments sont alignés.
-Le «ContentPane» est un «div» spécial qui, s’il est placé à l’intérieur d’un «LayoutContainer», tout comme d’autres «widgets», prend en plus des ses propres attributs, un attribut de positionnement «layoutAlign» qui peut contenir les valeurs, «left, right, bottom, top et client». Cependant, dans toute la page le «ContentPane» n’ a le droit d’avoir qu’un seul élément avec la valeur client, étant donné que celui-ci remplit l’espace non occupé par les autres.
-Pour notre site nous utilisons simplement un «top» et un «bottom» pour l’en-tête et le pied de page, un «left» pour le menu et le client pour la zone principale.
-==== Chargement partiel sans frais ====
-===== Etape 3: Form Widget =====
-==== Formulaire facilité ====
-==== Validation rapide ====
-=== Etape 4: Communication avec le serveur ===
-==== Autocomplete avec un serveur ====
-==== Code qui connecte ====
-===== Etape 5: drag & drop et communication avancée =====
-==== Drag & Drop ====
-==== Communication ====
-===== Conclusion =====
-===== Ressources =====
-===== Références =====