کلاس اپسان

کلاس Appsan

کلاس Appsan برای مدیریت عناصر و رفتارهای برنامه طراحی شده است. در این قسمت به توضیح توابع مختلف این کلاس و مثال‌هایی برای هر کدام پرداخته می‌شود.

1. setProperty

این تابع مقدار یک پراپرتی از یک المان خاص را تغییر می‌دهد.

ورودی‌ها:

• elementId: string - شناسه المان مورد نظر
• propertyName: string - نام پراپرتی
• propertyValue: string - مقدار جدید پراپرتی

نوع بازگشتی: void

مثال:

appsan.setProperty('element1', 'color', 'red');

این کد رنگ المان با شناسه element1 را به قرمز تغییر می‌دهد.

2. setVariable

این تابع مقدار یک متغیر را تغییر می‌دهد. و در صورت عدم وجود آن را می سازد.

ورودی‌ها:

• variableId: string - شناسه متغیر مورد نظر
• variableValue: string - مقدار جدید متغیر

نوع بازگشتی: void

مثال:

appsan.setVariable('var1', 'newValue');

این کد مقدار متغیر با شناسه var1 را به newValue تغییر می‌دهد.

3. runUpdate

این تابع یک آپدیت اپسان ورودی را اجرا می کند. برای اطلاعات بیشتر به بخش آپدیت مراجعه کنید.

ورودی‌ها:

• updateJson: string - اطلاعات به‌روزرسانی به صورت JSON

نوع بازگشتی: void

مثال:

const updateInfo = JSON.stringify({ elementId: 'element1', property: 'visible', value: true });
appsan.runUpdate(updateInfo);

این کد به‌روزرسانی‌ای را اجرا می‌کند که المان با شناسه element1 را قابل مشاهده می‌کند.

4. runAction

این تابع یک اکشن را اجرا می‌کند. برای اطلاعات بیشتر بخش اکشن ها را مطالع کنید.

ورودی‌ها:

• actions: string - نام اکشن مورد نظر

نوع بازگشتی: void

مثال:

appsan.runAction('app/end');

این کد اکشن app/end را اجرا می‌کند.

5. findElementById

این تابع یک المان را با استفاده از شناسه آن پیدا می‌کند.

ورودی‌ها:

• id: string - شناسه المان مورد نظر

نوع بازگشتی: { id, value }

مثال:

const element = appsan.findElementById('element1');
console.log(element);

این کد المان با شناسه element1 را پیدا کرده و اطلاعات آن را در کنسول چاپ می‌کند.