Angular Popover Properties

The function passed to this option enables you to specify a custom condition for widget closing. For instance, you can prevent closing until a user clicks a certain element.

var widgetOptions = {
    // ...
    closeOnOutsideClick: function(e) {
        return e.target === $("#someElement").get()[0];
    }
}

The default container is defined during the widget's initialization. It is the viewport, or the body element if the viewport is not found, or the parent element if the previous two are absent.

The specified container affects some features of the Popover: the area to be shaded, behavior on scrolling, etc.

See Also

• Customize the Content
• Custom Templates

This option accepts a value of one of the following types:

• Number
  The height in pixels.

• String
  A CSS-accepted measurement of height. For example, "55px", "80%", "auto", "inherit".

• Function
  A function returning either of the above. For example:

  JavaScript

  height: function() {
      return window.innerHeight / 1.5;
  }

If you assign only a string that specifies event names on which the widget is hidden, the widget will not apply any delay.

hideEvent: "dxhoverend"

This option accepts a value of one of the following types:

• Number
  The height in pixels.

• String
  A CSS-accepted measurement of height. For example, "55px", "80%", "auto", "inherit".

• Function
  A function returning either of the above. For example:

  JavaScript

  height: function() {
      return window.innerHeight / 1.5;
  }

This option accepts a value of one of the following types:

• Number
  The width in pixels.

• String
  A CSS-accepted measurement of width. For example, "55px", "80%", "auto", "inherit".

• Function
  A function returning either of the above. For example:

  JavaScript

  width: function() {
      return window.innerWidth / 1.5;
  }

This option accepts a value of one of the following types:

• Number
  The height in pixels.

• String
  A CSS-accepted measurement of height. For example, "55px", "80%", "auto", "inherit".

• Function
  A function returning either of the above. For example:

  JavaScript

  height: function() {
      return window.innerHeight / 1.5;
  }

This option accepts a value of one of the following types:

• Number
  The width in pixels.

• String
  A CSS-accepted measurement of width. For example, "55px", "80%", "auto", "inherit".

• Function
  A function returning either of the above. For example:

  JavaScript

  width: function() {
      return window.innerWidth / 1.5;
  }

You cannot access widget elements in this function because it is executed before they are ready. Use the onContentReady function instead.

Besides the position configuration object, the option can take on the following string values, which are shortcuts for the corresponding position configuration.

• "top" - places the popover over the target element
• "bottom" - places the popover under the target element
• "left" - places the popover to the left of the target element
• "right" - places the popover to the right of the target element

When this option is set to true, the widget text flows from right to left, and the layout of elements is reversed. To switch the entire application/site to the right-to-left representation, assign true to the rtlEnabled field of the object passed to the DevExpress.config(config) method.

DevExpress.config({
    rtlEnabled: true
});

See Also

• Right-to-Left Support Demo: DataGrid | Navigation Widgets | Editors

This option makes sense only if the shading option is set to true.

If you assign only a string that specifies event names on which the widget is shown, the widget will not apply any delay.

showEvent: "dxclick"

This option accepts one of the following values.

• A CSS selector, or a jQuery selector if you use jQuery

  target: '#targetElement';

• A jQuery wrapper

  target: $('#targetElement');

• A DOM element

  target: document.getElementById('#targetElement');

To align the Popover against this element, use the position option.

See Also

• Customize the Title
• Custom Templates

You can show and hide the widget by changing the value of an observable variable passed to this option.

This option accepts a value of one of the following types:

• Number
  The width in pixels.

• String
  A CSS-accepted measurement of width. For example, "55px", "80%", "auto", "inherit".

• Function
  A function returning either of the above. For example:

  JavaScript

  width: function() {
      return window.innerWidth / 1.5;
  }