Angular UI Components for jQWidgets

Angular is a development platform for building mobile and desktop web applications. It provides a way to build apps for any deployment target by reusing existing code. Using HTML as the template language, Angular offers developers the possiblity to create their own components.

Prerequisites

• Node.js - to verify that you have it installed, run the command node -v in cmd. It will output the current version.

Steps:

1. Create your project folder structure
2. Configurate and install all required packages
3. Build the app

Step 1 - Create your root project folder

The root folder contains a few configuration files and the app folder which holds the main content of the application.

 /root
 /app
 /index.html
 /src
 /app.component.ts
 /app.module.ts
 /main.ts
 /assets
 /package.json
 /tsconfig.json
 /tsconfig.aot.json
 /webpack.config.js
 

Step 2 - Install and configurate all required packages

Apart from the package.json and tsconfig.json you will need tsconfig.aot.json and webpack.config.js files.
The tsconfig.aot.json is a normal tsconfig.json file, but with AoT-oriented settings.
Let's take a look at the config files:

package.json

• ngc compiles our .ts files to .js. It is a drop-in replacement for tsc.
• webpack gets the transpiled .js files and bundles them to a single .js file.

When we type npm start in our CLI it executes both the commands. We just need to include the bundled file in or HTML and run it.

Here we have also added a watch command, which executes start on every save we make in a .ts/.css/htm file.

tsconfig.json

tsconfig.aot.json

What's really new is the ngc section called angularCompilerOptions. Here we say to the compiler to skip generating metadata files. We have also set genDir which means all of our recompiled files will go in that folder. For more information about AOT please refer to the official Ahead-Of-Time Compilation CookBook.

webpack.config.js

For more information about Webpack please refer to the official guide.

Step 3 - Build the app

I. index.html

Add the needed references and the <app-root></app-root> tag to the body of index.html. That's the tag where we initialize the main component.
Then import the bundled file we received after running the npm start command.

II. app.module.ts

III. main.ts

IV. app.component.ts

Imports:

@Component decorator:

The Class:

In the above example we create the widget through attributes.
There is another way through method called createComponent. It takes just one argument - an object containing the settings for the widget.

Events Methods & Properties

I. Events

Event Names in the Angular Components are the same as the Event Names in the Javascript Widgets.
The only thing you need to do is to put "on" before the Javascript widget event name and upperCase it's first letter.

II. Methods & Properties

Every widget also have a method setOptions which accepts an object as an argument. This object contains widget settings.

Two Way Data Binding

We often want to both display a data property and update that property when the user makes changes.
Let's take a look at the following example:

IV. app.component.ts