Guide d'utilisation Annuler

Création et activations des formulaires ColdFusion sous Dreamweaver

 

 

Remarque :

La prise en charge de ColdFusion a été supprimée de Dreamweaver et des versions ultérieures.

À propos des formulaires ColdFusion

Les formulaires ColdFusion fournissent plusieurs mécanismes intégrés permettant de valider les données de formulaire. Par exemple, vous pouvez vérifier si un utilisateur a entré une date valide. Certains contrôles de formulaire comportent des fonctionnalités supplémentaires. Certaines d’entre elles n’ont pas de correspondant HTML et d’autres prennent directement en charge le remplissage dynamique du contrôle à partir de sources de données.

Dreamweaver comporte de nombreuses améliorations facilitant la tâche des développeurs ColdFusion qui utilisent ColdFusion MX 7 ou une version ultérieure comme serveur de développement. Ces améliorations se présentent sous la forme d’un plus grand nombre de boutons dans le panneau Insertion, d’éléments de menu et d’inspecteurs Propriétés qui permettent de créer rapidement des formulaires ColdFusion et d’en définir les propriétés. Vous pouvez également générer du code qui valide les informations fournies par les visiteurs du site. Par exemple, vous pouvez vérifier qu’une adresse électronique saisie par un utilisateur contient bien un symbole @ (a commercial) ou qu’un champ de texte obligatoire a bien été renseigné.

Activation des améliorations ColdFusion

Certaines de ces améliorations nécessitent de définir un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure comme serveur d’évaluation de Dreamweaver. Par exemple, les inspecteurs de propriétés destinés aux contrôles de formulaires ne sont disponibles que si vous spécifiez le serveur d’évaluation correct.

Il n’est nécessaire de définir le serveur d’évaluation que la première fois. Dreamweaver détecte ensuite automatiquement la version du serveur d’évaluation et rend les améliorations disponibles si ColdFusion est détecté.

  1. Si ce n’est déjà fait, définissez un site Dreamweaver pour votre projet ColdFusion.
  2. Choisissez Site > Gérer les sites, sélectionnez votre site dans la liste, puis cliquez sur Édition.
  3. Sélectionnez la catégorie Serveurs et choisissez un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure comme serveur d’évaluation de votre site Dreamweaver. Veillez à entrer une URL Web valide.
  4. Ouvrez un document ColdFusion.

    Les changements de l’espace de travail de Dreamweaver ne sont visibles qu’après ouverture d’un document ColdFusion.

Création de formulaires ColdFusion

Vous pouvez utiliser sous Dreamweaver un plus grand nombre de boutons dans le panneau Insertion, d’éléments de menu et d’inspecteurs Propriétés pour créer rapidement des formulaires ColdFusion et définir leurs propriétés.

Remarque :

