Variables

Une variable est un mécanisme qui vous permet de stocker, de modifier et de réutiliser une valeur définie par l'utilisateur ou pour l'application (un nombre, un texte etc..). Cette valeur affecte l'interface utilisateur d'une manière ou d'une autre à un moment donné. 

Voici quelques cas d'usages : stocker et afficher le score de l'utilisateur, savoir si l'utilisateur a déjà ouvert ou non l'application, stocker un code couleur, sauvegarder une sélection de l'utilisateur... 

Les variables permettent d'ajouter plus de personnalisation dans votre application et de mettre en place des scénarios logiques avec les conditions.

Qu'est-ce qu'une variable ?

Une variable associe un nom à une valeur qui peut évoluer.

Choisissez le nom de la variable : celui-ci doit être unique, composé de caractères alphanumériques et il doit permettre de comprendre son usage de manière explicite. Par exemple :  score pour stocker le score de l'utilisateur ou selected_item pour sauvegarder l'identifiant d'un élément sélectionné par l'utilisateur.

Une fois que votre variable est créée, vous pouvez lui associer une valeur par défaut, modifier sa valeur depuis n'importe quel déclencheur et l'afficher dans l'interface.

Lorsque vous créez une variable via la base de données PandaSuite, cette variable est locale : elle est stockée seulement sur l'appareil de l'utilisateur. Celle-ci est persistante même après la fermeture de l'application. Par contre il n'est pas possible d'y accéder si l'utilisateur utilise un autre appareil ou de connaître sa valeur en dehors de l'application

Créer une variable

Pour créer une variable, ajoutez une base de données PandaSuite. Cliquez sur le bouton  Ajouter une propriété. 

Choisissez le nom de votre variable et son type :  Booléen, Nombre, Texte, Tableau... Vous pouvez choisir une valeur par défaut. 

Modifier la valeur d'une variable

Vous pouvez modifier la valeur d'une variable à tout moment et depuis n'importe quelle action de votre interface utilisateur : à l'affichage d'un écran, au clic sur un bouton etc... 

Sélectionnez votre déclencheur et l'action  Agir sur une base de données. Sélectionnez votre base de données PandaSuite et l'action Modifier la donnée. 

Choisissez parmi les fonctions possibles :  Définir, Incrémenter, Décrémenter, Ajouter, Supprimer.

Dans l'exemple ci-dessous, l'identifiant de l'élément courant est ajouté au sein de la variable saved_items (pour la mise en favoris).

Afficher la valeur d'une variable

Grâce au data binding, vous pouvez afficher la valeur de votre variable. Prenons l'exemple d'un score affiché 

Insérez un bloc de texte et cliquez sur  Source. 

Choisissez Depuis une base de données et sélectionnez votre variable.