Présentation
L'interface GMSAutocompleteTableDataSource fournit des prédictions de saisie semi-automatique de lieu pour renseigner un élément UITableView. Pour ce faire, implémentez les protocoles UITableViewDataSource et UITableViewMetadata.
GMSAutocompleteTableDataSource est conçu pour être utilisé comme source de données d'un UISearchDisplayController.
- Remarque :
- UISearchDisplayController est obsolète depuis iOS 8. Il est désormais recommandé d'utiliser UISearchController avec
GMSAutocompleteResultsViewController
pour afficher les résultats de la saisie semi-automatique à l'aide de l'UI de recherche iOS.
Définissez une instance de GMSAutocompleteTableDataSource en tant que propriétés searchResultsDataSource et searchResultsMetadata de UISearchDisplayController. Dans votre implémentation de shouldReloadTableForSearchString, appelez sourceTextHasChanged avec la chaîne de recherche actuelle.
Utilisez le protocole de délégation GMSAutocompleteTableDataSourceDelegate
pour être averti lorsqu'un lieu est sélectionné dans la liste. Étant donné que les prédictions de saisie semi-automatique se chargent de manière asynchrone, il est nécessaire d'implémenter didUpdateAutocompletePredictions et d'appeler reloadData dans la vue de table de UISearchDisplayController.
Fonctions de membre public | |
(type d'instance) | - init |
Initialise une source de données. | |
(void) | - sourceTextHasChanged: |
Informe la source de données que le texte source de la saisie semi-automatique a été modifié. | |
(void) | – clearResults |
Effacez toutes les prédictions. | |
Propriétés | |
ID IBOutlet < GMSAutocompleteTableDataSourceDelegate > | délégué |
Déléguez pour être averti lorsqu'un lieu est sélectionné ou que la sélection est annulée. | |
GMSAutocompleteFilter * | autocompleteFilter |
Filtre à appliquer aux suggestions de saisie semi-automatique (peut être nul). | |
UIColor * | tableCellBackgroundColor |
Couleur d'arrière-plan des cellules du tableau. | |
UIColor * | tableCellSeparatorColor |
Couleur de la ligne de séparation entre les cellules du tableau. | |
UIColor * | primaryTextColor |
Couleur du texte saisi dans le nom du résultat dans les résultats de saisie semi-automatique. | |
UIColor * | primaryTextHighlightColor |
Couleur utilisée pour mettre en surbrillance le texte correspondant dans les résultats de la saisie semi-automatique. | |
UIColor * | secondaryTextColor |
Couleur de la deuxième ligne de texte dans les résultats de la saisie semi-automatique. | |
UIColor * | tintColor |
Couleur de teinte appliquée aux commandes de la vue de saisie semi-automatique. | |
GMSPlaceField | placeFields |
GMSPlaceField permettant de spécifier des détails explicites sur le lieu à demander. | |
NSArray< GMSPlaceProperty > * | placeProperties |
GMSPlaceProperty permettant de spécifier des détails explicites sur le lieu à demander. |
Documentation sur les fonctions de membre
- (type d'instance) init |
Initialise une source de données.
- (void) sourceTextHasChanged: | (nullable NSString *) | texte |
Informe la source de données que le texte source de la saisie semi-automatique a été modifié.
Cette méthode ne doit être appelée qu'à partir du thread principal. L'appel de cette méthode à partir d'un autre thread entraînera un comportement indéfini. Les appels aux méthodes GMSAutocompleteTableDataSourceDelegate
seront également appelés sur le thread principal.
Cette méthode est non bloquante.
- Paramètres :
-
text Texte partiel à utiliser pour la saisie semi-automatique.
- (void) clearResults |
Effacez toutes les prédictions.
- Remarque :
- Les deux méthodes déléguées ci-dessous seront appelées:
didUpdateAutocompletePredictionsForResultsController:
didRequestAutocompletePredictionsForResultsController:
L'implémentation de cette méthode les appelle de manière synchrone et dans l'ordre.
Documentation sur la propriété
- (ID IBOutlet<GMSAutocompleteTableDataSourceDelegate>) delegate [read, write, assign] |
Déléguez pour être averti lorsqu'un lieu est sélectionné ou que la sélection est annulée.
- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
Filtre à appliquer aux suggestions de saisie semi-automatique (peut être nul).
- (UIColor*) tableCellBackgroundColor [read, write, assign] |
Couleur d'arrière-plan des cellules du tableau.
- (UIColor*) tableCellSeparatorColor [read, write, assign] |
Couleur de la ligne de séparation entre les cellules du tableau.
- (UIColor*) primaryTextColor [read, write, assign] |
Couleur du texte saisi dans le nom du résultat dans les résultats de saisie semi-automatique.
- (UIColor*) primaryTextHighlightColor [read, write, assign] |
Couleur utilisée pour mettre en surbrillance le texte correspondant dans les résultats de la saisie semi-automatique.
- (UIColor*) secondaryTextColor [read, write, assign] |
Couleur de la deuxième ligne de texte dans les résultats de la saisie semi-automatique.
- (UIColor*) tintColor [read, write, assign] |
Couleur de teinte appliquée aux commandes de la vue de saisie semi-automatique.
- (GMSPlaceField) placeFields [read, write, assign] |
GMSPlaceField
permettant de spécifier des détails explicites sur le lieu à demander.
La valeur par défaut renvoie tous les champs disponibles.
- (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign] |
GMSPlaceProperty
permettant de spécifier des détails explicites sur le lieu à demander.
La valeur par défaut renvoie toutes les propriétés disponibles.