創(chuàng)建自定義包

---

立即下載Kendo UI for jQuery

根據(jù)您的項(xiàng)目，您可能需要跳過一些Kendo UI實(shí)用程序，只安裝應(yīng)用程序所需的工具。

為了方便您的項(xiàng)目自定義，Kendo UI for jQuery提供了一組組合和單獨(dú)的腳本，還提供了腳本自定義的進(jìn)一步選項(xiàng)。

組合的腳本包包含了特定類型的小部件(例如，桌面、混合)的腳本，可用于不同的Kendo UI發(fā)行版。

單獨(dú)的腳本包包含按常用功能(例如，圖表、編輯器)分組的小部件的腳本，以便您可以選擇要添加到項(xiàng)目中的單個(gè)控件。

您還可以通過創(chuàng)建自定義腳本來進(jìn)一步定制您的項(xiàng)目，這些腳本會(huì)添加項(xiàng)目需求的特定小部件和特性。

從2022.3.1109版本開始，您可以使用ECMAScript在應(yīng)用程序中導(dǎo)入單個(gè)模塊。相關(guān)的依賴項(xiàng)將自動(dòng)與它們各自的模塊捆綁在一起。這將為您省去手動(dòng)選擇項(xiàng)目中包含哪些腳本的麻煩。

合并腳本

為了方便常見的項(xiàng)目類型，Kendo UI在捆綁包或CDN上發(fā)布了以下組合腳本：

• kendo.ui.core.min.js包含了Kendo UI Core發(fā)行版支持的所有小部件。相關(guān)的腳本也可以在Kendo UI Core包中找到。
• kendo.all.min.js包含 Kendo UI提供的所有功能的縮小版本。

注意：kendo.all.min.js可以在Kendo UI Professional，Telerik UI for ASP.NET MVC，Telerik UI for ASP.NET Core， Telerik UI for JSP and Telerik UI for PHP bundles中找到。但是，kendo.all.min.js不包括kendo.aspnetmvc.min.js，要安裝它，請(qǐng)將kendo.aspnetmvc.min.js添加到kendo.all.min.js中，或者使用自定義下載構(gòu)建器工具。

• kendo.web.min.js包括核心框架和所有桌面瀏覽器小部件(以前作為Kendo UI Web分發(fā))，它可以在Kendo UI Professional, JSP, PHP, MVC和Core中使用。
• kendo.dataviz.min.js包括核心框架和所有數(shù)據(jù)可視化小部件(以前作為Kendo UI DataViz分發(fā))，它可以在Kendo UI Professional, JSP, PHP, MVC和Core中使用。
• kendo.mobile.min.js包括核心框架和所有移動(dòng)設(shè)備特定的小部件(以前作為Kendo UI mobile分發(fā))。它可以在Kendo UI Professional, JSP, PHP, MVC和Core中使用。

注意：一次只能包含一個(gè)組合的JavaScript文件，因?yàn)樗鼈儼琄endo UI框架。如果要同時(shí)使用來自不同Kendo UI套件的小部件，請(qǐng)使用Kendo .all.min.js或構(gòu)建自定義腳本。

不要將任何組合腳本文件與來自同一套件的單個(gè)小部件腳本注冊(cè)在一起，例如不要將kendo.grid.js與kendo.web.js或kendo.all.js一起注冊(cè)，因?yàn)樗鼈円呀?jīng)包含了Grid腳本。

注意：注冊(cè)重復(fù)的腳本可能會(huì)導(dǎo)致JavaScript錯(cuò)誤和意外行為。

個(gè)人腳本

下面的列表提供了腳本文件的引用，無論是否壓縮，根據(jù)您的項(xiàng)目都可以包含在每個(gè)部件的基礎(chǔ)上。

• Kendo UI小部件的綁定支持列表
• 數(shù)據(jù)管理腳本文件
• 用于編輯的腳本文件
• 圖表腳本文件
• 儀表腳本文件
• 條形碼的腳本文件
• 用于圖表和地圖的腳本文件
• 調(diào)度腳本文件
• 布局腳本文件
• 導(dǎo)航腳本文件
• 交互和用戶體驗(yàn)?zāi)_本文件
• 混合UI的腳本文件
• 用于工具、框架和實(shí)用程序的腳本文件
• 服務(wù)器端包裝器的腳本文件

自定義腳本

您可以創(chuàng)建只提供項(xiàng)目所需的小部件和特性的自定義腳本。

使用下載構(gòu)建器

擁有商業(yè)許可的用戶可以使用定制的下載生成工具創(chuàng)建一個(gè)JavaScript文件，其中只包含所需的小部件和特性。

注意：不要使用多個(gè)自定義組合腳本，因?yàn)樗鼈儗貜?fù)的代碼，相反，創(chuàng)建一個(gè)組合腳本文件，并讓它包含您需要的所有內(nèi)容。

使用RequireJS加載Download Builder包是不可能的，因?yàn)樵摴ぞ卟粫?huì)創(chuàng)建所需的AMD模塊。

使用Gulp

如果您使用Kendo UI Core包，則可以使用gulp構(gòu)建工具并按照README文章中的說明構(gòu)建自定義發(fā)行版。自Kendo UI 2014 Q3發(fā)布以來，必要的構(gòu)建腳本已在可下載的商業(yè)捆綁包的src/目錄中發(fā)布。

若要從附帶的源構(gòu)建自定義分發(fā)，請(qǐng)執(zhí)行以下操作：

• 1.運(yùn)行以下shell命令。

cd src
npm install
npx gulp custom -c autocomplete,dropdow

• 2.列出您希望包含在自定義構(gòu)建中的組件，并用逗號(hào)(，)分隔它們。前面的示例構(gòu)建了一個(gè)自定義的小型腳本，其中包括AutoComplete和DropDownList小部件。
• 3.通過運(yùn)行npx gulp custom -c all構(gòu)建整個(gè)Kendo UI庫。

注意：完成后，gulp命令在src/dist目錄下會(huì)輸出一個(gè)kendo.custom.min.js文件。Gulp構(gòu)建任務(wù)自動(dòng)解析每個(gè)組件所需的依賴項(xiàng)，因此您不必列出它們。不要使用多個(gè)自定義組合腳本，因?yàn)樗鼈儗貜?fù)的代碼。相反，創(chuàng)建一個(gè)組合腳本文件并讓它包含您需要的所有內(nèi)容。

• 4.要編譯一個(gè)不被最小化的自定義腳本版本，請(qǐng)從gulpfile.js中刪除或注釋掉以下行：

...
.pipe(uglify())
...

標(biāo)簽順序

若要在HTML標(biāo)記之后加載和執(zhí)行腳本，請(qǐng)將腳本標(biāo)記放在結(jié)束body標(biāo)記之前。通常，Kendo UI 小部件初始化語句通過jQuery處理程序在document.ready事件中執(zhí)行，這意味著您必須在任何Kendo UI小部件初始化語句之前注冊(cè)jQuery，當(dāng)使用客戶端Kendo UI小部件時(shí)，您可以控制初始化語句的位置，以便可以在文檔的底部注冊(cè)jQuery腳本文件。

Kendo UI小部件的服務(wù)器端包裝器是自初始化的，這意味著每個(gè)初始化腳本都是在小部件的HTML標(biāo)記之后立即呈現(xiàn)的，在這種情況下，Kendo UI腳本仍然可以在文檔的末尾注冊(cè)，而jQuery腳本必須在文檔上的第一個(gè)Kendo UI小部件之前或在文檔  head.注冊(cè)。