نظرة عامة
توفر GMSAutocompleteTableDataSource واجهة لتوفير تنبؤات الإكمال التلقائي للأماكن من أجل تعبئة UITableView من خلال تنفيذ بروتوكولَي UITableViewDataSource وUITableViewDelegate.
تم تصميم دالة GMSAutocompleteTableDataSource للاستخدام كمصدر بيانات في UISearchDisplayController.
- ملاحظة:
- تم إيقاف واجهة برمجة التطبيقات UISearchDisplayController نهائيًا منذ نظام iOS 8. ننصح الآن باستخدام واجهة برمجة التطبيقات UISearchController مع
GMSAutocompleteResultsViewController
لعرض نتائج الإكمال التلقائي باستخدام واجهة مستخدم البحث في نظام التشغيل iOS.
اضبط مثيلاً من GMSAutocompleteTableDataSource كسمتَين searchResultsDataSource وsearchResultsDelegate في UISearchDisplayController. أثناء تنفيذ shouldReloadTableForSearchString، استدعِ sourceTextHasChanged باستخدام سلسلة البحث الحالية.
استخدِم بروتوكول تفويض GMSAutocompleteTableDataSourceDelegate
لتلقّي إشعار عند اختيار مكان من القائمة. نظرًا لأنه يتم تحميل توقعات الإكمال التلقائي بشكل غير متزامن، فمن الضروري تنفيذ doUpdateAutocompleteApplyions وتقرير بيانات إعادة تحميل المكالمات في عرض الجدول في UISearchDisplayController.
وظائف الأعضاء العامة | |
(instancetype) | - init |
تعمل على إعداد مصدر البيانات. | |
(void) | - sourceTextHasChanged: |
إعلام مصدر البيانات بأنه تم تغيير نص المصدر المطلوب إكماله تلقائيًا. | |
(void) | - clearResults |
محو جميع التوقعات. | |
المواقع | |
معرّف IBOutlet < GMSAutocompleteTableDataSourceDelegate > | تفويض |
تفويض ليتم إرسال إشعار إليه عند اختيار مكان أو عند إلغاء عملية الاختيار. | |
GMSAutocompleteFilter * | autocompleteFilter |
الفلترة لتطبيقه على اقتراحات الإكمال التلقائي (يمكن أن تكون قيمة فارغة). | |
لون واجهة المستخدم * | tableCellBackgroundColor |
لون خلفية خلايا الجدول | |
لون واجهة المستخدم * | tableCellSeparatorColor |
لون الخط الفاصل بين خلايا الجدول. | |
لون واجهة المستخدم * | primaryTextColor |
لون نص اسم النتيجة في نتائج الإكمال التلقائي | |
لون واجهة المستخدم * | primaryTextHighlightColor |
اللون المستخدَم لتمييز النص المطابق في نتائج الإكمال التلقائي. | |
لون واجهة المستخدم * | secondaryTextColor |
لون الصف الثاني من النص في نتائج الإكمال التلقائي | |
لون واجهة المستخدم * | tintColor |
لون اللون الخفيف الذي تم تطبيقه على عناصر التحكّم في عرض الإكمال التلقائي | |
GMSPlaceField | placeFields |
تمثّل هذه السمة GMSPlaceField لتحديد التفاصيل الصريحة للمكان المطلوب طلبه. | |
NSArray< GMSPlaceProperty > * | placeProperties |
تمثّل هذه السمة GMSPlaceProperty لتحديد التفاصيل الصريحة للمكان المطلوب طلبه. |
وثائق وظائف الأعضاء
- (instancetype) init |
تعمل على إعداد مصدر البيانات.
- (إبطال) sourceTextHasChanged: | (nullable NSString *) | نص |
إعلام مصدر البيانات بأنه تم تغيير نص المصدر المطلوب إكماله تلقائيًا.
ويجب استدعاء هذه الطريقة من سلسلة التعليمات الرئيسية فقط. سيؤدي استدعاء هذه الطريقة من سلسلة محادثات أخرى إلى سلوك غير محدّد. سيتم أيضًا استدعاء الطلبات إلى طُرق GMSAutocompleteTableDataSourceDelegate
في سلسلة المحادثات الرئيسية.
لا تؤدي هذه الطريقة إلى الحظر.
- المَعلمات:
-
text النص الجزئي المطلوب إكماله تلقائيًا.
- (إبطال) clearResults |
محو جميع التوقعات.
- ملاحظة:
- سيؤدي هذا الإجراء إلى استدعاء طريقتَي التفويض أدناه:
didUpdateAutocompletePredictionsForResultsController:
didRequestAutocompletePredictionsForResultsController:
ويضمن تطبيق هذه الطريقة استدعاء هذه البيانات بالتزامن والترتيب.
وثائق العقارات
- (IBOutlet id<GMSAutocompleteTableDataSourceDelegate>) تفويض [read, write, assign] |
تفويض ليتم إرسال إشعار إليه عند اختيار مكان أو عند إلغاء عملية الاختيار.
- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign] |
الفلترة لتطبيقه على اقتراحات الإكمال التلقائي (يمكن أن تكون قيمة فارغة).
- (UIColor*) tableCellBackgroundColor [read, write, assign] |
لون خلفية خلايا الجدول
- (UIColor*) tableCellSeparatorColor [read, write, assign] |
لون الخط الفاصل بين خلايا الجدول.
- (UIColor*) primaryTextColor [read, write, assign] |
لون نص اسم النتيجة في نتائج الإكمال التلقائي
- (UIColor*) primaryTextHighlightColor [read, write, assign] |
اللون المستخدَم لتمييز النص المطابق في نتائج الإكمال التلقائي.
- (UIColor*) secondaryTextColor [read, write, assign] |
لون الصف الثاني من النص في نتائج الإكمال التلقائي
- (UIColor*) tintColor [read, write, assign] |
لون اللون الخفيف الذي تم تطبيقه على عناصر التحكّم في عرض الإكمال التلقائي
- (GMSPlaceField) placeFields [read, write, assign] |
تمثّل هذه السمة GMSPlaceField
لتحديد التفاصيل الصريحة للمكان المطلوب طلبه.
يتم تلقائيًا عرض جميع الحقول المتاحة.
- (NSArray<GMSPlaceProperty>*) placeProperties [read, write, assign] |
تمثّل هذه السمة GMSPlaceProperty
لتحديد التفاصيل الصريحة للمكان المطلوب طلبه.
يتم عرض جميع السمات المتاحة بشكل تلقائي.