foundation-layout.foundationlayout

Home > @genesislcap/foundation-layout > FoundationLayout

FoundationLayout class

Top level web component which is used to initialise a custom layout

Signature:

export declare class FoundationLayout extends FoundationElement implements LayoutComponent 

Extends: FoundationElement

Implements: LayoutComponent

Remarks

Can be used in a composition to customise the styles of the layout.

The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the FoundationLayout class.

Properties

Property	Modifiers	Type	Description
autoSaveKey?		string	(Optional) Attribute which if set will auto save and load the layout as the user changes it. Omit this attribute to disable this feature. Set attribute using auto-save-key.
class		"FoundationLayoutMain"	Identifier constant token.
customButtons		CustomButton[]	Set custom button definition on this property to add them to the layout header controls
dimensionsConfig?		LayoutConfig.Dimensions	(Optional) Apply dimensions config to the layout, such as setting the size of the drag handles.
dragging		boolean	Set to true when the user is currently dragging the panes inside of the layout
hasFirstLoaded		boolean	Boolean signifies whether the layout has loaded for the first time or not.
lifecycleUpdateToken		string | undefined	Used to calculate whether a layout item should run its lifecycle methods or not
missingItemPlaceholder		(missingItem: string) => string	Function which is used to generate the placeholder text when a layout is loaded with a missing item.
popoutConfig		string | undefined	(BETA) Controls whether popout functionality is enabled on the layout. Defaults to disabled. Set this attribute to any string to enable popout functionality. If this string is of format number;number then this will be interpreted as the width and height of the popout window.
reloadBuffer		number	Number describing how long to wait in ms before reloading the config when adding items declaratively by the html API. Default 500 (ms).

Methods

Method	Modifiers	Description
addItem(config, placement)		Dynamically add a new item to the layout. The user can move the new plane to whenever they want once it has been added.
clearAutosaveAndRevertToDefault()		Clears the autosaved layout from local storage and reverts to the default layout
getLayout()		Gets a minified string containing the config describing the current layout of the layout object to later restore in function
layoutRequiredRegistrations(layout)	static	Gets all of the required element registry function names for a set of config
loadLayout(layout, handleMissingItem, disableCache)		Restores a layout described in the config from getLayout()
registeredItems()		Gets all of the currently registered names
registerItem(registration, elements)		Register a collection of Element and associate them with an ID with the layout system for later use.
removeItems(registration, force)		Removes all instances of a specified registered item from the layout.
tryActivatePopoutMode()		(BETA) If in a popout window from the dynamic layout, this function will run the flow to put the component in popout mode. This function is automatically called if using the declarative HTML API, but if only using the JavaScript API then you will need to call this function manually.
tryLoadLayoutFromLocalStorage()		Try to load a layout from local storage, or return false. Only required if manually calling FoundationLayout.registerItem()