KEMBAR78
composition-api-lifecycle-hooks by AmirHKarimi888 · Pull Request #158 · vuejs-translations/docs-fa · GitHub
Skip to content

Conversation

@AmirHKarimi888
Copy link
Contributor

Translation of composition-api-lifecycle

Translation of composition-api-lifecycle
@vercel
Copy link

vercel bot commented Jan 22, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
docs-fa ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jan 24, 2024 2:14pm

Copy link
Member

@mostafa-nematpour mostafa-nematpour left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

سلام
خوب ترجمه کردین و در کل خوبه.
این review یکم سختگیرانه هست. این باعث میشه در آینده نیاز کم‌تری به اصلاح داشته باشه
فکر کنم type همون تایپ ترجمه بشه بهتره تا نوشتار
چند مورد هم server side rendering رو رندر سمت سروری ترجمه کردین که من فکر می‌کنم
رندر سمت سرور بهتر باشه

لطفا موارد بالا رو خودتون فیکس کنید من برای رندر سمت سرور چند تا suggestion دادم ولی چون تعدادش زیاد بود همه رو نزدم

ممنون

:::info Usage Note
All APIs listed on this page must be called synchronously during the `setup()` phase of a component. See [Guide - Lifecycle Hooks](/guide/essentials/lifecycle) for more details.
:::info نکته استفاده
تمام API های لیست‌شده در این صفحه باید به صورت همگام، در هنگام فاز `()setup` یک کامپوننت استفاده‌شوند. برای جزییات بیشتر [Guide - Lifecycle Hooks](/guide/essentials/lifecycle) را ببینید.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
تمام API های لیست‌شده در این صفحه باید به صورت همگام، در هنگام فاز `()setup` یک کامپوننت استفاده‌شوند. برای جزییات بیشتر [Guide - Lifecycle Hooks](/guide/essentials/lifecycle) را ببینید.
تمام API های لیست‌شده در این صفحه باید به صورت همگام، در هنگام فاز `()setup` یک کامپوننت استفاده‌شوند. برای جزییات بیشتر [راهنما - هوک‌های چرخه حیات](/guide/essentials/lifecycle) را ببینید.

- تمام کامپوننت‌های همگام فرزند آن mount شده باشند (شامل کامپوننت‌های ناهمگام یا کامپوننت‌های داخل تگ `<Suspense>` نمی‌شود).

- Its own DOM tree has been created and inserted into the parent container. Note it only guarantees that the component's DOM tree is in-document if the application's root container is also in-document.
- درخت DOM آن ایجادشده و به داخل تگ دربرگیرنده آن الحاق شده‌باشد. توجه داشته باشید که تنها زمانی می‌توان تضمین کرد که درخت DOM کامپوننت در داخل DOM اصلی موجود است که تگ دربرگیرنده‌اش هم در DOM اصلی وجود داشته باشد.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- درخت DOM آن ایجادشده و به داخل تگ دربرگیرنده آن الحاق شده‌باشد. توجه داشته باشید که تنها زمانی می‌توان تضمین کرد که درخت DOM کامپوننت در داخل DOM اصلی موجود است که تگ دربرگیرنده‌اش هم در DOM اصلی وجود داشته باشد.
- درخت DOM آن ایجادشده و به داخل تگ دربرگیرنده آن اضافه شده‌باشد. توجه داشته باشید که تنها زمانی می‌توان تضمین کرد که درخت DOM کامپوننت در داخل DOM اصلی موجود است که تگ دربرگیرنده‌اش هم در DOM اصلی وجود داشته باشد.

این هوک معمولا برای انجام عوارض جانبی که نیاز به دسترسی به DOM رندر شده کامپوننت دارند، یا برای محدودکردن کدهای مرتبط با DOM در یک اپلیکیشن رندر شده توسط سرور ([server-rendered application](/guide/scaling-up/ssr)) استفاده می‌شود.

**This hook is not called during server-side rendering.**
**این هوک در هنگام رندر سمت سروری فراخوانی نمی‌شود.**
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**این هوک در هنگام رندر سمت سروری فراخوانی نمی‌شود.**
**این هوک در هنگام رندر سمت سرور فراخوانی نمی‌شود.**

