RaceScatter
Nuage de points dynamique (Race Scatter Chart)
Convient pour afficher la distribution des donnees au fil du temps; la position des points represente deux valeurs de mesure
Cas d utilisation:
- Analyser les caracteristiques de distribution dans un espace bidimensionnel et afficher leur evolution dynamique dans le temps
- Afficher l evolution de la correlation entre plusieurs variables au fil du temps
- Observer la trajectoire des points de donnees dans un espace bidimensionnel
Nuage de points dynamique :
- Les axes X et Y sont tous deux des axes numeriques (donnees continues) et prennent en charge plusieurs mappages de mesures
- Permet de controler la dimension temporelle via le lecteur pour afficher dynamiquement les changements de donnees
- Afficher intuitivement les changements de donnees par le deplacement des points
chartType
Type: "raceScatter"
Nuage de points dynamique, adapte a l affichage de la distribution des donnees au fil du temps
dataset
Type: Record[]
Source de données
dimensions
Type: RaceScatterDimension[] | undefined
Dimensions, utilisees pour distinguer les series de donnees et afficher la legende
id
Type: string
ID de champ correspondant à la dimension
alias
Type: string | undefined
Alias de dimension
timeFormat
Type: TimeFormat | undefined
Configuration du format de date de la dimension
type
Type: "year" | "quarter" | "month" | "week" | "day" | "hour" | "minute" | "second"
Granularité temporelle, détermine la précision d’affichage de la date
encoding
Type: "color" | "detail" | "tooltip" | "label" | "row" | "column" | "player" | undefined
Canaux de mappage des dimensions dans les graphiques race scatter
- color : prend en charge le mapping de plusieurs dimensions vers le canal de couleur
- detail : prend en charge le mapping de plusieurs dimensions vers le canal de détail
- tooltip : prend en charge le mapping de plusieurs dimensions vers le canal d’infobulle
- label : prend en charge le mapping de plusieurs dimensions vers le canal d’étiquette
- row : prend en charge le mapping de plusieurs dimensions vers le canal de ligne
- column : prend en charge le mapping de plusieurs dimensions vers le canal de colonne
- player : prend en charge le mappage de plusieurs dimensions au canal du lecteur
measures
Type: ScatterMeasure[] | undefined
Mesures. Au moins deux mesures sont requises et mappées respectivement sur l’axe X et l’axe Y.
id
Type: string
ID de champ correspondant à la dimension
alias
Type: string | undefined
Alias de dimension
autoFormat
Type: boolean | undefined
Formatage automatique des nombres, activé par défaut, priorité la plus élevée
Lorsque autoFormat=true, toutes les configurations numFormat sont remplacées
Lorsque cette option est activée, les étiquettes et infobulles du graphique choisissent automatiquement le format approprié selon les valeurs de mesure et la locale
Règles de formatage: nombres décimaux avec notation compacte activée, au moins 0 décimale, au plus 2 décimales, arrondi automatique, avec l’implémentation Intl.NumberFormat du navigateur
Par exemple:
- locale='zh-CN': 749740.264 → 74.45万
- locale='en-US': 749740.264 → 744.5K
numFormat
Type: NumFormat | undefined
Formatage numérique personnalisé des mesures; appliqué automatiquement aux étiquettes et aux infobulles
Remarque: pour utiliser un format personnalisé, vous devez définir explicitement autoFormat=false; sinon autoFormat remplacera cette configuration
type
Type: "number" | "percent" | "permille" | "scientific" | undefined
Type de format numérique, prend en charge: number (décimal), percent (%), permille (‰), notation scientifique
ratio
Type: number | undefined
Ratio du format numérique, ne peut pas être 0
Exemple - 100000 est converti en 10万, ratio:10000, symbol:"万" - 100000 est converti en 10K, ratio:1000, symbol:"K"
symbol
Type: string | undefined
Symbole du format numérique, par ex. %, ‰
Exemple - 100000 est converti en 10万, ratio:10000, symbol:"万" - 100000 est converti en 10K, ratio:1000, symbol:"K"
thousandSeparator
Type: boolean | undefined
Séparateur de milliers pour le formatage numérique
suffix
Type: string | undefined
Suffixe du format numérique
prefix
Type: string | undefined
Préfixe du format numérique
fractionDigits
Type: number | undefined
Décimales pour le formatage numérique, avec minimumFractionDigits et maximumFractionDigits d’Intl.NumberFormat du navigateur; priorité plus faible que significantDigits
Exemple - 1234.5678 est converti en 1235, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.6, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.57, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678 est converti en 1230.568, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.5678, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.56780, fractionDigits:5 (roundingMode:halfCeil)
significantDigits
Type: number | undefined
Chiffres significatifs pour le formatage numérique, avec minimumSignificantDigits et maximumSignificantDigits d’Intl.NumberFormat du navigateur; priorité plus élevée que fractionDigits
Exemple - 1234.5678 est converti en 1000, significantDigits:1 - 1234.5678 est converti en 1200, significantDigits:2 - 1234.5678 est converti en 1230, significantDigits:3 - 1234.5678 est converti en 1234, significantDigits:4 - 1234.5678 est converti en 1234.6, significantDigits:5 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.57, significantDigits:6 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.568, significantDigits:7 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.5678, significantDigits:8 (roundingMode:halfCeil)
roundingPriority
Type: "morePrecision" | "lessPrecision" | undefined
Priorité d’arrondi pour le formatage numérique lorsque significantDigits et fractionDigits sont tous deux définis; utilise Intl.NumberFormat du navigateur et suit les mêmes règles que roundingPriority d’Intl.NumberFormat
Exemple - 1234.5678 est converti en 1230, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678 est converti en 1234.5678, significantDigits:3 (roundingPriority:morePrecision)
roundingMode
Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined
Mode d’arrondi pour le formatage numérique, avec Intl.NumberFormat du navigateur et les mêmes règles que roundingMode d’Intl.NumberFormat
format
Type: NumFormat | undefined
type
Type: "number" | "percent" | "permille" | "scientific" | undefined
Type de format numérique, prend en charge: number (décimal), percent (%), permille (‰), notation scientifique
ratio
Type: number | undefined
Ratio du format numérique, ne peut pas être 0
Exemple - 100000 est converti en 10万, ratio:10000, symbol:"万" - 100000 est converti en 10K, ratio:1000, symbol:"K"
symbol
Type: string | undefined
Symbole du format numérique, par ex. %, ‰
Exemple - 100000 est converti en 10万, ratio:10000, symbol:"万" - 100000 est converti en 10K, ratio:1000, symbol:"K"
thousandSeparator
Type: boolean | undefined
Séparateur de milliers pour le formatage numérique
suffix
Type: string | undefined
Suffixe du format numérique
prefix
Type: string | undefined
Préfixe du format numérique
fractionDigits
Type: number | undefined
Décimales pour le formatage numérique, avec minimumFractionDigits et maximumFractionDigits d’Intl.NumberFormat du navigateur; priorité plus faible que significantDigits
Exemple - 1234.5678 est converti en 1235, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.6, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.57, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678 est converti en 1230.568, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.5678, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.56780, fractionDigits:5 (roundingMode:halfCeil)
significantDigits
Type: number | undefined
Chiffres significatifs pour le formatage numérique, avec minimumSignificantDigits et maximumSignificantDigits d’Intl.NumberFormat du navigateur; priorité plus élevée que fractionDigits
Exemple - 1234.5678 est converti en 1000, significantDigits:1 - 1234.5678 est converti en 1200, significantDigits:2 - 1234.5678 est converti en 1230, significantDigits:3 - 1234.5678 est converti en 1234, significantDigits:4 - 1234.5678 est converti en 1234.6, significantDigits:5 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.57, significantDigits:6 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.568, significantDigits:7 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.5678, significantDigits:8 (roundingMode:halfCeil)
roundingPriority
Type: "morePrecision" | "lessPrecision" | undefined
Priorité d’arrondi pour le formatage numérique lorsque significantDigits et fractionDigits sont tous deux définis; utilise Intl.NumberFormat du navigateur et suit les mêmes règles que roundingPriority d’Intl.NumberFormat
Exemple - 1234.5678 est converti en 1230, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678 est converti en 1234.5678, significantDigits:3 (roundingPriority:morePrecision)
roundingMode
Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined
Mode d’arrondi pour le formatage numérique, avec Intl.NumberFormat du navigateur et les mêmes règles que roundingMode d’Intl.NumberFormat
encoding
Type: "xAxis" | "color" | "tooltip" | "label" | "yAxis" | "size" | undefined
Canal auquel la mesure est mappée
- xAxis: mesure mappée sur l’axe X
- yAxis : mesure mappée sur l’axe y
- size: taille mappée depuis la mesure
- color : mesure mappée vers le canal de couleur
- label : mesure mappée au canal d'étiquette
- tooltip : mesure mappée au canal d'infobulle
parentId
Type: string | undefined
Dans une configuration de mesures plate, construit un groupe de mesures en arbre. parentId pointe vers l’id du groupe de mesures parent et sert à construire l’arbre des mesures
Il existe deux façons de configurer l’arbre des mesures: l’option 1 configure directement un arbre de mesures avec children; l’option 2 configure une liste plate de mesures avec parentId. Ces deux méthodes ne peuvent pas être utilisées simultanément
player
Type: Player | undefined
Configuration du lecteur, utilisée pour spécifier la dimension temporelle, configuration centrale du graphique à barres dynamique
Configuration du lecteur, utilisée pour spécifier le nom du champ à lire, qui doit être une dimension
Cette fonction ne prend pas en charge les types de graphiques table, pivotTable, dualAxis, histogram, boxPlot, etc., ni l’utilisation avec combinaison de mesures ou pivot lignes/colonnes activé
maxCount
Type: number | false | undefined
Nombre maximal de lectures ; les données au-delà de ce nombre sont tronquées, false signifie aucune limite
interval
Type: number | undefined
Intervalle de lecture, unité ms
autoPlay
Type: boolean | undefined
Indique s’il faut lire automatiquement
loop
Type: boolean | undefined
Indique s’il faut lire en boucle
position
Type: "left" | "top" | "right" | "bottom" | undefined
Position du lecteur
railColor
Type: string | undefined
Couleur de la piste de la barre de progression du lecteur
fontFamily
Type: string | undefined
Police du texte du lecteur
fontSize
Type: number | undefined
Taille de police du texte du lecteur
trackColor
Type: string | undefined
Couleur de progression de la barre de progression du lecteur
sliderHandleColor
Type: string | undefined
Couleur du curseur de la barre de progression du lecteur
sliderHandleBorderColor
Type: string | undefined
Couleur de bordure du curseur de la barre de progression du lecteur
startButtonColor
Type: string | undefined
Couleur du bouton de démarrage du lecteur
pauseButtonColor
Type: string | undefined
Couleur du bouton pause du lecteur
backwardButtonColor
Type: string | undefined
Couleur du bouton retour du lecteur
forwardButtonColor
Type: string | undefined
Couleur du bouton avance du lecteur
sort
Type: Sort | undefined
Configuration du tri de l’axe X, prend en charge le tri par dimension ou mesure ainsi qu’un ordre personnalise
Configuration du tri de l’axe categoriel, prend en charge le tri par dimension ou mesure ainsi qu’un ordre personnalise
Exemple sort: { orderBy: 'profit', order: 'asc', } sort: { customOrder:['2019', '2020', '2021'] }
- order:'asc' - orderBy:'date'
- customOrder:['2019', '2020', '2021']
order
Type: "asc" | "desc" | undefined
Ordre de tri, valeurs possibles: 'asc' ou 'desc'
Exemple order:'asc'
orderBy
Type: string | undefined
Mettre en surbrillance l’élément de données avec le taux de profit le plus élevé dans chaque région
Exemple - orderBy:'date' - orderBy:'profit'
customOrder
Type: string[] | undefined
Ordre personnalise applique directement a l’axe categoriel
page
Type: Page | undefined
Pagination
Configuration de pagination du graphique
field
Type: string
Champ de pagination; définit le nom du champ utilisé pour la pagination et doit être une dimension
currentValue
Type: string
Valeur de pagination actuelle; définit la valeur utilisée pour déterminer la page actuelle
Exemple '2023-01-01'
backgroundColor
Type: BackgroundColor
Couleur d’arrière-plan du graphique
La couleur d’arrière-plan peut être une chaîne de couleur (par ex. 'red', 'blue') ou une valeur hex, rgb ou rgba (par ex. '#ff0000', 'rgba(255,0,0,0.5)')
size
Type: number | number[] | undefined
Taille de la mesure du nuage de points, utilisée pour définir la taille ou la plage de tailles des points
- Si la plage de tailles est un nombre comme 10, la taille du point est fixée à 10
- Si la plage de tailles est un tableau à deux éléments comme [10, 40], la taille du point varie de 10 à 40
- Mutuellement exclusif avec sizeRange; priorité inférieure à size
sizeRange
Type: number | number[] | undefined
Plage de tailles de la mesure du nuage de points, utilisée pour définir la plage de tailles des points,
- Si la plage de tailles est un tableau à deux éléments comme [10, 40], la taille du point varie de 10 à 40
- Si la plage de tailles est un nombre comme 10, la taille du point est fixée à 10
- Mutuellement exclusif avec sizeRange; priorité supérieure à size
color
Type: Color | undefined
Couleur
Configuration de couleur pour définir le schéma de couleurs du graphique, y compris les listes de couleurs, les mappings de couleur et les dégradés.
colorScheme
Type: string[] | undefined
Schéma de couleurs discret pour définir les couleurs des différents éléments du graphique
Exemple ['#FFCDD2,#F8BBD0,#E1BEE7,#D1C4E9,#C5CAE9,#BBDEFB,#B3E5FC,#B2EBF2,#B2DFDB,#C8E6C9,#DCEDC8,#F0F4C3,#FFF9C4,#FFECB3,#FFE0B2']
linearColorScheme
Type: string[] | undefined
Schéma de dégradé linéaire pour définir les couleurs des différents éléments du graphique
Exemple ['#FFCDD2, #F8BBD0]
colorMapping
Type: Record<string, string> | undefined
Mapping de couleur utilisé pour associer les valeurs de données à des couleurs spécifiques
Exemple { 'profit': 'red', 'sales': 'blue', }
positiveColor
Type: string | undefined
Configuration de couleur positive/négative; définit la couleur des valeurs positives dans le graphique
negativeColor
Type: string | undefined
Configuration de couleur positive/négative; définit la couleur des valeurs négatives dans le graphique
label
Type: Label | undefined
Étiquette
Configuration des étiquettes pour définir les étiquettes de données du graphique, y compris leur position, leur format et leur style.
enable
Type: false | true
Indique si la fonction de label est activée
wrap
Type: boolean | undefined
Indique si les labels passent à la ligne suivante
showValue
Type: boolean | undefined
Indique si les labels affichent les valeurs des mesures
Dans les scénarios multi-mesures, il n’y a pas de risque de conflit de valeurs, car toutes les mesures liées au tracé passent par le traitement foldMeasures et sont fusionnées en une mesure représentant un seul point de données
Remarque : le label de encoding a une priorite plus elevee ; cette configuration n affecte pas le label de encoding
showValuePercent
Type: boolean | undefined
Indique si les labels affichent le pourcentage des valeurs des mesures
Dans les scénarios multi-mesures, il n’y a pas de risque de conflit de valeurs, car toutes les mesures liées au tracé passent par le traitement foldMeasures et sont fusionnées en une mesure représentant un seul point de données
Remarque : le label de encoding a une priorite plus elevee ; cette configuration n affecte pas le label de encoding
showDimension
Type: boolean | undefined
Indique si les labels affichent les labels de dimension
Afficher toutes les etiquettes de dimension
Remarque : le label de encoding a une priorite plus elevee ; cette configuration n affecte pas le label de encoding
autoFormat
Type: boolean | undefined
Formatage automatique des nombres, activé par défaut, priorité la plus élevée
Lorsque autoFormat=true, toutes les configurations numFormat sont remplacées
Lorsque cette option est activée, les étiquettes et infobulles du graphique choisissent automatiquement le format approprié selon les valeurs de mesure et la locale
Règles de formatage: nombres décimaux avec notation compacte activée, au moins 0 décimale, au plus 2 décimales, arrondi automatique, avec l’implémentation Intl.NumberFormat du navigateur
Par exemple:
- locale='zh-CN': 749740.264 → 74.45万
- locale='en-US': 749740.264 → 744.5K
numFormat
Type: NumFormat | undefined
Formatage numérique personnalisé des mesures; appliqué automatiquement aux étiquettes et aux infobulles
Remarque: pour utiliser un format personnalisé, vous devez définir explicitement autoFormat=false; sinon autoFormat remplacera cette configuration
type
Type: "number" | "percent" | "permille" | "scientific" | undefined
Type de format numérique, prend en charge: number (décimal), percent (%), permille (‰), notation scientifique
ratio
Type: number | undefined
Ratio du format numérique, ne peut pas être 0
Exemple - 100000 est converti en 10万, ratio:10000, symbol:"万" - 100000 est converti en 10K, ratio:1000, symbol:"K"
symbol
Type: string | undefined
Symbole du format numérique, par ex. %, ‰
Exemple - 100000 est converti en 10万, ratio:10000, symbol:"万" - 100000 est converti en 10K, ratio:1000, symbol:"K"
thousandSeparator
Type: boolean | undefined
Séparateur de milliers pour le formatage numérique
suffix
Type: string | undefined
Suffixe du format numérique
prefix
Type: string | undefined
Préfixe du format numérique
fractionDigits
Type: number | undefined
Décimales pour le formatage numérique, avec minimumFractionDigits et maximumFractionDigits d’Intl.NumberFormat du navigateur; priorité plus faible que significantDigits
Exemple - 1234.5678 est converti en 1235, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.6, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.57, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678 est converti en 1230.568, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.5678, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.56780, fractionDigits:5 (roundingMode:halfCeil)
significantDigits
Type: number | undefined
Chiffres significatifs pour le formatage numérique, avec minimumSignificantDigits et maximumSignificantDigits d’Intl.NumberFormat du navigateur; priorité plus élevée que fractionDigits
Exemple - 1234.5678 est converti en 1000, significantDigits:1 - 1234.5678 est converti en 1200, significantDigits:2 - 1234.5678 est converti en 1230, significantDigits:3 - 1234.5678 est converti en 1234, significantDigits:4 - 1234.5678 est converti en 1234.6, significantDigits:5 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.57, significantDigits:6 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.568, significantDigits:7 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.5678, significantDigits:8 (roundingMode:halfCeil)
roundingPriority
Type: "morePrecision" | "lessPrecision" | undefined
Priorité d’arrondi pour le formatage numérique lorsque significantDigits et fractionDigits sont tous deux définis; utilise Intl.NumberFormat du navigateur et suit les mêmes règles que roundingPriority d’Intl.NumberFormat
Exemple - 1234.5678 est converti en 1230, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678 est converti en 1234.5678, significantDigits:3 (roundingPriority:morePrecision)
roundingMode
Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined
Mode d’arrondi pour le formatage numérique, avec Intl.NumberFormat du navigateur et les mêmes règles que roundingMode d’Intl.NumberFormat
labelFontSize
Type: number | undefined
Taille de police du label
labelFontWeight
Type: string | number | undefined
Graisse de police du label
labelBackgroundColor
Type: string | undefined
Couleur d’arrière-plan du label
labelStroke
Type: string | undefined
Couleur du contour du label
labelColor
Type: string | undefined
Couleur de police du label
labelColorSmartInvert
Type: boolean | undefined
Indique si la couleur de police du label est inversée automatiquement selon la couleur de l’élément graphique
labelPosition
Type: "inside" | "outside" | undefined
Position du label
labelOverlap
Type: boolean | undefined
Indique si l’évitement du chevauchement des labels est activé
selector
Type: Selector | Selectors | undefined
Filtrage des labels; la relation par défaut entre les sélecteurs est OR
field
Type: string
Champ de dimension, ID d'un élément de dimension
operator
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
op
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
identique à operator
value
Type: string | number | (string | number)[]
Sélectionne les éléments par valeur de champ de dimension; prend en charge les tableaux
dynamicFilter
Type: ChartDynamicFilter | undefined
Filtre dynamique (exécution de code généré par l’IA)
Implémente une logique complexe de filtrage des données via du code JavaScript généré par l’IA.
Capacités principales :
-
Prend en charge des conditions de filtrage de données arbitrairement complexes
-
Utilise les fonctions utilitaires intégrées pour les opérations de données
-
S’exécute de manière sûre dans l’environnement du navigateur (sandbox Web Worker)
Exigences d’environnement : seuls les environnements de navigateur sont pris en charge ; les environnements Node.js utiliseront fallback
Remarque : selector et dynamicFilter ne peuvent pas être utilisés simultanément ; dynamicFilter a une priorité plus élevée
Configuration du filtre dynamique du graphique
Filtre les marques du graphique (aires, points, etc.) via du code JavaScript généré par l’IA
type
Type: "row-with-field"
description
Type: string | undefined
Description des besoins de filtrage de l’utilisateur (langage naturel).
Exemple "Highlight data items with sales greater than 1000"
code
Type: string
Code de filtrage JavaScript généré par IA
-
Seules les fonctions utilitaires intégrées sont autorisées (accessibles via _ ou R)
-
Paramètre d’entrée : data (tableau), chaque item contient un champ __row_index indiquant le numéro de ligne
-
Doit retourner un tableau de combinaisons index de ligne et champ : Array<{ __row_index: number, field: string }>
-
__row_index indique le numéro de ligne de l’élément d’origine, field indique le champ à mettre en évidence
-
Interdit : eval, Function, opérations asynchrones, DOM API, requêtes réseau
Exemple Mettre en évidence le champ sales des éléments dont sales est supérieur à 1000
Mettre en évidence l’élément dont la marge bénéficiaire est la plus élevée dans chaque zone
Mettre en évidence les éléments filtrés par plusieurs conditions
fallback
Type: Selector | Selectors | undefined
Solution de repli lorsque l'exécution du code échoue ou que l'environnement n'est pas pris en charge
field
Type: string
Champ de dimension, ID d'un élément de dimension
operator
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
op
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
identique à operator
value
Type: string | number | (string | number)[]
Sélectionne les éléments par valeur de champ de dimension; prend en charge les tableaux
result
Type: DynamicFilterExecutionResult<RowWithFieldRes> | undefined
Résultat d'exécution du filtre animé (champ runtime)
Écrit pendant la phase prepare(), en lecture seule à l'exécution
success
Type: false | true
data
Type: T[] | undefined
error
Type: string | undefined
legend
Type: Legend | undefined
Légende
Configuration de la légende du graphique, incluant sa position, son format et son style.
enable
Type: boolean | undefined
Indique si la fonction de légende est activée
Exemple enable: true
border
Type: boolean | undefined
Indique si la bordure de la legende est activee.
Efficace uniquement pour les légendes discrètes
Exemple border: true
labelColor
Type: string | undefined
Couleur de police du label
pagerIconColor
Type: string | undefined
Couleur de l’icône du pager
pagerIconDisableColor
Type: string | undefined
Couleur des icônes du pager désactivées
labelFontSize
Type: number | undefined
Taille de police de la légende
Exemple labelFontSize: 10
labelFontColor
Type: string | undefined
Couleur de police de la légende
labelFontWeight
Type: string | number | undefined
Graisse de police de la légende
Exemple labelFontWeight: 400
shapeType
Type: "circle" | "cross" | "diamond" | "square" | "arrow" | "arrow2Left" | "arrow2Right" | "wedge" | "thinTriangle" | "triangle" | "triangleUp" | "triangleDown" | "triangleRight" | "triangleLeft" | "stroke" | "star" | "wye" | "rect" | "arrowLeft" | "arrowRight" | "rectRound" | "roundLine" | undefined
Forme de légende
Efficace uniquement pour les légendes discrètes
Exemple shapeType: 'circle'
position
Type: "left" | "leftTop" | "leftBottom" | "lt" | "lb" | "top" | "topLeft" | "topRight" | "tl" | "tr" | "right" | "rightTop" | "rightBottom" | "rt" | "rb" | "bottom" | "bottomLeft" | "bottomRight" | "bl" | "br" | undefined
Position de la légende
Exemple position: 'rightTop'
maxSize
Type: number | undefined
Nombre maximal de colonnes ou de lignes lorsque les éléments de légende sont nombreux
Efficace uniquement pour les légendes discrètes
Exemple maxSize: 2
tooltip
Type: Tooltip | undefined
Infobulles
Configuration des infobulles du graphique, y compris position, format, style, etc.
enable
Type: false | true
Indique si la fonction de label est activée
brush
Type: Brush | undefined
Configuration de sélection brush du graphique
enable
Type: boolean | undefined
Indique si la sélection brush est activée
brushType
Type: "rect" | "x" | "y" | "polygon" | undefined
Type de brush
Définit la forme et la direction de sélection du brush
- rect : sélection brush rectangulaire, possible simultanément dans les directions des axes X et Y
- polygon : sélection brush polygonale, trace un polygone libre en cliquant plusieurs points pour sélectionner
- x : sélection brush selon l’axe X uniquement, sans restriction selon l’axe Y
- y : sélection brush selon l’axe Y uniquement, sans restriction selon l’axe X
brushMode
Type: "single" | "multiple" | undefined
- multiple: mode multiple, où plusieurs sélections brush peuvent coexister simultanément
Définit le mode de sélection brush
- multiple: mode de sélection multiple; plusieurs zones brush peuvent exister en même temps
removeOnClick
Type: boolean | undefined
Indique si la zone brush est supprimée à la fin de la sélection
inBrushStyle
Type: { opacity?: number; stroke?: string; lineWidth?: number; } | undefined
Opacité des points de données non sélectionnés, de 0 à 1
Définit le style des points de données sélectionnés par brush
opacity
Type: number | undefined
Opacité
Opacité des points de données sélectionnés, plage 0-1
stroke
Type: string | undefined
Couleur du trait
lineWidth
Type: number | undefined
Largeur du contour
outOfBrushStyle
Type: { opacity?: number; stroke?: string; lineWidth?: number; } | undefined
Axe X, axe de catégorie, configuration de l'axe X; définit l'axe X du graphique, y compris position, format, style, etc.
Définit le style des points de données hors de la sélection brush
opacity
Type: number | undefined
Opacité
Opacité des points de données sélectionnés, plage 0-1
stroke
Type: string | undefined
Couleur du trait
lineWidth
Type: number | undefined
Largeur du contour
xAxis
Type: XLinearAxis | undefined
X-axis numeric-axis configuration, used to define the chart X-axis, including position, format, style, and related settings.
visible
Type: boolean | undefined
Indique si l’axe est visible
min
Type: number | undefined
Ligne d’axe width
max
Type: number | boolean | undefined
Graduations de l axe X
log
Type: boolean | undefined
Indique s’il faut utiliser un axe logarithmique, uniquement valable pour les axes numériques
logBase
Type: number | undefined
Fonction d’assouplissement de l’animation.
nice
Type: boolean | undefined
Configuration de l’axe Y (axe catégoriel) utilisée pour définir l’axe Y, notamment la position, le format, le style, etc.
inverse
Type: boolean | undefined
Indique si l’axe est affiche en sens inverse; effectif uniquement pour les axes numeriques
zero
Type: boolean | undefined
Indique s’il faut forcer l’affichage de la valeur 0 sur l’axe. Si min et max sont configures, cette option est inactive. Effectif uniquement pour les axes numeriques.
autoFormat
Type: boolean | undefined
Formatage automatique des nombres, activé par défaut, priorité la plus élevée
Lorsque autoFormat=true, toutes les configurations numFormat sont remplacées
Lorsque cette option est activée, les étiquettes et infobulles du graphique choisissent automatiquement le format approprié selon les valeurs de mesure et la locale
Règles de formatage: nombres décimaux avec notation compacte activée, au moins 0 décimale, au plus 2 décimales, arrondi automatique, avec l’implémentation Intl.NumberFormat du navigateur
Par exemple:
- locale='zh-CN': 749740.264 → 74.45万
- locale='en-US': 749740.264 → 744.5K
numFormat
Type: NumFormat | undefined
Formatage numérique personnalisé des mesures; appliqué automatiquement aux étiquettes et aux infobulles
Remarque: pour utiliser un format personnalisé, vous devez définir explicitement autoFormat=false; sinon autoFormat remplacera cette configuration
type
Type: "number" | "percent" | "permille" | "scientific" | undefined
Type de format numérique, prend en charge: number (décimal), percent (%), permille (‰), notation scientifique
ratio
Type: number | undefined
Ratio du format numérique, ne peut pas être 0
Exemple - 100000 est converti en 10万, ratio:10000, symbol:"万" - 100000 est converti en 10K, ratio:1000, symbol:"K"
symbol
Type: string | undefined
Symbole du format numérique, par ex. %, ‰
Exemple - 100000 est converti en 10万, ratio:10000, symbol:"万" - 100000 est converti en 10K, ratio:1000, symbol:"K"
thousandSeparator
Type: boolean | undefined
Séparateur de milliers pour le formatage numérique
suffix
Type: string | undefined
Suffixe du format numérique
prefix
Type: string | undefined
Préfixe du format numérique
fractionDigits
Type: number | undefined
Décimales pour le formatage numérique, avec minimumFractionDigits et maximumFractionDigits d’Intl.NumberFormat du navigateur; priorité plus faible que significantDigits
Exemple - 1234.5678 est converti en 1235, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.6, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.57, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678 est converti en 1230.568, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.5678, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.56780, fractionDigits:5 (roundingMode:halfCeil)
significantDigits
Type: number | undefined
Chiffres significatifs pour le formatage numérique, avec minimumSignificantDigits et maximumSignificantDigits d’Intl.NumberFormat du navigateur; priorité plus élevée que fractionDigits
Exemple - 1234.5678 est converti en 1000, significantDigits:1 - 1234.5678 est converti en 1200, significantDigits:2 - 1234.5678 est converti en 1230, significantDigits:3 - 1234.5678 est converti en 1234, significantDigits:4 - 1234.5678 est converti en 1234.6, significantDigits:5 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.57, significantDigits:6 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.568, significantDigits:7 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.5678, significantDigits:8 (roundingMode:halfCeil)
roundingPriority
Type: "morePrecision" | "lessPrecision" | undefined
Priorité d’arrondi pour le formatage numérique lorsque significantDigits et fractionDigits sont tous deux définis; utilise Intl.NumberFormat du navigateur et suit les mêmes règles que roundingPriority d’Intl.NumberFormat
Exemple - 1234.5678 est converti en 1230, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678 est converti en 1234.5678, significantDigits:3 (roundingPriority:morePrecision)
roundingMode
Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined
Mode d’arrondi pour le formatage numérique, avec Intl.NumberFormat du navigateur et les mêmes règles que roundingMode d’Intl.NumberFormat
label
Type: { visible?: boolean; labelColor?: string; labelFontSize?: number; labelFontWeight?: number; labelAngle?: number; } | undefined
Etiquettes de graduation de l’axe X
visible
Type: boolean | undefined
Indique si les etiquettes sont visibles
labelColor
Type: string | undefined
Couleur des etiquettes
labelFontSize
Type: number | undefined
Taille de police des etiquettes
labelFontWeight
Type: number | undefined
Graisse de police des etiquettes
labelAngle
Type: number | undefined
Angle de rotation des etiquettes
line
Type: { visible?: boolean; lineColor?: string; lineWidth?: number; } | undefined
Ligne de l’axe X
visible
Type: boolean | undefined
Indique si les etiquettes sont visibles
lineColor
Type: string | undefined
Couleur de la ligne d’axe
lineWidth
Type: number | undefined
Largeur du contour
tick
Type: { visible?: boolean; tickInside?: boolean; tickColor?: string; tickSize?: number; } | undefined
Graduations de l’axe X
visible
Type: boolean | undefined
Indique si les etiquettes sont visibles
tickInside
Type: boolean | undefined
Indique si les graduations pointent vers l’interieur
tickColor
Type: string | undefined
Couleur des graduations
tickSize
Type: number | undefined
Taille des graduations
title
Type: { visible?: boolean; titleText?: string; titleColor?: string; titleFontSize?: number; titleFontWeight?: number; } | undefined
Titre de l’axe X
visible
Type: boolean | undefined
Indique si les etiquettes sont visibles
titleText
Type: string | undefined
Texte du titre; suit par defaut la configuration du champ
titleColor
Type: string | undefined
Couleur du titre
titleFontSize
Type: number | undefined
Taille de police du titre
titleFontWeight
Type: number | undefined
Graisse de police du titre
grid
Type: { visible?: boolean; gridColor?: string; gridWidth?: number; gridLineDash?: number[]; } | undefined
Inclut les themes integres light et dark. Les themes personnalises peuvent etre ajoutes via registerTheme.
visible
Type: boolean | undefined
gridColor
Type: string | undefined
selector = [{ profit: 100 }, { profit: 200 }]
gridWidth
Type: number | undefined
- not in : sélectionne les éléments de données dont la valeur du champ de dimension n’est pas dans le tableau
value.
gridLineDash
Type: number[] | undefined
Prend en charge les styles globaux ou les configurations de style conditionnelles.
animation
Type: { duration?: number; easing?: string; } | undefined
Configuration d’animation de l’axe X
duration
Type: number | undefined
value: [100, 300]
easing
Type: string | undefined
}
yAxis
Type: YLinearAxis | undefined
Axe Y
Axe numérique. Configuration de l’axe Y pour définir la position, le format, le style et les paramètres associés.
visible
Type: boolean | undefined
Indique si l’axe est visible
min
Type: number | undefined
Ligne d’axe width
max
Type: number | boolean | undefined
Graduations de l axe X
log
Type: boolean | undefined
Indique s’il faut utiliser un axe logarithmique, uniquement valable pour les axes numériques
logBase
Type: number | undefined
Fonction d’assouplissement de l’animation.
nice
Type: boolean | undefined
Configuration de l’axe Y (axe catégoriel) utilisée pour définir l’axe Y, notamment la position, le format, le style, etc.
inverse
Type: boolean | undefined
Indique si l’axe est affiche en sens inverse; effectif uniquement pour les axes numeriques
zero
Type: boolean | undefined
Indique s’il faut forcer l’affichage de la valeur 0 sur l’axe. Si min et max sont configures, cette option est inactive. Effectif uniquement pour les axes numeriques.
autoFormat
Type: boolean | undefined
Formatage automatique des nombres, activé par défaut, priorité la plus élevée
Lorsque autoFormat=true, toutes les configurations numFormat sont remplacées
Lorsque cette option est activée, les étiquettes et infobulles du graphique choisissent automatiquement le format approprié selon les valeurs de mesure et la locale
Règles de formatage: nombres décimaux avec notation compacte activée, au moins 0 décimale, au plus 2 décimales, arrondi automatique, avec l’implémentation Intl.NumberFormat du navigateur
Par exemple:
- locale='zh-CN': 749740.264 → 74.45万
- locale='en-US': 749740.264 → 744.5K
numFormat
Type: NumFormat | undefined
Formatage numérique personnalisé des mesures; appliqué automatiquement aux étiquettes et aux infobulles
Remarque: pour utiliser un format personnalisé, vous devez définir explicitement autoFormat=false; sinon autoFormat remplacera cette configuration
type
Type: "number" | "percent" | "permille" | "scientific" | undefined
Type de format numérique, prend en charge: number (décimal), percent (%), permille (‰), notation scientifique
ratio
Type: number | undefined
Ratio du format numérique, ne peut pas être 0
Exemple - 100000 est converti en 10万, ratio:10000, symbol:"万" - 100000 est converti en 10K, ratio:1000, symbol:"K"
symbol
Type: string | undefined
Symbole du format numérique, par ex. %, ‰
Exemple - 100000 est converti en 10万, ratio:10000, symbol:"万" - 100000 est converti en 10K, ratio:1000, symbol:"K"
thousandSeparator
Type: boolean | undefined
Séparateur de milliers pour le formatage numérique
suffix
Type: string | undefined
Suffixe du format numérique
prefix
Type: string | undefined
Préfixe du format numérique
fractionDigits
Type: number | undefined
Décimales pour le formatage numérique, avec minimumFractionDigits et maximumFractionDigits d’Intl.NumberFormat du navigateur; priorité plus faible que significantDigits
Exemple - 1234.5678 est converti en 1235, fractionDigits:0 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.6, fractionDigits:1 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.57, fractionDigits:2 (roundingMode:halfCeil) - 1234.5678 est converti en 1230.568, fractionDigits:3 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.5678, fractionDigits:4 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.56780, fractionDigits:5 (roundingMode:halfCeil)
significantDigits
Type: number | undefined
Chiffres significatifs pour le formatage numérique, avec minimumSignificantDigits et maximumSignificantDigits d’Intl.NumberFormat du navigateur; priorité plus élevée que fractionDigits
Exemple - 1234.5678 est converti en 1000, significantDigits:1 - 1234.5678 est converti en 1200, significantDigits:2 - 1234.5678 est converti en 1230, significantDigits:3 - 1234.5678 est converti en 1234, significantDigits:4 - 1234.5678 est converti en 1234.6, significantDigits:5 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.57, significantDigits:6 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.568, significantDigits:7 (roundingMode:halfCeil) - 1234.5678 est converti en 1234.5678, significantDigits:8 (roundingMode:halfCeil)
roundingPriority
Type: "morePrecision" | "lessPrecision" | undefined
Priorité d’arrondi pour le formatage numérique lorsque significantDigits et fractionDigits sont tous deux définis; utilise Intl.NumberFormat du navigateur et suit les mêmes règles que roundingPriority d’Intl.NumberFormat
Exemple - 1234.5678 est converti en 1230, significantDigits:3 (roundingPriority:lessPrecision) - 1234.5678 est converti en 1234.5678, significantDigits:3 (roundingPriority:morePrecision)
roundingMode
Type: "floor" | "ceil" | "expand" | "trunc" | "halfCeil" | "halfFloor" | "halfExpand" | "halfTrunc" | "halfEven" | undefined
Mode d’arrondi pour le formatage numérique, avec Intl.NumberFormat du navigateur et les mêmes règles que roundingMode d’Intl.NumberFormat
label
Type: { visible?: boolean; labelColor?: string; labelFontSize?: number; labelFontWeight?: number; labelAngle?: number; } | undefined
Etiquettes de graduation de l’axe X
visible
Type: boolean | undefined
Indique si les etiquettes sont visibles
labelColor
Type: string | undefined
Couleur des etiquettes
labelFontSize
Type: number | undefined
Taille de police des etiquettes
labelFontWeight
Type: number | undefined
Graisse de police des etiquettes
labelAngle
Type: number | undefined
Angle de rotation des etiquettes
line
Type: { visible?: boolean; lineColor?: string; lineWidth?: number; } | undefined
Ligne de l’axe X
visible
Type: boolean | undefined
Indique si les etiquettes sont visibles
lineColor
Type: string | undefined
Couleur de la ligne d’axe
lineWidth
Type: number | undefined
Largeur du contour
tick
Type: { visible?: boolean; tickInside?: boolean; tickColor?: string; tickSize?: number; } | undefined
Graduations de l’axe X
visible
Type: boolean | undefined
Indique si les etiquettes sont visibles
tickInside
Type: boolean | undefined
Indique si les graduations pointent vers l’interieur
tickColor
Type: string | undefined
Couleur des graduations
tickSize
Type: number | undefined
Taille des graduations
title
Type: { visible?: boolean; titleText?: string; titleColor?: string; titleFontSize?: number; titleFontWeight?: number; } | undefined
Titre de l’axe X
visible
Type: boolean | undefined
Indique si les etiquettes sont visibles
titleText
Type: string | undefined
Texte du titre; suit par defaut la configuration du champ
titleColor
Type: string | undefined
Couleur du titre
titleFontSize
Type: number | undefined
Taille de police du titre
titleFontWeight
Type: number | undefined
Graisse de police du titre
grid
Type: { visible?: boolean; gridColor?: string; gridWidth?: number; gridLineDash?: number[]; } | undefined
Inclut les themes integres light et dark. Les themes personnalises peuvent etre ajoutes via registerTheme.
visible
Type: boolean | undefined
gridColor
Type: string | undefined
selector = [{ profit: 100 }, { profit: 200 }]
gridWidth
Type: number | undefined
- not in : sélectionne les éléments de données dont la valeur du champ de dimension n’est pas dans le tableau
value.
gridLineDash
Type: number[] | undefined
Prend en charge les styles globaux ou les configurations de style conditionnelles.
animation
Type: { duration?: number; easing?: string; } | undefined
Configuration d’animation de l’axe X
duration
Type: number | undefined
value: [100, 300]
easing
Type: string | undefined
}
crosshairLine
Type: CrosshairLine | undefined
Ligne guide verticale
Ligne guide verticale affichee lorsque la souris se deplace sur le graphique.
Configuration de crosshair, utilisee pour afficher des lignes de visee (lignes guide) dans le graphique.
visible
Type: boolean | undefined
Indique si l’axe est visible
lineColor
Type: string | undefined
Couleur de la ligne de visee
labelColor
Type: string | undefined
Couleur de police du label
labelVisible
Type: boolean | undefined
Indique si le libellé de la ligne de visée est affiché
labelBackgroundColor
Type: string | undefined
Couleur d’arrière-plan du label
theme
Type: Theme | undefined
Configuration du thème
Thème
Deux thèmes intégrés sont disponibles, light et dark; de nouveaux thèmes personnalisés peuvent être définis via registerTheme.
length
Type: number
brand
Type: brand
pointStyle
Type: PointStyle | PointStyle[] | undefined
Configuration du style du marqueur de point, utilisée pour définir la couleur, la bordure et les paramètres associés du marqueur de point.
Prend en charge la configuration d’un style global ou d’un style conditionnel
Filtre de données
selector
Type: Selector | Selectors | undefined
- not in : sélectionne les éléments de données dont la valeur du champ de dimension n’est pas dans le tableau
value.
Exemple Couleur du trace du primitive barre (rectangle) selector = "tool" selector = ["tool", "book"] selector = 100 selector = [100, 200]
selector = { profit: 100 } selector = [{ profit: 100 }, { profit: 200 }]
selector = { field: 'category', operator: 'in', value: 'tool' } selector = { field: 'category', operator: 'not in', value: 'book' }
selector = { field: 'profit', operator: '>=', value: 100 } selector = { field: 'profit', operator: 'between' value: [100, 300] }
field
Type: string
Champ de dimension, ID d'un élément de dimension
operator
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
op
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
identique à operator
value
Type: string | number | (string | number)[]
Sélectionne les éléments par valeur de champ de dimension; prend en charge les tableaux
dynamicFilter
Type: ChartDynamicFilter | undefined
Filtre dynamique (exécution de code généré par l’IA)
Implémente une logique complexe de filtrage des données via du code JavaScript généré par l’IA.
Capacités principales :
-
Prend en charge des conditions de filtrage de données arbitrairement complexes
-
Utilise les fonctions utilitaires intégrées pour les opérations de données
-
S’exécute de manière sûre dans l’environnement du navigateur (sandbox Web Worker)
Exigences d’environnement : seuls les environnements de navigateur sont pris en charge ; les environnements Node.js utiliseront fallback
Remarque : selector et dynamicFilter ne peuvent pas être utilisés simultanément ; dynamicFilter a une priorité plus élevée
Configuration du filtre dynamique du graphique
Filtre les marques du graphique (aires, points, etc.) via du code JavaScript généré par l’IA
type
Type: "row-with-field"
description
Type: string | undefined
Description des besoins de filtrage de l’utilisateur (langage naturel).
Exemple "Highlight data items with sales greater than 1000"
code
Type: string
Code de filtrage JavaScript généré par IA
-
Seules les fonctions utilitaires intégrées sont autorisées (accessibles via _ ou R)
-
Paramètre d’entrée : data (tableau), chaque item contient un champ __row_index indiquant le numéro de ligne
-
Doit retourner un tableau de combinaisons index de ligne et champ : Array<{ __row_index: number, field: string }>
-
__row_index indique le numéro de ligne de l’élément d’origine, field indique le champ à mettre en évidence
-
Interdit : eval, Function, opérations asynchrones, DOM API, requêtes réseau
Exemple Mettre en évidence le champ sales des éléments dont sales est supérieur à 1000
Mettre en évidence l’élément dont la marge bénéficiaire est la plus élevée dans chaque zone
Mettre en évidence les éléments filtrés par plusieurs conditions
fallback
Type: Selector | Selectors | undefined
Solution de repli lorsque l'exécution du code échoue ou que l'environnement n'est pas pris en charge
field
Type: string
Champ de dimension, ID d'un élément de dimension
operator
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
op
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
identique à operator
value
Type: string | number | (string | number)[]
Sélectionne les éléments par valeur de champ de dimension; prend en charge les tableaux
result
Type: DynamicFilterExecutionResult<RowWithFieldRes> | undefined
Résultat d'exécution du filtre animé (champ runtime)
Écrit pendant la phase prepare(), en lecture seule à l'exécution
success
Type: false | true
data
Type: T[] | undefined
error
Type: string | undefined
pointVisible
Type: boolean | undefined
Indique si les points sont visibles
pointSize
Type: number | undefined
Taille du point
Taille du point
pointColor
Type: string | undefined
Couleur du marqueur de point
Couleur du marqueur de point
pointColorOpacity
Type: number | undefined
Opacite de la couleur du marqueur de point
Opacite de la couleur du marqueur de point
pointBorderColor
Type: string | undefined
Couleur de bordure du marqueur de point
Couleur de bordure du marqueur de point
pointBorderWidth
Type: number | undefined
Largeur de bordure du marqueur de point
Largeur de bordure du marqueur de point
pointBorderStyle
Type: "solid" | "dashed" | "dotted" | undefined
Style de bordure du marqueur de point
Style de bordure du marqueur de point
Exemple solid
dashed
dotted
annotationPoint
Type: AnnotationPoint | AnnotationPoint[] | undefined
Configuration des points d’annotation. Définit les points d’annotation du graphique à partir des données sélectionnées, y compris la position, le format, le style et les paramètres associés.
selector
Type: Selector | Selectors | undefined
Filtrage des labels; la relation par défaut entre les sélecteurs est OR
field
Type: string
Champ de dimension, ID d'un élément de dimension
operator
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
op
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
identique à operator
value
Type: string | number | (string | number)[]
Sélectionne les éléments par valeur de champ de dimension; prend en charge les tableaux
measureId
Type: string | undefined
Spécifie l’id de mesure auquel appartient le point d’annotation. Dans les scénarios à plusieurs mesures, il peut être combiné avec selector pour localiser précisément le point d’annotation de la mesure cible.
dynamicFilter
Type: ChartDynamicFilter | undefined
Filtre dynamique (exécution de code généré par l’IA)
Implémente une logique complexe de filtrage des données via du code JavaScript généré par l’IA.
Capacités principales :
-
Prend en charge des conditions de filtrage de données arbitrairement complexes
-
Utilise les fonctions utilitaires intégrées pour les opérations de données
-
S’exécute de manière sûre dans l’environnement du navigateur (sandbox Web Worker)
Exigences d’environnement : seuls les environnements de navigateur sont pris en charge ; les environnements Node.js utiliseront fallback
Remarque : selector et dynamicFilter ne peuvent pas être utilisés simultanément ; dynamicFilter a une priorité plus élevée
Configuration du filtre dynamique du graphique
Filtre les marques du graphique (aires, points, etc.) via du code JavaScript généré par l’IA
type
Type: "row-with-field"
description
Type: string | undefined
Description des besoins de filtrage de l’utilisateur (langage naturel).
Exemple "Highlight data items with sales greater than 1000"
code
Type: string
Code de filtrage JavaScript généré par IA
-
Seules les fonctions utilitaires intégrées sont autorisées (accessibles via _ ou R)
-
Paramètre d’entrée : data (tableau), chaque item contient un champ __row_index indiquant le numéro de ligne
-
Doit retourner un tableau de combinaisons index de ligne et champ : Array<{ __row_index: number, field: string }>
-
__row_index indique le numéro de ligne de l’élément d’origine, field indique le champ à mettre en évidence
-
Interdit : eval, Function, opérations asynchrones, DOM API, requêtes réseau
Exemple Mettre en évidence le champ sales des éléments dont sales est supérieur à 1000
Mettre en évidence l’élément dont la marge bénéficiaire est la plus élevée dans chaque zone
Mettre en évidence les éléments filtrés par plusieurs conditions
fallback
Type: Selector | Selectors | undefined
Solution de repli lorsque l'exécution du code échoue ou que l'environnement n'est pas pris en charge
field
Type: string
Champ de dimension, ID d'un élément de dimension
operator
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
op
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
identique à operator
value
Type: string | number | (string | number)[]
Sélectionne les éléments par valeur de champ de dimension; prend en charge les tableaux
result
Type: DynamicFilterExecutionResult<RowWithFieldRes> | undefined
Résultat d'exécution du filtre animé (champ runtime)
Écrit pendant la phase prepare(), en lecture seule à l'exécution
success
Type: false | true
data
Type: T[] | undefined
error
Type: string | undefined
text
Type: string | string[] | undefined
'red'
Exemple 'Texte du repère'
textColor
Type: string | undefined
4
Exemple 'red'
textFontSize
Type: number | undefined
[2, 2]
Exemple 12
textFontWeight
Type: number | undefined
0
Exemple 400
textAlign
Type: "left" | "right" | "center" | undefined
Alignement du texte. En général, définissez right pour afficher le texte à gauche du point d’annotation et le garder dans la zone visible du graphique
Il est recommandé d’utiliser 'right' afin que le texte soit à gauche du point d’annotation
right: le texte est à gauche du point d’annotation, son bord droit est aligné sur le point
left: le texte est à droite du point d’annotation, son bord gauche est aligné sur le point
center: le texte est centré sur le point d’annotation
Exemple 'right' le texte est à gauche du point d’annotation
textBaseline
Type: "top" | "bottom" | "middle" | undefined
Alignement vertical du texte. En général, définissez top pour afficher le texte sous le point d’annotation et le garder dans la zone visible du graphique
Il est recommandé d’utiliser 'top' afin que le texte reste entièrement visible
top: le texte est sous le point d’annotation, son bord supérieur est aligné sur le point
middle: le texte est centré sur le point d’annotation
bottom: le texte est au-dessus du point d’annotation, son bord inférieur est aligné sur le point
Exemple 'top' le texte est sous le point d’annotation
textBackgroundVisible
Type: boolean | undefined
Arrière-plan visible
Exemple true
textBackgroundColor
Type: string | undefined
Couleur d’arrière-plan
Exemple 'red'
textBackgroundBorderColor
Type: string | undefined
Couleur du texte
Exemple 'red'
textBackgroundBorderWidth
Type: number | undefined
Largeur de bordure de l’arrière-plan
Exemple 2
textBackgroundBorderRadius
Type: number | undefined
Rayon des coins de la bordure d’arrière-plan
Exemple 4
textBackgroundPadding
Type: number | undefined
Marge intérieure de l’arrière-plan
Exemple 4
offsetY
Type: number | undefined
Indique si l arriere-plan est visible.
Exemple true
offsetX
Type: number | undefined
Décalage en pixels de l’ensemble du point d’annotation dans la direction X. Lorsque le point est à gauche du graphique (début de l’axe catégoriel), une valeur positive est recommandée; lorsqu’il est à droite (fin de l’axe catégoriel), une valeur négative est recommandée.
Une valeur négative décale l’ensemble vers la gauche; par exemple -10 décale le point, le texte et l’arrière-plan de 10 pixels vers la gauche
Une valeur positive décale l’ensemble vers la droite; par exemple 10 décale le point, le texte et l’arrière-plan de 10 pixels vers la droite
Exemple offsetX: 5, le point d’annotation entier est décalé de 5 pixels vers la droite
annotationVerticalLine
Type: AnnotationVerticalLine | AnnotationVerticalLine[] | undefined
Ligne d’annotation de valeur de dimension, affichée verticalement, avec position et style configurables
xValue
Type: string | number | (string | number)[] | undefined
);
dynamicFilter
Type: ValueDynamicFilter | undefined
Filtre dynamique (exécution de code généré par l’IA)
Calcule dynamiquement la valeur de la ligne d’annotation via du code JavaScript généré par l’IA.
Convient lorsque la position de la ligne d’annotation doit être déterminée dynamiquement à partir des données, comme moyenne, maximum, quantile ou ligne métier.
Prend uniquement en charge les environnements de navigateur (Web Worker requis).
type
Type: "value"
description
Type: string | undefined
Description des besoins de filtrage de l’utilisateur (langage naturel).
Exemple "Highlight data items with sales greater than 1000"
code
Type: string
- Paramètres d’entrée: data (tableau), où chaque élément inclut un champ __row_index représentant le numéro de ligne
- __row_index représente le numéro de ligne de l’élément de données d’origine; field représente le champ à mettre en surbrillance
- Interdit: eval, Function, opérations asynchrones, DOM API, requêtes réseau
Exemple
fallback
Type: string | number | undefined
Solution de repli lorsque l'exécution du code échoue ou que l'environnement n'est pas pris en charge
result
Type: { success: boolean; data?: number | string; } | undefined
Résultat d'exécution du filtre animé (champ runtime)
Écrit pendant la phase prepare(), en lecture seule à l'exécution
success
Type: false | true
data
Type: string | number | undefined
text
Type: string | string[] | undefined
'red'
Exemple 'Texte du repère'
textPosition
Type: "outsideStart" | "outsideEnd" | "outsideMiddle" | "insideStart" | "insideMiddle" | "insideEnd" | undefined
Valeurs du champ de dimension selectionnees ; prend en charge les tableaux.
Exemple 'outsideEnd'
textColor
Type: string | undefined
4
Exemple 'red'
textFontSize
Type: number | undefined
[2, 2]
Exemple 12
textFontWeight
Type: number | undefined
0
Exemple 400
textAlign
Type: "left" | "right" | "center" | undefined
Alignement du texte. En général, définissez right pour afficher le texte à gauche du point d’annotation et le garder dans la zone visible du graphique
Il est recommandé d’utiliser 'right' afin que le texte soit à gauche du point d’annotation
right: le texte est à gauche du point d’annotation, son bord droit est aligné sur le point
left: le texte est à droite du point d’annotation, son bord gauche est aligné sur le point
center: le texte est centré sur le point d’annotation
Exemple 'right' le texte est à gauche du point d’annotation
textBaseline
Type: "top" | "bottom" | "middle" | undefined
Alignement vertical du texte. En général, définissez top pour afficher le texte sous le point d’annotation et le garder dans la zone visible du graphique
Il est recommandé d’utiliser 'top' afin que le texte reste entièrement visible
top: le texte est sous le point d’annotation, son bord supérieur est aligné sur le point
middle: le texte est centré sur le point d’annotation
bottom: le texte est au-dessus du point d’annotation, son bord inférieur est aligné sur le point
Exemple 'top' le texte est sous le point d’annotation
lineVisible
Type: boolean | undefined
Opacité de la couleur de la zone d’annotation
Exemple true
lineColor
Type: string | undefined
Couleur de bordure de la zone d annotation.
Exemple 'red'
lineWidth
Type: number | undefined
Largeur de bordure de la zone d annotation.
Exemple 2
lineStyle
Type: "solid" | "dashed" | "dotted" | undefined
Style du segment de ligne
Exemple
lineStyle: 'solid'
textBackgroundVisible
Type: boolean | undefined
Arrière-plan visible
Exemple true
textBackgroundColor
Type: string | undefined
Couleur d’arrière-plan
Exemple 'red'
textBackgroundBorderColor
Type: string | undefined
Couleur du texte
Exemple 'red'
textBackgroundBorderWidth
Type: number | undefined
Largeur de bordure de l’arrière-plan
Exemple 2
textBackgroundBorderRadius
Type: number | undefined
Rayon des coins de la bordure d’arrière-plan
Exemple 4
textBackgroundPadding
Type: number | undefined
Marge intérieure de l’arrière-plan
Exemple 4
annotationHorizontalLine
Type: AnnotationHorizontalLine | AnnotationHorizontalLine[] | undefined
Ligne d’annotation numérique, comprenant les lignes de moyenne, de maximum et de minimum. Elle est affichée horizontalement et peut être configurée par position et par style. Utilisez cette configuration pour tracer des lignes d’annotation de valeurs numériques, comme des lignes de moyenne.
yValue
Type: string | number | (string | number)[] | undefined
Valeur Y fixe utilisée pour annoter une ligne horizontale. Si l’axe catégoriel est dans la direction Y, vous pouvez saisir une valeur de dimension; si l’axe numérique est dans la direction Y, vous pouvez saisir une valeur numérique précise.
dynamicFilter
Type: ValueDynamicFilter | undefined
Filtre dynamique (exécution de code généré par l’IA)
Calcule dynamiquement la valeur de la ligne d’annotation via du code JavaScript généré par l’IA.
Convient lorsque la position de la ligne d’annotation doit être déterminée dynamiquement à partir des données, comme moyenne, maximum, quantile ou ligne métier.
Prend uniquement en charge les environnements de navigateur (Web Worker requis).
type
Type: "value"
description
Type: string | undefined
Description des besoins de filtrage de l’utilisateur (langage naturel).
Exemple "Highlight data items with sales greater than 1000"
code
Type: string
- Paramètres d’entrée: data (tableau), où chaque élément inclut un champ __row_index représentant le numéro de ligne
- __row_index représente le numéro de ligne de l’élément de données d’origine; field représente le champ à mettre en surbrillance
- Interdit: eval, Function, opérations asynchrones, DOM API, requêtes réseau
Exemple
fallback
Type: string | number | undefined
Solution de repli lorsque l'exécution du code échoue ou que l'environnement n'est pas pris en charge
result
Type: { success: boolean; data?: number | string; } | undefined
Résultat d'exécution du filtre animé (champ runtime)
Écrit pendant la phase prepare(), en lecture seule à l'exécution
success
Type: false | true
data
Type: string | number | undefined
text
Type: string | string[] | undefined
'red'
Exemple 'Texte du repère'
textPosition
Type: "outsideStart" | "outsideEnd" | "outsideMiddle" | "insideStart" | "insideMiddle" | "insideEnd" | undefined
Valeurs du champ de dimension selectionnees ; prend en charge les tableaux.
Exemple 'outsideEnd'
textColor
Type: string | undefined
4
Exemple 'red'
textFontSize
Type: number | undefined
[2, 2]
Exemple 12
textFontWeight
Type: number | undefined
0
Exemple 400
textAlign
Type: "left" | "right" | "center" | undefined
Alignement du texte. En général, définissez right pour afficher le texte à gauche du point d’annotation et le garder dans la zone visible du graphique
Il est recommandé d’utiliser 'right' afin que le texte soit à gauche du point d’annotation
right: le texte est à gauche du point d’annotation, son bord droit est aligné sur le point
left: le texte est à droite du point d’annotation, son bord gauche est aligné sur le point
center: le texte est centré sur le point d’annotation
Exemple 'right' le texte est à gauche du point d’annotation
textBaseline
Type: "top" | "bottom" | "middle" | undefined
Alignement vertical du texte. En général, définissez top pour afficher le texte sous le point d’annotation et le garder dans la zone visible du graphique
Il est recommandé d’utiliser 'top' afin que le texte reste entièrement visible
top: le texte est sous le point d’annotation, son bord supérieur est aligné sur le point
middle: le texte est centré sur le point d’annotation
bottom: le texte est au-dessus du point d’annotation, son bord inférieur est aligné sur le point
Exemple 'top' le texte est sous le point d’annotation
textBackgroundVisible
Type: boolean | undefined
Arrière-plan visible
Exemple true
textBackgroundColor
Type: string | undefined
Couleur d’arrière-plan
Exemple 'red'
textBackgroundBorderColor
Type: string | undefined
Couleur du texte
Exemple 'red'
textBackgroundBorderWidth
Type: number | undefined
Largeur de bordure de l’arrière-plan
Exemple 2
textBackgroundBorderRadius
Type: number | undefined
Rayon des coins de la bordure d’arrière-plan
Exemple 4
textBackgroundPadding
Type: number | undefined
Marge intérieure de l’arrière-plan
Exemple 4
lineVisible
Type: boolean | undefined
Opacité de la couleur de la zone d’annotation
Opacité de la couleur de la zone d’annotation
Exemple true
lineColor
Type: string | undefined
Couleur de bordure de la zone d annotation.
Exemple 'red'
lineWidth
Type: number | undefined
Largeur de bordure de la zone d annotation.
Exemple 2
lineStyle
Type: "solid" | "dashed" | "dotted" | undefined
Style du segment de ligne
Exemple
lineStyle: 'solid'
splitLine
Type: boolean | { positiveColor?: string; negativeColor?: string; } | undefined
Style de tirets de la bordure de la zone d annotation.
positiveColor
Type: string | undefined
Couleur principale de la partie supérieure à la valeur d’annotation
negativeColor
Type: string | undefined
0
annotationArea
Type: AnnotationArea | AnnotationArea[] | undefined
Zone d’annotation
Configuration de zone d’annotation; definit, a partir des donnees selectionnees, la position et le style de la zone d’annotation.
selector
Type: AreaSelector | AreaSelectors | undefined
Indique si la fonction de liaison de dimension est activee lorsque la perspective est activee sur le graphique ou lorsque les mesures sont combinees.
field
Type: string
Champ de dimension, ID d'un élément de dimension
operator
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
op
Type: "in" | "not in" | undefined
identique à operator
- in: sélectionne les éléments de données dont la valeur du champ de dimension appartient à la valeur spécifiée
identique à operator
value
Type: string | number | (string | number)[]
Sélectionne les éléments par valeur de champ de dimension; prend en charge les tableaux
text
Type: string | string[] | undefined
'red'
Exemple 'Texte du repère'
textPosition
Type: "left" | "top" | "topLeft" | "topRight" | "right" | "bottom" | "bottomLeft" | "bottomRight" | undefined
2
Exemple 'top'
textColor
Type: string | undefined
4
Exemple 'red'
textFontSize
Type: number | undefined
[2, 2]
Exemple 12
textFontWeight
Type: number | undefined
0
Exemple 400
textAlign
Type: "left" | "right" | "center" | undefined
Alignement du texte. En général, définissez right pour afficher le texte à gauche du point d’annotation et le garder dans la zone visible du graphique
Il est recommandé d’utiliser 'right' afin que le texte soit à gauche du point d’annotation
right: le texte est à gauche du point d’annotation, son bord droit est aligné sur le point
left: le texte est à droite du point d’annotation, son bord gauche est aligné sur le point
center: le texte est centré sur le point d’annotation
Exemple 'right' le texte est à gauche du point d’annotation
textBaseline
Type: "top" | "bottom" | "middle" | undefined
Alignement vertical du texte. En général, définissez top pour afficher le texte sous le point d’annotation et le garder dans la zone visible du graphique
Il est recommandé d’utiliser 'top' afin que le texte reste entièrement visible
top: le texte est sous le point d’annotation, son bord supérieur est aligné sur le point
middle: le texte est centré sur le point d’annotation
bottom: le texte est au-dessus du point d’annotation, son bord inférieur est aligné sur le point
Exemple 'top' le texte est sous le point d’annotation
textBackgroundVisible
Type: boolean | undefined
Arrière-plan visible
Exemple true
textBackgroundColor
Type: string | undefined
Couleur d’arrière-plan
Exemple 'red'
textBackgroundBorderColor
Type: string | undefined
Couleur du texte
Exemple 'red'
textBackgroundBorderWidth
Type: number | undefined
Largeur de bordure de l’arrière-plan
Exemple 2
textBackgroundBorderRadius
Type: number | undefined
Rayon des coins de la bordure d’arrière-plan
Exemple 4
textBackgroundPadding
Type: number | undefined
Marge intérieure de l’arrière-plan
Exemple 4
areaColor
Type: string | undefined
Couleur de la zone de repère
Exemple 'red'
areaColorOpacity
Type: number | undefined
Opacité du remplissage de la zone d’annotation
Exemple 0.5
areaBorderColor
Type: string | undefined
Couleur de bordure de la zone d’annotation
Exemple 'red'
areaBorderWidth
Type: number | undefined
Largeur de bordure de la zone d’annotation
Exemple 2
areaBorderRadius
Type: number | undefined
Rayon de bordure de la zone d’annotation
Exemple 4
areaLineDash
Type: number[] | undefined
Style de ligne de bordure de la zone d’annotation
Exemple [2, 2]
outerPadding
Type: number | undefined
Marge de la zone de repère
Exemple 0
locale
Type: "zh-CN" | "en-US" | "ja-JP" | "de-DE" | "id-ID" | "fr-FR" | "ko-KR" | "vi-VN" | undefined
Language
Configuration de la langue du graphique. Prend en charge 'zh-CN' et 'en-US'; il est aussi possible d’appeler intl.setLocale('zh-CN') pour définir la langue