نظرة عامة
توفِّر GMSAutocompleteTableDataSource واجهة لتوفير توقّعات الإكمال التلقائي للأماكن من أجل تعبئة بروتوكول UITableViewDataSource من خلال تنفيذ بروتوكولَي UITableViewDataSource وUITableViewدْ.
تم تصميم مصدر GMSAutocompleteTableDataSource لاستخدامه كمصدر بيانات في UISearchDisplayController.
- ملاحظة:
- تم إيقاف واجهة برمجة التطبيقات UISearchDisplayController نهائيًا منذ نظام التشغيل iOS 8. ننصحك الآن باستخدام واجهة مستخدم UISearchController مع
GMSAutocompleteResultsViewController
لعرض نتائج الإكمال التلقائي باستخدام واجهة مستخدم البحث في نظام التشغيل iOS.
اضبط مثيلاً لـ GMSAutocompleteTableDataSource كخاصيتين searchResultsDataSource وsearchResultsدور لـ UISearchDisplayController. في تنفيذك لـ shouldReloadTableForSearchString، استدعِ sourceTextHasChanged باستخدام سلسلة البحث الحالية.
يمكنك استخدام بروتوكول تفويض GMSAutocompleteTableDataSourceDelegate
لتلقّي إشعار عند اختيار مكان من القائمة. نظرًا لأنه يتم تحميل عبارات البحث المقترحة من خلال ميزة "الإكمال التلقائي" على نحو غير متزامن، يجب تنفيذ الترميز doUpdateAutocompleteForecastions وعملية إعادة تحميل المكالمات في طريقة العرض للجدول في UISearchDisplayController.
وظائف الأعضاء العامين | |
(instancetype) | - init |
يقوم بتهيئة مصدر البيانات. | |
(void) | - sourceTextHasChanged: |
إبلاغ مصدر البيانات بأن النص المصدر المطلوب إكماله تلقائيًا قد تم تغييره. | |
(void) | - clearResults |
محو جميع التوقّعات | |
المواقع | |
معرّف IBOutlet < GMSAutocompleteTableDataSourceDelegate > | تفويض |
تفويض ليتم إرسال إشعار عند اختيار مكان أو عند إلغاء الاختيار. | |
GMSAutocompleteFilter * | autocompleteFilter |
الفلتر المطلوب تطبيقه على اقتراحات الإكمال التلقائي (يمكن أن يكون صفرًا). | |
لون واجهة المستخدم * | tableCellBackgroundColor |
لون خلفية خلايا الجدول. | |
لون واجهة المستخدم * | tableCellSeparatorColor |
لون السطر الفاصل بين خلايا الجدول. | |
لون واجهة المستخدم * | primaryTextColor |
لون نص اسم النتيجة في نتائج الإكمال التلقائي. | |
لون واجهة المستخدم * | primaryTextHighlightColor |
اللون المستخدَم لتمييز النص المطابِق في نتائج الإكمال التلقائي | |
لون واجهة المستخدم * | secondaryTextColor |
لون الصف الثاني من النص في نتائج الإكمال التلقائي | |
لون واجهة المستخدم * | tintColor |
اللون الخفيف الذي تم تطبيقه على عناصر التحكّم في عرض الإكمال التلقائي | |
GMSPlaceField | placeFields |
السمة GMSPlaceField لتحديد التفاصيل الصريحة للمكان المطلوب طلبها. |
وثائق وظائف الأعضاء
- (instancetype) init |
يقوم بتهيئة مصدر البيانات.
- (باطل) sourceTextHasChanged: | (nullable NSString *) | نص |
إبلاغ مصدر البيانات بأن النص المصدر المطلوب إكماله تلقائيًا قد تم تغييره.
يجب طلب هذه الطريقة من سلسلة التعليمات الرئيسية فقط. وسيؤدي استدعاء هذه الطريقة من سلسلة محادثات أخرى إلى سلوك غير معروف. سيتم أيضًا عرض المكالمات الواردة إلى طرق GMSAutocompleteTableDataSourceDelegate
في سلسلة التعليمات الرئيسية.
لا تؤدي هذه الطريقة إلى الحظر.
- المَعلمات:
-
text جزء النص المطلوب إكماله تلقائيًا.
- (باطل) clearResults |
محو جميع التوقّعات
- ملاحظة:
- سيؤدي ذلك إلى استدعاء طريقتَي التفويض أدناه:
didUpdateAutocompletePredictionsForResultsController:
didRequestAutocompletePredictionsForResultsController:
ويضمن تطبيق هذه الطريقة استدعاء هذه العناصر بشكل متزامن وترتيب.
وثائق العقار
- (رقم تعريف IBOutlet<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
لتحديد التفاصيل الصريحة للمكان المطلوب طلبها.
يؤدي الإعداد التلقائي إلى عرض جميع الحقول المتاحة.