تعرف على كيفية تنفيذ تحويلات XSL على جانب الخادم في Dreamweaver. قم بإنشاء صفحات XSLT أو تحويل صفحة HTML إلى صفحات XSLT.

ملاحظة:

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

سير العمل لتنفيذ تحويلات XSL من جانب الخادم

يمكنك تنفيذ تحويلات XSL من جانب الخادم على الخادم. اقرأ عن التحويلات من جانب الخادم ومن جانب العميل وعن استخدام XML وXSL مع صفحات الويب قبل بناء الصفحات التي تعرض بيانات XML.

ملاحظة:

يجب أن تتم تهيئة الخادم بصورة صحيحة لتنفيذ التحويلات من جانب الخادم. لمزيد من المعلومات، يرجى الاتصال بمسؤول الخادم.

ويكون سير العمل العام الخاص بتحويلات XSL من جانب الخادم كما يلي (كل خطوة موضحة في موضوعات أخرى):

1. قم بإعداد موقع Dreamweaver.

2. اختر تقنية خادم وقم بإعداد خادم تطبيقات.

3. اختبر خادم التطبيقات.

على سبيل المثال، قم بإنشاء صفحة تتطلب معالجة، وتأكد من أن خادم التطبيقات يعالج الصفحة.

4. قم بإنشاء جزء XSLT أو صفحة XSLT، أو قم بتحويل صفحة HTML إلى صفحة XSLT.

  • في موقع Dreamweaver الخاص بك، قم بإنشاء جزء XSLT أو صفحة XSLT كاملة.

  • قم بتحويل صفحة HTML موجودة إلى صفحة XSLT كاملة.

5.أرفق مصدر بيانات XML بالصفحة.

6.اعرض بيانات XML بربط البيانات إلى جزء XSLT أو إلى صفحة XSLT كاملة.

7. أضف كائن XSLT لمنطقة تكرار إلى الجدول أو صف الجدول الذي يحتوي على العنصر (العناصر) النائبة لبيانات XML إن أمكن ذلك.

8. أدخل المراجع.

  • لإدخال مرجع إلى جزء XSLT في صفحتك الديناميكية، استخدم سلوك خادم تحويل XSL.

  • لإدخال مرجع إلى صفحة XSLT الكاملة في صفحتك الديناميكية، احذف كل رموز HTML من الصفحة الديناميكية، ثم استخدم سلوك خادم تحويل XSL.

9. انشر الصفحة والجزء.

انشر كلاً من الصفحة الديناميكية وجزء XSLT (أو صفحة XSLT الكاملة) على خادم التطبيقات. إذا كنت تستخدم ملف XML محلي، ستحتاج إلى نشره كذلك.

10. اعرض الصفحة الديناميكية في مستعرض.

عندما تفعل ذلك، يحول خادم التطبيقات بيانات XML، ويقوم بإدخالها في الصفحة الديناميكية ويعرضها في المستعرض.

إنشاء صفحة XSLT

يمكنك إنشاء صفحات XSLT التي تتيح لك عرض بيانات XML على صفحات الويب. يمكنك إنشاء صفحة XSLT كاملة - صفحة XSLT تحتوي على علامة <body> وعلامة <head> أو يمكنك إنشاء جزء XSLT. عندما تقوم بإنشاء جزء XSLT، قم بإنشاء ملف مستقل لا يحتوي على علامة النص الأساسي أو علامة الرأس - وهي تعليمة برمجية صغيرة يتم إدخالها لاحقًا في صفحة ديناميكية.

ملاحظة:

إذا كنت تبدأ بصفحة XSLT الموجودة، تحتاج إلى إلحاق مصدر بيانات XML بها.

  1. حدد File > New.
  2. في فئة الصفحة الفارغة الخاصة بمربع حوار المستند الجديد، حدد واحدًا مما يلي من عمود نوع الصفحة:
    • حدد XSLT (صفحة كاملة) لإنشاء صفحة XSLT كاملة.

    • حدد XSLT (جزء) لإنشاء جزء XSLT.

  3. انقر فوق Create، وقم بإجراء واحد مما يلي في مربع حوار Locate XML Source:
    • حدد Attach A Local File، وانقر فوق الزر Browse، واستعرض حتى تصل إلى ملف XML محلي على جهاز الكمبيوتر الخاص بك، وانقر فوق OK.
    • حدد Attach A Remote File، وأدخل عنوان URL لملف XML على الإنترنت (مثل ملف قادم من ملقم RSS)، وانقر فوق OK.

    ملاحظة:

    وعند النقر فوق الزر Cancel، يتم إنشاء صفحة XSLT بدون مصدر بيانات XML مرفق.

    ويتم ملء لوحة Bindings بمخطط مصدر بيانات XML الخاصة بك

    اللوحة Bindings
    اللوحة Bindings

    يقدم الجدول التالي تفسيرًا للعناصر المختلفة في المخطط الذي يمكن أن يظهر:

    العنصر

    يمثل

    تفاصيل

    <>

    عنصر XML غير المتكرر المطلوب

    وهو عنصر يظهر تمامًا مرة واحدة في عقدته الأصل

    <>+

    عنصر تكرار XML

    وهو عنصر يظهر مرة واحدة أو أكثر في عقدته الأصل

    <>+

    عنصر XML اختياري

    وهو عنصر لا يظهر إطلاقًا أو يظهر أكثر من مرة في عقدته الأصل

    عقدة العنصر بنوع غامق

    عنصر السياق الحالي

    هو في المعتاد عنصر التكرار عندما تكون نقطة الإدراج داخل منطقة التكرار

    @

    سمة XML

     

     

  4. احفظ صفحتك الجديدة (File > Save) بامتداد .xsl أو .xslt (.xsl هو الامتداد الافتراضي).

