Options du graphique en courbes

LineChartOptions API. Configurez les séries, les axes, l’interaction, l’animation, les étiquettes, les superpositions et le niveau de détail (LOD).

Import
import type { LineChartOptions } from "@sixtyfold/line";

Utilisez le point d’entrée public ci-dessus. Les imports de types sont retirés du JavaScript de l’application.

BandOptions

Options visuelles spécifiques à une plage/bande

Importer @sixtyfold/lineinterface

interface BandOptions
MembreDéfinitionDescription
borderColor?string | undefinedCouleur de bordure partagée pour les limites supérieure et inférieure (par défaut : couleur de la série lorsque la bordure est activée)
borderStyle?BandBorderStyle | undefined
= solid
Style de la ligne de bordure
borderWidth?number | undefinedLargeur de la bordure en pixels. Réglez sur 0 pour désactiver les bordures.
fill?number | boolean | undefinedRemplir la bande. - false : pas de remplissage de la bande - true : remplir avec la couleur de la série à l'opacité par défaut - nombre (0–1) : remplir avec la couleur de la série à l'opacité spécifiée
fillColor?string | SeriesGradient | undefinedCouleur de remplissage de la bande : chaîne de couleur unie ou objet dégradé. Remplace l'opacité de remplissage si spécifiée
lowerBorderColor?string | undefinedRemplace la couleur de la limite inférieure
upperBorderColor?string | undefinedRemplacer la couleur de la limite supérieure

BarOptions

Options visuelles spécifiques aux barres/colonnes

Importer @sixtyfold/lineinterface

interface BarOptions
MembreDéfinitionDescription
baseline?number | undefined
= 0
Valeur des données à partir de laquelle les barres s’étendent
borderColor?string | undefinedCouleur de la bordure partagée des barres (par défaut la couleur de la série lorsque la bordure est activée)
borderStyle?BarBorderStyle | undefined
= solid
Style de la ligne de bordure
borderWidth?number | undefinedÉpaisseur de la bordure en pixels. Mettre à 0 pour désactiver les bordures.
fill?number | boolean | undefinedRemplir les barres. - false : pas de remplissage des barres - true : remplir avec la couleur de la série à l’opacité par défaut - nombre (0–1) : remplir avec la couleur de la série à l’opacité spécifiée
fillColor?string | SeriesGradient | undefinedCouleur de remplissage des barres : chaîne de couleur unie ou objet dégradé. Remplace l’opacité de remplissage si spécifiée
maxWidth?number | undefined
= 24
Largeur maximale des barres en pixels
minWidth?number | undefined
= 1
Largeur minimale des barres en pixels
widthRatio?number | undefined
= 0.7
Fraction de l'espacement d'échantillonnage disponible utilisée par chaque barre

LegendLabelFontOptions

Options pour la police des étiquettes de la légende.

Importer @sixtyfold/lineinterface

interface LegendLabelFontOptions
MembreDéfinitionDescription
color?string | undefined
= #cfd6e6
Couleur de police
family?string | undefined
= DEFAULT_CHART_FONT_FAMILY
Police
size?number | undefined
= 12
Taille de la police en px
style?"normal" | "italic" | "oblique" | undefined
= normal
Style de police
weight?string | number | undefined
= normal
Épaisseur de la police
width?number | undefined
= auto
Largeur maximale du texte des étiquettes en px

LegendOptions

Placement, mise en page, typographie, nuanciers et interaction pour la légende Canvas2D intégrée.

Importer @sixtyfold/lineinterface