این هوک بعد از هرگونه به‌روزرسانی DOM کامپوننت فراخوانی می‌شود، که می‌تواند ناشی از تغییر استیت‌های مختلف باشد، زیرا چندین تغییر استیت را می‌توان به دلایل عملکردی در یک چرخه رندر واحد دسته‌بندی کرد. اگر نیاز دارید که بعد از تغییر یک استیت خاص به DOM به‌روزرسانی شده دسترسی داشته باشید، به‌جای آن از `()nextTick` استفاده کنید.

**This hook is not called during server-side rendering.**
**این هوک در حین رندر سمت سروری فراخوانی نمی‌شود.**
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**این هوک در حین رندر سمت سروری فراخوانی نمی‌شود.**
**این هوک در حین رندر سمت سرور فراخوانی نمی‌شود.**

هوک updated یک کامپوننت والد بعد از کامپوننت‌های فرزند آن فراخوانی می‌شود.

This hook is called after any DOM update of the component, which can be caused by different state changes, because multiple state changes can be batched into a single render cycle for performance reasons. If you need to access the updated DOM after a specific state change, use [nextTick()](/api/general#nexttick) instead.
این هوک بعد از هرگونه به‌روزرسانی DOM کامپوننت فراخوانی می‌شود، که می‌تواند ناشی از تغییر استیت‌های مختلف باشد، زیرا چندین تغییر استیت را می‌توان به دلایل عملکردی در یک چرخه رندر واحد دسته‌بندی کرد. اگر نیاز دارید که بعد از تغییر یک استیت خاص به DOM به‌روزرسانی شده دسترسی داشته باشید، به‌جای آن از `()nextTick` استفاده کنید.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
این هوک بعد از هرگونه به‌روزرسانی DOM کامپوننت فراخوانی می‌شود، که می‌تواند ناشی از تغییر استیت‌های مختلف باشد، زیرا چندین تغییر استیت را می‌توان به دلایل عملکردی در یک چرخه رندر واحد دسته‌بندی کرد. اگر نیاز دارید که بعد از تغییر یک استیت خاص به DOM به‌روزرسانی شده دسترسی داشته باشید، به‌جای آن از `()nextTick` استفاده کنید.
این هوک بعد از هرگونه به‌روزرسانی DOM کامپوننت فراخوانی می‌شود، که می‌تواند توسط تغییرات مختلف state ایجاد شود، زیرا چندین تغییر state را می‌توان به دلایل عملکردی در یک چرخه رندر واحد دسته‌بندی کرد. اگر نیاز دارید که بعد از تغییر یک state خاص به DOM به‌روزرسانی شده دسترسی داشته باشید، به‌جای آن از `()nextTick` استفاده کنید.

- **جزییات**

This hook can be used to access the DOM state before Vue updates the DOM. It is also safe to modify component state inside this hook.
این هوک می‌تواند برای دسترسی به استیت DOM قبل ازینکه Vue DOM را به‌روزرسانی کند استفاده شود. همچنین تغییر استیت کامپوننت در داخل این هوک ایمن است.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
این هوک می‌تواند برای دسترسی به استیت DOM قبل ازینکه Vue DOM را به‌روزرسانی کند استفاده شود. همچنین تغییر استیت کامپوننت در داخل این هوک ایمن است.
این هوک می‌تواند برای دسترسی به وضعیت DOM قبل از به‌روزرسانی DOM توسط Vue استفاده کرد. همچنین تغییر state کامپوننت در داخل این هوک ایمن است.

- هوک‌های چرخه حیات (Lifecycle hooks)
- تابع `()setup`
- واچرها (Watchers)
- هوک‌های دستورالعمل سفارشی (Custom directive hooks)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- هوک‌های دستورالعمل سفارشی (Custom directive hooks)
- هوک‌های دایرکتیو سفارشی (Custom directive hooks)

:::

You can modify component state in `errorCaptured()` to display an error state to the user. However, it is important that the error state should not render the original content that caused the error; otherwise the component will be thrown into an infinite render loop.
شما می‌توانید استیت کامپوننت را در `()errorCaptured` تغییر دهید تا یک حالت خطا به کاربر نمایش داده شود. با این حال مهم است که استیت خطا محتوای اصلی که باعث خطا شد را رندر نکند، در غیر این صورت کامپوننت به یک حلقه رندر بی نهایت پرتاب می شود.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
شما می‌توانید استیت کامپوننت را در `()errorCaptured` تغییر دهید تا یک حالت خطا به کاربر نمایش داده شود. با این حال مهم است که استیت خطا محتوای اصلی که باعث خطا شد را رندر نکند، در غیر این صورت کامپوننت به یک حلقه رندر بی نهایت پرتاب می شود.
شما می‌توانید state کامپوننت را در `()errorCaptured` تغییر دهید تا یک state خطا را به کاربر نمایش دهید. با این حال، مهم است که state خطا نباید محتوای اصلی که باعث خطا شده است را رندر کند. در غیر این صورت کامپوننت در یک حلقه رندر نامتناهی قرار می‌گیرد.

## ()onActivated {#onactivated}

Registers a callback to be called after the component instance is inserted into the DOM as part of a tree cached by [`<KeepAlive>`](/api/built-in-components#keepalive).
یک تابع callback را ثبت می‌کند تا بعد از اینکه نمونه کامپوننت به‌ عنوان قسمتی از درخت که به‌ وسیله [`<KeepAlive>`](/api/built-in-components#keepalive) ذخیره‌شده، به داخل DOM الحاق شد، فراخوانی شود.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
یک تابع callback را ثبت می‌کند تا بعد از اینکه نمونه کامپوننت به‌ عنوان قسمتی از درخت که به‌ وسیله [`<KeepAlive>`](/api/built-in-components#keepalive) ذخیره‌شده، به داخل DOM الحاق شد، فراخوانی شود.
یک تابع callback را ثبت می‌کند تا بعد از اینکه نمونه کامپوننت به‌ عنوان قسمتی از درخت که به‌ وسیله [`<KeepAlive>`](/api/built-in-components#keepalive) ذخیره‌شده، به داخل DOM اضافه شد، فراخوانی شود.

- به طور پیش‌فرض، تمام خطاها همچنان به [`app.config.errorHandler`](/api/application#app-config-errorhandler) در سطح اپلیکیشن، فرستاده می‌شوند، در صورتی که تعریف شده باشد، به طوری که هنوز می توان این خطاها را در یک مکان به یک سرویس تجزیه و تحلیل گزارش داد.

- If multiple `errorCaptured` hooks exist on a component's inheritance chain or parent chain, all of them will be invoked on the same error, in the order of bottom to top. This is similar to the bubbling mechanism of native DOM events.
- اگر چندین هوک `errorCaptured` در زنجیره توارث یا زنجیره والد یک کامپوننت وجود داشته باشد، همه آنها به ترتیب از پایین به بالا در همان خطا فراخوانی می شوند. این شبیه مکانیسم event bubbling در رویدادهای DOM نیتیو است.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- اگر چندین هوک `errorCaptured` در زنجیره توارث یا زنجیره والد یک کامپوننت وجود داشته باشد، همه آنها به ترتیب از پایین به بالا در همان خطا فراخوانی می شوند. این شبیه مکانیسم event bubbling در رویدادهای DOM نیتیو است.
- اگر چندین هوک `errorCaptured` در زنجیره ارث‌بری یا زنجیره والد یک کامپوننت وجود داشته باشد، همه آنها به ترتیب از پایین به بالا در همان خطا فراخوانی می‌شوند. این شبیه مکانیسم event bubbling در رویدادهای DOM نیتیو است.

composition-api-lifecycle Editions
@AmirHKarimi888
Copy link
Contributor Author

سلام خوب ترجمه کردین و در کل خوبه. این review یکم سختگیرانه هست. این باعث میشه در آینده نیاز کم‌تری به اصلاح داشته باشه فکر کنم type همون تایپ ترجمه بشه بهتره تا نوشتار چند مورد هم server side rendering رو رندر سمت سروری ترجمه کردین که من فکر می‌کنم رندر سمت سرور بهتر باشه

لطفا موارد بالا رو خودتون فیکس کنید من برای رندر سمت سرور چند تا suggestion دادم ولی چون تعدادش زیاد بود همه رو نزدم

ممنون

سلام مجدد، ممنون که بررسی کردید، تغییراتی که گفتید رو اعمال کردم و کامیت زدم🙏

@mostafa-nematpour
Copy link
Member

از مشارکتتون متشکرم

@mostafa-nematpour mostafa-nematpour merged commit c03da45 into vuejs-translations:main Jan 24, 2024
@mostafa-nematpour mostafa-nematpour changed the title Update composition-api-lifecycle.md composition-api-lifecycle-hooks Jan 24, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants