telerik / kendo-ui-core

An HTML5, jQuery-based widget library for building modern web apps.

Kendo UI Core

About Kendo UI Core

Kendo UI is everything you need to build sites and apps with HTML5 & JavaScript. Kendo UI Core is the free and open-source version of Kendo UI that provides access to the web's best UI widgets and key framework features, essential for developing great experiences for the web and mobile.

Features of Kendo UI Core

Kendo UI Core is a free and open-source subset of Kendo UI. The following table details the widgets and features available in Kendo UI Core, as well as the additional features available via a commercial Kendo UI license.

Feature	Kendo UI Core	Professional	UI for MVC/Core/JSP/PHP
Data Management
Grid	❌	✅	✅
FileManager	❌	✅	✅
Spreadsheet	❌	✅	✅
ListView	✅	✅	✅
PivotGrid	❌	✅	✅
TreeList	❌	✅	✅
Filter	❌	✅	✅
Pager	✅	✅	✅
Editors
AutoComplete	✅	✅	✅
Color Picker	✅	✅	✅
ComboBox	✅	✅	✅
DateInput	✅	✅	✅
DatePicker	✅	✅	✅
DateRangePicker	❌	✅	✅
DateTimePicker	✅	✅	✅
DropDownList	✅	✅	✅
DropDownTree	❌	✅	✅
Editor	❌	✅	✅
ListBox	✅	✅	✅
MaskedTextBox	✅	✅	✅
MultiColumnComboBox	❌	✅	✅
MultiSelect	✅	✅	✅
NumericTextBox	✅	✅	✅
Rating	❌	✅	✅
Slider	✅	✅	✅
Switch	❌	✅	✅
TextBox	✅	✅	✅
TimePicker	✅	✅	✅
Upload	❌	✅	✅
Validator	✅	✅	✅
Conversational UI
Chat	❌	✅	✅
Charts
Area Charts	❌	✅	✅
Bar Charts	❌	✅	✅
Box Plot Charts	❌	✅	✅
Bubble Charts	❌	✅	✅
Bullet Charts	❌	✅	✅
Chart API	❌	✅	✅
Donut Charts	❌	✅	✅
Funnel Charts	❌	✅	✅
Line Charts	❌	✅	✅
Pie Charts	❌	✅	✅
Polar Charts	❌	✅	✅
Radar Charts	❌	✅	✅
Range Bar Charts	❌	✅	✅
Scatter Charts	❌	✅	✅
Sparklines	❌	✅	✅
Stock Charts	❌	✅	✅
TreeMap	❌	✅	✅
Waterfall Charts	❌	✅	✅
Gauges
ArcGauge	❌	✅	✅
CircularGauge	❌	✅	✅
LinearGauge	❌	✅	✅
RadialGauge	❌	✅	✅
Barcodes
Barcode	❌	✅	✅
QR Code	❌	✅	✅
Diagram and Maps
Diagram	❌	✅	✅
Map	❌	✅	✅
Scheduling
Calendar	✅	✅	✅
Gantt	❌	✅	✅
MultiViewCalendar	❌	✅	✅
Scheduler	❌	✅	✅
Layout
Badge	✅	✅	✅
Dialog	✅	✅	✅
ExpansionPanel	❌	✅	✅
Form	❌	✅	✅
Notification	✅	✅	✅
Popover	❌	✅	✅
Responsive Panel	✅	✅	✅
Splitter	✅	✅	✅
TileLayout	❌	✅	✅
Tooltip	✅	✅	✅
Window	✅	✅	✅
Media
MediaPlayer	❌	✅	✅
ScrollView	❌	✅	✅
PDF
PDFViewer	❌	✅	✅
Navigation
ActionSheet	❌	✅	✅
Breadcrumb	❌	✅	✅
Button	✅	✅	✅
ButtonGroup	✅	✅	✅
Drawer	❌	✅	✅
Menu	✅	✅	✅
PanelBar	✅	✅	✅
Stepper	❌	✅	✅
TabStrip	✅	✅	✅
Timeline	❌	✅	✅
ToolBar	✅	✅	✅
TreeView	❌	✅	✅
Wizard	❌	✅	✅
Interactivity and UX
Drag-and-Drop	✅	✅	✅
Effects	✅	✅	✅
ProgressBar	✅	✅	✅
Sortable	✅	✅	✅
Styling	✅	✅	✅
Tools, Frameworks and Utilities
Chrome Inspector	✅	✅	✅
DataSource	✅	✅	✅
Drawing API	❌	✅	✅
Excel Export	❌	✅	✅
Globalization	✅	✅	✅
HierarchicalDataSource	✅	✅	✅
AngularJS Integration	✅	✅	✅
Bootstrap Friendly	✅	✅	✅
Localization	✅	✅	✅
MVVM Integration	✅	✅	✅
PDF Export	❌	✅	✅
Single-Page Application	✅	✅	✅
Templates	✅	✅	✅
ThemeBuilder	✅	✅	✅
Official Support	❌	✅	✅

