RecyclerView مكوّن Android لعرض قوائم قابلة للتمرير مع إعادة استخدام واجهات العناصر. تحتاج إلى بيانات وملف XML للعنصر وAdapter وViewHolder وLayoutManager. هذا الدرس نقطة البداية قبل القوائم الأفقية والشبكات والنقر ونقل البيانات.
الأجزاء الأساسية ودور كل منها
LayoutManager يحدد ترتيب العناصر واتجاهها، وAdapter يربط البيانات بالواجهة، وViewHolder يحتفظ بمراجع Views الخاصة بالبطاقة. onCreateViewHolder ينشئ View عند الحاجة وonBindViewHolder يعيد تعبئتها ببيانات عنصر. getItemCount يجب أن يعكس العدد الحقيقي؛ إرجاع صفر يعني عدم وجود عناصر للعرض.
الاعتماد والتخطيط وترتيب التهيئة
أضف اعتماد androidx.recyclerview المتوافق مع compileSdk وإعدادات مشروعك حسب صفحة إصدارات AndroidX؛ الإصدار 1.1.0 في المثال التاريخي ليس ادعاء بأنه الأحدث. جهز البيانات ثم Adapter واربط LayoutManager. إذا أضفت البيانات بعد تركيب Adapter فأرسل إشعار التغيير المناسب أو استخدم submitList مع ListAdapter.
تشخيص القائمة الفارغة وصحة إعادة التدوير
راجع تطابق ids وR.layout وأسماء نماذج البيانات بدل نسخ حزمة مشروع آخر. داخل Activity استخدم السياق المناسب، وفي Fragment جهز القائمة بعد إنشاء View. اختبر قائمة فارغة وعنصرًا واحدًا وقائمة طويلة. في كل ربط أعد ضبط النص والصورة والخلفية وحالة الظهور، ولا تخف خطأ موضع النقر بإضافة SuppressLint بدل معالجة الموضع الحالي.
للمتابعة: عرض القائمة أفقيًا، ثم Grid وStaggered Grid.
شرح كيفية عمل recyclerview داخل الاندرويد ستوديو بسهولة
عن الاندرويد ستوديو
تاريخ الاندرويد ستوديو
طريقة اضافة مكتبة ريسايكلر فيو – recyclerview
اولا توجة الى ملف build.gradle وابحث عن dependencies { وقم بإضافة الكود التالي أسفلة مباشرة
implementation 'androidx.recyclerview:recyclerview:1.1.0'طريقة عمل recyclerview بالاندرويد ستوديو
○ هذة الاكواد معتمدة على اكواد الكارد فيو التي قد سبق وان شرحناها ○
كود xml الخاص بالـ recyclerview
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/recler_eqtnasa"
tools:listitem="@layout/activity_cardhekma"
android:layout_width="match_parent"
android:layout_height="wrap_content" />غير activity_cardhekma بإسم الكارد فيو الذي قمت بعملة
PersonAdaptoreqrbas personAdapterr;
RecyclerView recyclerView;
ArrayList<Personeqtbasa> per = new ArrayList<>();اسفل
titale = findViewById(R.id.eqtbs);
image = findViewById(R.id.image_eqtbas);
personAdapterr = new PersonAdaptoreqrbas(per, this);
recyclerView = findViewById(R.id.recler_eqtnasa);
recyclerView.setLayoutManager(new LinearLayoutManager(this));
recyclerView.setAdapter(personAdapterr);
per.add(new Personeqtbasa(""));
import android.annotation.SuppressLint;
import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.Filter;
import android.widget.Filterable;
import android.widget.ImageView;
import android.widget.LinearLayout;
import android.widget.TextView;
import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;
import java.util.ArrayList;
import java.util.List;
public class PersonAdaptoreqrbas extends RecyclerView.Adapter<PersonAdaptoreqrbas.Holder> implements Filterable {
ArrayList<Personeqtbasa> personal;
Context context;
class Holder extends RecyclerView.ViewHolder {
TextView titale;
ImageView image;
LinearLayout linearLayout;
public Holder(@NonNull View itemView) {
super(itemView);
titale=itemView.findViewById(R.id.eqtbs);
image=itemView.findViewById(R.id.image_eqtbas);
linearLayout=itemView.findViewById(R.id.lenyereqtbs);
}
}
public PersonAdaptoreqrbas(ArrayList<Personeqtbasa> pesonal, Context context) {
this.personal = pesonal;
this.context = context;
}
@NonNull
@Override
public Holder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
View view = LayoutInflater.from(context).inflate(R.layout.activity_cardhekma,parent,false);
return new Holder(view);
}
@SuppressLint("ResourceAsColor")
@Override
public void onBindViewHolder(@NonNull final Holder holder, final int position) {
final Personeqtbasa person = personal.get(position);
holder.titale.setText(person.getTitale());
if (position %10 == 0) {
holder.linearLayout.setBackgroundResource(R.drawable.card_style_blue);
holder.image.setImageResource(R.drawable.t_hands);
}
else if (position %9 == 0) {
holder.linearLayout.setBackgroundResource(R.drawable.cars_style_cyam);
holder.image.setImageResource(R.drawable.t_love);
}
else if (position %8 == 0) {
holder.linearLayout.setBackgroundResource(R.drawable.card_style_ver);
holder.image.setImageResource(R.drawable.t_bbt);
}
else if (position %7 == 0) {
holder.linearLayout.setBackgroundResource(R.drawable.card_style_d3d3d3);
holder.image.setImageResource(R.drawable.t_talk);
}
else if (position %6 == 0) {
holder.linearLayout.setBackgroundResource(R.drawable.card_style_jook);
holder.image.setImageResource(R.drawable.t_smiley);
}
else if (position %5 == 0) {
holder.linearLayout.setBackgroundResource(R.drawable.caed_style_green);
holder.image.setImageResource(R.drawable.t_peace);
}
else if (position %4 == 0) {
holder.linearLayout.setBackgroundResource(R.drawable.card_style_mive);
holder.image.setImageResource(R.drawable.t_heart);
}
else if (position %3 == 0) {
holder.linearLayout.setBackgroundResource(R.drawable.card_style_b3b3b3);
holder.image.setImageResource(R.drawable.t_handshake);
}
else if (position %2 == 0) {
holder.linearLayout.setBackgroundResource(R.drawable.card_style_f3f3f3);
holder.image.setImageResource(R.drawable.t_handshake);
}
}
@Override
public int getItemCount() {
return personal.size();
}
}ادبتر لعمل صوتيات
package com.example.tafaol;
import android.content.Context;
import android.graphics.Color;
import android.media.MediaPlayer;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.LinearLayout;
import android.widget.TextView;
import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;
import com.ohoussein.playpause.PlayPauseView;
import java.util.ArrayList;
public class PersonAdaptormusic extends RecyclerView.Adapter<PersonAdaptormusic.Holder> {
ArrayList<Personmusic> personal;
Context context;
MediaPlayer mediaPlayer;
boolean var ;
class Holder extends RecyclerView.ViewHolder {
TextView tital;
PlayPauseView song;
LinearLayout linearLayout;
public Holder(@NonNull View itemView) {
super(itemView);
song=itemView.findViewById(R.id.play_pause_view);
tital=itemView.findViewById(R.id.titale);
linearLayout=itemView.findViewById(R.id.lenyer);
}
}
public PersonAdaptormusic(ArrayList<Personmusic> pesonal, Context context) {
this.personal = pesonal;
this.context = context;
}
@NonNull
@Override
public Holder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
View view = LayoutInflater.from(context).inflate(R.layout.activity_soung,parent,false);
return new Holder(view);
}
@Override
public void onBindViewHolder(@NonNull final Holder holder, final int position) {
final Personmusic person = personal.get(position);
holder.tital.setText(person.getTitale());
holder.song.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
if (var==false) {
mediaPlayer = MediaPlayer.create(context, person.getMusical());
mediaPlayer.start();
holder.song.toggle();
var=true; }
else if (var==true){
mediaPlayer.pause();
holder.song.toggle();
var=false;
}
mediaPlayer.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
@Override
public void onCompletion(MediaPlayer mediaPlayer) {
holder.song.toggle();
}
});
}}
);
if (position % 2 ==0 ) {
holder.linearLayout.setBackgroundColor(Color.WHITE);
}
}
@Override
public int getItemCount() {
return personal.size();
}
}فيديو الشرح
أسئلة شائعة
ما دور RecyclerView مقابل Adapter؟
RecyclerView يعرض العناصر ويدير إعادة استخدامها بالتعاون مع LayoutManager، وAdapter ينشئ واجهاتها ويربط البيانات بها.
لماذا لا تظهر العناصر؟
ابدأ بفحص البيانات وgetItemCount وLayoutManager وأبعاد XML، ثم اقرأ رسالة الخطأ الفعلية.








