شارك المقالة
البحث في Firestore باستخدام Flutter وحدود البحث النصي

البحث في Firestore باستخدام Flutter وحدود البحث النصي

البحث في Firestore باستخدام Flutter عبر كلمات مفهرسة وarrayContains، مع تطبيع النص وتأخير الإدخال وفهم متى تحتاج محرك بحث نصي.

البحث في Firestore باستخدام Flutter عبر كلمات مفهرسة وarrayContains، مع تطبيع النص وتأخير الإدخال وفهم متى تحتاج محرك بحث نصي.

حدد معنى البحث قبل كتابة الاستعلام

البحث بكلمة مساوية لعنصر في مصفوفة يختلف عن البحث بجزء من الكلمة أو ترتيب النتائج حسب الصلة. arrayContains يبحث عن قيمة مطابقة داخل حقل مصفوفة؛ لن يجد كل نص يحتوي كلمة بصورة تلقائية. حدد هل تحتاج وسمًا أو اسمًا يبدأ ببادئة أو بحثًا لغويًا شاملًا. إذا كان المطلوب ترتيب صلة وتصحيح أخطاء ومرادفات، ففكر في محرك بحث مخصص وفق حاجتك بدل تنزيل المجموعة كلها للهاتف.

تهيئة الكلمات عند الكتابة

المثال يعتمد حقل searchTokens يحوي كلمات مطبعة مسبقًا، مثل تحويل الحروف اللاتينية إلى lowercase وحذف المسافات الخارجية. نفذ السياسة نفسها عند الكتابة والبحث، واختر قواعد العربية بعناية؛ حذف التشكيل أو توحيد أشكال الهمزة يغير النتائج ويحتاج قرارًا واختبارات. لا تضف كل احتمالات المقاطع بلا حد داخل المستند، لأن ذلك يزيد حجم البيانات والفهارس وكلفة الصيانة. أبق الوصف الأصلي مستقلًا عن حقول البحث.

لا تطلق طلبًا لكل ضغطة بلا إدارة

أخر البحث مدة قصيرة باستخدام debounce، وتجاوز الإدخال الفارغ. احتفظ برقم للطلب أو النص الذي أرسله حتى لا تستبدل نتيجة جديدة باستجابة قديمة وصلت متأخرة. حدد حجم النتائج وأتح متابعة مناسبة، ولا تمسح النتائج الناجحة قبل أن تعرف هل المطلوب تغييرها. البحث عن اسم شخص أو نص خاص قد يحمل بيانات حساسة؛ لا تضع سجل كل الاستعلامات في Analytics تلقائيًا.

اختبار الجودة وحدود الحل

جرب كلمة موجودة وأخرى غير موجودة واختلاف الأحرف والمسافات والنص العربي. المقطع يعيد قائمة فارغة للإدخال الفارغ، ثم ينفذ بحث الكلمة الكاملة المفهرسة فقط. أخطاء الصلاحية أو الفهرس ينبغي عرضها كخطأ تقني مناسب، لا كرسالة لا توجد نتائج. إذا تغيرت طريقة استخراج الكلمات، حدث بيانات الاختبار والحقول القديمة بخطة واضحة حتى لا يبدو أن بعض المقالات أو المنتجات اختفت من البحث.

المثال التطبيقي وحدوده

أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.

import 'package:cloud_firestore/cloud_firestore.dart';

String normalizeSearchWord(String value) => value.trim().toLowerCase();

Future<List<QueryDocumentSnapshot<Map<String, dynamic>>>> searchProducts(String input) async {
  final word = normalizeSearchWord(input);
  if (word.isEmpty) return [];
  final result = await FirebaseFirestore.instance.collection('products')
      .where('searchTokens', arrayContains: word).limit(20).get();
  return result.docs;
}

الصور والفيديو من الشرح

المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.

How to search in firebase by using flutterStoring data in firebase during the search process

مراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع