راه اندازی جاوا اسکریپت
برای راه اندازی و تنظیمات فریم ورک ویجتنس کافیست فایل جاوا اسکریپت آنرا به صفحه خود اضافه کنید. با این عمل شما میتوانید از توابع و موضوعات آن به صورت پیش فرض استفاده کنید، ولیکن اگر بخواهید تغییراتی در تنظیمات دهید، میتوانید آن تنظیمات را شخصی سازی کنید. در زیر به این تنظیمات اشاره شده است.
فراخوانی
فایل کتابخانه را میتوانید در هر قسمت کد فراخوانی کنید، که بستگی به پیاده سازی کد شما دارد. اما پیشنهاد ما فراخوانی این فایل در هدر بوده تا قبل از هر تابع دیگری مقدارهای اولیه تنظیم و سپس توسط فراخوان های شما تنظیم گردد.
تنظیمات پیش فرض در کلاس WNConfig و متغییر همگانی wnConfig
برای تنظیم جدید متغییر wnConfig کافیست، یک کلاس از نوع IWNConfig را به آن نسبت دهید. که به صورت پیش فرض ما در این فریم ورک کلاس WNConfig را ساخته ایم. خصوصیات مندرج در این کلاس به شرح زیر است.
| نام خصوصیت | نوع | مقدار پیش فرض | شرح |
|---|---|---|---|
| nativeDigit | boolean | false | در برخی از توابع یا موضوعات، برای تبدیل اعداد به زبان محلی، به این خصوصیت مراجعه کرده و در صورتیکه مقدار پیش فرض آن true باشد، عمل تبدیل انجام میشود. |
| calendar | IWNCalendar | براساس تنظیمات صفحه یا مرورگر | برای محاسبه تاریخ و نمایش آن، مقدار پیش فرض بر اساس مروگر یا تنظیمات صفحه در صورتیکه فارسی باشند، تقویم جلالی و اگر نباشد، تقویم میلادی انتخاب میشود. شما میتوانید آنرا به صورت دستی تنظیم کنید. که برای این منظور به قسمت اسکریپت تاریخ مراجعه کنید. |
| hijriAdjustment | number | 0 | اگر از تقویم هجری قمری در برنامه استفاده میکند، به دلیل اختلاف محاسبات در روز قمری، عددی بین -3 تا 3 قرار دهید. |
| cultureInfo | IWNCultureInfo | براساس تنظیمات صفحه یا مرورگر |
برای نمایش رشته ها و اعداد و ... از این خصوصیت استفاده میشود، مقدار پیش فرض بر اساس مروگر یا تنظیمات صفحه در صورتیکه فارسی باشند، fa-IR
و اگر نباشد، en-US انتخاب میشود. شما میتوانید آنرا به صورت دستی تنظیم کنید. که برای این منظور به قسمت اسکریپت تاریخ مراجعه کنید. پس از تنظیم این خصوصیت، توابع مرتبط با کلاس Intl به صورت خودکار مقدار دهی میشوند. |
| locale | Intl.Locale | بر اساس فرهنگ | برای مشاهده به Intl مراجعه شود. |
| dateTimeFormat | Intl.DateTimeFormat | بر اساس فرهنگ | برای مشاهده به Intl مراجعه شود. |
| numberFormat | Intl.NumberFormat | بر اساس فرهنگ | برای مشاهده به Intl مراجعه شود. |
| language | dictionary | بر اساس فرهنگ | برای محلی سازی زبانی، برخی عناوین در این کتابخانه جمع آوری شده که شما نیز میتوانید به آن عبارت مد نظر خود را اضافه کنید بر اساس زبان فرهنگ، متون مرتبط با آن را فراخوانی میکند. |
| authorizationToken | string | اگر میخواهید از دستورات دریافت و ارسال اطلاعات برای api خود استفاده کنید، و نیاز است در هدر آن توکن امنیتی ارسال شود. مقدار آن توکن را در این متغییر قرار دهید. این مقدار در هر ارسال به سمت سرور قرار داده میشود. | |
| baseFetchUri | string | اگر میخواهید از دستورات ارسال اطلاعات به سرور استفاده کنید، در صورتیکه سرور api آدرس آن متفاوت است، آدرس آن سرور را میتوانید در این خصوصیت مشخص نمایید. |
<script>
wnConfig.calendar = new WNPersianCalendar();
wnConfig.cultureInfo = new WNCultureInfo_fa_IR();
wnConfig.baseFetchUri = 'http://YourServerAddress';
wnConfig.authorizationToken = WNGetCookie('MyCookie');
</script>
دیکشنری زبان
برای تنظیم زبان موضوعات مورد استفاده در این فریم ورک یک کتابخانه از نوع دیکشنری به نام WNLanguage ساخته شده است. شما نیز میتوانید این کتابخانه را به صورت دستی مقدار دهی و یا استفاده کنید.
توجه داشته باشید، برای مقدار دهی بایستی بعد از مقدار دهی اولیه رخ دهد.
<script>
wnConfig.language['MyData'] = { 'Hello': 'سلام' };
alert(wnConfig.language['MyData']['Hello']);
alert(wnConfig.language['common']['close']);
</script>