Skip to content

Commit

Permalink
feat: translate Api options misc (#101)
Browse files Browse the repository at this point in the history
* feat: translate translation for api/options-misc
  • Loading branch information
mostafa-rio authored Dec 5, 2023
1 parent 55cfb62 commit a144c90
Showing 1 changed file with 44 additions and 37 deletions.
81 changes: 44 additions & 37 deletions src/api/options-misc.md
Original file line number Diff line number Diff line change
@@ -1,54 +1,58 @@
# Options: Misc {#options-misc}
# Options: متفرقه (Misc) {#options-misc}

## name {#name}
## نام {#name}

Explicitly declare a display name for the component.
به صراحت یک نام نمایشی (display name) برای کامپوننت تعریف میکند.

- **Type**
- **تایپ (Type)**

```ts
interface ComponentOptions {
name?: string
}
```

- **Details**
- **جزئیات**

The name of a component is used for the following:
نام کامپوننت برای موارد زیر استفاده میشود:

- Recursive self-reference in the component's own template
- Display in Vue DevTools' component inspection tree
- Display in warning component traces
- خود ارجاعی بازگشتی (Recursive self-reference) در تمپلیت خود کامپوننت
- نمایش در درخت بازرسی (inspection tree) کامپوننت متعلق به Vue DevTools
- نمایش در trance‌های کامپوننت اخطار (warning)

When you use Single-File Components, the component already infers its own name from the filename. For example, a file named `MyComponent.vue` will have the inferred display name "MyComponent".
زمانی که از کامپوننتهای تک فایلی استفاده میکنید کامپوننت از قبل نام خود را از نام فایل میخواند (infer میکند). برای مثال یک فایل با نام `MyComponent.vue` نام نمایشی "MyComponent" را میخواند.

Another case is that when a component is registered globally with [`app.component`](/api/application#app-component), the global ID is automatically set as its name.
مورد دیگر زمانی است که یک کامپوننت به صورت سراسری (global) با [`app.component`](/api/application#app-component) ثبت شده باشد که در این صورت آیدی سراسری به شکل خودکار به عنوان نام کامپوننت قرار میگیرد.

آپشن `name` به شما اجازه میدهد که نام infer شده را نادیده بگیرید یا زمانی که هیچ نامی نمیتواند infer شود به صورت مشخص یک نام تعیین کنید
(برای مثال زمانی که از ابزارهای ساخت (build tools) استفاده نمیشود یا در یک کامپوننت غیر تک فایلی که به صورت inline هستند)


The `name` option allows you to override the inferred name, or to explicitly provide a name when no name can be inferred (e.g. when not using build tools, or an inlined non-SFC component).

There is one case where `name` is explicitly necessary: when matching against cacheable components in [`<KeepAlive>`](/guide/built-ins/keep-alive) via its `include / exclude` props.

:::tip
Since version 3.2.34, a single-file component using `<script setup>` will automatically infer its `name` option based on the filename, removing the need to manually declare the name even when used with `<KeepAlive>`.
یک مورد وجود دارد که نام صراحتاً ضروری است: هنگام تطبیق با کامپوننتهای قابل کش در [`<KeepAlive>`](/guide/built-ins/keep-alive) از طریق prop های `include / exclude` آن.

:::tip نکته
از نسخه 3.2.34, یک کامپوننت تک فایلی با استفاده از `<script setup>` به شکل خودکار آپشن `name` خود را بر اساس نام فایل infer میکند که نیاز به تعریف نام را حتی زمان استفاده از `<KeepAlive>` از بین میبرد.
:::

## inheritAttrs {#inheritattrs}
## آپشن inheritAttrs {#inheritattrs}

Controls whether the default component attribute fallthrough behavior should be enabled.
اینکه رفتار پیشفرض attribute fallthrough متعلق به کامپوننت فعال باشد را کنترل میکند.

- **Type**
- **تایپ (Type)**

```ts
interface ComponentOptions {
inheritAttrs?: boolean // default: true
}
```

- **Details**
- **جزئیات**

By default, parent scope attribute bindings that are not recognized as props will "fallthrough". This means that when we have a single-root component, these bindings will be applied to the root element of the child component as normal HTML attributes. When authoring a component that wraps a target element or another component, this may not always be the desired behavior. By setting `inheritAttrs` to `false`, this default behavior can be disabled. The attributes are available via the `$attrs` instance property and can be explicitly bound to a non-root element using `v-bind`.
به صورت پیشفرض ویژگیهای پیوندی (attribute binding) مربوط به اسکوپ کامپوننت والد که به عنوان props تشخیص داده نشدند "fallthrough" خواهند کرد. این به این معنی است که وقتی یک تک کامپوننت ریشه ای (single-root component) داشته باشیم این پیوندها به عنوان ویژگی های معمولی HTML به کامپوننت ریشه فرزند اعمال می شود.
این ممکن است در زمان نوشتن یک کامپوننت که یک المنت هدف یا کامپوننت دیگر را در بر میگیرد (wraps) رفتار دلخواه ما نباشد.
با تنظیم `inheritAttrs` روی `false` این رفتار پیش‌فرض را می‌توان غیرفعال کرد. ویژگی ها از طریق پراپرتی های نمونه (instance) `attrs$` در دسترس هستند و می توانند به طور صریح به یک المنت غیر root با استفاده از `v-bind` متصل شوند.

- **Example**
- **مثالها**

<div class="options-api">

Expand Down Expand Up @@ -76,7 +80,8 @@ Controls whether the default component attribute fallthrough behavior should be
</div>
<div class="composition-api">

When declaring this option in a component that uses `<script setup>`, you can use the [`defineOptions`](/api/sfc-script-setup#defineoptions) macro:
زمانی تعریف این آپشن در یک کامپوننت که از `<script setup>` استفاده میکند شما میتوانید از ماکرو [`defineOptions`](/api/sfc-script-setup#defineoptions) استفاده کنید.


```vue
<script setup>
Expand All @@ -98,8 +103,9 @@ Controls whether the default component attribute fallthrough behavior should be
</label>
</template>
```

از نسخه ۳.۳ همچنین میتوانید از `defineOptions` به شکل مستقیم در `<script setup>` استفاده کنید:

Since 3.3 you can also use `defineOptions` directly in `<script setup>`:

```vue
<script setup>
Expand All @@ -122,21 +128,22 @@ Controls whether the default component attribute fallthrough behavior should be

</div>

- **See also** [Fallthrough Attributes](/guide/components/attrs)
- **هچنین ببینید** [Fallthrough Attributes](/guide/components/attrs)

## کامپوننتها {#components}

## components {#components}
یک آبجکت که کامپوننتها را ثبت میکند تا در دسترس نمونه‌ی کامپوننت (component instance) باشد.

An object that registers components to be made available to the component instance.

- **Type**
- **تایپ (Type)**

```ts
interface ComponentOptions {
components?: { [key: string]: Component }
}
```

- **Example**
- **نمونه**

```js
import Foo from './Foo.vue'
Expand All @@ -152,21 +159,21 @@ An object that registers components to be made available to the component instan
}
```

- **See also** [Component Registration](/guide/components/registration)
- **همچنین ببینید** [Component Registration](/guide/components/registration)

## directives {#directives}
## دایرکتیوها (directives) {#directives}

An object that registers directives to be made available to the component instance.
یک آبجکت که دایرکتیوها را ثبت میکند که در دسترس نمونه‌ی کامپوننت باشد.

- **Type**
- **تایپ (Type)**

```ts
interface ComponentOptions {
directives?: { [key: string]: Directive }
}
```

- **Example**
- **نمونه ها**

```js
export default {
Expand All @@ -185,6 +192,6 @@ An object that registers directives to be made available to the component instan
<input v-focus>
```

A hash of directives to be made available to the component instance.
یک hash از دایرکتیوها که در دسترس نمونه‌ی کامپوننت باشد.

- **See also** [Custom Directives](/guide/reusability/custom-directives)
- **همچنین ببینید** [Custom Directives](/guide/reusability/custom-directives)

0 comments on commit a144c90

Please sign in to comment.