Wijmo defines a Control class that is the base class for all Wijmo controls.
The Control class provides the following functionality:
constructor(element, options, invalidateOnResize) | Creates the control and associates it with the specified HTML element. |
initialize(options) | Initializes the control by copying the properties from a given object. |
applyTemplate(classNames, template, parts, namePart) | Applies a template to a new instance of the control. |
getTemplate() | Gets the HTML template used to create instances of the control. |
dispose() | Restores the original content of the host element and disposes of the control. |
getControl(element) | Gets a reference to the control associated with the specified HTML element. |
hostElement | Gets a reference to the HTML element that hosts the control. |
isUpdating | Gets a value that indicates whether the control is currently being updated. |
focus() | Sets focus to the element that hosts the control. |
containsFocus() | Returns true if the host element or any of its children has focus. |
invalidate(fullUpdate) | Causes the control to refresh its contents asynchronously. Calling this method multiple times in sequence only causes one actual refresh. |
refresh(fullUpdate) | Causes the control to refresh its contents synchronously. |
beginUpdate() | Temporarily suspends all refreshes. |
endUpdate() | Restores refreshes suspended by a call to beginUpdate(). |
deferUpdate(function) | Suspends updates while executing the specified function. |
Wijmo controls do not have size or position properties. The host element determines their size and position, which we lay out using CSS and styles, the same as any regular HTML element.
The controls below show how you can set the size of Wijmo controls to specific values using CSS styles:
Regular Input Element:This grid has its maximum height set to 200 pixels, and width set to 100%. Because the data requires more than 200 pixels, the grid adds a vertical scrollbar automatically.
This grid has no explicit height. It sizes automatically to fit the data, and has no scrollbars.