اصلی

صفحات Main به عنوان صفحه اصلی یا داشبورد در یک اپلیکیشن عمل می‌کنند. این صفحات برای جمع‌آوری محتوای کلیدی، ارائه ناوبری و فراهم کردن دسترسی سریع به سایر صفحات طراحی شده‌اند. آنها به عنوان مرکز اصلی اپلیکیشن عمل می‌کنند تا کاربران بتوانند به راحتی اطلاعات مهم را پیدا کرده و به بخش‌های مختلف برنامه منتقل شوند.

---

صفحه (Page)

این بخش رفتار اصلی یک صفحه Main را تعریف می‌کند: نوع، نام، رنگ و کاور را مشخص می‌کند، ناوبری را با مسیرها (Routes)، صفحه بعدی (NextPage) و Timeout کنترل می‌کند، مشخص می‌کند که آیا صفحه آخرین مرحله است یا خیر، گزینه‌های نمایش مثل تمام‌صفحه (Fullscreen)، حالت افقی (Landscape) و امکان گرفتن اسکرین‌شات را مدیریت می‌کند و چیدمان و جهت متن را تعیین می‌کند.

فیلد	نوع	مقدار پیش‌فرض	توضیحات
@Type	PageType	"Main"	نوع صفحه را به عنوان صفحه اصلی مشخص می‌کند
Name	PageName	{name}	نام یا عنوان صفحه
Color	Color	{color}	رنگ پس‌زمینه صفحه
Cover	URL	{cover}	تصویر کاور اختیاری برای صفحه
Routes	Array	[]	لیست اسکریپت‌ها یا اقدامات مرتبط با این صفحه
NextPage	Page	0	شناسه صفحه بعدی برای ناوبری
Timeout	Number	0	مدت زمان به ثانیه قبل از ناوبری خودکار
Finish	Boolean	false	مشخص می‌کند که آیا این صفحه پایان یک توالی است یا خیر
FullScreen	Boolean	false	تعیین می‌کند که صفحه در حالت تمام‌صفحه نمایش داده شود
CanLandScape	Boolean	false	اجازه جهت افقی اگر true
CanScreenShot	Boolean	false	اجازه گرفتن اسکرین‌شات توسط کاربر اگر true
Dir	Direction	{dir}	جهت چیدمان صفحه (ltr یا rtl)
Dir.Text	TextDirection	{dir}	جهت متن محتوای صفحه

نمونه کدنویسی:

{
  "@Type": "Main",

  "Name": "{name}",
  "Color": "{color}",
  "Cover": "{cover}",
  "Routes": [],
  "NextPage": 0,
  "Timeout": 0,
  "Finish": false,
  "FullScreen": false,
  "CanLandScape": false,
  "CanScreenShot": false,
  "Dir": "{dir}",
  "Dir.Text": "{dir}"
}

---

عنوان صفحه (Title)

این بخش تنظیمات نوار عنوان صفحه را مدیریت می‌کند: امکان نمایش یا مخفی کردن، تعیین رنگ پس‌زمینه، تعریف متن عنوان با اندازه، رنگ و سبک، اتصال به صفحه منو و تعیین آیکون‌های بازگشت و منو را فراهم می‌کند.

فیلد	نوع	مقدار پیش‌فرض	توضیحات
Title.Show	Boolean	true	نمایش یا مخفی کردن نوار عنوان
Title.Color	Color	{titleColor}	رنگ پس‌زمینه نوار عنوان
Title.Text	String	{titleText}	متن عنوان نمایش داده شده در بالا
Title.Text.Size	Number	16	اندازه فونت متن عنوان
Title.Text.Color	Color	{titleTextColor}	رنگ متن عنوان
Title.Text.Style	TextStyle	{titleTextStyle}	سبک فونت (bold, italic و غیره)
Title.Menu	PageName	{pageName}	نام صفحه منو برای باز شدن از عنوان
Title.Back.Logo	Logo	{backLogo}	آیکون دکمه بازگشت
Title.Menu.Logo	Logo	{menuLogo}	آیکون دکمه منو

نمونه کدنویسی:

{
  "@Type": "Main",

  "Title.Show": true,
  "Title.Color": "{titleColor}",
  "Title.Text": "{titleText}",
  "Title.Text.Size": 16,
  "Title.Text.Color": "{titleTextColor}",
  "Title.Text.Style": "{titleTextStyle}",
  "Title.Menu": "{pageName}",
  "Title.Back.Logo": "{backLogo}",
  "Title.Menu.Logo": "{menuLogo}"
}

---

مرکز صفحه (Main Center)

این بخش ویژگی Main.Center را تعریف می‌کند: یک فیلد Boolean که مشخص می‌کند آیا محتوای اصلی صفحه در مرکز قرار گیرد یا خیر. مقدار پیش‌فرض false است، به این معنا که محتوا طبق چیدمان استاندارد قرار می‌گیرد مگر اینکه صریحاً به true تغییر داده شود.

فیلد	نوع	مقدار پیش‌فرض	توضیحات
Main.Center	Boolean	false	تعیین می‌کند آیا محتوای اصلی در مرکز صفحه قرار گیرد

نمونه کدنویسی:

{
  "@Type": "Main",

  "Main.Center": false
}

---

ناوبری (Nav)

فیلد AppNav.Show یک Boolean است که مشخص می‌کند آیا نوار ناوبری در اپلیکیشن نمایش داده شود یا نه.

فیلد	نوع	مقدار پیش‌فرض	توضیحات
AppNav.Show	Boolean	false	کنترل نمایش نوار ناوبری

نمونه کدنویسی:

{
  "@Type": "Main",

  "AppNav.Show": false
}

پاورقی (Footer)

این بخش پاورقی صفحه را تعریف می‌کند: صفحه‌ای که درون پاورقی نمایش داده می‌شود، ارتفاع، شعاع گوشه‌ها و فاصله خارجی پاورقی و فاصله خط جداکننده را کنترل می‌کند.

فیلد	نوع	مقدار پیش‌فرض	توضیحات
Footer.View	PageName	{pageName}	صفحه‌ای که داخل پاورقی نمایش داده می‌شود
Footer.Size	Number	100	ارتفاع پاورقی
Footer.Radius	Number	0	شعاع گوشه‌های پاورقی
Footer.Margin	Number	0	فاصله بیرونی پاورقی
Footer.MarginLine	Number	0	فاصله خط جداکننده پاورقی

نمونه کدنویسی:

{
  "@Type": "Main",

  "Footer.View": "{pageName}",
  "Footer.Size": 100,
  "Footer.Radius": 0,
  "Footer.Margin": 0,
  "Footer.MarginLine": 0
}

عناصر (Elements)

این بخش عناصر صفحه را تعریف می‌کند: شامل آرایه‌ای از کامپوننت‌های UI است که داخل صفحه نمایش داده می‌شوند و امکان ساختاردهی و نمایش محتوای تعاملی صفحه را فراهم می‌کند.

فیلد	نوع	مقدار پیش‌فرض	توضیحات
Elements	Array	[]	لیستی از عناصر UI که داخل صفحه نمایش داده می‌شوند

نمونه کدنویسی:

{
  "@Type": "Main",

  "Elements": [

  ]
}

🔗 نسخهٔ بصری

برای مشاهدهٔ نحوهٔ ایجاد این صفحه در اپلیکیشن ساز اپلین (حالت بدون کدنویسی)، به لینک زیر مراجعه کنید:
طراحی صفحهٔ اصلی در اپلین استودیو