> 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/commandes-powershell/new-udautocomplete.md).

# New-UDAutocomplete

New-UDAutocomplete crée un composant de saisie de texte dans PowerShell Universal enrichi d'un panneau filtrable d'options suggérées.

New-UDAutocomplete crée un composant de saisie de texte dans PowerShell Universal enrichi d'un panneau filtrable d'options suggérées.

### Résumé

L'autocomplete est une saisie de texte normale enrichie d'un panneau d'options suggérées.

### Syntaxe

```powershell
New-UDAutocomplete [-Id <String>] [-Label <String>] [-Value <Object>] [-OnChange <Endpoint>] [-Options <Object>] [-FullWidth] [-AutoSelect] [-Variant <String>] [-Multiple] [-ClassName <String>] [-Icon <Object>] [-OnEnter <Endpoint>] [-Disabled] [-Aria <ScriptBlock>] [<CommonParameters>]

New-UDAutocomplete [-Id <String>] [-Label <String>] [-Value <Object>] [-OnChange <Endpoint>] -OnLoadOptions <Endpoint> [-FullWidth] [-AutoSelect] [-Variant <String>] [-Multiple] [-ClassName <String>] [-Icon <Object>] [-OnEnter <Endpoint>] [-Disabled] [-Aria <ScriptBlock>] [<CommonParameters>]
```

### Description

Les zones de texte autocomplete peuvent être utilisées pour permettre à l'utilisateur de faire une sélection dans une grande liste d'éléments statiques ou dynamiques. La saisie dans la zone de texte filtrera la liste.

### Paramètres

#### -Id

L'ID du composant. Par défaut, il s'agit d'un GUID aléatoire.

```
Type                         String
Required?                    false
Position?                    named
Default value                ([Guid]::NewGuid())
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Label

L'étiquette à afficher pour la zone de texte.

```
Type                         String
Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Value

La valeur de la zone de texte.

```
Type                         Object
Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -OnChange

Un bloc de script qui est invoqué lorsque la sélection change.

```
Type                         Endpoint
Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -OnLoadOptions

Un bloc de script qui est appelé lorsque l'utilisateur commence à saisir du texte dans la zone de texte. La variable $Body contiendra le texte saisi. Vous devriez retourner un tableau JSON de valeurs qui sont le résultat de ce que l'utilisateur a saisi.

```
Type                         Endpoint
Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Options

Options statiques à afficher dans la liste déroulante de sélection. Lorsque l'utilisateur saisit du texte, ces options seront filtrées.

```
Type                         Object
Required?                    false
Position?                    named
Default value                @()
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -FullWidth

Indique si le composant doit occuper toute la largeur de son parent.

```
Type                         SwitchParameter
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -AutoSelect

Indique si le composant doit être sélectionné automatiquement s'il n'y avait qu'une seule option au total dans le tableau d'options.

```
Type                         SwitchParameter
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Variant

La variante de la zone de texte. Les valeurs valides sont : « filled », « outlined », « standard »

```
Type                         String
Required?                    false
Position?                    named
Default value                standard
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Multiple

Indique si plusieurs éléments peuvent être sélectionnés.

```
Type                         SwitchParameter
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -ClassName

Une classe CSS à appliquer au composant.

```
Type                         String
Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Icon

L'icône à afficher avant la zone de texte. Utilisez New-UDIcon pour créer la valeur de ce paramètre.

```
Type                         Object
Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -OnEnter

Un bloc de script à appeler lorsque l'utilisateur appuie sur Entrée dans la zone de texte autocomplete.

```
Type                         Endpoint
Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Disabled

Indique si cet autocomplete est désactivé.

```
Type                         SwitchParameter
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Aria

Un bloc de script qui définit les attributs ARIA pour le composant autocomplete.

```
Type                         ScriptBlock
Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### Paramètres communs

Cette applet de commande prend en charge les paramètres communs : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable. Pour plus d'informations, consultez [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

### Sorties

### Exemples

#### Exemple 1 : Autocomplete de base

```powershell
New-UDAutocomplete -Options @('Test', 'Test2', 'Test3', 'Test4') -Id 'autocomplete1' -FullWidth
```

La valeur doit être choisie parmi un ensemble prédéfini de valeurs autorisées.

#### Exemple 2 : Sélections multiples

```powershell
New-UDAutocomplete -Options @("Test", "No", "Yes") -Multiple -Id 'autocomplete2' -FullWidth
```

Permettre à l'utilisateur de sélectionner plusieurs valeurs.

#### Exemple 3 : Variantes

```powershell
New-UDStack -Content {
   New-UDAutocomplete -Options @("Test", "No", "Yes") -Variant 'filled' -Id 'autocomplete3' -FullWidth
   New-UDAutocomplete -Options @("Test", "No", "Yes") -Variant 'outlined' -Id 'autocomplete4' -FullWidth
   New-UDAutocomplete -Options @("Test", "No", "Yes") -Variant 'standard' -Id 'autocomplete5' -FullWidth
} -Direction 'column' -FullWidth
```

Modifier le style de la zone de texte autocomplete.

#### Exemple 4 : Gestion des changements

```powershell
New-UDAutocomplete -Options @("Test", "No", "Yes") -OnChange {
   Show-UDToast $EventData
} -Id 'autocomplete6' -FullWidth
```

Exécuter du PowerShell lorsque l'autocomplete change.

#### Exemple 5 : OnEnter

```powershell
New-UDAutocomplete -Options @("Test", "No", "Yes") -OnEnter {
   Show-UDToast $EventData
} -Id 'autocomplete7' -FullWidth
```

Exécuter du PowerShell lorsque l'utilisateur appuie sur Entrée.

#### Exemple 6 : Options asynchrones

```powershell
New-UDAutocomplete -OnLoadOptions {
  @('Test', 'Test2', 'Test3', 'Test4') | Where-Object { $_ -match $Body } | ConvertTo-Json
} -Id 'autocomplete8' -FullWidth
```

Crée un autocomplete avec un ensemble d'options filtré dynamiquement.

#### Exemple 7 : Options groupées

```powershell
New-UDAutocomplete -Options @(
   New-UDAutocompleteOption -Name 'Test' -Value 'test' -Group 'Group1'
   New-UDAutocompleteOption -Name 'Test2' -Value 'test2' -Group 'Group1'
   New-UDAutocompleteOption -Name 'Test3' -Value 'test3' -Group 'Group2'
   New-UDAutocompleteOption -Name 'Test4' -Value 'test4' -Group 'Group2'
) -Id 'autocomplete9' -FullWidth
```


---

# 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/commandes-powershell/new-udautocomplete.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.