ces améliorations ne sont disponibles que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. Ouvrez une page ColdFusion et placez le point d’insertion à l’endroit où vous souhaitez insérer le formulaire.
  2. Choisissez Insertion > Objets ColdFusion > Formulaire CF > Formulaire CF, ou sélectionnez la catégorie Formulaires CF du panneau Insertion, puis cliquez sur l’icône Formulaire CF.

    Dreamweaver insère un formulaire ColdFusion vierge. Dans une page affichée en mode Création, les formulaires sont indiqués par une bordure rouge en pointillé. Si vous ne voyez pas la bordure, vérifiez que l’option Affichage > Assistances visuelles > Eléments invisibles est activée.

  3. En veillant à ce que le formulaire soit toujours sélectionné, utilisez l’inspecteur Propriétés pour définir les propriétés de formulaire suivantes.

    Formulaire CF

    Définit le nom du formulaire.

    Action

    Permet d’indiquer le nom de la page ColdFusion à traiter lorsque le formulaire est envoyé.

    Méthode

    Permet d’indiquer la méthode à utiliser pour envoyer les données du formulaire au serveur :

    POST

    Envoie les données à l’aide de la méthode HTTP post, qui envoie les données au serveur dans un message séparé.

    GET

    Envoie les données à l’aide de la méthode HTTP get, qui place le contenu des champs du formulaire dans le corps de la chaîne de la requête d’URL.

    Cible

    Permet de modifier la valeur de l’attribut « target » de la balise cfform.

    Type de codage

    Précise la méthode de codage utilisée pour transmettre les données du formulaire.

    Remarque :

    le type de codage n’a rien à voir avec le codage des caractères. Cet attribut indique le type de contenu utilisé pour envoyer le formulaire au serveur (lorsque la méthode post est utilisée). S’il n’est pas spécifié, il prend par défaut la valeur « application/x-www-form-urlencoded ».

    Format

    Détermine le type de formulaire à créer :

    HTML

    Génère un formulaire HTML et le transmet au client. Les contrôles enfants cfgrid et cftree peuvent être au format Flash ou applet.

    Flash

    Génère un formulaire Flash et le transmet au client. Tous les contrôles sont au format Flash.

    XML

    Génère un formulaire XML XForms et place les résultats dans une variable avec le nom du formulaire ColdFusion. Rien n’est envoyé au client. Les contrôles enfants cfgrid et cftree peuvent être au format Flash ou applet.

    Style

    Permet d’indiquer un style pour le formulaire. Pour plus d’informations, consultez la documentation ColdFusion.

    Enveloppe Flash/XML

    Permet d’indiquer la couleur de halo pour donner un style au résultat. Le thème détermine la couleur utilisée pour les éléments activés et sélectionnés.

    Préserver les données

    Détermine si les valeurs initiales des contrôles doivent être remplacées ou non par les nouvelles valeurs lorsque le formulaire s’autotransmet les données.

    • Si cette option a la valeur Faux, les valeurs spécifiées dans les attributs de la balise du contrôle sont utilisées.

    • Si elle a la valeur Vrai, ce sont les valeurs saisies qui sont utilisées.

    Source scripts

    Indique l’adresse URL (relative à la racine du site) du fichier JavaScript qui contient le code côté client utilisé par la balise et ses balises enfants. Cet attribut est utile si le fichier ne se trouve pas dans l’emplacement par défaut. Cet attribut peut être nécessaire dans certains environnements et configurations qui bloquent l’accès au dossier /CFIDE. L’emplacement par défaut, qui peut être modifié par l’administrateur ColdFusion, est /CFIDE/scripts/cfform.js.

    Archive

    Indique l’adresse URL des classes Java téléchargeables pour les contrôles d’applet cfgrid, cfslider et cftree. Leur emplacement par défaut est /CFIDE/classes/cfapplets.jar.

    Hauteur

    Indique la hauteur du formulaire.

    Largeur

    Indique la largeur du formulaire.

    Afficher l’éditeur de balises pour cfform

    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

  4. Insérez des contrôles de formulaire ColdFusion.

    Placez le point d’insertion à l’endroit où vous souhaitez insérer le contrôle de formulaire ColdFusion dans le formulaire, puis sélectionnez le contrôle voulu dans le menu Insertion (Insertion > Objets ColdFusion > Formulaire) ou dans la catégorie Formulaires du panneau Insertion.

  5. Si nécessaire, définissez les propriétés du contrôle dans l’inspecteur Propriétés.

    Avant de définir les propriétés dans l’inspecteur Propriétés, vérifiez que le contrôle est sélectionné en mode Création. Pour plus d’informations sur les propriétés, cliquez sur l’icône Aide de l’inspecteur Propriétés.

  6. Améliorez la mise en forme du formulaire ColdFusion.

    Si vous créez un formulaire HTML, vous pouvez utiliser des sauts de ligne, des sauts de paragraphes, du texte préformaté ou des tableaux pour mettre en forme vos formulaires. Vous ne pouvez pas insérer un formulaire ColdFusion dans un autre formulaire ColdFusion (c’est-à-dire faire se chevaucher des balises), mais vous pouvez inclure plusieurs formulaires ColdFusion dans une même page.

    Si vous créez un formulaire Flash, utilisez les styles CSS (feuilles de style en cascade) pour le mettre en page. ColdFusion ignore les balises HTML du formulaire.

    N’oubliez pas de donner un libellé avec un texte descriptif aux champs du formulaire ColdFusion, pour aider les utilisateurs. Par exemple, créez un libellé « Indiquez votre nom » pour le champ destiné au nom de l’utilisateur.

Insertion de contrôles de formulaire ColdFusion

Le panneau Insertion et le menu Insérer permettent d’insérer rapidement des contrôles dans un formulaire ColdFusion. Vous devez créer un formulaire ColdFusion vierge avant d’y insérer des contrôles.

Remarque :

ces améliorations ne sont disponibles que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. En mode Création, placez le point d’insertion à l’intérieur de la bordure du formulaire.
  2. Sélectionnez le contrôle dans le menu Insertion (Insertion > Objets ColdFusion > Formulaire) ou dans la catégorie Formulaires du panneau Insertion.
  3. Cliquez sur le contrôle sur la page pour le sélectionner, puis définissez ses propriétés dans l’inspecteur Propriétés.

    Pour plus d’informations sur les propriétés de contrôles spécifiques, consultez les rubriques consacrées à chacun d’eux.

