בחר 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 (Fragment) כדי ליצור מקטע XSLT.
לחצו על יצירה ובצעו אחת מהפעולות הבאות בתיבת הדו-שיח 'Locate XML Source':
- בחר Attach A Local File, לחץ על הלחצן Browse, עיין לקובץ XML מקומי במחשב ולחץ על OK.
- בחר Attach A Remote File, הזן כתובת URL של קובץ XML באינטרנט (כגון כתובת המגיעה מהזנת RSS), ולחץ על OK.
אם תלחץ על הלחצן Cancel, ייווצר דף XSLT חדש ללא מקור נתוני XML מקושר.
החלונית Bindings כוללת את הסכימה של מקור נתוני XML
הטבלה הבאה מציגה הסבר לרכיבים השונים בסכימה שיכולים להופיע:
רכיב |
מייצג |
פרטים |
|---|---|---|
<> |
רכיב XML לא חוזר נדרש |
רכיב המופיע בדיוק פעם אחת בצומת האב |
<>+ |
רכיב XML חוזר |
רכיב המופיע פעם אחת או יותר בצומת האב |
<>+ |
רכיב XML אופציונלי |
רכיב המופיע אפס פעמים או יותר בצומת האב |
צומת רכיב בגופן מודגש |
רכיב בהקשר נוכחי |
בדרך כלל הרכיב החוזר, כשנקודת ההכנסה נמצאת בתוך אזור חוזר |
@ |
תכונת XML |
|
שמרו את העמוד החדש שלכם (File > Save) עם
סיומת .xsl או .xslt (.xsl הוא ברירת המחדל).
המרת דפי HTML לדףי XSLT
אפשר גם להמיר עמודי HTML קיימים לעמודי XSLT. לדוגמה, אם יש לכם עמוד סטטי מעוצב מראש שאליו אתם רוצים להוסיף נתוני XML, אפשר להמיר את העמוד לעמוד XSLT, במקום ליצור עמוד XSLT ולעצב מחדש את העמוד מההתחלה.
פתח דף HTML שברצונך להמיר.
בחרו File > Convert > XSLT 1.0
עותק של הדף נפתח בחלון המסמך. העמוד החדש הוא גליון סגנונות XSL, הנשמר עם סיומת .xsl.
צירוף מקורות של נתוני XML
אם אתם מתחילים עם עמוד XSLT קיים, או אם אתם לא מצרפים מקור נתוני XML בעת יצירת עמוד XSLT חדש עם Dreamweaver, עליכם לצרף מקור נתוני XML באמצעות לוח Bindings.
בלוח Bindings (Window > Bindings),
לחצו על קישור XML.
ניתן גם ללחוץ על הקישור Source בפינה הימנית העליונה של החלונית Bindings להוספת מקור נתוני XML.
בצע אחת מהפעולות הבאות:
בחרו Attach A Local File, לחצו על לחצן Browse, דפדפו לקובץ XML מקומי במחשב שלכם ולחצו על OK.
בחרו ב-Attach A Remote File והזינו את כתובת ה-URL של קובץ XML באינטרנט (כגון זה שמגיע מהזנת RSS).
לחץ על OK כדי לסגור את תיבת הדו-שיח Locate XML Source.
לוח Bindings מתמלא בסכמת מקור נתוני ה-XML שלכם.
הצגת נתוני XML בדפי XSLT
לאחר שיצרתם עמוד XSLT וצירפתם מקור נתוני XML, אפשר לקשר נתונים לעמוד. לשם כך, אתם מוסיפים מציין מיקום נתוני XML לעמוד שלכם ואז משתמשים ב-XPath Expression Builder או ב-Property inspector כדי לעצב נתונים נבחרים שיוצגו בעמוד.
פתח דף XSLT עם מקור נתוני XML מצורף.
(אופציונלי) בחרו Insert > Table כדי להוסיף טבלה לעמוד.טבלה מסייעת לך לארגן נתוני XML.
פתק
ברוב המקרים, אתם משתמשים באובייקט XSLT של Repeating Region כדי להציג אלמנטי XML חוזרים בעמוד. במקרה זה, אולי תרצו ליצור טבלה עם שורה אחת ועמודה אחת או יותר, או טבלה עם שתי שורות אם אתם רוצים לכלול כותרת טבלה.
בלוח Bindings, בחרו אלמנט XML וגררו אותו למקום בעמוד שבו אתם רוצים להוסיף נתונים.
מציין מיקום נתוני XML מופיע בעמוד. המציין מודגש ובסוגריים מסולסלים. הוא משתמש בתחביר XPath (XML Path language) כדי לתאר את המבנה ההיררכי של סכמת ה-XML. לדוגמה, אם אתם גוררים את אלמנט הצאצא title לעמוד, ולאלמנט הזה יש את אלמנטי ההורה rss, channel, ו-item, אז התחביר עבור מציין מיקום התוכן הדינמי יהיה {rss/channel/item/title}.
לחצו לחיצה כפולה על מציין מיקום נתוני XML בעמוד כדי לפתוח את XPath Expression Builder. ה-XPath Expression Builder מאפשר לכם לעצב נתונים נבחרים, או לבחור פריטים אחרים מסכמת ה-XML.
(אופציונלי) להחיל סגנונות על נתוני XML שלכם על ידי בחירה
במציין מיקום נתוני XML והחלת סגנונות עליו כמו כל
פיסת תוכן אחרת באמצעות Property inspector או לוח CSS Styles. לחלופין, תוכלו להשתמש בגיליונות סגנון של זמן עיצוב כדי להחיל\nסגנונות על קטעי XSLT.לכל אחת מהשיטות הללו יש קבוצה משלה של\nיתרונות ומגבלות.
הציגו תצוגה מקדימה של העבודה שלכם בדפדפן (File > Preview\nin Browser).
כשאתה מציג תצוגה מקדימה של עבודתך בעזרת האפשרות Preview in Browser, Dreamweaver מבצע המרת XSL פנימית מבלי להשתמש בשרת יישומים.
תצוגת רכיבי XML חוזרים
האובייקט Repeating Region XSLT מאפשר לכם להציג אלמנטים חוזרים ממקור נתונים XML בדף אינטרנט.לדוגמה, אם אתם מציגים כותרות מאמרים ותיאורים\nמהזנת חדשות, והזנת החדשות מכילה בין 10 ל-20\nמאמרים, כל כותרת ותיאור בקובץ ה-XML יהיו כנראה\nאלמנט צאצא של אלמנט חוזר.
כל אזור בתצוגת Design המכיל מציין מקום לנתוני XML ניתן להפוך לאזור חוזר.עם זאת, האזורים הנפוצים ביותר הם טבלאות, שורות טבלה או\nסדרה של שורות טבלה.
בתצוגת Design, בחרו אזור המכיל\nמציין מקום או מציינים לנתוני XML.
הבחירה יכולה להיות כל דבר, כולל טבלה, שורת\nטבלה או אפילו פסקת טקסט.
לבחירה מדויקת של אזור בדף, ניתן להשתמש בבורר התגים בפינה השמאלית התחתונה של חלון המסמך. לדוגמה, אם אזור הוא טבלה, לחץ בתוך הטבלה בדף, ולחץ על התג בבורר התגים.
בצע אחת מהפעולות הבאות:
בחרו Insert > XSLT Objects >\nRepeating Region.
בקטגוריית XSLT של לוח ה-Insert, לחצו על הלחצן Repeating Region.
ב-XPath Expression Builder, בחרו את האלמנט\nהחוזר, המסומן בסימן פלוס קטן.
לחץ על OK.
בחלון Document, מופיע מתאר אפור דק עם לשוניות מסביב לאזור החוזר.כשתציגו תצוגה מקדימה של העבודה שלכם בדפדפן\n(File > Preview in Browser), המתאר האפור נעלם\nוהבחירה מתרחבת כדי להציג את האלמנטים החוזרים המוגדרים\nבקובץ ה-XML.
כשאתם מוסיפים את האובייקט Repeating Region XSLT\nלדף, מציין המקום לנתוני ה-XML בחלון Document\nנקטע.הסיבה לכך היא ש-Dreamweaver קוטע\nאת ה-XPath עבור מציין המקום לנתוני ה-XML כך שהוא יחסי\nלנתיב של האלמנט החוזר.
הגדרת מאפייני אזור חוזר (XSL)
בבוחן המאפיינים, תוכלו לבחור\nצומת XML אחר כדי ליצור את האזור החוזר.
בתיבת Select, הזינו צומת חדש ולאחר מכן\nלחצו על סמל ברק ובחרו את הצומת מעץ סכמת ה-XML\nהמופיע.
עריכת אובייקט XSLT מסוג אזור חוזר
לאחר שהוספתם אובייקט Repeating Region XSLT\nלאזור, תוכלו לערוך אותו באמצעות בוחן המאפיינים.
בחרו את האובייקט על ידי לחיצה על הלשונית האפורה\nהמקיפה את האזור החוזר.
בבוחן המאפיינים (Window > Properties),\nלחצו על הסמל הדינמי ליד שדה הטקסט Select.
ב-XPath Expression Builder, בצעו את השינויים\nולחצו על OK.
הוספת קטעי XSLT בדפים\nדינמיים
לאחר שיצרתם קטע XSLT, תוכלו להוסיף אותו לדף אינטרנט דינמי באמצעות התנהגות השרת XSL Transformation.כשאתם מוסיפים את התנהגות\nהשרת לדף שלכם ומציגים את הדף בדפדפן, שרת יישומים\nמבצע טרנספורמציה המציגה את נתוני ה-XML מקטע ה-XSLT\nהנבחר.Dreamweaver תומך בהמרות XSL עבור דפי ColdFusion, ASP או PHP.
אם ברצונך להוסיף את התוכן של דף XSLT שלם לדף דינמי, ההליך זהה לחלוטין. לפני שימוש בהתנהגות המרת XSL של שרת להוספת דף XSLT שלם, מחק את קוד HTML מהדף הדינמי.
פתח דף קיים של ColdFusion, ASP או PHP.
בתצוגת Design, מקמו את נקודת ההוספה במיקום
שבו ברצונכם להוסיף את קטע ה-XSLT.
בשעת הוספת מקטעי XSLT, יש ללחוץ תמיד על הלחצן Show Code And Design Views לאחר הצבת נקודת ההכנסה בדף, כדי שתהיה בטוח שנקודת ההכנסה נמצאת במיקום הנכון. במקרה שלא, ייתכן שיהיה עליך ללחוץ במקום אחר בתצוגת Code כדי להציב את נקודת ההכנסה במיקום הרצוי.
בלוח Server Behaviors (Window > Server Behaviors), לחצו על הלחצן Plus (+) ובחרו XSL Transformation.
בתיבת הדו-שיח XSL Transformation, לחצו על הלחצן Browse
ועיינו בקטע XSLT או בדף XSLT שלם.
Dreamweaver ממלא את שדה הטקסט הבא בנתיב הקובץ או בכתובת ה-URL של קובץ ה-XML המצורף לקטע שצוין. כדי לשנות אותו, לחצו על הלחצן Browse ועיינו בקובץ אחר.
(אופציונלי) לחץ על הלחצן פלוס (+) להוספת פרמטר XSLT.
לחצו על OK כדי להוסיף הפניה לקטע ה-XSLT
בדף. המקטע אינו ניתן לעריכה. תוכלו ללחוץ לחיצה כפולה על
הקטע כדי לפתוח את קובץ המקור של הקטע ולערוך אותו.
נוצרת גם תיקיית includes/MM_XSLTransform/ בתיקייה הראשית של האתר המכילה קובץ ספריית זמן הריצה. שרת היישומים משתמש בפונקציות שהוגדרו בקובץ זה כדי לבצע את ההמרה.
העלו את הדף הדינמי לשרת שלכם (Site > Put) ולחצו על Yes כדי לכלול את הקבצים התלויים.הקובץ המכיל
את קטע ה-XSLT, קובץ ה-XML המכיל את הנתונים שלכם וקובץ
ספריית זמן הריצה שנוצר חייבים כולם להיות בשרת כדי
שהדף שלכם יוצג כראוי. (אם בחרתם בקובץ XML מרוחק כמקור הנתונים שלכם, הקובץ הזה חייב להיות ממוקם במקום אחר באינטרנט.)
מחיקת קטעי XSLT מדפים דינמיים
תוכלו להסיר קטע XSLT מדף על ידי מחיקת התנהגות השרת XSL Transformation שבה השתמשתם כדי להוסיף את הקטע. מחיקת התנהגות השרת מוחקת את קטע ה-XSLT בלבד – היא לא מוחקת את קבצי ה-XML, XSLT או ספריית זמן הריצה המשויכים.
בלוח Server Behaviors (Window >
Server Behaviors), בחרו את התנהגות השרת XSL Transformation
שברצונכם למחוק.
לחץ על הלחצן מינוס (-).
יש להסיר תמיד התנהגויות שרת בדרך זו. מחיקה ידנית של הקוד שנוצר מסירה חלקית את התנהגות השרת, גם אם התנהגות השרת לא תוצג בחלונית Server Behaviors.
עריכת התנהגויות שרת XSL Transformation
לאחר שהוספתם קטע XSLT לדף אינטרנט דינמי, תוכלו לערוך את התנהגות השרת XSL Transformation בכל עת.
בלוח Server Behaviors (Window > Server Behaviors), לחצו לחיצה כפולה על התנהגות השרת XSL Transformation שברצונכם לערוך.
בצע את השינויים הרצויים ולחץ על OK.
יצירת קישור דינמי
תוכלו ליצור קישור דינמי בדף ה-XSLT שלכם שמקשר לכתובת URL ספציפית כשהמשתמש לוחץ על מילה מסוימת או קבוצת מילים מנתוני ה-XML שלכם. להוראות מלאות, עיינו ב-errata של Dreamweaver בכתובת www.adobe.com/go/dw_documentation.
החלת סגנונות על מקטעי 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).במקום גישה זו, עליכם להשתמש בגיליונות סגנון של זמן עיצוב כדי להפנות לגיליון הסגנון החיצוני.
בעת עיצוב תוכן של קטעי 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 (Window > Server
Behaviors), או על ידי הוספת התנהגות שרת חדשה של XSL Transformation.
בתיבת הדו־שיח XSL Transformation, לחצו על הלחצן Plus
(+) ליד XSLT Parameters.
בתיבת הדו־שיח Add Parameters, הזינו שם עבור
הפרמטר בתיבה Name.השם יכול להכיל רק תווים
אלפאנומריים.הוא אינו יכול לכלול רווחים.
בצע אחת מהפעולות הבאות:
אם ברצונכם להשתמש בערך סטטי, הזינו אותו בתיבה Value.
אם ברצונכם להשתמש בערך דינמי, לחצו על הסמל הדינמי ליד התיבה Value, השלימו את תיבת הדו־שיח Dynamic Data, ולחצו על OK.למידע נוסף, לחצו על לחצן Help בתיבת הדו־שיח Dynamic Data.
בתיבת Default Value, הזינו את הערך שתרצו שהפרמטר ישתמש בו אם הדף לא יקבל ערך זמן־ריצה, ולחצו על OK.
עריכת פרמטר XSLT
פתח את תיבת הדו-שיח XSL Transformation.
תוכלו לעשות זאת על ידי לחיצה כפולה על התנהגות השרת XSL Transformation
בלוח Server Behaviors (Window > Server
Behaviors), או על ידי הוספת התנהגות שרת חדשה של XSL Transformation.
בחר פרמטר מרשימת הפרמטרים XSLT.
לחץ על הלחצן Edit.
בצע את השינויים הרצויים ולחץ על OK.
מחיקת פרמטר XSLT
פתח את תיבת הדו-שיח XSL Transformation.
תוכלו לעשות זאת על ידי לחיצה כפולה על התנהגות השרת XSL Transformation
בלוח Server Behaviors (Window > Server
Behaviors), או על ידי הוספת התנהגות שרת חדשה של XSL Transformation.
בחר פרמטר מרשימת הפרמטרים XSLT.
לחץ על הלחצן מינוס (-).
צרו ועדכנו אזורי XSLT מותנים
תוכלו ליצור אזורים מותנים פשוטים או אזורים מותנים מרובים בדף XSLT.תוכלו לבחור אלמנט ב־Design view ולהחיל אזור מותנה על הבחירה, או תוכלו להכניס אזור מותנה במקום שבו נמצאת נקודת ההכנסה במסמך.
לדוגמה, אם תרצו להציג את המילה "לא זמין" ליד המחיר של פריט כאשר הפריט לא זמין, הקלידו את הטקסט "לא זמין" בדף, בחרו אותו, ואז החילו אזור מותנה על הטקסט שנבחר.Dreamweaver מקיף את הבחירה בתגיות <xsl:if>, ומציג רק את המילה "לא זמין" בעמוד כאשר הנתונים תואמים את תנאי הביטוי התנאי.
החלת אזור XSLT מותנה
תוכלו לכתוב ביטוי תנאי פשוט להוספה לעמוד XSLT שלכם.אם תוכן נבחר כשאתם פותחים את תיבת הדו-שיח אזור תנאי, התוכן יעטף בבלוק <xsl:if>.אם תוכן לא נבחר, בלוק <xsl:if> מתווסף בנקודת ההוספה בעמוד.כדאי להשתמש בתיבת הדו-שיח כדי להתחיל ולהתאים אישית את הביטוי בתצוגת קוד.
אלמנט <xsl:if> דומה לפקודת if בשפות אחרות.האלמנט מספק דרך לבדוק תנאי ולנקוט פעולה בהתבסס על התוצאה.אלמנט <xsl:if> מאפשר לכם לבדוק ביטוי עבור ערך נכון או שקר יחיד.
בחרו הוספה > אובייקטים של XSLT > אזור תנאי או לחצו על סמל האזור התנאי בקטגוריית XLST של לוח ההוספה.
בתיבת הדו-שיח אזור תנאי, הזינו את הביטוי התנאי לשימוש באזור.
בדוגמה הבאה, אתם רוצים לבדוק אם ערך התכונה @available של צומת ההקשר הוא true.
לחץ על OK.
הקוד הבא נוסף לדף XSLT:
<xsl:if test="@available='true'">
התוכן נמצא כאן
</xsl:if>
יש להקיף ערכי מחרוזת כגון true במרכאות. Dreamweaver מקודד את המרכאות עבורכם (') כדי שהן יוזנו כ-XHTML חוקי.
בנוסף לבדיקת צמתים עבור ערכים, תוכלו להשתמש בכל אחת מפונקציות XSLT הנתמכות בכל הצהרה תנאית.התנאי נבדק בצומת הנוכחי בתוך קובץ XML. בדוגמה הבאה, אתם רוצים לבדוק עבור הצומת האחרון בסט התוצאות:
למידע נוסף ודוגמאות על כתיבת ביטויים תנאיים, ראו את החלק <xsl:if> בלוח העזרה (עזרה > עזרה).
החלת מספר אזורי XSLT מותנים
תוכלו לכתוב ביטוי תנאי פשוט להוספה לעמוד XSLT שלכם.אם תוכן נבחר כשאתם פותחים את תיבת הדו-שיח אזור תנאי, התוכן נעטף בבלוק <xsl:choose>.אם אתם לא בוחרים תוכן, בלוק <xsl:choose> מתווסף בנקודת ההוספה בעמוד.כדאי להשתמש בתיבת הדו-שיח כדי להתחיל ולהתאים אישית את הביטוי בתצוגת קוד.
אלמנט <xsl:choose> דומה להצהרת case בשפות אחרות.האלמנט מספק דרך לבדוק תנאי ולנקוט פעולה בהתבסס על התוצאה.הרכיב <xsl:choose> מאפשר לכם לבדוק מספר תנאים.
בחרו Insert > XSLT Objects >
Multiple Conditional Region או לחצו על הסמל Multiple Conditional Region
בקטגוריית XLST של לוח Insert.
בתיבת הדו-שיח Multiple Conditional Region, הזינו
את התנאי הראשון.
בדוגמה הבאה, אתם רוצים לבדוק אם תת-הרכיב price של צומת ההקשר קטן מ-5.
לחץ על OK.
בדוגמה, הקוד הבא מוכנס לדף ה-XSLT שלכם:
<xsl:choose>
<xsl:when test="price<5">
התוכן מופיע כאן
</xsl:when>
<xsl:otherwise>
התוכן יימצא כאן
</xsl:otherwise>
</xsl:choose>
כדי להוסיף תנאי נוסף, מקמו את נקודת ההכנסה
בתצוגת Code בין זוגות התגים <xsl:when>
או ממש לפני התג <xsl:otherwise>, ולאחר מכן
הכניסו אזור מותנה (Insert > XSLT Objects >
Conditional Region).
לאחר שתציינו את התנאי ותלחצו על OK, תג <xsl:when> נוסף יוכנס בבלוק <xsl:choose>.
למידע נוסף ודוגמאות על כתיבת ביטויים מותנים, עיינו בחלקים <xsl:choose> בלוח Reference (Help > Reference).
הגדרת מאפייני אזור מותנה (If)
המטרה של Property inspector של Set Conditional Region היא לשנות את התנאי שבשימוש באזור מותנה בדף ה-XSL שלכם. האזור המותנה בודק את התנאי ונוקט דרך פעולה בהתבסס על התוצאה.
בתיבת Test, הזינו תנאי חדש, ולאחר מכן
לחצו על Enter.
הגדרת מאפייני תנאי (When)
המטרה של Property inspector של Set Conditional Region היא לשנות את התנאי שבשימוש באזור מותנה מרובה בדף ה-XSL שלכם. האזור המותנה המרובה בודק את התנאי ונוקט דרך פעולה בהתבסס על התוצאה.
בתיבת Test, הזינו תנאי חדש, ולאחר מכן
לחצו על Enter.
הוספת הערות XSL
אתם יכולים להוסיף תגי הערה XSL למסמך, או שאתם יכולים לעטוף בחירה בתגי הערה XSL.
הוספת תגי הערת XSL למסמך
בצע אחת מהפעולות הבאות:
בתצוגת Design, בחרו Insert > XSLT Objects > XSL Comment, הקלידו את תוכן ההערה (או השאירו את התיבה ריקה), ולחצו על OK.
בתצוגת Code, בחרו Insert > XSLT Objects > XSL Comment.
פתק
אתם יכולים גם ללחוץ על סמל הערת XSL בקטגוריית XSLT בלוח ההוספה.
עטפו בחירה בתגי הערת XSL
עברו לתצוגת קוד (View >
Code).
בחר בקוד שברצונך להוסיף לו הערה.
בסרגל הכלים לקידוד, לחצו על לחצן Apply Comment
ובחרו 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 או ב-Property inspector.
צרו ביטוי XPath לזיהוי צומת ספציפי
לחצו פעמיים על מציין המקום של נתוני XML
בעמוד כדי לפתוח את בונה הביטויים של XPath.
בתיבת הדו-שיח של בונה הביטויים של XPath (Dynamic Text),
בחרו כל צומת בעץ סכמת ה-XML.
ביטוי XPath הנכון נכתב בתיבת הביטוי כדי לזהות את הצומת.
פתק
אם תבחרו צומת אחר בעץ סכמת ה-XML, הביטוי ישתנה כדי לשקף את הבחירה שלכם.
בדוגמה הבאה, אתם רוצים להציג את תת-האלמנט price של הצומת item:
בחירה זו תכניס את הקוד הבא לעמוד ה-XSLT שלכם:
<xsl:value-of select="price"/>
(אופציונלי) בחרו אפשרות עיצוב מתפריט Format
הקופץ.
עיצוב של בחירה שימושי כשהערך של הצומת שלכם מחזיר מספר. Dreamweaver מספק רשימה מוגדרת מראש של פונקציות עיצוב. לרשימה מלאה של פונקציות עיצוב זמינות ודוגמאות, ראו בלוח ההפניה.
בדוגמה הבאה, אתם רוצים לעצב את תת-האלמנט price כמטבע עם שני מקומות עשרוניים:
אפשרויות אלו יכניסו את הקוד הבא לעמוד ה-XSLT שלכם:<xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>
לחץ על OK.
כדי להציג את הערך של כל צומת בקובץ ה-XML, החילו
אזור חוזר על האלמנט המכיל את הטקסט הדינמי (לדוגמה,
שורת טבלה HTML או פיסקה).
למידע נוסף ולדוגמאות על בחירת צמתים להחזרת ערך, ראו את הקטע <xsl:value-of/> בלוח Reference.
בחירת צומת לחזרה
אתם יכולים לבחור צומת לחזרה עליו ו, באופן אופציונלי, לסנן את התוצאות. בתיבת הדיאלוג XPath Expression Builder התוכן שנבחר יעטף בתוך בלוק <xsl:for-each>. אם לא בחרתם תוכן, בלוק <xsl:for-each> יוזן במיקום הסמן שלכם.
לחצו פעמיים על ממלא המקום של נתוני ה-XML בעמוד
כדי לפתוח את ה-XPath Expression Builder.
בתיבת הדיאלוג XPath Expression Builder (Repeating Region),
בחרו את הפריט שיחזור בעץ הסכמה של ה-XML.
הביטוי הנכון של XPath נכתב בתיבת Expression כדי לזהות את הצומת.
פתק
פריטים חוזרים מזוהים בסמל פלוס (+) בעץ הסכמה של ה-XML.
בדוגמה הבאה, אתם רוצים לחזור על כל צומת item בתוך קובץ ה-XML.
כשאתם לוחצים על OK, הקוד הבא מוכנס לעמוד ה-XSLT שלכם:
<xsl:for-each select="provider/store/items/item">
התוכן מופיע כאן
</xsl:for-each>
במקרים מסוימים, אולי תרצו לעבוד עם תת-קבוצה של הצמתים החוזרים – לדוגמה, אולי תרצו רק פריטים שבהם לתכונה יש ערך ספציפי.במקרה זה, אתם צריכים ליצור מסנן.
סינון נתונים חוזרים
השתמשו במסנן כדי לזהות צמתים חוזרים שיש להם ערכי תכונה ספציפיים.
בעץ של סכימת XML, בחר צומת לחזרה.
לחץ על לחצן ההרחבה של Build Filter.
לחץ על הלחצן פלוס (+) ליצירת מסנן ריק.
הזן את הקריטריונים של המסנן בשדות הבאים:
Filter By
מציין את הצומת החוזר המכיל את הנתונים שאתם רוצים לסנן לפיהם. התפריט הקופץ מספק רשימה של צמתי-אב יחסית לצומת שבחרתם בעץ הסכמה של ה-XML.
Where
מציין את התכונה או תת-האלמנט של הצומת Filter By שישמש להגבלת התוצאות. אתם יכולים לבחור תכונה או תת-אלמנט מהתפריט הקופץ, או שאתם יכולים להזין ביטוי XPath משלכם בשדה זה כדי לזהות צאצאים הקיימים עמוק יותר בתוך עץ הסכמה.
Operator
מציין את אופרטור ההשוואה שיש להשתמש בו בביטוי המסנן.
Value
מציין את הערך שיש לבדוק בצומת Filter By. הזן את הערך. אם פרמטרים דינמיים מוגדרים לעמוד ה-XSLT שלכם, אתם יכולים לבחור אחד מהתפריט הנפתח.
כדי לציין מסנן נוסף, לחצו על הלחצן פלוס (+)
שוב.
כאשר מזינים ערכים או מבצעים בחירות בתפריטים הקופצים, הביטוי XPath בתיבת הביטוי משתנה.
בדוגמה הבאה, ברצונכם להגביל את קבוצת התוצאות לצמתי item אלה שבהם הערך של המאפיין @available הוא true.
כאשר לוחצים על OK, הקוד הבא מוכנס בדף XSLT שלכם:<xsl:for-each select="provider/store/items/item[@available = 'true']"> התוכן נכנס כאן </xsl:for-each>
יש להקיף ערכי מחרוזת כגון true במרכאות. Dreamweaver מקודד עבורכם את המרכאות (') כך שהן מוזנות כ-XHTML תקין.
תוכלו ליצור מסננים מורכבים יותר המאפשרים לכם לציין צמתי הורה כחלק מקריטריוני המסנן שלכם. בדוגמה הבאה, ברצונכם להגביל את קבוצת התוצאות לצמתי item אלה שבהם המאפיין @id של store שווה ל-1 והצומת price של item גדול מ-5.
כאשר לוחצים על OK, הקוד הבא מוכנס בדף XSLT שלכם:<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]"> התוכן מופיע כאן </xsl:for-each>
למידע נוסף ולדוגמאות של אזורים חוזרים, ראו את הקטע <xsl:for-each> בלוח הייחוס.
בניית אתרי אינטרנט יפהפיים ב-Dreamweaver
עיצוב כתיבת קוד וניהול אתרי אינטרנט דינמיים בכלי רב עוצמה כולל.