تحويل صفحات HTML إلى صفحات XSLT

يمكنك أيضًا تحويل صفحات HTML الحالية إلى صفحات XSLT. على سبيل المثال، إذا كانت لديك صفحة ثابتة مصممة مسبقًا وتريد إضافة بيانات XML إليها، يمكنك تحويل الصفحة إلى صفحة XSLT، بدلاً من إنشاء صفحة XSLT وإعادة تصميم الصفحة من الصفر.

  1. افتح صفحة HTML التي تريد تحويلها.
  2. حدد File > Convert > XSLT 1.0.

    تفتح نسخة من الصفحة في النافذة Document. تكون الصفحة الجديدة صحيفة أنماط XSL، ويتم حفظها بامتداد xsl.

إلحاق مصادر بيانات XML

إذا كنت تبدأ بصفحة XSLT موجودة، أو إذا لم تلحق مصدر بيانات XML عند إنشاء صفحة XSLT بـ Dreamweaver، يجب إرفاق مصدر بيانات XML باستخدام لوحة Bindings.

  1. في لوحة Bindings (Window > Bindings)، انقر فوق ارتباط XML.
    انقر فوق XML في لوحة Bindings
    انقر فوق XML في لوحة Bindings

    ملاحظة:

    يمكنك أيضًا النقر فوق الارتباط المصدر في الجانب العلوي الأيمن من لوحة Bindings لإضافة مصدر بيانات XML.

  2. قم بأحد الإجراءات التالية:
    • حدد Attach A Local File، وانقر فوق الزر Browse، واستعرض حتى تصل إلى ملف XML محلي على جهاز الكمبيوتر الخاص بك، وانقر فوق OK.

    • حدد Attach A Remote File، وأدخل عنوان URL لملف XML على الإنترنت (مثل ملف قادم من ملقم RSS).

  3. انقر فوق OK لإغلاق مربع الحوار Locate XML Source.

    ويتم ملء لوحة Bindings بمخطط مصدر بيانات XML الخاصة بك.

عرض بيانات XML في صفحات XSLT

بعد إنشائك لصفحة XSLT وإلحاق مصدر بيانات XML، يمكنك ربط البيانات إلى الصفحة. لعمل ذلك، تضيف عنصر نائب لبيانات XML إلى صفحتك، ثم تستخدم XPath Expression Builder أو Property inspector لتنسيق البيانات المحددة التي سيتم عرضها على الصفحة.

  1. افتح صفحة XSLT بمصدر بيانات XML مرفق.
  2. (اختياري) حدد Insert > Table لإضافة جدول إلى الصفحة. جدول يساعدك على تنظيم بيانات XML الخاصة بك.

    ملاحظة:

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

  3. في لوحة Bindings، حدد عنصر XML واسحبه إلى المكان الذي تريد فيه إدخال البيانات في الصفحة.
    حدد عنصر XML في لوحة Bindings
    حدد عنصر XML في لوحة Bindings

    يظهر عنصر نائب لبيانات XML في الصفحة. يتم تمييز العنصر النائب ويكون بين أقواس مقوسة. حيث يستخدم بناء جملة XPath (لغة مسار XML) لوصف البنية الهرمية لمخطط XML. على سبيل المثال، إذا سحبت العنصر التابع title إلى الصفحة، ويحتوي هذا العنصر على العناصر الأصل rssو channel item، ثم سيكون بناء الجملة للعنصر النائب للمحتوى الديناميكي هو {rss/channel/item/title}.

    انقر نقرًا مزدوجًا فوق العنصر النائب لبيانات XML على الصفحة لفتح XPath Expression Builder. يتيح لك XPath Expression Builder تنسيق البيانات المحددة، أو تحديد عناصر أخرى من مخطط XML.

  4. (اختياري) طبّق الأنماط على بيانات XML الخاصة بك بتحديد عنصر نائب لبيانات XML وتطبيق الأنماط عليه مثل أي جزء آخر من المحتويات باستخدام Property inspector أو اللوحة CSS Styles. وبديلاً عن ذلك، يمكنك استخدام صحيفة أنماط وقت التصميم لتطبيق الأنماط على جزء XSLT. ولكل أسلوب من هذه الأساليب مجموعة من الفوائد والقيود.
  5. استعرض عملك في مستعرض (File > Preview in Browser).

    ملاحظة:

    عندما تستعرض عملك باستخدام الخيار استعراض في مستعرض، ينفذ Dreamweaver تحويل XSL بدون استخدام خادم تطبيقات.

