Image

Affiche une image et fait en sorte qu'il soit possible de cliquer dessus, si nécessaire.

Liaison de données

Vous pouvez définir ou modifier les liaisons de données pour la vue dans l'onglet de propriétés Général. La vue Image peut être liée à une variable String qui contient l'emplacement de l'image devant être affichée par la vue. Généralement, vous liez la vue à une image stockée en tant que fichier web et l'URL est un chemin d'accès relatif permettant d'extraire le fichier du serveur. Lorsque vous liez la vue à une variable, la variable doit contenir une URL pouvant être résolue sur le serveur.

Astuce: Les URL absolues sont acceptables, mais les URL relatives sont généralement un meilleur choix afin d'éviter d'éventuels avertissements de sécurité.

Vous pouvez utiliser la liaison pour spécifier l'image. Si aucune liaison n'est spécifiée, la propriété de configuration URL de l'image par défaut est utilisée. Pour définir une image différente pour différentes tailles d'écran, vous devez utiliser la propriété de configuration URL de l'image par défaut.

Propriétés de configuration

Sous Configuration, définissez ou modifiez les propriétés d'apparence et de comportement de la vue.

Taille de l'écran: Une propriété de configuration comportant l'icône Tailles d'écran en regard du nom de la propriété peut avoir des valeurs différentes pour chaque taille d'écran. Si vous ne définissez pas de valeur, la taille de l'écran hérite de la valeur de taille d'écran supérieure suivante comme valeur par défaut.

Définitions de thème: Les définitions de thème spécifient les couleurs et les styles d'une vue et déterminent son apparence. Vous pouvez prévisualiser l'apparence des vues dans l'éditeur de thème. Voir Thèmes.

Les propriétés de configuration de l'apparence de la vue Image sont répertoriées dans le tableau ci-dessous :

Tableau 1. Propriétés de configuration de l'apparence du contrôle Image
Propriété de configuration de l'apparence	Description	Type de données
Rayon de la bordure	Spécifie le rayon de courbure d'une image. Vous pouvez rendre une image parfaitement ronde en lui affectant au moins la moitié de la largeur spécifiée pour la propriété Largeur. Par défaut, aucun rayon de bordure n'est spécifié.	`String`
Largeur	Spécifie la largeur d'une image en pixels, en pourcentage ou en unités em. Par exemple: `50px` ou `20%` ou `0.4em`. Si un nombre est indiqué sans unité, ce nombre est interprété comme le nombre de pixels. Par défaut, aucune largeur n'est spécifiée.	`String`
Hauteur	Spécifie la hauteur d'une image en pixels ou en unités em. Par exemple : `50px` ou `0.4em`. Si un nombre est indiqué sans unité, ce nombre est interprété comme le nombre de pixels. Par défaut, aucune hauteur n'est spécifiée.

Les propriétés de configuration du comportement de la vue Image sont répertoriées dans le tableau ci-dessous :

Tableau 2. Propriétés de configuration du comportement du contrôle Image
Propriété de configuration du comportement	Description	Type de données
Empêcher les clics multiples	Empêche un utilisateur de cliquer sur une image plusieurs fois lorsque l'événement de clic est programmé. Par défaut, cette propriété n'est pas sélectionnée.	`Boolean`
Type d'URL de l'image	Type d'URL de l'image. Toile d'araignée mondiale Externe Remarque : utilisez Externe pour les images qui ne sont pas hébergées sur le serveur local.
Acronyme de l'application de l'image	Acronyme de l'application de processus ou du kit d'outils contenant l'image. Par défaut, l'acronyme de l'application de processus en cours est utilisé.
URL de l'image par défaut	Si la vue n'est pas liée, cette URL est utilisée. Pour définir une image différente pour différentes tailles de d'écran, vous devez utiliser cette propriété. Pour utiliser une image, vous devez la télécharger dans le concepteur. Voir Ajout de fichiers gérés
Type d'URL de l'image par défaut	Si la vue n'est pas liée, ce type d'URL est utilisé. Toile d'araignée mondiale Externe Remarque : utilisez Externe pour les images qui ne sont pas hébergées sur le serveur local.
Acronyme de l'application d'image par défaut	Acronyme par défaut de l'application de processus ou du kit d'outils contenant l'image. Par défaut, l'acronyme de l'application de processus en cours est utilisé. Si la vue n'est pas liée à des données, l'acronyme spécifié ici est utilisé.

Exemple

Téléchargez l'image que vous souhaitez utiliser dans le concepteur. Voir Ajout de fichiers gérés.

Dans cet exemple, la vue Image se trouve dans une vue Disposition verticale, qui se trouve dans une vue Puits. L'exemple utilise les options de configuration suivantes :

Image URL type est Web.
L' URL de l'image par défaut est magnolia.gif.
Le Type d'adresse URL de l'image par défaut est défini sur Web.
Position du libellé est Bottom.
Rayon de la bordure est 50px.
Largeur correspond à 300px.

Lors de l'exécution, vous pouvez voir ce qui suit :

Evénements

Vous pouvez définir ou modifier des gestionnaires d'événements pour la vue dans l'onglet Evénements. Vous pouvez définir des événements à déclencher par programmation ou lorsqu'un utilisateur interagit avec la vue. Pour plus d'informations sur la manière de définir et de coder des événements, voir Evénements définis par l'utilisateur.

La vue Image comporte les types de gestionnaires d'événements suivants :

: Activé lors du chargement de la page. Par exemple :
: activé lorsqu'une image est cliquée, avant de quitter la page. Si l'expression évaluée renvoie false, le clic ne déclenche pas d'événement limite. Par exemple :

Méthodes

Pour plus d'informations sur les méthodes disponibles pour le contrôle Image, voir Image JavaScript API.

Ressources supplémentaires

Pour plus d'informations sur la création d'un coach ou d'une page, voir Génération de coaches.
Pour plus d'informations sur les propriétés standard (Général, Configuration, Positionnement, Visibilitéet Attributs HTML), voir Afficher les propriétés.