توجيه AngularJs باستخدام المعلمات

⚡ ملخص ذكي

يحوّل التوجيه في AngularJS صفحة HTML واحدة إلى تطبيق متعدد العرض باستخدام الخريطةping URL يتم تحويل الأجزاء إلى قوالب ووحدات تحكم. تقوم وحدة ngRoute وخدمة $routeProvider بتحديد هذه الخرائطpingبينما يقوم توجيه ng-view بإدخال القالب المطابق.

  • 🧩 الآلية الأساسية: يقوم $routeProvider بمطابقة الجزء الذي يلي رمز # ويقوم بتحميل قالب URL ووحدة التحكم المقترنة في ng-view.
  • 📦 التبعية المطلوبة: توجد عملية التوجيه خارج المكتبة الأساسية، لذلك يجب الإشارة إلى angular-route.js وتعريف ngRoute في الوحدة.
  • 🎯 المسار الافتراضي: تقوم كتلة "وإلا" بإعادة توجيه أي مسار غير مطابق، مما يمنع ظهور شاشة فارغة عند تحميل التطبيق لأول مرة.
  • 🔢 معلمات المسار: يُستخدم عنصر نائب مثل :topicId لالتقاط URL الأجزاء، التي يقرأها المتحكم من خلال $routeParams.
  • ⏳ التحميل المسبق للبيانات: تُنهي خاصية resolve جلب البيانات قبل تشغيل وحدة التحكم، لذلك لا يتم عرض العرض أبدًا في حالة فارغة.
  • 🔗 نظيف URLs: يؤدي تعيين html5Mode على $locationProvider إلى إزالة التجزئة، على الرغم من أنه يجب على الخادم بعد ذلك إعادة كتابة المسارات غير المعروفة إلى الصفحة الأساسية.

توجيه AngularJS مع المعلمات

قبل أن نتناول كيفية عمل التوجيه في AngularJS، من المفيد فهم نوع التطبيق الذي صُمم التوجيه لأجله. يحدد القسم التالي هذا السياق، وتعتمد كل تقنية لاحقة عليه.

ما هي تطبيقات الصفحة الواحدة؟

تطبيقات الصفحة الواحدة (SPA) هي تطبيقات ويب تقوم بتحميل صفحة HTML واحدة ثم تحديثها ديناميكيًا أثناء تفاعل المستخدم معها. فبدلاً من طلب مستند جديد من الخادم مع كل نقرة، يقوم تطبيق الصفحة الواحدة باستبدال الجزء المتغير فقط من الصفحة.

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

ما هو التوجيه في AngularJS؟

التوجيه في AngularJS هي طريقة تسمح لك بإنشاء تطبيقات صفحة واحدة. فهي تمكنك من إنشاء تطبيقات مختلفة URLتُستخدم هذه الميزة لعرض محتوى مختلف في تطبيقات الويب الخاصة بك. كما يساعد توجيه AngularJS على عرض محتويات متعددة بناءً على المسار المُختار. ويتم تحديد ذلك في URL بعد علامة التوقيع.

لنأخذ مثالاً على موقع يتم استضافته عبر URL http://example.com/index.html.

تستضيف هذه الصفحة الشاشة الرئيسية لتطبيقك. لنفترض أن التطبيق ينظم فعالية ما، ويرغب المستخدم في عرض قائمة الفعاليات، أو استعراض تفاصيل إحداها، أو حذف إحداها. في تطبيق ذي صفحة واحدة مع تمكين التوجيه، تتوفر كل هذه الخيارات عبر الروابط التالية.

سيتم استخدام الرمز # مع المسارات المختلفة (ShowEvent وDisplayEvent وDeleteEvent).

  • للاطلاع على جميع الأحداث، يتم توجيه المستخدم إلى http://example.com/index.html#ShowEvent
  • لمشاهدة حدث معين، يتم توجيههم إلى http://example.com/index.html#DisplayEvent
  • لحذف حدث، يتم توجيههم إلى http://example.com/index.html#DeleteEvent

لاحظ أن الرئيسي URL يبقى كما هو. يتغير فقط الجزء الذي يلي علامة #، وهذا الجزء هو ما يراقبه AngularJS. بعد توضيح المفهوم، يتناول القسم التالي المكونات التي يجب ربطها قبل أن يعمل أي شيء.

إضافة مسار AngularJS باستخدام $routeProvider

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

