ui.Chart.onClick
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Enregistre un rappel déclenché lorsque l'utilisateur clique sur le graphique.
Renvoie un ID qui peut être transmis à unlisten() pour annuler l'enregistrement du rappel.
| Utilisation | Renvoie |
|---|
Chart.onClick(callback) | Chaîne |
| Argument | Type | Détails |
|---|
ceci : ui.chart | ui.Chart | Instance ui.Chart. |
callback | Fonction | Rappel à déclencher lorsque l'utilisateur clique sur le graphique. Le rappel reçoit trois arguments : la valeur x, la valeur y et le nom de la série. Les valeurs temporelles sont représentées en millisecondes de l'epoch UTC, comme les valeurs "system:time_start" des éléments. Si l'utilisateur clique sur une entrée de légende pour sélectionner une série entière, les valeurs x et y sont nulles. Si l'utilisateur clique sur un point déjà sélectionné, tous les arguments sont nuls, ce qui indique que la sélection a été effacée. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/29 (UTC).
[null,null,["Dernière mise à jour le 2025/07/29 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003eChart.onClick()\u003c/code\u003e method registers a callback function that is triggered when a user clicks on a chart.\u003c/p\u003e\n"],["\u003cp\u003eThis function returns a unique ID that can be used with \u003ccode\u003eunlisten()\u003c/code\u003e to remove the registered callback.\u003c/p\u003e\n"],["\u003cp\u003eThe callback function receives the x-value, y-value, and series name as arguments, providing information about the clicked point on the chart.\u003c/p\u003e\n"],["\u003cp\u003eClicking on a legend entry to select a series results in null x and y values, while clicking an already-selected point results in all null arguments indicating selection clearance.\u003c/p\u003e\n"]]],[],null,["# ui.Chart.onClick\n\n\u003cbr /\u003e\n\nRegisters a callback that's fired when the chart is clicked.\n\n\u003cbr /\u003e\n\nReturns an ID which can be passed to unlisten() to unregister the callback.\n\n| Usage | Returns |\n|---------------------------|---------|\n| Chart.onClick`(callback)` | String |\n\n| Argument | Type | Details |\n|------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `ui.chart` | ui.Chart | The ui.Chart instance. |\n| `callback` | Function | The callback to fire when the chart is clicked. The callback is passed three arguments: the x-value, the y-value, and the series name. Time values are represented in UTC epoch milliseconds, like \"system:time_start\" values on assets. If the user clicks on a legend entry to select an entire series, the x- and y-values are null. If the user clicks an already-selected point, all arguments are null, indicating the selection was cleared. |"]]
