Présentation
GMSAutocompleteTableDataSource fournit une interface permettant de générer des prédictions de saisie semi-automatique de lieux afin de renseigner un UITableView en implémentant les protocoles UITableViewDataSource et UITableViewDelegate.
GMSAutocompleteTableDataSource est conçu pour être utilisé comme source de données pour un UISearchDisplayController.
- Remarque :
- UISearchDisplayController est obsolète depuis iOS 8. Il est maintenant 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 searchResultsDelegate 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 notifié lorsqu'un lieu est sélectionné dans la liste. Étant donné que les prédictions de la saisie semi-automatique se chargent de manière asynchrone, vous devez implémenter didUpdateAutocompletePredictions et appeler refreshData dans la vue de la table UISearchDisplayController.
Fonctions publiques des membres | |
(type d'instance) | - init |
Initialise une source de données. | |
(void) | - sourceTextHasChanged: |
Indique à la source de données que le texte source de la saisie semi-automatique a été modifié. | |
(void) | - clearResults |
Effacer toutes les prédictions. | |
Propriétés | |
ID IBOutlet < GMSAutocompleteTableDataSourceDelegate > | délégué |
Déléguer à une notification qui sera envoyée 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 du nom des résultats de la saisie semi-automatique. | |
UIColor * | primaryTexthighlightColor |
Couleur de mise en surbrillance du 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 |
Teinte appliquée aux commandes de la vue Saisie semi-automatique | |
GMSPlaceField | placeFields |
GMSPlaceField pour spécifier des détails de lieu explicites à demander. |
Documentation sur la fonction de membre
- (instancetype) init |
Initialise une source de données.
- (void) sourceTextHasChanged: | (null NSString *) | texte |
Indique à 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. Si vous appelez cette méthode à partir d'un autre thread, le comportement sera 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 à saisir automatiquement.
- (void) clearResults |
Effacer toutes les prédictions.
- Remarque :
- Cela appelle les deux méthodes de délégué ci-dessous :
didUpdateAutocompletePredictionsForResultsController:
didRequestAutocompletePredictionsForResultsController:
La mise en œuvre de cette méthode les garantira de manière synchrone et dans l'ordre.
Documentation sur la propriété
- (ID IBOutlet<GMSAutocompleteTableDataSourceDelegate>) délégués [read, write, assign] |
Déléguer à une notification qui sera envoyée 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 du nom des résultats de la saisie semi-automatique.
- (UIColor*) primaryTextHIGHLIGHTColor [read, write, assign] |
Couleur de mise en surbrillance du 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] |
Teinte appliquée aux commandes de la vue Saisie semi-automatique
- (GMSPlaceField) placeFields [read, write, assign] |
GMSPlaceField
pour spécifier des détails de lieu explicites à demander.
La valeur par défaut renvoie tous les champs disponibles.