@bryntum/grid-angular-thin 7.3.1 → 7.3.3

package/src/lib/bryntum-a-i-filter-field.component.ts

@@ -40,6 +40,8 @@ export type BryntumAIFilterFieldProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -86,9 +88,10 @@ export type BryntumAIFilterFieldProps = {
     catchEventHandlerExceptions ? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : boolean
+    centered ? : boolean|object
     /**
      * A function (or the name of a function in the ownership hierarchy) called during field validation
      * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-isValid)
@@ -190,7 +193,7 @@ export type BryntumAIFilterFieldProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -306,10 +309,14 @@ export type BryntumAIFilterFieldProps = {
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -511,7 +518,7 @@ export type BryntumAIFilterFieldProps = {
     rtl ? : boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**
@@ -775,7 +782,6 @@ export class BryntumAIFilterFieldComponent implements OnInit, OnDestroy {
         'autoComplete',
         'autoSelect',
         'bubbleEvents',
-        'centered',
         'checkValidity',
         'clearable',
         'client',
@@ -847,6 +853,7 @@ export class BryntumAIFilterFieldComponent implements OnInit, OnDestroy {
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'content',
@@ -913,7 +920,6 @@ export class BryntumAIFilterFieldComponent implements OnInit, OnDestroy {
     @Input() autoComplete                 ! : string;
     @Input() autoSelect                   ! : boolean;
     @Input() bubbleEvents                 ! : object;
-    @Input() centered                     ! : boolean;
     @Input() checkValidity                ! : ((field: Field) => void)|string;
     @Input() clearable                    ! : boolean|FieldTriggerConfig;
     @Input() client                       ! : Grid;
@@ -984,6 +990,9 @@ export class BryntumAIFilterFieldComponent implements OnInit, OnDestroy {
     @Input() badge                       ! : string;
     @Input() callOnFunctions             ! : boolean;
     @Input() catchEventHandlerExceptions ! : boolean;
+    @Input() centered                    ! : boolean|{
+        once?: boolean
+    }|boolean|object;
     @Input() cls                         ! : string|object;
     @Input() column                      ! : number;
     @Input() dataset                     ! : object|Record<string, string>;

package/src/lib/bryntum-checklist-filter-combo.component.ts

@@ -40,6 +40,8 @@ export type BryntumChecklistFilterComboProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -99,9 +101,10 @@ export type BryntumChecklistFilterComboProps = {
     catchEventHandlerExceptions ? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : boolean
+    centered ? : boolean|object
     /**
      * A function (or the name of a function in the ownership hierarchy) called during field validation
      * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-isValid)
@@ -237,7 +240,7 @@ export type BryntumChecklistFilterComboProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -404,10 +407,14 @@ export type BryntumChecklistFilterComboProps = {
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -669,7 +676,7 @@ export type BryntumChecklistFilterComboProps = {
     rtl ? : boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**
@@ -1000,7 +1007,6 @@ export class BryntumChecklistFilterComboComponent implements OnInit, OnDestroy {
         'bubbleEvents',
         'cacheLastResult',
         'caseSensitive',
-        'centered',
         'checkValidity',
         'chipView',
         'clearable',
@@ -1098,6 +1104,7 @@ export class BryntumChecklistFilterComboComponent implements OnInit, OnDestroy {
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'content',
@@ -1174,7 +1181,6 @@ export class BryntumChecklistFilterComboComponent implements OnInit, OnDestroy {
     @Input() bubbleEvents                 ! : object;
     @Input() cacheLastResult              ! : number|string|Duration|DurationConfig;
     @Input() caseSensitive                ! : boolean;
-    @Input() centered                     ! : boolean;
     @Input() checkValidity                ! : ((field: Field) => void)|string;
     @Input() chipView                     ! : ChipViewConfig;
     @Input() clearable                    ! : boolean|FieldTriggerConfig;
@@ -1271,6 +1277,9 @@ export class BryntumChecklistFilterComboComponent implements OnInit, OnDestroy {
     @Input() badge                       ! : string;
     @Input() callOnFunctions             ! : boolean;
     @Input() catchEventHandlerExceptions ! : boolean;
+    @Input() centered                    ! : boolean|{
+        once?: boolean
+    }|boolean|object;
     @Input() cls                         ! : string|object;
     @Input() column                      ! : number;
     @Input() dataset                     ! : object|Record<string, string>;

package/src/lib/bryntum-grid-base.component.ts

@@ -48,6 +48,8 @@ export type BryntumGridBaseProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/GridBase#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -359,10 +361,14 @@ export type BryntumGridBaseProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/GridBase#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/GridBase#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -375,7 +381,7 @@ export type BryntumGridBaseProps = {
      */
     labelPosition ? : 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/GridBase#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -1350,6 +1356,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
         'callOnFunctions',
         'catchEventHandlerExceptions',
         'cellEllipsis',
+        'centered',
         'cls',
         'collapsed',
         'column',
@@ -1560,6 +1567,9 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
     @Input() width                       ! : number|string;
 
     // Properties only
+    @Input() centered        ! : boolean|{
+        once?: boolean
+    };
     @Input() originalStore   ! : Store;
     @Input() parent          ! : Widget;
     @Input() selectedCell    ! : GridLocation|GridLocationConfig;

package/src/lib/bryntum-grid-chart-designer.component.ts

@@ -40,6 +40,8 @@ export type BryntumGridChartDesignerProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -73,9 +75,10 @@ export type BryntumGridChartDesignerProps = {
     catchEventHandlerExceptions ? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : boolean
+    centered ? : boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -149,7 +152,7 @@ export type BryntumGridChartDesignerProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -217,10 +220,14 @@ export type BryntumGridChartDesignerProps = {
     ignoreParentReadOnly ? : boolean
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -358,7 +365,7 @@ export type BryntumGridChartDesignerProps = {
     scrollable ? : boolean|ScrollerConfig|Scroller
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**
@@ -555,7 +562,6 @@ export class BryntumGridChartDesignerComponent implements OnInit, OnDestroy {
         'ariaDescription',
         'ariaLabel',
         'bubbleEvents',
-        'centered',
         'color',
         'config',
         'constrainTo',
@@ -602,6 +608,7 @@ export class BryntumGridChartDesignerComponent implements OnInit, OnDestroy {
         'appendTo',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'content',
@@ -656,7 +663,6 @@ export class BryntumGridChartDesignerComponent implements OnInit, OnDestroy {
     @Input() ariaDescription              ! : string;
     @Input() ariaLabel                    ! : string;
     @Input() bubbleEvents                 ! : object;
-    @Input() centered                     ! : boolean;
     @Input() color                        ! : Color;
     @Input() config                       ! : object;
     @Input() constrainTo                  ! : HTMLElement|Widget|Rectangle;
@@ -702,6 +708,9 @@ export class BryntumGridChartDesignerComponent implements OnInit, OnDestroy {
     @Input() appendTo                    ! : HTMLElement|string;
     @Input() callOnFunctions             ! : boolean;
     @Input() catchEventHandlerExceptions ! : boolean;
+    @Input() centered                    ! : boolean|{
+        once?: boolean
+    }|boolean|object;
     @Input() cls                         ! : string|object;
     @Input() column                      ! : number;
     @Input() content                     ! : string;

package/src/lib/bryntum-grid-field-filter-picker-group.component.ts

@@ -50,6 +50,8 @@ export type BryntumGridFieldFilterPickerGroupProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -107,9 +109,10 @@ export type BryntumGridFieldFilterPickerGroupProps = {
     catchEventHandlerExceptions ? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : boolean
+    centered ? : boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -198,7 +201,7 @@ export type BryntumGridFieldFilterPickerGroupProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -298,10 +301,14 @@ export type BryntumGridFieldFilterPickerGroupProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -327,7 +334,7 @@ export type BryntumGridFieldFilterPickerGroupProps = {
      */
     labelPosition ? : 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -504,7 +511,7 @@ export type BryntumGridFieldFilterPickerGroupProps = {
     scrollable ? : boolean|ScrollerConfig|Scroller
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**
@@ -762,7 +769,6 @@ export class BryntumGridFieldFilterPickerGroupComponent implements OnInit, OnDes
         'bubbleEvents',
         'canDeleteFilter',
         'canManageFilter',
-        'centered',
         'color',
         'config',
         'constrainTo',
@@ -823,6 +829,7 @@ export class BryntumGridFieldFilterPickerGroupComponent implements OnInit, OnDes
         'appendTo',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'content',
@@ -894,7 +901,6 @@ export class BryntumGridFieldFilterPickerGroupComponent implements OnInit, OnDes
     @Input() bubbleEvents                 ! : object;
     @Input() canDeleteFilter              ! : (filter: any) => boolean;
     @Input() canManageFilter              ! : (filter: any) => boolean;
-    @Input() centered                     ! : boolean;
     @Input() color                        ! : Color;
     @Input() config                       ! : object;
     @Input() constrainTo                  ! : HTMLElement|Widget|Rectangle;
@@ -954,6 +960,9 @@ export class BryntumGridFieldFilterPickerGroupComponent implements OnInit, OnDes
     @Input() appendTo                    ! : HTMLElement|string;
     @Input() callOnFunctions             ! : boolean;
     @Input() catchEventHandlerExceptions ! : boolean;
+    @Input() centered                    ! : boolean|{
+        once?: boolean
+    }|boolean|object;
     @Input() cls                         ! : string|object;
     @Input() column                      ! : number;
     @Input() content                     ! : string;

package/src/lib/bryntum-grid-field-filter-picker.component.ts

@@ -47,6 +47,8 @@ export type BryntumGridFieldFilterPickerProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -88,9 +90,10 @@ export type BryntumGridFieldFilterPickerProps = {
     catchEventHandlerExceptions ? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : boolean
+    centered ? : boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -179,7 +182,7 @@ export type BryntumGridFieldFilterPickerProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -283,10 +286,14 @@ export type BryntumGridFieldFilterPickerProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -312,7 +319,7 @@ export type BryntumGridFieldFilterPickerProps = {
      */
     labelPosition ? : 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -494,7 +501,7 @@ export type BryntumGridFieldFilterPickerProps = {
     scrollable ? : boolean|ScrollerConfig|Scroller
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**
@@ -753,7 +760,6 @@ export class BryntumGridFieldFilterPickerComponent implements OnInit, OnDestroy
         'autoUpdateRecord',
         'border',
         'bubbleEvents',
-        'centered',
         'color',
         'config',
         'constrainTo',
@@ -818,6 +824,7 @@ export class BryntumGridFieldFilterPickerComponent implements OnInit, OnDestroy
         'appendTo',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'content',
@@ -885,7 +892,6 @@ export class BryntumGridFieldFilterPickerComponent implements OnInit, OnDestroy
     @Input() autoUpdateRecord             ! : boolean;
     @Input() border                       ! : boolean;
     @Input() bubbleEvents                 ! : object;
-    @Input() centered                     ! : boolean;
     @Input() color                        ! : Color;
     @Input() config                       ! : object;
     @Input() constrainTo                  ! : HTMLElement|Widget|Rectangle;
@@ -949,6 +955,9 @@ export class BryntumGridFieldFilterPickerComponent implements OnInit, OnDestroy
     @Input() appendTo                    ! : HTMLElement|string;
     @Input() callOnFunctions             ! : boolean;
     @Input() catchEventHandlerExceptions ! : boolean;
+    @Input() centered                    ! : boolean|{
+        once?: boolean
+    }|boolean|object;
     @Input() cls                         ! : string|object;
     @Input() column                      ! : number;
     @Input() content                     ! : string;

package/src/lib/bryntum-grid.component.ts

@@ -48,6 +48,8 @@ export type BryntumGridProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/Grid#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -359,10 +361,14 @@ export type BryntumGridProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/Grid#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/Grid#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -375,7 +381,7 @@ export type BryntumGridProps = {
      */
     labelPosition ? : 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/Grid#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -1353,6 +1359,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
         'callOnFunctions',
         'catchEventHandlerExceptions',
         'cellEllipsis',
+        'centered',
         'cls',
         'collapsed',
         'column',
@@ -1564,6 +1571,9 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
     @Input() width                       ! : number|string;
 
     // Properties only
+    @Input() centered        ! : boolean|{
+        once?: boolean
+    };
     @Input() originalStore   ! : Store;
     @Input() parent          ! : Widget;
     @Input() selectedCell    ! : GridLocation|GridLocationConfig;