من أجل تنفيذ التوجيه، يجب تنفيذ الخطوات الرئيسية التالية في تطبيقك بأي ترتيب محدد.

  1. راجع ملف angular-route.js. هذا Javaسيناريو ملف، تم تطويره بواسطة Google، يحتوي على جميع وظائف التوجيه ويجب تضمينه حتى يتمكن التطبيق من الرجوع إلى احتياجات التوجيه الخاصة بالوحدات.
  2. أضف تبعية إلى وحدة ngRoute من داخل تطبيقك. بدون هذه التبعية، لا يمكن استخدام التوجيه في تطبيق AngularJS على الإطلاق.

وفيما يلي بناء الجملة العام لهذا البيان. هذا مجرد إعلان عادي لوحدة تتضمن الكلمة الأساسية ngRoute.

var module = angular.module("sampleApp", ['ngRoute']);
  1. قم بتكوين $routeProvider الخاص بك. يوفر هذا المسارات المختلفة في تطبيقك، ويشير بناء الجملة ببساطة إلى أنه عند اختيار المسار ذي الصلة، استخدم المسار لعرض العرض المحدد.
when(path, route)
  1. روابط إلى مسارك من داخل صفحة HTML الخاصة بك. في صفحة HTML الخاصة بك، ستضيف روابط مرجعية لمختلف المسارات المتاحة في تطبيقك.
<a href="#!/route1">Route 1</a><br/>
  1. وأخيرا سيكون إدراج توجيه ng-view، والتي عادة ما تكون في علامة div. سيتم استخدام هذا لإدخال محتوى العرض عند اختيار المسار ذي الصلة.

؟؟؟؟ تلميح: جميع الخطوات الخمس إلزامية. يُعدّ غياب مرجع angular-route.js السبب الأكثر شيوعًا لعدم تنفيذ المسار لأي إجراء، لأنّ $routeProvider غير موجود بدونه. يجمع القسم التالي الخطوات الخمس في مثال عملي.

مثال على توجيه AngularJS

الآن، دعونا نلقي نظرة على مثال للتوجيه باستخدام الخطوات المذكورة أعلاه.

في مثالنا لتوجيه AngularJS مع المعلمات،

  • أحد الروابط هو عرض المواضيع لـ AngularJS بالطبع، والآخر هو ل Node.js بالطبع.
  • عندما يقوم المستخدم بالنقر فوق أي رابط، سيتم عرض مواضيع تلك الدورة.

الخطوة 1) قم بتضمين ملف المسار الزاوي كمرجع للبرنامج النصي.

التوجيه AngularJS

يُعدّ ملف التوجيه هذا ضروريًا للاستفادة من وظائف وجود مسارات وعروض متعددة. ويمكن تنزيل هذا الملف من موقع AngularJS الإلكتروني.

الخطوة 2) أضف علامات href التي ستمثل روابط إلى "Angular JS Topics" و"Node JS Topics".

التوجيه AngularJS

الخطوة 3) أضف علامة div باستخدام التوجيه ng-view الذي سيمثل العرض.

سيسمح هذا بإدخال العرض المقابل عندما ينقر المستخدم على "Angular JS Topics" أو "Node JS Topics".

التوجيه AngularJS

الخطوة 4) في علامة البرنامج النصي الخاصة بك لـ AngularJS، أضف "وحدة ngRoute" وخدمة "$routeProvider".

التوجيه AngularJS

Code التفسير:

  1. قم بتضمين "وحدة ngRoute". مع وجود هذه الوحدة، يتولى Angular عملية التوجيه تلقائيًا ويفهم جميع أوامر التوجيه.
  2. خدمة $routeProvider هي خدمة تستمع في الخلفية إلى المسارات التي يتم استدعاؤها. عندما ينقر المستخدم على رابط، تكتشف هذه الخدمة ذلك وتحدد المسار الذي يجب اتباعه.
  3. قم بإنشاء مسار واحد لرابط Angular: عند النقر عليه، قم بحقن Angular.html واستخدم 'AngularController' لمنطق العمل.
  4. قم بإنشاء مسار واحد لرابط Node، والذي يقوم بحقن Node.html ويستخدم 'NodeController' بنفس الطريقة.

الخطوة 5) التالي هو إضافة وحدات تحكم لمعالجة منطق الأعمال لكل من AngularController وNodeController.

في كل وحدة تحكم، نقوم بإنشاء مصفوفة من أزواج المفاتيح والقيم لتخزين أسماء المواضيع وأوصافها لكل دورة. تتم إضافة متغير المصفوفة 'tutorial' إلى كائن النطاق لكل وحدة تحكم.

