List module
Important
The finance and operations (Dynamics 365) mobile app and platform have been deprecated. For more information, see Removed or deprecated platform features.
A list is a control that contains any numbers of rows. Each row follows a template for the layout of any number of controls. Lists come in two styles: simple and card.
Index
Types
Types
List
Hierarchy
ContainerControl
└─ List
Properties
Name | Signature | Description |
---|---|---|
$accessibility | $accessibility: any |
|
DefaultSearchColumn | DefaultSearchColumn: string |
|
container | container: boolean |
True if the control is a container. Inherited from ContainerControl.container Overrides Control.container |
emptyListMessage | emptyListMessage: string |
Settable property to override default empty list message. |
enableMultiSelect | enableMultiSelect: boolean |
|
generic | generic: boolean (optional) |
Inherited from Control.generic |
getDataSource | getDataSource: function(): any |
Inherited from Control.getDataSource |
hidden | hidden: boolean |
True if the control is hidden. Inherited from Control.hidden |
hideEmptyListMessage | hideEmptyListMessage: boolean |
If true, no message is shown if the list is empty. To set this property, update the corresponding metadata property via configureControl. |
imageFields | imageFields: any [ ] |
|
performingRemoteSearch | performingRemoteSearch: boolean |
|
searchQuery | searchQuery: [value: string]: any |
Methods
Name | Signature | Description |
---|---|---|
allowsNavigation | allowsNavigation(): boolean | |
applyDesign | applyDesign(IDesign: ListDesign): void | Applies given design to the design on the control. Overrides Control.applyDesign |
applySearch | applySearch(): void | |
canPerformRemoteSearch | canPerformRemoteSearch(): boolean | |
clearSearch | clearSearch(): void | |
dataContext | dataContext(): any | Inherited from Control.dataContext |
getColumnLabel | getColumnLabel(id: string): string | |
getControl | getControl(controlName: string): Control | Given the name of a control, returns the control instance. Inherited from ContainerControl.getControl |
getControlById | getControlById(id: string): Control | Given the ID of a control, returns the control instance. Inherited from ContainerControl.getControlById |
getControlMetadata | getControlMetadata(controlName: string): Control | |
getControlMetadataById | getControlMetadataById(id: string): Control | |
getData | getData(): any [ ] | |
getDesign | getDesign(): Design | Returns the design object of this control. Inherited from Control.getDesign |
getListData | getListData(): any | |
getRenderedRows | getRenderedRows(): Row [ ] | |
getRowNavigation | getRowNavigation(row: Row): Promise <any> | any | |
getRowSelectionCount | getRowSelectionCount(): number | |
getRowSelections | getRowSelections(): string [ ] | |
getRowTracking | getRowTracking(row: any, index: string): string | |
getSearchColumn | getSearchColumn(): string | |
getSearchColumnLabel | getSearchColumnLabel(): string | |
getSearchableColumns | getSearchableColumns(): any [ ] | |
hideSearchBar | hideSearchBar(): boolean | |
isEditable | isEditable(): boolean | Boolean indicating if the control is editable. Inherited from Control.isEditable |
loadMetaData | loadMetaData(): void | |
loadMore | loadMore(): void | |
metadata | metadata(): ListMetadata | Returns the metadata object of this control. Overrides ContainerControl.metadata |
parent | parent(): Control | Page | Returns the parent (control or page) of this control. Inherited from Control.parent |
performRemoteSearch | performRemoteSearch(): void | |
root | root(): Page | Returns the root form instance (page) of this control. Inherited from Control.root |
selectSearchColumn | selectSearchColumn(column: string): void | |
setRowSections | setRowSections(selections: string [ ]): void |
Events
Name | Signature | Description |
---|---|---|
onRowCreate | onRowCreate: EventHook <Row> |
|
onRowSelect | onRowSelect: EventHook <Row> |
ListDesign
Hierarchy
ContainerControlDesign
└─ ListDesign
Properties
Name | Signature | Description |
---|---|---|
alignItems | alignItems: string (optional) |
This property is an alias for the CSS property "align-items". Inherited from Design.alignItems |
alignSelf | alignSelf: string (optional) |
Inherited from Design.alignSelf |
allowScroll | allowScroll: string (optional) |
True if the container will allow scrolling when its items do not fit into the container's available space. If a container has an item which may scroll, then set this property to false to prevent nested scrolling areas. Inherited from ContainerControlDesign.allowScroll |
background | background: string (optional) |
The background color of the container. Inherited from ContainerControlDesign.background |
bindings | bindings: any (optional) |
Inherited from Design.bindings |
border | border: "none" | "solid" | "left" | "right" | "top" | "bottom" (optional) |
The border behavior of a control. This property will not be inherited by the children. Inherited from Design.border |
color | color: string (optional) |
The foreground color of the container. Inherited from Design.color |
design | design: GroupDesign (optional) |
The design object that will be applied to each row. |
flexFlow | flexFlow: string (optional) |
Specifying this property makes the component a flex container component. Inherited from Design.flexFlow |
flexSize | flexSize: string (optional) |
One number or two numbers written as a string. For example, "(size to grow) [(size-to-shrink)]" to accommodate available space in the immediate flex container. Inherited from Design.flexSize |
fontSize | fontSize: "medium" | "xx-small" | "x-small" | "small" | "large" | "x-large" | "xx-large" (optional) |
The proportional text size Inherited from Design.fontSize |
fontWeight | fontWeight: "normal" | "bold" (optional) |
Normal or bold text. Inherited from Design.fontWeight |
hideArrow | hideArrow: boolean (optional) |
Allows an arrow ( > ) on a default styled navigation control to be hidden. |
hideSearchBar | hideSearchBar: boolean (optional) |
If true, the search bar will be hidden. |
itemBorder | itemBorder: "solid" | "none" (optional) |
If true, a border will appear around each row in the list. Inherited from ContainerControlDesign.itemBorder |
items | items: string | Design [ ] (optional) |
An array containing the components to place inside of the container. Inherited from ContainerControlDesign.items |
justifyItems | justifyItems: "flex-start" | "flex-end" | "center" | "space-between" (optional) |
This property is an alias for the CSS property "justify-content". Inherited from Design.justifyItems |
label | label: string (optional) |
Inherited from Design.label |
labelPosition | labelPosition: "stacked" | "hidden" | "inline" (optional) |
Determines how a label is positioned, if at all. By default, labelPosition is set to stacked. Inherited from Design.labelPosition |
name | name: string (optional) |
Inherited from Design.name |
padding | padding: "none" | "small" | "std" (optional) |
Allows specifying the component's padding behavior. Inherited from Design.padding |
type | type: ControlType (optional) |
The type of the control as a string. Inherited from Design.type |
ListMetadata
Hierarchy
ContainerControlMetadata
└─ ListMetadata
Properties
Name | Signature | Description |
---|---|---|
BoundEntity | BoundEntity: string (optional) |
The entity to which the control is bound. Inherited from ControlMetadata.BoundEntity |
BoundField | BoundField: string (optional) |
Inherited from ControlMetadata.BoundField |
Children | Children: ControlMetadata [ ] (optional) |
List of metadata for controls that will appear in each row of the list. |
Description | Description: string (optional) |
Description of the control. Inherited from ControlMetadata.Description |
DetailsPageAppId | DetailsPageAppId: string (optional) |
App ID of the page that each row in the list will navigate to. |
DetailsPageId | DetailsPageId: string (optional) |
The ID of the page to which each row will navigate. |
Editable | Editable: boolean (optional) |
Boolean indicating if the control is editable. Inherited from ControlMetadata.Editable |
EmptyListMessage | EmptyListMessage: string (optional) |
If set, overrides the default message for empty lists. |
ExtType | ExtType: ControlType (optional) |
The extended control type. For example, a control of type Input might have an extended type of Barcode. Inherited from ControlMetadata.ExtType |
HelpText | HelpText: string (optional) |
The keyboard shortcut for a command. For example, "(Shift+F5)" Inherited from ControlMetadata.HelpText |
Hidden | Hidden: boolean (optional) |
Boolean indicating if the control is hidden or not. Inherited from ControlMetadata.Hidden |
HideEmptyListMessage | HideEmptyListMessage: boolean (optional) |
If true, the empty list message will be hidden. |
HideSearchBar | HideSearchBar: boolean (optional) |
If true, the search bar will be hidden. |
Id | Id: string (optional) |
Identification string for a control. Inherited from ControlMetadata.Id |
InfiniteScroll | InfiniteScroll: boolean (optional) |
If set to true then the list will allow infinite scroll. |
InfiniteScrollPageSize | InfiniteScrollPageSize: number (optional) |
Number of rows to load initially and the number of rows to load after the user reaches the end of the currently displayed rows. |
Label | Label: string (optional) |
Label for a control. For example, a control representing a person's first name might have a label "First Name". Inherited from ControlMetadata.Label |
ListStyle | ListStyle: string (optional) |
Dictates the list template type. |
MultiSelect | MultiSelect: boolean (optional) |
If true, then the list will be a multi-select list. |
Name | Name: string (optional) |
Name of a control. Inherited from ControlMetadata.Name |
NonEntityProjection | NonEntityProjection: boolean (optional) |
|
Order | Order: number (optional) |
Number indicating the order in which a control will appear on a page. Inherited from ControlMetadata.Order |
Type | Type: ControlType (optional) |
String indicating the control type. Inherited from ControlMetadata.Type |
Methods
Name | Signature | Description |
---|---|---|
navigationHandler | Optional navigationHandler(row: Row): Promise <any> | NavigationArgs | A function that determines the navigation for a given row. |
Events
Name | Signature | Description |
---|---|---|
OnNavigate | OnNavigate: function(navigation: NavigationArgs): any (optional) |
An event that is triggered when a pagelink control is selected. |
OnRowSelect | OnRowSelect: function(row: Row): void (optional) |
An event that is triggered when a row is selected. |
Row
Hierarchy
Row
Properties
Name | Signature | Description |
---|---|---|
fieldList | fieldList: Control [ ] |
|
headerField | headerField: Control |
|
hidden | hidden: boolean |
If true then the row will be hidden. |
imageFields | imageFields: Control [ ] |
|
isSelected | isSelected: boolean |
|
item | item: any |
A container of rendered data. |
template | template: Group |
Group control that represents the template for a row. |
Methods
Name | Signature | Description |
---|---|---|
getControl | getControl(controlName: string): Control | |
getControlById | getControlById(id: string): Control | |
getControlValueById | getControlValueById(id: string): string | |
getRowHeader | getRowHeader(): Control | |
getRowId | getRowId(): string | |
hasImageField | hasImageField(): boolean | Returns true if the row has an image field. |
isEntityCreatedNew | isEntityCreatedNew(): boolean | |
isEntityDeleted | isEntityDeleted(): boolean | |
isEntityModified | isEntityModified(): boolean | |
isEntitySyncPending | isEntitySyncPending(): boolean | |
select | select(): any |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour