Sélecteurs¶
La syntaxe des sélecteurs, par l'exemple.
Essayez¶
Choisissez un sélecteur : les éléments qu'il cible s'allument dans l'arbre.
- Window
- StackPanel.toolbar
- Button
- Button.accent
- ToggleButton
- Border.carte
- StackPanel
- TextBlock.titre
- TextBlock
- Button
- StackPanel
- TextBlock.accent
- StackPanel.toolbar
À remarquer :
Buttonne cible pas leToggleButton(type dérivé) ;:is(Button)oui..accentcible tous les types qui ont la classe, y compris unTextBlock.>= enfant direct : leButtonde la carte n'est pas enfant deStackPanel.toolbar.
Référence rapide¶
| Sélecteur | Cible |
|---|---|
Button |
tous les Button (et types dérivés : non) |
:is(Button) |
Button et types dérivés (ToggleButton…) |
.accent |
éléments avec la classe accent |
Button.accent.large |
Button avec les deux classes |
#Valider |
élément nommé x:Name="Valider" |
StackPanel Button |
Button descendant d'un StackPanel |
StackPanel > Button |
Button enfant direct |
Button:pointerover |
survolé |
Button:not(.accent) |
sans la classe accent |
ListBoxItem:nth-child(2n) |
un élément sur deux |
TextBox[IsReadOnly=True] |
selon une propriété |
Button /template/ ContentPresenter |
élément dans le template |
Button, ToggleButton |
l'un ou l'autre |
Type, classe, nom¶
<Style Selector="TextBlock"> <!-- tous les TextBlock -->
<Style Selector="TextBlock.muted"> <!-- classe -->
<Style Selector="TextBlock#Titre"> <!-- nom -->
<Style Selector=".badge"> <!-- tout type avec la classe -->
Pseudo-classes¶
<Style Selector="Button:pointerover"> <!-- survol -->
<Style Selector="Button:pressed"> <!-- appuyé -->
<Style Selector="Button:disabled"> <!-- désactivé -->
<Style Selector="TextBox:focus"> <!-- a le focus -->
<Style Selector="TextBox:focus-within"><!-- focus dans un descendant -->
<Style Selector="TextBox:focus-visible"><!-- focus au clavier -->
<Style Selector="CheckBox:checked"> <!-- coché -->
<Style Selector="CheckBox:indeterminate">
<Style Selector="ListBoxItem:selected">
<Style Selector="Expander:expanded">
<Style Selector="TextBox:error"> <!-- erreur de validation -->
Le piège du :pointerover sur un Button¶
Le thème Fluent dessine le fond dans le template. Changer Background sur le bouton ne suffit pas au survol :
flowchart TB
B["Button.violet<br/>Background = #6D28D9"] -- "TemplateBinding<br/>(état normal)" --> CP
subgraph T["Template du Button (Fluent)"]
CP["ContentPresenter#PART_ContentPresenter<br/>c'est LUI qui peint le fond"]
end
S["Style Fluent :pointerover<br/>/template/ ContentPresenter"] -- "au survol, écrase<br/>directement la valeur" --> CP
Au survol, Fluent ne passe plus par Background du bouton : il modifie directement le ContentPresenter.
Il faut donc cibler ce même élément avec /template/.
<!-- ❌ Sans effet au survol -->
<Style Selector="Button.violet:pointerover">
<Setter Property="Background" Value="#5B21B6" />
</Style>
<!-- ✅ Cible le ContentPresenter du template -->
<Style Selector="Button.violet">
<Setter Property="Background" Value="#6D28D9" />
<Setter Property="Foreground" Value="White" />
</Style>
<Style Selector="Button.violet:pointerover /template/ ContentPresenter#PART_ContentPresenter">
<Setter Property="Background" Value="#5B21B6" />
<Setter Property="Foreground" Value="White" />
</Style>
<Style Selector="Button.violet:pressed /template/ ContentPresenter#PART_ContentPresenter">
<Setter Property="Background" Value="#4C1D95" />
</Style>
❌ seul
:pointerover : le gris Fluent gagne✅ avec
/template/ : violet foncéTip
Les outils de développement (F12) montrent les noms des parties du template (PART_…).
Descendant et enfant¶
<!-- Tous les TextBlock dans une carte, à n'importe quelle profondeur -->
<Style Selector="Border.carte TextBlock">
<Setter Property="Foreground" Value="#374151" />
</Style>
<!-- Uniquement les Button enfants directs d'une barre d'outils -->
<Style Selector="StackPanel.toolbar > Button">
<Setter Property="Padding" Value="6" />
<Setter Property="Background" Value="Transparent" />
</Style>
Négation et alternance¶
Élément 1Élément 2Élément 3Élément 4Élément 5
<!-- Lignes zébrées -->
<Style Selector="ListBoxItem:nth-child(2n)">
<Setter Property="Background" Value="#F9FAFB" />
</Style>
<!-- Tous les boutons sauf les accents -->
<Style Selector="Button:not(.accent)">
<Setter Property="Background" Value="Transparent" />
</Style>
<!-- Le dernier élément -->
<Style Selector="StackPanel > Border:nth-last-child(1)">
<Setter Property="BorderThickness" Value="0" />
</Style>
Selon une propriété¶
<Style Selector="TextBox[IsReadOnly=True]">
<Setter Property="Background" Value="#F3F4F6" />
</Style>
<Style Selector="Border[Tag=urgent]">
<Setter Property="BorderBrush" Value="Red" />
</Style>
<!-- Propriété attachée -->
<Style Selector="TextBlock[(Grid.Row)=0]">
<Setter Property="FontWeight" Value="Bold" />
</Style>
Inclure les types dérivés¶
<!-- Button, ToggleButton, RepeatButton… -->
<Style Selector=":is(Button)">
<Setter Property="CornerRadius" Value="8" />
</Style>
Dans un template¶
<!-- Couleur de la coche d'une CheckBox -->
<Style Selector="CheckBox:checked /template/ Border#NormalRectangle">
<Setter Property="Background" Value="#6D28D9" />
<Setter Property="BorderBrush" Value="#6D28D9" />
</Style>
Valeur d'un setter complexe¶
<Style Selector="Border.degrade">
<Setter Property="Background">
<LinearGradientBrush StartPoint="0%,0%" EndPoint="100%,0%">
<GradientStop Offset="0" Color="#8B5CF6" />
<GradientStop Offset="1" Color="#EC4899" />
</LinearGradientBrush>
</Setter>
</Style>