Package com.vaadin.ui

Class Panel

    • Field Detail

      • actionManager

        protected ActionManager actionManager
        Keeps track of the Actions added to this component, and manages the painting and handling as well.

    • Constructor Detail

      • Panel

        public Panel()
        Creates a new empty panel.

      • Panel

        public Panel​(Component content)
        Creates a new empty panel which contains the given content.
        Parameters:
        content - the content for the panel.

      • Panel

        public Panel​(String caption)
        Creates a new empty panel with caption.
        Parameters:
        caption - the caption used in the panel (HTML).

      • Panel

        public Panel​(String caption,
             Component content)
        Creates a new empty panel with the given caption and content.
        Parameters:
        caption - the caption of the panel (HTML).
        content - the content used in the panel.

    • Method Detail

      • setCaption

        public void setCaption​(String caption)
        Description copied from interface: Component
        Sets the caption of the component.

        A caption is an explanatory textual label accompanying a user interface component, usually shown above, left of, or inside the component. Icon (see setIcon() is closely related to caption and is usually displayed horizontally before or after it, depending on the component and the containing layout.

        The caption can usually also be given as the first parameter to a constructor, though some components do not support it. 

         RichTextArea area = new RichTextArea();
 area.setCaption("You can edit stuff here");
 area.setValue("<h1>Helpful Heading</h1>"
         + "<p>All this is for you to edit.</p>");

        The contents of a caption are automatically quoted, so no raw HTML can be rendered in a caption. The validity of the used character encoding, usually UTF-8, is not checked.

        The caption of a component is, by default, managed and displayed by the layout component or component container in which the component is placed. For example, the VerticalLayout component shows the captions left-aligned above the contained components, while the FormLayout component shows the captions on the left side of the vertically laid components, with the captions and their associated components left-aligned in their own columns. The CustomComponent does not manage the caption of its composition root, so if the root component has a caption, it will not be rendered. Some components, such as Button and Panel, manage the caption themselves and display it inside the component.

        Specified by:
        setCaption in interface Component
        Overrides:
        setCaption in class AbstractComponent
        Parameters:
        caption - the new caption for the component. If the caption is null, no caption is shown and it does not normally take any space

      • paintContent

        public void paintContent​(PaintTarget target)
                  throws PaintException
        Description copied from interface: LegacyComponent

        Paints the Paintable into a UIDL stream. This method creates the UIDL sequence describing it and outputs it to the given UIDL stream.

        It is called when the contents of the component should be painted in response to the component first being shown or having been altered so that its visual representation is changed.

        Specified by:
        paintContent in interface LegacyComponent
        Parameters:
        target - the target UIDL stream where the component should paint itself to.
        Throws:
        PaintException - if the paint operation failed.

      • changeVariables

        public void changeVariables​(Object source,
                            Map<String,​Object> variables)
        Called when one or more variables handled by the implementing class are changed.
        Specified by:
        changeVariables in interface VariableOwner
        Parameters:
        source - the Source of the variable change. This is the origin of the event. For example in Web Adapter this is the request.
        variables - the Mapping from variable names to new variable values.
        See Also:
        VariableOwner.changeVariables(Object, Map)

      • getScrollLeft

        public int getScrollLeft()
        Description copied from interface: Scrollable
        Gets scroll left offset.

        Scrolling offset is the number of pixels this scrollable has been scrolled right.

        Specified by:
        getScrollLeft in interface Scrollable
        Returns:
        Horizontal scrolling position in pixels.

      • getScrollTop

        public int getScrollTop()
        Description copied from interface: Scrollable
        Gets scroll top offset.

        Scrolling offset is the number of pixels this scrollable has been scrolled down.

        Specified by:
        getScrollTop in interface Scrollable
        Returns:
        Vertical scrolling position in pixels.

      • setScrollLeft

        public void setScrollLeft​(int scrollLeft)
        Description copied from interface: Scrollable
        Sets scroll left offset.

        Scrolling offset is the number of pixels this scrollable has been scrolled right.

        Specified by:
        setScrollLeft in interface Scrollable
        Parameters:
        scrollLeft - the xOffset.

      • setScrollTop

        public void setScrollTop​(int scrollTop)
        Description copied from interface: Scrollable
        Sets scroll top offset.

        Scrolling offset is the number of pixels this scrollable has been scrolled down.

        The scrolling position is limited by the current height of the content area. If the position is below the height, it is scrolled to the bottom. However, if the same response also adds height to the content area, scrolling to bottom only scrolls to the bottom of the previous content area.

        Specified by:
        setScrollTop in interface Scrollable
        Parameters:
        scrollTop - the yOffset.

      • removeActionHandler

        public void removeActionHandler​(Action.Handler actionHandler)
        Description copied from interface: Action.Container
        Removes a previously registered action handler for the contents of this container.
        Specified by:
        removeActionHandler in interface Action.Container
        Parameters:
        actionHandler - the handler to be removed.

      • removeAllActionHandlers

        public void removeAllActionHandlers()
        Removes all action handlers.

      • addClickListener

        public Registration addClickListener​(MouseEvents.ClickListener listener)
        Add a click listener to the Panel. The listener is called whenever the user clicks inside the Panel. Also when the click targets a component inside the Panel, provided the targeted component does not prevent the click event from propagating.
        Parameters:
        listener - The listener to add, not null
        Returns:
        a registration object for removing the listener
        Since:
        8.0
        See Also:
        Registration

      • setTabIndex

        public void setTabIndex​(int tabIndex)
        Sets the tabulator index of the Focusable component. The tab index property is used to specify the order in which the fields are focused when the user presses the Tab key. Components with a defined tab index are focused sequentially first, and then the components with no tab index. 
         Form loginBox = new Form();
 loginBox.setCaption("Login");
 layout.addComponent(loginBox);

 // Create the first field which will be focused
 TextField username = new TextField("User name");
 loginBox.addField("username", username);

 // Set focus to the user name
 username.focus();

 TextField password = new TextField("Password");
 loginBox.addField("password", password);

 Button login = new Button("Login");
 loginBox.getFooter().addComponent(login);

 // An additional component which natural focus order would
 // be after the button.
 CheckBox remember = new CheckBox("Remember me");
 loginBox.getFooter().addComponent(remember);

 username.setTabIndex(1);
 password.setTabIndex(2);
 remember.setTabIndex(3); // Different than natural place
 login.setTabIndex(4);

        After all focusable user interface components are done, the browser can begin again from the component with the smallest tab index, or it can take the focus out of the page, for example, to the location bar.

        If the tab index is not set (is set to zero), the default tab order is used. The order is somewhat browser-dependent, but generally follows the HTML structure of the page.

        A negative value means that the component is completely removed from the tabulation order and can not be reached by pressing the Tab key at all.

        Specified by:
        setTabIndex in interface Component.Focusable
        Parameters:
        tabIndex - the tab order of this component. Indexes usually start from 1. Zero means that default tab order should be used. A negative value means that the field should not be included in the tabbing sequence.
        See Also:
        Component.Focusable.getTabIndex()

      • getState

        protected PanelState getState()
        Description copied from class: AbstractComponent
        Returns the shared state bean with information to be sent from the server to the client. Subclasses should override this method and set any relevant fields of the state returned by super.getState().
        Overrides:
        getState in class AbstractSingleComponentContainer
        Returns:
        updated component shared state

      • readDesign

        public void readDesign​(org.jsoup.nodes.Element design,
                       DesignContext designContext)
        Description copied from interface: Component
        Reads the component state from the given design.

        The component is responsible not only for updating its own state but also for ensuring that its children update their state based on the design.

        It is assumed that the component is in its default state when this method is called. Reading should only take into consideration attributes specified in the design and not reset any unspecified attributes to their defaults.

        This method must not modify the design.

        Specified by:
        readDesign in interface Component
        Overrides:
        readDesign in class AbstractSingleComponentContainer
        Parameters:
        design - The element to obtain the state from
        designContext - The DesignContext instance used for parsing the design

      • writeDesign

        public void writeDesign​(org.jsoup.nodes.Element design,
                        DesignContext designContext)
        Description copied from interface: Component
        Writes the component state to the given design.

        The component is responsible not only for writing its own state but also for ensuring that its children write their state to the design.

        This method must not modify the component state.

        Specified by:
        writeDesign in interface Component
        Overrides:
        writeDesign in class AbstractSingleComponentContainer
        Parameters:
        design - The element to write the component state to. Any previous attributes or child nodes are not cleared.
        designContext - The DesignContext instance used for writing the design