Hoppa till innehåll

Bädda in

Embedding is a simple way to include the app in your website. Add the following code to your website:

<iframe src="https://web.butterfly.linwood.dev/embed" width="100%" height="500px" allowtransparency="true"></iframe>

Alternativ

AlternativTypStandardBeskrivning
sparaBoolean (true, false)trueEnable save. If disabled, only an exit button will be shown
editableBoolean (true, false)trueEnable editing. If disabled, the document will be read-only
språkSträng (…, system, användare)systemLanguage of the document. If system, the language will be detected from the browser. If user, the language will set to the users preference

Händelser

Exempel på hur du använder den:

const embedElement = document.querySelector('#butterfly');
embedElement.addEventListener('message', (data) => {
if(data.detail.type === 'save') {
console.log('Saving...', data.detail.message);
}
});

spara

The save event is emitted when the user clicks the save button.

Parametrar:

  • data (Type List<int>): The data of the document.

avsluta

The exit event is emitted when the user clicks the exit button.

Parametrar:

  • data (Type List<int>): The data of the document.

change

The change event is emitted when the user changes the document.

Parametrar:

  • data (Type List<int>): The data of the document.

Metoder

Exempel på hur du använder den:

const embedElement = document.querySelector('#butterfly');
embedElement.pushMessage('getData', {});
embedElement.addEventListener('message', (data) => {
if(data.detail.type === 'getData') {
console.log(data.detail.message);
}
});

getData

The getData method returns the data of the document.

No parameters. Returns: List<int>

setData

The setData method sets the data of the document.

Parametrar:

  • data (Type List<int>): The data of the document.

render

The render method renders the document to a png image.

Parametrar:

  • width (Type Number): The width of the image.
  • height (Type Number): The height of the image.
  • scale (Type Number): The scale of the image.
  • renderBackground (Type Boolean): If true, the background will be rendered.

Returns: String (Base64 encoded image)

renderSVG

The renderSVG method renders the document to a svg image.

Parametrar:

  • width (Type Number): The width of the image.
  • height (Type Number): The height of the image.
  • renderBackground (Type Boolean): If true, the background will be rendered.

Returns: String (SVG)