Compatibility and Requirements

Kendo UI Core depends on the following libraries:

• jQuery v1.9.1+

Kendo UI Core has not been tested against any other versions of these libraries. You may find that versions other than these are compatible with Kendo UI Core. However, we make no claims to support those versions, and will not troubleshoot issues that arise when using those versions.

Building Kendo UI Core

There are two ways to get the source code for Kendo UI Core. You can either download a pre-built zip from Telerik.com, or build the source yourself using Gulp. The latter approach includes an option for building a distribution of Kendo UI Core that includes only the widgets and framework features required by your app.

Installing Dependencies

In order to build Kendo UI Core, you need to have Node.js 14.x and git 2.x.

For Windows you have to download and install Git for Windows and Node.js and Visual C++ Build Tools.

Mac OS users should install Homebrew. Once Homebrew is installed, run brew install git to install git, and brew install node@14 to install Node.js.

Linux users can use the distributions provided by NodeSource or their package managers to install git and nodejs.

How to build Kendo UI Core

Clone a copy of the repository by running

git clone https://github.com/telerik/kendo-ui-core.git

Enter the repository directory

cd kendo-ui-core

Initialize the submodule repository

git submodule update --init

Install dependencies:

npm install

Run the build script:

npm run build

The minified version of the scripts and styles of Kendo UI Core will be put in the dist/ subdirectory.

There are several other tasks available:

npx gulp --tasks

Building only what you need

The gulp custom task will create a custom minified file - dist/kendo.custom.min.js, which includes only the specified components. The following command will include only the autocomplete and dropdownlist widgets:

npx gulp custom -c autocomplete,dropdownlist

Building ESM and CJS modules

The npm script npm run scripts:modules will create two folders (cjs and esm) in the dist folder, which includes the bundled modules.

Development

• Run the dev script in order to compile both modules and js files in dist/dev and dist/mjs folder

  npm run scripts:dev or npm run scripts:dev -- -w

• Run the tests by running npx gulp tests

Source Code and Downloads

If you want to skip building Kendo UI Core yourself, head on over to Telerik.com to grab the full source.

Using Kendo UI Core via the Kendo Static CDN

You can also easily include Kendo UI Core in your site or application by using the Kendo CDN:

<link href="http://kendo.cdn.telerik.com/2014.2.716/styles/kendo.common.min.css" rel="stylesheet" />
<link href="http://kendo.cdn.telerik.com/2014.2.716/styles/kendo.default.min.css" rel="stylesheet" />
<script src="http://kendo.cdn.telerik.com/2014.2.716/js/jquery.min.js"></script>
<script src="http://kendo.cdn.telerik.com/2014.2.716/js/kendo.ui.core.min.js"></script>

The main advantage of the CDN approach is that your users may be able to leverage a primed cache version of Kendo UI Core if they've visited other sites using the framework.

Documentation

For complete Kendo UI Documentation, including Kendo UI Core, please visit https://docs.telerik.com/kendo-ui.

How to Contribute

Kendo UI Core is free and open-source. We encourage and support an active, healthy community that accepts contributions from the public. We'd like you to be a part of that community.

Before contributing to Kendo UI Core, please:

1. Read and sign the Kendo UI Core Contribution License Agreement, to confirm you've read and acknowledged the legal aspects of your contributions, and
2. Read our contribution guide, which houses all of the necessary info to:
   • submit bugs,
   • request new features, and
   • walk you through the entire process of preparing your code for a Pull Request.

Getting Help

• Use the issues list of this repo for bug reports, related both to Kendo UI Core and Kendo UI Professional

• Get help on Stack Overflow or the Kendo UI Premium Forums

• File feature requests on User Voice

As a fully-open source project, Kendo UI Core is a primarily community-supported project, As such, you are encouraged to use forums like Stack Overflow to post questions, and the issues list of this repo to report bugs.

The Kendo UI team does not provide formal support for Kendo UI Core, except to those customers who have purchased a commercial license for Kendo UI (Professional, UI for MVC, etc.) or a support-only package from Telerik.com. Please do not create support requests for this project in the issues list for this repo, as these will be immediately closed. You'll be directed to post your question on a community forum.

Release Notes

For change logs and release notes, see the online release notes at Telerik.com.

License Information

This project has been released under the Apache License, version 2.0, the text of which is included below. This license applies ONLY to the source of this repository and does not extend to any other Kendo UI distribution or variant, or any other 3rd party libraries used in a repository. For licensing information about Kendo UI, see the License Agreements page at Telerik.com.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Copyright © 2024 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries.

kendo-ui-core's Issues

Expose tabstrip keyboard navigation boolean configuration option

Right now you can't turn it off.

Editable doesn't validate :checked bindings on non boolean fields

The kendoEditable doesn't behave correctly with certain binding arrangements. Specifically it listens for model .set() and translated the model field to form input in order to validate the input (via .validateInput()), however the logic only checks if the type is boolean before picking the :checked binding

input = $(':input[' + kendo.attr("bind") + '="' + (isBoolean ? 'checked:' : 'value:') + e.field.replace(nameSpecialCharRegExp, "\\$1") + '"]', that.element);

the problems is that this markup:

<input type="radio" value="1" name="myField"/>
<input type="radio" value="2" name="myField"/>
<input type="radio" value="3" name="myField"/>

is valid and will be parsed automatically by the Editable (.refresh() method) and each input is given a checked: binding.

since the binding is :checked and the field is not Boolean the set handler will never select an input to try and validate

The proper behavior in this case would be for the editable to try and validate the entire list, or at least only the checked/first input. currently it gives the user nothing, since there is no input selected by the current code.

The main concern for me is that the Editable is creating a binding situation it can't validate (as opposed to the dev defining a complex template).

I'd be happy to send a PR but my solution is just to check for both checked/value bindings, and i am not convinced that that would not cause other subtle issues

Support for app level header/footer

Bottom border is randomly missing in Chrome at random zoom levels

The bottom border of an input widget may be missing at a particular zoom level in Chrome browser. The issue can be exhibited by only some of the widget instances on the page, but not by others.

Affected widgets:

ColorPicker
ComboBox
DatePicker
DateTimePicker
NumericTextBox
TimePicker

Web widget styling is broken in a mobile app with iOS7 theme

Repro demo

http://jsbin.com/guqoh/2/edit

Overlay transition is occasionally short cut

Can be reproduced on iPhone here - http://jsbin.com/musaz/2.

Pasting via "Ctrl + V" does not work in Firefox

swipe gesture in iOS 7 may results in subsequent invalid navigation on tap

This thread gives a clue on what happens - in a nutshell, the browser triggers a "delayed" touchend event:

http://stackoverflow.com/questions/19662434/in-ios-7-safari-how-do-you-differentiate-popstate-events-via-edge-swipe-vs-the

kendo.parseDate does not parse UTC dates without a timezone offset

Description

kendo.parseDate method only with value parameter does not parse UTC date without a timezone offset.

Repro code

//returns date without milliseconds
kendo.parseDate("2013-08-13T20:11:04.9297826");

Calendar header is animated incorrectly in IE8

Expose before/after* events

Start distributing Kendo.Core through NuGet

Now that this project is open source, you guys should heavily consider putting together an official NuGet distro for all of the core files, deployed to NuGet.org. You could then set up a password-protected NuGet server on your production site that would then distribute the Commercial NuGet package that depends on this new open source NuGet package.

Widget with source and value binding does not honor the ObservableArray change

Issue:

Widget is not updated when new data is added to the ObservableArray instance, because the reference to the ViewModel is lost.

Repro demo:

http://jsfiddle.net/krustev/u64v5/

Option to configure swipeToOpen only for certain views

Breaking change: TabStrip does not retain scroll position on tab change

Here is a screencast of the issue: http://www.screencast.com/t/nZXOuw9Hp

and a Kendo UI Dojo: http://trykendoui.telerik.com/@Kiril/iCaf

Icon is not vertically centered with XHTML 1.0 Transitional DOCTYPE

When using a XHTML 1.0 Transitional DOCTYPE, the widget icon is not vertically centered, but appears at the top part of its parent element. (Problem does not occur with XHTML 1.0 Strict, XHTML 1.1. or HTML 5 DOCTYPE).

Affected widgets:

ColorPicker
ComboBox
DropDownList
DatePicker
DateTimePicker
TimePicker

Support for mobile application model scope

This will allow the view models to reside in a separate namespace (instead of being exposed as global objects).

Slider should not have large last tick when the largeStep is not devisible to max value

kendo.destroy does not destroy multiple widget instances on an element

Pasting via "Ctrl + V" does not work in Firefox

Reproducible in Firefox 28

Support mobile view event bindings to the model

Platform variant classes shouldn't be added when different skin is set

For instance, when using the flat skin, platform variants (wp/android-light/dark) pollute the flat skin styling.

Widget throws an error when search for a nonexisting text and the last item is selected

Steps to reproduce:

1. Select last item in the widget
2. Type a letter, which cannot be found in the list
3. Repeat step 2
   An error is raised.

Repro demo:

http://trykendoui.telerik.com/uHIp

BlackBerry 10 and native scrolling

kendo mobile in BlackBerry 10 iuse native scrolling? Native scroll in BlackBerry 10 devices is supported, now scroll with kendo mobile on BlackBerry 10 is flaky.

Allow for the mobile view to disable elastic scrolling

Close event for Kendo UI Mobile Actionsheet should be triggered when shim is tapped

When the Actionsheet is closed with a click somewhere in the view, the close event is not fired, so it might be a good idea to fire a cancel event in such scenario.

Font

Ok new to this so sorry if this has been addressed. Has anyone addressed a universal font for kendo? If so, what is it? The UX guy I work with has thoughts on attractive fonts, and I find myself using Google fonts and replacing in the kendo code. What has your experience been?

configuration option to accept taps only (useful when drawer is present)

Add afterHide event to the Kendo UI Drawer

Currently the hide event is fired when the drawer closing animation starts. A customer suggested that an event that is fired when the animation completes will be useful.

Drag Scrolling Kendo UI Mobile ListView throws error checking useNativeScrolling

When scrolling a Kendo UI Mobile ListView OUTSIDE of the Kendo UI Mobile Application object, the view.hasNativeScrolling check runs and the options object on the view is undefined, rendering the useNativeScrolling property check in error.

This only occurs when doing a "drag scroll" (click and hold while moving mouse) with the mouse, but occurs always on a mobile device (iOS 7.1 tested).

http://trykendoui.telerik.com/OBEw

cultures / kendo.culture.ar-TN.js

The correct months names "Arabic for Tunisia":
months: {
names: ["جانفي","فيفري","مارس","أفريل","ماي","جوان","جويلية","أوت","سبتمبر","أكتوبر","نوفمبر","ديسمبر",""],
namesAbbr: ["جانفي","فيفري","مارس","أفريل","ماي","جوان","جويلية","أوت","سبتمبر","أكتوبر","نوفمبر","ديسمبر",""]
}

[bug] kendoui editor with custom image Browser on uploadUrl, error: "too much recursion"

I'm using the editor to image gallery of Kendo UI, the editor works fine (links, formats, etc. ..) and upload the photos to the gallery and read a service (rest); the problem is that when wanting to insert any image in the gallery get the error:

"too much recursion ... ute (i)," string "== typeof r) {try {r =" true "=== r 0:" false "=== r1:" null "r === null: + r ... jquery .... min.js (line 3) "

The funny thing is that when you remove the configuration "uploadURL", if you insert pictures in the textarea; obviously the plugin no longer gives me the option to upload.

In the documentation (http://docs.telerik.com/kendo-ui/api/web/editor # configuration-ImageBrowser): did not find details about how to fix it.

HTML(Razr)

<script type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js"></script>
<script type="text/javascript" src="/js/vendor/kendo-ui/kendo.all.min.js"></script>

<div class="k-content">
        <textarea id="KEditor" rows="10" cols="30" placeholder="@GetText("Content")" maxlength="255" style="height: 500px"></textarea>    
</div>

Js

$(document).ready(function() {
            $("#KEditor").kendoEditor({
                tools: [
                    "fontName", "fontSize", "foreColor",
                    "backColor", "bold", "italic",
                    "createLink", "unlink",
                    "insertImage",
                    "viewHtml"
                ],
                imageBrowser: {
                    transport: {
                        read: {
                            type: "GET",
                            url: "/api/sites/user-gallery",
                        },
                        destroy: "/api/sites/user-gallery?action=delete",
                        thumbnailUrl: function(path, name) {
                            var pictureUrl = decodeURIComponent(name);
                            return pictureUrl;
                        },
                        //work if this line is commented
                        uploadUrl: "/api/sites/user-gallery?action=upload", 
                        imageUrl: function(name) {
                            var pictureUrl = decodeURIComponent(name);
                            return pictureUrl;
                        },
                    }
                }          
                //, messages: { viewHtml: '@GetText("ViewHtml")'}
            });
        });

Json(read rest service):

{
   "pictureId":1369437,
   "name":"http://s3.amazonaws.com/nocnokdemo-img/1404301211033c10e4f43bdb468ba132ef12048d2438.jpg",
   "type":"f",
   "size":1024,
   "url":"http://s3.amazonaws.com/nocnokdemo-img/1404301211033c10e4f43bdb468ba132ef12048d2438.jpg"
}

Widget should place caret at first position on focus if input is empty

The issue can be reproduced in Google Chrome and our online demos.

reference ID 811203 and 810627

Add preventDefault functionality for the close event

Will be useful to have an option for preventing the close event of a ModalView

Complex views briefly appear before the transitions occur

Can be reproduced in iOS on our online demos with the adaptive grid.

Multiselect does not remove focused class on blur

The multiselect widget (http://demos.telerik.com/kendo-ui/web/multiselect/index.html) keeps the focus when the widget doesn't have the focus (I can see the issue on the test page in chrome 34 and firefox 28).
I click in the multiselect then I click in the other multiselect, the first and the second multiselect have the class k-state-focused.

The issue is more visible with the thme bootstrap.

Total is incorrect when re-adding a removed item and the DataSource is initially bound to a single record

var dataSource = new kendo.data.DataSource({
  data: [ { foo: "foo" }]
});
dataSource.read();
var item = dataSource.at(0);
dataSource.remove(item);
dataSource.add(item);
console.log(dataSource.total());// total is 2 instead of 1

Widget loses value selection on input focus in Firefox

Steps to reproduce:

1. Open "Basic usage" demo
2. Focus/blur several times the first widget.

Result:
You will see how second time the selection is lost.
Reproducible in Q1 2014 SP1

Export dropTarget field in the drag event data

Hover is not applied on the action buttons

Can be reproduced in our demos as well.

Configuration option to keep the scroll hints always visible

Widget prevents selection on ENTER after the popup is opened with ALT + DOWN

Steps to reproduce:

1. Open the widget with ALT+DOWN
2. Select item
3. Press ENTER

Error: the item is not selected and the popup does not close.

Repro demo:

http://trykendoui.telerik.com/egaf

Copyright <%= year %> Telerik AD

Hi,

First of all, this is a really great news that Kendo UI is now ASFv2 licensed! :)

I just get the telerik.kendoui.2014.1.416.core, watched to the license header and noticed a small issue (really not dramatic) about the year, in both minified and non-minified files:

/**
 * Copyright <%= year %> Telerik AD
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

Thanks again & best regards,
Sebastien

Implement disable/enable widget functionality

Add attribute that can be used to disable the validation for an input

Pull to refresh spinner should hide when a network request fails

Hiding keyboard in a form makes the view scroll from the top

Can be reproduced here http://jsbin.com/waqaq/1/edit

Using overlay:left for PopOver's pane transition breaks the widget

Can be reproduced here:
http://trykendoui.telerik.com/@Kiril/axIj

If you change it to overlay:up for example it will work as expected.

Add TypeScript build process and files

The Kendo TypeScript file is missing events and event argument definitions on the kendo.Observable object. I would like to be able to contribute fixes, but those files are not included in this repro. It would be great if you guys could add them, so they could be fixed.

Alternatively, since this is now open source, the Core TypeScript definitions shoudl probably be broken out from the Commercial ones, and the new kendo.core.d.ts file should probably be contributed to DefinitelyTyped so it can be distributed via NuGet.

support # # expressions in view/layout templates