From 1a2cc27f3aff07221abd551fc84f48052eff4550 Mon Sep 17 00:00:00 2001 From: Evert Timberg Date: Sun, 14 Mar 2021 01:12:06 -0500 Subject: [PATCH] Add documentation on how plugin hooks interact with the chart (#8634) * Add documentation on how plugin hooks interact with the chart * Add draw.io file for flowcharts --- docs/docs/developers/plugin_flowcharts.drawio | 1 + docs/docs/developers/plugins.md | 19 ++++++++++++++++++ docs/static/img/init_flowchart.png | Bin 0 -> 14834 bytes docs/static/img/render_flowchart.png | Bin 0 -> 45282 bytes docs/static/img/update_flowchart.png | Bin 0 -> 47214 bytes 5 files changed, 20 insertions(+) create mode 100644 docs/docs/developers/plugin_flowcharts.drawio create mode 100644 docs/static/img/init_flowchart.png create mode 100644 docs/static/img/render_flowchart.png create mode 100644 docs/static/img/update_flowchart.png diff --git a/docs/docs/developers/plugin_flowcharts.drawio b/docs/docs/developers/plugin_flowcharts.drawio new file mode 100644 index 000000000..280f987ec --- /dev/null +++ b/docs/docs/developers/plugin_flowcharts.drawio @@ -0,0 +1 @@ +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 \ No newline at end of file diff --git a/docs/docs/developers/plugins.md b/docs/docs/developers/plugins.md index 09417f609..e3b280e4d 100644 --- a/docs/docs/developers/plugins.md +++ b/docs/docs/developers/plugins.md @@ -1,6 +1,7 @@ --- title: Plugins --- +import useBaseUrl from '@docusaurus/useBaseUrl'; Plugins are the most efficient way to customize or change the default behavior of a chart. They have been introduced at [version 2.1.0](https://github.com/chartjs/Chart.js/releases/tag/2.1.0) (global plugins only) and extended at [version 2.5.0](https://github.com/chartjs/Chart.js/releases/tag/v2.5.0) (per chart plugins and options). @@ -119,3 +120,21 @@ var chart = new Chart(ctx, { ## Plugin Core API Read more about the [existing plugin extension hooks](https://github.com/chartjs/Chart.js/blob/master/types/index.esm.d.ts#L733). + +### Chart Initialization + +Plugins are notified during the initialization process. These hooks can be used to setup data needed for the plugin to operate. + +Chart.js init flowchart + +### Chart Update + +Plugins are notified during throughout the update process. + +Chart.js update flowchart + +### Rendering + +Plugins can interact with the chart throughout the render process. The rendering process is documented in the flowchart below. Each of the green processes is a plugin notification. The red lines indicate how cancelling part of the render process can occur when a plugin returns `false` from a hook. Not all hooks are cancelable, however, in general most `before*` hooks can be cancelled. + +Chart.js render pipeline flowchart diff --git a/docs/static/img/init_flowchart.png b/docs/static/img/init_flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..49a8671ce8d933baae51cd20b7486089c3a5f94d GIT binary patch literal 14834 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 literal 0 Hc-jL100001 diff --git a/docs/static/img/render_flowchart.png b/docs/static/img/render_flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..a140c55c0a5f3fd1391cb873ded829cf6da21a9f GIT binary patch literal 45282 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 literal 0 Hc-jL100001 diff --git a/docs/static/img/update_flowchart.png b/docs/static/img/update_flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..13329de39b1c40e2f257cc411358c8aaed5738de GIT binary patch literal 47214 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 literal 0 Hc-jL100001 -- 2.47.3