interface LegendOptions
MembreDéfinitionDescription
align?LegendAlign | undefined
= center
Alignement dans la zone de légende
allowHideAll?boolean | undefined
= false
Autoriser le masquage de toutes les séries
inactiveOpacity?number | undefined
= 0.45
Opacité pour les éléments de légende des séries masquées
interactive?boolean | undefined
= false
Activer l’interaction cliquer-pour-basculer
itemGap?number | undefined
= 12
Espacement entre les éléments en px
labelFont?LegendLabelFontOptions | undefinedStyle de police de l’étiquette de la légende
layout?LegendLayout | undefined
= column
Disposition des éléments
padding?{ top?: number; right?: number; bottom?: number; left?: number; } | undefined
= 8
Rembourrage à l'intérieur de la zone de légende en px
position?LegendPosition | undefined
= right
Position de la légende autour de la zone du graphique
swatch?LegendSwatchOptions | undefinedOptions de style du swatch
swatchGap?number | undefined
= 6
Espace entre le swatch et le libellé en px
visible?boolean | undefinedAffiche la légende. Elle est activée par défaut lorsque legend est fourni ; omettre legend la désactive.

LegendSwatchOptions

Options pour le carré de légende.

Import @sixtyfold/lineinterface

interface LegendSwatchOptions
MembreDéfinitionDescription
borderColor?string | undefined
= transparent
Couleur de la bordure du nuancier
borderWidth?number | undefined
= 0
Largeur de la bordure du nuancier en px
shape?LegendSwatchShape | undefined
= circle
Forme du nuancier
size?number | undefined
= 10
Taille du nuancier en px

LineAppearanceOptions

Apparence du graphique en ligne — apparence de base + légende + marqueur

Importer @sixtyfold/lineinterface

interface LineAppearanceOptions extends BaseAppearanceOptions
MembreDéfinitionDescription
axis?AxisAppearanceOptions | undefinedOptions d'apparence d'exécution pour l'axe.
chartBackground?BackgroundOptions | undefinedOptions d'apparence à l'exécution pour l'arrière‑plan du graphique.
crosshairStyle?CrosshairOptions | undefinedOptions d'apparence à l'exécution pour le style du crosshair.
grid?GridOptions | undefinedOptions d'apparence à l'exécution pour la grille.
labels?ChartLabels | undefinedOptions d'apparence à l'exécution pour les étiquettes.
legend?LegendOptions | undefinedOptions d'apparence à l'exécution pour la légende.
marker?MarkerOptions | undefinedOptions d'apparence à l'exécution pour le marqueur.
overlay?OverlayOptions | undefinedOptions d'apparence à l'exécution pour la superposition.
padding?PaddingOptions | undefinedOptions d'apparence à l'exécution pour le padding.
rangeSelector?RangeSelectorAppearanceOptions | undefinedOptions d'apparence à l'exécution pour le sélecteur de plage.
selection?SelectionOptions | undefinedOptions d'apparence à l'exécution pour la sélection.
textDirection?TextDirection | undefinedOptions d'apparence à l'exécution pour la direction du texte.
tooltip?TooltipOptions | undefinedOptions d'apparence à l'exécution pour l'infobulle.

LineChartOptions

Options de construction, d'interaction, d'apparence, de séries et de niveau de détail pour un graphique en lignes.

Import @sixtyfold/lineinterface

