diff --git a/src/components/Layout/Footer.tsx b/src/components/Layout/Footer.tsx index 9cdf256fb..4631a3f89 100644 --- a/src/components/Layout/Footer.tsx +++ b/src/components/Layout/Footer.tsx @@ -284,7 +284,7 @@ export function Footer() {
- Copyright © Meta Platforms, Inc + حقوق الطبع والنشر © منصة ميتا، المحدودة
- Learn React + تعلم React - Quick Start - Installation + البدء السريع + تثبيت - Describing the UI + وصف واجهة المستخدم - Adding Interactivity + إضافة التفاعل - Managing State - Escape Hatches + إدارة الدولة + فتحات الهروب
- API Reference + API مرجع + + + واجهات برمجة التطبيقات React + + + واجهات برمجة تطبيقات React DOM - React APIs - React DOM APIs
- Community + مجتمع - Code of Conduct + مدونة لقواعد السلوك - Meet the Team + تعرف على الفريق - Docs Contributors + مساهمو الوثائق - Acknowledgements + الشكر والتقدير
- More - Blog + أكثر + مدونة React Native - Privacy + خصوصية - Terms + شروط
+

{children}

); @@ -136,7 +136,7 @@ export function HomeContent() { React

- The library for web and native user interfaces + المكتبة الخاصة بواجهات المستخدم الأصلية والويب

- Learn React + label="تعلم React"> + تعلم React - API Reference + label="مرجع API"> + مرجع API
-
Create user interfaces from components
+
إنشاء واجهات المستخدم من المكونات
- React lets you build user interfaces out of individual pieces - called components. Create your own React components like{' '} - Thumbnail, LikeButton, and{' '} - Video. Then combine them into entire screens, pages, - and apps. + يتيح لك React إنشاء واجهات مستخدم من أجزاء فردية تسمى المكونات. قم + بإنشاء مكونات React الخاصة بك مثل الصورة المصغرة و + زر الإعجاب و فيديو. ثم قم بدمجها في + شاشات وصفحات وتطبيقات كاملة.
@@ -174,22 +173,20 @@ export function HomeContent() {
- Whether you work on your own or with thousands of other - developers, using React feels the same. It is designed to let you - seamlessly combine components written by independent people, - teams, and organizations. + سواء كنت تعمل بمفردك أو مع آلاف المطورين الآخرين، فإن استخدام + React يمنحك نفس الشعور. فهو مصمم للسماح لك بدمج المكونات التي + كتبها أشخاص مستقلون وفرق ومؤسسات بسلاسة.
-
Write components with code and markup
+
كتابة المكونات باستخدام الكود والترميز
- React components are JavaScript functions. Want to show some - content conditionally? Use an if statement. - Displaying a list? Try array map(). Learning React is - learning programming. + مكونات React عبارة عن وظائف JavaScript. هل تريد عرض بعض المحتوى + بشروط؟ استخدم عبارة if. هل تريد عرض قائمة؟ جرب + المصفوفة map(). تعلم React هو تعلم البرمجة.
@@ -197,22 +194,22 @@ export function HomeContent() {
- This markup syntax is called JSX. It is a JavaScript syntax - extension popularized by React. Putting JSX markup close to - related rendering logic makes React components easy to create, - maintain, and delete. + يُطلق على صيغة ترميز النص هذه اسم JSX. وهي عبارة عن امتداد لصيغة + ترميز النص JavaScript تم ترويجه بواسطة React. إن وضع صيغة ترميز + النص JSX بالقرب من منطق العرض المرتبط يجعل إنشاء مكونات React + وصيانتها وحذفها أمرًا سهلاً.
-
Add interactivity wherever you need it
+
أضف التفاعل أينما كنت في حاجة إليه
- React components receive data and return what should appear on the - screen. You can pass them new data in response to an interaction, - like when the user types into an input. React will then update the - screen to match the new data. + تتلقى مكونات React البيانات وتعيد ما يجب أن يظهر على الشاشة. يمكنك + تمرير بيانات جديدة إليهم استجابةً للتفاعل، مثل عندما يكتب المستخدم + في حقل إدخال. ثم يقوم React بتحديث الشاشة لتتوافق مع البيانات + الجديدة.
@@ -220,16 +217,15 @@ export function HomeContent() {
- You don’t have to build your whole page in React. Add React to - your existing HTML page, and render interactive React components - anywhere on it. + لا يتعين عليك إنشاء صفحتك بالكامل في React. أضف React إلى صفحتك + HTML الحالية، وقم بعرض مكونات React التفاعلية في أي مكان بها.
- Add React to your page + أضف React إلى صفحتك
@@ -238,14 +234,14 @@ export function HomeContent() {
- Go full-stack
- with a framework + انتقل إلى المجموعة الكاملة +
باستخدام إطار عمل
- React is a library. It lets you put components together, but it - doesn’t prescribe how to do routing and data fetching. To build an - entire app with React, we recommend a full-stack React framework - like Next.js or{' '} + React عبارة عن مكتبة. تتيح لك تجميع المكونات معًا، لكنها لا تحدد + كيفية القيام بالتوجيه وجلب البيانات. لبناء تطبيق كامل باستخدام + React، نوصي باستخدام إطار عمل React كامل المكدس مثل{' '} + Next.js أو{' '} Remix.
@@ -254,17 +250,17 @@ export function HomeContent() {
- React is also an architecture. Frameworks that implement it let - you fetch data in asynchronous components that run on the server - or even during the build. Read data from a file or a database, and - pass it down to your interactive components. + React هو أيضًا بنية معمارية. تتيح لك الأطر التي تنفذها جلب + البيانات في مكونات غير متزامنة تعمل على الخادم أو حتى أثناء + البناء. اقرأ البيانات من ملف أو قاعدة بيانات، ثم مررها إلى مكوناتك + التفاعلية.
- Get started with a framework + البدء بالإطار
@@ -272,12 +268,12 @@ export function HomeContent() {
-
Use the best from every platform
+
استخدم الأفضل من كل منصة
- People love web and native apps for different reasons. React - lets you build both web apps and native apps using the same - skills. It leans upon each platform’s unique strengths to let - your interfaces feel just right on every platform. + يحب الناس تطبيقات الويب والتطبيقات الأصلية لأسباب مختلفة. يتيح + لك React إنشاء تطبيقات الويب والتطبيقات الأصلية باستخدام نفس + المهارات. فهو يعتمد على نقاط القوة الفريدة لكل منصة لجعل واجهاتك + تبدو مناسبة تمامًا على كل منصة.
@@ -291,15 +287,15 @@ export function HomeContent() {

- Stay true to the web + البقاء على اتصال دائم بالويب

- People expect web app pages to load fast. On the server, - React lets you start streaming HTML while you’re still - fetching data, progressively filling in the remaining - content before any JavaScript code loads. On the client, - React can use standard web APIs to keep your UI - responsive even in the middle of rendering. + يتوقع الأشخاص أن يتم تحميل صفحات تطبيقات الويب بسرعة. + على الخادم، يتيح لك React بدء بث HTML أثناء استمرارك في + جلب البيانات، وملء المحتوى المتبقي تدريجيًا قبل تحميل أي + كود JavaScript. على العميل، يمكن لـ React استخدام واجهات + برمجة تطبيقات الويب القياسية للحفاظ على استجابة واجهة + المستخدم الخاصة بك حتى في منتصف العرض.

@@ -377,21 +373,20 @@ export function HomeContent() {

- Go truly native + اذهب إلى الأصل الحقيقي

- People expect native apps to look and feel like their - platform.{' '} + يتوقع الناس أن تبدو التطبيقات الأصلية وكأنها منصاتهم.{' '} React Native {' '} - and{' '} + و{' '} Expo{' '} - let you build apps in React for Android, iOS, and - more. They look and feel native because their UIs{' '} - are truly native. It’s not a web view—your - React components render real Android and iOS views - provided by the platform. + تتيح لك إنشاء تطبيقات في React لنظامي التشغيل Android + وiOS والمزيد. تبدو هذه التطبيقات وكأنها أصلية لأن + واجهات المستخدم الخاصة بها أصلية حقًا. إنها + ليست عرضًا للويب - حيث تقدم مكونات React الخاصة بك + عروض Android وiOS الحقيقية التي توفرها المنصة.

@@ -401,14 +396,14 @@ export function HomeContent() {
- With React, you can be a web and a native developer. Your - team can ship to many platforms without sacrificing the user - experience. Your organization can bridge the platform silos, and - form teams that own entire features end-to-end. + مع React، يمكنك أن تكون مطور ويب ومطورًا أصليًا. يمكن لفريقك + الشحن إلى العديد من المنصات دون التضحية بتجربة المستخدم. يمكن + لمؤسستك ربط صوامع المنصات، وتشكيل فرق تمتلك الميزات بالكامل من + البداية إلى النهاية.
- Build for native platforms + بناء للمنصات الأصلية
@@ -419,23 +414,23 @@ export function HomeContent() {
-
Upgrade when the future is ready
+
قم بالتحديث عندما يكون المستقبل جاهزًا
- React approaches changes with care. Every React commit is - tested on business-critical surfaces with over a billion - users. Over 100,000 React components at Meta help validate - every migration strategy. + تتعامل React مع التغييرات بعناية. يتم اختبار كل التزام React + على الأسطح المهمة للأعمال مع أكثر من مليار مستخدم. يساعد أكثر + من 100000 مكون React في Meta في التحقق من صحة كل استراتيجية + هجرة.
- The React team is always researching how to improve React. - Some research takes years to pay off. React has a high bar - for taking a research idea into production. Only proven - approaches become a part of React. + يبحث فريق React دائمًا عن كيفية تحسين React. تستغرق بعض + الأبحاث سنوات حتى تؤتي ثمارها. لدى React معيار مرتفع لأخذ + فكرة بحثية إلى الإنتاج. فقط الأساليب المثبتة تصبح جزءًا من + React.
- Read more React news + اقرأ المزيد من أخبار React
@@ -443,7 +438,7 @@ export function HomeContent() {

- Latest React News + أحدث أخبار React

@@ -461,7 +456,7 @@ export function HomeContent() {
- Read more React news + اقرأ المزيد من أخبار React
@@ -474,13 +469,12 @@ export function HomeContent() {
- Join a community
- of millions + انضم إلى مجتمع
+ المكون من ملايين
- You’re not alone. Two million developers from all over the - world visit the React docs every month. React is something - that people and teams can agree on. + لست وحدك. يزور مليونا مطور من جميع أنحاء العالم مستندات React + كل شهر. React هو شيء يمكن للأشخاص والفرق الاتفاق عليه.
@@ -488,13 +482,12 @@ export function HomeContent() {
- This is why React is more than a library, an architecture, or - even an ecosystem. React is a community. It’s a place where - you can ask for help, find opportunities, and meet new - friends. You will meet both developers and designers, - beginners and experts, researchers and artists, teachers and - students. Our backgrounds may be very different, but React - lets us all create user interfaces together. + لهذا السبب، يعد React أكثر من مجرد مكتبة أو بنية أو حتى نظام + بيئي. React عبارة عن مجتمع. إنه مكان يمكنك من خلاله طلب + المساعدة والعثور على الفرص ومقابلة أصدقاء جدد. ستلتقي بكل من + المطورين والمصممين، والمبتدئين والخبراء، والباحثين والفنانين، + والمعلمين والطلاب. قد تكون خلفياتنا مختلفة جدًا، لكن React + تتيح لنا جميعًا إنشاء واجهات مستخدم معًا.
@@ -511,15 +504,14 @@ export function HomeContent() {
- Welcome to the
- React community + مرحبًا بك في
مجتمع React
- Get Started + label="خذ البرنامج التعليمي"> + البدء
diff --git a/src/components/Layout/TopNav/TopNav.tsx b/src/components/Layout/TopNav/TopNav.tsx index cc5c654e3..f178b2c10 100644 --- a/src/components/Layout/TopNav/TopNav.tsx +++ b/src/components/Layout/TopNav/TopNav.tsx @@ -308,7 +308,7 @@ export default function TopNav({ )} onClick={onOpenSearch}> - Search + يبحث @@ -321,18 +321,18 @@ export default function TopNav({
- Learn + يتعلم - Reference + مرجع - Community + مجتمع - Blog + مدونة
@@ -408,20 +408,20 @@ export default function TopNav({
- Learn + يتعلم - Reference + مرجع - Community + مجتمع - Blog + مدونة
-If you want to build a new app or a new website fully with React, we recommend picking one of the React-powered frameworks popular in the community. +إذا كنت تريد إنشاء تطبيق جديد أو موقع ويب جديد بالكامل باستخدام React، فنوصيك باختيار أحد الأطر المدعومة بـ React والتي تحظى بشعبية في المجتمع. -You can use React without a framework, however we’ve found that most apps and sites eventually build solutions to common problems such as code-splitting, routing, data fetching, and generating HTML. These problems are common to all UI libraries, not just React. +يمكنك استخدام React بدون إطار عمل، ولكننا وجدنا أن معظم التطبيقات والمواقع تبني في النهاية حلولاً لمشاكل شائعة مثل تقسيم التعليمات البرمجية والتوجيه وجلب البيانات وإنشاء HTML. هذه المشاكل شائعة في جميع مكتبات واجهة المستخدم، وليس فقط React. -By starting with a framework, you can get started with React quickly, and avoid essentially building your own framework later. +من خلال البدء بإطار عمل، يمكنك البدء في استخدام React بسرعة، وتجنب بناء إطار العمل الخاص بك لاحقًا. -#### Can I use React without a framework? {/*can-i-use-react-without-a-framework*/} +#### هل يمكنني استخدام React بدون إطار عمل؟ {/*can-i-use-react-without-a-framework*/} -You can definitely use React without a framework--that's how you'd [use React for a part of your page.](/learn/add-react-to-an-existing-project#using-react-for-a-part-of-your-existing-page) **However, if you're building a new app or a site fully with React, we recommend using a framework.** +يمكنك بالتأكيد استخدام React بدون إطار عمل - هكذا يمكنك [استخدم React لجزء من صفحتك.](/learn/add-react-to-an-existing-project#using-react-for-a-part-of-your-existing-page) **ومع ذلك، إذا كنت تقوم ببناء تطبيق جديد أو موقع كامل باستخدام React، فنوصيك باستخدام إطار عمل.** -Here's why. +إليك السبب. -Even if you don't need routing or data fetching at first, you'll likely want to add some libraries for them. As your JavaScript bundle grows with every new feature, you might have to figure out how to split code for every route individually. As your data fetching needs get more complex, you are likely to encounter server-client network waterfalls that make your app feel very slow. As your audience includes more users with poor network conditions and low-end devices, you might need to generate HTML from your components to display content early--either on the server, or during the build time. Changing your setup to run some of your code on the server or during the build can be very tricky. +حتى إذا لم تكن بحاجة إلى التوجيه أو جلب البيانات في البداية، فمن المحتمل أن ترغب في إضافة بعض المكتبات لها. ومع نمو حزمة JavaScript الخاصة بك مع كل ميزة جديدة، فقد تضطر إلى معرفة كيفية تقسيم التعليمات البرمجية لكل مسار على حدة. ومع تزايد تعقيد احتياجات جلب البيانات، فمن المحتمل أن تواجه شلالات شبكة الخادم والعميل التي تجعل تطبيقك يبدو بطيئًا للغاية. نظرًا لأن جمهورك يتضمن المزيد من المستخدمين الذين يعانون من ظروف شبكة سيئة وأجهزة منخفضة الأداء، فقد تحتاج إلى إنشاء HTML من مكوناتك لعرض المحتوى مبكرًا - إما على الخادم أو أثناء وقت البناء. قد يكون تغيير الإعداد لتشغيل بعض التعليمات البرمجية الخاصة بك على الخادم أو أثناء البناء أمرًا صعبًا للغاية. -**These problems are not React-specific. This is why Svelte has SvelteKit, Vue has Nuxt, and so on.** To solve these problems on your own, you'll need to integrate your bundler with your router and with your data fetching library. It's not hard to get an initial setup working, but there are a lot of subtleties involved in making an app that loads quickly even as it grows over time. You'll want to send down the minimal amount of app code but do so in a single client–server roundtrip, in parallel with any data required for the page. You'll likely want the page to be interactive before your JavaScript code even runs, to support progressive enhancement. You may want to generate a folder of fully static HTML files for your marketing pages that can be hosted anywhere and still work with JavaScript disabled. Building these capabilities yourself takes real work. +**هذه المشاكل ليست خاصة بـ React. ولهذا السبب فإن Svelte لديه SvelteKit، وVue لديه Nuxt، وما إلى ذلك.** لحل هذه المشاكل بنفسك، ستحتاج إلى دمج bundler الخاص بك مع جهاز التوجيه الخاص بك ومع مكتبة جلب البيانات الخاصة بك. ليس من الصعب تشغيل الإعداد الأولي، ولكن هناك الكثير من التفاصيل الدقيقة المتضمنة في إنشاء تطبيق يتم تحميله بسرعة حتى مع نموه بمرور الوقت. ستحتاج إلى إرسال الحد الأدنى من كود التطبيق ولكن افعل ذلك في رحلة ذهاب وعودة واحدة بين العميل والخادم، بالتوازي مع أي بيانات مطلوبة للصفحة. من المحتمل أن ترغب في أن تكون الصفحة تفاعلية قبل تشغيل كود JavaScript الخاص بك، لدعم التحسين التدريجي. قد ترغب في إنشاء مجلد من ملفات HTML ثابتة تمامًا لصفحات التسويق الخاصة بك والتي يمكن استضافتها في أي مكان ولا تزال تعمل مع تعطيل JavaScript. إن بناء هذه القدرات بنفسك يتطلب عملاً حقيقيًا. -**React frameworks on this page solve problems like these by default, with no extra work from your side.** They let you start very lean and then scale your app with your needs. Each React framework has a community, so finding answers to questions and upgrading tooling is easier. Frameworks also give structure to your code, helping you and others retain context and skills between different projects. Conversely, with a custom setup it's easier to get stuck on unsupported dependency versions, and you'll essentially end up creating your own framework—albeit one with no community or upgrade path (and if it's anything like the ones we've made in the past, more haphazardly designed). +**تحل أطر عمل React الموجودة في هذه الصفحة مشكلات مثل هذه افتراضيًا، دون أي عمل إضافي من جانبك.** فهي تتيح لك البدء بشكل بسيط للغاية ثم توسيع نطاق تطبيقك بما يتناسب مع احتياجاتك. يحتوي كل إطار عمل React على مجتمع، لذا فإن العثور على إجابات للأسئلة وترقية الأدوات أسهل. كما تمنح الأطر هيكلًا لكودك، مما يساعدك أنت والآخرين على الاحتفاظ بالسياق والمهارات بين المشاريع المختلفة. وعلى العكس من ذلك، مع الإعداد المخصص، من الأسهل التعثر في إصدارات التبعية غير المدعومة، وستنتهي في الأساس إلى إنشاء إطار العمل الخاص بك - وإن كان بدون مجتمع أو مسار ترقية (وإذا كان يشبه تلك التي صنعناها في الماضي، فهو مصمم بشكل أكثر عشوائية). -If your app has unusual constraints not served well by these frameworks, or you prefer to solve these problems yourself, you can roll your own custom setup with React. Grab `react` and `react-dom` from npm, set up your custom build process with a bundler like [Vite](https://vitejs.dev/) or [Parcel](https://parceljs.org/), and add other tools as you need them for routing, static generation or server-side rendering, and more. +إذا كان تطبيقك يحتوي على قيود غير عادية لا تخدمها هذه الأطر بشكل جيد، أو كنت تفضل حل هذه المشكلات بنفسك، فيمكنك إنشاء إعداد مخصص خاص بك باستخدام React. احصل على `react` و`react-dom` من npm، وقم بإعداد عملية البناء المخصصة الخاصة بك باستخدام حزمة مثل [Vite](https://vitejs.dev/) أو [Parcel](https://parceljs.org/)، وأضف أدوات أخرى حسب الحاجة إليها للتوجيه أو التوليد الثابت أو العرض من جانب الخادم، والمزيد. -## Production-grade React frameworks {/*production-grade-react-frameworks*/} +## أطر عمل React المخصصة للإنتاج {/*production-grade-react-frameworks*/} These frameworks support all the features you need to deploy and scale your app in production and are working towards supporting our [full-stack architecture vision](#which-features-make-up-the-react-teams-full-stack-architecture-vision). All of the frameworks we recommend are open source with active communities for support, and can be deployed to your own server or a hosting provider. If you’re a framework author interested in being included on this list, [please let us know](https://github.com/reactjs/react.dev/issues/new?assignees=&labels=type%3A+framework&projects=&template=3-framework.yml&title=%5BFramework%5D%3A+).