Package com.vaadin.ui

See:
Description

Interface Summary

AbstractComponent.ComponentErrorEvent
AbstractComponent.ComponentErrorHandler
AbstractSelect.Filtering	Interface for option filtering, used to filter options based on user entered value.
AbstractSelect.NewItemHandler
Button.ClickListener	Interface for listening for a Button.ClickEvent fired by a Component.
Component	Component is the top-level interface that is and must be implemented by all Vaadin components.
Component.ErrorListener	Listener interface for receiving Component.Errorss.
Component.Focusable	A sub-interface implemented by components that can obtain input focus.
Component.Listener	Listener interface for receiving Component.Events.
ComponentContainer	Extension to the Component interface which adds to it the capacity to contain other components.
ComponentContainer.ComponentAttachListener	Component attach listener interface.
ComponentContainer.ComponentDetachListener	Component detach listener interface.
Field
FieldFactory	Deprecated. FieldFactory was split into two lighter interfaces in 6.0 Use FormFieldFactory or TableFieldFactory or both instead.
FormFieldFactory	Factory interface for creating new Field-instances based on Item, property id and uiContext (the component responsible for displaying fields).
Layout	Extension to the ComponentContainer interface which adds the layouting control to the elements in the container.
Layout.AlignmentHandler	AlignmentHandler is most commonly an advanced Layout that can align its components.
Layout.MarginHandler	This type of layout supports automatic addition of margins (space around its components).
Layout.SpacingHandler	This type of layout supports automatic addition of space between its components.
LoginForm.LoginListener	Login listener is a class capable to listen LoginEvents sent from LoginBox
MenuBar.Command	This interface contains the layer for menu commands of the MenuBar class.
PopupView.Content	Used to deliver customized content-packages to the PopupView.
PopupView.PopupVisibilityListener	Defines a listener that can receive a PopupVisibilityEvent when the visibility of the popup changes.
SplitPanel.SplitterClickListener	SplitterClickListener interface for listening for SplitterClickEvent fired by a SplitPanel.
Table.CellStyleGenerator	Allow to define specific style on cells (and rows) contents.
Table.ColumnGenerator	Used to create "generated columns"; columns that exist only in the Table, not in the underlying Container.
TableFieldFactory	Factory interface for creating new Field-instances based on Container (datasource), item id, property id and uiContext (the component responsible for displaying fields).
TabSheet.CloseHandler	CloseHandler is used to process tab closing events.
TabSheet.SelectedTabChangeListener	Selected Tab Change Event listener
TabSheet.Tab
Tree.CollapseListener	Collapse event listener.
Tree.ExpandListener	Expand event listener.
Tree.ItemStyleGenerator	ItemStyleGenerator can be used to add custom styles to tree items.
Upload.FailedListener	Receives events when the uploads are finished, but unsuccessful.
Upload.FinishedListener	Receives the events when the uploads are ready.
Upload.ProgressListener	ProgressListener receives events to track progress of upload.
Upload.Receiver	Interface that must be implemented by the upload receivers to provide the Upload component an output stream to write the uploaded data.
Upload.StartedListener	Receives the events when the upload starts.
Upload.SucceededListener	Receives events when the uploads are successfully finished.
UriFragmentUtility.FragmentChangedListener	Listener that listens changes in URI fragment.
Window.CloseListener	An interface used for listening to Window close events.
Window.ResizeListener	Listener for window resize events.

Class Summary

