בחירת שדות ופקדי קלט

בחרו סוג שדה לפי הערך שצריך לשמור. לוח הבקרה בוחר את פקד הקלט לפי הסוג; editor.json אינו בוחר פקד נפרד.

סוגי שדות נתמכים

סוג ב־definition.json	ערך שנשמר	מה בעל האתר משתמש בו
text	מחרוזת	קלט בשורה אחת, או אזור טקסט כאשר maxLength > 350.
richText	מחרוזת HTML שעברה ניקוי	עורך טקסט עשיר עם עיצוב פשוט נתמך.
asset	מזהה נכס כמחרוזת	בוחר נכס יחיד עם אפשרות ניקוי.
link	מחרוזת יעד	קלט טקסט; הפלטפורמה מאמתת יעדים מותרים.
boolean	ערך בוליאני	תיבת סימון.
group	אובייקט של ערכי ילדים	קבוצת שדות בעלת כותרת, המכילה את השדות המקוננים.
list	מערך אובייקטים	אוסף חוזר עם פעולות הוספה, הסרה ושינוי סדר.

בחוזה הזה אין סוגי שדה תוכן בשם textarea, ‏number, ‏select, ‏date או email. למשל, מספר טלפון בפרטי העסק הוא שדה text. לממשק טפסי הפניות יש סוגי שדות נפרדים; אל תעתיקו אותם להגדרת התוכן.

השתמשו במגבלות בכוונה

• label נותן לשדה שם שבעל האתר מבין. העדיפו ״כותרת ראשית״ על פני ״title״.
• required: true מחייב ערך לצורך פרסום; תוכן טיוטה יכול להיות לא גמור.
• maxLength מגביל מחרוזות. בחרו מגבלה קצרה לכותרות וארוכה לפסקאות. שדות text הופכים לאזורי טקסט רק מעל 350.
• שדה list מחייב maxItems בין 1 ל־50. ערך minItems יכול להיות בין 0 ל־maxItems; המינימום נאכף בעת פרסום.
• קבוצה או רשימה מגדירות fields של ילדים. לסוגים פשוטים אין שדות ילדים.

מגבלת אורך אינה יוצרת רשת עמודות, אינה משנה טיפוגרפיה של כותרת ואינה משנה את גודל הדף הציבורי. את העיצוב הציבורי מבצעים ב־Astro וב־CSS.

קישורים וטקסט עשיר

שדה link הוא יעד שנשמר, ולא רכיב כפתור מותאם. היעדים הנתמכים כוללים נתיבים מקומיים בטוחים, עוגנים וקישורי HTTP/HTTPS, ‏mailto או tel; כתובות לא בטוחות ויעדי מערכת או מסחר שמורים נדחים. השתמשו בערך בקוד התצוגה שלכם.

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

ערכים מקוננים ואימות

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

שינוי תווית קלט הוא שינוי בממשק. שינוי id או רמת הקינון משנה את מיקום הנתונים השמורים; תכננו מיגרציות לפני שחרור שינוי כזה.

שפה ותוויות מועילות

תוויות הפרויקט הן מחרוזות פשוטות. כתבו את תוויות ההגדרה והעורך עבור קהל בעלי האתרים; אובייקט כמו { "en": "...", "he": "..." } אינו נתמך. שפת ממשק הפלטפורמה ושפת התוכן השמור נפרדות מתוויות הסכמה האלה.

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