Advanced API
Widget Config and Events
Reference for behavior configuration and lifecycle event callbacks.
Widget config options
| Option | Type | Default | Description |
|---|---|---|---|
zIndex | number | 2147483647 | Widget popover z-index |
transitionDuration | number | 200 | Animation duration in ms |
popoverGap | number | 8 | Gap between trigger and popover |
Floating button options
| Option | Type | Default | Description |
|---|---|---|---|
position | "bottom-right" | "bottom-left" | "bottom-right" | Corner position |
offset | number | 20 | Viewport edge offset |
color | string | "#1e293b" | Auto-FAB background color |
size | number | 48 | Auto-FAB diameter |
zIndex | number | 2147483646 | FAB stacking order |
defaultType | "bug" | "feature" | "feedback" | undefined | Skip menu on click |
tooltip | string | "Send Feedback" | Auto-FAB tooltip |
Event callbacks
| Event | Signature | Description |
|---|---|---|
onOpen | () => void | Widget popover opened |
onClose | () => void | Widget popover closed |
onSubmit | (payload: SubmissionPayload) => void | Triggered before API call |
onSubmitSuccess | (payload: SubmissionPayload) => void | Triggered after successful API call |
onSubmitError | (error: Error, payload: SubmissionPayload) => void | Triggered on failed API call |
Example event object
{ onOpen: () => console.log("open"), onClose: () => console.log("close"), onSubmit: (payload) => console.log("submitting", payload), onSubmitSuccess: (payload) => console.log("success", payload), onSubmitError: (error, payload) => console.error("error", error, payload),}