ui.suggest

A suggest control.

Can be used standalone or as an editor for other components. Check suggest documentation for more detailed description.

Constructor

webix.ui({
    view:"text", 
    width: 300,
    name:"country", 
    label:"Country", 
    value:"Belarus", suggest:[
        {id:1, value: "Albania"},
        {id:2, value: "Bhutan"},
        {id:3, value: "Colombia"},
        {id:4, value: "Denmark"},
        {id:5, value: "Germany"},
        {id:6, value: "Moldova"}
    ]         
});

Where to start

• Overview of Suggest List
• Samples

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
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)
enable	enables the calling view that was disabled by the 'disable' method
getBody	gets the UI view of the window body
getChildViews	returns child views of the calling component
getFormView	returns master form for the input
getItemId	returns the id of the suggest's item
getItemText	returns the rendered text of the suggest's item
getList	returns list view of the suggest
getMasterValue	returns current value of master control
getNode	returns the main HTML container for the calling object
getParentView	returns the parent view of the component
getSuggestion	returns id of top suggestion from the suggest list
getTopParentView	returns the top parent view
getValue	gets the ID of a selected item in the option list
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
linkInput	links a suggest list to an input field
mapEvent	routes events from one object to another
queryView	returns inner element/elements of a widget that correspond(s) to the defined parameters
resize	adjusts the view to a new size
resizeChildren	resizes all children of the calling component
setMasterValue	set value in master control
setPosition	sets window's position
setValue	selects an item in the options list
show	makes the component visible
unbind	breaks "bind" link
unblockEvent	cancels events blocking that was enabled by the 'blockEvent' command

onAfterScroll	occurs when some webix view has been scrolled
onBeforeShow	fires right after show() method is called for the window (popup) and before the window is shown
onBindRequest	fires when the component is ready to receive data from the master component
onBlur	fires when focus is moved out of the view
onDestruct	occurs when component destroyed
onEnter	fires when the Enter key has been pressed
onFocus	fires when a view gets focus
onHide	fires when window is hidden
onKeyPress	occurs when keyboard key is pressed for the control in focus
onLongTouch	fires on holding finger in some position for a certain period of time
onShow	fires when window is shown
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
onValueSuggest	some item selected in the suggest control
onViewMove	fires while view is moving
onViewMoveEnd	fires when view has stopped moving
onViewResize	fires on resizing a view
onViewShow	fires when any hidden view is shown

animate	defines the type of animation, with which the view is shown, if it is a Multiview cell
autofit	adjusts window size to the size of an html node it is initiated in
autofocus	sets focus on the window the moment it appears on the page
body	the content of window body: template, or a view configuration object
borderless	used to hide the component borders
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
disabled	indicates whether an item is enabled
escHide	toggles default 'hide on escape' behaviour
filter	custom filtering function
fitMaster	adjusts the size of the suggest box to the master control
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
input	points to an HTML input field that houses the suggest list
keyPressTimeout	a delay between the key press and the action
left	the left offset of the window
master	the master component id (a read-only property)
maxHeight	defines the maximum height of the view
maxWidth	defines the maximum width of the view
minHeight	sets the minimal height for the view
minWidth	sets the minimal width for the view
modal	switches window modality
on	allows attaching custom handlers to inner events of the component
padding	sets padding for all four sides of the widget
point	adds an arrow to a popup window or removes it
position	sets the position of the window relative to the the screen
relative	positions a popup window relative to the component it's connected with
resize	enables resizing of a widget
template	template which will be used to fill parent input from selected record
textValue	defines which field from suggest list will be used as text after selecting an option
toFront	places window above other windows on clicking it
top	the top offset of a window
type	defines the type of the suggest control
url	the URL which the component will use to load data after its initialization
width	sets the width of a widget
zIndex	the stack order of the component

$dragCreate	the method is called at the moment when drag-n-drop has started
$dragDestroy	the method is called at the moment when drag-n-drop has ended
$dragPos	defines the position of a dragged view
$enterKey	the method that will be called when the Enter key is pressed
$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
$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)

Back to top