Exemple - Scriptage
Introduction
Ces exemples montrent comment utiliser Javascript et une interface utilisateur à base de code
HTML pour créer des extensions.
Exécution de l'exemple
Avant d'appeler l'un quelconque des exemples, ouvrez la vue Console de script en
sélectionnant "Perspective > Afficher la vue > Autre... > Génération de script > Console
de script".
Les messages générés par les exemples seront présentés dans la vue Console de script.
Plusieurs exemples de scriptage sont fournis.
Les instructions suivantes indiquent comment exécuter chacun d'eux.
-
Evaluer un script Javascript
Le bouton de la barre d'outils intitulé "Perform Scripted Javascript Action" déclenche
l'évaluation d'un script Javascript qui réside dans le fichier
excalibur.js. Ce script effectue les opérations suivantes :
-
Imprime une instruction "Begin".
-
Imprime toute ressource sélectionnée.
-
Présente une boîte de dialogue de sélection de conteneur du plan de travail et imprime le conteneur
sélectionné une fois la boîte de dialogue refermée.
-
Présente une boîte de dialogue de sélection de fichier du plan de travail et imprime le ou les nom(s) de fichier
sélectionné(s) lorsque la boîte de dialogue est refermée.
-
Présente une boîte de dialogue de sélection de dossier système et imprime le nom du répertoire
sélectionné lorsque la boîte de dialogue est refermée.
-
Présente une boîte de dialogue de sélection de fichiers système et imprime les noms de fichier
sélectionnés lorsque la boîte de dialogue est refermée.
-
Présente une boîte de message avec un bouton OK.
-
Présente une boîte de message avec des boutons OK et Cancel, et imprime le bouton qui a été actionné
lorsque la boîte est refermée.
-
Imprime l'emplacement d'installation du plug-in.
-
Imprime la liste de tous les points d'extension actuellement répertoriés dans le registre
du plug-in.
-
Imprime la liste de toutes les ressources (projets, dossiers et fichiers) de la solution ouverte
en cours.
-
Crée un projet nommé "ScriptProject".
-
Imprime une instruction "End".
-
Présenter un assistant avec gestion des événements Javascript
Le bouton de la barre d'outils intitulé "Perform Scripted User Interface Script
Action" appelle la classe Java org.eclipse.scripting.examples.ExcaliburScriptRenderer.
Celle-ci utilise une autre classe appelée org.eclipse.scripting.Renderer pour présenter
une interface utilisateur qui réside dans le fichier excaliburScriptRenderer.html.
Cette interface utilisateur est alimentée par les données qui se trouvent
dans le fichier excaliburCompany.xml.
-
Présenter un assistant avec gestion des événements Java
Le bouton de la barre d'outils intitulé "Perform Scripted User Interface JavaScript
Action" présente une interface utilisateur qui est définie dans le fichier
excaliburScript.html.
Cette interface est elle-même alimentée par les données qui résident
dans le fichier excalibur.xml.
-
Appeler un éditeur avec gestion des événements Javascript
-
Sélectionnez un fichier XML dans la vue Navigateur (si aucun n'est disponible, créez-en un).
-
Ouvrez le fichier en cliquant deux fois dessus.
-
L'éditeur de ressources scriptées
(Scripted Resource Editor) est alors lancé. Il contient des champs prévus pour
la saisie du prénom et du nom d'une personne ainsi que pour son numéro de téléphone
personnel, son numéro de portable et son numéro de fax.
Un bouton de sauvegarde (Save) est également présent dans l'interface de cet éditeur.
-
Présenter une page de préférences avec gestion des événements Javascript
-
Sélectionnez l'option de menu "Fenêtre / Préférences" et cliquez sur la page
Scripted JavaScript Example.
-
Présenter un assistant avec gestion des événements Javascript
-
Sélectionnez l'option de menu "Fichier > Nouveau > Autre... > Scripted JavaScript Example".
-
Cliquez sur Suivant (Next).
-
Le contenu de la page de l'assistant est rendu disponible via un fichier externe
situé dans le répertoire plugins.
-
Présenter un assistant avec gestion des événements Java
-
Sélectionnez l'option de menu "Fichier > Nouveau > Autre... ", puis choisissez "Scripted Handler
Example".
-
Cliquez sur Suivant (Next).
-
Le contenu de la page de l'assistant est rendu disponible via un fichier externe
situé dans le répertoire plugins.
-
Présenter un assistant avec gestion des événements Javascript
-
Sélectionnez l'option de menu "Fichier > Importer ", puis choisissez "Scripted JavaScript Example".
-
Sélectionnez l'option de menu "Fichier > Exporter", puis choisissez "Scripted JavaScript Example".
-
Cliquez sur Suivant (Next).
-
Le contenu de la page de l'assistant est rendu disponible via un fichier externe
situé dans le répertoire plugins.
Détails
Tous les fichiers référencés dans ces exemples (scripts, xml, etc.) se trouvent
dans le répertoire "/plugins/org.eclipse.scripting.examples".
Interfaces utilisateur
Une interface utilisateur commune est utilisée pour tous les exemples à l'exception
de l'éditeur de ressources (Resource Editor).
Cette interface est composée de deux pages.
La première page montre comment utiliser certaines des fonctions de scriptage
du Toolkit, à savoir :
Affichage d'une fenêtre de sélection d'un conteneur du plan de travail
Affichage d'une fenêtre de sélection de fichiers du plan de travail
Affichage d'une fenêtre de sélection d'un répertoire système
Affichage d'une fenêtre de sélection d'un fichier système
Présentation d'une boîte de message avec un bouton OK
Présentation d'une boîte de message avec un bouton OK et un bouton
Cancel (Annuler)
La seconde page montre comment il est possible d'associer des éléments de présentation
à des éléments de données.
Le fait de sélectionner un ou plusieurs éléments dans la boîte à liste
Departments met à jour le contenu de la boîte à liste Employees ainsi que celui
des zones d'entrée et des libellés situés en dessous des boîtes à liste. Si
vous modifiez le contenue des zones d'entrée, dans le bas de la page, le modèle de données
est automatiquement mis à jour en conséquence.
Exemple Resource Editor
L'exemple d'éditeur de ressources
(Resource Editor) affiche une page d'entrée de données.
Si le fichier
excaliburEditorScript.xml est sélectionné et que vous choisissez
"Ouvrir avec > Scripted Resource Editor Example" dans son menu contextuel, la page suivante
de l'éditeur est affichée.
Si un autre fichier XML est sélectionné, les zones d'entrée sont vides.