التوجيه AngularJS

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Event Registration</title>
</head>
<body ng-app="sampleApp">

<script src="https://code.angularjs.org/1.8.3/angular.min.js"></script>
<script src="https://code.angularjs.org/1.8.3/angular-route.js"></script>

<h1> Guru99 Global Event</h1>

<div class="container">
<ul>
<li><a href="#!/Angular">Angular JS Topics</a></li>
<li><a href="#!/Node">Node JS Topics</a></li>
</ul>
<div ng-view></div>
</div>

<script>
var sampleApp = angular.module('sampleApp', ['ngRoute']);

sampleApp.config(['$routeProvider',
function($routeProvider) {
  $routeProvider.
  when('/Angular', {
    templateUrl: 'Angular.html',
    controller: 'AngularController'
  }).
  when('/Node', {
    templateUrl: 'Node.html',
    controller: 'NodeController'
  });
}]);

sampleApp.controller('AngularController', function($scope) {
  $scope.tutorial = [
    {Name: "Controllers", Description: "Controllers in action"},
    {Name: "Models", Description: "Models and binding data"},
    {Name: "Directives", Description: "Flexibility of Directives"}
  ];
});

// NodeController follows the same shape with Node.js topics
sampleApp.controller('NodeController', function($scope) {
  $scope.tutorial = [{Name: "Promises", Description: "Power of Promises"}];
});
</script>
</body>
</html>

⚠️ تم تطبيق التصحيحات. استخدم <title> العلامة كانت بالداخل <body>, chrset="UTF 8" تم تهجئتها بشكل خاطئ، يشير الرابط الثاني إلى #Node.html بدلاً من المسار المسجل /Node، وكانت مسارات القوالب تحمل شرطة مائلة في البداية يتم حلها من جذر المجال.

التوجيه AngularJS

الخطوة 6) قم بإنشاء صفحات تسمى Angular.html وNode.html. لكل صفحة نقوم بتنفيذ الخطوات التالية.

ستضمن هذه الخطوات عرض جميع أزواج القيمة الرئيسية للمصفوفة على كل صفحة.

  1. باستخدام نانوغرام تكرار التوجيه المرور على كل زوج من المفتاح والقيمة المحدد في متغير البرنامج التعليمي.
  2. عرض اسم ووصف كل زوج من قيمة المفتاح.
  • Angular.html
<h2>Angular</h2>
<ul ng-repeat="ptutor in tutorial">
<li>Course : {{ptutor.Name}} - {{ptutor.Description}}</li>
</ul>
  • Node.html — مطابق للقائمة أعلاه، مع تغيير العنوان إلى "عقدة". كلا القالبين متطابقان في المحتوى. tutorial متغير، والذي يوفره كل متحكم من نطاقه الخاص.

التوجيه AngularJS

⚠️ تصحيح: كان العنوان في ملف Angular.html الأصلي هو "Anguler". تم تصحيح التهجئة أعلاه.

إذا تم تنفيذ الكود بنجاح، فسيتم عرض المخرجات التالية عند تشغيل الكود الخاص بك في المتصفح.

الإخراج:

التوجيه AngularJS

إذا نقرت على رابط مواضيع AngularJS، فسيتم عرض المخرجات أدناه.

التوجيه AngularJS

ويبين الإخراج بوضوح أن،

  • عند النقر على الرابط "Angular JS Topics"، يقرر RouteProvider الذي أعلناه في الكود الخاص بنا أنه يجب إدخال كود Angular.html.
  • سيتم إدخال هذا الرمز في علامة "div"، التي تحتوي على توجيه ng-view. كما أن محتوى وصف الدورة التدريبية يأتي من "متغير البرنامج التعليمي" الذي كان جزءًا من كائن النطاق المحدد في AngularController.
  • عندما ينقر أحد على Node.js المواضيع، ستحدث نفس النتيجة، وسيظهر العرض الخاص بموضوعات Node.js.
  • لاحظ أيضًا أن الصفحة URL يبقى كما هو. يتغير المسار الذي يلي علامة # فقط، وهذا هو مفهوم تطبيقات الصفحة الواحدة. علامة #hash في URL هو فاصل بين المسار (الذي هو في حالتنا 'Angular') وصفحة HTML الرئيسية (Sample.html).

التوجيه AngularJS

يعمل هذا المثال فقط عندما ينقر المستخدم على رابط يطابق مسارًا مسجلاً. يتناول القسم التالي ما يجب أن يحدث عندما لا يتطابق أي رابط.

