תחביר
1. מבנה בסיסי
-
תוכן הקובץ מתחיל ומסתיים כאובייקט (
object) מוקף בסוגריים מסולסלים{}. -
האובייקט מורכב מזוגות של שם תכונה (key) וערך (value).
-
שם התכונה והערך מופרדים באמצעות נקודתיים (
:) או שווה (=).
2. הערה
-
ההערה מתחילה ב-
//או ב-#ונכתבת בשורה אחת. -
ההערה תקפה עד לסוף השורה.
-
לא נתמכת הערה המשתרעת על פני מספר שורות, על מנת להוסיף הערה במספר שורות יש להוסיף
//או#בכל שורה.
3. אובייקט (Object)
-
האובייקט מוקף במעוגלונים
{}ומכיל זוגות מפתח-ערך. -
ניתן להשתמש בסימן
:או=בין המפתח לערך. ניתן להשתמש בערבוביה בשני הסימנים. -
כל תכונה מופרדת באמצעות פסיק(
,). -
ניתן לקנן אובייקטים נוספים בתוך האובייקט.
דוגמה:
{
סטטוס: "הצלחה",
קוד = 200,
משתמש = { מזהה: 123, שם: "ג'ון דו" }
}
4. מערך (Array)
-
המערך מוקף בסוגריים מרובעים
[]והאלמנטים מופרדים בפסיקים (.). -
האלמנטים במערך יכולים להיות אובייקטים, מחרוזות, מספרים ועוד סוגי נתונים שונים.
-
ב-WSON מערך יכול להיכלל בתוך אובייקט, ויכול להיות מקונן עם מערכים או אובייקטים אחרים בתוכו.
דוגמה:
משימות: [
{ מזהה_משימה: 1, כותרת: "השלם דוח פרויקט" },
{ מזהה_משימה: 2, כותרת: "סוקר משוב צוות" }
]
5. זוג מפתח-ערך (Key-Value Pair)
-
שם התכונה מורכב ממחרוזת, ללא רווח ליד הערך המופיע לאחר
:או=. -
סוגי הערכים כוללים מחרוזות, מספרים, בוליאנים, אובייקטים, מערכים וכדומה.
-
המחרוזת מוקפת במרכאות ״"״.
-
המספרים משתמשים ללא מירכאות, ויכולים להיות שלמים או שברים.
דוגמה:
שם: "ג'ון דו"
גיל = 25
6. סוגי נתונים (Data Types)
- מחרוזת (String): טקסט מוקף במירכאות
".
"שלום עולם"
- מספר (Number): ערכים שלמים או עשרוניים.
42
3.14
- בוליאן (Boolean): משתמש בערך
trueאוfalse.
active = true
- אובייקט (Object): זוגות מפתח-ערך מוקפים במעוגלונים
{}. - מערך (Array): רשימת אלמנטים מוקפים בסוגריים מרובעים
[].
7. הסבר על דוגמה
{
// מידע על קוד סטטוס והודעה
סטטוס: "הצלחה",
קוד: 200,
הודעה: "המידע נשאב בהצלחה",
משתמש = {
מזהה = 123,
שם: "ג'ון דו",
מייל: "john@example.com",
גיל: 25 # גיל המשתמש
},
משימות: [
{
מזהה_משימה: 1,
כותרת: "השלם דוח פרויקט",
סטטוס: "בתהליך",
תאריך_להגשה: "2024-10-15"
},
{
מזהה_משימה: 2,
כותרת: "סוקר משוב צוות",
סטטוס: "בהמתנה",
תאריך_להגשה: "2024-10-20"
}
]
}