Tổng quan
GMSAutocompleteTableDataSource cung cấp giao diện cung cấp các dự đoán tự động hoàn thành địa điểm nhằm điền sẵn UITableView bằng cách triển khai các giao thức UITableViewDataSource và UITableViewDelegate.
GMSAutocompleteTableDataSource được thiết kế để dùng làm nguồn dữ liệu cho UISearchDisplayController.
- Lưu ý:
- Kể từ iOS 8, UISearchDisplayController đã không còn được dùng nữa. Hiện tại, bạn nên sử dụng UISearchController với
GMSAutocompleteResultsViewControllerđể cho thấy kết quả tự động hoàn thành bằng giao diện người dùng tìm kiếm trên iOS.
Đặt một thực thể của GMSAutocompleteTableDataSource làm thuộc tính searchResultsDataSource và searchResultsDelegate của UISearchDisplayController. Trong quá trình triển khai shouldReloadTableForSearchString, hãy gọi sourceTextHasChanged bằng chuỗi tìm kiếm hiện tại.
Sử dụng giao thức uỷ quyền GMSAutocompleteTableDataSourceDelegate để nhận thông báo khi một địa điểm được chọn từ danh sách. Vì các cụm từ gợi ý tự động hoàn thành sẽ tải không đồng bộ, nên bạn cần phải triển khai các wasUpdateAutoProions và gọi loadingData trên chế độ xem theo bảng của UISearchDisplayController.
Hàm thành viên công khai | |
| (instancetype) | – init |
| Khởi động một nguồn dữ liệu. | |
| (void) | – sourceTextHasChanged: |
| Thông báo cho nguồn dữ liệu rằng văn bản nguồn cho tính năng tự động hoàn thành đã thay đổi. | |
| (void) | – clearResults |
| Xóa tất cả gợi ý. | |
Thuộc tính | |
| Mã IBOutlet < GMSAutocompleteTableDataSourceDelegate > | uỷ quyền |
| Người được uỷ quyền nhận thông báo khi một địa điểm được chọn hoặc hoạt động chọn bị huỷ. | |
| GMSAutocompleteFilter * | autocompleteFilter |
| Lọc để áp dụng cho các đề xuất tự động hoàn thành (có thể bằng không). | |
| UIColor * | tableCellBackgroundColor |
| Màu nền của các ô trong bảng. | |
| UIColor * | tableCellSeparatorColor |
| Màu của dòng phân tách giữa các ô trong bảng. | |
| UIColor * | primaryTextColor |
| Màu của văn bản tên kết quả trong kết quả tự động hoàn thành. | |
| UIColor * | primaryTextHighlightColor |
| Màu sắc dùng để đánh dấu văn bản trùng khớp trong kết quả tự động hoàn thành. | |
| UIColor * | secondaryTextColor |
| Màu của hàng văn bản thứ hai trong kết quả tự động hoàn thành. | |
| UIColor * | tintColor |
| Màu phủ được áp dụng cho các chế độ điều khiển trong chế độ xem Tự động hoàn thành. | |
| GMSPlaceField | placeFields |
GMSPlaceField để chỉ định thông tin chi tiết rõ ràng về địa điểm sẽ được yêu cầu. | |
| NSArray< GMSPlaceProperty > * | placeProperties |
GMSPlaceProperty để chỉ định thông tin chi tiết rõ ràng về địa điểm sẽ được yêu cầu. | |
Tài liệu về hàm thành phần
| – (instancetype) init |
Khởi động một nguồn dữ liệu.
| – (vô hiệu) sourceTextHasChanged: | (nullable NSString *) | văn bản |
Thông báo cho nguồn dữ liệu rằng văn bản nguồn cho tính năng tự động hoàn thành đã thay đổi.
Bạn chỉ nên gọi phương thức này từ luồng chính. Việc gọi phương thức này từ một chuỗi khác sẽ dẫn đến hành vi không xác định. Các lệnh gọi đến phương thức GMSAutocompleteTableDataSourceDelegate cũng sẽ được gọi trên luồng chính.
Phương thức này không chặn.
- Các tham số:
-
văn bản Văn bản một phần cần tự động hoàn thành.
| – (vô hiệu) clearResults |
Xóa tất cả gợi ý.
- Lưu ý:
- Thao tác này sẽ gọi hai phương thức uỷ quyền ở bên dưới:
didUpdateAutocompletePredictionsForResultsController:didRequestAutocompletePredictionsForResultsController:
Việc triển khai phương thức này đảm bảo sẽ gọi các phương thức này một cách đồng bộ và theo thứ tự.
Tài liệu về tài sản
- (Id IBOutlet<GMSAutocompleteTableDataSourceDelegate>) uỷ quyền [read, write, assign] |
Người được uỷ quyền nhận thông báo khi một địa điểm được chọn hoặc hoạt động chọn bị huỷ.
– (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
Lọc để áp dụng cho các đề xuất tự động hoàn thành (có thể bằng không).
– (UIColor*) tableCellBackgroundColor [read, write, assign] |
Màu nền của các ô trong bảng.
– (UIColor*) tableCellSeparatorColor [read, write, assign] |
Màu của dòng phân tách giữa các ô trong bảng.
– (UIColor*) primaryTextColor [read, write, assign] |
Màu của văn bản tên kết quả trong kết quả tự động hoàn thành.
– (UIColor*) primaryTextHighlightColor [read, write, assign] |
Màu sắc dùng để đánh dấu văn bản trùng khớp trong kết quả tự động hoàn thành.
– (UIColor*) secondaryTextColor [read, write, assign] |
Màu của hàng văn bản thứ hai trong kết quả tự động hoàn thành.
– (UIColor*) tintColor [read, write, assign] |
Màu phủ được áp dụng cho các chế độ điều khiển trong chế độ xem Tự động hoàn thành.
– (GMSPlaceField) placeFields [read, write, assign] |
GMSPlaceField để chỉ định thông tin chi tiết rõ ràng về địa điểm sẽ được yêu cầu.
Giá trị mặc định trả về tất cả các trường có sẵn.
– (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign] |
GMSPlaceProperty để chỉ định thông tin chi tiết rõ ràng về địa điểm sẽ được yêu cầu.
Chế độ mặc định sẽ trả về tất cả các cơ sở lưu trú hiện có.