إنشاء مسار افتراضي في AngularJS

يوفر التوجيه في AngularJS أيضًا إمكانية الحصول على مسار افتراضي. هذا هو المسار الذي يتم اختياره إذا لم يكن هناك تطابق للمسار الحالي.

يتم إنشاء المسار الافتراضي عن طريق إضافة الشرط التالي عند تعريف خدمة $routeProvider.

الصيغة أدناه تعني ببساطة إعادة التوجيه إلى صفحة مختلفة إذا لم تتطابق أي من المسارات الموجودة.

otherwise({
  redirectTo: 'page'
});

لنستخدم نفس المثال أعلاه ونضيف مسارًا افتراضيًا إلى خدمة $routeProvider الخاصة بنا.

إنشاء مسار افتراضي في AngularJS

sampleApp.config(['$routeProvider',
function($routeProvider) {
  $routeProvider.
  when('/Angular', {
    templateUrl: 'Angular.html',
    controller: 'AngularController'
  }).
  when('/Node', {
    templateUrl: 'Node.html',
    controller: 'NodeController'
  }).
  otherwise({
    redirectTo: '/Angular'
  });
}]);

Code التفسير:

  1. هنا نستخدم نفس الكود المذكور أعلاه، مع اختلاف بسيط يتمثل في استخدام عبارة "otherwise" وخيار "redirectTo" لتحديد العرض الذي يجب تحميله في حال عدم تحديد مسار. في حالتنا، نريد عرض صفحة "/Angular".

إذا تم تنفيذ الكود بنجاح، فسيتم عرض المخرجات التالية عند تشغيل الكود الخاص بك في المتصفح.

الإخراج:

إنشاء مسار افتراضي في AngularJS

من الإخراج،

  • يمكنك أن ترى بوضوح أن العرض الافتراضي المعروض هو عرض AngularJS.
  • يرجع ذلك إلى أنه عند تحميل الصفحة، تنتقل إلى خيار "otherwise" في وظيفة $routeProvider وتحمل عرض "/Angular".

يُحدد المسار الافتراضي أي عرض يتم تحميله. يتناول القسم التالي كيفية قيام مسار واحد بخدمة العديد من السجلات من خلال تضمين قيمة في URL.

كيفية الوصول إلى المعلمات من طريق AngularJS

توفر Angular أيضًا إمكانية تمرير المعلمات أثناء التوجيه. تُضاف المعلمات إلى نهاية المسار في URL، على سبيل المثال، http://guru99/index.html#/Angular/1. في مثال التوجيه الزاوي هذا،

  1. http://guru99/index.html هو تطبيقنا الرئيسي URL
  2. يرمز الرمز # إلى الفاصل بين التطبيق الرئيسي URL والطريق
  3. الزاوي هو طريقنا
  4. وأخيرًا، "1" هو المعلمة التي تمت إضافتها إلى طريقنا

بناء الجملة العام هو HTMLPage#/route/parameter، لذا تصبح المواضيع السابقة Sample.html#/Angular/1 و #/Angular/2 و #/Angular/3، حيث يكون الرقم هو معرف الموضوع.

دعونا نلقي نظرة تفصيلية على كيفية تنفيذ مسار Angular باستخدام معلمة.

الخطوة 1) أضف الكود التالي إلى العرض الخاص بك

  1. أضف جدولاً لعرض جميع مواضيع دورة Angular JS للمستخدم.
  2. أضف صفًا في الجدول لعرض موضوع "وحدات التحكم". بالنسبة لهذا الصف، اضبط قيمة href على "#!/Angular/1"، بحيث يؤدي النقر على الموضوع إلى تمرير المعامل 1 في URL على طول الطريق.
  3. أضف صفًا لموضوع "النماذج"، مع تعيين قيمة href إلى "#!/Angular/2" بحيث ينتقل المعامل 2 في URL.
  4. أضف صفًا لموضوع "التوجيهات"، مع تعيين قيمة href إلى "#!/Angular/3" بحيث ينتقل المعامل 3 في URL.

الوصول إلى المعلمات من طريق AngularJS

الخطوة الثانية: أضف معرّف الموضوع في دالة خدمة موفر المسار
في دالة خدمة موفر المسار، أضف :topicId يُستخدم هذا العنصر النائب للدلالة على أن أي مُعامل يتم تمريره في URL بعد ذلك، يجب تعيين المسار إلى المتغير topicId.

