Skip to main content

<ExportControlsComponent/>

Provides a set of buttons allowing your users to export a given canvas as SVG, PNG or JPG.

info

This component only works when your surface is using a ShapeLibrary to render elements, or if you are using a Diagram.

Usage​

This component is context aware and will discover the Surface to attach itself to if there is a single surface in your app. Alternatively you can wrap your surface and export controls inside a SurfaceProvider, or you can declare the export controls component as a child of a surface.

<script>
import { defineComponent } from "vue"

export default defineComponent({
name:"my-app",
data:() => {
return {
...
}
}
})

</script>
<template>
<SurfaceComponent .../>
<ExportControlsComponent/>
</template>

Props​

ExportControlsComponentProps
Props for the ExportControlsComponent
NameTypeDescription
allowJpgExport?booleanDefaults to true.
allowPngExport?booleanDefaults to true.
allowSvgExport?booleanDefaults to true.
imageOptions?ImageExportUIOptionsOptions for image exports.
label?stringWhat to show in the label, if visible. Defaults to "Export:".
labelProperty?stringThe name of the property that holds the label for a vertex
margins?PointXYOptional margins to apply to both SVG and image exports. Will not override any margins specified in svgOptions or imageOptions.
showLabel?booleanWhether or not to show a label in front of the buttons. Defaults to true.
surfaceId?stringOptional ID of the surface to attach to. It is better to nest this component inside a SurfaceComponent or SurfaceProvider.
svgOptions?SvgExportUIOptionsOptions for SVG exports.