قالب RecyclerView Adapter هو ملف يولّد الهيكل المتكرر للأدابتر داخل Android Studio. يفيد عند إنشاء قوائم متشابهة، لكنه لا يربط البيانات تلقائيًا؛ يجب تخصيص ملف العنصر واسم Binding وتعبئة onBindViewHolder وإرجاع العدد الصحيح.
كيف تنشئ File Template قابلًا للاستخدام؟
افتح Settings ثم Editor ثم File and Code Templates وأضف قالبًا بامتداد java. على macOS قد تظهر الإعدادات باسم Settings أو Preferences وفق الإصدار. استخدم NAME لاسم الصنف وPACKAGE_NAME للحزمة، ومتغيرات مخصصة لملف العنصر وصنف Binding. لا تلصق صيغة القالب مباشرة داخل ملف Java؛ ينفذها محرّك القوالب عند إنشاء الملف.
إصلاح المثال قبل تشغيله
في القالب أدناه أُصلح getItemCount ليعيد list.size بدل صفر. أكمل onBindViewHolder بما يناسب أسماء Views في تصميمك، ولا تتركها فارغة. استبدل com.example.newprojectandroid باسم namespace الفعلي. الكود يستخدم DataBindingUtil، لذلك يتطلب تفعيل dataBinding وتخطيطًا جذره layout، وليس تفعيل viewBinding وحده.
اختبار القالب بعد التوليد
أنشئ ملفًا تجريبيًا من New باستخدام القالب، وراجع imports واسم الصنف وR.layout وصنف Binding. اختبر قائمة فارغة ثم عنصرًا واحدًا وعدة عناصر. إذا بقي متغير بصيغة ${…} في الملف الناتج فراجع تعريفه؛ وإذا لم تظهر العناصر فتأكد من LayoutManager وعدد العناصر وربط النصوص.
للمتابعة العملية، اقرأ شرح RecyclerView من البداية ثم ربط بيانات RecyclerView باستخدام Data Binding؛ اختيار الدرس التالي يعتمد على المرحلة التي وصلت إليها في التطبيق.
خطوات المثال والتصميم
في هذا الدرس سوف نشرح لكم فكرة جديده سوف تسهل عليكم الكثير من الوقت في إنشاء ملف recyclerView خاص بال adapter وذلك سوف يكون عن طريق عمل ملف يمكنك استدعاءه في اي مكان في مشروعك وكل ما سوف تحتاجه هو تغيير الاسماء بالاسماء الجديده الخاصه بمشروعك فقط , الطريقة قد لا يعرفها الكثير منكم ولكنها مهمه جدا وتوفر عليكم الكثير من الوقت في البرمجة وهذا ما دفعنا لكتابة هذه المقالة لكم لكي يستفاد منها الجميع ويطور من نفسه في البرمجة ويتمكن من انجاز الكود الخاص به بشكل اسرع .
إنشاء RecyclerAdapter وتغيير الاسماء من داخله الى $
بعد تصميم ملف الadapter يمكنك تحويلة الى الشكل التالي لكي نتمكن من جعله ملف ولا تقلق من الاخطاء فهذا شيئ طبيعي ${} الاسم الذي بعدها يكون متغير بالنسبة للاسم الذي سوف نضعه لها .
إنشاء ملف يحتوي على بيانات الRecyclerAdapter
في الخطوة الثانيه انتقل الى new ومنها edit file لكي نتمكن من اضافة الملف .
إنشاء file مخصص لاستخدام الrecyclerView دون الحاجه الى كتابها في المرات المقبلة
يمكنك استخدام الكود التالي ولصقه لكي في المكان المخصص كما هو موضح بالصورة .
الكود المستخدم
recycler.java
#if (${PACKAGE_NAME} != "")package ${PACKAGE_NAME}; #end
import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import androidx.annotation.NonNull;
import androidx.databinding.DataBindingUtil;
import androidx.recyclerview.widget.RecyclerView;
import ${APP_NAMESPACE}.R;
import ${APP_NAMESPACE}.databinding.${ITEM_CLASS_NAME};
import java.util.List;
public class ${NAME} extends RecyclerView.Adapter<${NAME}.Holder> {
List<String> list;
Context context;
public ${NAME}(List<String> list, Context context) {
this.list = list;
this.context = context;
}
@NonNull
@Override
public Holder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
return new Holder(DataBindingUtil.inflate(LayoutInflater.from(context), R.layout.${ITEM_NAME} , parent , false));
}
@Override
public void onBindViewHolder(@NonNull Holder holder, int position) {
holder.binding.${TEXT_VIEW_ID}.setText(list.get(position));
}
@Override
public int getItemCount() {
return list == null ? 0 : list.size();
}
public class Holder extends RecyclerView.ViewHolder {
${ITEM_CLASS_NAME} binding;
public Holder(@NonNull ${ITEM_CLASS_NAME} binding) {
super(binding.getRoot());
this.binding = binding;
}
}
}
كيفية استعمال الrecyclerView في المرات المقبلة .
عندما ترغب باستخدام اي ملف منهم يمكنك ذلك من خلال ان تقوم بالنقر right click بالماوس على ال file ومنها تختار الملف الذي قمت بإنشاءه كما هو موضح .
ادخال بيانات الRecyclerView التي تريد انشائها
في المرحلة الاخيره تضع فقط الاسماء الخاصه بالملف كما هو موضح وبهذا تكون انتهيت من تكوين الملف بشكل اسرع بدلا من كتابة الاكواد الخاصه بالكود بشكل كامل في كل مره ترغب بعمل adapter
أسئلة شائعة
هل يعوض القالب فهم RecyclerView؟
لا؛ القالب يختصر كتابة الهيكل فقط. تحتاج إلى فهم Adapter وViewHolder ودورة إعادة ربط العناصر.
لماذا لا تظهر بيانات رغم إنشاء الملف؟
إرجاع صفر في getItemCount أو ترك onBindViewHolder فارغة يمنع عرض البيانات المطلوبة.
دروس RecyclerView المرتبطة
تصفح قسم قوائم Android وRecyclerView
مرجع تقني: توثيق قوالب IntelliJ IDEA المستخدمة في Android Studio.