عرض عناصر تكرار XML

يتيح لك كائن XSLT لمنطقة التكرار إمكانية عرض عناصر التكرار من مصدر بيانات XML في صفحة ويب. على سبيل المثال، إذا كنت تعرض عناوين وأوصاف مقالاتهم من ملقم أخبار، ويحتوي ملقم الأخبار على ما بين 10 و20 مقالاً، وفي الأغلب يكون كل عنوان ووصف في ملف XML عنصرًا فرعيًا من عنصر تكرار.

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

  1. في طريقة عرض التصميم، حدد منطقة تحتوي على عنصر نائب بيانات XML أو العناصر النائبة.

    يمكن أن يكون التحديد أي شيء، بما في ذلك جدول أو صف جدول أو حتى فقرة من نص.

    طريقة العرض Design
    طريقة العرض Design

    ملاحظة:

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

  2. قم بأحد الإجراءات التالية
    • حدد Insert > XSLT Objects > Repeating Region.

    • في فئة XSLT من لوحة Insert، انقر فوق الزر Repeating Region.

  3. في XPath Expression Builder، حدد عنصر التكرار، الذي تحدده علامة زائد صغيرة.
    XPath Expression Builder
    XPath Expression Builder

  4. انقر فوق OK.

    في النافذة Document، يظهر حد رقيق مبوب رمادي حول المنطقة المكررة. عندما تقوم باستعراض عملك في مستعرض (File > Preview in Browser)، يختفي الحد الرمادي ويمتد التحديد لعرض عناصر التكرار المحددة في ملف XML.

    عندما تضيف كائن XSLT لمنطقة التكرار إلى الصفحة، يكون العنصر النائب لبيانات XML في النافذة Document مبتورًا. ويرجع هذا إلى قيام Dreamweaver باقتطاع XPath للعنصر النائب لبيانات XML بحيث يكون متعلقًا بمسار عنصر التكرار.

قم بتعيين خصائص منطقة تكرار (XSL)

في Property inspector، يمكنك تحديد عقدة XML مختلفة لإنشاء منطقة التكرار.

  1. في المربع Select، أدخل عقدة جديدة، ثم اضغط رمز البرق وحدد العقدة من شجرة مخططات XML التي تظهر.

حرر كائن XSLT لمنطقة تكرار

بعد إضافة كائن XSLT لمنطقة التكرار إلى المنطقة، يمكنك تحريره بإضافة Property inspector.

  1. حدد الكائن عن طريق النقر فوق علامة التبويب الرمادية الذي يحيط بالمنطقة المكررة.
  2. في Property inspector (Window > Properties)، انقر فوق الرمز الديناميكي المجاور لحقل النص Select.
  3. في XPath Expression Builder، قم بإجراء التغييرات، ثم انقر فوق OK.

أدخل أجزاء XSLT في الصفحات الديناميكية

بعد إنشائك لجزء XSLT، يمكنك إدخاله في صفحة ويب ديناميكية باستخدام سلوك خادم تحويل XSL. عندما تضيف سلوك الخادم إلى صفحتك وعرض الصفحة في مستعرض، ينفذ خادم تطبيقات تحويلاً يعرض بيانات XML من جزء XSLT المحدد. يدعم Dreamweaver تحويلات XSL لصفحات ColdFusion أو ASP أو PHP.

ملاحظة:

إذا كنت تريد إدخال محتويات صفحة XSLT الكاملة في صفحة ديناميكية، فاستخدم نفس الإجراء. قبل استخدام سلوك خادم تحويل XSL لإدخال صفحة XSLT الكاملة، احذف كل تعليمة برمجية HTML من الصفحة الديناميكية.

  1. افتح صفحة ColdFusion أو ASP أو PHP موجودة.
  2. في طريقة العرض Design، ضع نقطة الإدراج في الموضع الذي تريد إدخال جزء XSLT به.

    ملاحظة:

    عند إدخال أجزاء XSLT، يجب عليك دائمًا النقر فوق الزر Show Code وDesign Views بعد وضع نقطة الإدراج في الصفحة بحيث يمكنك ضمان وجود نقطة الإدراج في المكان الصحيح. إذا لم يكن الأمر كذلك، قد تحتاج إلى النقر في مكان آخر في طريقة العرض Code لوضع نقطة الإدراج حيث تريدها.

  3. في لوحة Server Behaviors (Window > Server Behaviors)، انقر فوق زر الإضافة (+) وحدد XSL Transformation.
    اللوحة Server Behaviors
    اللوحة Server Behaviors

  4. في مربع حوار XSL Transformation، انقر فوق الزر Browse واستعرض حتى الصول إلى جزء XSLT أو صفحة XSLT كاملة.

    يملأ Dreamweaver حقل النص التالي بمسار الملف أو عنوان URL لملف XML المرفق بالجزء المحدد. لتغيير ذلك، انقر فوق الزر Browse، ثم استعرض وصولاً إلى ملف آخر.

  5. (إضافي) انقر فوق زر الإضافة (+) لإضافة معلمة XSLT.
  6. انقر فوق OK لإدخال مرجع إلى جزء XSLT في الصفحة. الجزء غير قابل للتحرير. يمكنك النقر نقرًا مزدوجًا فوق الجزء لفتح ملف مصدر الجزء وتحريره.

    يتم أيضًا إنشاء مجلد includes/MM_XSLTransform/ في المجلد الجذر للموقع الذي يحتوي على ملف مكتبة وقت تشغيل. ويستخدم خادم التطبيقات الوظائف المحددة في هذا الملف لإجراء التحويل.

  7. حمِّل الصفحة الديناميكية إلى خادمك (Site > Put) وانقر فوق Yes لتضمين ملفات تابعة. ويجب أن يكون كلٌ من الملف الذي يحتوي على جزء XSLT وملف XML الذي يحتوي على البيانات، وملف مكتبة وقت التشغيل الذي تم إنشاؤه على الخادم من أجل عرض صفحتك بصورة صحيحة. (إذا حددت ملف XML بعيد كمصدر بيانات، يجب أن يكون هذا الملف بالطبع في مكان آخر على الإنترنت).

أزل أجزاء XSLT من الصفحات الديناميكية

يمكنك إزالة جزء XSLT من صفحة بإزالة سلوك خادم تحويل XSL المستخدم لإدراج الجزء. يعمل حذف سلوك الخادم على حذف جزء XSLT فقط - ولا يحذف ملفات XML أو XSLT أو مكتبة وقت التشغيل المرتبطة.

  1. في لوحة Server Behaviors (Window > Server Behaviors)، حدد سلوك خادم تحويل XSL الذي تريد حذفه.
  2. انقر فوق زر علامة الطرح (-).

    ملاحظة:

    يجب عليك دائمًا إزالة سلوكيات الخادم بهذه الطريقة. ويؤدي الحذف اليدوي للتعليمة البرمجية التي تم إنشاؤها إلى الحذف الجزئي فقط لسلوك الخادم، حتى بالرغم من أن سلوك الخادم قد يختفي من لوحة Server Behaviors.

حرر سلوكيات خادم تحويل XSL

بعد إضافتك جزء XSLT إلى صفحة ويب ديناميكية، يمكنك تحرير سلوك خادم تحويل XSL في أي وقت.

  1. في لوحة Server Behaviors (Window > Server Behaviors)، انقر نقرًا مزدوجًا فوق سلوك خادم تحويل XSL الذي تريد تحريره.
  2. قم بإجراء التغييرات التي تريدها ثم انقر فوق OK.

يمكنك إنشاء ارتباط ديناميكي على صفحة XSLT الخاصة بك التي ترتبط بعنوان URL محدد عندما ينقر المستخدم على كلمة محددة أو مجموعة كلمات محددة من بيانات XML الخاصة بك. للحصول على التعليمات الكاملة، انظر بيانات Dreamweaver المرجعية على www.adobe.com/go/dw_documentation_ae.

تطبيق الأنماط على أجزاء XSLT

عندما تقوم بإنشاء صفحة XSLT مكتملة (وهي صفحة XSLT تحتوي على علامات <body> و <head>)، يمكنك عرض بيانات XML على الصفحة، ثم تنسيق البيانات مثل أي محتوى آخر باستخدام Property inspector أو لوحة CSS Styles. عندما تقوم بإنشاء جزء XSLT لإدراجه في صفحة ديناميكية، ومع ذلك (على سبيل المثال، جزء للإدخال في صفحة ASP أو PHP أو Cold Fusion)، يصبح عرض الأنماط في الجزء وفي الصفحة الديناميكية أكثر تعقيدًا. بالرغم من أنك تعمل على جزء XSLT بصورة منفصلة من الصفحة الديناميكية، من الهام أن تتذكر أن الغرض من الجزء هو استخدامه في الصفحة الديناميكية، وأن المخرجات من جزء XSLT موجودة في النهاية في علامات <body> من الصفحة الديناميكية. مع وضع سير العمل في الاعتبار، من الهام أن تتأكد أنك لم تضمِّن عناصر <head> (مثل تعريفات الأنماط أو الارتباطات إلى صفحات الأنماط الخارجية) في أجزاء XSLT. يتسبب القيام بذلك في أن يضع خادم التطبيقات هذه العناصر في <body> من الصفحة الديناميكية، وبذلك ينشئ تمييزًا غير صالح.

على سبيل المثال، قد ترغب في إنشاء جزء XSLT لإدراجه في صفحة ديناميكية وتنسيق الجزء باستخدام نفس صحية الأنماط كالصفحة الديناميكية. في حالة إرفاق نفس صحيفة الأنماط، ستحتوي صفحة HTML على ارتباط مزدوج إلى صحيفة الأنماط (أحدها في القسم <head> من الصفحة الديناميكية، وآخر في قسم <body> من الصفحة، حيث يظهر محتوى جزء XSLT). وبدلاً من هذا النهج، يجب عليك استخدام صفحات أنماط Design-time للإشارة إلى صحيفة أنماط خارجية.

