GradientEditorRoot

GradientEditorRoot is a headless root primitive for gradient editing.

It owns:

• active stop state
• subtype switching
• stop add/remove/update logic
• active color editing
• derived bar background

Props

Prop	Default	Type
fill* Current gradient fill value.	—	Fill

Events

Event	Payload	Description
update	fill: Fill	Emitted when the gradient fill changes.

Slots

Slot	Props	Description
default	editor state + handlers	Full gradient editor render contract.

Default slot props

{
  stops: GradientStop[]
  subtype: GradientSubtype
  subtypes: Array<{ value: GradientSubtype; label: string }>
  activeStopIndex: number
  activeColor: Color
  barBackground: string
  setSubtype: (type: GradientSubtype) => void
  selectStop: (index: number) => void
  addStop: () => void
  removeStop: (index: number) => void
  updateStopPosition: (index: number, position: number) => void
  updateStopColor: (index: number, hex: string) => void
  updateStopOpacity: (index: number, opacity: number) => void
  updateActiveColor: (color: Color) => void
  dragStop: (index: number, position: number) => void
}

Example

<GradientEditorRoot :fill="fill" @update="fill = $event" v-slot="ctx">
  <MyGradientUI v-bind="ctx" />
</GradientEditorRoot>

Related APIs

• GradientEditorBar
• GradientEditorStop