@syncfusion/ej2-angular-treegrid 28.2.6-ngcc → 29.1.33-ngcc

package/src/treegrid/aggregate-columns.directive.d.ts

@@ -22,56 +22,54 @@ export declare class AggregateColumnDirective extends ComplexBase<AggregateColum
     private viewContainerRef;
     directivePropList: any;
     /**
-     * Defines the aggregate type of a particular column.
-     * To use multiple aggregates for single column, specify the `type` as array.
-     * Types of aggregate are,
-     * * sum
-     * * average
-     * * max
-     * * min
-     * * count
-     * * falsecount
-     * * truecount
-     * * custom
-     * > Specify the `type` value as `custom` to use custom aggregation.
+     * Defines the aggregate type(s) for a particular column.
+     * To apply multiple aggregates to a single column, specify the `type` as an array.
+     * Available aggregate types include:
+     * * `sum`: Calculates the sum of all values in a column.
+     * * `average`: Computes the average of the column values.
+     * * `max`: Finds the maximum value in a column.
+     * * `min`: Finds the minimum value in a column.
+     * * `count`: Counts the number of records.
+     * * `falsecount`: Counts the number of false values.
+     * * `truecount`: Counts the number of true values.
+     * * `custom`: Allows for a custom aggregate function.
+     *
+     * Use `custom` to specify a custom aggregation.
+     *
      * @asptype string
      * @default null
      */
     type: any;
     /**
-     * Defines the column name to display the aggregate value. If `columnName` is not defined,
-     * then `field` name value will be assigned to the `columnName` property.
+     * Specifies the column name to display the aggregate value. If not defined, the `field` name is used by default.
      * @default null
      */
     columnName: any;
     /**
-     * Defines a function to calculate custom aggregate value. The `type` value should be set to `custom`.
-     * To use custom aggregate value in the template, use the key as `${custom}`.
-     * **Total aggregation**: The custom function will be called with the whole data and the current `AggregateColumn` object.
-     * **Group aggregation**: This will be called with the current group details and the `AggregateColumn` object.
+     * Defines a custom function to calculate the aggregate value. The `type` must be set to `custom`.
+     * Use the custom value as `${custom}` in templates.
+     * * `Total aggregation`: The custom function is called with the entire dataset and the current `AggregateColumn` object.
+     * * `Group aggregation`: It is called with the current group details and the `AggregateColumn` object.
      * @default null
      */
     customAggregate: any;
     /**
-     * Defines the column name to perform aggregation.
+     * Specifies the column name on which to perform the aggregation.
      * @default null
      */
     field: any;
     /**
-     * Format is applied to a calculated value before it is displayed.
-     * Gets the format from the user, which can be standard or custom
-     * [`number`](https://ej2.syncfusion.com/documentation/common/internationalization/#supported-format-string)
-     * and [`date`](https://ej2.syncfusion.com/documentation/common/internationalization/#supported-format-string-1) formats.
+     * Specifies the format to be applied to the calculated aggregate value before display.
+     * Supports both standard and custom formats for numbers and dates.
+     * Refer to the Syncfusion documentation for [number](https://ej2.syncfusion.com/documentation/common/internationalization/#supported-format-string)
+     * and [date](https://ej2.syncfusion.com/documentation/common/internationalization#date-formatting) formats.
      * @asptype string
      * @default null
      */
     format: any;
     /**
-     * Defines the footer cell template as a string for the aggregate column.
-     * The `type` name should be used to access aggregate values inside the template.
-     *
-     * {% codeBlock src="grid/footer-template-api/index.ts" %}{% endcodeBlock %}
-     *
+     * Defines a template for the footer cell of the aggregate column.
+     * Use the aggregate `type` names within the template to access aggregate values.
      * @default null
      * @asptype string
 

package/src/treegrid/aggregates.directive.d.ts

@@ -25,12 +25,12 @@ export declare class AggregateDirective extends ComplexBase<AggregateDirective>
     childColumns: any;
     tags: string[];
     /**
-     * Configures the aggregate columns.
+     * Configures the collection of aggregate columns.
      * @default []
      */
     columns: any;
     /**
-     * Display the childSummary for each parent.
+     * Determines whether to display child summaries for each parent row.
      */
     showChildSummary: any;
     constructor(viewContainerRef: ViewContainerRef);

package/src/treegrid/columns.directive.d.ts