عند تنسيق سياق أجزاء XSLT، استخدم سير العمل التالي:

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

  • ثم بعد ذلك، أرفق نفس صحيفة الأنماط الخارجية إلى جزء XSLT كصحيفة أنماط Design-time. وكما هو واضح من الاسم، تعمل صحيفة أنماط , Design-time فقط في طريقة العرض Design في Dreamweaver.

    بعد أن أكملت الخطوتين السابقتين، يمكنك إنشاء أنماط جديدة في جزء XSLT الخاص بك باستخدام نفس صحيفة الأنماط التي أرفقتها بصفحتك الديناميكية. ستكون مخرجات HTML أنظف (نظرًا لأن المرجع إلى صفحة الأنماط صالح فقط عند العمل في Dreamweaver)، وسيظل الجزء يعرض الأنماط الملائمة في طريقة العرض Design. بالإضافة إلى ذلك، سيتم تطبيق كل الأنماط الخاصة بك على كلٍ من الجزء والصفحة الديناميكية عندما تعرض الصفحة الديناميكية في طريقة العرض Design، أو تستعرض الصفحة الديناميكية في مستعرض.

ملاحظة:

إذا استعرضت جزء XSLT في مستعرض، لن يعرض المستعرض الأنماط. وبدلاً من ذلك، ينبغي عليك استعراض الصفحة الديناميكية في المستعرض لعرض جزء XSLT في سياق الصفحة الديناميكية.

استخدام المعلمات بتحويلات XSL

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

أضف معلمة XSL إلى تحويل XSL

  1. افتح مربع الحوار XSL Transformation. يمكنك القيام بذلك من خلال النقر نقرًا مزدوجًا فوق سلوك خادم تحويل XSL في لوحة Server Behaviors (Window > Server Behaviors)، أو بإضافة سلوك خادم Transformation server جديد.
  2. في مربع الحوار XSL Transformation، انقر فوق زر الإضافة (+) المجاور لمعلمات XSLT.
    مربع الحوار XSL Transformation
    مربع الحوار XSL Transformation

  3. في مربع الحوار Add Parameters، أدخل اسمًا للمعلمة في المربع Name. يجب أن يحتوي الاسم على حروف أبجدية رقمية. ولا يمكن أن يحتوي على مسافات.
  4. قم بأحد الإجراءات التالية:
    • إذا كنت تريد استخدام قيمة ثابتة، أدخلها في المربع Value.

    • إذا كنت تريد استخدام قيمة ديناميكية، انقر فوق الرمز الديناميكي المجاور للمربع Value، ثم أكمل مربع الحوار Dynamic Data، ثم انقر فوق OK. لمزيد من المعلومات، انقر فوق الزر Help، في مربع الحوار Dynamic Data.

  5. في المربع Default Value، أدخل القيمة التي تريد للمعلمة أن تستخدمها إذا كانت الصفحة لا تتلقى أي قيمة وقت تشغيل، وانقر فوق OK.

حرر معلمة XSLT

  1. افتح مربع الحوار XSL Transformation. يمكنك القيام بذلك من خلال النقر نقرًا مزدوجًا فوق سلوك خادم تحويل XSL في لوحة Server Behaviors (Window > Server Behaviors)، أو بإضافة سلوك خادم Transformation server جديد.
  2. حدد معلمة من قائمة معلمات XSLT.
  3. انقر فوق الزر Edit.
  4. قم بإجراء التغييرات التي تريدها ثم انقر فوق OK.

احذف معلمة XSLT

  1. افتح مربع الحوار XSL Transformation. يمكنك القيام بذلك من خلال النقر نقرًا مزدوجًا فوق سلوك خادم تحويل XSL في لوحة Server Behaviors (Window > Server Behaviors)، أو بإضافة سلوك خادم Transformation server جديد.
  2. حدد معلمة من قائمة معلمات XSLT.
  3. انقر فوق زر علامة الطرح (-).

قم بإنشاء وتحرير مناطق XSLT شرطية

يمكنك إنشاء مناطق شرطية بسيطة أو مناطق شرطية متعددة على صفحة XSLT. يمكنك إما تحديد عنصر في طريقة العرض Design أو تطبيق منطقة شرطية على التحديد، أو يمكنك إدراج منطقة شرطية أينما تكون نقطة الإدراج في المستند.

على سبيل المثال، إذا كنت ترغب في عرض الكلمة "Unavailable" بجوار سعر بند عندما يكون البند غير متاح، اكتب النص "Unavailable" في الصفحة، ثم طبق منطقة شرطية على النص المحدد. يحيط Dreamweaver التحديد بعلامات <xsl:if> ويعرض فقط الكلمة "Unavailable" في الصفحة عندما تطابق البيانات شروط التعبير الاشتراطي.

طبق منطقة XSLT شرطية

