Descripción general
GMSAutocompleteTableDataSource proporciona una interfaz para proporcionar predicciones de autocompletado de lugares para propagar una UITableView mediante la implementación de los protocolos UITableViewDataSource y UITableViewDelegate.
GMSAutocompleteTableDataSource está diseñado para usarse como la fuente de datos de un UISearchDisplayController.
- Nota:
- UISearchDisplayController dejó de estar disponible en iOS 8. Ahora se recomienda usar UISearchController con
GMSAutocompleteResultsViewControllerpara mostrar los resultados de autocompletado con la IU de búsqueda de iOS.
Configura una instancia de GMSAutocompleteTableDataSource como las propiedades searchResultsDataSource y searchResultsDelegate de UISearchDisplayController. En tu implementación de shouldReloadTableForSearchString, llama a sourceTextHasChanged con la cadena de búsqueda actual.
Usa el protocolo de delegado GMSAutocompleteTableDataSourceDelegate para recibir una notificación cuando se seleccione un lugar de la lista. Dado que las predicciones de autocompletado se cargan de forma asíncrona, es necesario implementar didUpdateAutocompletePredictions y llamar a reloadData en la vista de tabla UISearchDisplayController.
Funciones públicas de miembro | |
| (tipo de instancia) | - init |
| Inicializa una fuente de datos. | |
| (void) | - sourceTextHasChanged: |
| Notifica a la fuente de datos que el texto de origen que se va a autocompletar se modificó. | |
| (void) | - clearResults |
| Borra todas las predicciones. | |
Propiedades | |
| ID de IBOutlet < GMSAutocompleteTableDataSourceDelegate > | delegado |
| Delegar para recibir una notificación cuando se seleccione un lugar o se cancele la selección. | |
| GMSAutocompleteFilter * | autocompleteFilter |
| Filtro que se aplicará a las sugerencias de autocompletar (puede ser nulo). | |
| UIColor * | tableCellBackgroundColor |
| Es el color de fondo de las celdas de la tabla. | |
| UIColor * | tableCellSeparatorColor |
| El color de la línea de separador entre las celdas de la tabla. | |
| UIColor * | primaryTextColor |
| El color del texto del nombre de los resultados en los resultados de autocompletado. | |
| UIColor * | primaryTextHighlightColor |
| El color que se utiliza para resaltar el texto coincidente en los resultados de autocompletado. | |
| UIColor * | secondaryTextColor |
| El color de la segunda fila de texto en los resultados de autocompletado. | |
| UIColor * | tintColor |
| El color del tono aplicado a los controles en la vista Autocomplete. | |
| GMSPlaceField | placeFields |
El GMSPlaceField para especificar los detalles explícitos del lugar que se solicitarán. | |
| NSArray< GMSPlaceProperty > * | placeProperties |
El GMSPlaceProperty para especificar los detalles explícitos del lugar que se solicitarán. | |
Documentación sobre la función del miembro
| - (tipo de instancia) init |
Inicializa una fuente de datos.
| - (void) sourceTextHasChanged: | (nullable NSString *) | texto |
Notifica a la fuente de datos que el texto de origen que se va a autocompletar se modificó.
Solo se debe llamar a este método desde el subproceso principal. La llamada a este método desde otro subproceso dará como resultado un comportamiento indefinido. Las llamadas a los métodos GMSAutocompleteTableDataSourceDelegate también se llamarán en el subproceso principal.
Este método no genera bloqueos.
- Parámetros:
-
text Texto parcial para autocompletar
| - (void) clearResults |
Borra todas las predicciones.
- Nota:
- Esta acción llamará a los dos métodos delegados que se muestran a continuación:
didUpdateAutocompletePredictionsForResultsController:didRequestAutocompletePredictionsForResultsController:
La implementación de este método garantiza que las llamadas se realicen de forma síncrona y en orden.
Documentación de la propiedad
- (ID de IBOutlet<GMSAutocompleteTableDataSourceDelegate>) delegado [read, write, assign] |
Delegar para recibir una notificación cuando se seleccione un lugar o se cancele la selección.
- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
Filtro que se aplicará a las sugerencias de autocompletar (puede ser nulo).
- (UIColor*) tableCellBackgroundColor [read, write, assign] |
Es el color de fondo de las celdas de la tabla.
- (UIColor*) tableCellSeparatorColor [read, write, assign] |
El color de la línea de separador entre las celdas de la tabla.
- (UIColor*) primaryTextColor [read, write, assign] |
El color del texto del nombre de los resultados en los resultados de autocompletado.
- (UIColor*) primaryTextHighlightColor [read, write, assign] |
El color que se utiliza para resaltar el texto coincidente en los resultados de autocompletado.
- (UIColor*) secondaryTextColor [read, write, assign] |
El color de la segunda fila de texto en los resultados de autocompletado.
- (UIColor*) tintColor [read, write, assign] |
El color del tono aplicado a los controles en la vista Autocomplete.
- (GMSPlaceField) placeFields [read, write, assign] |
El GMSPlaceField para especificar los detalles explícitos del lugar que se solicitarán.
La opción predeterminada muestra todos los campos disponibles.
- (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign] |
El GMSPlaceProperty para especificar los detalles explícitos del lugar que se solicitarán.
La opción predeterminada muestra todas las propiedades disponibles.