> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/fr/applis/components/inputs/button.md).

# Bouton

Ajoutez des boutons contenus, contourés, à icône et de chargement dans les applications PowerShell Universal, y compris des groupes de boutons et des gestionnaires d'événements de clic pour les action

Les boutons permettent aux utilisateurs de poser des actions et de faire des choix en un seul appui.

## Bouton contenu

Les boutons contenus sont très mis en évidence, se distinguant par leur utilisation de l'élévation et du remplissage. Ils contiennent les actions principales de votre appli.

```powershell
 New-UDButton -Variant 'contained' -Text 'Default'
```

## Bouton contouré

Les boutons contourés sont des boutons de mise en évidence moyenne. Ils contiennent des actions importantes, mais qui ne sont pas l'action principale d'une appli.

```powershell
New-UDButton -Variant 'outlined' -Text 'Default'
```

## Contrôler la taille du bouton

Vous pouvez contrôler la taille en pixels d'un bouton en fonction de la taille en pixels à l'aide du paramètre Style

```powershell
New-UDButton -Id "Submit" -Text "Submit" -Style @{ Width = "150px"; Height = "100px" }
```

## Boutons avec icônes et étiquette

Vous pourriez parfois vouloir avoir des icônes pour certains boutons afin d'améliorer l'expérience utilisateur de l'application, puisque nous reconnaissons les logos plus facilement que le texte brut. Par exemple, si vous avez un bouton de suppression, vous pouvez l'étiqueter avec une icône de poubelle.

```powershell
New-UDButton -Icon (New-UDIcon -Icon trash) -Text 'Delete'
```

## Boutons avec gestionnaires d'événements

Vous pouvez spécifier un bloc de script à exécuter lorsque le bouton est cliqué

```powershell
New-UDButton -Text 'Message Box' -OnClick {
    Show-UDToast -Message 'Hello, world!'
}
```

## Bouton de chargement

Les boutons de chargement affichent une icône de chargement pendant l'exécution d'un gestionnaire d'événements. C'est utile pour les événements de plus longue durée.

```powershell
New-UDButton -Text 'Message Box' -OnClick {
    Show-UDToast -Message 'Hello, world!'
    Start-Sleep 10
} -ShowLoading
```

## Groupe de boutons

Un groupe de boutons produit un bouton avec un menu déroulant. On l'appelle aussi un bouton fractionné.

```powershell
New-UDButtonGroup -Children {
    New-UDButtonGroupItem -Text "Button 1" -OnClick {
        Show-UDToast "Button 1"
    }
    New-UDButtonGroupItem -Text "Button 2" -OnClick {
        Show-UDToast "Button 2"
    }
    New-UDButtonGroupItem -Text "Button 3" -OnClick {
        Show-UDToast "Button 3"
    }
}
```

## Désactiver le bouton après le clic

Cet exemple utilise `Set-UDElement` pour désactiver le bouton après avoir exécuté une action.

```powershell
New-UDButton -Id "btn1" -OnClick {
    Show-UDToast "Hello!"
    Set-UDElement -Id 'btn1' -Attributes @{
        disabled = $true
    }
}
```

## API

* [New-UDButton](/powershell-universal/fr/commandes-powershell/new-udbutton.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/fr/applis/components/inputs/button.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.