Using Input API

Input API

The Input API is a framework that allows your plugin to show a full-size view with multiple inputs to get user input data.

Text Dialog

buildfire.input.showTextDialog(options, callback)

Options Object | [Object]

• placeholder - Will be used as the input's placeholder.
• saveText - Will be used to complete the input and go to next step.
• cancelText - Will be used to cancel the input and return.
• doneText - Will be used when there are multiple steps and you have reached the end. Defaults to saveText.
• maxLength - set max length of input allowed.
• defaultValue - set pre-existing value of the input. Usually used during edits.
• attachments - Object specifying which attachments to enable
  • images Object

    • { enable: Boolean, multiple: Boolean }

    • gifs Object * { enable: Boolean }

Callback Function

(err, data) => { ... }

• err - If the options are invalid you will receive an error
• data - An object with the results[] and a cancelled property that can be true/false. If the input dialog was cancelled, the results array will contain up to where the user reached.
  • results is an array of the result of each step.

Each result can contain the following properties depending on what was enabled

• textValue - Text value the user entered
• images - Array of image urls
• gifs - Array of gif objects

data = {
	cancelled: false,
	results: [
		{ textValue: "...", images: [], gifs: [{...}, {...}] }
	]
}

Example

buildfire.input.showTextDialog({
	placeholder:"Enter your title here"
	,saveText:"Set"
	,maxLength:50
	,defaultValue:subscriberTitle.innerHTML
}, (e,response)=>{
	if(e || response.cancelled) return;
	subscriberTitle.innerHTML = response.results[0].textValue;
});

Multiple Inputs

Some times you want the user to enter multiple things in order. To do this you can pass multiple option objects in an array.

Example

const steps = [options1, options2, options3];

buildfire.input.showTextDialog(steps, callback);

List Dialog

buildfire.input.showTextDialog(options, callback)

Options Object | [Object]

• title - String. Will render as the dialog's title.
• multiSelect - Boolean. If true, the dialog allows multiple selections and the options render as checkboxes.
• listItems - Array. List of options to present to the user.
  • text - String. Title of the option.
  • value - String. Value of the option.
• cancelButton - Object
  • text - String. This appears as the text in the button. Defaults to Cancel
  • value - String. This is the value attributed to the button. Defaults to cancel
• confirmButton - Object
  • text - String. This appears as the text in the button. Defaults to Ok
  • value - String. This is the value attributed to the button. Defaults to ok

Callback Function

(error, result) => {...}

• err - If the options are invalid you will receive an error
• data - An object with the selected[] and a cancelled property that can be true/false. If the input dialog was cancelled, the selected array will still contain the user's selections.

data = {
	cancelled: false,
	selected: [
		{ value: "..." }
	]
}