interface LineChartOptions
MembreDéfinitionDescription
animated?boolean | undefinedAnime la révélation des données et les transitions du viewport/axes. Si omis, l'animation est activée sauf si le navigateur signale prefers-reduced-motion: reduce.
axis?AxisOptions | undefinedPersonnalisation des axes (couleur de la ligne et couleurs des étiquettes)
chartBackground?BackgroundOptions | undefined
= #16213e
Arrière-plan du graphique (couvre tout le canvas y compris la zone d’aperçu). Peut être une chaîne de couleur unie, une définition de dégradé ou une image.
crosshairStyle?CrosshairOptions | undefinedStyle des lignes de réticule (lignes guides verticale et horizontale)
grid?GridOptions | undefinedPersonnalisation des lignes de la grille pour le graphique principal
interactive?boolean | undefined
= true
Activer les interactions utilisateur (pan/zoom/pinch). Lorsqu'il est false, le graphique est en lecture seule mais affiche toujours la croix/infobulle au survol.
interpolation?"none" | "linear" | "spline" | undefined
= linear
Mode d'interpolation pour les valeurs entre les points de données : - 'none' : pas d'interpolation, s'aligner sur le point de données le plus proche - 'linear' : interpolation linéaire entre points adjacents - 'spline' : interpolation spline Catmull‑Rom pour des courbes lisses
keepAliveInterval?number | undefined
= 0 (disabled)
Intervalle de keep‑alive en secondes pour empêcher Safari de libérer les ressources GPU. Safari nettoie agressivement les canevas « inutilisés », provoquant des graphiques vides.
keyboardActivation?"focus" | "hover" | undefinedComment les contrôles clavier deviennent actifs : - "focus" (par défaut) : le graphique doit avoir le focus DOM - "hover" : le graphique sous le pointeur reçoit la navigation clavier
keyboardAnnouncements?false | KeyboardAnnouncementMessages | undefinedLocalisez les annonces d'actions clavier pour les technologies d'assistance, ou réglez false pour les désactiver. Les messages omis utilisent des valeurs par défaut concises en anglais.
keyboardPanSpeed?number | undefined
= 0.1 (10%)
Vitesse de panoramique au clavier (touches fléchées). Fraction de la plage visible à déplacer par pression de touche.1 (10%)
keyboardZoomSpeed?number | undefined
= 0.1 (10% per keypress)
Vitesse de zoom au clavier (touches +/-). Des valeurs plus élevées = zoom plus rapide.1 (10% par pression)
labels?ChartLabels | undefinedÉtiquettes textuelles autour du graphique (titre, étiquettes d'axe)
legend?LegendOptions | undefinedOptions de légende des séries
lod?LineLODOptions | undefinedPolitique de présentation du niveau de détail.
marker?MarkerOptions | undefinedStyle de marqueur par défaut pour les points au survol (peut être remplacé par série)
minViewportRange?number | undefinedPlus petite étendue de la fenêtre X interactive, exprimée dans les mêmes unités que les valeurs X du graphique. Les valeurs invalides ou non positives conservent la valeur par défaut du type de graphique. Cette option de construction ne fait pas partie de l'apparence mutable.
overlay?OverlayOptions | undefinedPrimitives d'overlay déclaratives rendues au‑dessus du contenu du graphique
padding?PaddingOptions | undefined
= { top: 20, right: 80, bottom: 40, left: 80 }
Rembourrage personnalisé en pixels
rangeSelector?RangeSelectorOptions | undefinedConfiguration du sélecteur de plage (graphique d'aperçu)
rendererInitializationTimeout?number | undefined
= 15000
Temps maximal en millisecondes autorisé pour le démarrage du renderer. Le watchdog démarre pendant la construction du graphique, il protège donc aussi les applications qui n'attendent pas BaseChart.initialize. Définir à 0 pour le désactiver.
renderMode?"auto" | "worker" | "main" | undefinedSélectionne le mode de rendu. auto privilégie Worker + OffscreenCanvas ; worker force le worker avec repli sur le thread principal ; main effectue le rendu sur le thread principal du navigateur et requiert un DOM.
selection?SelectionOptions | undefinedStyle du sélecteur de plage (glisser-pour-zoomer)
series?SeriesOptions[] | undefinedConfiguration par série (couleurs, remplissage, dégradés)
textDirection?TextDirection | undefined
= inherit
Direction utilisée pour le texte Canvas2D. Utilisez « auto » pour inférer à partir du premier caractère fort de chaque chaîne, ou « rtl »/« ltr » pour forcer une direction sur tout le graphique.
tooltip?TooltipOptions | undefinedStyle du tooltip (fenêtre d'information du réticule)
wheelZoomDirection?"up-in" | "up-out" | undefinedSens du zoom à la molette. - « up-in » (par défaut) : molette vers le haut/en arrière pour zoomer, molette vers le bas/en avant pour dézoomer - « up-out » : molette vers le haut/en arrière pour dézoomer, molette vers le bas/en avant pour zoomer
wheelZoomSpeed?number | undefined
= 0.1 (10% per wheel tick)
Vitesse du zoom à la molette. Valeurs plus élevées = zoom plus rapide.1 (10% par cran de molette)
yDomain?YDomainOptions | undefinedVerrouillez un ou les deux bords du domaine Y rendu. Les bords omis continuent de s'adapter automatiquement aux données visibles. Fournir les deux bords finis maintient la fenêtre de visualisation Y stable lors du zoom, de la sélection du niveau de détail (LOD) et des mises à jour en streaming. L'option est désactivée par défaut et constitue une configuration de construction plutôt qu'une apparence modifiable.

LineChartStatsOptions

Contrôle la fréquence de publication de la télémétrie de la ligne.

Importer @sixtyfold/lineinterface

interface LineChartStatsOptions
MembreDéfinitionDescription
intervalMs?number | undefined
= 250
Intervalle minimum entre les mises à jour des statistiques en millisecondes

LineDataUpdateOptions

Contrôle la transition animée utilisée pour un remplacement en masse des données de ligne.

Import @sixtyfold/lineinterface

interface LineDataUpdateOptions
MembreDéfinitionDescription
preservePreviousFrame?boolean | undefinedLaisser le tracé précédemment rendu visible en amont de la frontière de révélation pendant le dessin animé d’un jeu de données de remplacement. La valeur par défaut est false. Attendez la fin de la révélation précédente avant d’utiliser cette option ; sinon sa trame partiellement révélée, y compris toute zone restante vide, est conservée. Les pixels conservés sont statiques, donc un panoramique ou un zoom pendant la nouvelle révélation peut créer une jonction temporaire grille/données jusqu’à la fin de la transition.

LineLODOptions

Politique de présentation stable en espace-écran et coefficients de fidélité/fluidité.

Importer @sixtyfold/lineinterface

interface LineLODOptions
MembreDéfinitionDescription
density?number | undefined
= 0.75
Colonnes de présentation cibles par pixel CSS et contrôle principal de fidélité/travail. Des valeurs plus élevées conservent davantage de détails locaux et augmentent la charge de rendu.
mode?"pyramid" | "adaptive" | undefinedadaptive utilise une présentation en espace écran sensible au viewport et stable lorsque pris en charge. pyramid sélectionne parmi les niveaux LOD globaux préconstruits.
quantizationStep?number | undefined
= 0.25
Intervalle additif de grille à l’intérieur de chaque octave binaire. Les valeurs plus petites rendent disponibles des largeurs de grille plus proches et réduisent les sauts de texture au prix de requêtes plus nombreuses. Pour des transitions fluides, associez ceci à une échelle de rebase similaire (par exemple 0,1 avec 1,1–1,12).
rebaseRatio?number | undefined
= 1.25
Dérive maximale projetée de la largeur de colonne avant que la grille sticky ne se rebase. La borne inférieure est son réciproque. Des valeurs plus basses produisent des changements de représentation plus petits et plus fréquents.

MarkerGlowOptions

Effet de lueur optionnel pour les marqueurs au survol

Importer @sixtyfold/lineinterface

interface MarkerGlowOptions
MembreDéfinitionDescription
blur?number | undefined
= 12
Rayon de flou de l’effet de lueur en pixels
color?string | undefinedCouleur de la lueur (par défaut : remplissage du marqueur/couleur de la série)
opacity?number | undefined
= 0.45
Opacité du halo 0-1

MarkerOptions

Options des marqueurs pour les indicateurs de point survolé

Importer @sixtyfold/lineinterface

interface MarkerOptions
MembreDéfinitionDescription
borderColor?string | undefined
= #fff
Couleur de la bordure/du trait
borderWidth?number | undefined
= 1
Épaisseur de la bordure/du trait en pixels
glow?boolean | MarkerGlowOptions | undefinedLueur optionnelle autour du marqueur
shape?MarkerShape | undefined
= circle
Forme du marqueur
size?number | undefined
= 5
Taille du marqueur en pixels — rayon pour le cercle, demi-largeur pour les autres

PointOptions

Options visuelles spécifiques aux scatter/points

Import @sixtyfold/lineinterface

interface PointOptions
MembreDéfinitionDescription
borderColor?string | undefined
= #fff
Couleur de la bordure/du contour du point
borderWidth?number | undefined
= 0
Largeur de la bordure/du contour du point en pixels
color?string | undefinedCouleur de remplissage du point (par défaut la couleur de la série)
opacity?number | undefined
= 1
Opacité du point 0-1
shape?MarkerShape | undefined
= circle
Forme du point
size?number | undefined
= 3
Taille du point en pixels — rayon pour le cercle, demi-largeur pour les autres

SeriesAppearanceOptions

Champs d'apparence par série — uniquement visuel et de présentation

Import @sixtyfold/linetype

type SeriesAppearanceOptions = Pick<SeriesOptions, "type" | "color" | "fill" | "fillColor" | "fillToZero" | "fillEffect" | "band" | "bar" | "stack" | "point" | "width" | "name" | "unit" | "marker">
MembreDéfinitionDescription
band?BandOptions | undefinedRemplissage et style de bordure spécifiques à la plage/bande
bar?BarOptions | undefinedRemplissage, bordure, largeur et style de ligne de base spécifiques aux barres/colonnes
color?string | undefinedCouleur de la ligne (retombe sur la palette par défaut si non spécifiée)
fill?number | boolean | undefinedRemplir la zone sous la courbe. - false : pas de remplissage (par défaut) - true : remplir avec la couleur de la courbe à 40 % d'opacité - nombre (0–1) : remplir avec la couleur de la courbe à l'opacité spécifiée
fillColor?string | SeriesGradient | undefinedCouleur de remplissage : chaîne de couleur unie ou objet dégradé. Remplace l'opacité de remplissage si elle est spécifiée
fillEffect?"none" | "glow" | "layered" | undefinedEffet de style de remplissage : 'none' : remplissage en couleur plate (par défaut) - 'glow' : lueur douce émanant de la courbe - 'layered' : remplissages empilés avec opacités variables pour donner de la profondeur
fillToZero?boolean | undefined
= true
Remplir jusqu'à la ligne de base zéro au lieu du bas du graphique Lorsque true : les valeurs positives se remplissent vers zéro, les négatives se remplissent vers zéro Lorsque false : remplissage toujours jusqu'au bas du graphique
marker?MarkerOptions | undefinedStyle du marqueur pour le point au survol de cette série (remplace le marqueur au niveau du graphique)
name?string | undefinedNom d'affichage de la série (utilisé dans la légende et l'infobulle).
point?PointOptions | undefinedStyle de marqueur spécifique aux scatter/points
stack?StackOptions | undefinedRemplissage et style de la limite supérieure spécifiques aux zones empilées
type?LineSeriesType | undefined
= line
Style de tracé de la série. « step » est un alias de « step-after » ; « band » est un alias de « range » ; « points » est un alias de « scatter » ; « column » est un alias de « bar » ; « stackedArea » est un alias de « stacked-area ».
unit?UnitOptions | undefinedConfiguration d’unité pour cette série (utilisée dans l’infobulle et les étiquettes d’axe)
width?number | undefined
= 1.5
Largeur du trait de la ligne en pixels. Réglez à 0 pour supprimer le trait tout en conservant les remplissages de plage, les infobulles et autres calques de série.

SeriesGradient

Définition du dégradé pour le remplissage de la série

Importer @sixtyfold/lineinterface

interface SeriesGradient
MembreDéfinitionDescription
colorsstring[]Arrêts de couleur CSS (minimum 2) ; les couleurs invalides sont ignorées.
direction?"vertical" | "horizontal" | undefined
= vertical
Direction du dégradé
offsets?number[] | undefinedPositions d'offset optionnelles pour chaque couleur (0–1), par défaut réparties uniformément

SeriesOptions

Configuration pour une seule série

Import @sixtyfold/lineinterface

interface SeriesOptions
MembreDéfinitionDescription
band?BandOptions | undefinedStyle de remplissage et de bordure spécifique aux plages/bandes
bar?BarOptions | undefinedStyle de remplissage, bordure, largeur et ligne de base spécifique aux barres/colonnes
color?string | undefinedCouleur de la ligne (retombe sur la palette par défaut si non spécifiée)
fill?number | boolean | undefinedRemplir la zone sous la ligne. - false : pas de remplissage (par défaut) - true : remplissage avec la couleur de la ligne à 40 % d’opacité - nombre (0‑1) : remplissage avec la couleur de la ligne à l’opacité spécifiée
fillColor?string | SeriesGradient | undefinedCouleur de remplissage : chaîne de couleur unie ou objet dégradé. Écrase l'opacité de remplissage si spécifiée
fillEffect?"none" | "glow" | "layered" | undefinedEffet de style de remplissage : 'none' : remplissage en couleur plate (par défaut) - 'glow' : halo diffus émanant de la ligne - 'layered' : remplissages empilés avec opacités variables pour la profondeur
fillToZero?boolean | undefined
= true
Remplir jusqu'à la ligne de base zéro au lieu du bas du graphique Si true : les valeurs positives remplissent vers zéro, les négatives remplissent vers le haut jusqu'à zéro Si false : toujours remplir jusqu'au bas du graphique
marker?MarkerOptions | undefinedStyle de marqueur pour le point au survol de cette série (remplace le marqueur au niveau du graphique)
name?string | undefinedNom de la série affiché (utilisé dans la légende et l'infobulle).
point?PointOptions | undefinedStyle de marqueur spécifique aux nuages de points/points
stack?StackOptions | undefinedStyle de remplissage et de bord supérieur spécifique aux aires empilées
type?LineSeriesType | undefined
= line
Style de rendu de la série. « step » est un alias de « step-after » ; « band » est un alias de « range » ; « points » est un alias de « scatter » ; « column » est un alias de « bar » ; « stackedArea » est un alias de « stacked-area ».
unit?UnitOptions | undefinedConfiguration d'unité pour cette série (utilisée dans l'infobulle et les labels des axes)
width?number | undefined
= 1.5
Largeur du trait de la ligne en pixels. Mettre à 0 pour supprimer le trait tout en conservant les remplissages de plage, les infobulles et les autres calques de la série.

StackOptions

Options visuelles spécifiques aux aires empilées

Import @sixtyfold/lineinterface

interface StackOptions
MemberDefinitionDescription
borderColor?string | undefinedCouleur de la bordure supérieure (par défaut, couleur de la série)
borderStyle?StackBorderStyle | undefined
= solid
Style de ligne de la bordure supérieure
borderWidth?number | undefinedLargeur de la bordure supérieure en pixels (par défaut, largeur de la série). Définir à 0 pour désactiver.
curve?StackCurveStyle | undefined
= linear
Forme de la bordure pour la bande remplie et la bordure supérieure.
fill?number | boolean | undefinedRemplir la zone empilée. - false : pas de remplissage de zone - true : remplir avec la couleur de la série à l'opacité par défaut - nombre (0-1) : remplir avec la couleur de la série à l'opacité spécifiée
fillColor?string | SeriesGradient | undefinedCouleur de remplissage de la zone : chaîne de couleur unie ou objet dégradé. Remplace l'opacité de remplissage si elle est spécifiée