Class “Popover”

Object > NativeObject > Popup > Popover

An Popover represents a modal ui container that is shown above the apps content. It provides the root element of a new layout hierarchy in the form of its contentView property. User provided widgets can be attached to the contentView similarly to the tabris.contentView. In order to close the Popover the close() method can be used.

The appearance of the Popover depends on the device size: On larger devices (like tablets) the Popover is shown as a floating window whereas on smaller devices it is shown as a fullscreen sheet covering the entire app. When used on larger devices, the size has to be provided via the width and height properties.

Constructor public
Singleton No
Namespace tabris
Direct subclasses None
JSX support Element: <Popover/>
Child elements: None
Text content: Not supported

Example

const popover = new Popover();
popover.contentView.append(new TextView({text: 'Hello Popover'}));
popover.open();

See also:

Constructor

new Popover(properties?)

Parameter Type Optional Description
properties Properties<Popover> Yes Sets all key-value pairs in the properties object on the Popover.

Properties

anchor

iOS

An anchor Widget the Popover should attach to. When the anchor is given the Popover is positioned next to the anchor Widget and provides a visual indication of its relation. When omitted the Popover is positioned centered on the screen.

Type Widget
Settable Yes

contentView

The root widget element containing all children of Popover.

Type ContentView
Default ContentView
Settable No

This property can only be set via constructor or JSX. Once set, it cannot change anymore.

height

The height of the Popover when shown in windowed mode on large screen devices

Type dimension
Settable Yes

width

The width of the Popover when shown in windowed mode on large screen devices.

Type dimension
Settable Yes

Events

close

Fired when the Popover was closed.

Change Events

widthChanged

Fired when the width property has changed.

Parameter Type Description
value dimension The new value of width.

heightChanged

Fired when the height property has changed.

Parameter Type Description
value dimension The new value of height.

anchorChanged

Fired when the anchor property has changed.

Parameter Type Description
value Widget The new value of anchor.