Class: DialogHelper

container

Element

The parent node to append to.

Returns

Node

A Node that is the appended child (aChild), except when aChild is a DocumentFragment, in which case the empty DocumentFragment is returned.

Inherited from

UITool.appendElement

createElement()

Call Signature

createElement(
   doc,
   tagName,
   props?): DocumentFragment;

Defined in: src/tools/ui.ts:78

Create DocumentFragment.

Parameters

doc

Document

tagName

"fragment"

props?

FragmentElementProps

Returns

DocumentFragment

Example

const frag: DocumentFragment = ui.createElement(document, "fragment", {
  children: [{ tag: "h1", properties: { innerText: "Hello World!" } }],
});

Inherited from

Call Signature

createElement<HTML_TAG, T>(
   doc,
   tagName,
   props?): T;

Defined in: src/tools/ui.ts:113

Create HTMLElement.

Type Parameters

HTML_TAG

HTML_TAG extends keyof HTMLElementTagNameMap

T

Parameters

doc

Document

tagName

HTML_TAG

props?

HTMLElementProps

Returns

T

Examples

const div: HTMLDivElement = ui.createElement(document, "div");

Attributes(for elem.setAttribute()), properties(for elem.prop=), listeners, and children.

const div: HTMLDivElement = ui.createElement(document, "div", {
  id: "hi-div",
  skipIfExists: true,
  listeners: [{ type: "click", listener: (e) => ui.log("Clicked!") }],
  children: [
    { tag: "h1", properties: { innerText: "Hello World!" } },
    { tag: "a", attributes: { href: "https://www.zotero.org" } },
  ],
});

Inherited from

Call Signature

createElement<XUL_TAG, T>(
   doc,
   tagName,
   props?): T;

Defined in: src/tools/ui.ts:128

Create XULElement.

Type Parameters

XUL_TAG

XUL_TAG extends keyof XULElementTagNameMap

T

Parameters

doc

Document

tagName

XUL_TAG

props?

XULElementProps

Returns

T

See

ElementProps

Example

const menuitem: XULMenuItem = ui.createElement(document, "menuitem", {
  attributes: { label: "Click Me!" },
});

Inherited from

Call Signature

createElement<SVG_TAG, T>(
   doc,
   tagName,
   props?): T;

Defined in: src/tools/ui.ts:138

Create SVGElement

Type Parameters

SVG_TAG

SVG_TAG extends keyof SVGElementTagNameMap

T

Parameters

doc

Document

tagName

SVG_TAG

props?

SVGElementProps

Returns

T

Inherited from

Call Signature

createElement(
   doc,
   tagName,
   props?): HTMLElement | SVGElement | XULElement;

Defined in: src/tools/ui.ts:148

Create Element

Parameters

doc

Document

tagName

string

props?

ElementProps

Returns

HTMLElement | SVGElement | XULElement

Inherited from

Call Signature

createElement(
   doc,
   tagName,
   namespace?,
   enableElementRecord?): DocumentFragment | HTMLElement | SVGElement | XULElement;

Defined in: src/tools/ui.ts:160

Parameters

doc

Document

target document, e.g. Zotero main window.document

tagName

string

element tag name, e.g. hbox, div

namespace?

default "html"

"html" | "svg" | "xul"

enableElementRecord?

boolean

If current element will be recorded and maintained by toolkit. If not set, use this.enableElementRecordGlobal

Returns

DocumentFragment | HTMLElement | SVGElement | XULElement

Deprecated

Inherited from

UITool.createXULElement

createXULElement()

createXULElement(doc, type): XULElement;

Defined in: src/basic.ts:212

Create an XUL element

For Zotero 6, use createElementNS;

For Zotero 7+, use createXULElement.

Parameters

doc

Document

type

string

Returns

XULElement

Example

Create a <menuitem>:

const compat = new ZoteroCompat();
const doc = compat.getWindow().document;
const elem = compat.createXULElement(doc, "menuitem");

Inherited from

getGlobal()

Call Signature

getGlobal(k): typeof Zotero;

Defined in: src/basic.ts:93

Alpha

Parameters

k

"Zotero" | "zotero"

Returns

typeof Zotero

Inherited from

Call Signature

getGlobal(k): ZoteroPane;

Defined in: src/basic.ts:98

Alpha

Parameters

k

"ZoteroPane" | "ZoteroPane_Local"

Returns

ZoteroPane

Inherited from

Call Signature

getGlobal(k): Zotero_Tabs;

Defined in: src/basic.ts:103

Alpha

Parameters

k

"Zotero_Tabs"

Returns

Zotero_Tabs

Inherited from

Call Signature

getGlobal(k): any;

Defined in: src/basic.ts:108

Alpha

Parameters

k

"Zotero_File_Interface"

Returns

any

Inherited from

Call Signature

