@syncfusion/ej2-inputs 20.4.40 → 20.4.48

package/dist/global/index.d.ts

@@ -1,6 +1,6 @@
 /*!
 *  filename: index.d.ts
-*  version : 20.4.40
+*  version : 20.4.48
 *  Copyright Syncfusion Inc. 2001 - 2020. All rights reserved.
 *  Use of this code is subject to the terms of our license.
 *  A copy of the current license can be obtained at any time by e-mailing

package/package.json

@@ -1,8 +1,8 @@
 {
   "_from": "@syncfusion/ej2-inputs@*",
-  "_id": "@syncfusion/ej2-inputs@20.4.38",
+  "_id": "@syncfusion/ej2-inputs@20.4.42",
   "_inBundle": false,
-  "_integrity": "sha512-1BObDYS1OiYXHlM3ofwW3AJcOjefONr4guSezY9GGkIeYTd9u+Hp6wXXIDPJySebgTxM3vBPld6r3d3KsoOnrw==",
+  "_integrity": "sha512-cjzaMmmmfNG3GwYbZw1nMEqn2i4S+KZpDTM37zRWdIvcEkBTyMF/d1XU+sqEK24/HclUdaMAJu7yZfmzxfCAxg==",
   "_location": "/@syncfusion/ej2-inputs",
   "_phantomChildren": {},
   "_requested": {
@@ -39,8 +39,8 @@
     "/@syncfusion/ej2-schedule",
     "/@syncfusion/ej2-vue-inputs"
   ],
-  "_resolved": "https://nexus.syncfusion.com/repository/ej2-hotfix-new/@syncfusion/ej2-inputs/-/ej2-inputs-20.4.38.tgz",
-  "_shasum": "63b3cd6b432a40223cd32e60ddfd4f4f5c61e430",
+  "_resolved": "https://nexus.syncfusion.com/repository/ej2-hotfix-new/@syncfusion/ej2-inputs/-/ej2-inputs-20.4.42.tgz",
+  "_shasum": "c75a231b3cd6ebaa687dc98d96318ef77b79b97d",
   "_spec": "@syncfusion/ej2-inputs@*",
   "_where": "/jenkins/workspace/ease-automation_release_19.1.0.1/packages/included",
   "author": {
@@ -48,10 +48,10 @@
   },
   "bundleDependencies": false,
   "dependencies": {
-    "@syncfusion/ej2-base": "~20.4.40",
-    "@syncfusion/ej2-buttons": "~20.4.40",
-    "@syncfusion/ej2-popups": "~20.4.40",
-    "@syncfusion/ej2-splitbuttons": "~20.4.40"
+    "@syncfusion/ej2-base": "~20.4.48",
+    "@syncfusion/ej2-buttons": "~20.4.48",
+    "@syncfusion/ej2-popups": "~20.4.48",
+    "@syncfusion/ej2-splitbuttons": "~20.4.48"
   },
   "deprecated": false,
   "description": "A package of Essential JS 2 input components such as Textbox, Color-picker, Masked-textbox, Numeric-textbox, Slider, Upload, and Form-validator that is used to get input from the users.",
@@ -119,7 +119,7 @@
     "url": "https://github.com/syncfusion/ej2-javascript-ui-controls/tree/master/controls/inputs"
   },
   "typings": "index.d.ts",
-  "version": "20.4.40",
+  "version": "20.4.48",
   "sideEffects": false,
   "homepage": "https://www.syncfusion.com/javascript-ui-controls"
 }

package/src/common/signature-base.js

@@ -663,6 +663,7 @@ var SignatureBase = /** @class */ (function (_super) {
      * @returns {void}.
      */
     SignatureBase.prototype.draw = function (text, fontFamily, fontSize) {
+        var args = { actionName: 'draw-text' };
         this.canvasContext.clearRect(0, 0, this.canvasContext.canvas.width, this.canvasContext.canvas.height);
         fontFamily = fontFamily || 'Arial';
         fontSize = fontSize || 30;
@@ -672,6 +673,7 @@ var SignatureBase = /** @class */ (function (_super) {
         this.canvasContext.fillText(text, this.element.width / 2, this.element.height / 2);
         this.updateSnapCollection();
         this.isSignatureEmpty = false;
+        this.trigger('change', args);
     };
     /**
      * To load the signature with the given base 64 string, height and width.

package/src/rating/rating-model.d.ts

@@ -1,4 +1,4 @@
-import { addClass, Event, attributes, BaseEventArgs, compile, Component, EmitType, EventHandler, getUniqueID, INotifyPropertyChanged, select } from '@syncfusion/ej2-base';import { isNullOrUndefined, KeyboardEventArgs, KeyboardEvents, MouseEventArgs, NotifyPropertyChanges, Property, remove, removeClass } from '@syncfusion/ej2-base';import { Tooltip } from '@syncfusion/ej2-popups';
+import { addClass, Event, attributes, BaseEventArgs, compile, Component, EmitType, EventHandler, getUniqueID, INotifyPropertyChanged, select, Browser } from '@syncfusion/ej2-base';import { isNullOrUndefined, KeyboardEventArgs, KeyboardEvents, MouseEventArgs, NotifyPropertyChanges, Property, remove, removeClass } from '@syncfusion/ej2-base';import { Tooltip } from '@syncfusion/ej2-popups';
 import {LabelPosition,PrecisionType,RatingItemEventArgs,RatingHoverEventArgs,RatingChangedEventArgs} from "./rating";
 import {ComponentModel} from '@syncfusion/ej2-base';
 
@@ -8,60 +8,64 @@ import {ComponentModel} from '@syncfusion/ej2-base';
 export interface RatingModel extends ComponentModel{
 
     /**
-     * Defines whether to show or hide the reset button.
-     * If min is not zero, then reset button won’t be displayed regardless of allowReset value.
+     * Defines whether to show or hide the reset button in a rating component.
+     * When set to "true", the reset button will be visible to the user, and they will be able to click it to reset the rating value to its default value.
      *
      * @default false
      */
     allowReset?: boolean;
 
     /**
-     * Defines the CSS class to customize the rating appearance.
+     * Defines one or more CSS classes that can be used to customize the appearance of a rating component.
+     * One or more CSS classes to customize the appearance of the rating component, such as by changing its colors, fonts, sizes, or other visual aspects.
      *
      * @default ''
      */
     cssClass?: string;
 
     /**
-     * Defines whether the rating is enabled or disabled.
+     * Defines whether a rating component is enabled or disabled.
+     * A disabled rating component may have a different visual appearance than an enabled one.
+     * When set to "true", the rating component will be disabled, and the user will not be able to interact with it.
      *
      * @default false
      */
     disabled?: boolean;
 
     /**
-     * Defines whether to add animation when an item is hovered.
+     * Defines the template that defines the appearance of each un-rated item in a rating component.
      *
-     * @default true
+     * @default ''
      */
-    enableAnimation?: boolean;
+    emptyTemplate?: string;
 
     /**
-     * Defines the template content for each item when it is not selected.
-     * The template context will contain the current item value for customization.
+     * Defines whether to add animation (to provide visual feedback to the user) when an item in a rating component is hovered.
+     * When set to "true", an animation will be added when the user hovers their cursor over an item in the rating component.
      *
-     * @default ''
+     * @default true
      */
-    emptyTemplate?: string;
+    enableAnimation?: boolean;
 
     /**
-     * Defines whether to enable single selection like radio button or not.
-     * If not enabled all the items before the selected item will also be in the selected state.
+     * Defines whether to select all the items before the selected item should be in selected state in a rating component.
+     * When set to "true", only the selected item will be in the selected state, and all other items will be un-selected.
+     * When set to "false", all items before the selected one will be in the selected state.
      *
      * @default false
      */
     enableSingleSelection?: boolean;
 
     /**
-     * Defines the template content for each item when it is selected.
-     * The template context will contain the current item value for customization.
+     * Defines the template that defines the appearance of each rated item in a rating component.
      *
      * @default ''
      */
     fullTemplate?: string;
 
     /**
-     * Defines the number of rating items.
+     * Defines the specific number of items (symbols) in rating component.
+     * The rating component typically consists of a number of items, such as stars or other symbols, that represent the rating value.
      *
      * @default 5
      * @aspType int
@@ -69,11 +73,13 @@ export interface RatingModel extends ComponentModel{
     itemsCount?: number;
 
     /**
-     * Defines the position of the label in the rating.
-     * *Top
-     * *Bottom
-     * *Left
-     * *Right
+     * Defines the position of the label in rating component.
+     *
+     * The possible values are:
+     * * Top
+     * * Bottom
+     * * Left
+     * * Right
      *
      * @isenumeration true
      * @default LabelPosition.Right
@@ -82,15 +88,15 @@ export interface RatingModel extends ComponentModel{
     labelPosition?: string | LabelPosition;
 
     /**
-     * Defines the template content for the label.
-     * The template context will contain the current value and maximum value for customization.
+     * Defines the template that used as label over default label of the rating. The current value of rating passed as context to build the content.
      *
      * @default ''
      */
     labelTemplate?: string;
 
     /**
-     * Defines the minimum value of the rating.
+     * Defines the value that specifies minimum rating that a user can select.
+     * The value is set to 0, which means that the minimum possible rating is 0.
      *
      * @default 0.0
      * @aspType double
@@ -98,11 +104,14 @@ export interface RatingModel extends ComponentModel{
     min?: number;
 
     /**
-     * Defines the minimum increase in the value.
-     * *Full
-     * *Half
-     * *Quarter
-     * *Exact
+     * Defines the precision type of the rating which used to component the granularity of the rating,
+     * allowing users to provide ratings with varying levels of precision.
+     *
+     * The possible values are:
+     * * Full
+     * * Half
+     * * Quarter
+     * * Exact
      *
      * @isenumeration true
      * @default PrecisionType.Full
@@ -111,36 +120,42 @@ export interface RatingModel extends ComponentModel{
     precision?: string | PrecisionType;
 
     /**
-     * Defines whether the read only mode is enabled or not where interaction is disabled without any UI change.
+     * Defines a boolean value that specifies whether the read-only mode is enabled for a rating component,
+     * which prevents the user from modifying or interacting with the rating value but allows them to read it.
      *
      * @default false
      */
     readOnly?: boolean;
 
     /**
-     * Defines whether to show a label which display the current value.
+     * Defines a value that specifies whether to display a label that shows the current value of a rating.
+     * When set to "true", a label will be displayed that shows the current value of the rating; otherwise false.
      *
      * @default false
      */
     showLabel?: boolean;
 
     /**
-     * Defines whether to show tooltip for the items.
+     * Defines a value that defines whether to show tooltip for the items.
+     * When set to "true", show tooltip for the items.
      *
      * @default true
      */
     showTooltip?: boolean;
 
     /**
-     * Defines the template content for the tooltip.
-     * The template context will contain the current value for customization.
+     * Defines the template that used as tooltip content over default tooltip content of the rating.
+     * The current value of rating passed as context to build the content.
      *
      * @default ''
      */
     tooltipTemplate?: string;
 
     /**
-     * Defines the rating value.
+     * Defines the current rating value which used to display and update the rating selected by the user.
+     * Based on "PrecisionType", users can select ratings with varying levels of precision.
+     * The "value" is a decimal value that ranges from the minimum value to the items count,
+     * as specified by the "min" and "itemsCount" properties of the rating.
      *
      * @default 0.0
      * @aspType double
@@ -148,35 +163,36 @@ export interface RatingModel extends ComponentModel{
     value?: number;
 
     /**
-     * Defines whether the rating is visible or hidden.
+     * Defines a value that indicates whether the rating component is visible or hidden.
+     * When set to "true", if the rating component is visible.
      *
      * @default true
      */
     visible?: boolean;
 
     /**
-     * Event triggers before rendering each item.
+     * Event callback that is raised before rendering each item.
      *
      * @event beforeItemRender
      */
     beforeItemRender?: EmitType<RatingItemEventArgs>;
 
     /**
-     * Event triggers after the creation of Rating.
+     * Event callback that is raised after rendering the rating.
      *
      * @event created
      */
     created?: EmitType<Event>;
 
     /**
-     * Event triggers whenever a new item is hovered.
+     * Event callback that is raised when a user hovers over an item.
      *
      * @event onItemHover
      */
     onItemHover?: EmitType<RatingHoverEventArgs>;
 
     /**
-     * Event triggers whenever the value changes.
+     * Event callback that is raised when the value is changed.
      *
      * @event valueChanged
      */

package/src/rating/rating.d.ts

@@ -1,49 +1,50 @@
 import { BaseEventArgs, Component, EmitType, INotifyPropertyChanged } from '@syncfusion/ej2-base';
 import { RatingModel } from './rating-model';
 /**
- * Defines the position of the label in the rating.
+ * Defines where to position the label in rating
  */
 export declare enum LabelPosition {
     /**
-     * Shows the label above the rating.
+     * The label is positioned at the top center of the rating component.
      */
     Top = "Top",
     /**
-     * Shows the label below the rating.
+     * The label is positioned at the bottom center of the rating component.
      */
     Bottom = "Bottom",
     /**
-     * Shows the label to the left of rating.
+     * The label is positioned at the left side of the rating component.
      */
     Left = "Left",
     /**
-     * Shows the label to the right of rating.
+     * The label is positioned at the right side of the rating component.
      */
     Right = "Right"
 }
 /**
- * Defines the minimum increase in the value in Rating Control.
+ * Defines the precision type of the rating.
+ * It is used to component the granularity of the rating, allowing users to provide ratings with varying levels of precision.
  */
 export declare enum PrecisionType {
     /**
-     * Process the value as whole numbers.
+     * The rating is increased in whole number increments.
      */
     Full = "Full",
     /**
-     * Process the value in terms of 0.5 (half).
+     * The rating is increased in increments of 0.5 (half).
      */
     Half = "Half",
     /**
-     * Process the value in terms of 0.25 (quarter).
+     * The rating is increased in increments of 0.25 (quarter).
      */
     Quarter = "Quarter",
     /**
-     * Process the value in terms of 0.1.
+     * The rating is increased in increments of 0.1.
      */
     Exact = "Exact"
 }
 /**
- * Event triggers whenever the value changes.
+ * Provides information about valueChanged event callback
  */
 export interface RatingChangedEventArgs extends BaseEventArgs {
     /**
@@ -64,11 +65,11 @@ export interface RatingChangedEventArgs extends BaseEventArgs {
     value: number;
 }
 /**
- * Event triggers whenever a new item is hovered.
+ * Provides information about onItemHover event callback.
  */
 export interface RatingHoverEventArgs extends BaseEventArgs {
     /**
-     * Provides the hovered item element.
+     * Provides the rating item element reference.
      */
     element: HTMLElement;
     /**
@@ -76,16 +77,16 @@ export interface RatingHoverEventArgs extends BaseEventArgs {
      */
     event: Event;
     /**
-     * Provides the current value of the hovered item.
+     * Provides the hover value at hovered point of rating.
      */
     value: number;
 }
 /**
- * Event triggers before rendering each item.
+ * Provides information about beforeItemRender event callback.
  */
 export interface RatingItemEventArgs extends BaseEventArgs {
     /**
-     * Html element of the current item to be rendered.
+     * Provides the rating item element reference.
      */
     element: HTMLElement;
     /**
@@ -93,66 +94,86 @@ export interface RatingItemEventArgs extends BaseEventArgs {
      */
     value: number;
 }
+/**
+ * The Rating component allows the user to rate something by clicking on a set of symbols on a numeric scale.
+ * This allows users to provide feedback or ratings for products, services, or content.
+ *
+ * ```html
+ * <input id="rating">
+ * ```
+ * ```typescript
+ * <script>
+ *   let ratingObj: Rating = new Rating();
+ *   ratingObj.appendTo('#rating');
+ * </script>
+ * ```
+ */
 export declare class Rating extends Component<HTMLElement> implements INotifyPropertyChanged {
     /**
-     * Defines whether to show or hide the reset button.
-     * If min is not zero, then reset button won’t be displayed regardless of allowReset value.
+     * Defines whether to show or hide the reset button in a rating component.
+     * When set to "true", the reset button will be visible to the user, and they will be able to click it to reset the rating value to its default value.
      *
      * @default false
      */
     allowReset: boolean;
     /**
-     * Defines the CSS class to customize the rating appearance.
+     * Defines one or more CSS classes that can be used to customize the appearance of a rating component.
+     * One or more CSS classes to customize the appearance of the rating component, such as by changing its colors, fonts, sizes, or other visual aspects.
      *
      * @default ''
      */
     cssClass: string;
     /**
-     * Defines whether the rating is enabled or disabled.
+     * Defines whether a rating component is enabled or disabled.
+     * A disabled rating component may have a different visual appearance than an enabled one.
+     * When set to "true", the rating component will be disabled, and the user will not be able to interact with it.
      *
      * @default false
      */
     disabled: boolean;
     /**
-     * Defines whether to add animation when an item is hovered.
+     * Defines the template that defines the appearance of each un-rated item in a rating component.
      *
-     * @default true
+     * @default ''
      */
-    enableAnimation: boolean;
+    emptyTemplate: string;
     /**
-     * Defines the template content for each item when it is not selected.
-     * The template context will contain the current item value for customization.
+     * Defines whether to add animation (to provide visual feedback to the user) when an item in a rating component is hovered.
+     * When set to "true", an animation will be added when the user hovers their cursor over an item in the rating component.
      *
-     * @default ''
+     * @default true
      */
-    emptyTemplate: string;
+    enableAnimation: boolean;
     /**
-     * Defines whether to enable single selection like radio button or not.
-     * If not enabled all the items before the selected item will also be in the selected state.
+     * Defines whether to select all the items before the selected item should be in selected state in a rating component.
+     * When set to "true", only the selected item will be in the selected state, and all other items will be un-selected.
+     * When set to "false", all items before the selected one will be in the selected state.
      *
      * @default false
      */
     enableSingleSelection: boolean;
     /**
-     * Defines the template content for each item when it is selected.
-     * The template context will contain the current item value for customization.
+     * Defines the template that defines the appearance of each rated item in a rating component.
      *
      * @default ''
      */
     fullTemplate: string;
     /**
-     * Defines the number of rating items.
+     * Defines the specific number of items (symbols) in rating component.
+     * The rating component typically consists of a number of items, such as stars or other symbols, that represent the rating value.
      *
      * @default 5
      * @aspType int
      */
     itemsCount: number;
     /**
-     * Defines the position of the label in the rating.
-     * *Top
-     * *Bottom
-     * *Left
-     * *Right
+     * Defines the position of the label in rating component.
+     *
+     * The possible values are:
+     * * Top
+     * * Bottom
+     * * Left
+     * * Right
      *
      * @isenumeration true
      * @default LabelPosition.Right
@@ -160,25 +181,28 @@ export declare class Rating extends Component<HTMLElement> implements INotifyPro
      */
     labelPosition: string | LabelPosition;
     /**
-     * Defines the template content for the label.
-     * The template context will contain the current value and maximum value for customization.
+     * Defines the template that used as label over default label of the rating. The current value of rating passed as context to build the content.
      *
      * @default ''
      */
     labelTemplate: string;
     /**
-     * Defines the minimum value of the rating.
+     * Defines the value that specifies minimum rating that a user can select.
+     * The value is set to 0, which means that the minimum possible rating is 0.
      *
      * @default 0.0
      * @aspType double
      */
     min: number;
     /**
-     * Defines the minimum increase in the value.
-     * *Full
-     * *Half
-     * *Quarter
-     * *Exact
+     * Defines the precision type of the rating which used to component the granularity of the rating,
+     * allowing users to provide ratings with varying levels of precision.
+     *
+     * The possible values are:
+     * * Full
+     * * Half
+     * * Quarter
+     * * Exact
      *
      * @isenumeration true
      * @default PrecisionType.Full
@@ -186,63 +210,70 @@ export declare class Rating extends Component<HTMLElement> implements INotifyPro
      */
     precision: string | PrecisionType;
     /**
-     * Defines whether the read only mode is enabled or not where interaction is disabled without any UI change.
+     * Defines a boolean value that specifies whether the read-only mode is enabled for a rating component,
+     * which prevents the user from modifying or interacting with the rating value but allows them to read it.
      *
      * @default false
      */
     readOnly: boolean;
     /**
-     * Defines whether to show a label which display the current value.
+     * Defines a value that specifies whether to display a label that shows the current value of a rating.
+     * When set to "true", a label will be displayed that shows the current value of the rating; otherwise false.
      *
      * @default false
      */
     showLabel: boolean;
     /**
-     * Defines whether to show tooltip for the items.
+     * Defines a value that defines whether to show tooltip for the items.
+     * When set to "true", show tooltip for the items.
      *
      * @default true
      */
     showTooltip: boolean;
     /**
-     * Defines the template content for the tooltip.
-     * The template context will contain the current value for customization.
+     * Defines the template that used as tooltip content over default tooltip content of the rating.
+     * The current value of rating passed as context to build the content.
      *
      * @default ''
      */
     tooltipTemplate: string;
     /**
-     * Defines the rating value.
+     * Defines the current rating value which used to display and update the rating selected by the user.
+     * Based on "PrecisionType", users can select ratings with varying levels of precision.
+     * The "value" is a decimal value that ranges from the minimum value to the items count,
+     * as specified by the "min" and "itemsCount" properties of the rating.
      *
      * @default 0.0
      * @aspType double
      */
     value: number;
     /**
-     * Defines whether the rating is visible or hidden.
+     * Defines a value that indicates whether the rating component is visible or hidden.
+     * When set to "true", if the rating component is visible.
      *
      * @default true
      */
     visible: boolean;
     /**
-     * Event triggers before rendering each item.
+     * Event callback that is raised before rendering each item.
      *
      * @event beforeItemRender
      */
     beforeItemRender: EmitType<RatingItemEventArgs>;
     /**
-     * Event triggers after the creation of Rating.
+     * Event callback that is raised after rendering the rating.
      *
      * @event created
      */
     created: EmitType<Event>;
     /**
-     * Event triggers whenever a new item is hovered.
+     * Event callback that is raised when a user hovers over an item.
      *
      * @event onItemHover
      */
     onItemHover: EmitType<RatingHoverEventArgs>;
     /**
-     * Event triggers whenever the value changes.
+     * Event callback that is raised when the value is changed.
      *
      * @event valueChanged
      */
@@ -294,6 +325,7 @@ export declare class Rating extends Component<HTMLElement> implements INotifyPro
     private clearLabelPosition;
     private wireItemsEvents;
     private clickHandler;
+    private updateValueChange;
     private triggerChange;
     private mouseMoveHandler;
     private openRatingTooltip;