CardView Properties

Name	Type	Default	Description
AddNewButton	bool	false	Controls the visibility and functionality of the button used to add new cards to the interface. When enabled, users can click the button to create and add additional cards; when disabled, the button is hidden or inactive, preventing new card additions.
AllowDrag	bool	false	Enables users to rearrange the order of cards within the interface by clicking and dragging individual cards to new positions. This drag-and-drop functionality provides an intuitive way to customize the card sequence.
CardHeight	int?	N/A	Specifies the height value assigned to each card component, determining how tall each card will appear within the user interface.
CellOrientation	Orientation	Orientation.Vertical	Specifies the layout direction of the card cells, determining whether they are arranged horizontally (side by side) or vertically (stacked one above the other) within the container. This setting controls the visual organization of the cards.
Collapsible	bool	false	Enables users to expand or collapse the card’s content, allowing for a more compact view when the content is hidden and revealing additional details when expanded.
Columns	IEnumerable<ICardViewColumn>	N/A	Specifies the configuration properties for table columns: label — Defines the display name or header text for the column as shown in the user interface. dataField — Specifies the key or property name in the data source that this column should display. icon — Allows you to assign an icon (e.g., as a URL or icon class) to be displayed in the column header or alongside cell values. formatSettings — Provides formatting options for the column's values, such as date/time formats, number precision, or custom display rules. formatFunction — Accepts a callback function to apply custom transformations or styling to the column's cell values before rendering.
CoverField	string	""""	Specifies the data field that should be used as the cover image or primary visual representation for the item.
CoverMode	CardViewCoverMode	CardViewCoverMode.Crop	Provides detailed information about the 'cover image fit' property, which defines how a cover image is resized or scaled to fit within its container. This property determines whether the image should fill, contain, cover, or be otherwise adjusted to cover the allotted space, often corresponding to CSS 'object-fit' values such as 'cover', 'contain', or 'fill'.
DataSource	object	N/A	Specifies the origin or endpoint from which the item's data is retrieved for display within the card component. This property defines where the card fetches its content, such as a local data object, a remote API, or a database, ensuring the card displays up-to-date and relevant information.
DataSourceSettings	DataSourceSettings	N/A	Configures the grid's data source options, specifying how data should be loaded and managed when the dataSource property is assigned either an array of data objects or a remote data endpoint (URL). This includes settings for data retrieval, formatting, paging, sorting, and other data-related behaviors.
Editable	bool	false	Enables the functionality for users to edit the content of individual cards. When this option is active, users can modify card details such as titles, descriptions, and other editable fields directly within the card interface.
HeaderPosition	CardViewHeaderPosition	CardViewHeaderPosition.None	Sets or retrieves the position of the header section within the component. The header typically includes interactive elements such as the Customize, Filter, Sort, and Search buttons, allowing users to tailor the content display, apply filters, change sorting options, and perform searches.
UnlockKey	string	""	Sets or retrieves the unlockKey value, a unique key required to unlock and gain access to the product's full features or content. Use this property to assign a new unlock key or to obtain the current key in use.
Locale	string	"en"	Sets or retrieves the current locale (language and regional settings) to be used by the component. This is typically used together with the messages property, which provides localized text or translations for different locales. By specifying the locale, the component displays messages, labels, and other text elements in the appropriate language and format.
Messages	object	N/A	Defines or retrieves an object containing the text strings displayed by the widget, allowing these strings to be customized for different languages. This property works in conjunction with the locale property to enable localization, so you can provide translations for various UI elements based on the user's selected language or region. Use this option to specify or override default widget labels and messages for internationalization purposes.
RightToLeft	bool	false	Determines or retrieves whether the element’s text direction is set to right-to-left (RTL), allowing proper alignment and rendering for languages and locales that use RTL scripts (such as Arabic or Hebrew). This ensures the element displays content correctly for users in RTL language environments.
Theme	string	""	Specifies the theme to be applied to the element. The selected theme controls the overall visual appearance, including colors, fonts, spacing, and style variations, ensuring a consistent and cohesive look for the element within the user interface.
Scrolling	Scrolling	Scrolling.Physical	Provides detailed configuration for how the element responds to user scrolling actions, specifying whether content scrolls automatically, remains stationary, or follows other predefined scrolling behaviors.
TitleField	string	""	Specifies the data field that should be used as the title, typically for labeling or displaying the main identifier of an item.

CardView Methods

Name	Type	Arguments	Description
AddFilter	void	string[] filters, string operatorArg	Enables advanced filtering functionality, allowing users to refine and display data based on specific criteria such as category, date range, status, or custom attributes. This feature improves data navigation and helps users quickly locate relevant information.Args: string[] filters - Filter information,string operator - Logical operator between the filters of different fields
AddFilter	void	string[] filters	Enables advanced filtering functionality, allowing users to refine and display data based on specific criteria such as category, date range, status, or custom attributes. This feature improves data navigation and helps users quickly locate relevant information.
AddRecord	void	object recordId, object data, string position	Creates and inserts a new record into the database or data collection, initializing all required fields with the provided values.Args: object recordId - The id of the record to add,object data - The data of the record to add,string position - The position to add the record to. Possible values: 'first' and 'last'.
AddRecord	void	N/A	Creates and inserts a new record into the database or data collection, initializing all required fields with the provided values.
AddSort	void	IEnumerable<object> dataFields, IEnumerable<object> orderBy	Enables sorting functionality, allowing users to arrange data in ascending or descending order based on specified fields or columns. This feature enhances the user experience by making it easier to organize, locate, and analyze information within lists or tables.Args: string dataFields - The data field(s) to sort by,IEnumerable<object> orderBy - The sort direction(s) to sort the data field(s) by
AddSort	void	string dataFields, string orderBy	Enables sorting functionality, allowing users to arrange data in ascending or descending order based on specified fields or columns. This feature enhances the user experience by making it easier to organize, locate, and analyze information within lists or tables.Args: string dataFields - The data field(s) to sort by,string orderBy - The sort direction(s) to sort the data field(s) by
BeginEdit	void	object recordId	Initiates an edit transaction, allowing changes to be made to the data. This operation typically marks the start of a sequence where modifications can be performed, and may require committing or canceling the changes to finalize or discard the edits.Args: object recordId - The id of the record to edit
BeginEdit	void	int recordId	Initiates an edit transaction, allowing changes to be made to the data. This operation typically marks the start of a sequence where modifications can be performed, and may require committing or canceling the changes to finalize or discard the edits.Args: int recordId - The id of the record to edit
BeginEdit	void	string recordId	Initiates an edit transaction, allowing changes to be made to the data. This operation typically marks the start of a sequence where modifications can be performed, and may require committing or canceling the changes to finalize or discard the edits.Args: string recordId - The id of the record to edit
CancelEdit	void	N/A	Terminates the ongoing edit session and reverts any unsaved changes, ensuring that all modifications made during the current operation are discarded and the original state is restored.
ClosePanel	void	N/A	Closes any currently open header panel, such as a dropdown menu or navigation panel, ensuring that all header-related overlays are hidden from view.
EndEdit	void	N/A	Finalizes the current editing session by committing all modifications made and persisting the changes to the data source or storage.
EnsureVisible	object	object recordId	Ensures that a specified record is brought into view by automatically scrolling to its position on the page. If the operation is successful, the method returns the HTML element representing the card associated with that record, allowing for further manipulation or interaction within the DOM.Args: object recordId - The id of the record to scroll to
EnsureVisible	object	int recordId	Ensures that a specified record is brought into view by automatically scrolling to its position on the page. If the operation is successful, the method returns the HTML element representing the card associated with that record, allowing for further manipulation or interaction within the DOM.Args: int recordId - The id of the record to scroll to
EnsureVisible	object	string recordId	Ensures that a specified record is brought into view by automatically scrolling to its position on the page. If the operation is successful, the method returns the HTML element representing the card associated with that record, allowing for further manipulation or interaction within the DOM.Args: string recordId - The id of the record to scroll to
GetDataSourceAsync()	Task<IEnumerable<object>>	'N/A'	Gets the &quot;DataSource&quot; property as Task&lt;IEnumerable&lt;object&gt;&gt;.
OpenCustomizePanel	void	N/A	Opens the "Customize Cards" dropdown panel, allowing users to access and modify card display settings.
OpenFilterPanel	void	N/A	Displays the "Filter" header panel as a drop-down menu, allowing users to view and select filtering options for the current data set.
OpenSortPanel	void	N/A	Displays the "Sort" header panel as a dropdown menu, allowing users to select sorting options for the current data view.
Refresh	void	'N/A'	Refreshes the Blazor Component. Performs a layout of the HTML Elements and recalculates the measurements.
RemoveFilter	void	N/A	Removes any active filters, displaying the full, unfiltered dataset.
RemoveRecord	void	object recordId	Deletes a specific record from the database or data collection, permanently removing all associated data for that entry.Args: object recordId - The id of the record to remove
RemoveRecord	void	int recordId	Deletes a specific record from the database or data collection, permanently removing all associated data for that entry.Args: int recordId - The id of the record to remove
RemoveRecord	void	string recordId	Deletes a specific record from the database or data collection, permanently removing all associated data for that entry.Args: string recordId - The id of the record to remove
RemoveSort	void	N/A	Disables any active sorting on the data, reverting the items to their original order.
Render	void	'N/A'	Re-renders the Blazor Component. This method will make a full re-render.
SetFilter	void	string dataField, string filter	Enhances and applies custom filter criteria to a specific column within the cardview. Accepts both single and multiple filter expressions, allowing for complex filtering logic using logical operators such as "and" and "or". For example, to filter the "lastName" column for values that contain either "burke" or "peterson", use: `cardview.setFilter('lastName', ['CONTAINS "burke"', 'or', 'CONTAINS "peterson"'])`. The method also supports numeric filters (e.g., `GREATER_THAN 100`), a variety of comparison operators (such as `EQUALS`, `LESS_THAN`, `STARTS_WITH`, etc.), and can be used to combine different conditions for precise data selection.Args: string dataField - The data field name of the column to filter, e.g., 'firstName'.,string filter - The filter expression(s) to apply. Examples include 'startsWith B', ['contains Andrew or contains Nancy'], or ['quantity', '<= 3 and >= 8']. Supported operators: '=', 'EQUAL', '<>', 'NOT_EQUAL', '!=', '<', 'LESS_THAN', '>', 'GREATER_THAN', '<=', 'LESS_THAN_OR_EQUAL', '>=', 'GREATER_THAN_OR_EQUAL', 'starts with', 'STARTS_WITH', 'ends with', 'ENDS_WITH', '', 'EMPTY', 'CONTAINS', 'DOES_NOT_CONTAIN', 'NULL', 'NOT_NULL'.
SetLocale	void	string locale, object messages	Sets the locale of a component.Args: string locale - The locale abbreviation. For example: 'de'.,object messages - Object containing the locale messages.
SetLocale	void	string locale	Sets the locale of a component.
ShowColumn	void	string dataField	Displays a single vertical column within the layout, typically used to organize content or interface elements in a structured manner. This column can contain text, images, or other components, and its appearance (such as width, alignment, and styling) can be customized through additional properties or CSS classes.Args: string dataField - The data field of the column
SortBy	void	string dataField, string sortOrder	Applies sorting to the CardView based on the specified data field. You can either add sorting by providing a valid sortOrder (such as 'asc' or 'desc'), or remove sorting from a column by setting the sortOrder parameter to null. This allows dynamic adjustment of CardView sorting criteria, enabling users to sort data as needed or clear sorting on individual columns.Args: string dataField - The data field of the column to sort, e.g., 'firstName'.,string sortOrder - Sort order to apply: 'asc' for ascending, 'desc' for descending, or null to remove sorting.
SortBy	void	string dataField, string sortOrder	Applies sorting to the CardView based on the specified data field. You can either add sorting by providing a valid sortOrder (such as 'asc' or 'desc'), or remove sorting from a column by setting the sortOrder parameter to null. This allows dynamic adjustment of CardView sorting criteria, enabling users to sort data as needed or clear sorting on individual columns.Args: string dataField - The data field of the column to sort, e.g., 'firstName'.,string sortOrder - Sort order to apply: 'asc' for ascending, 'desc' for descending, or null to remove sorting.
StateHasChanged	void	'N/A'	Refreshes the state and Re-renders the Blazor Component, if necessary.

CardView Events

Name	Type	Description	Event Detail
OnFilter	EventCallback<Event>	This event is triggered whenever a user applies a filter to the data set, typically by selecting filter criteria or options in the interface. It signals that the displayed data has been updated based on the chosen filter parameters, allowing developers to execute additional logic in response, such as refreshing the view or fetching new data.	N/A
Filtered	event CardViewFilteredEventHandler	This event is triggered whenever a user applies a filter to the data set, typically by selecting filter criteria or options in the interface. It signals that the displayed data has been updated based on the chosen filter parameters, allowing developers to execute additional logic in response, such as refreshing the view or fetching new data.	CardViewFilteredEventArgs
OnSort	EventCallback<Event>	This event is triggered whenever a sorting action is performed on the data set, such as when a user updates the sorting order of a table or list by clicking on a column header or selecting a sort option.	N/A
Sorted	event CardViewSortedEventHandler	This event is triggered whenever a sorting action is performed on the data set, such as when a user updates the sorting order of a table or list by clicking on a column header or selecting a sort option.	CardViewSortedEventArgs
OnOpen	EventCallback<Event>	This event is triggered immediately after the window has been successfully opened, allowing you to execute code in response to the window becoming visible and accessible to the user. It is typically used to initialize resources, update the user interface, or perform actions that should occur as soon as the window appears.	N/A
Opened	event CardViewOpenedEventHandler	This event is triggered immediately after the window has been successfully opened, allowing you to execute code in response to the window becoming visible and accessible to the user. It is typically used to initialize resources, update the user interface, or perform actions that should occur as soon as the window appears.	CardViewOpenedEventArgs
OnOpening	EventCallback<Event>	This event is fired just before the window is opened, giving you an opportunity to perform additional logic or checks. To prevent the window from opening, call event.preventDefault() within your event handler. If preventDefault() is not called, the window will open as usual. This allows you to control whether or not the window opening operation proceeds based on your custom criteria.	N/A
Opening	event CardViewOpeningEventHandler	This event is fired just before the window is opened, giving you an opportunity to perform additional logic or checks. To prevent the window from opening, call event.preventDefault() within your event handler. If preventDefault() is not called, the window will open as usual. This allows you to control whether or not the window opening operation proceeds based on your custom criteria.	CardViewOpeningEventArgs
OnClose	EventCallback<Event>	This event is triggered immediately when the window is closed by the user or programmatically, allowing scripts to execute any necessary cleanup operations or final actions before the window is terminated.	N/A
Closed	event CardViewClosedEventHandler	This event is triggered immediately when the window is closed by the user or programmatically, allowing scripts to execute any necessary cleanup operations or final actions before the window is terminated.	CardViewClosedEventArgs
OnClosing	EventCallback<Event>	This event is triggered just before the window begins the closing process. It gives developers an opportunity to perform actions or prompt the user before the window actually closes. If you want to prevent the window from closing—for example, to confirm with the user or save data—you can call event.preventDefault() inside the event handler function. This will cancel the default close operation and keep the window open.	N/A
Closing	event CardViewClosingEventHandler	This event is triggered just before the window begins the closing process. It gives developers an opportunity to perform actions or prompt the user before the window actually closes. If you want to prevent the window from closing—for example, to confirm with the user or save data—you can call event.preventDefault() inside the event handler function. This will cancel the default close operation and keep the window open.	CardViewClosingEventArgs
OnDragStart	EventCallback<Event>	This event is triggered when the user initiates a drag action on the card component, typically by clicking and holding the mouse button or starting a touch gesture. It signals the beginning of the card's movement, allowing developers to implement custom behavior such as visual feedback or updating drag-related state.	N/A
DragStarted	event CardViewDragStartedEventHandler	This event is triggered when the user initiates a drag action on the card component, typically by clicking and holding the mouse button or starting a touch gesture. It signals the beginning of the card's movement, allowing developers to implement custom behavior such as visual feedback or updating drag-related state.	CardViewDragStartedEventArgs
OnDragging	EventCallback<Event>	This event is triggered continuously while the user is actively dragging the card element with their cursor or finger, allowing you to track the card's position and respond to movement in real time.	N/A
Dragging	event CardViewDraggingEventHandler	This event is triggered continuously while the user is actively dragging the card element with their cursor or finger, allowing you to track the card's position and respond to movement in real time.	CardViewDraggingEventArgs
OnDragEnd	EventCallback<Event>	This event is triggered when the user initiates a drag action on the card component, typically by clicking and holding the mouse button (or touching and holding on a touchscreen) and then moving the card to a different position within the interface.	N/A
DragEnded	event CardViewDragEndedEventHandler	This event is triggered when the user initiates a drag action on the card component, typically by clicking and holding the mouse button (or touching and holding on a touchscreen) and then moving the card to a different position within the interface.	CardViewDragEndedEventArgs

Enums

Orientation

Orientation.Horizontal

Orientation.Vertical

CardViewColumnDataType

CardViewColumnDataType.String

CardViewColumnDataType.Date

CardViewColumnDataType.Boolean

CardViewColumnDataType.Number

CardViewColumnDataType.Array

CardViewColumnDataType.Any

CardViewCoverMode

CardViewCoverMode.Fit

CardViewCoverMode.Crop

DataSourceSettingsSanitizeHTML

DataSourceSettingsSanitizeHTML.All

DataSourceSettingsSanitizeHTML.BlackList

DataSourceSettingsSanitizeHTML.None

DataSourceSettingsDataFieldDataType

DataSourceSettingsDataFieldDataType.String

DataSourceSettingsDataFieldDataType.Date

DataSourceSettingsDataFieldDataType.Boolean

DataSourceSettingsDataFieldDataType.Number

DataSourceSettingsDataFieldDataType.Array

DataSourceSettingsDataFieldDataType.Any

DataSourceSettingsDataSourceType

DataSourceSettingsDataSourceType.Array

DataSourceSettingsDataSourceType.Json

DataSourceSettingsDataSourceType.Xml

DataSourceSettingsDataSourceType.Csv

DataSourceSettingsDataSourceType.Tsv

CardViewHeaderPosition

CardViewHeaderPosition.None

CardViewHeaderPosition.Top

CardViewHeaderPosition.Bottom

Scrolling

Scrolling.Physical

Scrolling.Virtual

Scrolling.Infinite

Scrolling.Deferred

CardViewColumn Properties

Name	Type	Default	Description
DataField	string	""	Sets or gets the column's data source bound field.
DataType	CardViewColumnDataType	CardViewColumnDataType.String	Sets or gets the column's data type.
Icon	object	""	Sets or gets the column's icon. Expects CSS class name.
Image	bool	false	Sets or gets the column's image visibility.
Label	string	""	Sets or gets the text displayed in the column's header.
Visible	bool	true	Sets or gets whether the column is visible. Set the property to 'false' to hide the column.
FormatFunction	Action<object>	null	Sets or gets the column's format function.
FormatSettings	object	new object()	Sets or gets the column's format settings. You can use any of the build in formatting options or to NumberFormat object like that: 'Intl: { NumberFormat: { style: \'currency\', currency: \'EUR\' }}' or DateTimeFormat object like that: 'Intl: { DateTimeFormat: { dateStyle: \'full\' }}''

DataSourceSettings Properties

Name	Type	Default	Description
AutoGenerateColumns	bool	false	Sets or gets whether a column will be auto-generated.
ChildrenDataField	string	""	Sets or gets a children data field like 'children', 'items' in the data source. When this property is set, the component will look for this data field when looping through the items. If it is found a hierarchical data source would be created.
Root	string	""	Sets or gets the XML binding root.
SanitizeHTML	DataSourceSettingsSanitizeHTML	DataSourceSettingsSanitizeHTML.BlackList	Sets or gets the XML binding root.
Record	string	""	Sets or gets the XML binding record.
GroupBy	string[]	new string[]{}	Sets or gets the data fields to group by.
DataFields	IEnumerable<IDataSourceSettingsDataField>	null	Sets or gets the data fields which decribe the loaded data and data type. Ex: ['id: number', 'firstName: string', 'lastName: string']
DataSourceType	DataSourceSettingsDataSourceType	DataSourceSettingsDataSourceType.Array	Sets or gets whether the data source type.
Id	string	""	Sets or gets the component's id
KeyDataField	string	""	Sets or gets the key data field to be used for building the hierarchy. It is used in combination with the parentDataField property. Usually the 'id' field is used as key data field and 'parentId' as parent data field'
ParentDataField	string	""	Sets or gets the parent data field to be used for building the hierarchy. It is used in combination with the keyDataField property. Usually the 'id' field is used as key data field and 'parentId' as parent data field'
MapChar	string	"."	Sets the 'mapChar' data field of the record
VirtualDataSource	object	null	Sets the virtual data source function which is called each time the Grid requests data. Demos using 'virtualDataSource' are available on the Grid demos page.
VirtualDataSourceOnExpand	object	null	Sets the virtual data source on expand function. This function is called when we load data on demand in Tree or TreeGrid and virtualDataSource in these components is set, too

DataSourceSettingsDataField Properties

Name	Type	Default	Description
Name	string	""	Sets the dataField name.
Map	string	""	Sets the dataField mapping path. For nested mapping, use '.'. Example: 'name.firstName'.
DataType	DataSourceSettingsDataFieldDataType	DataSourceSettingsDataFieldDataType.String	Sets the dataField type.