@exadel/esl

Exadel Smart Library

Exadel Smart Library (ESL) is an open-source lightweight and flexible UI component library based on web components. Increase your site’s performance by building UX models with custom components from our library. The ESL web UI components library is compatible with any framework, which makes ESL ideal for projects regardless of their tech stack.

Table of Contents

• Overview

• Library Structure

• ⏎ Monorepo Root

  • Contribute to ESL

Overview

Exadel Smart Library, or ESL for short, is a free web UI components library that reduces routine tasks and lets you efficiently create websites with multiple web components at hand. When you’re deciding which is the best UI component library for your site, keep in mind that it should be compatible with other libraries and frameworks — like ESL is!

ESL UI component library allows you to access a toolkit full of reusable components. You can utilize these web components to complement projects or build your infrastructure from the ground up using ESL alone. Our web UI components library is high-quality, so the only thing you’ll have to focus on is applying styles to meet your project needs.

ESL is based solely on Web API and ECMAScript 6 features, which let our web UI components library work well across all modern browsers such as Firefox, Chrome, Safari, Opera, and Edge.

Library Structure

While building the UI component library, we included components, form components, and utilities that solve complex project architecture problems and comply with the DRY principle. See the rundown of web components and read the specs.

Library Core

With our UI component library, you get flexible syntax sugar meant for building on top of basic components and controlling their life cycle.

• ESL Base Element

• ESL Mixin Element

• ESL Media Query

• ESL Traversing Query

• ESL Event Listener

• ESL Utils

Components

Our HTML UI component library provides you with all the elements you’ll need to construct UX modules with excellent performance.

• ESL A11yGroup (beta)

• ESL Alert

• ESL Animate

• ESL Carousel

• ESL Footnotes

• ESL Image Utils

• ESL Image (Legacy)

• ESL Media

• ESL Panel

• ESL Panel Group

• ESL Popup (beta)

• ESL Related Target

• ESL Scrollbar

• ESL Select (beta)

• ESL Select List (beta)

• ESL Share

• ESL Tab and Tabs

• ESL Toggleable

• ESL Trigger

Installation Guide

• Preconditions:

  • Make sure you have all needed polyfills to support browsers from your browser-support list. See Browser support & Polyfills for details.
  • Use a bundler to build your project. Currently, only ES6 modules are available for consumption.

• Install esl npm dependency:

  npm i @exadel/esl --save
  

• Import Components/Modules you need:

  import '@exadel/esl/modules/esl-component/core';
  

  • core module entry usually represents main part of the module;
  • include optional sub-features directly. See component's documentation for details.

  import '@exadel/esl/modules/esl-media/providers/iframe-provider';
  

  • Some modules contain cumulative all entries.
  • Styles are distributed in two versions:
    • 'ready to use' core.css or core.less
    • mixin version core.mixin.less for custom tagname definition

• [Optional] Setup environment configuration, e.g. custom screen breakpoints:

  import {ESLScreenBreakpoints} from '@exadel/esl/modules/esl-media-query/core';
  
  // define XS screen breakpoint for up to 800px screen width
  ESLScreenBreakpoints.addCustomBreakpoint('XS', 1, 800); 
  

• Register web components via register static method call:

  ESLMedia.register();
  

  You can pass custom tag name to 'register' function, but use this option only in an exceptional situation.

Exadel, Inc.

Changelog

5.14.0 (2025-09-30)

🚀 Features

• remove deprecated alias for ActionParams on ESLAlert, ESLPanel, ESLPopup, ESLTooltip (4c9972092)
• introduce ESLIntrinsicElements ESL custom tag jsx declaration interface (8b053737b)
• esl-carousel: introduce capabilities to provide custom autoplay restrictions. Resolves #3349 (#3349)
• esl-popup: introduce config prop for easily accessing params of popup (2252767c5)
• ui-playground: default attribute settings (7ee27aad1)

🩹 Fixes

• esl-trigger: update esl-base-trigger and it's instances to dispatch esl:change:action (e1b84e326)
• esl-utils: handle empty eventName in dispatch function (8821c837a)

💅 Refactors

• introduce global ESLIntrinsicElements interface (fe64e7871)
• rename some Shape types declarations for consistency (6e709d0d6)
• esl-popup: clearing params on popup hide (89884d581)
• eslint-config: has embedded support of esl/custom linting (1417150d8)
• site: playground home page (7b71b9f15)
• site: playground demo logo update (62d1d8b34)
• site: add playground section (dbaf99955)
• site: add rulers in sidebar (54454cc1a)
• site: add automated brakpoints on sidebar, adjust playground examples (fdd2aebfc)
• site: drop changes not related to playground readme (c1a0a222e)
• site: remove unused tags (05c77d33f)
• site: remove unused images (6d62abf25)
• site: add empty line (1c77e2f7f)
• site: remove unused sidebar logo (1c676738f)
• site: playground navigation (772859d85)
• site: add playground description (e83a7eb79)
• site: move header titles to the actual collection (f780c38db)
• ui-playground: migrate UIP project to latest (8) JSX-DOM (5275cb787)

Documentation updates

• add detailed TSX support guide (dee009e76)
• esl-utils: add @safe decorator documentation (4e4c73551)
• esl-utils: add @bind decorator documentation (f5e2a75cb)
• esl-utils: add @memoize decorator documentation (622d27c4b)
• esl-utils: add @ready decorator documentation (9c6bf404d)
• esl-utils: add @decorate decorator documentation (be705918a)
• esl-utils: add @prop decorator documentation (ce08e6c28)
• esl-utils: add @boolAttr decorator documentation (50be80d0c)
• esl-utils: add @listen decorator documentation (4f0e0eb15)
• esl-utils: add @jsonAttr decorator draft documentation (c445edd61)
• esl-utils: update cumulative docs (8ddf9d90e)
• site: add detailed site ESL TS Decorators documentation (e792a2e57)