From 7add2e70c24c6b690879b500106f8f5b885c8172 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Sun, 24 Dec 2023 21:59:11 +0330
Subject: [PATCH 01/23] Update built-in-special-attributes.md

to fa version
---
 src/api/built-in-special-attributes.md | 78 +++++++++++++-------------
 1 file changed, 40 insertions(+), 38 deletions(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 3dfb7523..a3afe85d 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -1,18 +1,18 @@
-# Built-in Special Attributes {#built-in-special-attributes}
+# ویژگیهای خاص ساخته شده {#built-in-special-attributes}
 
-## key {#key}
+## کلید {#key}
 
-The `key` special attribute is primarily used as a hint for Vue's virtual DOM algorithm to identify vnodes when diffing the new list of nodes against the old list.
+ویژگی خاص `key` به عنوان یک راهنما برای الگوریتم DOM مجازی Vue استفاده میشود تا هنگام تفاوتیابی لیست جدید گرهها با لیست قدیمی، vnodes را شناسایی کند.
 
-- **Expects:** `number | string | symbol`
+- **انتظارات:** `number | string | symbol`
 
-- **Details**
+- **جزئیات**
 
-  Without keys, Vue uses an algorithm that minimizes element movement and tries to patch/reuse elements of the same type in-place as much as possible. With keys, it will reorder elements based on the order change of keys, and elements with keys that are no longer present will always be removed / destroyed.
+بدون Vue ، Key از یک الگوریتم استفاده میکند که حرکت عناصر را به حداقل میرساند و سعی میکند عناصر هم نوع را در جای خود ترمیم/باز استفاده کند تا حد امکان. با key، این عناصر را بر اساس تغییر ترتیب keyها مرتب میکند و عناصری که دارای `key`هایی هستند که دیگر وجود ندارند، همیشه حذف / نابود میشوند.
 
-  Children of the same common parent must have **unique keys**. Duplicate keys will cause render errors.
+فرزندان یک والد مشترک باید دارای key های منحصر به فرد باشند. key های تکراری باعث خطاهای رندر میشوند.
 
-  The most common use case is combined with `v-for`:
+مورد استفاده رایجترین این ویژگی، همراه با `v-for` است:
 
   ```vue-html
   <ul>
@@ -20,12 +20,14 @@ The `key` special attribute is primarily used as a hint for Vue's virtual DOM al
   </ul>
   ```
 
-  It can also be used to force replacement of an element/component instead of reusing it. This can be useful when you want to:
 
-  - Properly trigger lifecycle hooks of a component
-  - Trigger transitions
+این ویژگی را میتوان برای اجبار جایگزینی یک عنصر/کامپوننت به جای باز استفاده از آن نیز استفاده کرد. این میتواند زمانی مفید باشد که شما بخواهید:
 
-  For example:
+•  به درستی هوک های چرخه حیات یک کامپوننت را فعال کنید
+
+•  ترنزیشن را فعال کنید
+
+برای مثال:
 
   ```vue-html
   <transition>
@@ -33,28 +35,28 @@ The `key` special attribute is primarily used as a hint for Vue's virtual DOM al
   </transition>
   ```
 
-  When `text` changes, the `<span>` will always be replaced instead of patched, so a transition will be triggered.
+  وقتی `text` تغییر کند، `<span>` همیشه جایگزین شده به جای ترمیم شده، بنابراین یک ترنزیشین فعال میشود.
 
-- **See also** [Guide - List Rendering - Maintaining State with `key`](/guide/essentials/list#maintaining-state-with-key)
+- **همچنین ببینید** [راهنما - لیست رندرینگ - حفظ حالت با `key`](/guide/essentials/list#maintaining-state-with-key)
 
-## ref {#ref}
+## مرجع {#ref}
 
-Denotes a [template ref](/guide/essentials/template-refs).
+یک [تمپلیت مرجع](/guide/essentials/template-refs) را نشان میدهد.
 
-- **Expects:** `string | Function`
+- **انتظارات:** `string | Function`
 
-- **Details**
+- **جزپیات**
 
-  `ref` is used to register a reference to an element or a child component.
+  `ref` برای ثبت یک مرجع به یک عنصر یا یک کامپوننت فرزند استفاده میشود.
 
-  In Options API, the reference will be registered under the component's `this.$refs` object:
+در API آپشن، مرجع زیر شیء `this.$refs` کامپوننت ثبت میشود:
 
   ```vue-html
   <!-- stored as this.$refs.p -->
   <p ref="p">hello</p>
   ```
 
-  In Composition API, the reference will be stored in a ref with matching name:
+  در Composition API, مرجع در یک مرجع با نام منطبق ذخیره می شود:
 
   ```vue
   <script setup>
@@ -68,34 +70,34 @@ Denotes a [template ref](/guide/essentials/template-refs).
   </template>
   ```
 
-  If used on a plain DOM element, the reference will be that element; if used on a child component, the reference will be the child component instance.
+  اگر از این ویژگی روی یک عنصر DOM ساده استفاده شود، مرجع آن عنصر خواهد بود؛ اگر روی یک کامپوننت فرزند استفاده شود، مرجع نمونه کامپوننت فرزند خواهد بود.
 
-  Alternatively `ref` can accept a function value which provides full control over where to store the reference:
+ به طور جایگزین `ref` میتواند یک مقدار تابعی را بپذیرد که کنترل کاملی روی اینکه کجا مرجع را ذخیره کنید، فراهم میکند:
 
   ```vue-html
   <ChildComponent :ref="(el) => child = el" />
   ```
 
-  An important note about the ref registration timing: because the refs themselves are created as a result of the render function, you must wait until the component is mounted before accessing them.
+ یک نکته مهم در مورد زمان ثبت ref این است که چون ref ها خودشان به عنوان نتیجه تابع رندر ایجاد میشوند، شما باید تا زمانی که کامپوننت نصب شود، صبر کنید تا به آنها دسترسی پیدا کنید.
 
-  `this.$refs` is also non-reactive, therefore you should not attempt to use it in templates for data-binding.
+`this.$refs` همچنین واکنشگرا نیست، بنابراین شما نباید سعی کنید که از آن در تمپلیتها برای پیوند داده استفاده کنید.
 
-- **See also**
-  - [Guide - Template Refs](/guide/essentials/template-refs)
-  - [Guide - Typing Template Refs](/guide/typescript/composition-api#typing-template-refs) <sup class="vt-badge ts" />
-  - [Guide - Typing Component Template Refs](/guide/typescript/composition-api#typing-component-template-refs) <sup class="vt-badge ts" />
+- **همچنین ببینید**
+  - [راهنما - تمپلیت مراجع](/guide/essentials/template-refs)
+  - [راهنما - نوع تمپلیت مراجع](/guide/typescript/composition-api#typing-template-refs) <sup class="vt-badge ts" />
+  - [راهنما - نوع کامپوننت تمپلیت مراجع](/guide/typescript/composition-api#typing-component-template-refs) <sup class="vt-badge ts" />
 
-## is {#is}
+## است {#is}
 
-Used for binding [dynamic components](/guide/essentials/component-basics#dynamic-components).
+برای اتصال [کامپوننت های داینامیک](/guide/essentials/component-basics#dynamic-components) استفاده میشود.
 
-- **Expects:** `string | Component`
+- **انتظارات:** `string | Component`
 
-- **Usage on native elements** <sup class="vt-badge">3.1+</sup>
+- **استفاده در عناصر بومی** <sup class="vt-badge">3.1+</sup>
 
-  When the `is` attribute is used on a native HTML element, it will be interpreted as a [Customized built-in element](https://html.spec.whatwg.org/multipage/custom-elements.html#custom-elements-customized-builtin-example), which is a native web platform feature.
+  وقتی ویژگی `is` روی یک عنصر HTML بومی استفاده شود، به عنوان یک <a href="https://html.spec.whatwg.org/multipage/custom-elements.html#custom-elements-customized-builtin-example">عنصر سفارشی ساخته شده</a> تفسیر میشود، که یک ویژگی بومی پلتفرم وب است.
 
-  There is, however, a use case where you may need Vue to replace a native element with a Vue component, as explained in [in-DOM Template Parsing Caveats](/guide/essentials/component-basics#in-dom-template-parsing-caveats). You can prefix the value of the `is` attribute with `vue:` so that Vue will render the element as a Vue component instead:
+  اما یک مورد استفاده وجود دارد که شما ممکن است نیاز داشته باشید که Vue یک عنصر بومی را با یک کامپوننت Vue جایگزین کند، که در احتیاطهای تجزیه تمپلیت در DOM توضیح داده شده است. شما میتوانید مقدار ویژگی `is` را با `vue:` پیشوند کنید تا Vue عنصر را به عنوان یک کامپوننت Vue رندر کند:
 
   ```vue-html
   <table>
@@ -103,7 +105,7 @@ Used for binding [dynamic components](/guide/essentials/component-basics#dynamic
   </table>
   ```
 
-- **See also**
+- **همچنین ببینید**
 
-  - [Built-in Special Element - `<component>`](/api/built-in-special-elements#component)
-  - [Dynamic Components](/guide/essentials/component-basics#dynamic-components)
+  - [عنصر خاص ساخته شده - `<component>`](/api/built-in-special-elements#component)
+  - [کامپوننت های داینامیک](/guide/essentials/component-basics#dynamic-components)

From 810a3867c6b929ec7c62bcb082204247ff19262d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:04:51 +0330
Subject: [PATCH 02/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index a3afe85d..0661b1cb 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -1,4 +1,4 @@
-# ویژگیهای خاص ساخته شده {#built-in-special-attributes}
+# ویژگی‌های خاص ساخته شده {#built-in-special-attributes}
 
 ## کلید {#key}
 

From f056d791dd40db7f3a69ca60234502afd58b12d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:05:01 +0330
Subject: [PATCH 03/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 0661b1cb..b7128367 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -2,7 +2,7 @@
 
 ## کلید {#key}
 
-ویژگی خاص `key` به عنوان یک راهنما برای الگوریتم DOM مجازی Vue استفاده میشود تا هنگام تفاوتیابی لیست جدید گرهها با لیست قدیمی، vnodes را شناسایی کند.
+ویژگی خاص `key` به عنوان یک راهنما برای الگوریتم DOM مجازی Vue استفاده می‌شود تا هنگام تفاوت‌یابی لیست جدید نودها با لیست قدیمی، vnodes را شناسایی کند.
 
 - **انتظارات:** `number | string | symbol`
 

From 2e58225f27a2614f34e0ef0d9236aef6655fea12 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:05:20 +0330
Subject: [PATCH 04/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index b7128367..85a2a0a3 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -8,7 +8,7 @@
 
 - **جزئیات**
 
-بدون Vue ، Key از یک الگوریتم استفاده میکند که حرکت عناصر را به حداقل میرساند و سعی میکند عناصر هم نوع را در جای خود ترمیم/باز استفاده کند تا حد امکان. با key، این عناصر را بر اساس تغییر ترتیب keyها مرتب میکند و عناصری که دارای `key`هایی هستند که دیگر وجود ندارند، همیشه حذف / نابود میشوند.
+  بدون Vue ، Key از یک الگوریتم استفاده می‌کند که حرکت عناصر را به حداقل می‌رساند و سعی می‌کند عناصر هم نوع را تا حد امکان در جای خود ترمیم/باز استفاده کند. با key، این عناصر را بر اساس تغییر ترتیب keyها مرتب می‌کند و عناصری که دارای `key`هایی هستند که دیگر وجود ندارند، همیشه حذف / نابود می‌شوند.
 
 فرزندان یک والد مشترک باید دارای key های منحصر به فرد باشند. key های تکراری باعث خطاهای رندر میشوند.
 

From 5a2e433997c13c321ce18df2f99a125a7cd9b4dc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:05:30 +0330
Subject: [PATCH 05/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 85a2a0a3..f6d3ac6e 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -10,7 +10,7 @@
 
   بدون Vue ، Key از یک الگوریتم استفاده می‌کند که حرکت عناصر را به حداقل می‌رساند و سعی می‌کند عناصر هم نوع را تا حد امکان در جای خود ترمیم/باز استفاده کند. با key، این عناصر را بر اساس تغییر ترتیب keyها مرتب می‌کند و عناصری که دارای `key`هایی هستند که دیگر وجود ندارند، همیشه حذف / نابود می‌شوند.
 
-فرزندان یک والد مشترک باید دارای key های منحصر به فرد باشند. key های تکراری باعث خطاهای رندر میشوند.
+  فرزندان یک والد مشترک باید دارای key های منحصر به فرد باشند. key های تکراری باعث خطاهای رندر می‌شوند.
 
 مورد استفاده رایجترین این ویژگی، همراه با `v-for` است:
 

From e91f517b32db525cce4bbb234107e1b481b428f4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:05:38 +0330
Subject: [PATCH 06/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index f6d3ac6e..85fbdec3 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -12,7 +12,7 @@
 
   فرزندان یک والد مشترک باید دارای key های منحصر به فرد باشند. key های تکراری باعث خطاهای رندر می‌شوند.
 
-مورد استفاده رایجترین این ویژگی، همراه با `v-for` است:
+  رایج‌ترین مورد استفاده این ویژگی، همراه با `v-for` است:
 
   ```vue-html
   <ul>

From 152c6493f5089cdc8d728f1a6ee08ba7d5b3e168 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:05:45 +0330
Subject: [PATCH 07/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 85fbdec3..de71f6fd 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -78,7 +78,7 @@
   <ChildComponent :ref="(el) => child = el" />
   ```
 
- یک نکته مهم در مورد زمان ثبت ref این است که چون ref ها خودشان به عنوان نتیجه تابع رندر ایجاد میشوند، شما باید تا زمانی که کامپوننت نصب شود، صبر کنید تا به آنها دسترسی پیدا کنید.
+  یک نکته مهم در مورد زمان ثبت ref این است که چون ref ها خودشان به عنوان نتیجه تابع رندر ایجاد می‌شوند، شما باید تا زمانی که کامپوننت mount شود، صبر کنید تا به آنها دسترسی پیدا کنید.
 
 `this.$refs` همچنین واکنشگرا نیست، بنابراین شما نباید سعی کنید که از آن در تمپلیتها برای پیوند داده استفاده کنید.
 

From 473f36f194485123faf485b5ad9e7e40370b6606 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:05:56 +0330
Subject: [PATCH 08/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index de71f6fd..aed733f4 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -80,7 +80,7 @@
 
   یک نکته مهم در مورد زمان ثبت ref این است که چون ref ها خودشان به عنوان نتیجه تابع رندر ایجاد می‌شوند، شما باید تا زمانی که کامپوننت mount شود، صبر کنید تا به آنها دسترسی پیدا کنید.
 
-`this.$refs` همچنین واکنشگرا نیست، بنابراین شما نباید سعی کنید که از آن در تمپلیتها برای پیوند داده استفاده کنید.
+  `this.$refs` همچنین reactive نیست، بنابراین شما نباید سعی کنید که از آن در تمپلیت‌ها برای اتصال دادن داده استفاده کنید.
 
 - **همچنین ببینید**
   - [راهنما - تمپلیت مراجع](/guide/essentials/template-refs)

From 774c3a1fae6eb080a79734b7bf46b28963595d14 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:06:32 +0330
Subject: [PATCH 09/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index aed733f4..c2e1f91c 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -87,7 +87,7 @@
   - [راهنما - نوع تمپلیت مراجع](/guide/typescript/composition-api#typing-template-refs) <sup class="vt-badge ts" />
   - [راهنما - نوع کامپوننت تمپلیت مراجع](/guide/typescript/composition-api#typing-component-template-refs) <sup class="vt-badge ts" />
 
-## است {#is}
+## is {#is}
 
 برای اتصال [کامپوننت های داینامیک](/guide/essentials/component-basics#dynamic-components) استفاده میشود.
 

From c06ea63b7cec0d4fcd7fcebb4718dd79028dc34c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:06:41 +0330
Subject: [PATCH 10/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index c2e1f91c..36bb286a 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -95,7 +95,7 @@
 
 - **استفاده در عناصر بومی** <sup class="vt-badge">3.1+</sup>
 
-  وقتی ویژگی `is` روی یک عنصر HTML بومی استفاده شود، به عنوان یک <a href="https://html.spec.whatwg.org/multipage/custom-elements.html#custom-elements-customized-builtin-example">عنصر سفارشی ساخته شده</a> تفسیر میشود، که یک ویژگی بومی پلتفرم وب است.
+  وقتی ویژگی `is` روی یک عنصر HTML بومی استفاده شود، به عنوان یک <a href="https://html.spec.whatwg.org/multipage/custom-elements.html#custom-elements-customized-builtin-example">عنصر سفارشی ساخته شده</a> تفسیر می‌شود، که یک ویژگی بومی پلتفرم وب است.
 
   اما یک مورد استفاده وجود دارد که شما ممکن است نیاز داشته باشید که Vue یک عنصر بومی را با یک کامپوننت Vue جایگزین کند، که در احتیاطهای تجزیه تمپلیت در DOM توضیح داده شده است. شما میتوانید مقدار ویژگی `is` را با `vue:` پیشوند کنید تا Vue عنصر را به عنوان یک کامپوننت Vue رندر کند:
 

From f0e01ae5252d888313f1fb60752a7d2c82d03602 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:06:57 +0330
Subject: [PATCH 11/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 36bb286a..754dc087 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -97,7 +97,7 @@
 
   وقتی ویژگی `is` روی یک عنصر HTML بومی استفاده شود، به عنوان یک <a href="https://html.spec.whatwg.org/multipage/custom-elements.html#custom-elements-customized-builtin-example">عنصر سفارشی ساخته شده</a> تفسیر می‌شود، که یک ویژگی بومی پلتفرم وب است.
 
-  اما یک مورد استفاده وجود دارد که شما ممکن است نیاز داشته باشید که Vue یک عنصر بومی را با یک کامپوننت Vue جایگزین کند، که در احتیاطهای تجزیه تمپلیت در DOM توضیح داده شده است. شما میتوانید مقدار ویژگی `is` را با `vue:` پیشوند کنید تا Vue عنصر را به عنوان یک کامپوننت Vue رندر کند:
+  اما یک مورد استفاده وجود دارد که شما ممکن است نیاز داشته باشید که Vue یک عنصر بومی را با یک کامپوننت Vue جایگزین کند، که در [محدودیت‌های تجزیه تمپلیت در DOM](/guide/essentials/component-basics#in-dom-template-parsing-caveats) توضیح داده شده است. شما میتوانید مقدار ویژگی `is` را با `vue:‎` پیشوند کنید تا Vue عنصر را به عنوان یک کامپوننت Vue رندر کند:
 
   ```vue-html
   <table>

From c3a31f41f93652b6c9166f8f794e9c0bbfa977e6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:11:19 +0330
Subject: [PATCH 12/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 754dc087..9a515cd1 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -20,7 +20,6 @@
   </ul>
   ```
 
-
 این ویژگی را میتوان برای اجبار جایگزینی یک عنصر/کامپوننت به جای باز استفاده از آن نیز استفاده کرد. این میتواند زمانی مفید باشد که شما بخواهید:
 
 •  به درستی هوک های چرخه حیات یک کامپوننت را فعال کنید

From b02f476973fe26411e8db6bcc221a0fb1eefcb4c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:11:44 +0330
Subject: [PATCH 13/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 9a515cd1..8cd07e54 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -34,7 +34,7 @@
   </transition>
   ```
 
-  وقتی `text` تغییر کند، `<span>` همیشه جایگزین شده به جای ترمیم شده، بنابراین یک ترنزیشین فعال میشود.
+  وقتی `text` تغییر کند، همیشه المنت `<span>`  جایگزین می‌شود به جای اینکه صرفا متن آن تغییر کند، بنابراین ترنزیشین فعال می‌شود.
 
 - **همچنین ببینید** [راهنما - لیست رندرینگ - حفظ حالت با `key`](/guide/essentials/list#maintaining-state-with-key)
 

From b1b72714e82fcd147d64abb95809da65d36062f4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:12:16 +0330
Subject: [PATCH 14/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 8cd07e54..403a8817 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -36,7 +36,7 @@
 
   وقتی `text` تغییر کند، همیشه المنت `<span>`  جایگزین می‌شود به جای اینکه صرفا متن آن تغییر کند، بنابراین ترنزیشین فعال می‌شود.
 
-- **همچنین ببینید** [راهنما - لیست رندرینگ - حفظ حالت با `key`](/guide/essentials/list#maintaining-state-with-key)
+- **همچنین ببینید** [راهنما - لیست رندرینگ - حفظ state با `key`](/guide/essentials/list#maintaining-state-with-key)
 
 ## مرجع {#ref}
 

From 059e9f408b3a5600ea72499f091c7f3ec40a311e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:12:49 +0330
Subject: [PATCH 15/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 403a8817..421be57e 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -38,7 +38,7 @@
 
 - **همچنین ببینید** [راهنما - لیست رندرینگ - حفظ state با `key`](/guide/essentials/list#maintaining-state-with-key)
 
-## مرجع {#ref}
+## ref {#ref}
 
 یک [تمپلیت مرجع](/guide/essentials/template-refs) را نشان میدهد.
 

From bd7981f96738ad60e3703cd96a67714e66844614 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:13:11 +0330
Subject: [PATCH 16/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 421be57e..06bdc6fc 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -40,7 +40,7 @@
 
 ## ref {#ref}
 
-یک [تمپلیت مرجع](/guide/essentials/template-refs) را نشان میدهد.
+یک [ارجاع از طریق تمپلیت](/guide/essentials/template-refs) را نشان می‌دهد.
 
 - **انتظارات:** `string | Function`
 

From a35741f05bffcc5d7d6b309a11cec6c3a89b05ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:13:30 +0330
Subject: [PATCH 17/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 06bdc6fc..09af28c0 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -69,7 +69,7 @@
   </template>
   ```
 
-  اگر از این ویژگی روی یک عنصر DOM ساده استفاده شود، مرجع آن عنصر خواهد بود؛ اگر روی یک کامپوننت فرزند استفاده شود، مرجع نمونه کامپوننت فرزند خواهد بود.
+  اگر از این ویژگی روی یک عنصر DOM ساده استفاده شود، ارجاع همان عنصر خواهد بود؛ اگر روی یک کامپوننت فرزند استفاده شود، ارجاع نمونه ساخته شده از کامپوننت فرزند خواهد بود.
 
  به طور جایگزین `ref` میتواند یک مقدار تابعی را بپذیرد که کنترل کاملی روی اینکه کجا مرجع را ذخیره کنید، فراهم میکند:
 

From 87eaed0568db9030f5faf8d8871273b6c1b0bfd1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:13:47 +0330
Subject: [PATCH 18/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 09af28c0..30fc8dc2 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -71,7 +71,7 @@
 
   اگر از این ویژگی روی یک عنصر DOM ساده استفاده شود، ارجاع همان عنصر خواهد بود؛ اگر روی یک کامپوننت فرزند استفاده شود، ارجاع نمونه ساخته شده از کامپوننت فرزند خواهد بود.
 
- به طور جایگزین `ref` میتواند یک مقدار تابعی را بپذیرد که کنترل کاملی روی اینکه کجا مرجع را ذخیره کنید، فراهم میکند:
+  به طور جایگزین `ref` میتواند یک مقدار تابعی را بپذیرد که کنترل کاملی روی اینکه کجا رفرنس دریافت شده را ذخیره کنید، فراهم می‌کند:
 
   ```vue-html
   <ChildComponent :ref="(el) => child = el" />

From 768cea6c18bd9bf31df8a7dffdeb42d44df41e62 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:14:01 +0330
Subject: [PATCH 19/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 30fc8dc2..22af9c8c 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -46,7 +46,7 @@
 
 - **جزپیات**
 
-  `ref` برای ثبت یک مرجع به یک عنصر یا یک کامپوننت فرزند استفاده میشود.
+  `ref` برای ثبت یک ارجاع به یک عنصر یا یک کامپوننت فرزند استفاده می‌شود.
 
 در API آپشن، مرجع زیر شیء `this.$refs` کامپوننت ثبت میشود:
 

From 89ae6bcb9cfc16911e746875c926685c04125df1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:14:48 +0330
Subject: [PATCH 20/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 22af9c8c..507c1b37 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -1,6 +1,6 @@
 # ویژگی‌های خاص ساخته شده {#built-in-special-attributes}
 
-## کلید {#key}
+## key {#key}
 
 ویژگی خاص `key` به عنوان یک راهنما برای الگوریتم DOM مجازی Vue استفاده می‌شود تا هنگام تفاوت‌یابی لیست جدید نودها با لیست قدیمی، vnodes را شناسایی کند.
 

From 4241508e435cc53b9bbe9260f12efe632e43ec2c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:15:11 +0330
Subject: [PATCH 21/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 507c1b37..0a3653e8 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -44,7 +44,7 @@
 
 - **انتظارات:** `string | Function`
 
-- **جزپیات**
+- **جزئیات**
 
   `ref` برای ثبت یک ارجاع به یک عنصر یا یک کامپوننت فرزند استفاده می‌شود.
 

From 7c00c70b6dcc3eb5c190e3c3e9383f578476d25b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:15:30 +0330
Subject: [PATCH 22/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 0a3653e8..95a23b3c 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -48,7 +48,7 @@
 
   `ref` برای ثبت یک ارجاع به یک عنصر یا یک کامپوننت فرزند استفاده می‌شود.
 
-در API آپشن، مرجع زیر شیء `this.$refs` کامپوننت ثبت میشود:
+  در Option API ارجاع تحت آبجکت `this.$refs‎` کامپوننت ثبت می‌شود:
 
   ```vue-html
   <!-- stored as this.$refs.p -->

From b91c3bf49bddefe5013200f39f8e1a86a3157a34 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D9=85=D8=AD=D9=85=D8=AF=20=D8=B4=D8=B1=D9=81=DB=8C?=
 <80104926+MMDShen@users.noreply.github.com>
Date: Wed, 27 Dec 2023 12:15:47 +0330
Subject: [PATCH 23/23] Update src/api/built-in-special-attributes.md

Co-authored-by: Mostafa <nematpor46@gmail.com>
---
 src/api/built-in-special-attributes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/built-in-special-attributes.md b/src/api/built-in-special-attributes.md
index 95a23b3c..9f31867a 100644
--- a/src/api/built-in-special-attributes.md
+++ b/src/api/built-in-special-attributes.md
@@ -55,7 +55,7 @@
   <p ref="p">hello</p>
   ```
 
-  در Composition API, مرجع در یک مرجع با نام منطبق ذخیره می شود:
+  در Composition API، ارجاع در یک ref با نام منطبق ذخیره می‌شود:
 
   ```vue
   <script setup>