getGlobal(k): any;

Defined in: src/basic.ts:113

Alpha

Parameters

k

"Zotero_File_Exporter"

Returns

any

Inherited from

Call Signature

getGlobal(k): any;

Defined in: src/basic.ts:118

Alpha

Parameters

k

"Zotero_LocateMenu"

Returns

any

Inherited from

Call Signature

getGlobal(k): any;

Defined in: src/basic.ts:123

Alpha

Parameters

k

"Zotero_Report_Interface"

Returns

any

Inherited from

Call Signature

getGlobal(k): any;

Defined in: src/basic.ts:128

Alpha

Parameters

k

"Zotero_Timeline_Interface"

Returns

any

Inherited from

Call Signature

getGlobal(k): any;

Defined in: src/basic.ts:133

Alpha

Parameters

k

"Zotero_Tooltip"

Returns

any

Inherited from

Call Signature

getGlobal(k): ZoteroContextPane;

Defined in: src/basic.ts:138

Alpha

Parameters

k

"ZoteroContextPane"

Returns

ZoteroContextPane

Inherited from

Call Signature

getGlobal(k): any;

Defined in: src/basic.ts:143

Alpha

Parameters

k

"ZoteroItemPane"

Returns

any

Inherited from

Call Signature

getGlobal<K, GLOBAL>(k): GLOBAL[K];

Defined in: src/basic.ts:148

Alpha

Type Parameters

K

GLOBAL

GLOBAL extends typeof globalThis

Parameters

k

K

Returns

GLOBAL[K]

Inherited from

Call Signature

getGlobal(k): any;

Defined in: src/basic.ts:156

Get global variables.

Parameters

k

string

Global variable name, Zotero, ZoteroPane, window, document, etc.

Returns

any

Inherited from

insertElementBefore()

insertElementBefore(properties, referenceNode): undefined | Node;

Defined in: src/tools/ui.ts:334

Inserts a node before a reference node as a child of its parent node.

Parameters

properties

TagElementProps

UITool.insertElementBefore

referenceNode

Element

The node before which newNode is inserted.

Returns

undefined | Node

Node

Inherited from

isXULElement()

isXULElement(elem): boolean;

Defined in: src/basic.ts:189

If it's an XUL element

Parameters

elem

Element

Returns

boolean

Inherited from

UITool.isXULElement

log()

log(...data): void;

Defined in: src/basic.ts:221

Output to both Zotero.debug and console.log

Parameters

data

...any

e.g. string, number, object, ...

Returns

void

Inherited from

UITool.log

open()

open(title, windowFeatures): DialogHelper;

Defined in: src/helpers/dialog.ts:185

Open the dialog

Parameters

title

string

Window title

windowFeatures

alwaysRaised?

boolean

Is the window always at the top.

centerscreen?

boolean

Open window at the center of screen.

fitContent?

boolean

Resize the window to content size after elements are loaded.

height?

number

Ignored if fitContent is true.

left?

number

noDialogMode?

boolean

Dialog mode window only has a close button. Set true to make maximize and minimize button visible.

resizable?

boolean

If window is resizable.

top?

number

width?

number

Ignored if fitContent is true.

Returns

DialogHelper

parseXHTMLToFragment()

parseXHTMLToFragment(
   str,
   entities,
   defaultXUL): DocumentFragment;

Defined in: src/tools/ui.ts:380

Parse XHTML to XUL fragment. For Zotero 6.

To load preferences from a Zotero 7's .xhtml, use this method to parse it.

Parameters

str

string

xhtml raw text

entities

string[] = []

dtd file list ("chrome://xxx.dtd")

defaultXUL

boolean = true

true for default XUL namespace

Returns

DocumentFragment

Inherited from

UITool.parseXHTMLToFragment

patch()

patch<T, K>(
   object,
   funcSign,
   ownerSign,
   patcher): void;

Defined in: src/basic.ts:300

Patch a function

Type Parameters

T

T

K

K extends string | number | symbol

Parameters

object

T

The owner of the function

funcSign

K

The signature of the function(function name)

ownerSign

string

The signature of patch owner to avoid patching again

patcher

(fn) => T[K]

The new wrapper of the patched function

Returns

void

Deprecated

Use PatchHelper instead.

Inherited from

UITool.patch

removeListenerCallback()

removeListenerCallback<T>(type, callback): void;

Defined in: src/basic.ts:337

Remove a Zotero event listener callback

Type Parameters

T

T extends keyof ListenerCallbackMap

Parameters

type

T

Event type

callback

ListenerCallbackMap[T]

Event callback

Returns

void

Inherited from

UITool.removeListenerCallback

replaceElement()

replaceElement(properties, oldNode): undefined | Node;

Defined in: src/tools/ui.ts:358

Replace oldNode with a new one.

Parameters

properties

ElementProps & object