DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Image
  • Présentation
  • Champ d'une page
  • Utiliser une image à défilement automatique dans un site WEBDEV
  • Programmation d'une image à défilement automatique
  • Présentation
  • Définition des images à afficher lors du défilement
  • Fonctions WLangage
  • Propriétés WLangage
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation

Champ d'une page

Le champ Image à défilement automatique permet de visualiser un ensemble d'images présent dans un ou plusieurs répertoires du site. Le parcours des images est effectué automatiquement.
Le changement d'images peut être automatique ou manuel (grâce aux fonctions WLangage).
Des effets de transition peuvent être appliqués.
Il est ainsi possible de créer simplement des bannières publicitaires ou des diaporama.
Le défilement automatique est proposé sur les champs suivants :
  • Champ Image.
  • Champ Image cliquable.
  • Champ Vignette.
Remarque : Si les différentes images utilisées par le défilement automatique ont des tailles différentes, le mode d'affichage précisé dans l'onglet "Général" du champ est automatiquement appliqué.
Utiliser une image à défilement automatique dans un site WEBDEV
Pour utiliser une image à défilement automatique dans un site WEBDEV :
  1. Créez un champ Image.
  2. Affichez la fenêtre de description du champ (option "Description" du menu contextuel du champ Image).
  3. Dans l'onglet "UI", dans la zone "Défilement automatique", cochez l'option "Faire défiler les images d'un répertoire ou d'une liste programmée" puis indiquez les différentes options concernant le défilement :
    • Durée entre chaque image : indique le délais d'affichage de l'image.
    • Démarrer automatiquement. Si cette option n'est pas sélectionnée, il est possible de démarrer le défilement grâce à la fonction ImageLanceDéfilement.
    • Parcourir le répertoire de l'image (Onglet Général) : Cette option permet de parcourir toutes les images présentes dans le répertoire actuellement sélectionné pour le champ Image (ou le répertoire de l'image actuellement associée au champ Image). Dans ce cas, le parcours n'est pas récursif : les images des sous-répertoires ne sont pas parcourues.
    • Trier le contenu du défilement : Cette option permet d'afficher les images parcourues selon leur nom. Sélectionnez si nécessaire le répertoire de parcours des images (champ "Image").
  4. Validez la fenêtre de description du champ.
Si vous avez choisi un démarrage automatique du défilement et un répertoire des images, le défilement est automatiquement réalisé lors du test de la page.
Remarque : Il est possible de combiner les effets de transition avec le défilement.
Programmation d'une image à défilement automatique

Présentation

Les champs proposant un défilement automatique peuvent être manipulés par programmation grâce à différentes fonctions et propriétés WLangage. Ces fonctions et propriétés sont disponibles également en code navigateur et en PHP.

Définition des images à afficher lors du défilement

Les images affichées dans le champ lors du défilement peuvent être :
  • présentes dans le répertoire sélectionné dans la fenêtre de description du champ.
  • associées au champ par programmation. Exemples :
    • Une liste d'images est associée au champ :
      // Affectation en code serveur
      IMG_Image = "chiffres_0.png" + RC + "chiffres_1.png" + RC + ...
      "chiffres_2.png" + RC + "chiffres_3.png"
    • Un répertoire contenant des images est associé au champ :
      IMG_Image = "images"
      Ce code permet d'associer un ensemble d'images ou un répertoire au champ. Le chemin est relatif au répertoire des images du site (répertoire _WEB).

Fonctions WLangage

Différentes fonctions du WLangage permettent de gérer les images à défilement automatique. Ces fonctions sont les suivantes :
ImageArrêteDéfilementArrête le défilement automatique des images.
ImageDernierAffiche la dernière image du défilement.
ImageLanceDéfilementLance le défilement automatique des images.
ImageOccurrenceRenvoie le nombre total d'images prises en compte par le défilement.
ImagePositionDéfilementRetourne l'image affichée.
ImagePrécédentAffiche l'image précédente du défilement.
ImagePremierAffiche la première image du défilement.
ImageSuivantAffiche l'image suivante du défilement.
Exemple de programmation du défilement :
// Programmation des images du bandeau défilant.
// Possibilité de donner le répertoire des images de son choix
// Au premier affichage, choix aléatoire de la 1er photo.
// =================
// Déclaration de globales
gnNombreImagesDefilement est un entier
gnImageDemarrage est un entier
gsNomImageDefilement est une chaîne
 
// Initialisation de la page
<BLOC Gestion du Bandeau défilant>
gsNomImageDefilement = fListeFichier(fRepWeb() + fSep + "BandeauxAccueil" +
fSep + "*.jpg", frNonRécursif)
POUR TOUTE CHAÎNE sUnFichier DE gsNomImageDefilement SÉPARÉE PAR RC
gnNombreImagesDefilement++
FIN
InitHasard()
gnImageDemarrage = Hasard(1, gnNombreImagesDefilement)
 
NumImageDepartDefilement est un entier = gnImageDemarrage
 
POUR I = 1 À NumImageDepartDefilement
ImageSuivant(IMG_Presentation)
FIN
ImageLanceDéfilement(IMG_Presentation)
<FIN>

Propriétés WLangage

Différentes propriétés du WLangage permettent de gérer les images à défilement automatique. Ces propriétés sont les suivantes :
OptionTriPermet de définir le mode de tri des images lors du défilement.
TriéePermet de savoir si le champ trie les images lors du défilement et permet de trier les images lors du défilement.
ValeurRenvoie le chemin du répertoire des images.
ValeurAffichéeRenvoie le chemin de l'image actuellement affichée.
Liste des exemples associés :
Le champ Image (animations et transitions) Exemples unitaires (WEBDEV) : Le champ Image (animations et transitions)
[ + ] Présentation de fonctionnalités d'animations et d'effets proposés en standard dans WEBDEV et le WLangage sur le champ Image.
Version minimum requise
  • Version 16
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 12/05/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale