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 Zone Répétée
  • Présentation du champ Zone répétée
  • Création d'un champ Zone répétée
  • Création d'un champ Zone répétée horizontal
  • Attributs d'un champ Zone répétée
  • Attributs d'un champ Zone répétée en WEBDEV
  • Attributs d'un champ Zone répétée en WINDEV ou WINDEV Mobile
  • Vocabulaire
  • Notes
  • Permuter un champ Table et un champ Zone répétée
  • Refactoring : créer un champ Zone répétée à partir des champs sélectionnés
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Présentation du champ Zone répétée
Un champ Zone répétée permet de répéter des champs présents dans une zone définie. Plus précisément, un champ Zone répétée est un champ "conteneur" qui permet de répéter plusieurs fois l'ensemble de champs (champs de saisie, libellés, combos, etc.) qu'il contient.
Le champ Zone répétée permet de simplifier l'affichage et la saisie d'informations.
Par rapport au champ Table, le champ Zone répétée permet d'obtenir des interfaces beaucoup plus riches, tous les types de champs pouvant être répétés.
Les informations affichées dans le champ Zone répétée peuvent :
  • être déterminées par programmation : on parle alors de champ Zone répétée par programmation.
  • provenir d'un fichier de données ou d'une requête : on parle alors de champ Zone répétée fichier.
  • provenir d'une variable WLangage : on parle alors de champ Zone répétée sur variable.
Remarques :
  • Selon les plateformes, les champs Zone répétée peuvent être affichés :
  • AndroidiPhone/iPad La fonctionnalité "Tirer pour rafraîchir" (Pull to Refresh) est disponible sur le champ Zone répétée sous Android et iOS. Pour plus de détails, consultez Pull to Refresh sur les champs Table et Zone répétée (Android/iOS).
  • AndroidiPhone/iPad Les téléphones ou tablettes disposent souvent d'une touche "Suivant" permettant de passer à la saisie d'un élément suivant. Dans le cas d'un champ de saisie dans un champ Zone répétée, il n'est pas possible d'utiliser cette touche pour passer à la modification de la répétition suivante, ou pour permettre la saisie en cascade. Il est nécessaire de créer une interface spécifique permettant de réaliser ce type de saisie.
Création d'un champ Zone répétée
Pour créer un champ de type Zone répétée :
  1. Sous le volet "Création", dans le groupe "Données" :
    • WINDEVWINDEV Mobile déroulez "Zone répétée" et sélectionnez "Zone répétée (verticale)".
      WINDEVWindowsAndroidiPhone/iPad Remarque : Il est possible de créer une zone répétée horizontale grâce à l'option "Zone répétée horizontale".
    • WEBDEV - Code Serveur déroulez "Zone répétée" et sélectionnez "Zone répétée".
      Remarque : Il est possible de créer une zone répétée de type Galerie grâce aux options "Galerie en ligne" et "Galerie en colonne".
  2. Cliquez dans la fenêtre ou dans la page à la position où le champ doit être créé. L'assistant de création d'un champ Zone répétée se lance automatiquement.
Remarques :
  • WINDEV Les dimensions du champ créé sont optimisées pour occuper l'espace disponible à la position indiquée. Si la taille du champ ne vous convient pas, utilisez la combinaison de touches Ctrl + Z : le champ retrouvera sa taille par défaut.
  • iPhone/iPad L'assistant de création de fenêtres pour iPhone et iPad permet également de créer des zones répétées prédéfinies. Pour plus de détails, consultez Fenêtres pour iPhone et iPad.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
Pour plus de détails :
WINDEVWindowsAndroidiPhone/iPad

Création d'un champ Zone répétée horizontal

Il est également possible de créer des champs Zone répétée horizontale. Dans ce cas, le champ possédera un ascenseur horizontal pour faire défiler les différentes répétitions.
Pour créer un champ de type Zone répétée horizontale :
  1. Sous le volet "Création", dans le groupe "Données", déroulez "Zone répétée" et sélectionnez "Zone répétée horizontale".
  2. Cliquez dans la fenêtre ou dans la page à la position où le champ doit être créé. L'assistant de création d'un champ Zone répétée se lance automatiquement.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
Attributs d'un champ Zone répétée
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP

Attributs d'un champ Zone répétée en WEBDEV

Un champ Zone répétée est composé de :
  • champs, répétés à chaque répétition.
  • attributs. Un attribut permet de définir la caractéristique du champ qui sera modifiée à chaque répétition. Par exemple, si à chaque répétition, le champ PRIX doit changer de valeur et de couleur, il sera nécessaire de définir deux attributs différents sur le même champ.
Pour connaître ou modifier la caractéristique d'un champ (sa valeur, sa couleur, etc.), il suffit de manipuler ce champ ou l'attribut correspondant par programmation.
WINDEVAndroidiPhone/iPadJava

Attributs d'un champ Zone répétée en WINDEV ou WINDEV Mobile

Un champ Zone répétée est composée de champs, répétés à chaque répétition.
WINDEVWindows Le contenu des champs Table ou Graphe par exemple peut être différent à chaque répétition. Pour plus de détails, consultez Afficher un contenu différent à chaque répétition.
Pour connaître ou modifier la caractéristique d'un champ (sa valeur, sa couleur, etc.), il suffit de manipuler directement ce champ par programmation.
Remarque : Par compatibilité avec WEBDEV, il est également possible d'utiliser des attributs. Dans ce cas, pour connaître ou modifier la caractéristique d'un champ (sa valeur, sa couleur, etc.), il suffit de manipuler ce champ ou l'attribut correspondant par programmation.
Vocabulaire
Pour manipuler simplement un champ Zone répétée, il est nécessaire de connaître le vocabulaire suivant :
NomDéfinition
AttributUn attribut correspond à l'association entre le champ présent dans la zone répétée et la propriété modifiable pour ce champ à chaque répétition.
Pour chaque attribut, il est nécessaire de définir :
  • le nom de l'attribut.
  • le nom du champ de la zone répétée.
  • la propriété du champ qui pourra être modifiée à chaque répétition (valeur, couleur, etc.).
WINDEVWINDEV Mobile Rappel : Les attributs ne sont pas obligatoires.
Zone répétée FichierLe champ Zone répétée est basé sur un fichier de données ou une requête. A chaque répétition, un enregistrement du fichier de données est affiché. Deux types de champs Zone répétée fichier sont disponibles :
  • Zone répétée fichier "Chargé en mémoire" : Le contenu du champ est chargé en mémoire puis affiché. L'accès aux différents éléments du champ est plus rapide. Ce mode est réservé pour des fichiers de données de moins de 100 000 enregistrements.
  • Zone répétée fichier "Accès direct (sans limite)" : Le champ Zone répétée affiche directement le contenu du fichier de données ou de la requête. L'enregistrement en cours correspond à l'élément sélectionné. Chaque déplacement dans le champ entraîne un accès au fichier de données lié. Ce mode est réservé aux fichiers de données de plus de 100 000 enregistrements.
Zone répétée par programmationLe champ Zone répétée n'est basé ni sur un fichier de données ni sur une requête. Les éléments affichés dans le champ sont déterminés par le développeur (par programmation).
Zone répétée sur variableLe champ Zone répétée est basé sur une variable (globale au projet, à la fenêtre ou à la page, membre de classe, etc.).
Notes

Permuter un champ Table et un champ Zone répétée

WINDEV, WINDEV Mobile et WEBDEV permettent de transformer automatiquement un champ Table en un champ Zone répétée :
  1. Sélectionnez le champ Table à transformer.
  2. Sous le volet "Modification", dans le groupe "Transformations", déroulez "Refactoring et permutations" et sélectionnez l'option "Table vers Zone Répétée".

Refactoring : créer un champ Zone répétée à partir des champs sélectionnés

WINDEV, WINDEV Mobile et WEBDEV permettent de créer automatiquement un champ Zone répétée à partir des champs actuellement sélectionnés :
  1. Sélectionnez les champs voulus.
  2. Sous le volet "Modification", dans le groupe "Transformations", déroulez "Refactoring et permutations" et sélectionnez l'option "Créer une zone répétée avec la sélection".
Liste des exemples associés :
Le champ Zone répétée (afficher les bornes) Exemples unitaires (WEBDEV) : Le champ Zone répétée (afficher les bornes)
[ + ] Affichage des bornes d'une zone répétée avec réglette personnalisée.
Affichage / dissimulation d'une zone de saisie Exemples unitaires (WEBDEV) : Affichage / dissimulation d'une zone de saisie
[ + ] Affichage d'une zone de saisie à l'aide d'une zone répétée.
L'ajout d'une zone de saisie se fait par l'ajout d'une ligne dans la zone répétée.
Le champ Zone répétée (bandeau de sélection) Exemples unitaires (WEBDEV) : Le champ Zone répétée (bandeau de sélection)
[ + ] Simulation d'un bandeau de sélection dans une zone répétée.
Le champ Zone Répétée (modifier le nombre de lignes affichées) Exemples unitaires (WEBDEV) : Le champ Zone Répétée (modifier le nombre de lignes affichées)
[ + ] Modification du nombre de lignes affichées dans une zone Répétée.
Le champ Zone Répétée Ajax Exemples unitaires (WEBDEV) : Le champ Zone Répétée Ajax
[ + ] Utilisation des zones répétées Ajax. Cet exemple permet de :
- Vider la zone répétée
- Remplir la zone répétée
- Trier la zone répétée
Le champ Zone Répétée Ajax en PHP Exemples unitaires (WEBDEV) : Le champ Zone Répétée Ajax en PHP
[ + ] Utilisation des zones répétées Ajax en PHP.
Cet exemple permet de :
- Vider la zone répétée
- Remplir la zone répétée
- Trier la zone répétée
Le champ Zone répétée Exemples unitaires (WINDEV) : Le champ Zone répétée
[ + ] Utilisation du champ Zone répétée.
Il est possible d'ajouter une ligne grâce à la fonction ZoneRépétéeAjouteLigne.
Il est également possible de récupérer les valeurs saisies grâce à la syntaxe :
  NomAttribut[Indice]
webmillion Exemples complets (WEBDEV) : webmillion
[ + ] Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ Utilisation des requêtes
2/ Utilisation des zones répétées "fichier" en parcours automatique
3/ Utilisation des zones répétées "fichier" en parcours manuel

Résumé de l'exemple livré avec WEBDEV :
Cette application Web réalisée avec WEBDEV permet de visualiser, de rechercher et de commander des TShirt.
Une fois la commande établie, il est possible d'utiliser le module PayBox de paiement sécurisé.

Cet exemple contient une page permettant de générer un fichier de données contenant un grand nombre d'enregistrements.
WM Gestion Contacts Exemples multiplateforme (WINDEV Mobile) : WM Gestion Contacts
[ + ] Cet exemple illustre la gestion de contacts pour Android et iOS.
Il permet de :
- lister les contacts du téléphone
- appeler les contacts
- envoyer des sms aux contacts
- ...
WM ToDo List Exemples multiplateforme (WINDEV Mobile) : WM ToDo List
[ + ] Cet exemple est un gestionnaire de listes des choses à faire, ou plus communément appelé un gestionnaire de To-Do Lists.
Le projet utilise les gestures dans les zones répétées afin de déplacer et supprimer les listes et les tâches.
Les données sont, quant à elles, stockées dans une base HFSQL.
WM Inscrits Exemples multiplateforme (WINDEV Mobile) : WM Inscrits
[ + ] Cette application est un gestionnaire de présence. Elle permet de noter les personnes présentes lors d'un séminaire.
La base de données est préalablement renseignée avec la liste des personnes inscrites.
Il est possible de rechercher une personne par son nom.
Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ l'utilisation d'une zone répétée fichier basée sur une requête
2/ l'utilisation d'une base de données au format HFSQL.
Galerie_Photos Exemples complets (WEBDEV) : Galerie_Photos
[ + ] Cet exemple est un site de galerie photos et se compose de 2 parties principales :
- la partie "visiteur", réalisée en mode AWP et référençable.
- la partie administration réalisée en mode WEBDEV classique et sécurisée.  
 
Parmi les fonctionnalités proposées, vous y trouverez :
- une organisation par albums de vos photos
- un lien vers les réseaux sociaux
- la possibilité pour les visiteurs de commenter vos publications
- la connexion des utilisateurs est gérée via le GPU de WEBDEV
- un formulaire de contact
- au niveau de l’administration du site, vous pourrez bien évidemment uploader vos photos, les classer par album et aussi les décrire
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Windev Mobile 24
Attribut HauteurLigne : attention à la manipulation par programme de cet attribut : un coefficient semble s'appliquer entre la valeur saisie dans l'IHM (onglet détail) et la valeur utilisé sous Android. (dans mon cas, 92 saisie dans l'interface, info(ZC_HISTO..HauteurLigne) retournant 92 dans le simulateur et 122 sur la tablette !)
Patrick MOIRE
27 déc. 2019

Dernière modification : 13/09/2024

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