په نوټ پیډ (Notepad) کې د .JSON فایل جوړولو څرنګوالی

JSON یو ساده متن دی چې سخت قوانین لري. نوټ پیډ په اسانۍ سره دا لیکلی شي. هغه څه چې خلک پکې اشتباه کوي، د ټوټ (وسیله) پر ځای د هغې سینټکس (Syntax) دی. که جوړښت یې سم وي، نو د فایل خوندي کول تر ټولو اسانه برخه ده.

JSON فایل څه شی دی؟

JSON د JavaScript Object Notation لنډیز دی. دا ډیټا د کلي-ارزښت (key-value) جوړو په بڼه د منحني قوسونو { } دننه ذخیره کوي او د نېسټډ (nested) ابجیکټونو او ارې (arrays) ملاتړ کوي. اپلیکیشنونه، API-ګانې او د تنظیماتو فایلونه له دې کار اخلي ځکه چې دا خورا سپک دی او په هره لویه ژبه کې لوستل کېدای شي.

د یو اساسي JSON فایل بڼه داسې ده:

{

  "name": "John",

  "age": 28,

  "isActive": true,

  "skills": ["writing", "editing"]

}

ګام په ګام: په نوټ پیډ کې د JSON فایل جوړول

لومړی ګام: نوټ پیډ پرانیزئ

په خپل کمپیوټر کې نوټ پیډ پرانیزئ، یا له هر براوزر څخه د وړیا آنلاین نوټ پیډ څخه ګټه واخلئ.

دویم ګام: په پرانیستونکي قوس پیل کړئ

هر JSON فایل د یو ابجیکټ لپاره په { او یا د یو ارې (array) لپاره په [ پیلېږي. ډیری فایلونه د ابجیکټ سره پیلېږي.

درېیم ګام: خپل کلي (Keys) او ارزښتونه (Values) اضافه کړئ

هر کلي په دوه ګونو اقتباسونو (double quotes) کې ولیکئ، ورپسې یو کولون (:) او بیا ارزښت ورکړئ. هر جوړه د کامې (comma) په واسطه جلا کړئ.

{

  "title": "Sample File",

  "version": 1

}

څلورم ګام: فایل په سمه توګه وتړئ

د هر پرانیستونکي قوس لپاره یو تړونکی قوس ولیکئ. په ابجیکټ یا ارې کې وروستۍ کلي-ارزښت جوړه کامه نه اخلي.

پنځم ګام: د .json توسیع سره یې خوندي کړئ

File مینو ته لاړ شئ او Save As کلیک کړئ. د "Save as type" ډراپ‌ډاون کې All Files انتخاب کړئ. فایل ته د .json توسیع په ورکولو سره نوم ورکړئ، د مثال په توګه data.json. که تاسو د دې ډراپ‌ډاون له بدلولو پرته فایل خوندي کړئ، دا به د .txt فایل پاتې شي چې د JSON په توګه نه لوستل کېږي.

شپږم ګام: د کارولو دمخه یې تصدیق کړئ

فایل په یو JSON ایډیټر کې ولیکئ ترڅو ډاډ ترلاسه کړئ چې د کارولو دمخه د اعتبار وړ دی. دلته یو چټک چک کول تاسو د وروستیو ډیبګینګ ستونزو څخه ژغوري.

د JSON د سینټکس یادولو وړ قواعد

• یوازې دوه ګوني اقتباسونه (Double quotes). کلي او د متن ارزښتونه باید دوه ګوني اقتباسونه ولري، نه واحد اقتباسونه.

• د وروستۍ کامې نشتوالی. په ابجیکټ یا ارې کې د وروستي توکي وروسته هیڅ شی نشي راتلای.

• تبصرې (Comments) نشته. معیاري JSON د فایل دننه د // یا /* */ نوټونو ملاتړ نه کوي.

• بولین (Booleans) په کوچنیو تورو کې دي. له true او false کار واخلئ، نه له True یا FALSE څخه.

• شمېرې اقتباسونو ته اړتیا نلري. 28 ولیکئ، نه "28"، پرته لدې چې ارزښت یې د متن په توګه وي.

عامې تېروتنې او د هغوی مخنیوی

ستونزه: د کلي-ارزښت جوړو ترمنځ د کامې نشتوالی. حل: هره جوړه د وروستۍ جوړې پرته باید وروسته کامه ولري.

ستونزه: ناسم قوسونه. حل: خپل { } او [ ] قوسونه وشمېرئ. یو ویلیډېټر (validator) به هغه کرښه په ګوته کړي چې قوسونه پکې ناسم دي.

ستونزه: د متن دننه د اقتباسونو نه ایستل. حل: داخلي اقتباسونه د بیک‌سلیش (backslash) سره وتښتئ، د مثال په توګه "He said \"hello\"".

ستونزه: پرته له اقتباسونو کلي. حل: هر کلي باید په دوه ګونو اقتباسونو کې وي، حتی ساده کلي ګانې لکه id یا name.

پایله

یو JSON فایل یوازې متن دی چې یو سخت فارمیټ تعقیبوي. خپل کلي او ارزښتونه په دوه ګونو اقتباسونو کې ولیکئ، خپل قوسونه برابر کړئ، وروستۍ کامه مه کاروئ، او فایل په .json توسیع سره خوندي کړئ. د کارولو دمخه یې یو ځل په ویلیډېټر کې وګورئ، او کار مو بشپړ دی.