创建自定义包
根据您的项目,您可能需要跳过一些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.注册。