دوست من این نمونه رو ببینید ... jquery
-----------------------------------------------------
روش استفاده:
بعد از اضافه کردن ارجاع به فایل dll کتابخانه، کنترلها را در صفحه رجیستر کنید. برای این کار کافیست بعد از تگ Page@ (اول صفحه) کد زیر را اضافه کنید:
PHP:
<%@ Page ... %>
<%@ Register Assembly="JQControls" Namespace="JQControls" TagPrefix="jq" %>
در صورتی که میخواهید این کنترلها را در تمامی صفحات استفاده کنید، میتوانید بجای اضافه کردن آن در هر صفحه، در فایل Web.Config عبارت زیر را (در قسمت system.web) اضافه کنید:
PHP:
<pages>
<controls>
<add assembly="JQControls" namespace="JQControls" tagPrefix="jq" />
</controls>
</pages>
برای استفاده از این کنترل، ابتدا در شروع صفحه (قبل از سایر کنترلهای این کتابخانه) یک نمونه از کنترل JQLoader را قرار دهید. با استفاده از ویژگی Theme در این کنترل میتوانید تم مورد نظر خود را انتخاب کنید. دقت کنید که برای تمامی کنترلهای موجود در این کتابخانه، تنها یک نمونه از کنترل JQLoader کافیست.
سپس کنترل JQDatePicker را به صفحه اضافه کنید. به طور پیشفرض این کنترل تقویم میلادی و زبان انگلیسی را استفاده میکند. در صورتی که میخواهید از تقویم شمسی استفاده کنید، کافیست ویژگی Regional آن را برابر با fa قرار دهید.
PHP:
<jq:JQLoader ID="JQLoader1" Theme="DarkHive" runat="server"></jq:JQLoader>
<jq:JQDatePicker ID="JQDatePicker1" Regional="fa" runat="server"></jq:JQDatePicker>
پس از آن با استفاده از ویژگی Date این کنترل، میتوانید تاریخ انتخاب شده را استفاده کنید. نکته قابل توجه اینست که این تاریخ، معادل تاریخ میلادی انتخاب شده (بدون توجه به قالب تاریخ و تقویم استفاده شده) است. در صورتی که تمایل داشتید که دقیقا عبارت نوشته شده در کنترل را دریافت کنید، میتوانید از ویژگی Text استفاده کنید.
PHP:
DateTime selectedDate = JQDatePicker1.Date;
اضافه کردن کنترلها به Toolbox:
برای استفاده آسان از این کنترلها میتوانید آنها را به نوار ابزار (Toolbox) اضافه کنید تا همانند سایر کنترلهای ASP.NET آنها را تنها با کشیدن بر روی فرم استفاده کنید.
برای این کار بر روی Toolbox کلیک سمت راست کنید و گزینه Choose Items را انتخاب کنید (باز شدن صفحه بعدی ممکن است کمی طولانی شود). سپس بر روی دکمه Browse کلیک کرده و فایل dll کتابخانه را انتخاب کنید و بعد از در حالی که کنترلهای موجود در کتابخانه انتخاب شدهاند، دکمه OK را فشار دهید تا این کنترلها به Toolbox اضافه شوند.
ویژگیهای پرکاربرد JQDatePicker:
Date
تاریخ انتخاب شده در تقویم (به صورت میلادی)
Regional
انتخاب زبان و نوع تقویم که شامل مقادیر en برای زبان انگلیسی (و تقویم میلادی) و fa برای زبان فارسی (و تقویم میلادی) است.
DateFormat
انتخاب قالب نمایش تاریخ که شامل مقادیر YMD، DMY و MDY است. در این عبارات D نشان روز، M نشان ماه و Y نشان سال است. از آنجا که در حالت RTL در مرورگر IE، نمایش تاریخ بر خلاف جهت سایر مرورگرها است، میتوانید با استفاده از ویژگی IEDateFormat قالب تاریخ مخصوص این مرورگر را به صورت مجزا انتخاب کنید.
ShowButtonPanel
نمایش دکمههای "امروز" و "بستن"
ShowSelectButton
نمایش آیکون تقویم و ظاهر شدن تقویم بعد از کلیک بر روی آن
ButtonImage
انتخاب تصویر دلخواه برای آیکون نمایش تقویم
AnimationType
افکت استفاده شده هنگام ظاهر شدن تقویم که شامل مقادیر Default (پیشفرض)، Fade (محو شدن) و Slide (کشویی) میباشد.
AnimationSpeed
سرعت نمایش افکت ظاهر شدن تقویم که شامل مقادیر Default، Slow، Fast و Disabled (برای غیرفعال کردن افکت) است.
ChangeMonth
قابلیت انتخاب ماه از طریق DropDownList
ChangeYear
قابلیت انتخاب سال از طریق DropDownList
NumberOfMonths
تعداد ماههای نمایش داده شده در تقویم به صورت همزمان که به طور پیشفرض مقدار آن 1 ماه است.
ShowInline
نمایش تقویم به صورت Inline. در این حالت TextBox انتخاب تقویم نمایش داده نخواهد شد و تقویم به صورت ثابت در صفحه باقی خواهد ماند.
MinDate
محدود کردن حداقل تاریخ قابل انتخاب در تقویم
MaxDate
محدود کردن حداکثر تاریخ قابل انتخاب در تقویم
استفاده از تمهای jQuery UI:
کتابخانه ارایه شده در اینجا حاوی 24 تم پیش ساخته است که به طور پیشفرض JQLoader یکی از آنها را در صفحات اضافه میکند. شما میتوانید برای هماهنگی بیشتر بین کنترلهای این کتابخانه با سایر قسمتهای صفحات خود و همچنین قالب دهی سریع و آسان به صفحات خود، از همین تمها در صفحات خود نیز استفاده کنید. در این صورت میتوانید از
راهنمای تمهای jQuery UI برای آشنایی با نحوه استفاده از تمها استفاده کنید. در مثال ضمیمه شده از این تمها در سایر عناصر صفحه استفاده شده که برای نمونه میتوانید به این مثال نیز مراجعه کنید.
ضمایم:
در پایان سه فایل فشرده شده ضمیمه کردهام. فایل اول نمونه ای از امکانات مختلف این کنترل به همراه نمونه استفاده از تمهای این کتابخانه است که در قالب یک پروژه نمونه آماده شدهاست. در این مثال نحوه استفاده از اسکریپتهای jQuery که به طور پیشفرض به صفحه اضافه میشوند نیز نشان داده شده است.
فایل دوم حاوی dll اصلی این کتابخانه است و در نهایت فایل سوم سورس کتابخانه است که استفاده از آن تحت مجوز CPL مجاز است.
مشاهده پیوست JQControlsSample.zip
مشاهده پیوست JQControls.dll_.zip
مشاهده پیوست JQControls-1.0.1.0-src.zip
با تشکر از دوست خوبم آقای هشمی نژاد.
اصل مطلب