ویجتهای وب Kendo UI کدامند؟
ویجتهای وب Kendo UI مجموعهای از کنترلهای سفارشی HTML 5 هستند که برفراز jQuery تهیه شدهاند. این کنترلها برای برنامههای وب و همچنین برنامههای دسکتاپ لمسی طراحی شدهاند.
بهترین روش برای مشاهدهی این مجموعه، مراجعه به فایل examples\index.html پوشهی اصلی Kendo UI است که لیست کاملی از این ویجتها را به همراه مثالهای مرتبط ارائه میدهد. تعدادی از اعضای این مجموعه شامل کنترلهای ذیل هستند:
Window, TreeView, Tooltip, ToolBar, TimePicker, TabStrip, Splitter, Sortable, Slider, Gantt, Scheduler, ProgressBar, PanelBar, NumericTextBox, Notification, MultiSelect, Menu, MaskedTextBox, ListView, PivotGrid, Grid, Editor, DropDownList, DateTimePicker, DatePicker, ComboBox, ColorPicker, Calendar, Button, AutoComplete
نحوهی استفاده کلی از ویجتهای وب Kendo UI
با توجه به اینکه کنترلهای Kendo UI مبتنی بر jQuery هستند، نحوهی استفاده از آنها، مشابه سایر افزونههای جیکوئری است. ابتدا المانی به صفحه اضافه میشود:
<input id="pickDate" type="text"/>
سپس این المان را در رویداد document ready، به یکی از کنترلهای Kendo UI مزین خواهیم کرد. برای مثال تزئین یک TextBox معمولی با یک Date Picker:
<script type="text/javascript">
$(function() {
$("#pickDate").kendoDatePicker();
});
</script>
روش دیگری به نام declarative initialization نیز برای اعمال ویجتهای وب Kendo UI قابل استفاده است که از ویژگیهای *-data مرتبط با HTML 5 کمک میگیرد. برای نمونه، کدهای جاوا اسکریپتی فوق را میتوان با ویژگی data-role ذیل جایگزین کرد:
<input id="dateOfBirth" type="text" data-role="datepicker" />
اگر در این حالت برنامه را اجرا کنید، تفاوتی را مشاهده نخواهید کرد.
برای فعال سازی حالت declarative initialization باید به دو نکتهی مهم دقت داشت:
الف)
در مطلب معرفی Kendo UI اسکریپتهای ذیل برای آماده سازی Kendo Ui معرفی شدند:
<!--KendoUI: Web-->
<link href="styles/kendo.common.min.css" rel="stylesheet" type="text/css" />
<link href="styles/kendo.default.min.css" rel="stylesheet" type="text/css" />
<script src="js/jquery.min.js" type="text/javascript"></script>
<script src="js/kendo.web.min.js" type="text/javascript"></script>
<!--KendoUI: DataViz-->
<link href="styles/kendo.dataviz.min.css" rel="stylesheet" type="text/css" />
<script src="js/kendo.dataviz.min.js" type="text/javascript"></script>
<!--KendoUI: Mobile-->
<link href="styles/kendo.mobile.all.min.css" rel="stylesheet" type="text/css" />
<script src="js/kendo.mobile.min.js" type="text/javascript"></script>
باید دقت داشت که در آن واحد نمیتوان تمام این بستهها را با هم بکار برد؛ چون برای مثال فایلهای جداگانه ویجتهای وب و موبایل با هم
تداخل ایجاد میکنند. بجای اینکار بهتر است از فایلهای kendo.all.min.js (که حاوی تمام اسکریپتهای لازم است) و cssهای عنوان شده استفاده کرد:
<link href="styles/kendo.common.min.css" rel="stylesheet" type="text/css" />
<link href="styles/kendo.default.min.css" rel="stylesheet" type="text/css" />
<script src="js/jquery.min.js" type="text/javascript"></script>
<script src="js/kendo.all.min.js" type="text/javascript"></script>
ب) data-roleها توسط متد kendo.init فعال میشوند.
یک مثال کامل:
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title></title>
<link href="styles/kendo.common.min.css" rel="stylesheet" type="text/css" />
<link href="styles/kendo.default.min.css" rel="stylesheet" type="text/css" />
<script src="js/jquery.min.js" type="text/javascript"></script>
<script src="js/kendo.all.min.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
$("#pickDate").kendoDatePicker();
});
$(function () {
// initialize any widgets in the #container div
kendo.init($("#container"));
});
</script>
</head>
<body>
<span>
Pick a date: <input id="pickDate" type="text" />
</span>
<div id="container">
<input id="dateOfBirth" type="text" data-role="datepicker" />
<div id="colors"
data-role="colorpalette"
data-columns="4"
data-tile-size="{ width: 34, height: 19 }"></div>
</div>
</body>
</html>
- در این مثال نحوهی پیوست تمام فایلهای لازم Kendo UI را به صورت یکجا ملاحظه میکنید که در ابتدای head صفحه ذکر شدهاند.
- در اینجا pickDate به صورت معمولی فعال شدهاست.
- اما در قسمت kendo.init نام یک ناحیه یا نام یک کنترل را میتوان ذکر کرد. برای مثال در اینجا کل ناحیهی مشخص شده توسط یک div با id مساوی container به صورت یکجا با تمام کنترلهای داخل آن فعال گردیدهاست.
بنابراین برای اعمال declarative initialization، یک ناحیه را توسط kendo.init مشخص کرده و سپس توسط data-roleها، نام ویجت وب مورد نظر را به صورت lower case مشخص میکنیم. همچنین فایلهای اسکریپت مورد استفاده نیز نباید تداخلی داشته باشند.
تنظیمات ویجتهای وب Kendo UI
تاکنون
نمونهی سادهای از بکارگیری ویجتهای وب Kendo UI را بررسی کردیم؛ اما این ویجتها توسط تنظیمات پیش بینی شده برای آنها بسیار قابل تنظیم و تغییر هستند. تنظیمات آنها نیز بستگی به روش استفاده و آغاز آنها دارد. برای مثال اگر این ویجتها را توسط کدهای جاوا اسکریپتی آغاز کردهاید، در همانجا توسط پارامترهای افزونهی جیکوئری میتوان تنظیمات مرتبط را اعمال کرد:
<script type="text/javascript">
$(function () {
$("#pickDate").kendoDatePicker({
format: "yyyy/MM/dd"
});
});
</script>
که در اینجا توسط پارامتر format، نحوهی دریافت تاریخ نهایی مشخص میشود.
در حالت declarative initialization، پارامتر format تبدیل به ویژگی data-format خواهد شد:
<input id="dateOfBirth" type="text"
data-role="datepicker"
data-format="yyyy/MM/dd" />
تنظیمات DataSource ویجتهای وب
بسیاری از ویجتهای وب Kendo UI با دادهها سر و کار دارند مانند Grid، Auto Complete، Combo box و غیره. این کنترلها دادههای خود را از طریق خاصیت DataSource دریافت میکنند. برای نمونه در اینجا یک combo box را در نظر بگیرید. در مثال اول، خاصیت dataSource کنترل ComboBox در همان افزونهی جیکوئری تنظیم شدهاست:
<input id="colorPicker1" />
<script type="text/javascript">
$(document).ready(function () {
$("#colorPicker1").kendoComboBox({
dataSource: ["Blue", "Green", "Red", "Yellow"]
});
});
</script>
و در مثال دوم، نحوهی مقدار دهی ویژگی data-source را در حالت declarative initialization مشاهده میکنید. همانطور که عنوان شد، در این حالت ذکر متد kendo.init بر روی یک ناحیه و یا یک کنترل ویژه، جهت آغاز فعالیت آن ضروری است:
<input id="colorPicker2" data-role="combobox" data-source='["Blue", "Green", "Red", "Yellow"]' />
<script type="text/javascript">
$(document).ready(function () {
kendo.init($("#colorPicker2"));
});
</script>
کار با رویدادهای ویجتهای وب
نحوهی کار با رویدادهای ویجتهای وب نیز بر اساس نحوهی آغاز آنها متفاوت است. در مثالهای ذیل، دو حالت متفاوت تنظیم رویداد change را توسط خواص افزونهی جیکوئری:
<input id="colorPicker3" />
<script type="text/javascript">
function onColorChange(e) {
alert('Color Change!');
}
$(document).ready(function () {
$("#colorPicker3").kendoComboBox({
dataSource: ["Blue", "Green", "Red", "Yellow"],
change: onColorChange
});
});
</script>
و همچنین توسط ویژگی data-change مشاهده میکنید:
<input id="colorPicker4" data-role="combobox"
data-source='["Blue", "Green", "Red", "Yellow"]'
data-change="onColorChange" />
<script type="text/javascript">
function onColorChange(e) {
alert('Color Change!');
}
$(document).ready(function () {
kendo.init($("#colorPicker4"));
});
</script>
در هر دو حالت، انتخاب یک گزینهی جدید combo box، سبب فراخوانی متد callback ایی به نام onColorChange میشود.
تغییر قالب ویجتهای وب
Kendo UI همیشه یک جفت CSS را جهت تعیین قالبهای ویجتهای خود، مورد استفاده قرار میدهد. برای نمونه در مثالهای فوق، kendo.common.min.css حاوی اطلاعات محل قرارگیری و اندازهی ویجتها است. شیوه نامهی دوم همیشه به شکل kendo.[skin].min.css تعریف میشود که دارای اطلاعات رنگ و پس زمینهی ویجتها خواهد بود؛ مانند kendo.black.min.css، kendo.blueopal.min.css و امثال آن که در پوشهی styles قابل مشاهده هستند.
همچنین باید دقت داشت که همیشه common باید پیش از skin ذکر شود؛ زیرا در تعدادی از حالات، شیوه نامهی skin، اطلاعات common را بازنویسی میکند.
علاوه بر skinهای پیش فرض موجود در پوشهی styles، امکان استفاده از یک theme builder آنلاین نیز وجود دارد:
kendo-ui-themebuilder