حدد File > New.
تاريخ آخر تحديث
20 ديسمبر 2021
تعرف على كيفية تنفيذ تحويلات XSL على جانب الخادم في Dreamweaver. قم بإنشاء صفحات XSLT أو تحويل صفحة HTML إلى صفحات XSLT.
تم تبسيط واجهة المستخدم في Dreamweaver والإصدارات الأحدث. ونتيجة لذلك، قد لا تجد بعض الخيارات الموضحة في هذه المقالة في Dreamweaver والإصدارات اللاحقة. للاطلاع على المزيد من المعلومات، راجع هذه المقالة.
سير عمل لتنفيذ تحويلات XSL من جانب الخادم
يمكنك تنفيذ تحويلات XSL من جانب الخادم على الخادم. اقرأ حول تحويلات XSL من جانب الخادم وجانب العميل وحول استخدام XML و XSL مع صفحات الويب قبل بناء الصفحات التي تعرض بيانات XML.
يجب أن تتم تهيئة الخادم بصورة صحيحة لتنفيذ التحويلات من جانب الخادم. لمزيد من المعلومات، يرجى الاتصال بمسؤول الخادم.
سير العمل العام لتنفيذ تحويلات XSL من جانب الخادم كما يلي (كل خطوة موصوفة في مواضيع أخرى):
1.قم بإعداد موقع Dreamweaver.
2.اختر تقنية خادم وقم بإعداد خادم التطبيق.
3.اختبر خادم التطبيق.
على سبيل المثال، أنشئ صفحة تتطلب معالجة، وتأكد من أن خادم التطبيق يعالج الصفحة.
4.أنشئ جزء XSLT أو صفحة، أو حوّل صفحة HTML إلى صفحة XSLT.
في موقع Dreamweaver الخاص بك، أنشئ جزء XSLT أو صفحة XSLT كاملة.
قم بتحويل صفحة HTML موجودة إلى صفحة XSLT كاملة.
5.أرفق مصدر بيانات XML بالصفحة.
6.اعرض بيانات XML عن طريق ربط البيانات بجزء XSLT أو بصفحة XSLT الكاملة.
7. إذا كان ذلك مناسباً، أضف كائن XSLT للمنطقة المتكررة إلى الجدول أو صف الجدول الذي يحتوي على العناصر النائبة لبيانات XML.
8.أدرج المراجع.
لإدراج مرجع إلى جزء XSLT في صفحتك الديناميكية، استخدم سلوك الخادم XSL Transformation.
لإدراج مرجع إلى صفحة XSLT الكاملة في الصفحة الديناميكية، احذف كل كود HTML من صفحة ديناميكية، ثم استخدم سلوك الخادم XSL Transformation.
9.انشر الصفحة والجزء.
انشر كلاً من الصفحة الديناميكية وجزء XSLT (أو صفحة XSLT الكاملة) على خادم التطبيق الخاص بك. إذا كنت تستخدم ملف XML محلي، ستحتاج إلى نشر ذلك أيضاً.
10.اعرض الصفحة الديناميكية في متصفح.
عندما تفعل ذلك، يحوّل خادم التطبيق بيانات XML، ويدرجها في الصفحة الديناميكية، ويعرضها في المتصفح.
إنشاء صفحة XSLT
يمكنك إنشاء صفحات XSLT تتيح لك عرض بيانات XML على صفحات الويب. يمكنك إنشاء إما صفحة XSLT كاملة—صفحة XSLT تحتوي على علامة <body> وعلامة <head>—أو يمكنك إنشاء جزء XSLT. عندما تنشئ جزء XSLT، تنشئ ملفًا مستقلاً لا يحتوي على علامة body أو head—قطعة بسيطة من الكود يتم إدراجها لاحقًا في صفحة ديناميكية.
إذا كنت تبدأ بصفحة XSLT الموجودة، تحتاج إلى إلحاق مصدر بيانات XML بها.
في فئة الصفحة الفارغة في مربع الحوار مستند جديد، حدد أحد الخيارات التالية من عمود نوع الصفحة:
حدد XSLT (الصفحة بأكملها) لإنشاء صفحة XSLT كاملة.
حدد XSLT (جزء) لإنشاء جزء XSLT.
انقر فوق إنشاء وقم بأحد الإجراءات التالية في مربع الحوار تحديد موقع
مصدر XML:
- حدد Attach A Local File، وانقر فوق الزر Browse، واستعرض حتى تصل إلى ملف XML محلي على جهاز الكمبيوتر الخاص بك، وانقر فوق OK.
- حدد Attach A Remote File، وأدخل عنوان URL لملف XML على الإنترنت (مثل ملف قادم من ملقم RSS)، وانقر فوق OK.
وعند النقر فوق الزر Cancel، يتم إنشاء صفحة XSLT بدون مصدر بيانات XML مرفق.
ويتم ملء لوحة Bindings بمخطط مصدر بيانات XML الخاصة بك
يقدم الجدول التالي تفسيرًا للعناصر المختلفة في المخطط الذي يمكن أن يظهر:
العنصر |
يمثل |
تفاصيل |
|---|---|---|
<> |
عنصر XML غير المتكرر المطلوب |
وهو عنصر يظهر تمامًا مرة واحدة في عقدته الأصل |
<>+ |
عنصر تكرار XML |
وهو عنصر يظهر مرة واحدة أو أكثر في عقدته الأصل |
<>+ |
عنصر XML اختياري |
وهو عنصر لا يظهر إطلاقًا أو يظهر أكثر من مرة في عقدته الأصل |
عقدة العنصر بنوع غامق |
عنصر السياق الحالي |
هو في المعتاد عنصر التكرار عندما تكون نقطة الإدراج داخل منطقة التكرار |
@ |
سمة XML |
|
احفظ صفحتك الجديدة (ملف > حفظ) بامتداد
.xsl أو .xslt (امتداد .xsl هو الافتراضي).
تحويل صفحات HTML إلى صفحات XSLT
يمكنك أيضًا تحويل صفحات HTML الموجودة إلى صفحات XSLT.على سبيل المثال، إذا كان لديك صفحة ثابتة مُصممة مسبقًا تريد إضافة بيانات XML إليها، يمكنك تحويل الصفحة إلى صفحة XSLT، بدلاً من إنشاء صفحة XSLT وإعادة تصميم الصفحة من البداية.
افتح صفحة HTML التي تريد تحويلها.
حدد ملف > تحويل > XSLT
1.0.
تفتح نسخة من الصفحة في النافذة Document. الصفحة الجديدة هي ورقة أنماط XSL، محفوظة بامتداد .xsl.
إلحاق مصادر بيانات XML
إذا كنت تبدأ بصفحة XSLT موجودة، أو إذا لم تُرفق مصدر بيانات XML عند إنشاء صفحة XSLT جديدة باستخدام Dreamweaver، يجب عليك إرفاق مصدر بيانات XML باستخدام لوحة الربط.
في لوحة الربط (نافذة > ربط)،
انقر فوق رابط XML.
يمكنك أيضًا النقر فوق الارتباط المصدر في الجانب العلوي الأيمن من لوحة Bindings لإضافة مصدر بيانات XML.
قم بأحد الإجراءات التالية:
حدد إرفاق ملف محلي، وانقر فوق زر استعراض، واستعرض ملف XML محلي على جهاز الكمبيوتر لديك، وانقر فوق موافق.
حدد إرفاق ملف بعيد، وأدخل عنوان URL الخاص بـ ملف XML على الإنترنت (مثل الذي يأتي من موجز RSS).
انقر فوق OK لإغلاق مربع الحوار Locate XML Source.
يتم ملء لوحة الربط بمخطط مصدر بيانات XML الخاص بك.
عرض بيانات XML في صفحات XSLT
بعد إنشاء صفحة XSLT وإرفاق مصدر بيانات XML، يمكنك ربط البيانات بالصفحة.للقيام بذلك، تُضيف عنصر نائب لبيانات XML إلى صفحتك ثم تستخدم منشئ التعبير XPath أو فاحص الخصائص لتنسيق البيانات المُحددة التي ستُعرض على الصفحة.
افتح صفحة XSLT بمصدر بيانات XML مرفق.
(اختياري) حدد إدراج > جدول لإضافة
جدول إلى الصفحة.جدول يساعدك على تنظيم بيانات XML الخاصة بك.
ملاحظة
في معظم الحالات، تستخدم كائن XSLT للمنطقة المتكررة لعرض عناصر XML المتكررة في الصفحة.في هذه الحالة، قد تريد إنشاء جدول من صف واحد مع عمود واحد أو أكثر، أو جدول من صفين إذا كنت تريد تضمين رأس جدول.
في لوحة الربط، حدد عنصر XML واسحبه
إلى المكان في الصفحة حيث تريد إدراج البيانات.
يظهر عنصر نائب لبيانات XML على الصفحة.العنصر النائب مُميز وموضوع بين أقواس معقوفة.يستخدم بناء جملة XPath (لغة مسار XML) لوصف البنية الهرمية لمخطط XML.على سبيل المثال، إذا سحبت العنصر الفرعي title إلى الصفحة، وكان ذلك العنصر يحتوي على العناصر الرئيسية rss وchannel وitem، فسيكون بناء الجملة لعنصر المحتوى الديناميكي النائب {rss/channel/item/title}.
انقر نقرًا مزدوجًا فوق عنصر بيانات XML النائب على الصفحة لفتح منشئ التعبير XPath.يتيح لك منشئ التعبير XPath تنسيق البيانات المُحددة، أو تحديد عناصر أخرى من مخطط XML.
(اختياري) طبِّق أنماطًا على بيانات XML عن طريق تحديد عنصر نائب لبيانات XML وتطبيق أنماط عليه مثل أي جزء آخر من المحتوى باستخدام فاحص الخصائص أو لوحة أنماط CSS.بدلاً من ذلك، يمكنك استخدام أوراق الأنماط في وقت التصميم لتطبيق
الأنماط على أجزاء XSLT.كل طريقة من هذه الطرق لها مجموعة فوائد
وقيود خاصة بها.
قم بمعاينة عملك في المتصفح (ملف > معاينة
في المتصفح).
عندما تستعرض عملك باستخدام الخيار استعراض في مستعرض، ينفذ Dreamweaver تحويل XSL بدون استخدام خادم تطبيقات.
عرض عناصر تكرار XML
يتيح لك كائن XSLT للمنطقة المتكررة عرض العناصر المتكررة من مصدر بيانات XML في صفحة ويب. على سبيل المثال، إذا كنت تعرض عناوين المقالات وأوصافها من موجز الأخبار، وكان موجز الأخبار هذا يحتوي على ما بين 10 و 20 مقالة، فمن المحتمل أن يكون كل عنوان وكل وصف في ملف XML عنصراً فرعياً لعنصر متكرر.
يمكن تغيير أي منطقة في عرض التصميم تحتوي على عنصر نائب لبيانات XML إلى منطقة متكررة.ومع ذلك، فإن المناطق الأكثر شيوعاً هي الجداول أو صفوف الجداول أو مجموعة من صفوف الجداول.
في عرض التصميم، حدد منطقة تحتوي على
عنصر نائب أو عناصر نائبة لبيانات XML.
يمكن أن يكون التحديد أي شيء، بما في ذلك جدول أو صف جدول أو حتى فقرة من النص.
لتحديد منطقة على الصفحة بصورة دقيقة، يمكنك استخدام محدد العلامات الموجود في الجزء السفلي الأيسر من النافذة Document. على سبيل المثال، إذا كانت المنطقة هي جدول، انقر داخل الجدول في الصفحة، ثم انقر فوق العلامة في محدد العلامات.
قم بأحد الإجراءات التالية
حدد إدراج > كائنات XSLT > منطقة متكررة.
في فئة XSLT في لوحة الإدراج، انقر على زر المنطقة المتكررة.
في منشئ تعبيرات XPath، حدد العنصر المتكرر،
المشار إليه بعلامة زائد صغيرة.
انقر فوق OK.
في نافذة المستند، يظهر مخطط رمادي رفيع ومبوب حول المنطقة المتكررة.عندما تقوم بمعاينة عملك في المتصفح (ملف > معاينة في المتصفح)، يختفي المخطط الرمادي ويتوسع التحديد لعرض العناصر المتكررة المحددة في ملف XML.
عندما تضيف كائن XSLT للمنطقة المتكررة إلى الصفحة، يتم اقتطاع العنصر النائب لبيانات XML في نافذة المستند.هذا لأن Dreamweaver يقتطع XPath للعنصر النائب لبيانات XML بحيث يكون نسبياً لمسار العنصر المتكرر.
قم بتعيين خصائص منطقة تكرار (XSL)
في مفتش الخصائص، يمكنك تحديد عقدة XML مختلفة لإنشاء المنطقة المتكررة.
في مربع التحديد، أدخل عقدة جديدة، ثم اضغط على أيقونة البرق وحدد العقدة من شجرة مخطط XML التي تظهر.
حرر كائن XSLT لمنطقة تكرار
بعد إضافة كائن XSLT للمنطقة المتكررة، يمكنك تعديله باستخدام مفتش الخصائص.
حدد الكائن بالنقر على التبويب الرمادي الذي
يحيط بالمنطقة المتكررة.
في مفتش الخصائص (نافذة > خصائص)،
انقر على الأيقونة الديناميكية بجوار حقل نص التحديد.
في منشئ تعبيرات XPath، أجرِ التغييرات وانقر موافق.
إدراج أجزاء XSLT في الصفحات الديناميكية
بعد إنشاء جزء XSLT، يمكنك إدراجه في صفحة ويب ديناميكية باستخدام سلوك الخادم XSL Transformation.عندما تضيف سلوك الخادم إلى صفحتك وتعرض الصفحة في المتصفح، يقوم خادم التطبيق بإجراء تحويل يعرض بيانات XML من جزء XSLT المحدد.Dreamweaver يدعم تحويلات XSL لصفحات ColdFusion أو ASP أو PHP.
إذا كنت تريد إدخال محتويات صفحة XSLT الكاملة في صفحة ديناميكية، فاستخدم نفس الإجراء. قبل استخدام سلوك خادم تحويل XSL لإدخال صفحة XSLT الكاملة، احذف كل تعليمة برمجية HTML من الصفحة الديناميكية.
افتح صفحة ColdFusion أو ASP أو PHP موجودة.
في عرض التصميم، ضع نقطة الإدراج في الموقع
حيث تريد إدراج جزء XSLT.
عند إدخال أجزاء XSLT، يجب عليك دائمًا النقر فوق الزر Show Code وDesign Views بعد وضع نقطة الإدراج في الصفحة بحيث يمكنك ضمان وجود نقطة الإدراج في المكان الصحيح. إذا لم يكن الأمر كذلك، قد تحتاج إلى النقر في مكان آخر في طريقة العرض Code لوضع نقطة الإدراج حيث تريدها.
في لوحة سلوكيات الخادم (نافذة > سلوكيات الخادم)، انقر فوق الزر علامة الجمع (+) وحدد XSL Transformation.
في مربع حوار XSL Transformation، انقر فوق زر الاستعراض وانتقل إلى جزء XSLT أو صفحة XSLT كاملة.
Dreamweaver يملأ حقل النص التالي بمسار الملف أو عنوان URL لملف XML المتصل بالجزء المحدد.لتغييره، انقر فوق زر استعراض واستعرض إلى ملف آخر.
(إضافي) انقر فوق زر الإضافة (+) لإضافة معلمة XSLT.
انقر فوق موافق لإدراج مرجع إلى جزء XSLT في
الصفحة.الجزء غير قابل للتحرير. يمكنك النقر المزدوج فوق
الجزء لفتح الملف المصدر للجزء وتعديله.
يتم أيضًا إنشاء مجلد includes/MM_XSLTransform/ في مجلد الجذر للموقع يحتوي على ملف مكتبة وقت التشغيل.يستخدم خادم التطبيق الوظائف المحددة في هذا الملف لتنفيذ التحويل.
ارفع الصفحة الديناميكية إلى خادمك (موقع >
وضع) وانقر فوق نعم لتضمين الملفات التابعة.يجب أن تكون الملفات التالية جميعها على الخادم لكي تُعرض صفحتك بشكل صحيح: الملف الذي يحتوي على جزء XSLT، وملف XML الذي يحتوي على بياناتك، وملف مكتبة وقت التشغيل المُنشأ.(إذا حددت ملف XML بعيد كمصدر بياناتك، يجب أن يتواجد ذلك الملف في مكان آخر على الإنترنت.)
حذف أجزاء XSLT من الصفحات الديناميكية
يمكنك إزالة جزء XSLT من صفحة عن طريق حذف سلوك خادم XSL Transformation المستخدم لإدراج الجزء.حذف سلوك الخادم يحذف جزء XSLT فقط - لا يحذف ملفات XML أو XSLT أو مكتبة وقت التشغيل المرتبطة.
في لوحة سلوكيات الخادم (نافذة >
سلوكيات الخادم)، حدد سلوك خادم XSL Transformation
الذي تريد حذفه.
انقر فوق زر علامة الطرح (-).
يجب عليك دائمًا إزالة سلوكيات الخادم بهذه الطريقة. ويؤدي الحذف اليدوي للتعليمة البرمجية التي تم إنشاؤها إلى الحذف الجزئي فقط لسلوك الخادم، حتى بالرغم من أن سلوك الخادم قد يختفي من لوحة Server Behaviors.
تعديل سلوكيات خادم تحويل XSL
بعد أن أضفت جزء XSLT إلى صفحة ويب ديناميكية، يمكنك تعديل سلوك خادم XSL Transformation في أي وقت.
في لوحة سلوكيات الخادم (نافذة >
سلوكيات الخادم)، انقر نقرًا مزدوجًا فوق سلوك خادم XSL Transformation
الذي تريد تعديله.
قم بإجراء التغييرات التي تريدها ثم انقر فوق OK.
قم بإنشاء ارتباط ديناميكي
يمكنك إنشاء رابط ديناميكي على صفحة XSLT الخاصة بك يرتبط بعنوان URL محدد عندما ينقر المستخدم على كلمة محددة أو مجموعة من الكلمات من بيانات XML الخاصة بك.للتعليمات الكاملة، راجع تصحيحات Dreamweaver في www.adobe.com/go/dw_documentation.
تطبيق الأنماط على أجزاء XSLT
عندما تنشئ صفحة XSLT كاملة (أي صفحة XSLT تحتوي على علامات <body> و <head>)، يمكنك عرض بيانات XML على الصفحة ثم تنسيق البيانات مثل أي جزء محتوى آخر باستخدام مفتش الخصائص أو لوحة أنماط CSS.عندما تنشئ جزء XSLT للإدراج في صفحة ديناميكية، مع ذلك (على سبيل المثال، جزء للإدراج في صفحة ASP أو PHP أو Cold Fusion)، يصبح عرض الأنماط في الجزء وفي الصفحة الديناميكية أكثر تعقيدًا.رغم أنك تعمل على جزء XSLT منفصلاً عن الصفحة الديناميكية، من المهم أن تتذكر أن الجزء مخصص للاستخدام داخل الصفحة الديناميكية، وأن الناتج من جزء XSLT يتواجد في النهاية في مكان ما داخل علامات <body> في الصفحة الديناميكية.بالنظر إلى سير العمل هذا، من المهم التأكد من عدم تضمين عناصر <head> (مثل تعريفات الأنماط أو الروابط إلى أوراق الأنماط الخارجية) في أجزاء XSLT.إن القيام بذلك سيتسبب في وضع خادم التطبيق لهذه العناصر في <body> الخاص بالصفحة الديناميكية، مما ينتج عنه ترميز غير صالح.
على سبيل المثال، قد تريد إنشاء جزء XSLT للإدراج في صفحة ديناميكية وتنسيق الجزء باستخدام نفس ورقة الأنماط الخارجية المستخدمة في الصفحة الديناميكية.إذا قمت بإرفاق نفس ورقة الأنماط بالجزء، فإن صفحة HTML الناتجة تحتوي على رابط مكرر إلى ورقة الأنماط (واحد في قسم <head> الخاص بالصفحة الديناميكية، وآخر في قسم <body> الخاص بالصفحة، حيث يظهر محتوى جزء XSLT).بدلاً من هذا الأسلوب، يجب استخدام أوراق الأنماط في وقت التصميم للإشارة إلى ورقة الأنماط الخارجية.
عند تنسيق محتوى أجزاء XSLT، استخدم سير العمل التالي:
أولاً، أرفق صحيفة أنماط خارجية إلى الصفحة الديناميكية. (وهذه هي أفضل الممارسات لتطبيق الأنماط على محتويات أي صفحة ويب).
ثم بعد ذلك، أرفق نفس صحيفة الأنماط الخارجية إلى جزء XSLT كصحيفة أنماط Design-time. وكما هو واضح من الاسم، تعمل صحيفة أنماط , Design-time فقط في طريقة العرض Design في Dreamweaver.
بعد أن أكملت الخطوتين السابقتين، يمكنك إنشاء أنماط جديدة في جزء XSLT الخاص بك باستخدام نفس صحيفة الأنماط التي أرفقتها بصفحتك الديناميكية. ستكون مخرجات HTML أنظف (نظرًا لأن المرجع إلى صفحة الأنماط صالح فقط عند العمل في Dreamweaver)، وسيظل الجزء يعرض الأنماط الملائمة في طريقة العرض Design. بالإضافة إلى ذلك، سيتم تطبيق كل الأنماط الخاصة بك على كلٍ من الجزء والصفحة الديناميكية عندما تعرض الصفحة الديناميكية في طريقة العرض Design، أو تستعرض الصفحة الديناميكية في مستعرض.
إذا استعرضت جزء XSLT في مستعرض، لن يعرض المستعرض الأنماط. وبدلاً من ذلك، ينبغي عليك استعراض الصفحة الديناميكية في المستعرض لعرض جزء XSLT في سياق الصفحة الديناميكية.
استخدام المعلمات بتحويلات XSL
يمكنك تعريف معاملات لتحويل XSL عند إضافة سلوك خادم XSL Transformation إلى صفحة ويب.تتحكم المعاملات في كيفية معالجة وعرض بيانات XML.على سبيل المثال، قد تستخدم معاملاً لتحديد وسرد مقالة معينة من تغذية الأخبار.عند تحميل الصفحة في المتصفح، تظهر فقط المقالة التي حددتها بالمعامل.
إضافة معامل XSLT إلى تحويل XSL
افتح مربع الحوار XSL Transformation.
يمكنك القيام بذلك بالنقر المزدوج على سلوك خادم XSL Transformation
في لوحة Server Behaviors (النافذة > Server
Behaviors)، أو بإضافة سلوك خادم XSL Transformation جديد.
في مربع الحوار XSL Transformation، انقر على زر علامة الجمع (+) بجوار XSLT Parameters.
في مربع الحوار Add Parameters، أدخل اسماً للمعامل
في مربع Name.يمكن أن يحتوي الاسم على أحرف وأرقام فقط.ولا يمكن أن يحتوي على مسافات.
قم بأحد الإجراءات التالية:
إذا كنت تريد استخدام قيمة ثابتة، أدخلها في مربع Value.
إذا كنت تريد استخدام قيمة ديناميكية، انقر على أيقونة ديناميكية بجوار مربع Value، أكمل مربع الحوار Dynamic Data، وانقر على OK.لمزيد من المعلومات، انقر على زر Help في مربع الحوار Dynamic Data.
في مربع Default Value، أدخل القيمة التي تريد أن
يستخدمها المعامل إذا لم تتلق الصفحة قيمة وقت التشغيل، وانقر
على OK.
حرر معلمة XSLT
افتح مربع الحوار XSL Transformation.
يمكنك القيام بذلك بالنقر المزدوج على سلوك خادم XSL Transformation
في لوحة Server Behaviors (النافذة > Server
Behaviors)، أو بإضافة سلوك خادم XSL Transformation جديد.
حدد معلمة من قائمة معلمات XSLT.
انقر فوق الزر Edit.
قم بإجراء التغييرات التي تريدها ثم انقر فوق OK.
احذف معلمة XSLT
افتح مربع الحوار XSL Transformation.
يمكنك القيام بذلك بالنقر المزدوج على سلوك خادم XSL Transformation
في لوحة Server Behaviors (النافذة > Server
Behaviors)، أو بإضافة سلوك خادم XSL Transformation جديد.
حدد معلمة من قائمة معلمات XSLT.
انقر فوق زر علامة الطرح (-).
إنشاء وتعديل مناطق XSLT الشرطية
يمكنك إنشاء مناطق شرطية بسيطة أو مناطق شرطية متعددة على صفحة XSLT.يمكنك إما تحديد عنصر في عرض Design وتطبيق منطقة شرطية على التحديد، أو يمكنك إدراج منطقة شرطية في أي مكان يكون فيه نقطة الإدراج في المستند.
على سبيل المثال، إذا كنت تريد عرض كلمة "غير متاح" بجوار سعر العنصر عندما يكون العنصر غير متاح، تكتب النص "غير متاح" على الصفحة، وتحدده، ثم تطبق منطقة شرطية على النص المحدد.يحيط Dreamweaver بالتحديد بعلامات <xsl:if>، ويعرض فقط كلمة "غير متاح" على الصفحة عندما تطابق البيانات شروط التعبير الشرطي.
طبق منطقة XSLT شرطية
يمكنك كتابة تعبير شرطي بسيط لإدراجه في صفحة XSLT الخاصة بك.إذا كان المحتوى محدداً عندما تفتح مربع حوار المنطقة الشرطية، فسيتم التفاف المحتوى في كتلة <xsl:if>.إذا لم يكن المحتوى محدداً، فستتم إضافة كتلة <xsl:if> في نقطة الإدراج على الصفحة.من الأفضل استخدام مربع الحوار للبدء ثم تخصيص التعبير في عرض الكود.
عنصر <xsl:if> يشبه جملة if في اللغات الأخرى.يوفر العنصر طريقة لاختبار شرط واتخاذ مسار عمل بناءً على النتيجة.يسمح لك عنصر <xsl:if> باختبار تعبير لقيمة صحيحة أو خاطئة واحدة.
حدد إدراج > كائنات XSLT > منطقة شرطية أو انقر على أيقونة المنطقة الشرطية في فئة XSLT من لوحة الإدراج.
في مربع حوار المنطقة الشرطية، أدخل التعبير الشرطي
الذي تريد استخدامه للمنطقة.
في المثال التالي، تريد اختبار ما إذا كانت قيمة خاصية @available لعقدة السياق هي true.
انقر فوق OK.
يتم إدراج التعليمة البرمجية التالية في صفحة XSLT الخاصة بك:
<xsl:if test="@available='true'">
يوضع المحتوى هنا
</xsl:if>
يجب أن تحيط قيم السلسلة مثل القيمة صواب بعلامة تنصيص. يقوم Dreamweaver بترميز علامات الاقتباس نيابة عنك (') بحيث يتم إدخالها كـ XHTML صالح.
بالإضافة إلى اختبار العقد للقيم، يمكنك استخدام أي من وظائف XSLT المدعومة في أي بيان شرطي.يتم اختبار الشرط للعقدة الحالية داخل ملف XML. في المثال التالي، تريد اختبار العقدة الأخيرة في مجموعة النتائج:
للحصول على مزيد من المعلومات والأمثلة حول كتابة التعبيرات الشرطية، راجع قسم <xsl:if> في لوحة المرجع (مساعدة > مرجع).
تطبيق مناطق XSLT الشرطية المتعددة
يمكنك كتابة تعبير شرطي بسيط لإدراجه في صفحة XSLT الخاصة بك.إذا كان المحتوى محدداً عندما تفتح مربع حوار المنطقة الشرطية، فسيتم التفاف المحتوى في كتلة <xsl:choose>.إذا لم تحدد محتوى، فستتم إضافة كتلة <xsl:choose> في نقطة الإدراج على الصفحة.من الأفضل استخدام مربع الحوار لبدء الاستخدام ثم تخصيص التعبير في عرض الكود.
عنصر <xsl:choose> يشبه تعليمة case في اللغات الأخرى.يوفر العنصر طريقة لاختبار شرط واتخاذ مسار عمل بناءً على النتيجة.عنصر <xsl:choose> يتيح لك اختبار حالات متعددة.
حدد إدراج > كائنات XSLT > منطقة شرطية متعددة أو انقر على أيقونة المنطقة الشرطية المتعددة في فئة XSLT في لوحة الإدراج.
في مربع حوار المنطقة الشرطية المتعددة، أدخل
الحالة الأولى.
في المثال التالي، تريد اختبار ما إذا كان العنصر الفرعي price لعقدة السياق أقل من 5.
انقر فوق OK.
في المثال، يتم إدراج الرمز التالي في صفحة XSLT الخاصة بك:
<xsl:choose>
<xsl:when test="price<5">
يوضع المحتوى هنا
</xsl:when>
<xsl:otherwise>
يوضع المحتوى هنا
</xsl:otherwise>
</xsl:choose>
لإدراج حالة أخرى، ضع نقطة الإدراج
في عرض الرمز بين أزواج علامات <xsl:when>
أو قبل علامة <xsl:otherwise> مباشرة، ثم
أدرج منطقة شرطية (إدراج > كائنات XSLT >
منطقة شرطية).
بعد تحديد الحالة والنقر على موافق، يتم إدراج علامة <xsl:when> أخرى في كتلة <xsl:choose>.
لمزيد من المعلومات والأمثلة حول كتابة التعبيرات الشرطية، راجع أقسام <xsl:choose> في لوحة المرجع (مساعدة > مرجع).
قم بتعيين خصائص المنطقة الشرطية (If)
الغرض من مفتش خصائص تعيين المنطقة الشرطية هو تغيير الحالة المستخدمة في منطقة شرطية في صفحة XSL الخاصة بك. المنطقة الشرطية تختبر الحالة وتتخذ مسار عمل بناءً على النتيجة.
في مربع الاختبار، أدخل حالة جديدة، ثم
اضغط على Enter.
قم بتعيين خصائص (When) الشرطية
الغرض من مفتش خصائص تعيين المنطقة الشرطية هو تغيير الشرط المستخدم في منطقة شرطية متعددة في صفحة XSL الخاصة بك.المنطقة الشرطية المتعددة تختبر الحالة وتتخذ مسار عمل بناءً على النتيجة.
في مربع الاختبار، أدخل حالة جديدة، ثم
اضغط على Enter.
أدخل تعليقات XSL
يمكنك إضافة علامات تعليق XSL إلى مستند، أو يمكنك تغليف التحديد في علامات تعليق XSL.
أضف علامات تعليقات XSL إلى مستند
قم بأحد الإجراءات التالية:
في عرض التصميم، حدد إدراج > كائنات XSLT > تعليق XSL، اكتب محتويات التعليق (أو اترك المربع فارغاً)، وانقر على موافق.
في عرض الرمز، حدد إدراج > كائنات XSLT > تعليق XSL.
ملاحظة
يمكنك أيضًا النقر على أيقونة تعليق XSL في فئة XSLT في لوحة الإدراج.
لف التحديد في علامات تعليق XSL
بدّل إلى عرض الكود (عرض > كود).
حدد التعليمة البرمجية التي تريد التعليق عليها.
في شريط أدوات الترميز، انقر على زر تطبيق تعليق
وحدد Apply <xsl:comment></xsl:comment> Comment.
استخدام منشئ تعبير XPath لإضافة تعبيرات لبيانات XML
XPath (XML Path Language) هي صيغة غير XML لمعالجة أجزاء من مستند XML.يتم استخدامها في الغالب كـ لغة استعلام لبيانات XML، تماماً كما تُستخدم لغة SQL للاستعلام في قواعد البيانات.لمزيد من المعلومات حول XPath، راجع مواصفات لغة XPath على موقع W3C في www.w3.org/TR/xpath.
منشئ تعبير XPath هو ميزة في Dreamweaver تتيح لك إنشاء تعبيرات XPath بسيطة لتحديد عُقد بيانات معينة وللمناطق المتكررة.ميزة استخدام هذه الطريقة بدلاً من سحب القيم من شجرة مخطط XML هي أنه يمكنك تنسيق القيمة التي يتم عرضها.يتم تحديد السياق الحالي بناءً على موضع نقطة الإدراج في ملف XSL عند فتح مربع حوار منشئ تعبير XPath. السياق الحالي بالنوع الغامق في شجرة مخططات XML. بينما تقوم بالتحديدات في مربع الحوار هذا، يتم إنشاء عبارات XPath الصحيحة، بالنسبة إلى السياق الحالي الخاص بك.هذا يبسط عملية كتابة تعبيرات XPath صحيحة للمبتدئين والمستخدمين المتقدمين.
تم تصميم هذه الميزة لمساعدتك على بناء تعبيرات XPath البسيطة لتحديد عقدة محددة أو لمناطق التكرار. فهي لا تتيح لك تحرير التعبيرات باليد. إذا كنت بحاجة إلى إنشاء تعبيرات معقدة، استخدم XPath Expression Builder للبدء، ثم قم بتخصيص تعبيرات في طريقة العرض Code أو بعارض الخصائص.
إنشاء تعبير XPath لتحديد عُقدة معينة
انقر نقرًا مزدوجًا على عنصر نائب بيانات XML في الصفحة لفتح منشئ تعبير XPath.
في مربع حوار منشئ تعبير XPath (النص الديناميكي)،
حدد أي عُقدة في شجرة مخطط XML.
يتم كتابة تعبير XPath الصحيح في مربع التعبير لتحديد العُقدة.
ملاحظة
إذا حددت عُقدة مختلفة في شجرة مخطط XML، يتغير التعبير ليعكس اختيارك.
في المثال التالي، تريد عرض العنصر الفرعي price للعُقدة item:
هذا التحديد سيدرج الكود التالي في صفحة XSLT الخاصة بك:
<xsl:value-of select="price"/>
(اختياري) حدد خيار التنسيق من القائمة المنبثقة للتنسيق.
تنسيق تحديد مفيد عندما ترجع قيمة العُقدة الخاصة بك رقماً.يوفر Dreamweaver قائمة محددة مسبقًا من وظائف التنسيق.للحصول على قائمة كاملة من وظائف التنسيق المتاحة والأمثلة، راجع لوحة المرجع.
في المثال التالي، تريد تنسيق العنصر الفرعي price كعملة بمنزلتين عشريتين:
هذه الخيارات ستدرج الكود التالي في صفحة XSLT الخاصة بك:<xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>
انقر فوق OK.
لعرض قيمة كل عقدة في ملف XML، طبق
منطقة متكررة على العنصر الذي يحتوي على النص الديناميكي (على
سبيل المثال، صف جدول HTML أو فقرة).
لمزيد من المعلومات والأمثلة حول تحديد العقد لإرجاع قيمة، راجع قسم <xsl:value-of/> في لوحة المرجع.
حدد عقدة لتكرارها
يمكنك تحديد عقدة لتكرارها واختياريًا تصفية النتائج.في مربع حوار XPath Expression Builder ، سيتم تضمين المحتوى المحدد داخل كتلة <xsl:for-each>. إذا لم تحدد محتوى، فسيتم إدخال كتلة <xsl:for-each> عند نقطة الإدراج لمؤشرك.
انقر نقرًا مزدوجًا على عنصر بيانات XML النائب في الصفحة
لفتح XPath Expression Builder.
في مربع حوار XPath Expression Builder (Repeating Region)،
حدد العنصر المراد تكراره في شجرة مخطط XML.
يتم كتابة تعبير XPath الصحيح في مربع التعبير لتحديد العقدة.
ملاحظة
يتم تحديد العناصر المتكررة برمز الجمع (+) في شجرة مخطط XML.
في المثال التالي، تريد تكرار كل عقدة item داخل ملف XML.
عند النقر فوق موافق، يتم إدراج الرمز التالي في صفحة XSLT الخاصة بك:
<xsl:for-each select="provider/store/items/item">
يوضع المحتوى هنا
</xsl:for-each>
في بعض الحالات، قد ترغب في العمل مع مجموعة فرعية من العقد المتكررة—على سبيل المثال، قد تريد عناصر حيث تحتوي السمة على قيمة محددة.في هذه الحالة، عليك إنشاء عامل تصفية.
قم بتصفية البيانات المطلوب تكرارها
استخدم عامل تصفية لتحديد العقد المتكررة التي تحتوي على قيم سمات محددة.
في مخطط XML، حدد عقدة لتكرارها.
انقر فوق الزر Build Filter expander.
انقر فوق زر الإضافة (+) لإنشاء عامل تصفية فارغ.
أدخل معايير عامل التصفية في الحقول التالية:
تصفية حسب
يحدد العقدة المتكررة التي تحتوي على البيانات التي تريد التصفية حسبها.توفر القائمة المنبثقة قائمة بالعقد الأصلية نسبةً إلى العقدة التي حددتها في شجرة مخطط XML.
Where
يحدد السمة أو العنصر الفرعي لعقدة التصفية حسب التي ستُستخدم للحد من النتائج.يمكنك تحديد سمة أو عنصر فرعي من القائمة المنبثقة، أو يمكنك إدخال تعبير XPath خاص بك في هذا الحقل لتحديد العناصر الفرعية الموجودة بعمق أكبر داخل شجرة المخطط.
العامل
يحدد عامل المقارنة المراد استخدامه في تعبير عامل التصفية.
Value
تحدد القيمة المطلوب فحصها في عنصر التصفية حسب العقدة. أدخل القيمة. إذا تم تعريف معاملات ديناميكية لصفحة XSLT الخاصة بك، يمكنك تحديد واحدة من القائمة المنبثقة.
لتحديد عامل تصفية آخر، انقر على زر علامة الجمع (+)
مرة أخرى.
عند إدخال القيم أو إجراء تحديدات في القوائم المنبثقة، يتغير تعبير XPath في مربع التعبير.
في المثال التالي، تريد تقييد مجموعة النتائج على عقد item حيث تكون قيمة الخاصية @available هي true.
عند النقر على موافق، يتم إدراج الكود التالي في صفحة XSLT الخاصة بك:<xsl:for-each select="provider/store/items/item[@available = 'true']"> يوضع المحتوى هنا </xsl:for-each>
تحتاج إلى أن تحيط قيم السلسلة مثل القيمة صواب بعلامة تنصيص. يقوم Dreamweaver بترميز علامات الاقتباس لك (') بحيث يتم إدخالها كـ XHTML صالح.
يمكنك إنشاء مرشحات أكثر تعقيدًا تتيح لك تحديد العقد الأساسية كجزء من معايير التصفية الخاصة بك.في المثال التالي، تريد تقييد مجموعة النتائج على عُقد item حيث تكون سمة store للـ @id مساوية لـ 1 وعُقدة item للـ price أكبر من 5.
عند النقر على موافق، يتم إدراج الكود التالي في صفحة XSLT الخاصة بك:<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]"> يُدرج المحتوى هنا </xsl:for-each>
لمزيد من المعلومات و أمثلة على المناطق المتكررة، راجع قسم <xsl:for-each> في لوحة المرجع.
قم بإنشاء مواقع ويب جميلة في Dreamweaver
قم بتصميم مواقع الويب الديناميكية وبرمجتها وإدارتها في أداة قوية متكاملة.