الوصول إلى المعلمات من طريق AngularJS

الخطوة 3) أضف الكود الضروري إلى وحدة التحكم

  1. تأكد من إضافة "$routeParams" كمعامل عند تعريف دالة المتحكم. سيتمكن هذا المعامل من الوصول إلى جميع معلمات المسار التي تم تمريرها في URL.
  2. يحتوي "$routeParams" على معرّف الموضوع الذي تم تمريره في المسار. إرفاق $routeParams.topicId في النطاق كما $scope.tutorialid يجعلها متاحة للعرض كمعرف تعليمي.

الوصول إلى المعلمات من طريق AngularJS

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Event Registration</title>
</head>
<body ng-app="sampleApp">

<script src="https://code.angularjs.org/1.8.3/angular.min.js"></script>
<script src="https://code.angularjs.org/1.8.3/angular-route.js"></script>

<h1> Guru99 Global Event</h1>
<table class="table table-striped">
<tbody>
<tr><td>1</td><td>Controllers</td>
<td><a href="#!/Angular/1">Topic details</a></td></tr>
<!-- rows 2 and 3 repeat with /Angular/2 and /Angular/3 -->
</tbody>
</table>
<div ng-view></div>

<script>
var sampleApp = angular.module('sampleApp', ['ngRoute']);

sampleApp.config(['$routeProvider',
function($routeProvider) {
  $routeProvider.
  when('/Angular/:topicId', {
    templateUrl: 'Angular.html',
    controller: 'AngularController'
  });
}]);

sampleApp.controller('AngularController', ['$scope', '$routeParams',
function($scope, $routeParams) {
  $scope.tutorialid = $routeParams.topicId;
}]);
</script>
</body>
</html>

⚠️ تم تطبيق التصحيحات. استخدمت النسخة الأصلية الحرف l بدلاً من الرقم 1 in href="#Angular/l"، تم حذف ng-view الحاوية، لذا لم يكن لدى القالب مكان لعرضه، وتم تحميله angular-route.js قبل angular.min.js، مما يؤدي إلى ظهور خطأ في الوحدة.

الخطوة الرابعة) أضف التعبير لعرض المتغير
أضف التعبير لعرض متغير البرنامج التعليمي في صفحة Angular.html.

الوصول إلى المعلمات من طريق AngularJS

<h2>Angular</h2>

<br><br>{{tutorialid}}

إذا تم تنفيذ الكود بنجاح، فسيتم عرض المخرجات التالية عند تشغيل الكود الخاص بك في المتصفح.

الإخراج:

الوصول إلى المعلمات من طريق AngularJS

في شاشة الإخراج،

  • إذا نقرت على رابط تفاصيل الموضوع للموضوع الأول، فسيتم إضافة الرقم 1 إلى URL.
  • يتم اعتبار هذا الرقم وسيطًا "routeParams" ويصبح متاحًا في وحدة التحكم.

قراءة المعامل أمر بسيط. أما جلب السجل الذي يحدده المعامل، قبل ظهور العرض، فهو مهمة الخاصية التي سيتم تناولها لاحقاً.

كيفية تحميل البيانات مسبقًا باستخدام خاصية resolve

يقوم المتحكم في القسم السابق بقراءة معرّف الموضوع وعرضه فورًا. أما التطبيقات الحقيقية، فيجب عليها أولًا جلب السجل من الخادم، وإذا تم عرض الصفحة قبل استجابة الطلب، فسيرى المستخدم قالبًا فارغًا يتم ملؤه بعد لحظات. resolve تعمل هذه الخاصية على إزالة وميض المحتوى الفارغ.

كل مفتاح داخل resolve الكائن هو تبعية تُجهزها AngularJS قبل تفعيل المسار. إذا كانت القيمة وعدًا، ينتظر الموجّه اكتماله. بعد اكتمال جميع الوعود، تُنشئ AngularJS وحدة التحكم وتُعرض القالب، وتُحقن القيم المُكتملة في وحدة التحكم بالاسم، تمامًا كما هو الحال مع أي خدمة أخرى.

sampleApp.config(['$routeProvider',
function($routeProvider) {
  $routeProvider.
  when('/Angular/:topicId', {
    templateUrl: 'Angular.html',
    controller: 'AngularController',
    resolve: {
      // The router waits for this promise before rendering
      topic: ['$http', '$route', function($http, $route) {
        var id = $route.current.params.topicId;
        return $http.get('/api/topics/' + id).then(function(response) {
          return response.data;
        });
      }]
    }
  });
}]);

