{"id":36543899,"url":"https://github.com/plotly/react-chart-editor","last_synced_at":"2026-01-12T05:53:54.131Z","repository":{"id":27442614,"uuid":"99609572","full_name":"plotly/react-chart-editor","owner":"plotly","description":"Customizable React-based editor panel for Plotly charts","archived":false,"fork":false,"pushed_at":"2025-06-04T21:15:47.000Z","size":27579,"stargazers_count":521,"open_issues_count":162,"forks_count":114,"subscribers_count":40,"default_branch":"master","last_synced_at":"2025-11-27T09:44:57.822Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://plotly.github.io/react-chart-editor/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/plotly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"custom":"https://plot.ly/products/consulting-and-oem/"}},"created_at":"2017-08-07T18:52:28.000Z","updated_at":"2025-09-22T08:00:22.000Z","dependencies_parsed_at":"2023-09-26T06:35:25.745Z","dependency_job_id":"30a14252-ad38-4dfd-866b-083b8749daab","html_url":"https://github.com/plotly/react-chart-editor","commit_stats":{"total_commits":1644,"total_committers":18,"mean_commits":91.33333333333333,"dds":0.6587591240875912,"last_synced_commit":"a2ba64d6e4c1a4023f65594aecf0dff8483e3f96"},"previous_names":["plotly/react-plotly.js-editor"],"tags_count":116,"template":false,"template_full_name":null,"purl":"pkg:github/plotly/react-chart-editor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plotly%2Freact-chart-editor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plotly%2Freact-chart-editor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plotly%2Freact-chart-editor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plotly%2Freact-chart-editor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plotly","download_url":"https://codeload.github.com/plotly/react-chart-editor/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plotly%2Freact-chart-editor/sbom","scorecard":{"id":738071,"data":{"date":"2025-08-11","repo":{"name":"github.com/plotly/react-chart-editor","commit":"b3891d801646cb48e93aca0c5bd3271f0a571ae8"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.2,"checks":[{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":5,"reason":"Found 2/4 approved changesets -- score normalized to 5","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 29 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-22T16:30:01.719Z","repository_id":27442614,"created_at":"2025-08-22T16:30:01.719Z","updated_at":"2025-08-22T16:30:01.719Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28335583,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T00:36:25.062Z","status":"online","status_checked_at":"2026-01-12T02:00:08.677Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-12T05:53:53.457Z","updated_at":"2026-01-12T05:53:54.123Z","avatar_url":"https://github.com/plotly.png","language":"JavaScript","funding_links":["https://plot.ly/products/consulting-and-oem/"],"categories":[],"sub_categories":[],"readme":"# react-chart-editor\n\n\u003e React component for creating \u0026 editing D3 charts. [Sponsor an addition to this project](https://plot.ly/products/consulting-and-oem/)\n\n![master](https://circleci.com/gh/plotly/react-chart-editor/tree/master.svg?style=svg\u0026circle-token=df4574e01732846dba81d800d062be5f0fef5641)\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://dash.plotly.com/project-maintenance\"\u003e\n    \u003cimg src=\"https://dash.plotly.com/assets/images/maintained-by-plotly.png\" width=\"400px\" alt=\"Maintained by Plotly\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\n## Demo \u0026 Screenshots\n\nCheck out the [live demo here](https://plotly.github.io/react-chart-editor/).\n\n![gif](examples/editor.gif)\n\n## Quick start\n\nCheck out the demo of the latest release of the `DefaultEditor` at https://plotly.github.io/react-chart-editor/ or run it locally with:\n\n```\ngit clone [this repo]\ncd react-chart-editor\ncd examples/demo\nyarn install\nyarn watch\n```\n\nSee more examples\n[here](https://github.com/plotly/react-chart-editor/tree/master/examples).\n\n## Overview\n\nThis module's entry point is a React component called `\u003cPlotlyEditor /\u003e` which connects an instance of `\u003cEditorControls /\u003e` to a [plotly.js](https://plot.ly/javascript/)-powered `\u003cPlot /\u003e` component care of [`react-plotly.js`](https://github.com/plotly/react-plotly.js). `\u003cPlotlyEditor /\u003e` accepts as children React components whose descendents are input elements wrapped via `connectToContainer()` calls so as to bind them to the `\u003cPlot /\u003e`'s figure's values. If no children are passed to the `\u003cPlotlyEditor /\u003e`, the `\u003cDefaultEditor /\u003e` is used. This module also exposes the [building block components](#Built-in-Components) that comprise the `\u003cDefaultEditor /\u003e` so that developers can create their own customized editors.\n\n## Styling the `\u003cDefaultEditor /\u003e` and the built-in components\n\n* Import editor styles with `import 'react-chart-editor/lib/react-chart-editor.min.css'`\n* Interested in [theming](https://github.com/plotly/react-chart-editor/tree/master/THEMING.md)?\n* Need to support IE11? import the IE css instead: `import 'react-chart-editor/lib/react-chart-editor.ie.min.css'`\n\n## Development Setup\n\nThis repo contains a [dev app](https://github.com/plotly/react-chart-editor/tree/master/dev) that depends on the components locally and is configured for hot reloading, for easy local development. A `jest`-based test suite is also included.\n\n```\ncp accessTokens.tpl.js accessTokens.js # and edit to taste\nyarn install\nyarn watch\n# hacking happens here\nyarn test\n```\n\n## Built-in Components\n\nThis module provides a number of nestable _containers_ which are intended to contain _fields_ that render _widgets_ that have been connected to individual values in the figure via _connector functions_. Containers can also be connected to parts of the figure tree (e.g. `layout` or specific traces in `data`) such that their child fields map to the appropriate leaf values. A field must have a connected container as an ancestor in order to be bound to the figure. The `\u003cPlotlyEditor /\u003e` and connector functions use the React [`context` API](https://reactjs.org/docs/legacy-context.html) to push configuration information to child components.\n\nAt a pseudo-code level it looks like this:\n\n```javascript\n\u003cPlotlyEditor {...etc}\u003e\n  \u003cConnectedContainer {...etc}\u003e\n    \u003cField attr=\"path.to.figure.value\" {...etc} /\u003e\n  \u003c/ConnectedContainer\u003e\n\u003c/PlotlyEditor\u003e\n```\n\nThe [custom editor example](https://github.com/plotly/react-chart-editor/tree/master/examples/custom) shows how to build a custom editor, and shows off all of the general-purpose containers and fields listed below.\n\n### General-purpose Containers\n\n* `\u003cPanelMenuWrapper /\u003e`: renders as a sidebar selector menu for `\u003cPanel /\u003e`s\n* `\u003cPlotlyPanel /\u003e`: renders as a generic rectangular container with special handling for collapsing/expanding child `\u003cFold /\u003e`s and optionally an 'add' button for creating them, has special [visibility rules](https://github.com/plotly/react-chart-editor/tree/master/src/components/containers/__tests__/ConnectedContainersVisibility-test.js) that depend on plotly figure\n* `\u003cPlotlyFold /\u003e`: collapsable container within a `\u003cPanel /\u003e`, has special [visibility rules](https://github.com/plotly/react-chart-editor/tree/master/src/components/containers/__tests__/ConnectedContainersVisibility-test.js) that depend on plotly figure\n* `\u003cPlotlySection /\u003e`: uncollapsable container within a `\u003cPanel /\u003e` or `\u003cFold /\u003e`, has special [visibility rules](https://github.com/plotly/react-chart-editor/tree/master/src/components/containers/__tests__/ConnectedContainersVisibility-test.js) that depend on plotly figure\n* `\u003cPanel/\u003e`, `\u003cFold/\u003e`, `\u003cSection/\u003e`: same as `PlotlyPanel`, `PlotlyFold`, `PlotlySection`, but there are no special visibility rules, those containers [always show, and always show their children](https://github.com/plotly/react-chart-editor/tree/master/src/components/containers/__tests__/UnconnectedContainersVisibility-test.js), but Fold does not have the canDelete functionality as its context related\n* `\u003cSingleSidebarItem/\u003e`: wraps any item you would like to see appear in the sidebar menu.\n\n### General-purpose Fields\n\nAll Fields except `\u003cInfo /\u003e` accept an `attr` property to bind them to a key in the figure (see https://plot.ly/javascript/reference/ for exhaustive documentation of figure keys). This property can be a `.`-delimited path to a leaf, starting at the context-appropriate point in the figure for the parent container (see connector functions below).\n\n* `\u003cInfo /\u003e`: renders its children as HTML, useful for displaying help text\n* `\u003cNumeric /\u003e`: renders as a text field with arrows and units, useful for numeric values\n* `\u003cRadio /\u003e`: renders as a button group, useful for mutually-exclusive low-cardinality enumerable values\n* `\u003cDropdown /\u003e`: renders as a dropdown menu useful for mutually-exclusive high-cardinality enumerable values\n* `\u003cDropzone/\u003e`: renders a dropzone component to drag and drop files to load\n* `\u003cColorPicker /\u003e`: renders as a popup color-picker, useful for CSS color hex value strings\n* `\u003cColorscalePicker /\u003e`: npm module [react-colorscales](https://github.com/plotly/react-colorscales)\n* `\u003cFlaglist /\u003e`: renders as a list of checkboxes, useful for `+`-joined flag lists like `data[].mode`\n* `\u003cTextEditor /\u003e`: renders as a WYSIWYG editor, useful for text like `layout.title`, takes props: `latexOnly`, `richTextOnly`, `htmlOnly` if no format props given, defaults to the `MultiFormat` text editor (latex \u0026\u0026 richText \u0026\u0026 html)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"examples/components.png\" alt=\"Components\" width=\"432\" height=\"692\" border=\"1\"\u003e\n\u003c/p\u003e\n\n### Widgets\n\nSimple component that takes in props and renders.\n\n* `\u003cButton/\u003e`: simple button component, useful when combined with `\u003cSingleSidebarItem/\u003e` to add as menu item\n\n### Special-Purpose Containers\n\n* `\u003cTraceAccordion /\u003e`: `\u003cPanel /\u003e` whose children are replicated into `\u003cFolds /\u003e` connected to traces via `connectTraceToPlot()`.\n* `\u003cLayoutPanel /\u003e`: `\u003cPanel /\u003e` whose children are connected to the `layout` figure key\n* `\u003cLayoutSection /\u003e`: `\u003cSection /\u003e` whose children are connected to the `layout` figure key\n* `\u003cTraceRequiredPanel /\u003e`: `\u003cLayoutPanel /\u003e` renders `\u003cPanelEmpty /\u003e` if no trace data is set, can add extra conditions (i.e. an array of functions that will be run) with the `extraConditions` prop and a matching array with extraEmptyPanelMessages to show when those conditions are not met.\n* `\u003cAnnotationAccordion /\u003e`: `\u003cPanel /\u003e` whose children are replicated into `\u003cFolds /\u003e` connected to annotations via `connectAnnotationToLayout()`. For use in a `\u003cLayoutPanel /\u003e`.\n* `\u003cShapeAccordion /\u003e`: `\u003cPanel /\u003e` whose children are replicated into `\u003cFolds /\u003e` connected to shapes via `connectShapeToLayout()`. For use in a `\u003cLayoutPanel /\u003e`.\n* `\u003cImageAccordion /\u003e`: `\u003cPanel /\u003e` whose children are replicated into `\u003cFolds /\u003e` connected to images via `connectImageToLayout()`. For use in a `\u003cLayoutPanel /\u003e`.\n* `\u003cAxesFold /\u003e`: `\u003cFold /\u003e` whose children are bound to axis-specific keys. For use in a `\u003cLayoutPanel /\u003e`; and automatically contains an `\u003cAxesSelector /\u003e` (see below).\n* `\u003cTraceMarkerSection /\u003e`: `\u003cSection /\u003e` with trace-specific name handling. For use in containers bound to traces e.g. as children of `\u003cTraceAccordion /\u003e`.\n\n### Special-Purpose Fields\n\nFor use in containers bound to traces e.g. as children of `\u003cTraceAccordion /\u003e`:\n\n* `\u003cDataSelector /\u003e`: renders as a `\u003cDropdown /\u003e` coupled to `data[].*src` etc, triggers `onUpdateTraces` when changed\n* `\u003cTraceSelector /\u003e`: renders as a `\u003cDropdown /\u003e` useful for `data[].type`\n* `\u003cLineDashSelector /\u003e`: renders as a `\u003cDropdown /\u003e` useful for `data[].line.dash`\n* `\u003cLineShapeSelector /\u003e`: renders as a `\u003cDropdown /\u003e` useful for `data[].line.shape`\n* `\u003cSymbolSelector /\u003e`: renders as a `\u003cDropdown /\u003e` useful for `data[].marker.symbol`\n* `\u003cPositioningRef /\u003e`: renders as a `\u003cDropdown /\u003e` useful for `layout.*.xref/yref` where the allowable values are `paper|[axis]`\n* `\u003cErrorBars/\u003e`: renders a set of controls that control a trace's error bars (`visibility`, `type`, `value`, `valueminus`, `array`, `arrayminus`)\n\nFor use in containers bound to layout:\n\n* `\u003cFontSelector /\u003e`: renders as a `\u003cDropdown /\u003e` whose options are rendered in the selected font\n* `\u003cCanvasSize /\u003e`: renders as a `\u003cNumeric /\u003e` with visibility coupled to `layout.autosize`\n\nFor use in containers bound to axes:\n\n* `\u003cAxesSelector /\u003e`: renders as a `\u003cRadio /\u003e` to select one or all axes. Must be in a container bound to a figure via `connectAxesToPlot()` and sets that container's context such that its children are bound to either all axes or just the selected one. `\u003cAxesFold\u003e`s automatically contain this component.\n* `\u003cAxesRange /\u003e`: numeric with visibility coupled to `layout.*axis.autorange`\n\nFor use in containers bound to annotations e.g. as children of `\u003cAnnotationAccordion /\u003e`:\n\n* `\u003cAnnotationRef /\u003e`: renders as a `\u003cDropdown /\u003e` useful for `layout.annotations[].xref`, `layout.annotations[].yref`\n* `\u003cAnnotationArrowRef /\u003e`: renders as a `\u003cDropdown /\u003e` useful for `layout.annotations[].axref`, `layout.annotations[].ayref`\n* `\u003cArrowSelector /\u003e`: renders as a `\u003cDropdown /\u003e` useful for `layout.annotations[].arrowhead`\n\n### Connector functions\n\n* `connectToContainer( Component )`: returns a field component that can be bound to a figure value via the `attr` prop.\n* `connectTraceToPlot( Container )`: returns a wrapped container component that can be bound to a figure trace such that its children are bound to that trace's figure entry under the `data` key, e.g. `\u003cTraceAccordion /\u003e` above.\n* `connectLayoutToPlot( Container )`: returns a wrapped container component that can be bound to a figure such that its children are bound to that figure's layout under the `layout` key.\n* `connectAxesToLayout( Container )`: returns a wrapped container component that should contain an `\u003cAxesSelector /\u003e` field (see above) and can be bound to a figure such that its children are bound to that figure's axes entries under the `layout.*axis` keys.\n* `connectAnnotationToLayout( Container )`: returns a wrapped container component that can be bound to a figure annotation such that its children are bound to that annotation's figure entry under the `layout.annotations` key, e.g. the `\u003cFold\u003e`s in `\u003cAnnotationAccordion /\u003e` above.\n* `connectShapeToLayout( Container )`: returns a wrapped container component that can be bound to a shape such that its children are bound to that shape's figure entry under the `layout.shapes` key, e.g. the `\u003cFold\u003e`s in `\u003cShapeAccordion /\u003e` above.\n* `connectImagesToLayout( Container )`: returns a wrapped container component that can be bound to an image such that its children are bound to that image's figure entry under the `layout.image` key, e.g. the `\u003cFold\u003e`s in `\u003cImageAccordion /\u003e` above.\n\n## Mapbox Access Tokens\n\nTo use Satellite Maps in the Editor, [Mapbox access tokens](https://www.mapbox.com/help/how-access-tokens-work/) are required.\n\nOnce you have your tokens, you can provide it as a config prop to the `\u003cPlotlyEditor /\u003e` component: `\u003cPlotlyEditor config={{mapboxAccessToken: 'your token'}}/\u003e`\n\n## See also\n\n* [plotly.js](https://github.com/plotly/plotly.js)\n* [react-plotly.js](https://github.com/plotly/react-plotly.js)\n\n## License\n\n\u0026copy; 2019 Plotly, Inc. MIT License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplotly%2Freact-chart-editor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplotly%2Freact-chart-editor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplotly%2Freact-chart-editor/lists"}