Package org.zkoss.zul

Class Popup

    • Constructor Detail

      • Popup

        public Popup()

      • Popup

        protected Popup​(boolean visible)

    • Method Detail

      • open

        public void open​(Component ref)
        Opens this popup right below the specified component at the client.

        By default the position "at_pointer" is assumed.(since 5.0.0)

        Parameters:
        ref - the reference component to position the popup. It cannot be null.
        Since:
        3.0.0
        See Also:
        open(Component, String)

      • open

        public void open​(Component ref,
                 java.lang.String position)
        Opens this popup right below the specified component at the client.

        In most cases, the popup is shown automatically when specified in the tooltip, popup and context properties (XulElement.setTooltip(java.lang.String), XulElement.setPopup(java.lang.String), and XulElement.setContext(java.lang.String)). However, if you want to show it manually, you can invoke this method directly.

        Possible values for the position attribute are:

        • before_start
          the popup appears above the anchor, aligned to the left.
        • before_center
          the popup appears above the anchor, aligned to the center.
        • before_end
          the popup appears above the anchor, aligned to the right.
        • after_start
          the popup appears below the anchor, aligned to the left.
        • after_center
          the popup appears below the anchor, aligned to the center.
        • after_end
          the popup appears below the anchor, aligned to the right.
        • start_before
          the popup appears to the left of the anchor, aligned to the top.
        • start_center
          the popup appears to the left of the anchor, aligned to the middle.
        • start_after
          the popup appears to the left of the anchor, aligned to the bottom.
        • end_before
          the popup appears to the right of the anchor, aligned to the top.
        • end_center
          the popup appears to the right of the anchor, aligned to the middle.
        • end_after
          the popup appears to the right of the anchor, aligned to the bottom.
        • overlap/top_left
          the popup overlaps the anchor, with anchor and popup aligned at top-left.
        • top_center
          the popup overlaps the anchor, with anchor and popup aligned at top-center.
        • overlap_end/top_right
          the popup overlaps the anchor, with anchor and popup aligned at top-right.
        • middle_left
          the popup overlaps the anchor, with anchor and popup aligned at middle-left.
        • middle_center
          the popup overlaps the anchor, with anchor and popup aligned at middle-center.
        • middle_right
          the popup overlaps the anchor, with anchor and popup aligned at middle-right.
        • overlap_before/bottom_left
          the popup overlaps the anchor, with anchor and popup aligned at bottom-left.
        • bottom_center
          the popup overlaps the anchor, with anchor and popup aligned at bottom-center.
        • overlap_after/bottom_right
          the popup overlaps the anchor, with anchor and popup aligned at bottom-right.
        • at_pointer
          the popup appears with the upper-left aligned with the mouse cursor.
        • after_pointer
          the popup appears with the top aligned with the bottom of the mouse cursor, with the left side of the popup at the horizontal position of the mouse cursor.

        Parameters:
        ref - the reference component to position the popup. It cannot be null.
        position - the descriptions above are for a locale where the UI is displayed left to right and top to bottom. In this case, before is the top, after is the bottom, start is the left and end is the right. For right to left locales, start is the right and end is the left.
        Since:
        3.6.1

      • close

        public void close()
        Closes this popup at the client.

        In most cases, the popup is closed automatically when the user clicks outside of the popup.

        Since:
        3.0.0