ASP:PANEL |
ASP : Panneau |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:Panel paramètres> controle </asp:Panel> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| controle | Ce paramètre de balise permet d'indiquer une liste de balise de contrôle. | ||
| AccessKey=valeur | Ce paramètre de balise permet d'indiquer un touche de raccourci à associer avec cette balise. | ||
| BackColor=valeur | Ce paramètre permet d'indiquer la couleur d'arrière plan de la balise. | ||
| BackImageUrl=valeur | Ce paramètre permet d'indiquer un lien URL vers une image d'arrière-plan. | ||
| 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. | ||
| CssClass=valeur | Ce paramètre permet d'indiquer la classe de feuille de style CSS de la balise. | ||
| DefaultButton=valeur | Ce paramètre permet d'indiquer le bouton par défaut. | ||
| Direction=valeur | Ce paramètre permet d'indiquer la direction d'affichage des balises incluses : | ||
| Constante | Description | ||
| "NotSet" | Cette constante permet d'indiquer qu'elle ne sont pas fixés à un endroit précis. | ||
| "LeftToRight" | Cette constante permet d'indiquer qu'elle sont afficher de la gauche vers la droite. | ||
| "RightToLeft" | Cette constante permet d'indiquer qu'elle sont afficher de la droite vers la gauche. | ||
| 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. | ||
| HorizontalAlign=valeur | Ce paramètre permet d'indiquer l'alignement horizontal du panneau : | ||
| Constante | Description | ||
| "NotSet" | Cette constante permet d'indiquer qu'il n'est pas aligné. | ||
| "Left" | Cette constante permet d'indiquer qu'il est aligné à gauche. | ||
| "Center" | Cette constante permet d'indiquer qu'il est aligné au centre. | ||
| "Justify" | Cette constante permet d'indiquer qu'il est justifié. | ||
| "Right" | Cette constante permet d'indiquer qu'il est aligné à droite. | ||
| 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. | ||
| 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. | ||
| 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. | ||
| ScrollBars=valeur | Ce paramètre permet d'indiquer la disposition de la barre de défilement : | ||
| Constante | Description | ||
| "None" | Cette constante permet d'indiquer qu'il n'y a pas de barre de défilement affiché. | ||
| "Horizontal" | Cette constante permet d'indiquer qu'il y a uniquement une barre de défilement horizontal. | ||
| "Vertical" | Cette constante permet d'indiquer qu'il y a uniquement une barre de défilement vertical. | ||
| "Both" | Cette constante permet d'indiquer qu'il y a une barre de défilement horizontal et vertical. | ||
| "Auto" | Cette constante permet d'indiquer qu'il y a une barre de défilement horizontal et vertical seulement si nécessaire. | ||
| 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. | ||
| 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. | ||
| Wrap=valeur | Ce paramètre permet d'indiquer si le texte peut être découpé ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne pas découper le texte. | ||
| "True" | Cette constante permet d'indiquer qu'il faut découper le texte. | ||
Description
Cette balise permet de définir un panneau de contrôle devant contenant d'autres contrôles variés.
Remarques
- Le contrôle <asp:Panel> est un conteneur utilisé pour regrouper d'autres contrôles Web ASP.NET. Il permet d'organiser la structure de la page de manière logique et visuelle, facilitant ainsi la mise en page.
- En HTML rendu, un Panel correspond généralement à une balise <div>, mais cela peut varier en fonction des propriétés utilisées. Il peut contenir n'importe quel autre contrôle ASP.NET ou HTML.
- Le Panel est très utile pour appliquer des styles CSS à un groupe de contrôles. Grâce à ses attributs comme CssClass ou Style, on peut facilement contrôler l'apparence de toute une section de la page.
- L'un des usages les plus courants du Panel est de masquer ou d'afficher dynamiquement une portion de la page via la propriété Visible. Cela est pratique pour créer des interfaces adaptatives sans recharger entièrement la page.
- Le contrôle peut être activé ou désactivé via la propriété Enabled. Lorsqu'il est désactivé, tous les contrôles enfants deviennent aussi inactifs, ce qui est très utile pour bloquer des blocs d'interface.
- Le Panel joue un rôle important dans le développement d'interfaces complexes où certaines sections doivent apparaître uniquement selon certaines conditions, comme après une authentification ou une sélection.
- Il est possible d'ajouter dynamiquement des contrôles dans un Panel via le code-behind, en utilisant sa collection Controls.Add(). Cela permet une grande souplesse dans la génération de l'interface.
- La propriété ScrollBars permet de gérer l'affichage de barres de défilement à l'intérieur du Panel. On peut ainsi contrôler la navigation dans des contenus dont la taille dépasse celle du panneau.
- Un Panel peut aussi être utilisé pour isoler des zones partiellement mises à jour via des technologies comme AJAX. Il est souvent combiné avec un UpdatePanel pour des interfaces plus fluides.
- Lorsqu'on utilise la propriété GroupingText, le Panel peut s'afficher comme un encadré avec un titre, ce qui améliore l'ergonomie de certaines sections (par exemple un formulaire).
- La balise <asp:Panel> accepte également les événements du cycle de vie comme OnLoad ou OnPreRender, permettant d'agir à différents moments du rendu ou de la préparation du contrôle.
- Le Panel peut servir à encapsuler des validations. Par exemple, en regroupant plusieurs contrôles avec un ValidationGroup, on peut cibler la validation sur un seul panneau à la fois.
- Un Panel n'a pas d'effet fonctionnel sur le contenu qu'il contient par défaut, mais il peut être stylisé pour avoir une bordure, une couleur d'arrière-plan ou tout autre effet visuel.
- En JavaScript ou avec jQuery, les Panel ASP.NET sont souvent ciblés via leur ClientID, pouvant être utilisé pour manipuler leur visibilité ou leur style sans recharger la page.
- Dans des interfaces multi-étapes (wizard), les Panel sont souvent utilisés pour afficher une étape à la fois, tout en gardant le reste caché, simplifiant ainsi la navigation pour l'utilisateur.
Exemple
Voici un exemple affichant deux panneaux :
- <%@ Page Language="vb" %>
- <!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">
- <body>
- <form id="MonFormulaire" runat="server">
- <asp:Panel id="Panel1" runat="server">
- <asp:Label id="ItemA" runat="server" text="Item A"></asp:Label><br />
- <asp:Label id="ItemB" runat="server" text="Item B"></asp:Label><br />
- <asp:Label id="ItemC" runat="server" text="Item C"></asp:Label><br />
- </asp:Panel>
- <br />
- <asp:Panel id="Panel2" runat="server">
- <asp:Label id="Item1" runat="server" text="Item 1"></asp:Label><br />
- <asp:Label id="Item2" runat="server" text="Item 2"></asp:Label><br />
- <asp:Label id="Item3" runat="server" text="Item 3"></asp:Label><br />
- </asp:Panel>
- </form>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
|
Item A
Item B Item C
Item 1
Item 2 Item 3 |
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017