Indicateurs de progression et d’activité dans Xamarin.iOS

Il est probable que votre application devra effectuer des tâches longues telles que le chargement ou le traitement des données et que ce délai peut entraîner un retard dans la mise à jour de votre interface utilisateur. Pendant ce temps, vous devez toujours utiliser un indicateur de progression pour rassurer l’utilisateur que le système est occupé à faire du travail. Cela permet à l’utilisateur de contrôler que l’application travaille sur sa requête, qu’elle n’attend pas son entrée et qu’elle peut fournir un moyen de détailler exactement la durée pendant laquelle elle doit attendre.

iOS fournit deux méthodes principales pour fournir cette indication de progression dans votre application : indicateurs d’activité (y compris un indicateur d’activité réseau spécifique) et barres de progression.

Indicateur d’activité

Les indicateurs d’activité doivent être affichés lorsque votre application exécute un processus long, mais vous ne connaissez pas la durée exacte nécessaire à la tâche.

Apple propose les suggestions suivantes pour utiliser les indicateurs d’activité :

• Dans la mesure du possible, utilisez les barres de progression à la place : étant donné qu’un indicateur d’activité ne donne aucun commentaire à l’utilisateur quant à la durée d’exécution du processus, utilisez toujours une barre de progression si la longueur est comprise (par exemple, le nombre d’octets à télécharger dans un fichier).
• Conserver l’indicateur animé : les utilisateurs associent un indicateur d’activité stationnaire à une application bloquée afin que vous ayez toujours l’indicateur animé pendant qu’il est affiché.
• Décrire la tâche en cours de traitement : l’affichage de l’indicateur d’activité par lui-même n’est pas suffisant, l’utilisateur doit être informé du processus sur lequel il attend. Incluez une étiquette explicite (généralement une phrase simple et complète) qui définit clairement la tâche.

Implémentation d’un indicateur d’activité

Un indicateur d’activité est implémenté par le biais de la UIActivityIndictorView classe pour indiquer qu’un UIActivity est en cours.

Gestion du comportement de l’indicateur d’activité

Utilisez les méthodes et StopAnimating() les StartAnimating() méthodes pour démarrer et arrêter l’animation de l’indicateur d’activité.

Définissez la propriété pour true que l’indicateur HidesWhenStopped d’activité disparaisse après StopAnimating() avoir été appelé. Cette valeur est définie true par défaut. À tout moment, vous pouvez voir si l’indicateur d’activité exécute son animation de rotation en case activée la IsAnimating propriété.

Gestion des apparences des indicateurs d’activité

L’énumération UIActivityIndicatorViewStyle peut être passée en tant que paramètre lors de l’instanciation de l’indicateur d’activité. Vous pouvez l’utiliser pour définir le style Grayvisuel sur , Whiteou WhiteLarge, par exemple :

activitySpinner = new UIActivityIndicatorView(UIActivityIndicatorViewStyle.WhiteLarge);

Vous pouvez remplacer la couleur fournie en UIActivityIndicatorViewStyle définissant la Color propriété.

Barre de progression

Une barre de progression présente une ligne qui remplit de couleur pour indiquer l’état et la durée d’une tâche fastidieuse. Les barres de progression doivent toujours être utilisées lorsque la longueur des tâches est connu ou peut être calculée.

Apple propose les suggestions suivantes pour utiliser les barres de progression :

• Progression du rapport précis : les barres de progression doivent toujours être une représentation précise du temps nécessaire à l’exécution d’une tâche. Ne faussez jamais le temps de rendre l’application occupée.
• Utilisation pour des durées bien définies : la barre de progression ne doit pas seulement montrer qu’une tâche longue a lieu, mais donner à l’utilisateur et l’indication de la quantité de la tâche terminée et une estimation du temps restant.

Implémentation d’une barre de progression

Une barre de progression est créée en instanciant un UIProgressView

Barres de progression et planches de montage séquentiel

Vous pouvez également ajouter une barre de progression à votre interface utilisateur lors de l’utilisation du Concepteur iOS. Recherchez le mode Progression dans la boîte à outils et faites-le glisser vers votre affichage.

Les propriétés suivantes peuvent être ajustées sur le panneau des propriétés :

Gestion du comportement de la barre de progression

La progression de la barre peut être initialement définie à l’aide de la Progress propriété :

ProgressBar.Progress = 0f;

La progression peut être ajustée à l’aide de la SetProgress méthode et en passant une déclaration booléenne si vous souhaitez que la modification soit animée ou non.

ProgressBar.SetProgress(1.0f, true);

Pour plus d’informations sur l’utilisation de la barre de progression, reportez-vous à la recette De progression des rapports.

Gestion de l’apparence de la barre de progression

Comme pour un indicateur d’activité, l’énumération UIProgressViewStyle peut être passée en tant que paramètre lors de l’instanciation de la barre de progression.

La couleur de progression et de suivi de l’image et de la teinte peut être ajustée à l’aide des propriétés suivantes :

progressBar = new UIProgressView(UIProgressViewStyle.Default)
            {
                ProgressImage = UIImage.FromBundle("TrackImage"),
                ProgressTintColor = UIColor.Cyan,
                TrackImage = UIImage.FromBundle("TrackImage"),
                TrackTintColor = UIColor.Magenta
            };