ASP:BULLETEDLIST |
ASP : Liste de puces |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:BulletedList paramètres> <asp:ListItem>valeurs 1</asp:ListItem> <asp:ListItem>valeurs 2</asp:ListItem> <asp:ListItem>valeurs 3</asp:ListItem> ... </asp:BulletedList> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| AccessKey=valeur | Ce paramètre de balise permet d'indiquer un touche de raccourci à associer avec cette balise. | ||
| AppendDataBoundItems=valeur | Ce paramètre permet d'indiquer si les éléments de la liste sont effacés avant la liaison des données ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'ils ne sont pas effacés. | ||
| "True" | Cette constante permet d'indiquer qu'ils sont effacés. | ||
| AutoPostBack=valeur | Ce paramètre permet d'indiquer s'il faut poster immédiatement après avoir coché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne faut pas poster. | ||
| "True" | Cette constante permet d'indiquer qu'il faut poster. | ||
| BackColor=valeur | Ce paramètre permet d'indiquer la couleur d'arrière plan de la balise. | ||
| BorderColor=valeur | Ce paramètre permet d'indiquer la couleur de bordure de la balise. | ||
| BorderStyle=valeur | Ce paramètre permet d'indiquer le style de bordure de la balise : NotSet, None, Dotted, Dashed, Solid, Double, Groove, Ridge, Inset ou Outset. | ||
| BorderWidth=valeur | Ce paramètre permet d'indiquer la largeur de la bordure de la balise. | ||
| CausesValidation=valeur | Ce paramètre permet d'indiquer s'il faut effectuer la validation ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne faut pas valider. | ||
| "True" | Cette constante permet d'indiquer qu'il faut valider. | ||
| CssClass=valeur | Ce paramètre permet d'indiquer la classe de feuille de style CSS de la balise. | ||
| DataMember=valeur | Ce paramètre permet d'indiquer les données du membre de la balise. | ||
| DataSource=valeur | Ce paramètre permet d'indiquer le contrôle où sont situés les données. | ||
| DataSourceID=valeur | Ce paramètre permet d'indiquer l'identificateur de contrôle où sont situés les données. | ||
| DataTextField=valeur | Ce paramètre permet d'indiquer le champ de données texte. | ||
| DataTextFormatString=valeur | Ce paramètre permet d'indiquer la chaine de caractères de formatage du champ de données texte. | ||
| DataValueField=valeur | Ce paramètre permet d'indiquer la valeur du champ de données. | ||
| Enabled=valeur | Ce paramètre permet d'indiquer si la balise doit être active ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| "True" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| EnableTheming=valeur | Ce paramètre permet d'indiquer si le thème de la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le thème de la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que le thème de la balise est affiché. | ||
| EnableViewState=valeur | Ce paramètre permet d'indiquer si le ViewState de la balise doit être activé ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le ViewState de la balise n'est pas actif. | ||
| "True" | Cette constante permet d'indiquer que le ViewState de la balise est actif. | ||
| Font-Bold=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être en gras ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas en gras. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est en gras. | ||
| Font-Italic=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être en italique ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas en italique. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est en italique. | ||
| Font-Names=valeur | Ce paramètre permet d'indiquer les noms de la police de caractères. | ||
| Font-Overline=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être surligné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas surligné. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est surligné. | ||
| Font-Size=valeur | Ce paramètre permet d'indiquer la taille de la police de caractères de la balise : Smaller, Larger, XX-Small, X-Small, Small, Medium, Large, X-Large ou XX-Large. | ||
| Font-Strikeout=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être barré ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas barré. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est barré. | ||
| Font-Underline=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être souligné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas souligné. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est souligné. | ||
| ForeColor=valeur | Ce paramètre permet d'indiquer la couleur de premier plan de la balise. | ||
| Height=valeur | Ce paramètre permet d'indiquer la hauteur de la balise. | ||
| ID=valeur | Ce paramètre permet d'indiquer l'identificateur de la balise. | ||
| OnDataBinding=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de DataBinding. | ||
| OnDataBound=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de DataBound. | ||
| OnDisposed=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de disposition. | ||
| OnInit=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement d'initialisation. | ||
| OnLoad=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de chargement. | ||
| OnPreRender=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de pré-rendu. | ||
| OnSelectedIndexChanged=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de changement d'index sélectionné. | ||
| OnTextChanged=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de changement de texte. | ||
| OnUnload=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de déchargement. | ||
| runat=valeur | Ce paramètre permet d'indiquer où doit être exécuté la balise : | ||
| Constante | Description | ||
| "server" | Cette constante permet d'indiquer qu'il faut exécuter la balise du côté serveur. | ||
| SkinID=valeur | Ce paramètre permet d'indiquer l'identificateur de Skin. | ||
| Style=valeur | Ce paramètre de balise permet d'indiquer des paramètres de feuille de style associé avec cette balise. | ||
| TabIndex=valeur | Ce paramètre de balise permet d'indiquer l'ordre de sélection des champs et éléments dans un formulaire. | ||
| ToolTip=valeur | Ce paramètre de balise permet d'indiquer l'info-bulle. | ||
| ValidationGroup=valeur | Ce paramètre de balise permet d'indiquer le groupe de validation. | ||
| Visible=valeur | Ce paramètre permet d'indiquer si la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que la balise est affiché. | ||
| Width=valeur | Ce paramètre de balise permet d'indiquer la largeur de la balise. | ||
| ... | ... | ||
Description
Cette balise permet d'afficher une liste d'item avec une puce ou un autre symbole pour chaque item.
Remarques
- Le contrôle BulletedList d'ASP.NET permet d'afficher une liste à puces structurée directement côté serveur. Il s'agit d'une alternative pratique aux balises HTML classiques <ul> et <li>, avec en plus les avantages de l'intégration dans le cycle de vie des pages ASP.NET.
- Grâce à la syntaxe <asp:BulletedList>, on peut créer des listes dynamiques tout en bénéficiant des fonctionnalités de data-binding. Cela simplifie énormément la gestion d'éléments provenant de sources de données, comme une base SQL, un fichier XML ou une collection en mémoire.
- Chaque élément de la liste est défini à l'aide de balises <asp:ListItem>, ce qui permet de spécifier des propriétés supplémentaires comme la valeur interne (Value) et le texte affiché (Text). C'est utile notamment lors de la manipulation côté code-behind.
- Le contrôle peut afficher différentes puces selon la propriété BulletStyle. On peut choisir entre des styles classiques (cercles, carrés, chiffres, alphabets) ou même opter pour des images personnalisées, ce qui rend le rendu visuel plus flexible.
- On peut facilement modifier l'apparence globale du contrôle avec des propriétés comme Font, ForeColor, ou CssClass, ce qui facilite son intégration graphique dans n'importe quelle interface utilisateur ASP.NET.
- Le contrôle BulletedList est interactif si on active la propriété DisplayMode. Par exemple, en choisissant LinkButton, chaque élément devient cliquable et peut générer un événement serveur, ce qui permet de créer des menus ou listes interactives sans JavaScript.
- L'événement Click associé au contrôle permet de réagir aux sélections d'éléments dans la liste. C'est particulièrement pratique pour des cas comme la navigation conditionnelle ou l'affichage de détails associés à un élément choisi.
- Le data-binding est supporté via la propriété DataSource. On peut lier une liste, un tableau, un DataTable ou toute collection IEnumerable. Cela permet de générer des listes dynamiques depuis des données externes sans avoir à coder chaque item à la main.
- Chaque élément peut contenir un Value distinct du texte affiché, ce qui permet de gérer des identifiants ou des codes tout en affichant des libellés compréhensibles à l'utilisateur. C'est utile dans les scénarios de traitements ou de navigation conditionnelle.
- Le contrôle est parfaitement compatible avec le ViewState, ce qui permet de conserver la sélection et l'état de la liste entre les postbacks sans effort particulier. Cela simplifie la gestion de l'état côté développeur.
- Avec le mode HyperLink, chaque élément peut rediriger l'utilisateur vers une URL spécifique. Cette approche transforme la liste en un mini-menu de navigation ou un sommaire, très pratique pour les interfaces simples.
- Il est possible d'utiliser un gabarit de données pour personnaliser encore davantage l'affichage des éléments, bien que ce ne soit pas aussi flexible qu'un Repeater ou un ListView. Cela permet tout de même d'introduire du contenu enrichi dans la liste.
- Le contrôle BulletedList est limité à une structure plate : il ne gère pas les sous-niveaux ou l'imbrication d'éléments. Pour des hiérarchies plus complexes, il faudra envisager d'autres contrôles comme un TreeView ou un Repeater personnalisé.
- Côté accessibilité, le contrôle est bien interprété par les lecteurs d'écran, surtout si on utilise le mode TextOnly. Cela le rend utile dans des contextes où l'accessibilité est une exigence, notamment pour les sites publics ou administratifs.
- Le contrôle peut aussi être utilisé à des fins non visuelles, comme pour afficher des messages, des instructions ou des états. Sa simplicité de mise en oeuvre en fait un outil polyvalent dans l'arsenal ASP.NET.
Exemple
Voici un exemple permettant d'afficher une liste :
- <%@ Page Language="vb" AutoEventWireup="false" CodeBehind="aspbulletedlist.aspx.vb" Inherits="WebSamples.aspbulletedlist" %>
-
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
- <html xmlns="http://www.w3.org/1999/xhtml">
- <head runat="server">
- <title></title>
- </head>
- <body>
- <form id="MonFormulaire" runat="server">
- <asp:BulletedList id="BulletedList1" BulletStyle="Circle" runat="server">
- <asp:ListItem>Un</asp:ListItem>
- <asp:ListItem>Deux</asp:ListItem>
- <asp:ListItem>Trois</asp:ListItem>
- <asp:ListItem>Quatre</asp:ListItem>
- <asp:ListItem>Cinq</asp:ListItem>
- <asp:ListItem>Six</asp:ListItem>
- <asp:ListItem>Sept</asp:ListItem>
- <asp:ListItem>Huit</asp:ListItem>
- <asp:ListItem>Neuf</asp:ListItem>
- <asp:ListItem>Dix</asp:ListItem>
- </asp:BulletedList>
- </form>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
- Un
- Deux
- Trois
- Quatre
- Cinq
- Six
- Sept
- Huit
- Neuf
- Dix
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017