// 'topic' is injected already resolved, so no loading state is needed
sampleApp.controller('AngularController', ['$scope', 'topic',
function($scope, topic) {
  $scope.topic = topic;
}]);

هناك سلوكان مهمان هنا. يؤدي رفض الوعد إلى إلغاء تغيير المسار وإبقاء المتصفح على العرض الحالي، لذا لا ينتج عن الطلب الفاشل صفحة معطوبة. مع ذلك، ولأن الموجّه يحجب العملية أثناء انتظار الوعد، فإن نقطة النهاية البطيئة تجعل التطبيق يبدو متجمداً. resolve مع مؤشر تقدم مدفوع بواسطة $routeChangeStart و $routeChangeSuccess التالي.

⚠️ : تحذير لا تقم أبدًا بوضع عمليات التحقق من المصادقة داخل resolveإن رفض مسار ما يخفي عرضًا ولكنه لا يحمي البيانات الموجودة خلفه، ويجب أن تظل نقطة نهاية API تفرض الوصول على الخادم.

إلى جانب تحميل البيانات مسبقًا، يمكن للمسار أيضًا أن يحمل قيمًا ثابتة للتكوين. الخدمة الموضحة لاحقًا هي كيفية قراءة وحدة التحكم لهذه القيم.

كيفية استخدام خدمة Angular $route

تتيح لك خدمة $route الوصول إلى خصائص المسار. تتوفر خدمة $route كمعامل عند تعريف الدالة في وحدة التحكم. يوضح الشكل أدناه الصيغة العامة لكيفية إتاحة معامل $route من وحدة التحكم.

myApp.controller('MyController', function($scope, $route) { ... });
  1. myApp هو وحدة AngularJS المُعرّفة لتطبيقك.
  2. MyController هو اسم وحدة التحكم المحددة لتطبيقك.
  3. وكما يقوم $scope بتمرير المعلومات من وحدة التحكم إلى العرض، فإن $route يكشف خصائص المسار الحالي.

دعونا نلقي نظرة على كيفية استخدام خدمة $route.

في هذا المثال،

  • سنقوم بإنشاء متغير مخصص بسيط يسمى "mytext"، والذي سيحتوي على السلسلة "This is angular".
  • سنقوم بربط هذا المتغير بمسارنا. Later سنقوم بالوصول إلى هذه السلسلة من وحدة التحكم الخاصة بنا باستخدام خدمة $route ثم نستخدم كائن النطاق لعرضها في العرض الخاص بنا.

لذا، دعونا نرى الخطوات التي يتعين علينا تنفيذها لتحقيق ذلك.

الخطوة 1) أضف زوجًا مخصصًا من قيمة المفتاح إلى المسار. نحن هنا نضيف مفتاحًا يسمى "mytext" ونخصص له قيمة "This is angular".

خدمة المسار $ الزاوي

الخطوة 2) أضف الكود ذي الصلة إلى وحدة التحكم.

  1. أضف المعامل $route إلى دالة المتحكم. يُعدّ المعامل $route معاملًا أساسيًا مُعرّفًا في Angular، يسمح بالوصول إلى خصائص المسار.
  2. يمكن الوصول إلى المتغير "mytext" الذي تم تعريفه في المسار عبر المرجع $route.current. ثم يتم تعيين هذا إلى متغير "النص" لكائن النطاق. يمكن بعد ذلك الوصول إلى متغير النص من العرض وفقًا لذلك.

خدمة المسار $ الزاوي

// Only the config and controller change; the page markup is unchanged
sampleApp.config(['$routeProvider',
function($routeProvider) {
  $routeProvider.
  when('/Angular/:topicId', {
    mytext: "This is angular",   // custom key attached to the route
    templateUrl: 'Angular.html',
    controller: 'AngularController'
  });
}]);

sampleApp.controller('AngularController', ['$scope', '$routeParams', '$route',
function($scope, $routeParams, $route) {
  $scope.tutorialid = $routeParams.topicId;
  $scope.text = $route.current.mytext;
}]);

الخطوة 3) أضف مرجعًا إلى متغير النص من كائن النطاق كتعبير. ستتم إضافة هذا إلى صفحة Angular.html كما هو موضح أدناه.

سيؤدي هذا إلى إدخال النص "هذا زاوي" في العرض. التعبير {{tutorialid}} هو نفسه الذي رأيناه في الموضوع السابق وهذا سيعرض الرقم "1".

