87 lines
4.1 KiB
Markdown
87 lines
4.1 KiB
Markdown
|
## Préférer la saisie assistée à l'autocomplétion
|
|||
|
|
|
|||
|
|
### Identifiants
|
|||
|
|
|
|||
|
|
// TODO
|
|||
|
|
|
|||
|
|
### Catégories
|
|||
|
|
|
|||
|
|
| Cycle de vie | Tiers | Responsable |
|
|||
|
|
|:---------:|:----:|:----:|
|
|||
|
|
| 1. Spécification | Utilisateur/Terminal | PO/AMOA |
|
|||
|
|
|
|||
|
|
### Indications
|
|||
|
|
|
|||
|
|
| Degré de priorité | Mise en oeuvre | Impact écologique |
|
|||
|
|
|:-------------------:|:-------------------------:|:---------------------:|
|
|||
|
|
| 3 | 3 | 3 |
|
|||
|
|
|
|||
|
|
|Ressources Economisées |
|
|||
|
|
|:----------------------------------------------------------:|
|
|||
|
|
| Requêtes |
|
|||
|
|
|
|||
|
|
### Description
|
|||
|
|
|
|||
|
|
L'autocomplétion, ou complément automatique est une fonctionnalité très répandue consistant à suggérer à l'utilisateur ou utilisatrice
|
|||
|
|
des résultats correspondant à sa recherche pendant sa saisie. Par exemple, un site permettant de rechercher un itinéraire
|
|||
|
|
va proposer « Paris », « Lyon Part-Dieu » et « Paray le Monial » quand la personne tape « Par ».
|
|||
|
|
|
|||
|
|
L'implémentation de l'autocomplétion consiste à envoyer une requête au serveur à chaque caractère saisi pour récupérer les
|
|||
|
|
résultats correspondants. On peut donc avoir beaucoup de requêtes effectuées et beaucoup de ressources dépensées.
|
|||
|
|
|
|||
|
|
Dans la mesure du possible, cette fonctionnalité est à remplacer par la saisie assistée.
|
|||
|
|
Cela consiste à guider la personne utilisatrice par un ensemble d’informations et d’indices :
|
|||
|
|
- Présentation du format attendu en grisé dans le champ de saisie (`placeholder`)
|
|||
|
|
- Texte expliquant le format attendu
|
|||
|
|
- Réaction de l’interface avec un message d’erreur ou un changement de couleur et aide textuelle lorsque la saisie est incorrecte
|
|||
|
|
- etc.
|
|||
|
|
|
|||
|
|
Les interactions liées à la saisie assistée sont gérées localement, ce qui réduit les échanges avec le serveur.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Pour l'exemple de la recherche d'itinéraire et de la complétion des villes, il est possible, en cas d'ambiguïté, de proposer
|
|||
|
|
les différents résultats après la soumission du formulaire. L'utilisateur entre une chaine de caractère, par exemple « Lens »,
|
|||
|
|
soumet le formulaire, et se voit à ce moment proposées différentes options : « Lens (France) », « Lens (Belgique) »,
|
|||
|
|
« Loison sous Lens ».
|
|||
|
|
|
|||
|
|
Si le recours à l'autocomplétion ne peut pas être évité il est possible de minimiser le nombre de requêtes avec des optimisations simples :
|
|||
|
|
- Ajouter un délai de quelque dixièmes de secondes entre l'ajout d'un caractère et la requête : cela permet de ne pas déclencher de requête si l'utilisateur n'a pas terminé sa saisie.
|
|||
|
|
- Limiter le nombre de résultats affichés par l'autocomplétion, priorisés par une note de pertinence
|
|||
|
|
- Fixer un nombre de caractères minimal avant de chercher à compléter.
|
|||
|
|
- Si la taille de la base de données le permet, effectuer l'autocomplétion côté client en utilisant un composant natif comme `AutoCompleteTextView`
|
|||
|
|
- Mettre en cache les résultats des recherches avec pour clef la chaîne saisie pour moins solliciter la base de données.
|
|||
|
|
- Contextualiser les résultats pour en limiter le nombre.
|
|||
|
|
|
|||
|
|
### Exemple
|
|||
|
|
|
|||
|
|
Gain potentiel : à chaque fois que l’on utilise la saisie assistée pour une fonctionnalité, plutôt que l’autocomplétion, on réduit le nombre de requêtes associées par un facteur 10.
|
|||
|
|
|
|||
|
|
### Solution alternative
|
|||
|
|
|
|||
|
|
Si la donnée qui est proposée à l'utilisateur est assez petite en quantité, vous pouvez l'inclure directement dans le code de l'application en utilisant le composant natif `AutoCompleteTextView`.
|
|||
|
|
|
|||
|
|
```xml
|
|||
|
|
<AutoCompleteTextView
|
|||
|
|
android:id="@+id/auto_complete_country_text_view"
|
|||
|
|
android:layout_width="match_parent"
|
|||
|
|
android:layout_height="wrap_content"/>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
```kotlin
|
|||
|
|
val COUNTRIES = arrayOf("Belgium", "France", "Italy", "Germany", "Spain")
|
|||
|
|
val countriesAdapter = ArrayAdapter<String>(
|
|||
|
|
this,
|
|||
|
|
R.layout.simple_dropdown_item_1line,
|
|||
|
|
COUNTRIES,
|
|||
|
|
)
|
|||
|
|
binding.autoCompleteCountryTextView.setAdapter(countriesAdapter)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Ce composant proposera nativement, et sans aller/retour avec le serveur, un mécanisme d'autocompletion.
|
|||
|
|
|
|||
|
|
### Principe de validation
|
|||
|
|
|
|||
|
|
| Le nombre ... | est inférieur ou égal à |
|
|||
|
|
|-------------------|:-------------------------:|
|
|||
|
|
| de champs en autocomplétion | 20% |
|