ui.Chart.onClick
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Registriert einen Callback, der ausgelöst wird, wenn auf das Diagramm geklickt wird.
Gibt eine ID zurück, die an „unlisten()“ übergeben werden kann, um den Callback zu deregistrieren.
| Nutzung | Ausgabe |
|---|
Chart.onClick(callback) | String |
| Argument | Typ | Details |
|---|
So gehts: ui.chart | ui.Chart | Die ui.Chart-Instanz. |
callback | Funktion | Der Callback, der ausgelöst werden soll, wenn auf das Diagramm geklickt wird. Der Callback erhält drei Argumente: den x-Wert, den y-Wert und den Namen der Reihe. Zeitwerte werden in UTC-Epochenmillisekunden dargestellt, wie z. B. „system:time_start“-Werte für Assets. Wenn der Nutzer auf einen Legendeneintrag klickt, um eine ganze Reihe auszuwählen, sind die x- und y-Werte null. Wenn der Nutzer auf einen bereits ausgewählten Punkt klickt, sind alle Argumente „null“, was darauf hinweist, dass die Auswahl aufgehoben wurde. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-29 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
