創建自定義包
根據您的項目,您可能需要跳過一些Kendo UI實用程序,只安裝應用程序所需的工具。
為了方便您的項目自定義,Kendo UI for jQuery提供了一組組合和單獨的腳本,還提供了腳本自定義的進一步選項。
組合的腳本包包含了特定類型的小部件(例如,桌面、混合)的腳本,可用于不同的Kendo UI發行版。
單獨的腳本包包含按常用功能(例如,圖表、編輯器)分組的小部件的腳本,以便您可以選擇要添加到項目中的單個控件。
您還可以通過創建自定義腳本來進一步定制您的項目,這些腳本會添加項目需求的特定小部件和特性。
從2022.3.1109版本開始,您可以使用在應用程序中導入單個模塊。相關的依賴項將自動與它們各自的模塊捆綁在一起。這將為您省去手動選擇項目中包含哪些腳本的麻煩。
合并腳本
為了方便常見的項目類型,Kendo UI在捆綁包或CDN上發布了以下組合腳本:
- kendo.ui.core.min.js包含了支持的所有小部件。相關的腳本也可以在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,要安裝它,請將kendo.aspnetmvc.min.js添加到kendo.all.min.js中,或者使用自。
- kendo.web.min.js包括核心框架和所有桌面瀏覽器小部件(以前作為Kendo UI Web分發),它可以在Kendo UI Professional, JSP, PHP, MVC和Core中使用。
- kendo.dataviz.min.js包括核心框架和所有數據可視化小部件(以前作為Kendo UI DataViz分發),它可以在Kendo UI Professional, JSP, PHP, MVC和Core中使用。
- kendo.mobile.min.js包括核心框架和所有移動設備特定的小部件(以前作為Kendo UI mobile分發)。它可以在Kendo UI Professional, JSP, PHP, MVC和Core中使用。
注意:一次只能包含一個組合的JavaScript文件,因為它們包含Kendo UI框架。如果要同時使用來自不同Kendo UI套件的小部件,請使用Kendo .all.min.js或構建自定義腳本。
不要將任何組合腳本文件與來自同一套件的單個小部件腳本注冊在一起,例如不要將kendo.grid.js與kendo.web.js或kendo.all.js一起注冊,因為它們已經包含了Grid腳本。
注意:注冊重復的腳本可能會導致JavaScript錯誤和意外行為。
個人腳本
下面的列表提供了腳本文件的引用,無論是否壓縮,根據您的項目都可以包含在每個部件的基礎上。
自定義腳本
您可以創建只提供項目所需的小部件和特性的自定義腳本。
使用下載構建器
擁有商業許可的用戶可以使用創建一個JavaScript文件,其中只包含所需的小部件和特性。
注意:不要使用多個自定義組合腳本,因為它們將包含重復的代碼,相反,創建一個組合腳本文件,并讓它包含您需要的所有內容。
使用RequireJS加載Download Builder包是不可能的,因為該工具不會創建所需的AMD模塊。
使用Gulp
如果您使用Kendo UI Core包,則可以使用gulp構建工具并按照中的說明構建自定義發行版。自Kendo UI 2014 Q3發布以來,必要的構建腳本已在可下載的商業捆綁包的src/目錄中發布。
若要從附帶的源構建自定義分發,請執行以下操作:
- 1.運行以下shell命令。
cd src npm install npx gulp custom -c autocomplete,dropdow
- 2.列出您希望包含在自定義構建中的組件,并用逗號(,)分隔它們。前面的示例構建了一個自定義的小型腳本,其中包括AutoComplete和DropDownList小部件。
- 3.通過運行npx gulp custom -c all構建整個Kendo UI庫。
注意:完成后,gulp命令在src/dist目錄下會輸出一個kendo.custom.min.js文件。Gulp構建任務自動解析每個組件所需的依賴項,因此您不必列出它們。不要使用多個自定義組合腳本,因為它們將包含重復的代碼。相反,創建一個組合腳本文件并讓它包含您需要的所有內容。
- 4.要編譯一個不被最小化的自定義腳本版本,請從gulpfile.js中刪除或注釋掉以下行:
... .pipe(uglify()) ...
標簽順序
若要在HTML標記之后加載和執行腳本,請將腳本標記放在結束body標記之前。通常,Kendo UI 小部件初始化語句通過jQuery處理程序在document.ready事件中執行,這意味著您必須在任何Kendo UI小部件初始化語句之前注冊jQuery,當使用客戶端Kendo UI小部件時,您可以控制初始化語句的位置,以便可以在文檔的底部注冊jQuery腳本文件。
Kendo UI小部件的服務器端包裝器是自初始化的,這意味著每個初始化腳本都是在小部件的HTML標記之后立即呈現的,在這種情況下,Kendo UI腳本仍然可以在文檔的末尾注冊,而jQuery腳本必須在文檔上的第一個Kendo UI小部件之前或在文檔 head.注冊。