ShapePaletteComponentProps
Props for the ShapePaletteComponent
Properties
allowClickToAdd?
optionalallowClickToAdd:boolean
When in tap mode, allow addition of new vertices simply by clicking, instead of requiring a shape be drawn. (When this is true, the drawing method also still works)
allowDropOnEdge?
optionalallowDropOnEdge:boolean|CanDropOnEdgeFilter
Whether or not to allow drop on edge. Defaults to false.
allowRotation?
optionalallowRotation:boolean
Whether or not to allow rotation of elements being dragged. Defaults to true.
autoEdgeConnect?
optionalautoEdgeConnect:boolean|AutoEdgeConnectOptions
Controls whether the palette will automatically connect a new vertex being dragged onto the canvas to existing vertices, if the shape definitions for the new vertex and/or the existing vertices have source/target elements. You can set this to simply 'true', and use defaults, or you can provide values for various options.
className?
optionalclassName:string
Optional class name to append to the root element's class list.
dataGenerator?
optionaldataGenerator:DataGeneratorFunction
Optional data generator to allow you to specify initial data for some element to be dragged. Note that you cannot override the object's type with this function. The palette will set the new object's type to match the type of the element that the user is dragging from the palette.
dragSize?
optionaldragSize:Size
Optional size to use for dragged elements.
fill?
optionalfill:string
Optional fill color to use for dragged elements. This should be in RGB or hex format, not a color like 'white' or 'cyan' etc.
iconSize?
optionaliconSize:Size
Optional size to use for icons.
initialSet?
optionalinitialSet:string
ID of the initial set to show, if any. When you have multiple shapes in a set you may want the palette to open up showing just one set.
inspector?
optionalinspector:boolean
When true, selecting an element in the canvas will cause its related shape to be selected in the palette. Defaults to true.
mode?
optionalmode:PaletteMode
Mode to use for the palette.
onVertexAdded?
optionalonVertexAdded:OnVertexAddedCallback
Optional callback to invoke when a vertex as been dragged onto the canvas
outline?
optionaloutline:string
Optional color to use for outline of dragged elements. Should be in RGB or hex format.
paletteStrokeWidth?
optionalpaletteStrokeWidth:number
Stroke width to use for shapes in palette. Defaults to 1.
preparedShapes?
optionalpreparedShapes:PreparedShape[]
Optional set of prepared shapes to show in the palette. When this is provided, the palette will only render these shapes, and not the contents of the shape library.
rotationSpeed?
optionalrotationSpeed:number
The number of milliseconds required to complete a full rotation of an element when the trigger key is held down. Defaults to 2000.
selectAfterDrop?
optionalselectAfterDrop:boolean
When true (which is the default), a newly dropped vertex will be set as the underlying model's selection.
showAllMessage?
optionalshowAllMessage:string
Message to use for the 'show all' option in the shape set drop down when there is more than one set of shapes. Defaults to Show all.
showGroups?
optionalshowGroups:boolean
Whether or not to show groups in the palette. Defaults to true.
showLabels?
optionalshowLabels:boolean
Optionally show each shape icon's label underneath it
surface?
optionalsurface:Surface
Surface to attach the drag/drop to. Optional; this component can extract the Surface from a SurfaceProvider, or from being a child of a SurfaceComponent. You'd only need to set this in certain advanced scenarios.
updateTypeOnPaletteTap?
optionalupdateTypeOnPaletteTap:boolean
When true, clicking on an entry in the palette will change the type of any selected vertices to that type. Defaults to false. This is a potentially destructive operation if the properties of the new shape type are not compatible with the old one.