PDF

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


صفحه (Page)

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

فیلد نوع مقدار پیش‌فرض توضیحات
@Type PageType "PDF" نوع صفحه را به عنوان صفحه PDF مشخص می‌کند
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": "PDF",

  "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": "PDF",

  "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}"
}

منبع PDF (Source)

این بخش منبع PDF را تعریف می‌کند: مسیر URL یا فایل سند PDF که داخل صفحه نمایش داده می‌شود.

فیلد نوع مقدار پیش‌فرض توضیحات
Src URL {pdfUrl} مسیر یا URL فایل PDF برای نمایش

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

{
  "@Type": "PDF",

  "Src": "{pdfUrl}"
}

🔗 نسخهٔ بصری

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