> For the complete documentation index, see [llms.txt](https://moeindeveloper.gitbook.io/maad/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://moeindeveloper.gitbook.io/maad/databinding.md).

# DataBinding

## استفاده از DataBinding:

برای استفاده از **DataBinding**، ابتدا پروژه را **make** کنید تا برای ما کلاس **ActivityMainBinding** تشکیل شود. 

***Make project:***

> *Build*>*Make project*

بعد از انجام این کار، به کلاس **MainActivity.kt** رجوع کنید و متغیر **binding** را تعریف کنید:

```kotlin
private lateinit var binding: ActivityMainBinding
```

اما همانطور که مشاهده می کنید، کلاس **ActivityMainBinding** ناشناخته می باشد! ***چرا؟؟؟*** به این دلیل که شما باید در فایل **activity\_main.xml** نیز تغییراتی *اعمال* کنید! پس به فایل مذکور رجوع کنید:

```markup
<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
xmlns:app="http://schemas.android.com/apk/res-auto"
tools:context=".MainActivity">

                <TextView
                android:id="@+id/helloWorldTextView"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="Hello World"
                app:layout_constraintBottom_toBottomOf="parent"
                app:layout_constraintLeft_toLeftOf="parent"
                app:layout_constraintRight_toRightOf="parent"
                app:layout_constraintTop_toTopOf="parent"/>
</android.support.constraint.ConstraintLayout>
```

لایه را در یک **layout** قرار دهید:

```markup
<?xml version="1.0" encoding="utf-8"?>
<layout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        xmlns:app="http://schemas.android.com/apk/res-auto">
    <android.support.constraint.ConstraintLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            tools:context=".MainActivity">

        <TextView
                android:id="@+id/helloWorldTextView"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="Hello World"
                app:layout_constraintBottom_toBottomOf="parent"
                app:layout_constraintLeft_toLeftOf="parent"
                app:layout_constraintRight_toRightOf="parent"
                app:layout_constraintTop_toTopOf="parent"/>

    </android.support.constraint.ConstraintLayout>
</layout>
```

حالا دوباره پروژه را **Make** کنید؛ به کلاس **MainActivity.kt** برگردید و دوباره متغیر **binding** را تعریف کنید و همانطور که خواهید دید، کلاس **ActivityMainBinding** دیگر ناشناخته نیست:

```kotlin
private lateinit var binding: ActivityMainBinding
```

قدم های بعدی:

در متود **onCreate** نیز باید تغییراتی اعمال شود:

```kotlin
setContentView(R.layout.activity_main)
```

به :

```kotlin
binding = DataBindingUtil.setContentView(this,R.layout.activity_main)
```

تبدیل شود.

## مثال ساده:

اگر دقت کرده باشید در لایه **MainActivity** دارای یک **TextView** می باشد! حال میخواهیم متن آن را تغییر دهیم:

```markup
<TextView
                android:id="@+id/helloWorldTextView"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="Hello World"
                app:layout_constraintBottom_toBottomOf="parent"
                app:layout_constraintLeft_toLeftOf="parent"
                app:layout_constraintRight_toRightOf="parent"
                app:layout_constraintTop_toTopOf="parent"/>
```

در متود **onCreate** کلاس **MainActivity** کدی خواهیم نوشت که بعد از سه ثانیه متن  **helloWorldTextView** را تغییر دهد:

ابتدا از کلاس **Handler** استفاده خواهیم کرد:

```kotlin
Handler().postDelayed({
            //Code here
        },3000)
```

حالا با استفاده از **کد** زیر متن را تغییر می دهیم:

```kotlin
binding.apply {
helloWorldTextView.text = "salam donya"
}
```

و در آخر **کد** ما به این صورت خواهید بود:

```kotlin
Handler().postDelayed({
            binding.apply {
                 helloWorldTextView.text = "salam donya"
            }
        },3000)
```

اگر توجه کرده باشید ما شئ **helloWroldTextView** را اصلأ تعریف نکرده بودیم! پس از کجا همچین متغییری وجود داشت؟ جواب ساده است! از کلاس **ActivityMainBinding**! هر عنصری از **UI** که داخل هر اکتیویتی ساخته می شود، در کلاس **dataBinding** مربوطه نیز تعریف خواهد شد بدون اینکه از متود درد آور **findViewById** استفاده شود!&#x20;

## مثال پیشرفته:

یک کلاس **کاتلین** به نام **User** بسازید به این صورت:

```kotlin
data class User(val name: String)
```

کلاس **User** حاوی مقداری به نام **name** می باشد و حالا قصد داریم که از این دیتاکلاس خود در برنامه استفاده کنیم.

ابتدا در **activity\_main.xml**،  یک تگ دیتا با نوع **User** تشکلیل بدهید به این صورت:

```kotlin
<data>
        <variable name="user"
                  type="moeindeveloper.kotlinmvvm.User"/>
    </data>
```

و حالا می خواهیم از مقدار **name** در کلاس **User** برای مقدار **Text** شئ **helloWorldTextView** استفاده کنیم! در **helloWorldTextView** مقدار **Text** را اینگونه تنظیم کنید:

```markup
android:text="@{user.name}"
```

و در آخر به این گونه خواهد بود:

```markup
<?xml version="1.0" encoding="utf-8"?>
<layout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        xmlns:app="http://schemas.android.com/apk/res-auto">
    <data>
        <variable name="user"
                  type="moeindeveloper.kotlinmvvm.User"/>
    </data>
    <android.support.constraint.ConstraintLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            tools:context=".MainActivity">

        <TextView
                android:id="@+id/helloWorldTextView"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="@{user.name}"
                app:layout_constraintBottom_toBottomOf="parent"
                app:layout_constraintLeft_toLeftOf="parent"
                app:layout_constraintRight_toRightOf="parent"
                app:layout_constraintTop_toTopOf="parent"/>

    </android.support.constraint.ConstraintLayout>
</layout>
```

حال دوباره به **MainActivity.kt** بر گردید و قبل از تغییر کد، ابتدا پروژه **Make** کنید تا **دیتابایندینگ**، شئ های جدید را شناسایی و تعریف کند!

حال به **کدی** که در مثال ساده نوشتیم دقت کنید:

```kotlin
Handler().postDelayed({
            binding.apply {
                 helloWorldTextView.text = "salam donya"
            }
        },3000)
```

حالا **کد** را به این صورت تغییر بدهید:

```kotlin
Handler().postDelayed({
            val user = User("Moein")
            binding.user = user
            binding.executePendingBindings()
        },3000)
```

در اینجا، یک کلاس **User** ساخته شد و به مقدار **user** در **binding** نسبت داده شد اما برای ثبت تغییرات اعمال شده در **binding**، با دستور زیر تغییرات را اعمال خواهیم کرد:

```kotlin
binding.executePendingBindings()
```

به کلاس **MainActivity** دقت کنید:

```kotlin
import android.databinding.DataBindingUtil
import android.support.v7.app.AppCompatActivity
import android.os.Bundle
import android.os.Handler
import moeindeveloper.kotlinmvvm.databinding.ActivityMainBinding

class MainActivity : AppCompatActivity() {

    private lateinit var binding: ActivityMainBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = DataBindingUtil.setContentView(this,R.layout.activity_main)
        Handler().postDelayed({
            val user = User("Moein")
            binding.user = user
            binding.executePendingBindings()
        },3000)
    }
}
```

***کد کمتر، و خوانا تر!***