Insertion de champs de texte ColdFusion

Vous pouvez insérer visuellement dans votre formulaire un champ de texte ou de mot de passe ColdFusion, puis définir ses options.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

Insertion visuelle d’un champ de texte ColdFusion

  1. En mode Création, placez le point d’insertion à l’intérieur de la bordure du formulaire.
  2. Dans la catégorie Formulaire du panneau Insertion, cliquez sur l’icône Champ de texte CF, ou sélectionnez Insertion > Objets ColdFusion > Formulaire > Champ de texte CF.

    Un champ de texte apparaît dans le formulaire.

  3. Sélectionnez le champ de texte et définissez ses options dans l’inspecteur Propriétés.
  4. Pour attribuer une étiquette au champ de texte dans la page, cliquez en regard du champ de texte et tapez le texte souhaité.

Insertion visuelle d’un champ de mot de passe

  1. Répétez les étapes 1 et 2 de la procédure précédente (insertion d’un champ de texte).
  2. Sélectionnez le champ de texte que vous venez d’insérer pour l’afficher dans l’inspecteur Propriétés.
  3. Dans l’inspecteur Propriétés, sélectionnez la valeur Mot de passe dans le menu déroulant Mode texte.

Options des champs de texte (ColdFusion)

Pour définir les options d’un champ de texte ou de mot de passe ColdFusion, définissez les options suivantes dans l’inspecteur Propriétés :

CFtextfield

(Ch. Texte CF) Définit l’attribut id de la balise <cfinput>.

Valeur

Permet d’indiquer le texte à afficher dans ce champ lorsque la page s’ouvre dans un navigateur. Cette chaîne peut être statique ou dynamique.

Pour indiquer une valeur dynamique, cliquez sur l’icône en forme d’éclair à côté de la zone Valeur, et sélectionnez la colonne d’un jeu d’enregistrements dans la boîte de dialogue Données dynamiques. Les jeux d’enregistrements de cette colonne fournissent les valeurs affichées dans le champ de texte lorsque le formulaire est affiché dans un navigateur.

Mode texte

Permet de passer d’un champ de saisie de texte standard à un champ de saisie de mot de passe, et inversement. L’attribut modifié par ce contrôle est type.

Lecture seule

Permet de mettre le texte affiché en lecture seule.

Long. max.

Indique le nombre maximum de caractères que peut contenir le champ.

Masque

Permet d’indiquer un masque de texte. Cette propriété permet de valider la saisie des utilisateurs. Le format du masque est composé de caractères A, 9, X et ? .

Remarque :

l’attribut de masque est ignoré pour la balise cfinput type="password".

Valider

Spécifie le type de validation du champ actuel.

Valider à

Spécifie le moment de validation : onSubmit, onBlur ou onServer.

Etiquette

Permet d’indiquer un libellé pour le champ de texte.

Schéma

Permet d’indiquer un modèle d’expression régulière en JavaScript pour valider la saisie. Les barres obliques de début ou de fin sont ignorées. Pour plus d’informations, consultez la documentation ColdFusion.

Hauteur

Permet d’indiquer la hauteur du contrôle, en pixels.

Largeur

Permet d’indiquer la largeur du contrôle, en pixels.

Taille

Permet d’indiquer la taille du contrôle.

Obligatoire

Permet de préciser si le champ de texte doit contenir des données pour que le formulaire soit transmis au serveur.

Afficher l’éditeur de balises

Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

Insertion de champs masqués ColdFusion

