Aller au contenu

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.

Terrain de jeu · arbre visuel d'une fenêtre
  • Window
    • StackPanel.toolbar
      • Button
      • Button.accent
      • ToggleButton
    • Border.carte
      • StackPanel
        • TextBlock.titre
        • TextBlock
        • Button
    • TextBlock.accent

À remarquer :

  • Button ne cible pas le ToggleButton (type dérivé) ; :is(Button) oui.
  • .accent cible tous les types qui ont la classe, y compris un TextBlock.
  • > = enfant direct : le Button de la carte n'est pas enfant de StackPanel.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>
Aperçu · survolez, cliquez
❌ 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

Aperçu · ListBoxItem:nth-child(2n)
É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>

Style en C

var style = new Style(x => x.OfType<Button>().Class("danger"))
{
    Setters =
    {
        new Setter(Button.BackgroundProperty, Brushes.Red),
        new Setter(Button.ForegroundProperty, Brushes.White)
    }
};
Application.Current!.Styles.Add(style);