71 lines
1.8 KiB
Markdown
71 lines
1.8 KiB
Markdown
|
---
|
||
|
|
title: GradientEditorBar
|
||
|
|
description: Primitive de barre déplaçable headless pour les points d'arrêt de dégradé.
|
||
|
|
---
|
||
|
|
|
||
|
|
# GradientEditorBar
|
||
|
|
|
||
|
|
`GradientEditorBar` est la primitive de barre déplaçable utilisée dans les éditeurs de dégradé.
|
||
|
|
|
||
|
|
## Props
|
||
|
|
|
||
|
|
<SdkPropsTable
|
||
|
|
:rows="[
|
||
|
|
{ name: 'stops', type: 'GradientStop[]', description: 'Points d\'arrêt de dégradé courants.', required: true },
|
||
|
|
{ name: 'activeStopIndex', type: 'number', description: 'Index du point d\'arrêt actif.', required: true },
|
||
|
|
{ name: 'barBackground', type: 'string', description: 'Chaîne CSS de fond pour la barre.', required: true }
|
||
|
|
]"
|
||
|
|
/>
|
||
|
|
|
||
|
|
## Événements
|
||
|
|
|
||
|
|
<SdkEventsTable
|
||
|
|
:rows="[
|
||
|
|
{ name: 'selectStop', payload: 'index: number', description: 'Émis quand un point d\'arrêt est sélectionné.' },
|
||
|
|
{ name: 'dragStop', payload: 'index: number, position: number', description: 'Émis pendant le déplacement d\'un point d\'arrêt.' }
|
||
|
|
]"
|
||
|
|
/>
|
||
|
|
|
||
|
|
## Slots
|
||
|
|
|
||
|
|
<SdkSlotsTable
|
||
|
|
:rows="[
|
||
|
|
{ name: 'default', props: 'état de la barre + handlers de déplacement', description: 'Contrat de rendu complet de la barre de dégradé.' }
|
||
|
|
]"
|
||
|
|
/>
|
||
|
|
|
||
|
|
### Props du slot par défaut
|
||
|
|
|
||
|
|
```ts
|
||
|
|
{
|
||
|
|
stops: GradientStop[]
|
||
|
|
activeStopIndex: number
|
||
|
|
barBackground: string
|
||
|
|
barRef: (el: unknown) => void
|
||
|
|
onStopPointerDown: (index: number, event: PointerEvent) => void
|
||
|
|
onPointerMove: (event: PointerEvent) => void
|
||
|
|
onPointerUp: () => void
|
||
|
|
draggingIndex: number | null
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Exemple
|
||
|
|
|
||
|
|
```vue
|
||
|
|
<GradientEditorBar
|
||
|
|
:stops="stops"
|
||
|
|
:active-stop-index="activeStopIndex"
|
||
|
|
:bar-background="barBackground"
|
||
|
|
@select-stop="selectStop"
|
||
|
|
@drag-stop="dragStop"
|
||
|
|
v-slot="ctx"
|
||
|
|
>
|
||
|
|
<MyGradientBar v-bind="ctx" />
|
||
|
|
</GradientEditorBar>
|
||
|
|
```
|
||
|
|
|
||
|
|
## API associées
|
||
|
|
|
||
|
|
- [GradientEditorRoot](./gradient-editor-root)
|
||
|
|
- [GradientEditorStop](./gradient-editor-stop)
|