Vous pouvez insérer visuellement dans votre formulaire un champ masqué ColdFusion, puis définir ses propriétés. Les champs masqués permettent de conserver et transmettre des informations qui ne sont pas saisies par l’utilisateur. Ces informations sont masquées afin que l’utilisateur ne puisse pas les voir.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. En mode Création, placez le point d’insertion à l’intérieur de la bordure du formulaire.
  2. Dans la catégorie Formulaire du panneau Insertion, cliquez sur l’icône Champ caché CF.

    Un marqueur apparaît dans le formulaire ColdFusion. Si vous ne voyez pas le marqueur, choisissez Affichage > Assistances visuelles > Eléments invisibles.

  3. Sélectionnez le champ masqué sur la page et définissez les options suivantes dans l’inspecteur Propriétés :

    Cfhiddenfield

    (Champ masqué) Indique le nom unique du champ masqué.

    Valeur

    Permet d’indiquer la valeur du champ masqué. Cette chaîne peut être statique ou dynamique.

    Pour indiquer une valeur dynamique, cliquez sur l’icône en forme d’éclair à côté de la zone Valeur, et sélectionnez la colonne d’un jeu d’enregistrements dans la boîte de dialogue Données dynamiques. Les jeux d’enregistrements de cette colonne fournissent les valeurs affichées dans le champ de texte lorsque le formulaire est affiché dans un navigateur.

    Valider

    Spécifie le type de validation du champ actuel.

    Valider à

    Spécifie le moment de validation : onSubmit, onBlur ou onServer.

    Etiquette

    Permet d’indiquer un libellé pour le contrôle. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Schéma

    Permet d’indiquer un modèle d’expression régulière en JavaScript pour valider la saisie. Les barres obliques de début ou de fin sont ignorées. Pour plus d’informations, consultez la documentation ColdFusion.

    Hauteur

    Permet d’indiquer la hauteur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Largeur

    Permet d’indiquer la largeur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Taille

    Permet d’indiquer la taille du contrôle. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Obligatoire

    Permet de préciser si le champ masqué doit contenir des données pour que le formulaire soit transmis au serveur.

    Afficher l’éditeur de balises

    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

Insertion de zones de texte ColdFusion

Vous pouvez insérer visuellement dans votre formulaire une zone de texte ColdFusion, puis définir ses propriétés. Une zone de texte est un élément de saisie composé de plusieurs lignes de texte.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. Placez le point d’insertion dans la bordure du formulaire.
  2. Dans la catégorie Formulaire du panneau Insertion, cliquez sur l’icône Zone de texte CF.

    Une zone de texte apparaît dans le formulaire ColdFusion.

  3. Sélectionnez la zone de texte sur la page et définissez les options suivantes dans l’inspecteur Propriétés :

    Cftextarea

    (Zone de texte) Permet d’indiquer un nom unique pour le contrôle.

    Largeur car.

    Indique le nombre de caractères par ligne.

    Nbre lignes

    Permet d’indiquer le nombre de lignes à afficher dans la zone de texte.

    Wrap

    (Renvoi à la ligne) Permet d’indiquer comment le texte saisi par les utilisateurs doit être renvoyé à la ligne.

    Obligatoire

    Permet d’indiquer si la saisie de texte dans ce contrôle est obligatoire (case cochée) ou non (case non cochée).

    Valeur initiale

    Permet d’indiquer le texte à afficher dans la zone de texte lorsque la page s’ouvre dans un navigateur.

    Valider

    Spécifie le type de validation du champ actuel.

    Valider à

    Spécifie le moment de validation : onSubmit, onBlur ou onServer.

    Etiquette

    Permet d’indiquer un libellé pour le contrôle.

    Style

    Permet d’indiquer un style pour le contrôle. Pour plus d’informations, consultez la documentation ColdFusion.

    Hauteur

    Permet d’indiquer la hauteur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Largeur

    Permet d’indiquer la largeur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Afficher l’éditeur de balises

    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

  4. Pour attribuer une étiquette à la zone de texte, cliquez en regard de la zone et tapez le texte souhaité.

Insertion de boutons ColdFusion

Vous pouvez insérer visuellement dans votre formulaire un bouton ColdFusion, puis définir ses propriétés. Les boutons contrôlent les différentes opérations du formulaire ColdFusion. Les boutons permettent d’envoyer les données du formulaire au serveur ou de réinitialiser le formulaire. Il s’agit en général des boutons Envoyer et Réinitialiser. Vous pouvez également attribuer à un bouton d’autres tâches de traitement préalablement définies dans un script. Un bouton peut ainsi calculer le montant total des éléments sélectionnés en fonction des valeurs que vous leur avez attribuées.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. Placez le point d’insertion dans la bordure du formulaire ColdFusion.
  2. Dans la catégorie Formulaire du panneau Insertion, cliquez sur l’icône Bouton CF.

    Un bouton apparaît dans le formulaire ColdFusion.

  3. Sélectionnez le bouton sur la page et définissez les options suivantes dans l’inspecteur Propriétés :

    Cfbutton

    (Zone de texte) Permet d’indiquer un nom unique pour le contrôle.

    Action

    Permet d’indiquer le type de bouton à créer.

    Afficher l’éditeur de balises

    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

    A l’exécution, les autres propriétés sont ignorées par le serveur ColdFusion.