@@ -18,60 +18,53 @@ export declare class ColumnDirective extends ComplexBase<ColumnDirective> {
     childColumns: any;
     tags: string[];
     /**
-     * Defines the data type of the column.
+     * Defines the type of data stored in the column, which may be string, number, date, or other types.
      * @default null
      */
     type: any;
     /**
-     * If `allowEditing` set to false, then it disables editing of a particular column.
-     * By default all columns are editable.
+     * Controls whether editing is permitted for the column. By default, all columns are editable.
      * @default true
      */
     allowEditing: any;
     /**
-     * If `allowFiltering` set to false, then it disables filtering option and filter bar element of a particular column.
-     * By default all columns are filterable.
+     * Controls whether the column supports filtering. If set to false, users cannot filter data by this column.
      * @default true
      */
     allowFiltering: any;
     /**
-     * If `allowReordering` set to false, then it disables reorder of a particular column.
-     * By default all columns can be reorder.
+     * Enables or disables the reordering of this column via drag-and-drop. Allows for dynamic column adjustments.
      * @default true
      */
     allowReordering: any;
     /**
-     * If `allowResizing` set to false, it disables resize option of a particular column.
+     * Determines if this column can be resized. If false, the column size is fixed.
      * @default true
      */
     allowResizing: any;
     /**
-     * If `allowSorting` set to false, then it disables sorting option of a particular column.
-     * By default all columns are sortable.
+     * Specifies whether sorting is enabled for this column. Set to false to prevent sort actions.
      * @default true
      */
     allowSorting: any;
     /**
-     * Defines the cell content's overflow mode. The available modes are
-     *
-     * also it will display tooltip while hover on ellipsis applied cell.
+     * Determines how overflow content is handled within a cell. Options include:
+     * * `Clip`: Truncates the content.
+     * * `Ellipsis`: Shows ellipsis for overflow.
+     * * `EllipsisWithTooltip`: Shows ellipsis and tooltip on hover.
      * @default Syncfusion.EJ2.Grids.ClipMode.Ellipsis
      * @isenumeration true
      * @asptype Syncfusion.EJ2.Grids.ClipMode
      */
     clipMode: any;
     /**
-     * Used to render multiple header rows(stacked headers) on TreeGrid header.
+     * Allows for the creation of stacked headers by using multiple rows in the grid's header.
      * @default null
      */
     columns: any;
     /**
-     * `commands` provides an option to display command buttons in every cell.
-     * The available built-in command buttons are
-     * * Edit - Edit the record.
-     * * Delete - Delete the record.
-     * * Save - Save the record.
-     * * Cancel - Cancel the edit state.
+     * Provides built-in command button options for cells. Options include Edit, Delete, Save, and Cancel.
+     * Custom command button implementations are possible.
      *
      * The following code example implements the custom command column.
      *```html
@@ -98,53 +91,49 @@ export declare class ColumnDirective extends ComplexBase<ColumnDirective> {
      */
     commands: any;
     /**
-     * The CSS styles and attributes of the content cells of a particular column can be customized.
+     * Enables the addition of CSS styles and attributes for the content cells in a particular column.
      * @default null
      */
     customAttributes: any;
     /**
-     * Defines default values for the component when adding a new record to the TreeGrid.
+     * Sets default values when new records are added to the TreeGrid involving this column.
      * @default null
      */
     defaultValue: any;
     /**
-     * If `disableHtmlEncode` is set to true, it encodes the HTML of the header and content cells.
+     * If set to `true`, the HTML content within header and content cells is encoded to prevent injection attacks.
      * @default true
      */
     disableHtmlEncode: any;
     /**
-     * If `displayAsCheckBox` is set to true, it displays the column value as a check box instead of Boolean value.
+     * Displays the column value as a checkbox instead of a Boolean value when set to `true`.
      * @default false
      */
     displayAsCheckBox: any;
     /**
-     * Defines the `IEditCell` object to customize default edit cell.
+     * Allows customizing the default edit cell through the `IEditCell` object for more control over editing.
      * @default {}
      */
     edit: any;
     /**
-     * Defines the type of component for editing.
+     * Specifies the component type used for editing cells within this column.
      * @default 'stringedit'
      */
     editType: any;
     /**
-     * Defines the field name of column which is mapped with mapping name of DataSource.
-     * The bounded columns can be sort, filter etc.,
-     * The `field` name must be a valid JavaScript identifier,
-     * the first character must be an alphabet and should not contain spaces and special characters.
+     * Specifies the field name in the data source to which the column is bound. This field is used for operations like sorting and filtering.
+     * The field name must be a valid JavaScript identifier, beginning with a letter and avoiding spaces and special characters.
      * @default 'undefined'
      */
     field: any;
     /**
-     *  Defines the filter options to customize filtering for the particular column.
+     * Customizes filter options for the column, enabling specialized filtering functionality.
      * @default null
      */
     filter: any;
     /**
-     * The `filterBarTemplate` is used to add a custom component instead of default input component for filter bar.
-     * It have create and read functions.
-     * * create: It is used for creating custom components.
-     * * read: It is used to perform custom filter action.
+     * Allows for a custom component within the filter bar, facilitating advanced filter interfaces.
+     * Includes create and read functions for custom component management.
      *
      * ```html
      *<div id="TreeGrid"></div>
@@ -169,7 +158,7 @@ export declare class ColumnDirective extends ComplexBase<ColumnDirective> {
      *            gridObj.filterByColumn(args.element.id, 'equal', args.element.value);
      *       }
      *    }
-     * }],
+     *}],
      *  allowFiltering: true
      *});
      *gridObj.appendTo('#TreeGrid');
@@ -179,35 +168,33 @@ export declare class ColumnDirective extends ComplexBase<ColumnDirective> {
      */
     filterBarTemplate: any;
     /**
-     * It is used to change display value with the given format and does not affect the original data.
-     * Gets the format from the user which can be standard or custom
-     * [`number`](https://ej2.syncfusion.com/documentation/common/internationalization/#supported-format-string)
-     * and [`date`](https://ej2.syncfusion.com/documentation/common/internationalization/#supported-format-string-1) formats.
+     * Formats the displayed value of the column without affecting the underlying data. Supports standard and custom formats for numbers and dates.
+     *
+     * References for [number](https://ej2.syncfusion.com/documentation/common/internationalization/#supported-format-string)
+     *and [date](https://ej2.syncfusion.com/documentation/common/internationalization#date-formatting) formats.
      * @default null
      * @asptype string
      */
     format: any;
     /**
-     * Defines the method which is used to achieve custom formatting from an external function.
-     * This function triggers before rendering of each cell.
+     * Allows for custom cell content formatting using an external method, executed prior to rendering.
      * @default null
      */
     formatter: any;
     /**
-     * Defines which side the column need to freeze
+     * Determines which side (left, right, or center) the column should be frozen on.
      * @default Syncfusion.EJ2.Grids.FreezeDirection.None
      * @isenumeration true
      * @asptype Syncfusion.EJ2.Grids.FreezeDirection
      */
     freeze: any;
     /**
-     * Defines the header text of column which is used to display in column header.
-     * If `headerText` is not defined, then field name value will be assigned to header text.
+     * Specifies the text displayed in the column header. If omitted, the `field` value is used as the header text.
      * @default 'undefined'
      */
     headerText: any;
     /**
-     * Define the alignment of column header which is used to align the text of column header.
+     * Aligns the text in the column header. By default, the alignment corresponds to other content alignments.
      * @default null
      * @aspdefaultvalueignore
      * @isenumeration true
@@ -215,120 +202,113 @@ export declare class ColumnDirective extends ComplexBase<ColumnDirective> {
      */
     headerTextAlign: any;
     /**
-     * Column visibility can change based on [`Media Queries`](http://cssmediaqueries.com/what-are-css-media-queries.html).
-     * `hideAtMedia` accepts only valid Media Queries.
+     * Adjusts column visibility based on [Media Queries](http://cssmediaqueries.com/what-are-css-media-queries.html). Accepts valid CSS media query strings for responsive adjustments.
      * @default 'undefined'
      */
     hideAtMedia: any;
     /**
-     * You can use this property to freeze selected columns in grid.
+     * Allows the column to be frozen, keeping it stationary while scrolling horizontally through the grid.
      * @default false
      */
     isFrozen: any;
     /**
-     * If `isIdentity` is set to true, then this column is considered as identity column.
+     * Identifies the column as an identity column in database terms, if set to `true`.
      * @default false
      */
     isIdentity: any;
     /**
-     * If `isPrimaryKey` is set to true, considers this column as the primary key constraint.
+     * Identifies the column as a primary key if set to `true`, enforcing uniqueness.
      * @default false
      */
     isPrimaryKey: any;
     /**
-     * If `lockColumn` set to true, then it disables Reordering of a particular column.
-     * The locked column will be moved to first position.
+     * Prevents column reordering when set to true, locking the column into a set position.
      * @default false
      */
     lockColumn: any;
     /**
-     * Defines the maximum width of the column in pixels or percentage, which will restrict resizing beyond this pixels or percentage.
+     * Defines the maximum allowable width of the column in pixels or as a percentage, preventing resizing beyond this limit.
      * @default 'undefined'
      */
     maxWidth: any;
     /**
-     * Defines the minimum width of the column in pixels or percentage.
+     * Determines the minimum width of the column in pixels or percentage. This ensures the column does not shrink below this size.
      * @default 'undefined'
      */
     minWidth: any;
     /**
-     * If `showCheckbox` set to true, then the checkboxes will be displayed in particular column.
+     * Displays checkboxes in the column when enabled, allowing for selections and certain operations.
      * @default false
      */
     showCheckbox: any;
     /**
-     * If `showColumnMenu` set to false, then it disable the column menu of a particular column.
-     * By default column menu will show for all columns
+     * Decides if the column menu should be available, providing options for column customization.
      * @default true
      */
     showColumnMenu: any;
     /**
-     * If `showInColumnChooser` set to false, then hide the particular column in column chooser.
-     *  By default all columns are displayed in column Chooser.
+     * Determines whether the column should appear in the Column Chooser. Set to false to exclude it.
      * @default true
      */
     showInColumnChooser: any;
     /**
-     * Defines the sort comparer property.
+     * Provides a custom sort comparer property to control how sorting is handled for this column's data.
      * @default 'undefined'
      */
     sortComparer: any;
     /**
-     * Defines the alignment of the column in both header and content cells.
+     * Specifies the horizontal alignment for the column content and header. Options include alignment to the left, center, or right.
      * @default Syncfusion.EJ2.Grids.TextAlign.Left
      * @isenumeration true
      * @asptype Syncfusion.EJ2.Grids.TextAlign
      */
     textAlign: any;
     /**
-     * Gets the unique identifier value of the column. It is used to get the object.
+     * Retrieves the unique identifier for the column. This UID is used internally to reference and manipulate the column.
      * @default 'undefined'
      */
     uid: any;
     /**
-     * Defines rules to validate data before creating and updating.
+     * Establishes validation rules to ensure data integrity during creation and updates.
      * @default null
      */
     validationRules: any;
     /**
-     * Defines the method used to apply custom cell values from external function and display this on each cell rendered.
+     * Applies custom cell values using an external function, allowing for dynamic display adjustments.
      * @default null
      */
     valueAccessor: any;
     /**
-     * If `visible` is set to false, hides the particular column. By default, columns are displayed.
+     * Toggles the visibility of the column. Set to false to hide the column from view. Columns are visible by default.
      * @default true
      */
     visible: any;
     /**
-     * Defines the width of the column in pixels or percentage.
+     * Sets the column's width in pixels or as a percentage. This defines how the column will occupy space in the grid.
      * @default 'undefined'
      */
     width: any;
     /**
-     * Defines the column template that renders customized element in each cell of the column.
-     * It accepts either [template string](https://ej2.syncfusion.com/documentation/common/template-engine/) or HTML element ID.
+     * Customizes the rendering of cell content using either a template string or HTML element ID.
      * @default null
      * @asptype string
      */
     template: any;
     /**
-     * Defines the header template as string or HTML element ID which is used to add customized element in the column header.
+     * Customizes the header content with a template, defined as a string or an HTML element ID.
      * @default null
      * @asptype string
      */
     headerTemplate: any;
     filter_itemTemplate: any;
     /**
-     * Defines the filter template/UI that is used as filter for a particular column.
-     * It accepts either template string or HTML element ID.
+     * Specifies a custom template or UI for filtering within this column, utilizing either string templates or HTML element IDs.
      * @aspignore
      */
     filterTemplate: any;
     commandsTemplate: any;
     /**
-     * Defines the cell edit template that used as editor for a particular column.
-     * It accepts either template string or HTML element ID.
+     * Provides a template for editing cells in this column, supporting either a template string or an HTML element ID.
      * @aspignore
      */
     editTemplate: any;