px-popover

Overview

Px-popover is a Predix UI component used for displaying additional information to a user. The popover is similar to a tooltip, but is invoked by clicking instead of hovering on a target component, and can also contain richer content than a basic tooltip.

Usage

Prerequisites

1. node.js
2. npm
3. bower
4. webcomponents-lite.js polyfill

Node, npm, and bower are necessary to install the component and dependencies. webcomponents.js adds support for web components and custom elements to your application.

Getting Started

First, install the component via bower on the command line:

bower install px-popover --save

Second, import the component in your application with the following tag in your head:

<link rel="import" href="/bower_components/px-popover/px-popover.html"/>

Finally, use the component in your application:

Top popover

<div class="sample-container">
    <button id="btnUp" type="button" name="button">Up</button>
    <px-popover
        for="btnUp"
        orientation="top"
        popover-title="Top Popover"
        popover-body="Lorem ipsum dolor sit amet, consectetur elit, sed do eiusmod.">
    </px-popover>
</div>

Bottom popover

<div class="sample-container">
    <button id="btnUp" type="button" name="button">Bottom</button>
    <px-popover
        for="btnUp"
        orientation="bottom"
        popover-title="Bottom Popover"
        popover-body="Lorem ipsum dolor sit amet, consectetur elit, sed do eiusmod.">
    </px-popover>
</div>

Popover in a Relative position ancestor

<div class="sample-container" style="position:relative">
...
  <div style="position:relative>"
    <button id="btnRel" type="button" name="button">Bottom</button>
    <px-popover
        for="btnRel"
        orientation="bottom"
        popover-title="Bottom Popover"
        popover-body="Lorem ipsum dolor sit amet, consectetur elit, sed do eiusmod."
        position="relative" >
    </px-popover>
  </div>
  ...
</div>

Layout

The px-popover component has a fixed width but will grow vertically relative to its contents.

Documentation

Read the full API and view the demo here.

Local Development

From the component's directory...

$ npm install
$ bower install
$ gulp sass

From the component's directory, to start a local server run:

$ gulp serve

Navigate to the root of that server (e.g. http://localhost:8080/) in a browser to open the API documentation page, with link to the "Demo" / working examples.

GE Coding Style Guide

GE JS Developer's Guide

---

Known Issues

• Transformations on the target with position relative parent do not work. Instead, apply the transformation to the parent div so the popover gets it too.

Please use Github Issues to submit any bugs you might find.