Insertion de cases à cocher ColdFusion

Vous pouvez insérer visuellement dans votre formulaire une case à cocher ColdFusion, puis définir ses propriétés. Utilisez des cases à cocher pour permettre aux utilisateurs d’activer plusieurs options dans un groupe.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. Placez le point d’insertion dans la bordure du formulaire.
  2. Dans la catégorie Formulaire du panneau Insertion, cliquez sur l’icône Case à cocher CF.

    Une case à cocher apparaît dans le formulaire ColdFusion.

  3. Sélectionnez la case à cocher sur la page et définissez les options suivantes dans l’inspecteur Propriétés :

    Cfcheckbox

    (Zone de texte) Permet d’indiquer un nom unique pour le contrôle.

    Valeur

    Permet d’indiquer la valeur renvoyée par la case à cocher si l’utilisateur l’active.

    Etat initial

    Permet d’indiquer si la case à cocher est déjà activée lorsque la page s’ouvre dans un navigateur.

    Valider

    Spécifie le type de validation de la case à cocher.

    Valider à

    Spécifie le moment de validation de la case à cocher : onSubmit, onBlur ou onServer.

    Etiquette

    Permet d’indiquer un libellé pour la case à cocher.

    Schéma

    Permet d’indiquer un modèle d’expression régulière en JavaScript pour valider la saisie. Les barres obliques de début ou de fin sont ignorées. Pour plus d’informations, consultez la documentation ColdFusion.

    Hauteur

    Permet d’indiquer la hauteur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Largeur

    Permet d’indiquer la largeur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Taille

    Permet d’indiquer la taille du contrôle. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Obligatoire

    Permet de préciser si la case à cocher doit être cochée pour que le formulaire soit transmis au serveur.

    Afficher l’éditeur de balises

    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

  4. Pour attribuer une étiquette à la case à cocher, cliquez en regard de la case sur la page et tapez l’étiquette souhaitée.

Insertion de boutons radio ColdFusion

Vous pouvez insérer visuellement dans votre formulaire un bouton radio ColdFusion, puis définir ses propriétés. Utilisez des boutons radio lorsque vous souhaitez que les utilisateurs ne sélectionnent qu’une seule option dans un groupe. Elles sont généralement utilisées en groupe. Tous les boutons radio d’un même groupe doivent porter le même nom.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. Placez le point d’insertion dans la bordure du formulaire.
  2. Choisissez Insertion > Objets ColdFusion > Formulaire > Bouton radio.

    Un bouton radio apparaît dans le formulaire ColdFusion.

  3. Sélectionnez le bouton radio sur la page et définissez les options suivantes dans l’inspecteur Propriétés :

    Cfradiobutton

    (Zone de texte) Permet d’indiquer un nom unique pour le contrôle.

    Valeur

    Permet d’indiquer la valeur renvoyée par le bouton radio si l’utilisateur l’active.

    Etat initial

    Permet d’indiquer si le bouton radio est déjà activé lorsque la page s’ouvre dans un navigateur.

    Valider

    Spécifie le type de validation du bouton radio.

    Valider à

    Spécifie le moment de validation : onSubmit, onBlur ou onServer.

    Etiquette

    Permet d’indiquer un libellé pour le bouton radio.

    Schéma

    Permet d’indiquer un modèle d’expression régulière en JavaScript pour valider la saisie. Les barres obliques de début ou de fin sont ignorées. Pour plus d’informations, consultez la documentation ColdFusion.

    Hauteur

    Permet d’indiquer la hauteur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Largeur

    Permet d’indiquer la largeur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Taille

    Permet d’indiquer la taille du contrôle. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Obligatoire

    Permet de préciser si le bouton radio doit être activé pour que le formulaire soit transmis au serveur.

    Afficher l’éditeur de balises

    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

  4. Pour attribuer une étiquette au bouton radio, cliquez en regard du bouton et tapez le texte souhaité.

Insertion de zones de liste ColdFusion

Vous pouvez insérer visuellement dans votre formulaire une zone de liste ColdFusion, puis définir ses propriétés. Une zone de liste permet à un visiteur de sélectionner un ou plusieurs éléments dans une liste. Les zones de liste sont utiles lorsque vous disposez d’un espace réduit et devez afficher de nombreux éléments. Elles s’avèrent également pratiques lorsque vous souhaitez contrôler les valeurs renvoyées au serveur. A la différence des champs de texte, dans lesquels les utilisateurs peuvent taper ce qu’ils veulent, y compris des données non valides, c’est à vous de définir les valeurs exactes renvoyées par un menu.