خدمة المسار $ الزاوي

<h2>Angular</h2>

<br><br>{{text}}
<br><br>{{tutorialid}}

إذا تم تنفيذ الكود بنجاح، فسيتم عرض المخرجات التالية عند تشغيل الكود الخاص بك في المتصفح.

الإخراج:

خدمة المسار $ الزاوي

من الإخراج،

  • يمكننا أن نرى أن النص "هذا هو angular" يظهر أيضًا عندما ننقر على أي من الروابط في الجدول. كما يتم عرض معرف الموضوع في نفس وقت عرض النص.

كل ما URL لا يزال الرمز الموضح حتى الآن يحمل علامة #. ستزيله خطوة التكوين النهائية.

تمكين توجيه HTML5

تُستخدم تقنية التوجيه في HTML5 لإنشاء صفحات نظيفة URLيعني ذلك إزالة علامة التصنيف من URLإذن، التوجيه URLعند استخدام توجيه HTML5، ستظهر العناصر كما هو موضح أدناه.

Sample.html/Angular/1

Sample.html/Angular/2

Sample.html/Angular/3

يُعرف هذا المفهوم عادةً باسم تقديم شيء جميل URL للمستخدم.

هناك خطوتان رئيسيتان يجب تنفيذهما لتوجيه HTML2.

  1. تكوين $locationProvider
  2. تحديد قاعدتنا للروابط النسبية

دعونا نلقي نظرة تفصيلية على كيفية تنفيذ الخطوات المذكورة أعلاه في مثالنا.

الخطوة 1) أضف الكود ذي الصلة إلى وحدة Angular.

  1. إضافة <base> أضف الوسم إلى رأس المستند. هذا ضروري لتوجيه HTML5 حتى يعرف التطبيق موقعه الأساسي.
  2. أضف خدمة $locationProvider. تتيح لك هذه الخدمة تحديد وضع HTML5.
  3. اضبط html5Mode لخدمة $locationProvider على القيمة true.

تمكين توجيه HTML5

الخطوة 2) قم بإزالة جميع علامات # للروابط ('Angular/1'، 'Angular/2'، 'Angular/3') لإنشاء روابط سهلة القراءة URLs.

تمكين توجيه HTML5

<!-- In the head: required by html5Mode so relative templates resolve -->
<base href="/">

<!-- In the body: the # is dropped from every link -->
<a href="Angular/1">Topic details</a>

<script>
sampleApp.config(['$routeProvider', '$locationProvider',
function($routeProvider, $locationProvider) {
  $locationProvider.html5Mode(true);
  $routeProvider.
  when('/Angular/:topicId', {
    templateUrl: 'Angular.html',
    controller: 'AngularController'
  });
}]);
</script>

⚠️ تصحيح: أعلن الأصل baseUrl يشير ثابت إلى مسار IDE محلي، وهو أمر لا يؤثر على وضع HTML5. يقرأ AngularJS الموقع الأساسي من <base href> الوسم. تم حقن النسخة الأصلية أيضًا $locationProvider دون الحاجة إلى الاتصال html5Mode(true)لذلك لم تتم إزالة التجزئة أبدًا.

إذا تم تنفيذ الكود بنجاح، فسيتم عرض المخرجات التالية عند تشغيل الكود الخاص بك في المتصفح.

الإخراج:

تمكين توجيه HTML5

من الإخراج،

  • يمكنك أن ترى أن العلامة # غير موجودة عند الوصول إلى التطبيق.

يستخدم كل ما سبق ngRoute، وهو الموجّه الذي يوفره فريق AngularJS. وهو ليس الخيار الوحيد، وتوضح المقارنة أدناه متى يكون البديل هو الأنسب.

ngRoute مقابل ui-router: أي موجه تختار؟

يتم صيانة ngRoute بواسطة فريق AngularJS ويتوافق مع URL مباشرةً إلى قالب ووحدة تحكم واحدة. ui-router هو مشروع مجتمعي تم بناؤه لإزالة القيد الرئيسي لـ ngRoute: وهو المطابقة على مستوى التطبيق حالة بدلاً من أن يكون على URL بمفرده، مما يسمح لشاشة واحدة باحتواء عدة مناطق موجهة بشكل مستقل.

