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

# Zone de texte

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

## Zone de texte

![](/files/FIddafp0FKulF9b5itRk)

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

## Types de zone de texte

Les zones de texte peuvent être configurées pour accepter des types spécifiques, tels que les mots de passe, les nombres ou les adresses courriel.

### Type mot de passe

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

![](/files/4SzA91fLqo5DISwwN5NF)

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

### Type nombre

Accepte uniquement les nombres. Certains navigateurs afficheront des flèches vers le haut et vers le bas pour augmenter ou diminuer la valeur actuelle.

![](/files/ymrL3L5lCpTGEpUxrR1K)

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

## 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 lignes et le nombre maximal de lignes à l'aide des paramètres `-Rows` et `-RowsMax`.

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

## 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.

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

### Définir la valeur d'une zone de texte

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

New-UDButton -OnClick {

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

} -Text "Get textbox value"
```

## Icônes

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

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

![](/files/wRWERQG4vlps6Xdb9yTp)

## Masquage

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

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

La définition peut contenir

* `0` - n'importe quel chiffre
* `a` - n'importe quelle lettre
* `*` - n'importe quel caractère
* les autres caractères qui ne figurent pas dans les définitions personnalisées sont supposés être *fixes*
* `[]` - rend la saisie facultative
* `{}` - 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 `\\` (par exemple, `\\0`).

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

## OnEnter

Le gestionnaire d'événements `-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.

```powershell
New-UDTextbox -OnEnter {
    Invoke-UDEndpoint -Id 'submit' -Session
}

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

## OnBlur

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

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

## OnValidate

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

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

## API

[New-UDTextbox](https://github.com/Devolutions/doc-gitbook/blob/master/translations/fr/powershell-universal/cmdlets/New-UDTextbox.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/textbox.md?ask=<question>
```

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.