> 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/textbox.md).

# Zone de texte

Ajoutez des champs de saisie de texte aux applis PowerShell Universal avec les types mot de passe, nombre et multiligne, le masquage, les icônes et les gestionnaires d'événements de validation.

Une zone de texte permet aux utilisateurs de saisir et de modifier du texte.

## Textbox

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -Label 'Standard' -Placeholder 'Textbox'
New-UDTextbox -Label 'Disabled' -Placeholder 'Textbox' -Disabled
New-UDTextbox -Label 'Textbox' -Value 'With value'
```

{% endcode %}

## Types de zone de texte

Les zones de texte peuvent être configurées pour accepter des types précis, comme des mots de passe, des nombres ou des courriels.

### Type mot de passe

Une zone de texte de type mot de passe masque la saisie.

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -Label 'Password' -Type password
```

{% endcode %}

### Type nombre

N'accepte que des nombres. Certains navigateurs incluront des flèches vers le haut et vers le bas pour augmenter et diminuer la valeur actuelle.

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -Label 'Number' -Type number -Minimum 10 -Maximum 10000 -Value 1234
```

{% endcode %}

## Multiligne

Vous pouvez créer une zone de texte multiligne en utilisant le paramètre `-Multiline`. Appuyer sur Entrée ajoutera une nouvelle ligne. Vous pouvez définir le nombre de rangées et le nombre maximal de rangées à l'aide de `-Rows` et `-RowsMax`.

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -Multiline -Rows 4 -RowsMax 10
```

{% endcode %}

## Interaction

### Récupérer la valeur d'une zone de texte

Vous pouvez utiliser `Get-UDElement` pour obtenir la valeur d'une zone de texte

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -Id 'txtExample' 
New-UDButton -OnClick {
    $Value = (Get-UDElement -Id 'txtExample').value 
    Show-UDToast -Message $Value
} -Text "Get textbox value"
```

{% endcode %}

### Définir la valeur de la zone de texte

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -Id 'txtExample' -Label 'Label' -Value 'Value'

New-UDButton -OnClick {

    Set-UDElement -Id 'txtExample' -Properties @{
        Value = "test123"
    }

} -Text "Get textbox value"
```

{% endcode %}

## Icônes

Vous pouvez définir l'icône d'une zone de texte en utilisant le paramètre `-Icon` et l'applet de commande `New-UDIcon`.

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -Id "ServerGroups" -Icon (New-UDIcon -Icon 'server') -Value "This is my server"
```

{% endcode %}

## Masquage

Vous pouvez utiliser `-MaskPattern` pour définir un masque pour la zone de texte. Voici un exemple de masque de zone de texte.

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -Id 'textbox16' -MaskPattern '+7 (000) 000-00-00'
```

{% endcode %}

La définition peut contenir

* `0` - tout chiffre
* `a` - toute lettre
* `*` - tout caractère
* les autres caractères qui ne figurent pas dans les définitions personnalisées sont censés être *fixes*
* `[]` - rend la saisie optionnelle
* `{}` - inclut la partie fixe dans la valeur non masquée
* `` ` `` - empêche le décalage arrière des symboles

Si un caractère de définition doit être traité comme fixe, il doit être échappé par `\\` (p. ex. `\\0`).

Le masquage de la zone de texte est contrôlé par [imaskjs](https://imask.js.org/guide.html#masked-pattern).

## OnEnter

Le gestionnaire d'événement `-OnEnter` est exécuté lorsque l'utilisateur appuie sur Entrée dans le champ de texte. Il est utile pour effectuer d'autres actions, comme cliquer sur un bouton, lors de l'appui sur Entrée.

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -OnEnter {
    Invoke-UDEvent -Id 'submit' -Event onClick
}

New-UDButton -Id 'submit' -OnClick {
    Show-UDToast -Message 'From Textbox'
}
```

{% endcode %}

## OnBlur

Le gestionnaire d'événement `-OnBlur` est exécuté lorsque la zone de texte perd le focus.

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -OnBlur {
    Show-UDToast "Blurred"
}
```

{% endcode %}

## OnValidate

Utilisez le gestionnaire d'événement `-OnValidate` pour valider la saisie entrée dans la zone de texte.

{% code collapsedlinecount="10" %}

```powershell
New-UDTextbox -OnValidate {
    if ($EventData.Length -lt 10)
    {
        New-UDValidationResult -ValidationError 'String needs to be longer than 10'
    }
}
```

{% endcode %}

## API

[New-UDTextbox](/powershell-universal/fr/commandes-powershell/new-udtextbox.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/textbox.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.