Fermer

juillet 21, 2021

Prise en main du contrôle BadgeView pour Xamarin.Forms


R2 2021 de Telerik UI pour Xamarin est sorti et il apporte notre tout nouveau contrôle BadgeView. Avec lui, vous pouvez facilement afficher des badges sur votre application dans un scénario mobile où une notification ou une mise à jour peut être illustrée par un badge.

Vous avez vu des badges partout, indiquant le nombre d'e-mails non lus, affichant des mises à jour sur une application professionnelle ou présentant l'état d'une application de messagerie indiquant si une personne est en ligne, hors ligne ou absente. Quel que soit le scénario que vous essayez de réaliser, le Xamarin BadgeView regorge de toutes les fonctionnalités dont vous aurez besoin !

Xamarin_badge_overview montrant quatre styles différents, y compris le nombre, le symbole et les deux ; cercles purs et rectangles arrondis

Get Started

Le moyen le plus simple d'utiliser RadBadgeView consiste à ajouter notre Telerik.UI.for.Xamarin NuGet package à votre solution Xamarin.Forms.

Ensuite, ajoutez une référence à l'espace de noms Telerik.XamarinForms.Primitives :

xmlns:telerikPrimitives="clr-namespace:Telerik.XamarinForms.Primitives;assembly=Telerik.XamarinForms.Primitives"

Enfin, ajoutez le contrôle BadgeView à la page. Dans l'exemple ci-dessous, le badge serait attaché à un contrôle RadBorder avec une étiquette :

<telerikPrimitives:RadBadgeView BadgeText="new">[19659002] ]<telerikPrimitives:RadBadgeView.Content>

<telerikPrimitives:RadBorder WidthRequest="80"

HeightRequest ="80"

Épaisseur frontière="1"

BorderColor="Gris Clair">

<Label Text="Telerik BadgeView pour Xamarin"

FontSize="14"

VerticalTextAlignment= "Centre"

HorizontalTextAlignment="Centre"/>[19659002] </telerikPrimitives:RadBorder>

</telerikPrimitives:RadBadgeView.Content>

</telerikPrimitives:RadBadgeView>

Consulter le résultat sur la simulation iOS ou :

Xamarin_simple_badge - un badge rectangle arrondi rouge indique "nouveau"

Utiliser des badges prédéfinis

Nous avons pensé aux scénarios les plus courants où un badge serait nécessaire et avons proposé un ensemble de badges prédéfinis types que vous pouvez utiliser directement dans votre application. Choisissez entre « Disponible », « Ne pas déranger », « Absent du bureau » et plus encore. Consultez la liste complète dans la rubrique de documentation Types de badges.

Voici un exemple rapide avec un badge prédéfini marquant le statut d'un utilisateur d'application :

<telerikPrimitives :RadBadgeView BadgeType="Disponible"

BadgePositionHorizontale="Centre"[19659002] BadgeVerticalPosition="Centre"

BadgeOffsetX="30"

BadgeOffsetY="30"[19659012]>

<telerikPrimitives:RadBadgeView.Content>

<telerikPrimitives:RadBorder[19659011]WidthRequest="91"

HeightRequest="91"

HorizontalOptions="Centre"

BorderThickness="4"

BorderColor= "#DFDFDF"

C ornerRadius="46">

<Image Source[19659012]="account_image.png" />

</telerikPrimitives:RadBorder >

</telerikPrimitives:RadBadgeView.Content>

</telerikPrimitives:RadBadgeView>

Et le résultat avec différents types de badges sur iOS :

Xamarin_predefined_badges badges circulaires en vert avec une coche pour afficher disponible, en rouge avec une ligne horizontale pour afficher indisponible, et en gris avec une flèche vers la droite pour afficher.

Créez votre propre badge

Vous pouvez également définir manuellement le texte affiché à l'intérieur du badge - c'est très utile lorsque vous devez afficher le nombre de nouveaux e-mails ou messages, ou ajouter une balise spécifique, telle que « nouveau », « mis à jour », etc.

