עיצוב רשימות חוזרות וגלריות

השתמשו בשדה list עבור תוכן שבעל האתר יכול להוסיף, להסיר ולסדר: שירותים, אנשי צוות, המלצות או פריטי גלריה. לכל פריט אותה סכמת שדות ילדים. השתמשו ב־group קבוע כאשר צריך אובייקט אחד בלבד, למשל פרטי העסק.

הגדירו תחילה את נתוני האוסף

בהגדרת Studio, השדה services הוא רשימה שבכל פריט שלה יש title, ‏summary, ‏image ו־href. הערך maxItems: 6 מגביל את גודלה, והערך minItems: 1 מחייב לפחות פריט אחד בעת פרסום.

בעל האתר יכול להוסיף פריט, לערוך את שדותיו, להסירו או לשנות את מיקומו. פריטים חדשים מתחילים עם ערכי ילדים ריקים: רשימות מקוננות ריקות, ערכים בוליאניים הם false ושדות פשוטים מכילים מחרוזות ריקות. אל תניחו שפריט חדש משכפל את כרטיס ברירת המחדל הראשון.

תנו לכל פריט תקציר שימושי

הוסיפו את הרשומה הבאה ל־editor.json.collections:

Collection inside editor.json

{
  "path": "services",
  "view": "gallery",
  "labelField": "title",
  "descriptionField": "summary",
  "imageField": "image"
}

הגדרה	כיצד לקרוא אותה
path: "services"	הגדרת הרשימה בנתיב התוכן הזה.
view: "gallery"	הצגת הפריטים בתצוגת אוסף בסגנון גלריה.
labelField: "title"	שימוש בשם השירות כתווית התקציר של הפריט.
descriptionField: "summary"	הצגת התיאור הקצר בתקציר.
imageField: "image"	שימוש בנכס שנבחר בפריט כתמונה ממוזערת.

נתיבי הכותרת, התיאור והתמונה יחסיים לפריט יחיד. השתמשו ב־title, ולא ב־services.title, ‏services.0.title או services.*.title.

בקבוצות מקוננות, נתיב יחסי כמו details.title יכול להצביע על שדה טקסט בתוך הפריט. נתיבי התקציר יכולים לעבור דרך קבוצות, ולא דרך רשימה נוספת. התווית צריכה להפנות ל־text; התיאור ל־text או ל־link; והתמונה ל־asset.

בחירה בין רשימה לגלריה

השתמשו ב־view: "list" לפריטים שמזוהים בעיקר לפי טקסט, כמו קישורי ניווט. השתמשו ב־view: "gallery" כאשר תמונות מסייעות בזיהוי. הבחירה משנה את תצוגת האוסף בלוח הבקרה, ולא את פריסת ה־CSS באתר הציבורי.

אם לא מגדירים אוסף, העורך מסיק תקצירים מהשדות הזמינים ובוחר תצוגה אוטומטית. הגדרה מפורשת מקלה להבין ולתחזק את התוצאה הרצויה.

אוספים מקוננים

הנתיב path של האוסף יכול לעבור דרך קבוצות עד לרשימה, למשל homepage.services. הוא חייב לזהות רשימה בסכמה. נתיב שעובר דרך רשימה חוזרת, כוכבית או אינדקס פריט אינו נתיב תקין להגדרות אוסף.

הציבו את הקבוצה או הרשימה העליונה במקטע באמצעות המזהה שלה ברמה העליונה. אי אפשר להעביר שדה של פריט מקונן למקטע עליון נפרד.

הפכו את העריכה לצפויה

הציבו בתחילת הפריט את השדה שהכי קל לזהות לפיו, בחרו מגבלת פריטים מציאותית ותנו לשדות תמונה תוויות ברורות. בדקו מצב ריק, פריט יחיד ומספר פריטים מרבי. בדקו הוספה, הסרה ושינוי סדר, וודאו שהרכיב הציבורי שומר על הסדר שבחר בעל האתר.

תיבת הסימון showServices והאוסף services הם שדות נפרדים. הציבו אותם יחד במקטע אחד כדי להבהיר את הקשר, ואז מימשו את ההצגה ברכיב Astro. תיבת הסימון והמאפיין minItems אינם מספקים כללי סכמה מותנים.