Utilisation des indicateurs de progression tvOS dans Xamarin
Cet article traite de la conception et de l’utilisation d’indicateurs de progression à l’intérieur d’une application Xamarin.tvOS.
Il peut arriver que votre application Xamarin.tvOS ait besoin de charger du nouveau contenu ou d’effectuer une longue opération de traitement. Pendant ces périodes, vous devez présenter un indicateur d’activité ou une barre de progression pour informer l’utilisateur que l’application est toujours en cours d’exécution et lui donner une indication quant à la longueur de la tâche en cours d’exécution.
À propos des indicateurs d’activité
Un indicateur d’activité présente comme une roue de rotation et est utilisé pour représenter une tâche d’une longueur indéterminée. L’indicateur est présenté lorsque la tâche démarre et disparaît lorsque la tâche est terminée.
Apple propose les suggestions suivantes pour travailler avec les indicateurs d’activité :
- Dans la mesure du possible, utilisez plutôt des barres de progression : é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 connue (par exemple, le nombre d’octets à télécharger dans un fichier).
- Gardez l’indicateur animé : les utilisateurs associent un indicateur d’activité stationnaire à une application bloquée. Vous devez donc toujours animer l’indicateur pendant son affichage.
- 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.
À propos des barres 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 connue 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 présenter 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 : les barres de progression ne doivent 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.
Indicateurs de progression et tableaux de montage séquentiel
Le moyen le plus simple d’utiliser un indicateur de progression dans une application Xamarin.tvOS consiste à l’ajouter à l’interface utilisateur de l’application à l’aide du Concepteur iOS.
Dans le Panneau Solution, double-cliquez sur le fichier Main.storyboard et ouvrez-le pour modification.
Faites glisser un indicateur d’activité à partir de la boîte à outils et déposez-le dans la vue :
Dans l’onglet Widget du panneau Propriétés, vous pouvez ajuster plusieurs propriétés de l’indicateur d’activité, telles que son style, son comportement et son nom :
Le nom détermine le nom de la propriété qui représente l’indicateur d’activité dans le code C#.
Faites glisser un affichage de progression à partir de la boîte à outils et déposez-le dans la vue :
Dans l’onglet Widget de l’Explorateur de propriétés, vous pouvez ajuster plusieurs propriétés de l’affichage de progression, telles que son style, sa progression (pourcentage terminé) et son nom :
Le nom détermine le nom de la propriété qui représente l’affichage de progression dans le code C#.
Enregistrez vos modifications.
Pour plus d’informations sur l’utilisation des storyboards, consultez notre Guide de démarrage rapide Hello, tvOS.
Utilisation des indicateurs d’activité
Comme indiqué ci-dessus, les indicateurs d’activité doivent être affichés lorsque votre application exécute un long processus de longueur indéterminée.
À tout moment, vous pouvez voir si un indicateur d’activité s’anime en case activée sa IsAnimating propriété. Si la HidesWhenStopped propriété est true, l’indicateur d’activité est automatiquement masqué lorsque son animation est arrêtée.
Vous pouvez utiliser le code suivant pour démarrer l’animation :
ActivityIndicator.StartAnimating();
Les éléments suivants arrêtent l’animation :
ActivityIndicator.StopAnimating();
Remarque
Ces extraits de code supposent que le nom de l’indicateur d’activité a été défini sur ActivityIndicator dans l’onglet Widget du Concepteur iOS.
Utilisation des barres de progression
Là encore, une barre de progression doit être utilisée chaque fois que votre application exécute une tâche longue d’une durée connue.
La Progress propriété est utilisée pour définir la quantité de la tâche qui a été effectuée de 0 % à 100 % (0,0 à 1,0). Utilisez la ProgressTintColor propriété pour définir la couleur de la barre terminée de la quantité terminée et la TrackTintColor propriété pour définir la couleur d’arrière-plan (quantité non supprimée).
Résumé
Cet article a abordé la conception et l’utilisation d’indicateurs de progression à l’intérieur d’une application Xamarin.tvOS.