ReactJS Popover Component

The Popover component for ReactJS represents a small overlay of content that is used to display secondary information of any element when it is clicked by a user.

Prerequisites

Refer to ReactJS Getting Started before you start with this help topic.

Configuration

The Popover component for ReactJS requires the following imports.

 
import React from 'react';
import ReactDOM from 'react-dom';
 
import JqxPopover from 'jqwidgets-react/react_jqxpopover.js';
 

Then we create our component class. Properties and methods are put as ReactJS props.

  
class App extends React.Component {
  render () {
    return (
        <JqxPopover 
            width={220} height={40}
            showCloseButton={true} selector={'#button'}
        />
    )
  }
}
 

Finally we render our class in the desired HTML element:

 
ReactDOM.render(<App />, document.getElementById('app'));
 

Events Methods & Properties

In order to bind to any event, change any property or call any method, we need a reference to the component.
For that we use the ReactJS "ref" Callback Attribute:

 
<JqxPopover ref='myPopover' width={220} height={40}..... />
 

Now, when we have a reference, we need to call the desired event/property/method.
This is done in the componentDidMount() ReactJS Component Lifecycle method.

 
class App extends React.Component {
  componentDidMount()
  {
     //your logic
  }
  render ()
  {
    return
    (
      ....
    )
  }
};
 

Events

The open event is triggered when the popover is opened.

The following example demonstrates how to add an event listener:

 
componentDidMount ()
{
 
  this.refs.myPopover.on('open', (event) =>
  {
     //your logic
  });
 
}
 

Methods & Properties

This is how you call methods & props:

  
//Open Method
this.refs.myPopover.open();
 
//Close Method
this.refs.myPopover.close();
  
//Get Properties
let height  = this.refs.myPopover.height();
 
//Set Properties
this.refs.myPopover.height(75);
 

Every component have a method setOptions which accepts a object as an argument. This object contains component settings.

 
this.refs.myPopover.setOptions({
    showArrow: true, width: 200, height: 50
})
 

Every component also have a method getOptions which returns a object containing the component settings.

 
let options = this.refs.myPopover.getOptions();
 

Popover Examples

Overview

The following example demonstrates how to create a Popover component.

 
import React from 'react';
import ReactDOM from 'react-dom';
 
import JqxPopover from 'jqwidgets-react/react_jqxpopover.js';
 
class App extends React.Component {
  render () {
    return (
        <div>
            <JqxPopover 
                width={220} height={40}
                showCloseButton={true} selector={'#button'}
             />
            <button id="button">Click me</button>
        </div>
    )
  }
}
ReactDOM.render(<App />, document.getElementById('app'));
 

Popover API