شارك المقالة
شرح RecyclerView في Android Studio باستخدام Java خطوة بخطوة

شرح RecyclerView في Android Studio باستخدام Java خطوة بخطوة

RecyclerView مكوّن Android لعرض قوائم قابلة للتمرير مع إعادة استخدام واجهات العناصر. تحتاج إلى بيانات وملف XML للعنصر وAdapter وViewHolder…

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 بإسم الكارد فيو الذي قمت بعملة

كود java


قم بتعريف الاشياء الموجود في كود الكارد فيو لديك اولا واضف عليها ما تحت //

    TextView titale;
    ImageView image;

//

PersonAdaptoreqrbas personAdapterr;
RecyclerView recyclerView;
ArrayList<Personeqtbasa> per = new ArrayList<>();
 

اسفل 

 

super.onCreate(savedInstanceState);  

 

اكتب 


        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(""));

 


الان يمكنك تكرار الكود per.add(new Personeqtbasa(“”)); كما تريد وكل ما سوف تضعه في هذا الكود سوف ياتيك في الكارد بنفس الخصائص التي قمت بإنشاءة بها

اذا اردت تمرير صور او غيرها يمكنك عمل , بعد “” وكتابة R.drawable.## واستبدل ## بعنوان الصورة 
قم بتغيير النصطلحات السابقة بالمصطلحات التي قمت بتسميتها وإنشائها

الان قم بإنشاء class بإسم Personeqtbasa واكتب بداخلة ( اذا اردت تمرير صور او فيديوهات او صوتيات فجميعها تكون من نوع int )

    String titale;
    int image;

وعمل كلك يمين وعمل لهم getter and setter و Constructor


الخطوة الاخيره وهي انشاء class بإسم PersonAdaptoreqrbas واكتب مثل الموجود في الصورة

بنية Adapter وViewHolder لعرض قائمة بيانات في RecyclerView

تخصيص لون وصورة عنصر القائمة وفقًا لموضعه

إرجاع عدد عناصر البيانات داخل getItemCount

💕 الاكواد الموجودة في الصورة 💕

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();
    }
}


ادبتر لعمل صوتيات


إكمال ربط بيانات العناصر داخل Adapter الخاص بـ RecyclerView

إعداد القيم المعروضة لكل عنصر داخل onBindViewHolder



🌹 الاكواد الموجودة في الصور 🌹

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، ثم اقرأ رسالة الخطأ الفعلية.

دروس مرتبطة

قسم قوائم Android وRecyclerView — المرجع التقني الرسمي

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

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