AbsoluteLayout	AbsoluteLayout is a layout implementation that mimics html absolute positioning.
AbstractComponent	An abstract class that defines default implementation for the Component interface.
AbstractComponentContainer	Extension to AbstractComponent that defines the default implementation for the methods in ComponentContainer.
AbstractField	Abstract field component for implementing buffered property editors.
AbstractField.FocusShortcut	A ready-made ShortcutListener that focuses the given Focusable (usually a Field) when the keyboard shortcut is invoked.
AbstractLayout	An abstract class that defines default implementation for the Layout interface.
AbstractOrderedLayout
AbstractSelect	A class representing a selection of items the user has selected in a UI.
AbstractSelect.AcceptItem	This criterion accepts a only a Transferable that contains given Item (practically its identifier) from a specific AbstractSelect.
AbstractSelect.TargetItemIs	Criterion which accepts a drop only if the drop target is (one of) the given Item identifier(s).
AbstractSelect.VerticalLocationIs	An accept criterion to accept drops only on a specific vertical location of an item.
Accordion
Alignment	Class containing information about alignment of a component.
AlignmentUtils	Helper class for setting alignments using a short notation.
BaseFieldFactory	Deprecated. use DefaultFieldFactory or own implementations on FormFieldFactory or TableFieldFactory instead.
Button	A generic button component.
Button.ClickShortcut	A ShortcutListener specifically made to define a keyboard shortcut that invokes a click on the given button.
CheckBox
ComboBox	A filtering dropdown single-select.
Component.ErrorEvent	Class of all component originated error events.
Component.Event	Superclass of all component originated events.
ComponentContainer.ComponentAttachEvent	Component attach event sent when a component is attached to container.
ComponentContainer.ComponentDetachEvent	Component detach event sent when a component is detached from container.
CssLayout	CssLayout is a layout component that can be used in browser environment only.
CustomComponent	Custom component provides simple implementation of Component interface for creation of new UI components by composition of existing components.
CustomLayout	A container component with freely designed layout and style.
DateField	A date editor component that can be bound to any bindable Property.
DefaultFieldFactory	This class contains a basic implementation for both FormFieldFactory and TableFieldFactory.
DragAndDropWrapper
Embedded	Component for embedding external objects.
ExpandLayout	Deprecated. Deprecated in favor of the new OrderedLayout
Field.ValueChangeEvent	An Event object specifying the Field whose value has been changed.
Form	Form component provides easy way of creating and managing sets fields.
FormLayout	FormLayout is used by Form to layout fields.
GridLayout	A container that consists of components with certain coordinates (cell position) on a grid.
HorizontalLayout	Horizontal layout HorizontalLayout is a component container, which shows the subcomponents in the order of their addition (horizontally).
InlineDateField	A date entry component, which displays the actual date selector inline.
Label	Label component for showing non-editable short texts.
Layout.MarginInfo
Link	Link is used to create external or internal URL links.
ListSelect	This is a simple list select without, for instance, support for new items, lazyloading, and other advanced features.
LoginForm	LoginForm is a Vaadin component to handle common problem among Ajax applications: browsers password managers don't fill dynamically created forms like all those UI elements created by Vaadin.
MenuBar	A class representing a horizontal menu bar.
NativeButton
NativeSelect	This is a simple drop-down select without, for instance, support for multiselect, new items, lazyloading, and other advanced features.
OptionGroup	Configures select to be used as an option group.
OrderedLayout	Deprecated. Replaced by VerticalLayout/HorizontalLayout.
Panel	Panel - a simple single component container.
PopupDateField	A date entry component, which displays the actual date selector as a popup.
PopupView	A component for displaying a two different views to data.
ProgressIndicator	ProgressIndicator is component that shows user state of a process (like long computing or file upload) ProgressIndicator has two mainmodes.
RichTextArea	A simple RichTextArea to edit HTML format text.
Select	A class representing a selection of items the user has selected in a UI.
Slider	A component for selecting a numerical value within a range.
SplitPanel	SplitPanel.
Table	Table is used for representing data or components in a pageable and selectable table.
Table.TableDropCriterion	Lazy loading accept criterion for Table.
TabSheet	Tabsheet component.
TextField	A text editor component that can be bound to any bindable Property.
Tree	Tree component.
Tree.TargetItemAllowsChildren	A criterion that accepts Transferable only directly on a tree node that can have children.
Tree.TreeDropCriterion	Lazy loading accept criterion for Tree.
TwinColSelect	Multiselect component with two lists: left side for available items and right side for selected items.
Upload	Component for uploading files from client to server.
UriFragmentUtility	Experimental web browser dependent component for URI fragment (part after hash mark "#") reading and writing.
VerticalLayout	Vertical layout VerticalLayout is a component container, which shows the subcomponents in the order of their addition (vertically).
Window	Application window component.
Window.CloseShortcut	A ShortcutListener specifically made to define a keyboard shortcut that closes the window.
Window.Notification	A notification message, used to display temporary messages to the user - for example "Document saved", or "Save failed".

Enum Summary

DragAndDropWrapper.DragStartMode
Table.TableDragMode	Modes that Table support as drag sourse.
Tree.TreeDragMode	Supported drag modes for Tree.

Exception Summary

Upload.UploadException

Annotation Types Summary

ClientWidget

Annotation defining the default client side counterpart in GWT terminal for Component.

Package com.vaadin.ui Description

Provides interfaces and classes in Vaadin.

Package Specification

Interface hierarchy

The general interface hierarchy looks like this:

Note that the above picture includes only the main interfaces. This package includes several other lesser sub-interfaces which are not significant in this scope. The interfaces not appearing here are documented with the classes that define them.

The Component interface is the top-level interface which must be implemented by all user interface components in Vaadin. It defines the common properties of the components and how the framework will handle them. Most simple components, such as Button, for example, do not need to implement the lower-level interfaces described below. Notice that also the classes and interfaces required by the component event framework are defined in Component.

The next level in the component hierarchy are the classes implementing the ComponentContainer interface. It adds the capacity to contain other components to Component with a simple API.

The third and last level is the Layout, which adds the concept of location to the components contained in a ComponentContainer. It can be used to create containers which contents can be positioned.

Component class hierarchy

The actual component classes form a hierarchy like this:

Underlined classes are abstract.

At the top level is AbstractComponent which implements the Component interface. As the name suggests it is abstract, but it does include a default implementation for all methods defined in Component so that a component is free to override only those functionalities it needs.

As seen in the picture, AbstractComponent serves as the superclass for several "real" components, but it also has a some abstract extensions. AbstractComponentContainer serves as the root class for all components (for example, panels and windows) who can contain other components. AbstractField, on the other hand, implements several interfaces to provide a base class for components that are used for data display and manipulation.