> 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/apps/components/inputs/button.md).
# Bouton
Les boutons permettent aux utilisateurs d'effectuer des actions et de faire des choix en un seul clic.
## Bouton contenu
Les boutons contenus sont à haute emphase, distingués par leur utilisation de l'élévation et du remplissage. Ils contiennent les actions principales de votre application.
```powershell
New-UDButton -Variant 'contained' -Text 'Default'
```
## Bouton en contour
Les boutons en contour sont des boutons à emphase moyenne. Ils contiennent des actions importantes, mais qui ne sont pas l'action principale d'une application.
```powershell
New-UDButton -Variant 'outlined' -Text 'Default'
```
## Contrôler la taille d'un bouton
Vous pouvez contrôler la taille en pixels d'un bouton en utilisant le 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 ajouter des icônes à certains boutons afin d'améliorer l'expérience utilisateur de l'application, car 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 corbeille.
```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. Cela est utile pour les événements de 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 parle également de bouton divisé.
```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"
}
}
```
Button Group
## Désactiver le bouton après un clic
Cet exemple utilise `Set-UDElement` pour désactiver le bouton après avoir effectué une action.
```powershell
New-UDButton -Id "btn1" -OnClick {
Show-UDToast "Hello!"
Set-UDElement -Id 'btn1' -Attributes @{
disabled = $true
}
}
```
## API
* [New-UDButton](https://github.com/Devolutions/doc-gitbook/blob/master/translations/fr/powershell-universal/cmdlets/New-UDButton.txt)
---
# 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:
```
GET https://docs.devolutions.net/powershell-universal/fr/apps/components/inputs/button.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.