RecyclerView ile dinamik listeler oluşturun Android Jetpack'in bir parçasıdır.
RecyclerView, büyük veri kümelerini etkili bir şekilde görüntülemeyi kolaylaştırır. Verileri sağlayıp her bir öğenin nasıl görüneceğini tanımlarsınız. RecyclerView kitaplığı, gerektiğinde öğeleri dinamik olarak oluşturur.
Adından da anlaşılacağı gibi RecyclerView, bu öğeleri geri dönüştürür. RecyclerView, bir öğe ekranın dışına çıktığında görünümünü bozmaz. Bunun yerine, RecyclerView, ekranda kaydırılan yeni öğeler için görünümü yeniden kullanır. RecyclerView, performansı ve uygulamanızın duyarlılığını artırırken güç tüketimini azaltır.
Temel sınıflar
Çeşitli sınıflar, dinamik listenizi oluşturmak için birlikte çalışır.
RecyclerView
, verilerinize karşılık gelen görünümleri içerenViewGroup
öğesidir. Görünüm kendisi olduğu içinRecyclerView
öğesini düzeninize diğer herhangi bir kullanıcı arayüzü öğesi gibi eklersiniz.Listedeki her bir öğe, bir görünüm sahibi nesnesiyle tanımlanır. Görünüm sahibi oluşturulduğunda, bu cihazla ilişkili hiçbir veri olmaz. Görünüm sahibi oluşturulduktan sonra
RecyclerView
bunu kendi verilerine bağlar. Görünüm tutucuyuRecyclerView.ViewHolder
uzantısını genişleterek tanımlarsınız.RecyclerView
, adaptördeki yöntemleri çağırarak görünümler ister ve görünümleri bu verilere bağlar. BağdaştırıcıyıRecyclerView.Adapter
uzantısını genişleterek tanımlarsınız.Düzen yöneticisi, listenizdeki öğeleri ayrı ayrı düzenler. RecyclerView kitaplığı tarafından sağlanan düzen yöneticilerinden birini kullanabilir veya kendi düzen yöneticilerinizi tanımlayabilirsiniz. Düzen yöneticilerinin tümü kitaplığın
LayoutManager
soyut sınıfını temel alır.
Tüm parçaların nasıl bir araya geldiğini RecyclerView örnek uygulaması (Kotlin) veya RecyclerView örnek uygulaması (Java) uygulamasında görebilirsiniz.
RecyclerView'u uygulama adımları
RecyclerView'u kullanacaksanız yapmanız gereken birkaç şey var. Bunlar, aşağıdaki bölümlerde ayrıntılı olarak açıklanmıştır.
Listenin veya ızgaranın nasıl görüneceğine karar verin. Normal olarak, RecyclerView kitaplığının standart düzen yöneticilerinden birini kullanabilirsiniz.
Listedeki her bir öğenin nasıl görüneceğini ve davranacağını tasarlayın. Bu tasarıma göre
ViewHolder
sınıfını genişletin.ViewHolder
sürümünüz, liste öğeleriniz için tüm işlevleri sağlar. Görünüm sahibiniz, birView
için sarmalayıcıdır ve bu görünümRecyclerView
tarafından yönetilir.Verilerinizi
ViewHolder
görünümleriyle ilişkilendirenAdapter
tanımlayın.
Ayrıca RecyclerView'u tam ihtiyaçlarınıza göre uyarlamanıza olanak tanıyan gelişmiş özelleştirme seçenekleri de vardır.
Düzeninizi planlayın
RecyclerView'daki öğeler, LayoutManager
sınıfına göre düzenlenir. RecyclerView kitaplığı, en yaygın düzen durumlarını ele alan üç düzen yöneticisi sağlar:
LinearLayoutManager
, öğeleri tek boyutlu bir listede düzenler.GridLayoutManager
, öğeleri iki boyutlu bir ızgarada düzenler:- Izgara dikey olarak düzenlenirse
GridLayoutManager
, her bir satırdaki tüm öğelerin aynı genişliğe ve yüksekliğe sahip olmasını sağlamaya çalışır ancak farklı satırların yükseklikleri farklı olabilir. - Izgara yatay olarak düzenlenirse
GridLayoutManager
, her sütundaki tüm öğelerin aynı genişliğe ve yüksekliğe sahip olmasını sağlamaya çalışır ancak farklı sütunlar farklı genişliklere sahip olabilir.
- Izgara dikey olarak düzenlenirse
StaggeredGridLayoutManager
,GridLayoutManager
işlevine benzer ancak bir satırdaki öğelerin aynı yüksekliğe sahip olmasını (dikey ızgaralar için) veya aynı sütundaki öğelerin aynı genişliğe (yatay ızgaralar için) sahip olmasını gerektirmez. Sonuç olarak bir satır veya sütundaki öğelerin birbirinden uzaklığı olabilir.
Ayrıca, tek tek öğelerin düzenini de tasarlamanız gerekir. Sonraki bölümde açıklandığı gibi, görünüm tutucuyu tasarlarken bu düzene ihtiyacınız vardır.
Bağdaştırıcınızı ve görünüm tutucuyu takma
Düzeninizi belirledikten sonra Adapter
ve ViewHolder
uygulamanız gerekir. Bu iki sınıf, verilerinizin nasıl görüntüleneceğini tanımlamak için birlikte çalışır. ViewHolder
, listedeki tek bir öğenin düzenini içeren bir View
öğesinin etrafında yer alan sarmalayıcıdır. Adapter
, gerektiğinde ViewHolder
nesne oluşturur ve bu görünümlerin verilerini de ayarlar. Görünümleri kendi verileriyle ilişkilendirme sürecine bağlama adı verilir.
Bağdaştırıcınızı tanımladığınızda üç temel yöntemi geçersiz kılarsınız:
onCreateViewHolder()
:RecyclerView
, yeni birViewHolder
oluşturması gerektiğinde bu yöntemi çağırır. Yöntem,ViewHolder
ve ilişkiliView
öğesini oluşturup başlatır ancak görünümün içeriklerini doldurmaz.ViewHolder
henüz belirli verilere bağlanmamıştır.onBindViewHolder()
:RecyclerView
, birViewHolder
öğesini verilerle ilişkilendirmek için bu yöntemi çağırır. Yöntem, uygun verileri getirir ve görünüm sahibinin düzenini doldurmak için verileri kullanır. Örneğin,RecyclerView
bir ad listesi görüntülüyorsa yöntem, listede uygun adı bulabilir ve görünüm sahibininTextView
widget'ını doldurabilir.getItemCount()
:RecyclerView
, veri kümesinin boyutunu almak için bu yöntemi çağırır. Örneğin, bir adres defteri uygulamasında bu toplam adres sayısı olabilir. RecyclerView, gösterilebilecek başka öğe kalmadığında bunu kullanır.
Bir veri listesi gösteren iç içe yerleştirilmiş bir ViewHolder
içeren basit bir bağdaştırıcı örneğini burada bulabilirsiniz. Bu durumda RecyclerView, metin öğelerinden oluşan basit bir liste gösterir. Bağdaştırıcıya, ViewHolder
öğelerinin metnini içeren bir dize dizisi aktarılır.
Kotlin
class CustomAdapter(private val dataSet: Array<String>) : RecyclerView.Adapter<CustomAdapter.ViewHolder>() { /** * Provide a reference to the type of views that you are using * (custom ViewHolder) */ class ViewHolder(view: View) : RecyclerView.ViewHolder(view) { val textView: TextView init { // Define click listener for the ViewHolder's View textView = view.findViewById(R.id.textView) } } // Create new views (invoked by the layout manager) override fun onCreateViewHolder(viewGroup: ViewGroup, viewType: Int): ViewHolder { // Create a new view, which defines the UI of the list item val view = LayoutInflater.from(viewGroup.context) .inflate(R.layout.text_row_item, viewGroup, false) return ViewHolder(view) } // Replace the contents of a view (invoked by the layout manager) override fun onBindViewHolder(viewHolder: ViewHolder, position: Int) { // Get element from your dataset at this position and replace the // contents of the view with that element viewHolder.textView.text = dataSet[position] } // Return the size of your dataset (invoked by the layout manager) override fun getItemCount() = dataSet.size }
Java
public class CustomAdapter extends RecyclerView.Adapter<CustomAdapter.ViewHolder> { private String[] localDataSet; /** * Provide a reference to the type of views that you are using * (custom ViewHolder) */ public static class ViewHolder extends RecyclerView.ViewHolder { private final TextView textView; public ViewHolder(View view) { super(view); // Define click listener for the ViewHolder's View textView = (TextView) view.findViewById(R.id.textView); } public TextView getTextView() { return textView; } } /** * Initialize the dataset of the Adapter * * @param dataSet String[] containing the data to populate views to be used * by RecyclerView */ public CustomAdapter(String[] dataSet) { localDataSet = dataSet; } // Create new views (invoked by the layout manager) @Override public ViewHolder onCreateViewHolder(ViewGroup viewGroup, int viewType) { // Create a new view, which defines the UI of the list item View view = LayoutInflater.from(viewGroup.getContext()) .inflate(R.layout.text_row_item, viewGroup, false); return new ViewHolder(view); } // Replace the contents of a view (invoked by the layout manager) @Override public void onBindViewHolder(ViewHolder viewHolder, final int position) { // Get element from your dataset at this position and replace the // contents of the view with that element viewHolder.getTextView().setText(localDataSet[position]); } // Return the size of your dataset (invoked by the layout manager) @Override public int getItemCount() { return localDataSet.length; } }
Her görünüm öğesinin düzeni, her zamanki gibi bir XML düzen dosyasında tanımlanır.
Bu örnekte, uygulama şuna benzer bir text_row_item.xml
dosyasına sahiptir:
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="@dimen/list_item_height"
android:layout_marginLeft="@dimen/margin_medium"
android:layout_marginRight="@dimen/margin_medium"
android:gravity="center_vertical">
<TextView
android:id="@+id/textView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/element_text"/>
</FrameLayout>
Sonraki adımlar
Aşağıdaki kod snippet'i, RecyclerView
özelliğini nasıl kullanabileceğinizi göstermektedir.
Kotlin
class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val dataset = arrayOf("January", "February", "March") val customAdapter = CustomAdapter(dataset) val recyclerView: RecyclerView = findViewById(R.id.recycler_view) recyclerView.layoutManager = LinearLayoutManager(this) recyclerView.adapter = customAdapter } }
Java
RecyclerView recyclerView = findViewById(R.id.recycler_view); recyclerView.layoutManager = new LinearLayoutManager(this) recyclerView.setAdapter(customAdapter);
Kitaplık, uygulamanızı özelleştirmeniz için birçok yol da sunar. Daha fazla bilgi için Gelişmiş RecyclerView özelleştirme bölümünü inceleyin.
Ek kaynaklar
Android'de test etme hakkında daha fazla bilgi için aşağıdaki kaynaklara bakın.