Il est possible d’insérer deux types de zones de liste dans un formulaire : un menu qui se « déroule » lorsque l’utilisateur clique dessus, ou un menu qui affiche une liste d’éléments que vous pouvez faire défiler et sélectionner.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. Placez le point d’insertion dans la bordure du formulaire.
  2. Dans la catégorie Formulaire du panneau Insertion, cliquez sur l’icône Sélection CF.

    Une zone de liste apparaît dans le formulaire ColdFusion.

  3. Sélectionnez la zone de liste sur la page et définissez les options suivantes dans l’inspecteur Propriétés :

    Cfselect

    (Zone de texte) Permet d’indiquer un nom unique pour le contrôle.

    Type

    Permet de choisir entre un menu déroulant ou une liste. Si vous choisissez le type Liste, les options Hauteur liste et Autoriser la sélection de plusieurs listes deviennent disponibles.

    Hauteur liste

    Permet d’indiquer le nombre de lignes à afficher dans la liste. Cette propriété n’est disponible qu’avec le type Liste.

    Autoriser la sélection de plusieurs listes

    Permet d’indiquer si l’utilisateur peut sélectionner plusieurs options à la fois dans la liste. Cette propriété n’est disponible qu’avec le type Liste.

    Modifier les valeurs

    Ouvre une boîte de dialogue qui permet d’ajouter, modifier ou supprimer des options à la zone de liste.

    Initialement sélectionné

    Définit les éléments sélectionnés par défaut dans la liste. Si vous avez activé l’option Autoriser la sélection de plusieurs listes, vous pouvez sélectionner plusieurs options.

    Jeu d’enregistrements

    Permet d’indiquer le nom de la requête ColdFusion à utiliser pour remplir la liste ou le menu.

    Afficher colonne

    Permet d’indiquer la colonne du jeu d’enregistrements qui doit fournir le libellé de chaque élément de la liste. Cette propriété est utilisée de concert avec la propriété Jeu d’enregistrements.

    Colonne valeurs

    Permet d’indiquer la colonne du jeu d’enregistrements qui doit fournir la valeur de chaque élément de la liste. Cette propriété est utilisée de concert avec la propriété Jeu d’enregistrements.

    Etiquette Flash

    Permet d’indiquer un libellé pour la zone de liste.

    Hauteur Flash

    Permet d’indiquer la hauteur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Largeur Flash

    Permet d’indiquer la largeur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Message

    Permet d’indiquer le message à afficher si la propriété Obligatoire est activée et si l’utilisateur n’a pas effectué de sélection avant de tenter d’envoyer le formulaire.

    Obligatoire

    Permet de préciser si un élément de menu doit être sélectionné pour que le formulaire soit transmis au serveur.

    Afficher l’éditeur de balises

    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

Insertion de champs d’image ColdFusion

Vous pouvez insérer visuellement dans votre formulaire un champ d’image ColdFusion, puis définir ses options. Les champs d’image permettent de créer des boutons personnalisés.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. En mode Création, placez le point d’insertion à l’intérieur de la bordure du formulaire.
  2. Dans la catégorie Formulaire du panneau Insertion, cliquez sur l’icône Champ d’image CF. Recherchez l’image à insérer, puis cliquez sur OK. Vous pouvez aussi entrer directement le chemin d’accès du fichier image dans la zone Src.
    Remarque :

    si le fichier d’image se trouve à l’extérieur du dossier racine du site, il est préférable de copier cette image dans le dossier racine. En effet, les images situées à l’extérieur du dossier racine risquent d’être inaccessible après publication du site.

  3. Sélectionnez le champ d’image sur la page et définissez les options suivantes dans l’inspecteur Propriétés :

    Cfimagefield

    (Zone de texte) Permet d’indiquer un nom unique pour le contrôle.

    Src

    Permet d’indiquer l’adresse URL de l’image à insérer.

    Alt

    Permet d’indiquer un message qui apparaîtra lorsque l’image ne peut pas être affichée.

    Alignement

    Permet d’indiquer l’alignement de l’image.

    Bordure

    Permet d’indiquer la largeur de la bordure de l’image.

    Modifier image

    Ouvre l’image dans votre logiciel de retouche d’images par défaut.

    Pour définir votre logiciel de retouche d’images par défaut, choisissez Édition > Préférences > Types de fichiers/Editeurs. Si ce logiciel n’est pas défini, le bouton Modifier l’image est sans effet.

    Valider

    Spécifie le type de validation du champ d’image.

    Valider à

    Spécifie le moment de validation : onSubmit, onBlur ou onServer.

    Etiquette

    Permet d’indiquer un libellé pour le bouton radio.

    Schéma

    Permet d’indiquer un modèle d’expression régulière en JavaScript pour valider la saisie. Les barres obliques de début ou de fin sont ignorées. Pour plus d’informations, consultez la documentation ColdFusion.

    Hauteur

    Permet d’indiquer la hauteur du contrôle, en pixels.

    Largeur

    Permet d’indiquer la largeur du contrôle, en pixels.

    Taille

    Permet d’indiquer la taille du contrôle. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Obligatoire

    Permet de préciser si le contrôle doit contenir des données pour que le formulaire soit transmis au serveur.

    Afficher l’éditeur de balises

    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