<telerikPrimitives:RadBadgeView BadgeText=[19659013]"11"

BadgePositionHorizontale="Fin"

BadgeVerticalPosition="Fin">

<telerikPrimitives:RadBadgeView.Content>

<Image Source= "envelope.png" WidthRequest="60" />

</telerikPrimitives:RadBadgeView.Content>

</telerikPrimitives:RadBadgeView>

Xamarin_badge_text - une icône d'application d'enveloppe a un badge rouge avec 11, montrant 11 nouveaux messages

Si l'affichage du texte à l'intérieur du badge n'est pas suffisant pour obtenir le scénario souhaité, vous pouvez modifier complètement le Badge ControlTemplate et ajouter n'importe quel contenu à l'intérieur. Accédez à la page de sujet Badge Customization pour plus d'informations si vous souhaitez explorer cette option.

Positionnez-le comme vous le souhaitez

Profitez des paramètres de position et d'alignement flexibles, afin que vous puissiez placer le badge à l'endroit exact où vous souhaitez qu'il apparaisse. Vous pouvez définir sa position en fonction de la vue à laquelle il est attaché, appliquer un alignement et un décalage horizontaux et verticaux. Pour des informations détaillées sur les options disponibles, consultez notre page de sujet BadgeView : Position et alignement.

Découvrez différentes options de position dans l'image ci-dessous :

Xamarin_badge_position - en haut à gauche, au centre , en haut à droite

Stylisez-le selon votre propre design

Comme toujours, RadBadgeView est livré avec une variété de paramètres de style, il s'adaptera donc parfaitement au design de l'application que vous avez appliqué. Vous pouvez modifier les paramètres de police, différentes couleurs (couleur du texte, couleur d'arrière-plan, couleur de la bordure), la taille du badge et le rayon du coin.

Consultez ci-dessous un exemple rapide de BadgeView avec quelques propriétés de style appliquées. Pour la BadgeFontFamily, j'ai utilisé notre fichier Telerik ttf. Pour plus de détails à ce sujet, consultez la page de sujet Telerik UI for Xamarin Font Icons.

<telerikPrimitives:RadBadgeView BadgeText=" 39"

BadgeFontFamily="{StaticResource IconsFont}"

BadgeBackgroundColor="#0E88F2"

BadgeCornerRadius= ]"20"

BadgePositionHorizontale="Fin"

BadgePositionVerticale="Fin"

BadgeHorizontalAlignment="Fin"

Marge="20">

<[19659010]telerikPrimitives:RadBadgeView.Content>

<telerikPrimitives:RadBorder BackgroundColor=[19659013]"#EFEFEF"

CornerRadius="20"

HorizontalOptions="Centre"

Rembourrage="10">

<Label Text="Notre succès en tant qu'entreprise repose sur le dos de ..."

FontSize="15" />

</ telerikPrimitives:RadBorder>

</telerikPrimitives:RadBadgeView.Content>

</telerikPrimitives:RadBadgeView>

L'image ci-dessous montre à quoi ressemblera le badge sur iOS :

 

Xamarin_badge_styling - le badge est en bas à droite, bleu, un rectangle arrondi, et il a un cœur avec 39, montrant 39 likes.

En savoir plus et partager vos commentaires[19659005] J'espère avoir réussi à vous donner un aperçu des fonctionnalités de base du contrôle BadgeView dans l'interface utilisateur Telerik pour Xamarin. Et n'hésitez pas à consulter la documentation.

En attendant, nous aimerions connaître vos commentaires sur le contrôle BadgeView et sur la façon dont nous pouvons l'améliorer. Si vous avez des idées de fonctionnalités à ajouter, n'hésitez pas à partager ces informations avec nous sur notre Telerik UI for Xamarin Feedback Portal.

Si vous n'avez pas encore essayé la suite Telerik UI for Xamarin, essayez-le avec un essai gratuit de 30 joursoffrant toutes les fonctionnalités et commandes à votre disposition à un coût nul.




Source link