@syncfusion/ej2-angular-treegrid 28.2.6 → 29.1.33

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

@@ -19,60 +19,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
@@ -99,53 +92,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>
@@ -170,7 +159,7 @@ export declare class ColumnDirective extends ComplexBase<ColumnDirective> {
      *            gridObj.filterByColumn(args.element.id, 'equal', args.element.value);
      *       }
      *    }
-     * }],
+     *}],
      *  allowFiltering: true
      *});
      *gridObj.appendTo('#TreeGrid');
@@ -180,35 +169,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
@@ -216,120 +203,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;