Extension Factories
Extension API
Extension Points

Modal

A modal extension renders a button that opens a modal, and allows to specify a custom HTML content to the body of it. It also provides a set of APIs to interact with this modal.

Supported attributes

NameTypeDescription
label *stringText to be used as the label of the link.
weightnumber

Determines the order in which this extension appears respect to others in the same location.

Extensions are displayed top to bottom or left to right in order of ascending weight.

onAction *function

signature: (modalAPI) => void

Method to be called when the product is ready to render the Modal. The plugin system will provide an API with methods to modify the title, content and actions of the modal.

Refer to Modal API documentation for more info.

* required

Always remember to check the documentation of each product's extension point and supported attributes.

Read more information about Revealing extension points on the page.

Supported annotations

NameTypeDescription
@clientside-extension *-Indicates that the next function is an extension factory to be consumed by the webpack plugin.
@extension-point *stringDefines the location where the extension will be rendered.
@conditionstring | Condition, UrlReadingCondition

Defines one or multiple conditions that must be satisfied for the extension to be displayed.

The conditions are evaluated on the server, and created with Java.

If one of the conditions is not met, the code of the extension won't be loaded in the client.

For more information about the conditions please refer to the examples of Web items documentation.

* required

Usage

1
2
import { ModalExtension } from '@atlassian/clientside-extensions';

/**
 * @clientside-extension
 * @extension-point reff.plugins-example-location
 */
export default ModalExtension.factory((extensionAPI, context) => {
    return {
        label: 'Open Modal',
        onAction(modalAPI) {
            modalAPI.setTitle('A cool modal with JS');

            modalAPI.onMount((container, modalOptions) => {
                // use the container to render your content in it...
                // use the modalOptions to interact with the modal after opened...
            });

            modalAPI.onUnmount(() => {
                // run your cleanup code here...
            });
        },
    };
});

With context definition

1
2
import { ModalExtension } from '@atlassian/clientside-extensions';

interface ExampleContext {
    issueId: string;
    title: string;
}

/**
 * @clientside-extension
 * @extension-point reff.plugins-example-location
 */
export default ModalExtension.factory<ExampleContext>((extensionAPI, context) => {
    return {
        label: 'Open Modal',
        onAction(modalAPI) {
            modalAPI.onMount((container) => {
                container.innerHTML = `
                  <h1>${context.title}</h1>
                  <p>Jira issue id: ${context.issueId}</p>
                `;
            });
        },
    };
});

Rate this page: