Skip to content

Commit bd7a4d2

Browse files
committed
translate(scaling-up): SFC enhance translation
1 parent 30319d5 commit bd7a4d2

File tree

1 file changed

+12
-13
lines changed

1 file changed

+12
-13
lines changed

src/guide/scaling-up/sfc.md

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## مقدمة {#introduction}
44

5-
مكونات vue أحادية الملف ( التي تُسمَّى أو تُعرف أيضا باسم ملفات `*.vue` ، و المختصرة باسم **SFC** ) هي تنسيق ملف خاص يسمح لنا بتغليف القالب، المنطق و التنسيق لمُكون vue في ملف واحد. إليك مثال SFC:
5+
مكونات vue أحادية الملف ( التي تُسمَّى أو تُعرف أيضا باسم ملفات `*.vue` ، و المختصرة باسم **SFC** ) هي تنسيق ملف خاص يسمح لنا بتغليف القالب، الشيفرة البرمجية و التنسيق لمُكون vue في ملف واحد. إليك مثال SFC:
66

77
<div class="options-api">
88

@@ -61,23 +61,22 @@ const greeting = ref('Hello World!')
6161

6262
- صياغة مُكونات مُركبة باستخدام صيغة HTML، CSS و JavaScript المُعتادة.
6363
- [تجميع الاهتمامات ( الجوانب و العوامل املختلفة التي يجب مُراعاتها ) المُترابطة بطبيعتها.](#what-about-separation-of-concerns)
64-
- قوالب مُجمعة مُسبقا بدون تكلفة التجميع أثناء التشغيل.
64+
- قوالب مُصرفة مُسبقا بدون تكلفة التصريف أثناء التشغيل.
6565
- [CSS ذات نطاق المُكون ( التنسيق أو النمط يكون مُحدد بشكل خاص للمُكون ).](/api/sfc-css-features)
6666
- [صياغة أكثر سلاسة عند العمل مع الواجهة التركيبية لبرمجة التطبيقات](/api/sfc-script-setup)
6767
- المزيد من تحسينات مرحلة الترجمة عن طريق تحليل متقاطع بين القالب و المنطق البرمجي
6868
- [دعم مُحرر بيئة التطوير المتكاملة](/guide/scaling-up/tooling.html#ide-support) مع إكمال تلقائي و فحص نوع البيانات لتعبيرات القوالب.
6969
- دعم ميزة استبدال الوحدات النمطية الحية أثناء تشغيل التطبيق دون الحاجة إلى أي تهيئة إضافية.
7070

71-
المكونات أحادية الملف من المميزات المحددة لـ Vue كإطار عمل، و يُعتبر النهج الموصى به لاستخدام Vue في السيناريوهات التالي:
72-
- تطبيقات الصفحة الواحدة ( SPA )
71+
المكونات أحادية الملف من المميزات المحددة لـ Vue كإطار عمل، و يُعتبر النهج الموصى به لاستخدام Vue في السيناريوهات التالية:
72+
- التطبيقات أحادية الصفحة ( SPA )
7373
- مولدات مواقع الويب الساكنة ( SSG )
74-
- أي واجهة أمامية غير بسيطة أين هنالك تبرير لاستخدام مرحلة بناء المشروع لتوفير تجربة تطوير أفضل
75-
76-
ومع ذلك ، ندرك أن هناك سيناريوهات يمكن أن تبدو فيها مكونات أحادية الملف و كأنها مُبالغة. هذا هو السبب في أنه لا يزال من الممكن استخدام Vue عبر JavaScript بشكل عادي بدون مرحلة بناء. إذا كنت تبحث فقط عن تحسين HTML إلى حد كبير من خلال التفاعلات الخفيفة ، فيُمكنك أيضا إلقاء نظرة على [petite-vue](https://github.com/vuejs/petite-vue) ، وهي نُسخة محدودة بحجم 6 كيلو بايت من Vue محسّنة من أجل التحسين التدريجي.
74+
- أي واجهة أمامية غير بسيطة حيث يمكن تبرير استخدام عملية بناء المشروع لتوفير تجربة تطوير أفضل
7775

76+
ومع ذلك ، ندرك أن هناك سيناريوهات يمكن أن تبدو فيها مكونات أحادية الملف و كأنها مُبالغة. هذا هو السبب في أنه لا يزال من الممكن استخدام Vue عبر JavaScript بشكل عادي بدون مرحلة بناء. إذا كنت تبحث فقط عن تحسين HTML إلى حد كبير من خلال التفاعلات الخفيفة ، فيُمكنك أيضا إلقاء نظرة على [petite-vue](https://github.com/vuejs/petite-vue) ، وهي نُسخة محدودة بحجم 6 كيلو بايت من Vue محسّنة من أجل تعزيز التدرج
7877
## كيف تعمل {#how-it-works}
7978

80-
المٌكون أحادي الملف لـ vue هو تنسيق ملف خاص بإطار العمل و يجب تصريفه مُسبقا بواسطة [@vue/compiler-sfc](https://github.com/vuejs/core/tree/main/packages/compiler-sfc) إلى جافاسكربت القياسية و CSS. المُكون أحادي الملف (SFC) المُصرف هو وحدة جافاسكربت قياسية (ES) - مما يعني أنه مع الإعداد المُناسب لمرحلة البناء، يُمكنك استيراد المكون أحادي الملف (SFC) كوحدة:
79+
المٌكون أحادي الملف لـ vue هو تنسيق ملف خاص بإطار العمل و يجب تصريفه مُسبقا بواسطة [@vue/compiler-sfc](https://github.com/vuejs/core/tree/main/packages/compiler-sfc) إلى standard JavaScript و CSS. المُكون أحادي الملف (SFC) المُجمع هو standard JavaScript (ES) module (ES) - مما يعني أنه مع الإعداد المُناسب لمرحلة البناء، يُمكنك استيراد المكون أحادي الملف (SFC) كوحدة:
8180

8281
```js
8382
import MyComponent from './MyComponent.vue'
@@ -89,17 +88,17 @@ export default {
8988
}
9089
```
9190

92-
عادة ما يتم حقن وسوم `style` داخل المكونات أحادية الملف كـوُسوم `style` أصلية أثناء التطوير لدعم التحديثات النشطة. لبيئة الإنتاج يُمكن فصلهم و دمجهم في ملف CSS واحد.
91+
عادة تُدرج وسوم `<style>` داخل المكونات أحادية الملف كوسوم `<style>` الأصلية أثناء التطوير لدعم التحديثات النشطة. أما في مرحلة الإنتاج يمكن استخراجها ودمجها في ملف CSS واحد.
9392

94-
يمكنك اللعب مع ملفات SFC و استكشاف كيفية تجميعها في [Vue SFC Playground](https://sfc.vuejs.org/).
93+
يمكنك تجربة المكونات أحادية الملف واستكشاف كيفية تصريفها في [Vue SFC Playground](https://sfc.vuejs.org/).
9594

9695
في المشاريع الفعلية ، ندمج عادة مُترجم SFC مع أداة بناء مثل [Vite](https://vitejs.dev/) أو [Vue CLI](http://cli.vuejs.org/) (التي تعتمد على [webpack](https://webpack.js.org/)) ، وتوفر Vue أدوات تخطيط رسمية لبدء العمل مع ملفات SFC بأسرع ما يمكن. تحقق من المزيد من التفاصيل في قسم [أدوات SFC](/guide/scaling-up/tooling).
9796

98-
## ماذا عن فصل الإهتمامات؟ {#what-about-separation-of-concerns}
97+
## ماذا عن فصل نوع الشيفرات؟ {#what-about-separation-of-concerns}
9998

100-
بعض المستخدمين القادمين من خلفية تطوير الويب التقليدية قد يكون لديهم القلق من أن المكونات أحادية الملف تخلط اهتمامات مختلفة في نفس المكان - والتي كان من المفترض أن تفصلها HTML / CSS / JS!
99+
بعض المستخدمين القادمين من خلفية تطوير الويب التقليدية قد يكون لديهم القلق من أن المكونات أحادية الملف تخلط نوع شيفرات مختلفة في نفس المكان - والتي كان من المفترض أن تفصلها HTML / CSS / JS!
101100

102-
للإجابة على هذا السؤال، من المهم بالنسبة لنا الاتفاق على أن **فصل الاهتمامات لا يعني فصل أنواع الملفات.** الهدف النهائي من مبادئ الهندسة هو تحسين قابلية صيانة الشيفرة البرمجية. فصل الاهتمامات، عند تطبيقه بشكل متعصب كفصل أنواع الملفات، لا يساعدنا في تحقيق هذا الهدف في سياق تطبيقات الواجهة الأمامية المعقدة بشكل متزايد.
101+
للإجابة على هذا السؤال، من المهم بالنسبة لنا الاتفاق على أن **فصل نوع الشيفرات لا يعني فصل أنواع الملفات.** الهدف النهائي من مبادئ الهندسة هو تحسين قابلية صيانة الشيفرة البرمجية. فصل نوع الشيفرات عند تطبيقه بشكل متعصب كفصل أنواع الملفات، لا يساعدنا في تحقيق هذا الهدف في سياق تطبيقات الواجهة الأمامية المعقدة بشكل متزايد.
103102

104103
في تطوير واجهة المستخدم الحديثة ، وجدنا أنه بدلاً من تقسيم الشيفرة البرمجية إلى ثلاث طبقات ضخمة تتشابك مع بعضها البعض ، فمن المنطقي تقسيمها إلى مكونات غير مترابطة وتشكيلهم معا. داخل مُكون، فإن قالبه ومنطقه وأنماطه مقترنة بطبيعتها، ويجعل تجميعهم معًا المكون أكثر تماسكًا وقابلية للصيانة.
105104

0 commit comments

Comments
 (0)