در
قسمت قبلی
شما را با DataTables آشنا کردم. به طور خلاصه نحوه اعمال کردن
DataTables به یک جدول ساده html را گفتیم که با این کار به صورت پیش
فرض، امکاناتی مثل فیلتر کردن داده ها، صفحه بندی و مرتب سازی آنها و نیز
اعمال شدن استایلهای css به همین جدول html خام اضافه میشود. نکته مهم در
مثال قبلی این بود که دادههای درون این جدول با کدنویسی خام html فراهم
شدند، اما این را در نظر داشته باشید که اکثریت مواقع باید دادهها از یک
بانک اطلاعاتی دریافت شوند و سپس درون جدول قرار بگیرند.
در این قسمت سعی خواهیم کرد تا منبع داده جدول را یک آرایه جاوا اسکریپتی و
سپس کالکشنی از آبجکتهای جاوا اسکریپتی (json
) در نظر بگیریم و نیز برخی
ویژگیهای پیش فرض پلاگین را غیر فعال نمائیم.
فرض کنید میخواهید لیستی از اطلاعات دانشجویان شامل نام (FirstName)، نام
خانوادگی (LastName)، و سن (Age) را نمایش دهید. اطلاعات قرار است در جدول
زیر قرار بگیرند:
<table id="std-grid">
<thead>
<th>نام</th>
<th>نام خانوادگی</th>
<th>سن</th>
</thead>
<tbody>
</tbody>
</table>
مشاهده میکنید که این جدول فقط شامل قسمت header است و در بدنه آن هیچ
سطری قرار نگرفته است. در این مثال اطلاعات از یک آرایه جاوا اسکریپتی باید
خوانده شوند و تبدیل به html شده و در نهایت درون قسمت
<tbody></tbody> آن تزریق شوند. خوشبختانه DataTables برای این
کار امکانات آماده ای را در اختیار قرار میدهد. این کار بدین صورت قابل
انجام است:
<script>
$(document).ready(function() {
$('#std-grid').dataTable({
"aaData": [
["پژمان", "پارسائی", "24"],
["سعید", "الیاسی", "25"],
["محمد رضا", "گلزار", "20"],
["آرش", "ایرانی", "19"],
["مرتضی", "فرمانی", "22"],
["سعید", "حمیدیان", "23"],
["امین", "پارسانیا", "23"],
["محمد امین", "فقیهی", "24"],
["محمد", "خرمی", "25"],
["سینا", "امیریان", "20"],
["آرش", "ایرانی", "19"],
["وحید", "فرزانه", "22"],
["امیر علی", "فرمانی", "23"],
["امین", "حسینی", "23"],
});
});
</script>
شرح کد:
aaData : یک آرایه دو بعدی (که به آن ماتریس یا آرایه ای از آرایهها هم
گفته میشود) است که مقادیر سلول هایی را نشان میدهد که در جدول قرار
خواهند گرفت. تعداد ستونها در این آرایه دو بعدی باید با تعداد ستونهای
جدول html متناظر یکسان باشند.
در مثال بالا از یک ماتریس به عنوان منبع داده استفاده شد. منبع داده
میتواند به فرمت json نیز باشد. البته در این صورت باید ستونهای جدول
html را هم به پلاگین معرفی کنید، بدین صورت:
$(document).ready(function() {
$('#std-grid').dataTable({
"aaData": [
{"FirstName" : "پژمان", "LastName" : "پارسائی", "Age" : "24"},
{ "FirstName": "سعید", "LastName": "الیاسی", "Age": "25" },
{ "FirstName": "محمد رضا", "LastName": "گلزار", "Age": "24" },
{ "FirstName": "آرش", "LastName": "ایرانی", "Age": "24" },
{ "FirstName": "مرتضی", "LastName": "فرمانی", "Age": "24" },
{ "FirstName": "سعید", "LastName": "حمیدیان", "Age": "24" },
{ "FirstName": "امین", "LastName": "پارسانیا", "Age": "24" },
{ "FirstName": "محمد امین", "LastName": "فقیهی", "Age": "24" },
{ "FirstName": "محمد", "LastName": "خرمی", "Age": "24" },
{ "FirstName": "سینا", "LastName": "امیریان", "Age": "24" },
{ "FirstName": "آرش", "LastName": "ایرانی", "Age": "24" },
{ "FirstName": "وحید", "LastName": "فرزانه", "Age": "24" },
{ "FirstName": "امیر علی", "LastName": "فرمانی", "Age": "24" },
{ "FirstName": "امین", "LastName": "حسینی", "Age": "24" },
],
"aoColumns": [
{ "mDataProp": "FirstName" },
{ "mDataProp": "LastName" },
{ "mDataProp": "Age" }
]
});
});
aaData : همان طور که گفته شد در این قسمت دیتاهای درون جدول آورده میشوند و در این مثال آنها به فرمت json نوشته شده اند.
aoColumns : در این قسمت باید اسم ستونهای جدول ذکر شوند.
غیرفعال کردن بعضی از ویژگیهای پیش فرض DataTables
همان طور که گفته شد پلاگین DataTables به صورت پیش فرض ویژگیهای مرتب
سازی (sorting)، صفحه بندی (paging)، فیلتر کردن دادهها (filtering)، و
غیره را به جدول مورد نظرش اعمال میکند. و بدین صورت قابل تغییر است:
$('#std-grid').dataTable({
"bPaginate": false,
"bLengthChange": false,
"bFilter": false,
"bSort": false,
"bInfo": true,
"bAutoWidth": false
});
bPaginate : بیان میکند آیا صفحه بندی سطرهای جدول فعال باشد یا نه.
bLengthChange : در صورتی که قابلیت صفحه بندی فعال باشد ، بیان میکند که کاربر بتواند اندازه صفحه را تغییر دهد یا نه.
bFilter : بیان میکند آیا قابلیت فیلتر کردن دادهها فعال باشد یا نه.
bSort : بیان میکند قابلیت مرتب سازی دادههای جدول فعال باشد یا نه.
bInfo : بیان میکند که قسمت info زیر گرید نشان داده شود یا نه (در این
قسمت اطلاعاتی راجع به تعداد کل رکوردهای بایند شده به جدول و نیز رکوردهای
درون صفحه جاری نشان داده میشود)
bAutoWidth : در صورتی که این گزینه فعال باشد اندازه عرض هر ستون به صوتر خودکار توسط DataTables مقدار دهی خواهد شد.
مقدارهای قابل قبول برای هر کدام از این خصوصیات : true یا false
کدهای مربوط به این مثال را میتوانید از لینک زیر دریافت کنید:
DataTables-DoteNetTips-Tutorial-02.zip