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 HcmV?d00001 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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
    V1zRq)So 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 B`TGC> literal 0 HcmV?d00001 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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 BdO83A literal 0 HcmV?d00001