يمكنك كتابة تعبير شرطي بسيط لإدراجه في صفحة XSLT. في حالة تحديد محتوى عندما تفتح مربع الحوار Conditional Region، سيتم لف المحتوى في كتلة <xsl:if>. في حالة عدم تحديد المحتوى، تتم إضافة الكتلة <xsl:if> في نقطة الإدراج بالصفحة. من الأفكار الجيدة أيضًا استخدام مربع حوار للبدء، ثم تخصيص التعبير في طريقة العرض Code.

يعد العنصر <xsl:if> مشابهًا لـ إذا كانت العبارة بلغة أخرى. يوفر لك العنصر طريقة لاختبار شرط واتخاذ إجراء بناءً على النتيجة. يتيح لك العنصر <xsl:if> اختبار تعبير لقيمة صواب أو خطأ مفردة.

  1. حدد Insert > XSLT Objects > Conditional Region أو انقر فوق الرمز Conditional Region بفئة XLST في لوحة Insert.
  2. في مربع الحوار Conditional Region،أدخل التعبير الشرطي لاستخدامه للمنطقة.

    في المثال التالي، تريد الاختبار لكي ترى قيمة سمة عقدة السياق @available هي true.

    مربع حوار Conditional Region
    مربع حوار Conditional Region

  3. انقر فوق OK.

    يتم إدراج التعليمة البرمجية التالية في صفحة XSLT الخاصة بك:

    <xsl:if test="@available=&apos;true&apos;"> 
        Content goes here 
    </xsl:if>

    ملاحظة:

    يجب أن تحيط قيم السلسلة مثل القيمة صواب بعلامة تنصيص. يقوم Dreamweaver بترميز علامات التنصيص لك (&apos;) وبذلك يتم إدخالها كـ HTML صالح.

    بالإضافة إلى اختبار العقد للقيم، يمكنك استخدام أي من وظائف XSLT المدعومة في أي عبارة شرطية. يتم اختبار الشرط للعقدة الحالية داخل ملف XML. في المثال التالي، تريد الاختبار للعقدة الأخيرة في مجموعة النتائج:

    اختبار آخر عقدة في مجموعة النتائج
    اختبار آخر عقدة في مجموعة النتائج

    لمزيد من المعلومات والأمثلة على كتابة التعبيرات الشرطية، راجع قسم <xsl:if> في لوحة Reference (Help > Reference).

تطبيق مناطق XSLT شرطية متعددة

يمكنك كتابة تعبير شرطي بسيط لإدراجه في صفحة XSLT. في حالة تحديد محتوى عندما تفتح مربع الحوار Conditional Region، يتم لف المحتوى في كتلة <xsl:choose>. في حالة عدم تحديد المحتوى، تتم إضافة الكتلة <xsl:choose> في نقطة الإدراج في الصفحة. من الأفكار الجيدة أيضًا استخدام مربع حوار للبدء، ثم تخصيص التعبير في طريقة العرض Code.

يعد العنصر <xsl:choose> مشابهًا لعبارة case بلغة أخرى. يوفر لك العنصر طريقة لاختبار شرط واتخاذ إجراء بناءً على النتيجة. يتيح لك العنصر <xsl:choose> اختبار شروط متعددة.

  1. حدد Insert > XSLT Objects > Multiple Conditional Region أو انقر فوق رمز Multiple Conditional Region في فئة XLST من لوحة Insert.
  2. في مربع الحوار Multiple Conditional Region،أدخل الشرط الأول.

    في المثال التالي، تريد الاختبار لكي ترى إذا كان العنصر الفرعي price لعقدة السياق أقل من 5.

    مربع حوار Multiple Conditional Region
    مربع حوار Multiple Conditional Region

  3. انقر فوق OK.

    في المثال، يتم إدراج التعليمة البرمجية التالية في صفحة XSLT الخاصة بك:

    <xsl:choose> 
        <xsl:when test="price&lt;5"> 
            Content goes here 
        </xsl:when> 
        <xsl:otherwise> 
            Content goes here 
        </xsl:otherwise> 
    </xsl:choose>
  4. لإدراج شرط آخر، ضع نقطة الإدراج في طريقة العرض Code بين زوج من العلامات <xsl:when> أو قبل علامة <xsl:otherwise> مباشرةً، ثم أدرج منطقة شرطية (Insert > XSLT Objects > Conditional Region).

    بعد تحديد الشرط والضغط فوق OK، يتم إدراج علامة <xsl:when> في كتلة <xsl:choose>.

    لمزيد من المعلومات والأمثلة حول كتابة تعبيرات شرطية، راجع أقسام <xsl:choose> في لوحة Reference (Help > Reference).

قم بتعيين خصائص المنطقة الشرطية (If)

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

  1. في المربع Test، أدخل شرطًا جديدًا، ثم اضغط Enter.

قم بتعيين خصائص (When) الشرطية

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

  1. في المربع Test، أدخل شرطًا جديدًا، ثم اضغط Enter.

أدخل تعليقات XSL

يمكنك إضافة علامات تعليقات XSL إلى مستند، أو يمكنك لف تحديد في علامات تعليقات XSL.

