How can I help you?
Getting started in EJ2 JavaScript Rating control
10 Feb 202612 minutes to read
This section explains the steps required to create a simple Essential® JS 2 Rating and demonstrate the basic usage of the Rating control in a JavaScript application.
Dependencies
The list of dependencies required to use the Rating component in your application is given below:
|-- @syncfusion/ej2-inputs
|-- @syncfusion/ej2-base
|-- @syncfusion/ej2-popupsSetup for local environment
Refer to the following steps to set up your local environment.
Step 1: Create a root folder named my-app for your application.
Step 2: Create a my-app/resources folder to store local scripts and styles files.
Step 3: Open Visual Studio Code and create my-app/index.js and my-app/index.html files to initialize the Essential® JS 2 Rating control.
Adding Syncfusion® resources
The Essential® JS 2 Rating control can be initialized by using either of the following ways.
- Using local script and style.
- Using CDN link for script and style.
Using local script and style references in a HTML page
Step 1: Create an app folder quickstart for getting started.
Step 2: You can get the global scripts and styles from the Essential Studio® JavaScript (Essential® JS 2) build installed location.
Syntax:
Dependency Script:
**(installed location)**\Syncfusion\Essential Studio\JavaScript - EJ2\{RELEASE_VERSION}\Web (Essential JS 2)\JavaScript\{DEPENDENCY_PACKAGE_NAME}\dist\global\{DEPENDENCY_PACKAGE_NAME}.min.jsControl Script:
**(installed location)**\Syncfusion\Essential Studio\JavaScript - EJ2\{RELEASE_VERSION}\Web (Essential JS 2)\JavaScript\{PACKAGE_NAME}\dist\global\{PACKAGE_NAME}.min.jsDependency Styles:
**(installed location)**\Syncfusion\Essential Studio\JavaScript - EJ2\{RELEASE_VERSION}\Web (Essential JS 2)\JavaScript\{DEPENDENCY_PACKAGE_NAME}\styles\material.cssControl Styles:
**(installed location)**\Syncfusion\Essential Studio\JavaScript - EJ2\{RELEASE_VERSION}\Web (Essential JS 2)\JavaScript\{PACKAGE_NAME}\styles\material.css
Example:
Dependency Script:
C:\Program Files (x86)\Syncfusion\Essential Studio\JavaScript - EJ2\16.3.0.17\Web (Essential JS 2)\JavaScript\ej2-base\dist\global\ej2-base.min.jsControl Script:
C:\Program Files (x86)\Syncfusion\Essential Studio\JavaScript - EJ2\16.3.0.17\Web (Essential JS 2)\JavaScript\ej2-inputs\dist\global\ej2-inputs.min.jsDependency Styles:
C:\Program Files (x86)\Syncfusion\Essential Studio\JavaScript - EJ2\16.3.0.17\Web (Essential JS 2)\JavaScript\ej2-base\styles\material.cssControl Styles:
C:\Program Files (x86)\Syncfusion\Essential Studio\JavaScript - EJ2\16.3.0.17\Web (Essential JS 2)\JavaScript\ej2-inputs\styles\material.css
The below located script and style file contains all Syncfusion® JavaScript (ES5) UI control resources in a single file.
Scripts:
**(installed location)**\Syncfusion\Essential Studio\JavaScript - EJ2\{RELEASE_VERSION}\Web (Essential JS 2)\JavaScript\ej2\dist\ej2.min.jsStyles:
**(installed location)**\Syncfusion\Essential Studio\JavaScript - EJ2\{RELEASE_VERSION}\Web (Essential JS 2)\JavaScript\ej2\material.css
The Custom Resource Generator (CRG) is an online web tool, which can be used to generate the custom script and styles for a set of specific controls. This web tool is useful to combine the required control scripts and styles in a single file.
Step 3: Create a folder ~/quickstart/resources and copy/paste the global scripts and styles from the above installed location to ~/quickstart/resources/package corresponding package location.
Step 4: Create a HTML page (index.html) in ~/quickstart/index.html location and add the Essential® JS 2 script and style references.
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>JavaScript (ES5)</title>
<!-- JavaScript (ES5) Rating's dependency style -->
<link href="resources/base/material.css" rel="stylesheet" type="text/css"/>
<link href="resources/popups/material.css" rel="stylesheet" type="text/css"/>
<!-- JavaScript (ES5) Rating's control style -->
<link href="resources/inputs/material.css" rel="stylesheet" type="text/css"/>
<!-- JavaScript (ES5) Rating's dependency global script -->
<script src="resources/base/ej2-base.min.js" type="text/javascript"></script>
<script src="resources/popups/ej2-popups.min.js" type="text/javascript"></script>
<!-- JavaScript (ES5) Rating's control global script -->
<script src="resources/inputs/ej2-inputs.min.js" type="text/javascript"></script>
</head>
<body>
</body>
</html>Step 5: Now, add the Rating element and initialize the JavaScript (ES5) Rating control in the index.html as shown below
[src/index.html]
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>JavaScript (ES5)</title>
<!-- JavaScript (ES5) Rating's dependency style -->
<link href="resources/base/material.css" rel="stylesheet" type="text/css"/>
<link href="resources/popups/material.css" rel="stylesheet" type="text/css"/>
<!-- JavaScript (ES5) Rating's control style -->
<link href="resources/inputs/material.css" rel="stylesheet" type="text/css"/>
<!-- JavaScript (ES5) Rating's dependency global script -->
<script src="resources/base/ej2-base.min.js" type="text/javascript"></script>
<script src="resources/popups/ej2-popups.min.js" type="text/javascript"></script>
<!-- JavaScript (ES5) Rating's control global script -->
<script src="resources/inputs/ej2-inputs.min.js" type="text/javascript"></script>
</head>
<body>
<!-- Add the HTML <input> element -->
<div class='wrap'>
<input id="rating"/>
</div>
<script>
// initialize Rating control
var Rating = new ej.inputs.Rating({}, "#rating");
</script>
</body>
</html>Step 6: Now, run the index.html in web browser, it will render the Syncfusion® JavaScript (ES5) Rating control.
Using CDN link for script and style reference
Step 1: Create an app folder quickstart for getting started.
Step 2: The JavaScript (ES5) control’s global scripts and styles are already hosted in the below CDN link formats.
Syntax:
Dependency Script:
https://cdn.syncfusion.com/ej2/{DEPENDENCY_PACKAGE_NAME}/dist/global/{PACKAGE_NAME}.min.jsControl Script:
https://cdn.syncfusion.com/ej2/{PACKAGE_NAME}/dist/global/{PACKAGE_NAME}.min.jsDependency Styles:
https://cdn.syncfusion.com/ej2/{DEPENDENCY_PACKAGE_NAME}/styles/material.cssControl Styles:
https://cdn.syncfusion.com/ej2/{PACKAGE_NAME}/styles/material.css
Example:
Script:
https://cdn.syncfusion.com/ej2/ej2-inputs/dist/global/ej2-inputs.min.jsStyles:
https://cdn.syncfusion.com/ej2/ej2-inputs/styles/material.css
Step 3: Create a HTML page (index.html) in ~/quickstart/index.html location and add the CDN link references. Now, add the Rating element and initiate the JavaScript (ES5) Rating control in the index.html by using following code.
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js"></script>
<title>JavaScript (ES5)</title>
<!-- JavaScript (ES5) Rating's dependency style -->
<link href="https://cdn.syncfusion.com/ej2/32.2.3/ej2-base/styles/material.css" rel="stylesheet" type="text/css" />
<link href="https://cdn.syncfusion.com/ej2/32.2.3/ej2-popups/styles/material.css" rel="stylesheet" type="text/css" />
<!-- JavaScript (ES5) Rating's control style -->
<link href="https://cdn.syncfusion.com/ej2/32.2.3/ej2-inputs/styles/material.css" rel="stylesheet" type="text/css" />
<!-- JavaScript (ES5) Rating's dependency global script -->
<script src="https://cdn.syncfusion.com/ej2/32.2.3/ej2-base/dist/global/ej2-base.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/32.2.3/ej2-popups/dist/global/ej2-popups.min.js" type="text/javascript"></script>
<!-- JavaScript (ES5) Rating's control global script -->
<script src="https://cdn.syncfusion.com/ej2/32.2.3/ej2-inputs/dist/global/ej2-inputs.min.js" type="text/javascript"></script>
<!--style reference from app-->
<link href="index.css" rel="stylesheet" />
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<!--Element to render the Rating control-->
<div class='wrap' style="margin: 50px auto; text-align: center;">
<input id="rating" />
</div>
<script>
ej.base.enableRipple(true);
// initialize Rating control
var rating = new ej.inputs.Rating({});
// Render initialized Rating.
rating.appendTo('#rating');
</script>
<script>
var ele = document.getElementById('container');
if (ele) {
ele.style.visibility = "visible";
}
</script>
</body>
</html>#container {
visibility: hidden;
padding-left: 5%;
width: 100%;
}
#loader {
color: #008cff;
font-family: 'Helvetica Neue','calibiri';
font-size: 14px;
height: 40px;
left: 45%;
position: absolute;
top: 45%;
width: 30%;
}
.wrap {
margin: 50px auto;
text-align: center;
}Step 4: Run the index.html in a web browser to render the Syncfusion® JavaScript Rating control.
Value
You can set the rating value by using the value property.
ej.base.enableRipple(true);
// Initialize the Rating control.
var rating = new ej.inputs.Rating({value:3.0});
// Render initialized Rating.
rating.appendTo('#rating');<!DOCTYPE html><html lang="en"><head>
<title>EJ2 Rating</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="TypeScript Rating Component">
<meta name="author" content="Syncfusion">
<link href="styles.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/32.2.3/ej2-base/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/32.2.3/ej2-buttons/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/32.2.3/ej2-popups/styles/material.css" rel="stylesheet">
<link href="https://cdn.syncfusion.com/ej2/32.2.3/ej2-inputs/styles/material.css" rel="stylesheet">
<script src="https://cdn.syncfusion.com/ej2/32.2.3/dist/ej2.min.js" type="text/javascript"></script>
<script src="https://cdn.syncfusion.com/ej2/syncfusion-helper.js" type ="text/javascript"></script>
</head>
<body>
<div id="container">
<div class="wrap">
<input id="rating">
</div>
</div>
<script>
var ele = document.getElementById('container');
if(ele) {
ele.style.visibility = "visible";
}
</script>
<script src="index.js" type="text/javascript"></script>
</body></html>#container {
visibility: hidden;
}
#loader {
color: #008cff;
font-family: 'Helvetica Neue','calibiri';
font-size: 14px;
height: 40px;
left: 45%;
position: absolute;
top: 45%;
width: 30%;
}
.wrap {
margin: 50px auto;
text-align: center;
}