Insertion de champs de fichier ColdFusion

Vous pouvez insérer visuellement dans votre formulaire un champ de fichier ColdFusion, puis définir ses propriétés. Vous pouvez créer un champ de fichier pour permettre aux utilisateurs de sélectionner un fichier sur leur ordinateur (tel qu’un document de traitement de texte ou un fichier graphique) et de le transférer sur le serveur. Un champ de fichier ColdFusion est similaire à un champ de texte, mais contient également un bouton Parcourir. L’utilisateur peut soit saisir manuellement le chemin d’accès au fichier à transférer, soit cliquer sur le bouton Parcourir pour le rechercher et le sélectionner.

Les champs de fichier nécessitent l’utilisation de la méthode POST pour transmettre des fichiers depuis un navigateur vers le serveur. Le fichier est transféré à l’adresse indiquée dans la zone de texte Action du formulaire. Avant d’utiliser le champ de fichier, vérifiez auprès de votre administrateur de serveur que le transfert anonyme de fichiers est autorisé.

Les champs de fichier nécessitent aussi que le codage du formulaire soit défini comme « multipart/form ». Dreamweaver active automatiquement ce paramètre lorsque vous insérez un contrôle de champ de fichier.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. En mode Création, sélectionnez le formulaire ColdFusion pour l’afficher dans l’inspecteur Propriétés.

    Pour sélectionner rapidement le formulaire, cliquez n’importe où dans son cadre, puis cliquez sur la balise <cfform> dans le sélecteur de balises figurant dans le coin inférieur de la fenêtre de document.

  2. Dans l’inspecteur Propriétés, définissez la méthode du formulaire comme « POST ».
  3. Dans le menu déroulant Enctype, sélectionnez multipart/form-data.
  4. Placez le point d’insertion à l’intérieur de la bordure du formulaire, à l’endroit où le champ de fichier doit apparaître.
  5. Choisissez Insertion > Objets ColdFusion > Formulaire > Champ fichier.

    Un champ de fichier apparaît dans le document.

  6. Sélectionnez le champ de fichier sur la page et définissez les propriétés suivantes dans l’inspecteur Propriétés :

    Cffilefield

    (Zone de texte) Permet d’indiquer un nom unique pour le contrôle.

    Long. max.

    Indique le nombre maximum de caractères que peut contenir le chemin d’accès du fichier.

    Valider

    Spécifie le type de validation du champ actuel.

    Valider à

    Spécifie le moment de validation : onSubmit, onBlur ou onServer.

    Etiquette

    Permet d’indiquer un libellé pour le champ.

    Schéma

    Permet d’indiquer un modèle d’expression régulière en JavaScript pour valider la saisie. Les barres obliques de début ou de fin sont ignorées. Pour plus d’informations, consultez la documentation ColdFusion.

    Hauteur

    Permet d’indiquer la hauteur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Largeur

    Permet d’indiquer la largeur du contrôle, en pixels. A l’exécution, ce paramètre est ignoré par le serveur ColdFusion.

    Taille

    Permet d’indiquer la taille du contrôle.

    Obligatoire

    Permet de préciser si le champ de fichier doit contenir des données pour que le formulaire soit transmis au serveur.

    Afficher l’éditeur de balises

    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

Insertion de champs de date ColdFusion