أضف علامات تعليقات XSL إلى مستند

  1. قم بأحد الإجراءات التالية:
    • في طريقة العرض Design، حدد Insert > XSLT Objects > XSL Comment، واكتب محتويات التعليق (أو اترك المربع فارغًا)، ثم انقر فوق OK.

    • في طريقة العرض Code، حدد Insert > XSLT Objects > XSL Comment.

    ملاحظة:

    يمكنك النقر أيضًا فوق رمز تعليق XSL في فئة XSLT من لوحة Insert.

قم بلف تحديد في علامات تعليقات XSL

  1. التبديل إلى عرض Code (View > Code)
  2. حدد التعليمة البرمجية التي تريد التعليق عليها.
  3. في شريط أدوات Coding، انقر فوق الزر Comment، ثم حدد Apply <xsl:comment></xsl:comment> Comment.

استخدم XPath Expression Builder لإضافة تعبيرات لبيانات XML

إن XPath (لغة مسار XML) ليس بناء جملة XML لمعالجة أجزاء مستند XML. تستخدم غالبًا كلغة استعلام لبيانات XML، كاستخدام لغة SQL لاستعلام قواعد البيانات. لمزيد من المعلومات عن XPath، راجع مواصفات لغة XPath في موقع W3C على الويب على www.w3.org/TR/xpath.

XPath Expression Builder هو ميزة Dreamweaver تتيح لك بناء تعبيرات XPath بسيطة لتحديد عقد محددة من البيانات ولمناطق التكرار. وتعد ميزة استخدام هذا الأسلوب بدلاً من سحب القيم من شجرة مخططات XML هي أنه يمكنك تنسيق القيمة التي يتم عرضها. وقد تم تحديد السياق الحالي بناءً على موقع نقطة الإدراج في ملف XSL عندما يتم فتح مربع حوار XPath Expression Builder. السياق الحالي بالنوع الغامق في شجرة مخططات XML. حينما تقوم بإجراء التحديدات داخل مربع الحوار هذا، يتم إنشاء جمل XPath الصحيحة، المتعلقة بالسياق الحالي الخاص بك. وهذا يبسِّط عملية كتابة تعبيرات XPath الصحيحة للمستخدمين المبتدئين والمتقدمين.

ملاحظة:

تم تصميم هذه الميزة لمساعدتك على بناء تعبيرات XPath البسيطة لتحديد عقدة محددة أو لمناطق التكرار. فهي لا تتيح لك تحرير التعبيرات باليد. إذا كنت بحاجة إلى إنشاء تعبيرات معقدة، استخدم XPath Expression Builder للبدء، ثم قم بتخصيص تعبيرات في طريقة العرض Code أو بعارض الخصائص.

قم بإنشاء تعبير XPath لتحديد عقدة محددة

  1. انقر نقرًا مزدوجًا فوق العنصر النائب لبيانات XML على الصفحة لفتح XPath Expression Builder.
  2. في مربع الحوار XPath Expression Builder (Dynamic Text)، حدد أي عقدة في شجرة مخططات XML.

    يتم كتابة تعبير XPath الصحيح في المربع Expression لتحديد العقدة.

    ملاحظة:

    إذا حددت عقدة مختلفة في شجرة مخططات XML، يتغير التعبير ليعكس اختيارك.

    في المثال التالي، ترغب في عرض العنصر الفرعي price‎ لعقدة ‎item:

    مربع حوار XPath Expression Builder (النص الديناميكي)
    مربع حوار XPath Expression Builder (النص الديناميكي)

    وسيعمل هذا التحديد على إدراج التعليمة البرمجية التالية في صفحة XSLT الخاصة بك:

    <xsl:value-of select="price"/>
  3. (اختياري) حدد خيار تنسيق من القائمة المنبثقة Format.

    يعد تنسيق تحديد أمرًا مفيدًا عندما ينتج عن قيمة عقدتك رقم. يوفر Dreamweaver قائمة محددة مسبقًا من وظائف التنسيق. للحصول على قائمة مكتملة من وظائف التنسيق والأمثلة المتاحة، راجع لوحة Reference.

    في المثال التالي، تريد تنسيق العنصر الفرعي price‎ كعملة بموضعين عشريين:

    تنسيق العنصر الفرعي للسعر كعملة بموضعين عشريين
    تنسيق العنصر الفرعي للسعر كعملة بموضعين عشريين

    تقوم هذه الخيارات بإدراج التعليمة البرمجية التالية في صفحة XSLT:<xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>

    <xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>
  4. انقر فوق OK.
  5. لعرض قيمة كل عقدة في ملف XML، طبق منطقة تكرار على العنصر الذي يحتوي على نص ديناميكي (على سبيل المثال، فقرة أو صف جدول HTML).

    لمزيد من المعلومات والأمثلة على تحديد العقد لإنتاج قيمة، راجع القسم <xsl:value-of/> في لوحة Reference.

حدد عقدة لتكرارها

