שימוש בתחביר תצוגה נוסף
Yii מאפשרת למפתחים להשתמש בתחביר התצוגה המועדף עליהם (לדוגמא Prado, Smarty וכדומה) בכדי לכתוב את קבצי התצוגה של הקונטרולר או הוידג'ט. זה נעשה על ידי כתיבת והתקנת רכיב אפליקציה viewRenderer. מעבד התצוגה (הרנדרר) מיירט את הקריאות של CBaseController::renderFile, מקמפל את קובץ התצוגה עם תחביר תצוגה מותאם אישית, ומציג (מרנדרר) את התוצאה המקומפלת.
» Info|מידע: מומלץ להשתמש בתחביר תצוגה מותאם אישית רק כאשר כותבים קבצי תצוגה שסביר להניח שלא יעשה בהם שימוש חוזר. אחרת, משתמשים אשר משתמשים בקבצי התצוגה יהיו מוכרחים לעבוד עם אותו תחביר תצוגה באפליקציות שלהם.
בחלק הבא, אנו מציגים כיצד להשתמש CPradoViewRenderer, מעבד תצוגה (רנדרר) אשר מאפשר למפתחים להשתמש בתחביר תצוגה הדומה לזה שנמצא ב Prado. עבור מפתחים הרוצים לכתוב את מעבד התצוגה שלהם, ניתן להשתמש ב CPradoViewRenderer כמחלקת עזר.
שימש ב CPradoViewRenderer
בכדי להשתמש ב CPradoViewRenderer, אנו צריכים להגדיר את האפליקציה בצורה הבאה:
כברירת מחדל, CPradoViewRenderer מקמפל את קוד המקור של קבצי התצוגה ושומר את תוצאת הקימפול בקובץ PHP תחת התיקיה הזמנית. רק כאשר קובץ המקור של התצוגה משתנה, קבצי ה PHP השמורים בתיקיה הזמנית יווצרו מחדש. לכן, שימוש ב CPradoViewRenderer כמעט ולא משפיע לרעה על ביצועי המערכת.
» Tip|טיפ: למרות ש CPradoViewRenderer מציג בעיקר תגיות תחביר חדשות עבור קבצי התצוגה בכדי לפשט ולזרז את כתיבתם, ניתן עדיין להשתמש בקוד PHP בתוך קבצי התצוגה כפי שבדרך כלל נעשה.
בחלק הבא, אנו נציג את התגיות החדשות הנתמכות על ידי CPradoViewRenderer.
תגיות PHP קצרות
תגיות PHP קצרות הם קיצורי דרך לכתיבת ביטויים ב PHP בתוך קבצי התצוגה. התגית
מתורגמת ל
בזמן שהתגית
מתורגמת ל
לדוגמא,
מתורגם לקוד ה PHP הבא
תגיות רכיבים
תגיות רכיבים נועדו לשימוש בעיקר בכדי להכניס וידג'ט לקובץ התצוגה. תגית זו משתמשת בתחביר הבא:
כש WidgetClass מייצגת את שם המחלקה של הוידג'ט או הנתיב המקוצר אליה, והערכים ההתחלתיים של מאפייני המחלקה יכולים להיות עטופים במרכאות או ביטויים ב PHP אשר עטופים ב סוגריים מסולסלות. לדוגמא,
יתורגם לקוד ה PHP הבא
» Note|הערה: הערך עבור ה מוגדר כ {false} במקום "false" מאחר והשני מעיד על סטרינג במקום ערך בוליאני.
תגיות מטמון
תגיות מטמון הם קיצור לשימוש במטמון בחלקים. התחביר שלו הוא כמו בדוגמא הבאה,
כש fragmentID צריך להיות המזהה היחודי של המטמון שמזהה יחודית את התוכן הנשמר במטמון, וזוגות המאפיינים אחריו נועדו להגדרת המאפיינים ההתחלתיים של המטמון. לדוגמא,
יתורגם לקוד ה PHP הבא
תגיות קליפ
כמו בתגיות המטמון, תגיות קליפ הינם קיצור דרך לקריאה של CBaseController::beginClip ו CBaseController::endClip בקובץ תצוגה. התחביר שלהם הוא כפי שמוצג בדוגמא הבאה,
כש clipID הוא מזהה יחודי עבור תוכן הקליפ. תגיות הקליפ יתורגמו לקוד ה PHP הבא
תגיות הערות
תגיות הערות נועדו לכתיבת הערות בתצוגה שיש להציג אותם רק למפתחים. תגיות הערות אלו יוסרו כשקובץ התצוגה יוצג למשתמשי הקצה. התחביר עבור תגיות הערות הוא כבדוגמא הבאה,
ערבוב פורמט תבניות
החל מגרסא 1.1.2, ניתן לערבב שימוש של כמה תחבירי תבניות עם תחביר PHP רגיל. בכדי לעשות זאת, המאפיין CViewRenderer::fileExtension של מעבד התבניות המותקן כרגע צריך להיות מוגדר עם ערך השונה מ php.. לדוגמא, אם המאפיין מוגדר לערך tpl., אז כל קובץ תצוגה המסתיים ב tpl. יועבד ויוצג בעזרת מעבד התבניות המותקן, בזמן שכל שאר קבצי התצוגה המסתיימים עם php. יקבלו יחס של קבצי PHP רגילים.
«div class="revision"»$Id: topics.prado.txt 1983 2010-03-31 19:46:37Z qiang.xue $«/div»