ui.property
A structured table of 2 columns that presents 'name:value' pairs for a list of properties.
The component can be used for creating various on-page editors. The value field can be presented by any control - a text field, a checkbox, a drop-down list box etc. Check property documentation for more detailed description.
Constructor
var property = webix.ui({
view:"property",
id:"sets",
width:300,
elements:[
{ label:"Layout", type:"label"},
{ label:"Data url", type:"text", id:"url"},
{ label:"Data type", type:"select", options:["json","xml","csv"], id:"type"},
{ label:"Use JSONP", type:"checkbox", id:"jsonp"}
]
});
Where to start
Based on:
AutoTooltip,
EditAbility,
MapCollection,
MouseEvents,
Scrollable,
SingleRender,
AtomRender,
AtomDataLoader,
EventSystem,
ui.view,
ui.baseview,
Settings,
Destruction,
BaseBind
Methods
| adjust | adjusts the component to the size of the parent HTML container |
| attachEvent | attaches the handler to an inner event of the component |
| bind | binds components |
| blockEvent | temporarily blocks triggering of ALL events of the calling object |
| callEvent | calls an inner event |
| clear | removes all values set for the elements of a property sheet |
| customize | redefines the 'type' property |
| define | redefines a single configuration property (or a object with properties) |
| destructor | destructs the calling object |
| detachEvent | detaches a handler from an event (which was attached before by the attachEvent method) |
| disable | disables the calling view (makes it dimmed and unclickable) |
| edit | enables the edit mode for the specified item |
| editCancel | cancels the edit mode and closes all opened editors. The component remains editable. |
| editNext | closes the current editor and opens one in the next cell of the row |
| editStop | stops the edit mode and closes all opened editors. The component remains editable. |
| enable | enables the calling view that was disabled by the 'disable' method |
| focusEditor | moves focus to the active editor |
| getChildViews | returns child views of the calling component |
| getEditState | returns info about active editor object |
| getEditor | returns an editor object |
| getEditorValue | returns the value of the active (currently open) editor |
| getFormView | returns master form for the input |
| getItem | returns the data object of a property by its ID |
| getItemNode | returns HTML element of the item |
| getNode | returns the main HTML container for the calling object |
| getParentView | returns the parent view of the component |
| getScrollState | returns the scroll position |
| getTopParentView | returns the top parent view |
| getValues | gets values from the property sheet |
| hasEvent | checks whether the component has the specified event handler |
| hide | hides the view |
| isEnabled | checks whether the view is enabled |
| isVisible | checks whether the view is visible |
| load | loads data from an external data source |
| locate | returns the id of an item from the specified HTML event |
| mapEvent | routes events from one object to another |
| parse | loads data to the component from an inline data source |
| queryView | returns inner element/elements of a widget that correspond(s) to the defined parameters |
| refresh | repaints the whole view or a specific item |
| registerType | registers a new editor type for property sheet elements |
| render | renders the specified item or the whole component |
| resize | adjusts the view to a new size |
| scrollTo | scrolls the data container to a certain position |
| setValues | sets values into the inputs of a form/toolbar/property sheet control |
| show | makes the component visible |
| showItem | scrolls the property sheet to make the specified property visible |
| sync | allows you to sync two copies of data (all or just a part of it) from one DataCollection to another |
| unbind | breaks "bind" link |
| unblockEvent | cancels events blocking that was enabled by the 'blockEvent' command |
| updateItem | an alias for refresh, repaints the property view |
| validateEditor | validates data in currently active editor |
Events
| onAfterContextMenu | fires after the context menu was called in the item area |
| onAfterEditStart | fires after edit operation was initiated, editor opened and ready for input |
| onAfterEditStop | fires after the edit operation is finished |
| onAfterLoad | fires after data loading is complete |
| onAfterRender | occurs immediately after the component has been rendered. |
| onAfterScroll | occurs when some webix view has been scrolled |
| onBeforeContextMenu | fires before the context menu is called in the item area |
| onBeforeEditStart | fires before edit operation is initiated |
| onBeforeEditStop | fires before the edit stop command is received |
| onBeforeLoad | fires immediately before data loading has started |
| onBeforeRender | occurs immediately before the component has been rendered |
| onBindRequest | fires when the component is ready to receive data from the master component |
| onBlur | fires when focus is moved out of the view |
| onCheck | fires on checking/unchecking a checkbox |
| onDestruct | occurs when component destroyed |
| onEnter | fires when the Enter key has been pressed |
| onFocus | fires when a view gets focus |
| onItemClick | fires when a component item was clicked |
| onItemDblClick | fires when a component item was double-clicked |
| onItemSingleClick | allows distinguishing between single and double-click events |
| onKeyPress | occurs when keyboard key is pressed for the control in focus |
| onLiveEdit | fires when data was changed in the editor |
| onLoadError | fires when an error occurs during data loading (invalid server side response) |
| onLongTouch | fires on holding finger in some position for a certain period of time |
| onMouseMove | fires when the mouse was moved over the specified component |
| onMouseMoving | fires when the mouse was moved over the component |
| onMouseOut | fires when the mouse was moved out from the specified item |
| onSwipeX | occurs on a horizontal swipe movement |
| onSwipeY | occurs on a vertical swipe movement |
| onTimedKeyPress | fires after typing has been finished in the field |
| onTouchEnd | occurs when the touch event is ended |
| onTouchMove | occurs during touch movement |
| onTouchStart | fires when some webix view has been touched |
| onViewResize | fires when the size of a view has been changed by resizer |
| onViewShow | fires when any hidden view is shown |
Properties
| animate | defines the type of animation, with which the view is shown, if it is a Multiview cell |
| autoheight | adjusts the height of the property view to its contents |
| borderless | used to hide the component borders |
| complexData | enables complex data parsing mode |
| container | an HTML container (or its ID) where the component should be initialized |
| css | the name of the CSS class or the object with styles that will be applied to the view container |
| data | JavaScript array containing data for the component |
| datatype | the type of loaded data |
| disabled | indicates whether an item is enabled |
| editValue | defines which data item is editable (in case of several data items in the cell/line) |
| editable | allows/denies editing in the view |
| editaction | defines the action on which editors will be opened |
| elements | an array of property items |
| form | linked form |
| gravity | sets the view gravity |
| height | sets the height of the component |
| hidden | defines whether the view will be hidden initially |
| id | the ID of a widget |
| item | alias to the type property |
| keyPressTimeout | a delay between the key press and the action |
| map | defines data mapping |
| maxHeight | sets the maximum height for the view |
| maxWidth | sets the maximum width for the view |
| minHeight | sets the minimal height for the view |
| minWidth | sets the minimal width for the view |
| mouseEventDelay | the delay between a real mouse action and invoking the related events |
| nameWidth | sets the width of the first column (property names) |
| on | allows attaching custom handlers to inner events of the component |
| onClick | attaches a click handler for component parts with the specified CSS class |
| onContext | a property used to define custom context-click (right click) handlers for elements in the DataTable cells
|
| onDblClick | attaches a dblclick behavior for component items with the specified CSS class. |
| onMouseMove | attaches a mousemove behavior for component items with the specified CSS class. |
| scroll | enables/disables the scroll bar |
| scrollSpeed | the time during which the component is scrolled to the specified position (in milliseconds) |
| template | the component template |
| tooltip | sets a popup message next to the item when the cursor points to it |
| type | allows setting the inner height of items |
| url | the URL which the component will use to load data after its initialization |
| width | sets the width of a widget |
Other
| $getSize | returns the current size of the component |
| $height | the current height of the view |
| $scope | scope for resolving event and method names |
| $setNode | defines HTML element for the component |
| $setSize | sets the component size |
| $skin | the method which will be called when skin is defined |
| $tooltipIn | shows a tooltip |
| $tooltipMove | defines the tooltip while the cursor moves over a view or an HTML area |
| $tooltipOut | defines the behavior of a tooltip when the cursor is out of the target widget or HTML area |
| $view | reference to the top HTML element of the view |
| $width | the current width of the view |
| config | all options from the initial component configuration |
| name | indicates the name of the component (a read-only property) |
| on_click | redefines default click behavior for component items. |
| on_context | a property used to define custom context-click (right click) handlers for elements in widgets |
| on_dblclick | attaches a dblclick behavior for component items with the specified CSS class |
| on_edit | a set of flags that defines which types are editable |
| on_mouse_move | attaches a mouse move behavior for component items with the specified CSS class |
| on_render | a set of functions for custom editor types |
| type | currently used set of helpers for view rendering |
Back to top