البعد ngRoute موجه واجهة المستخدم
خدمة التكوين $routeProvider موفر الحالة
المباريات على URL فقط الولاية المسماة، URL اختياري
طرق العرض المتداخلة غير معتمد عائلات
عرض متعدد لكل شاشة عرض واحد ng-view العديد من منافذ ui-view المسماة
حل متداخل غير معتمد ترث الدول الفرعية قرارات الدولة الأصلية
أفضل مناسب لـ تطبيقات مسطحة وصغيرة لوحات المعلومات والتصميمات متعددة الطبقات

اختر ngRoute عندما يكون كل URL تُعرض الخرائط على صفحة كاملة واحدة، لأنها لا تتطلب أي تبعيات إضافية، ويمكن عرض واجهة برمجة التطبيقات بالكامل على صفحة واحدة. اختر ui-router عندما تحتوي الشاشة على أجزاء تتنقل بشكل مستقل، أو عندما يتعين على العروض الفرعية إعادة استخدام البيانات التي تم تحميلها بواسطة العرض الرئيسي. الترحيل لاحقًا ممكن ولكنه ليس بالأمر السهل، لأن أسماء الحالة تُستبدل URL أنماط في جميع القوالب.

أخطاء التوجيه الشائعة في AngularJS وكيفية إصلاحها

تُنتج معظم حالات فشل التوجيه صفحة ng-view فارغة بدلاً من ظهور خطأ في وحدة التحكم، مما يجعل تشخيصها أصعب مما ينبغي. يوضح كل عرض أدناه سببه وحلّه.

  • موفر غير معروف: $routeProvider: لم يتم تحميل ملف angular-route.js مطلقًا، أو تم تحميله قبل ملف angular.min.js. يُرجى الرجوع إلى المكتبة الأساسية أولًا.
  • تبقى الشاشة فارغة دون ظهور أي خطأ: لا يوجد عنصر يحمل توجيه ng-view، لذلك لا يوجد مكان لعرض القالب.
  • لا يتم تحميل أي شيء في الزيارة الأولى: لا يوجد مسار مطابق للمسار الفارغ. أضف كتلة "وإلا" بقيمة "إعادة التوجيه إلى".
  • $routeParams فارغ: النمط يفتقر إلى عنصر النقطتين. يجب أن يكون '/Angular/:topicId'.
  • خطأ 404 في القوالب بعد تفعيل وضع HTML5: قم بتهيئة الخادم لإعادة كتابة المسارات غير المطابقة إلى الصفحة الأساسية، وتأكد من وجود علامة href الأساسية.
  • لا يتم إعادة تشغيل وحدة التحكم مطلقًا: لم يتغير سوى المعامل، لذا أعاد AngularJS استخدام نسخة المتحكم بدلاً من إعادة بنائها. استمع إلى حدث $routeUpdate بدلاً من الاعتماد على استدعاء دالة المتحكم مرة أخرى.

الأسئلة الشائعة

تُعيد الدالة `$routeParams` كلاً من عناصر مسار التطبيق وقيم سلسلة الاستعلام مُدمجة في كائن واحد. بينما تُعيد الدالة `$location.search()` سلسلة الاستعلام فقط. استخدم `$routeParams` داخل وحدات التحكم، و`$location.search()` عند قراءة أو كتابة قيم الاستعلام مباشرةً.

نعم. بدون رمز التجزئة، يرسل المتصفح المسار الكامل إلى الخادم عند تحديث الصفحة أو مشاركة رابط. يجب على الخادم إعادة كتابة كل مسار غير مطابق إلى صفحة HTML الأساسية، وإلا ستُرجع الروابط العميقة رمز الخطأ 404.

انتهى دعم AngularJS في ديسمبر 2021، ولم يعد يتلقى أي تحديثات. لا يزال ngRoute مناسبًا لصيانة تطبيقات AngularJS الحالية، ولكن ينبغي للمشاريع الجديدة استخدام إطار عمل مدعوم حاليًا.

نعم. AI يقوم المساعدون بربط كل كتلة "عندما" بإدخال في مصفوفة المسارات وترجمة مفاتيح الحل إلى محللات المسارات. Revيتم التعامل مع حراس العرض والتعامل مع الأحرف البديلة يدويًا، نظرًا لأن جهازي التوجيه يتعاملان مع المسارات غير المتطابقة بشكل مختلف.

تتحقق أدوات الذكاء الاصطناعي من الأسباب الثلاثة الشائعة بالترتيب: وجود تبعية ngRoute مفقودة، وغياب عنصر ng-view، ونمط مسار لا يتطابق مع URLوصف الأعراض ولصق كتلة التكوين عادة ما يؤدي إلى تحديد العطل.

تلخيص هذه التدوينة بـ: