External Client Libraries
- 2 minutes to read
DevExpress Dashboard, Reports, Query Builder, and Charts components require that specific external libraries are available on the client, including DevExtreme resources.
To ensure a component works correctly, you need to do one of the following:
- Add all the required external libraries.
- Add the resources section to the Web.config file so the control can load the external libraries automatically.
Required Client Libraries
- jquery-3.5.1.min.js
- jquery.validate.min.js (1.17)
- jquery.validate.unobtrusive.min.js (3.2.6)
- jquery.unobtrusive-ajax.min.js (3.2.4)
- knockout-3.5.0.js
- ace.js
- ext-language_tools.js
- theme-ambiance.js
- theme-dreamweaver.js
- cldr.min.js (0.4.3)
- cldr.event.min.js (0.4.3)
- cldr.supplemental.min.js (0.4.3)
- globalize.js (1.0.1)
- globalize.message.min.js (1.0.1)
- globalize.number.min.js (1.0.1)
- globalize.date.min.js (1.0.1)
globalize.currency.min.js (1.0.0)
DevExtreme client libraries
- jquery.js (3.5.1)
- jquery.validate.min.js (1.17)
- jquery.validate.unobtrusive.min.js (3.2.6)
- jquery.unobtrusive-ajax.min.js (3.2.4)
- knockout.js (3.5.1)
- cldr.min.js (0.4.3) (optional)
- cldr.event.min.js (0.4.3) (optional)
- cldr.supplemental.min.js (0.4.3) (optional)
- cldr.unresolved.js (0.4.3)(optional)
- globalize.js (1.0.1) (optional)
- globalize.message.min.js (1.0.1) (optional)
- globalize.number.min.js (1.0.1) (optional)
- globalize.currency.min.js (1.0.0) (optional)
- globalize.date.min.js (1.0.1) (optional)
- ace.js (1.4.13) (optional - code highlighting)
- ext-language_tools.js (optional - code highlighting)
jszip.min.js (3.7.1) (optional - rich text editor)
DevExtreme client libraries
- jquery.js (3.5.1)
- jquery.validate.min.js (1.17)
- jquery.validate.unobtrusive.min.js (3.2.6)
- jquery.unobtrusive-ajax.min.js (3.2.4)
- knockout.js (3.5.1)
- ace.js (1.4.13)
- ext-language_tools.js
- cldr.min.js (0.4.3) (optional)
- cldr.event.min.js (0.4.3) (optional)
- cldr.supplemental.min.js (0.4.3) (optional)
- cldr.unresolved.js (0.4.3) (optional)
- globalize.js (1.0.1) (optional)
- globalize.message.min.js (1.0.1) (optional)
- globalize.number.min.js (1.0.1) (optional)
- globalize.currency.min.js (1.0.0) (optional)
- globalize.date.min.js (1.0.1) (optional)
- DevExtreme client libraries
Register Client Scripts Automatically
To load DevExtreme and third-party libraries automatically, add the following references to the resources section to the Web.config file.
<configuration>
<configSections>
<sectionGroup name="devExpress">
<!-- ... -->
<section name="resources" type="DevExpress.Web.ResourcesConfigurationSection, DevExpress.Web.v23.1, Version=23.1.5.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" requirePermission="false" />
</sectionGroup>
</configSections>
<!-- ... -->
</configuration>
<!-- ... -->
<devExpress>
<!-- ... -->
<resources>
<add type="ThirdParty" />
<add type="DevExtreme" />
</resources>
</devExpress>
The code snippet above allows you to register the following resources:
ThirdParty
- Adds references to required third-party libraries.
DevExtreme
- Adds a reference to the DevExtreme package.
When you create a project from the DevExpress Template Gallery, it automatically registers the resources in the Web.config file. In this case, all necessary client-side libraries are automatically passed to the client.
Register Client Scripts Manually
Follow the steps below to specify the libraries to deploy on the client:
Declare an empty resources section to prevent external client scripts from loading automatically.
<resources> </resources>
Attach DevExtreme resources and the third-party libraries (see the Required Script Libraries section) to the web page. DevExpress scripts modify the jQuery libraries for our own purposes, so you should register the resources in the following order:
- Third-party libraries.
- The DevExtreme packages.