يمكنك تحديد عقدة لتكرارها ولتصفية النتائج (اختياريًا). في مربع الحوار XPath Expression Builder، سيتم لف المحتوى الذي حددته داخل كتلة <xsl:for-each>. إذا لم تحدد محتوى، سيتم إدخال كتلة <xsl:for-each> في نقطة الإدراج الخاصة بمؤشرك.

  1. انقر نقرًا مزدوجًا فوق العنصر النائب لبيانات XML على الصفحة لفتح XPath Expression Builder.
  2. في مربع الحوار XPath Expression Builder (Repeating Region)، حدد العنصر الذي تريده في شجرة مخططات XML.

    يتم كتابة تعبير XPath الصحيح في المربع Expression لتحديد العقدة.

    ملاحظة:

    يتم تحديد عناصر التكرار برمز الإضافة (+) في شجرة مخططات XML.

    في المثال التالي، تريد إلى تكرار كل عقدة بند في ملف XML.

    مربع حوار XPath Expression Builder (منطقة التكرار)
    مربع حوار XPath Expression Builder (منطقة التكرار)

    عندما تنقر فوق OK، يتم إدراج التعليمة البرمجية التالية في صفحة XSLT الخاصة بك:

    <xsl:for-each select="provider/store/items/item"> 
     Content goes here 
    </xsl:for-each>

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

قم بتصفية البيانات المطلوب تكرارها

استخدم عامل تصفية لتحديد عقد التكرار التي تحتوي على قيم سمات محددة.

  1. في مخطط XML، حدد عقدة لتكرارها.
  2. انقر فوق الزر Build Filter expander.
  3. انقر فوق زر الإضافة (+) لإنشاء عامل تصفية فارغ.
  4. أدخل معايير عامل التصفية في الحقول التالية:

    تصفية حسب

    يحدد عقدة التكرار التي تحتوي على البيانات التي تريد تصفيتها. توفر القائمة المنبثقة قائمة من العقد الأصل المتعلقة بالعقدة التي حددتها في شجرة مخططات XML.

    Where

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

    العامل

    يحدد عامل المقارنة المطلوب استخدامه في تعبير عنصر التصفية.

    Value

    تحدد القيمة المطلوب فحصها في عنصر التصفية حسب العقدة. أدخل القيمة. في حالة تحديد معلمات ديناميكية لصفحة XSLT الخاصة بك، يمكنك تحديد واحدة من القائمة المنبثقة.

  5. لتحديد عنصر تصفية آخر، انقر فوق زر الإضافة (+) مرة أخرى.

    عند إدخالك قيم أو إجراء تحديدات في القوائم المنبثقة، يتغير تعبير XPath في المربع Expression.

    في المثال التالي، تريد تقييد النتيجة التي تم تعيينها لعُقد item‎ حيث تكون قيمة سمة @available هي true.

    قم بتقييد مجموعة النتائج التي تم تعيينها لعُقد item‎ هذه حيث تكون قيمة سمة @available هي true
    قم بتقييد مجموعة النتائج التي تم تعيينها لعُقد item‎ هذه حيث تكون قيمة سمة @available هي true

    وعند النقر فوق OK، يتم إدراج التعليمة البرمجية التالية في صفحة XSLT لديك:<xsl:for-each select="provider/store/items/item[@available = &apos;true&apos;]"> Content goes here </xsl:for-each>

    <xsl:for-each select="provider/store/items/item[@available = &apos;true&apos;]"> 
          Content goes here 
    </xsl:for-each>

    ملاحظة:

    تحتاج إلى أن تحيط قيم السلسلة مثل القيمة صواب بعلامة تنصيص. يقوم Dreamweaver بترميز علامات التنصيص لك (&apos;) وبذلك يتم إدخالها كـ HTML صالح.

    يمكنك إنشاء عوامل تصفية معقدة أكثر تتيح لك تحديد عقد أصل كجزء من معايير عامل التصفية الخاص بك. في المثال التالي، تريد تقييد مجموعة النتائج المعينة إلى عُقد item حيث تكون السمة store’s @id تساوي 1 وعقدة item’s price أكبر من 5.

    قم بتقييد مجموعة النتائج المعينة إلى عُقد item حيث تكون السمة store’s @id تساوي 1 وعقدة item’s price أكبر من 5
    قم بتقييد مجموعة النتائج المعينة إلى عُقد item حيث تكون السمة store’s @id تساوي 1 وعقدة item’s price أكبر من 5.

    وعند النقر فوق OK، يتم إدراج التعليمة البرمجية التالية في صفحة XSLT لديك:<xsl:for-each select="provider/store[@id = 1]/items/item[price &gt; 5]"> Content goes here </xsl:for-each>

    لمزيد من المعلومات والأمثلة عن مناطق التكرار، راجع قسم <xsl:for-each> في لوحة Reference.

    <xsl:for-each select="provider/store[@id = 1]/items/item[price &gt; 5]"> 
        Content goes here 
    </xsl:for-each>

تم ترخيص هذا العمل بموجب الترخيص العام غير المعدل الخاص بالإسناد وعدم التجارة والمشاركة الإصدار 3.0 ‏من ‏‏Creative Commons‏‏  إن بنود Creative Commons لا تشمل منشورات Twitter™‎ وFacebook.

إشعارات قانونية   |   سياسة الخصوصية على الإنترنت