Vous ne pouvez pas insérer visuellement dans votre formulaire un champ de date ColdFusion, mais vous pouvez définir visuellement ses propriétés. Un champ de date ColdFusion est un type spécial de champ de texte qui permet de sélectionner une date dans un mini-calendrier afin de l’insérer dans le champ de texte.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. En mode Création, sélectionnez le formulaire ColdFusion pour l’afficher dans l’inspecteur Propriétés.

    Pour sélectionner rapidement le formulaire, cliquez n’importe où dans son cadre, puis cliquez sur la balise <cfform> dans le sélecteur de balises figurant dans le coin inférieur de la fenêtre de document.

  2. Dans l’inspecteur Propriétés, définissez le format du formulaire comme « Flash ».

    Le contrôle de champ de date ne peut apparaître que dans des formulaires ColdFusion en mode Flash.

  3. Passez en mode d’affichage Code (Affichage > Code) et insérez la balise suivante en un point quelconque entre les balises CFForm d’ouverture et de fermeture :
    <cfinput name="datefield" type="datefield">
    <cfinput name="datefield" type="datefield">
    <cfinput name="datefield" type="datefield">
  4. Passez en mode Création, sélectionnez le champ de date sur la page, puis définissez les options suivantes dans l’inspecteur Propriétés :

    Cfdatefield

    (Zone de texte) Permet d’indiquer un nom unique pour le contrôle.

    Valeur

    Permet d’indiquer la date à afficher dans ce champ lorsque la page s’ouvre dans un navigateur. Cette date peut être statique ou dynamique.

    Pour indiquer une valeur dynamique, cliquez sur l’icône en forme d’éclair à côté de la zone Valeur, et sélectionnez la colonne d’un jeu d’enregistrements dans la boîte de dialogue Données dynamiques. Les jeux d’enregistrements de cette colonne fournissent les valeurs affichées dans le champ de date lorsque le formulaire est affiché dans un navigateur.

    Valider

    Spécifie le type de validation du champ actuel.

    Valider à

    Spécifie le moment de validation : onSubmit, onBlur ou onServer.

    Etiquette

    Permet d’indiquer un libellé pour le champ.

    Schéma

    Permet d’indiquer un modèle d’expression régulière en JavaScript pour valider la saisie. Les barres obliques de début ou de fin sont ignorées. Pour plus d’informations, consultez la documentation ColdFusion.

    Hauteur

    Permet d’indiquer la hauteur du contrôle, en pixels.

    Largeur

    Permet d’indiquer la largeur du contrôle, en pixels.

    Taille

    Permet d’indiquer la taille du contrôle.

    Obligatoire

    Permet de préciser si le champ de date doit contenir des données pour que le formulaire soit transmis au serveur.

    Afficher l’éditeur de balises

    Permet de modifier les propriétés qui n’apparaissent pas dans l’inspecteur Propriétés.

Modification de contrôles de formulaire ColdFusion

Vous pouvez modifier visuellement les propriétés des contrôles de formulaires ColdFusion, que vous travailliez en mode Création ou Code.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. En mode Création, sélectionnez le contrôle de formulaire ; en mode Code, cliquez dans la balise du contrôle concerné.

    L’inspecteur Propriétés affiche les propriétés du contrôle de formulaire.

  2. Modifiez ces propriétés dans l’inspecteur Propriétés.

    Pour plus d’informations, cliquez sur l’icône Aide de l’inspecteur Propriétés.

  3. Pour définir d’autres propriétés, cliquez sur le bouton Afficher l’éditeur de balises dans l’inspecteur Propriétés, et définissez les propriétés dans l’éditeur de balises qui s’affiche.

Validation des données de formulaire ColdFusion

Dreamweaver permet de créer des formulaires ColdFusion permettant de vérifier dans le contenu des champs de texte spécifiés que l’utilisateur a bien saisi le type de données approprié.

Remarque :

cette amélioration n’est disponible que si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

  1. Créez un formulaire ColdFusion comprenant au moins un champ de saisie et un bouton Envoyer. Assurez-vous que chaque champ ColdFusion que vous souhaitez valider porte un nom unique.
  2. Dans le formulaire, sélectionnez le champ à valider.
  3. Dans l’inspecteur Propriétés, indiquez comment le champ doit être validé.

    La partie inférieure de chaque inspecteur Propriétés contient des contrôles qui permettent de définir une règle de validation spécifique. Par exemple, vous pouvez spécifier qu’un champ de texte donné doit contenir un numéro de téléphone. Pour ce faire, choisissez Téléphone dans le menu déroulant Valeur de l’inspecteur Propriétés. Vous pouvez aussi indiquer le moment de la validation dans le menu local Valider à.

Recevez de l’aide plus rapidement et plus facilement

Nouvel utilisateur ?