| <!doctype html> |
| <html data-n-head-ssr> |
| <head> |
| <link rel="stylesheet" type="text/css" href="https://fastly.jsdelivr.net/npm/bootstrap@3.3.7/dist/css/bootstrap.min.css"> |
| <link rel="stylesheet" type="text/css" href="https://fastly.jsdelivr.net/gh/apache/echarts-website@asf-site/zh/css/main.css"> |
| <link rel="stylesheet" href="https://fastly.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css"> |
| <title>Handbook - Apache ECharts</title><meta data-n-head="ssr" charset="utf-8"><meta data-n-head="ssr" name="viewport" content="width=device-width,initial-scale=1"><meta data-n-head="ssr" data-hid="description" name="description" content=""><meta data-n-head="ssr" data-hid="docsearch:language" name="docsearch:language" content="en"><base href="/handbook/"><link data-n-head="ssr" rel="icon" type="image/x-icon" href="https://fastly.jsdelivr.net/gh/apache/echarts-website@asf-site/zh/images/favicon.png"><link rel="preload" href="/handbook/_nuxt/5870c6f.js" as="script"><link rel="preload" href="/handbook/_nuxt/js/f74f8c0f406ea2522d04.js" as="script"><link rel="preload" href="/handbook/_nuxt/css/8b5c6d8.css" as="style"><link rel="preload" href="/handbook/_nuxt/js/e96421e0f27cc5a35348.js" as="script"><link rel="preload" href="/handbook/_nuxt/css/35be9a3.css" as="style"><link rel="preload" href="/handbook/_nuxt/js/d6226697ecb43e03cd0d.js" as="script"><link rel="preload" href="/handbook/_nuxt/css/5da5a8e.css" as="style"><link rel="preload" href="/handbook/_nuxt/js/d63042719a059a581645.js" as="script"><link rel="preload" href="/handbook/_nuxt/css/a9c5fa4.css" as="style"><link rel="preload" href="/handbook/_nuxt/js/4f3ab71f990e271ccbe4.js" as="script"><link rel="stylesheet" href="/handbook/_nuxt/css/8b5c6d8.css"><link rel="stylesheet" href="/handbook/_nuxt/css/35be9a3.css"><link rel="stylesheet" href="/handbook/_nuxt/css/5da5a8e.css"><link rel="stylesheet" href="/handbook/_nuxt/css/a9c5fa4.css"> |
| </head> |
| <body> |
| <div data-server-rendered="true" id="__nuxt"><!----><div id="__layout"><div><nav role="navigation" class="navbar navbar-default navbar-fixed-top"><div class="container-fluid"><div class="navbar-header"><button type="button" data-toggle="collapse" data-target="#navbar-collapse" aria-expanded="false" class="navbar-toggle collapsed"><span class="sr-only">Toggle navigation</span><span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span></button><a href="https://echarts.apache.org/en/index.html" class="navbar-brand"><img src="https://echarts.apache.org/en/images/logo.png" alt="echarts logo" class="navbar-logo"></a></div><div id="navbar-collapse" class="collapse navbar-collapse"><ul class="nav navbar-nav navbar-left"><li id="nav-index"><a href="https://echarts.apache.org/en/index.html">Home</a></li><li id="nav-doc" class="dropdown"><a href="#" data-toggle="dropdown" class="dropdown-toggle">Docs<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://echarts.apache.org/en/feature.html">Features</a></li><li><a href="https://echarts.apache.org/handbook/en/get-started/">Handbook<span class="new">new</span></a></li><li><a href="https://echarts.apache.org/en/api.html">API</a></li><li><a href="https://echarts.apache.org/en/option.html">Chart Configuration</a></li><li><a href="https://echarts.apache.org/en/changelog.html">Changelog</a></li><li><a href="https://echarts.apache.org/en/faq.html">FAQ</a></li><li><a href="https://echarts.apache.org/handbook/en/basics/release-note/v5-upgrade-guide">V5 Upgrade Guide</a></li></ul></li><li id="nav-download" class="dropdown"><a href="#" data-toggle="dropdown" class="dropdown-toggle">Download<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://echarts.apache.org/en/download.html">Download</a></li><li><a href="https://echarts.apache.org/en/download-theme.html">Download Themes</a></li><li><a href="https://echarts.apache.org/en/download-extension.html">Download Extensions</a></li></ul></li><li id="nav-examples"><a href="https://echarts.apache.org/examples/en/index.html">Examples</a></li><li id="nav-resources"><a href="#" data-toggle="dropdown" class="dropdown-toggle">Resources<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://echarts.apache.org/en/spreadsheet.html">Spread Sheet Tool</a></li><li><a href="https://echarts.apache.org/en/theme-builder.html">Theme Builder</a></li><li><a href="https://echarts.apache.org/en/cheat-sheet.html">Cheat Sheet</a></li><li><a href="https://echarts.apache.org/en/resources.html">More Resources</a></li></ul></li><li id="nav-contribute"><a href="#" data-toggle="dropdown" class="dropdown-toggle">Community<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://echarts.apache.org/en/events.html">Events</a></li><li><a href="https://echarts.apache.org/en/committers.html">Committers</a></li><li><a href="https://echarts.apache.org/en/maillist.html">Mailing List</a></li><li><a href="https://echarts.apache.org/en/contributing.html">How to Contribute</a></li><li><a href="https://echarts.apache.org/en/dependencies.html">Dependencies</a></li><li><a href="https://echarts.apache.org/en/coding-standard.html">Code Standard</a></li><li><a href="https://github.com/apache/echarts" target="_blank">Source Code (GitHub)<svg width="15px" height="15px" viewbox="0 0 100 100" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="icon-external-link"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li><li><a href="https://github.com/apache/echarts/issues" target="_blank">Issues (GitHub)<svg width="15px" height="15px" viewbox="0 0 100 100" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="icon-external-link"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li></ul></li><li id="nav-others"><a href="#" data-toggle="dropdown" class="dropdown-toggle">ASF<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://www.apache.org/" target="_blank">Apache Software Foundation<svg width="15px" height="15px" viewbox="0 0 100 100" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="icon-external-link"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li><li><a href="https://echarts.apache.org/en/security.html">Security</a></li><li><a href="https://www.apache.org/licenses/" target="_blank">License<svg width="15px" height="15px" viewbox="0 0 100 100" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="icon-external-link"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li><li><a href="https://www.apache.org/events/current-event" target="_blank">Events<svg width="15px" height="15px" viewbox="0 0 100 100" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="icon-external-link"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li><li><a href="https://www.apache.org/foundation/sponsorship.html" target="_blank">Sponsorship<svg width="15px" height="15px" viewbox="0 0 100 100" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="icon-external-link"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li><li><a href="https://www.apache.org/foundation/thanks.html" target="_blank">Thanks<svg width="15px" height="15px" viewbox="0 0 100 100" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" class="icon-external-link"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></li></ul></li></ul><ul class="nav navbar-nav navbar-right"><li id="nav-homeen"><a href="javascript:;" onclick='changeLang("zh")'>中文</a></li></ul></div></div></nav> <div class="page-main"><div class="page-content handbook-content single-page container-fluid row flex-xl-nowrap"><div class="bd-sidebar col-sm-3 col-md-2 closed"><div class="sidebar-search"><input id="handbook-search-intput" type="search" placeholder="Search Handbook"> <div class="search-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"></path></svg></div></div> <div class="bd-docs-nav"><ul class="nav bd-sidenav nav-root level0"><li class="nav-item"><a href="/handbook/en/get-started" class="nav-link"><span class="title">Get Started</span></a> <ul class="nav bd-sidenav level1" style="display:none"></ul></li><li class="nav-item"><div class="nav-link"><span class="title">Basics</span></div> <ul class="nav bd-sidenav level1"><li class="nav-item"><a href="/handbook/en/basics/download" class="nav-link"><span class="title">Download ECharts</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/basics/import" class="nav-link"><span class="title">Import ECharts</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><!----><li class="nav-item"><a href="/handbook/en/basics/help" class="nav-link"><span class="title">Get Help</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><li class="nav-item"><a class="nav-link"><span class="title">What's New</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level2" style="display:none"><li class="nav-item"><a href="/handbook/en/basics/release-note/v5-feature" class="nav-link"><span class="title">ECharts 5 Features</span></a> <ul class="nav bd-sidenav level3" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/basics/release-note/v5-upgrade-guide" class="nav-link"><span class="title">Migration from v4 to v5</span></a> <ul class="nav bd-sidenav level3" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/basics/release-note/5-2-0" class="nav-link"><span class="title">5.2</span></a> <ul class="nav bd-sidenav level3" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/basics/release-note/5-3-0" class="nav-link"><span class="title">5.3</span></a> <ul class="nav bd-sidenav level3" style="display:none"></ul></li></ul></li></ul></li><li class="nav-item"><div class="nav-link"><span class="title">Concepts</span></div> <ul class="nav bd-sidenav level1"><li class="nav-item"><a href="/handbook/en/concepts/chart-size" class="nav-link"><span class="title">Chart Container</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><!----><!----><li class="nav-item"><a href="/handbook/en/concepts/style" class="nav-link"><span class="title">Style</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/concepts/dataset" class="nav-link"><span class="title">Dataset</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/concepts/data-transform" class="nav-link"><span class="title">Data Transform</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><!----><li class="nav-item"><a href="/handbook/en/concepts/axis" class="nav-link"><span class="title">Axis</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/concepts/visual-map" aria-current="page" class="nav-link nuxt-link-exact-active nuxt-link-active"><span class="title">Visual Mapping</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/concepts/legend" class="nav-link"><span class="title">Legend</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/concepts/event" class="nav-link"><span class="title">Event and Action</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li></ul></li><li class="nav-item"><div class="nav-link"><span class="title">How To Guides</span></div> <ul class="nav bd-sidenav level1"><li class="nav-item"><a class="nav-link"><span class="title">Common Charts</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level2" style="display:none"><li class="nav-item"><a class="nav-link"><span class="title">Bar</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level3" style="display:none"><li class="nav-item"><a href="/handbook/en/how-to/chart-types/bar/basic-bar" class="nav-link"><span class="title">Basic Bar</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/how-to/chart-types/bar/stacked-bar" class="nav-link"><span class="title">Stacked Bar</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/how-to/chart-types/bar/bar-race" class="nav-link"><span class="title">Bar Racing</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li><!----><li class="nav-item"><a href="/handbook/en/how-to/chart-types/bar/waterfall" class="nav-link"><span class="title">Waterfall</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li></ul></li><li class="nav-item"><a class="nav-link"><span class="title">Line</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level3" style="display:none"><li class="nav-item"><a href="/handbook/en/how-to/chart-types/line/basic-line" class="nav-link"><span class="title">Basic Line</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/how-to/chart-types/line/stacked-line" class="nav-link"><span class="title">Stacked Line</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/how-to/chart-types/line/area-line" class="nav-link"><span class="title">Area Chart</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/how-to/chart-types/line/smooth-line" class="nav-link"><span class="title">Smoothed Line</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/how-to/chart-types/line/step-line" class="nav-link"><span class="title">Step Line</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li></ul></li><li class="nav-item"><a class="nav-link"><span class="title">Pie</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level3" style="display:none"><li class="nav-item"><a href="/handbook/en/how-to/chart-types/pie/basic-pie" class="nav-link"><span class="title">Basic Pie</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/how-to/chart-types/pie/doughnut" class="nav-link"><span class="title">Ring Style</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/how-to/chart-types/pie/rose" class="nav-link"><span class="title">Rose Style</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li></ul></li><li class="nav-item"><a class="nav-link"><span class="title">Scatter</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level3" style="display:none"><li class="nav-item"><a href="/handbook/en/how-to/chart-types/scatter/basic-scatter" class="nav-link"><span class="title">Basic Scatter</span></a> <ul class="nav bd-sidenav level4" style="display:none"></ul></li></ul></li></ul></li><!----><li class="nav-item"><a class="nav-link"><span class="title">Cross Platform</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level2" style="display:none"><li class="nav-item"><a href="/handbook/en/how-to/cross-platform/server" class="nav-link"><span class="title">Server Side Rendering</span></a> <ul class="nav bd-sidenav level3" style="display:none"></ul></li></ul></li><li class="nav-item"><a class="nav-link"><span class="title">Data</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level2" style="display:none"><li class="nav-item"><a href="/handbook/en/how-to/data/dynamic-data" class="nav-link"><span class="title">Dynamic Data</span></a> <ul class="nav bd-sidenav level3" style="display:none"></ul></li><!----></ul></li><li class="nav-item"><a class="nav-link"><span class="title">Label</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level2" style="display:none"><li class="nav-item"><a href="/handbook/en/how-to/label/rich-text" class="nav-link"><span class="title">Rich Text</span></a> <ul class="nav bd-sidenav level3" style="display:none"></ul></li></ul></li><li class="nav-item"><a class="nav-link"><span class="title">Animation</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level2" style="display:none"><li class="nav-item"><a href="/handbook/en/how-to/animation/transition" class="nav-link"><span class="title">Data Transition</span></a> <ul class="nav bd-sidenav level3" style="display:none"></ul></li></ul></li><li class="nav-item"><a class="nav-link"><span class="title">Interaction</span> <span class="glyphicon glyphicon-menu-down"></span></a> <ul class="nav bd-sidenav level2" style="display:none"><li class="nav-item"><a href="/handbook/en/how-to/interaction/drag" class="nav-link"><span class="title">Drag</span></a> <ul class="nav bd-sidenav level3" style="display:none"></ul></li><!----></ul></li></ul></li><li class="nav-item"><div class="nav-link"><span class="title">Best Practices</span></div> <ul class="nav bd-sidenav level1"><!----><li class="nav-item"><a href="/handbook/en/best-practices/canvas-vs-svg" class="nav-link"><span class="title">Canvas vs. SVG</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li><li class="nav-item"><a href="/handbook/en/best-practices/aria" class="nav-link"><span class="title">Aria</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li></ul></li><li class="nav-item"><div class="nav-link"><span class="title">Edit Handbook</span></div> <ul class="nav bd-sidenav level1"><li class="nav-item"><a href="/handbook/en/meta/edit-guide" class="nav-link"><span class="title">Edit Guide</span></a> <ul class="nav bd-sidenav level2" style="display:none"></ul></li></ul></li></ul></div> <div class="open-sidebar"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"></path></svg></div></div> <div class="bd-content col-sm-7 pl-sm-2 col-12"><div class="post-content content"><div><div class="post-inner"><!----> <div class="nuxt-content"><article><h1 id="visual-map-of-data" tabindex="-1">Visual Map of Data</h1> <p>Data visualization is a procedure of mapping data into visual elements. This procedure can also be called visual coding, and visual elements can also be called visual channels.</p> <p>Every type of charts in Apache ECharts<sup>TM</sup> has this built-in mapping procedure. For example, line chart map data into <em>lines</em>, bar chart map data into <em>height</em>. Some more complicated charts, like <code>graph</code>, <code>themeRiver</code>, and <code>treemap</code> have their own built-in mapping.</p> <p>Besides, ECharts provides <a href="https://echarts.apache.org/option.html#visualMap">visualMap component</a> for general visual mapping. Visual elements allowed in <code>visualMap</code> component are:</p> <ul><li><code>symbol</code>, <code>symbolSize</code></li> <li><code>color</code>, <code>opacity</code>, <code>colorAlpha</code>,</li> <li><code>colorLightness</code>, <code>colorSaturation</code>, <code>colorHue</code></li></ul> <p>Next, we are going to introduce how to use <code>visualMap</code> component.</p> <h2 id="data-and-dimension" tabindex="-1">Data and Dimension</h2> <p>Data are usually stored in <a href="https://echarts.apache.org/option.html#series.data">series.data</a> in ECharts. Depending on chart types, like list, tree, graph, and so on, the form of data may vary somehow. But they have one common feature, that they are a collection of data items. Every data item contains data value, and other information if needed. Every data value can be a single value (one dimension) or an array (multiple dimensions).</p> <p>For example, <a href="https://echarts.apache.org/option.html#series.data">series.data</a> is the most common form, which is a <code>list</code>, a common array:</p> <div class="md-code-block"><div class="nuxt-content-highlight"><pre class="language-js line-numbers"><code>series<span class="token operator">:</span> <span class="token punctuation">{</span> |
| data<span class="token operator">:</span> <span class="token punctuation">[</span> |
| <span class="token punctuation">{</span> |
| <span class="token comment">// every item here is a dataItem</span> |
| value<span class="token operator">:</span> <span class="token number">2323</span><span class="token punctuation">,</span> <span class="token comment">// this is data value</span> |
| itemStyle<span class="token operator">:</span> <span class="token punctuation">{</span><span class="token punctuation">}</span> |
| <span class="token punctuation">}</span><span class="token punctuation">,</span> |
| <span class="token number">1212</span><span class="token punctuation">,</span> <span class="token comment">// it can also be a value of dataItem, which is a more common case</span> |
| <span class="token number">2323</span><span class="token punctuation">,</span> <span class="token comment">// every data value here is one dimension</span> |
| <span class="token number">4343</span><span class="token punctuation">,</span> |
| <span class="token number">3434</span> |
| <span class="token punctuation">]</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span></code></pre></div> <!----> <div class="clipboard" data-v-479657ca><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6" data-v-479657ca><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6" data-v-479657ca><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 5H6a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2v-1M8 5a2 2 0 002 2h2a2 2 0 002-2M8 5a2 2 0 012-2h2a2 2 0 012 2m0 0h2a2 2 0 012 2v3m2 4H10m0 0l3-3m-3 3l3 3" data-v-479657ca></path></svg></svg></div></div> <div class="md-code-block"><div class="nuxt-content-highlight"><pre class="language-js line-numbers"><code>series<span class="token operator">:</span> <span class="token punctuation">{</span> |
| data<span class="token operator">:</span> <span class="token punctuation">[</span> |
| <span class="token punctuation">{</span> |
| <span class="token comment">// every item here is a dataItem</span> |
| value<span class="token operator">:</span> <span class="token punctuation">[</span><span class="token number">3434</span><span class="token punctuation">,</span> <span class="token number">129</span><span class="token punctuation">,</span> <span class="token string">'San Marino'</span><span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token comment">// this is data value</span> |
| itemStyle<span class="token operator">:</span> <span class="token punctuation">{</span><span class="token punctuation">}</span> |
| <span class="token punctuation">}</span><span class="token punctuation">,</span> |
| <span class="token punctuation">[</span><span class="token number">1212</span><span class="token punctuation">,</span> <span class="token number">5454</span><span class="token punctuation">,</span> <span class="token string">'Vatican'</span><span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token comment">// it can also be a value of dataItem, which is a more common case</span> |
| <span class="token punctuation">[</span><span class="token number">2323</span><span class="token punctuation">,</span> <span class="token number">3223</span><span class="token punctuation">,</span> <span class="token string">'Nauru'</span><span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token comment">// every data value here is three dimension</span> |
| <span class="token punctuation">[</span><span class="token number">4343</span><span class="token punctuation">,</span> <span class="token number">23</span><span class="token punctuation">,</span> <span class="token string">'Tuvalu'</span><span class="token punctuation">]</span> <span class="token comment">// If is scatter chart, usually map the first dimension to x axis,</span> |
| <span class="token comment">// the second dimension to y axis,</span> |
| <span class="token comment">// and the third dimension to symbolSize</span> |
| <span class="token punctuation">]</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span></code></pre></div> <!----> <div class="clipboard" data-v-479657ca><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6" data-v-479657ca><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6" data-v-479657ca><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 5H6a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2v-1M8 5a2 2 0 002 2h2a2 2 0 002-2M8 5a2 2 0 012-2h2a2 2 0 012 2m0 0h2a2 2 0 012 2v3m2 4H10m0 0l3-3m-3 3l3 3" data-v-479657ca></path></svg></svg></div></div> <p>Usually the first one or two dimensions are used for mapping. For example, map the first dimension to x axis, and the second dimension to y axis. If you want to represent more dimensions, <code>visualMap</code> is what you need. Most likely, <a href="https://echarts.apache.org/option.html#series-scatter">scatter charts</a> use radius to represent the third dimension.</p> <h2 id="the-visualmap-component" tabindex="-1">The visualMap Component</h2> <p>visualMap component defines the mapping from <em>which dimension of data</em> to <em>what visual elements</em>.</p> <p>The following two types of visualMap components are supported, identified with <a href="https://echarts.apache.org/option.html#visualMap.type">visualMap.type</a>.</p> <p>Its structure is defined as:</p> <div class="md-code-block"><div class="nuxt-content-highlight"><pre class="language-js line-numbers"><code>option <span class="token operator">=</span> <span class="token punctuation">{</span> |
| visualMap<span class="token operator">:</span> <span class="token punctuation">[</span> |
| <span class="token comment">// can define multiple visualMap components at the same time</span> |
| <span class="token punctuation">{</span> |
| <span class="token comment">// the first visualMap component</span> |
| type<span class="token operator">:</span> <span class="token string">'continuous'</span> <span class="token comment">// defined as continuous visualMap</span> |
| <span class="token comment">// ...</span> |
| <span class="token punctuation">}</span><span class="token punctuation">,</span> |
| <span class="token punctuation">{</span> |
| <span class="token comment">// the second visualMap component</span> |
| type<span class="token operator">:</span> <span class="token string">'piecewise'</span> <span class="token comment">// defined as discrete visualMap</span> |
| <span class="token comment">// ...</span> |
| <span class="token punctuation">}</span> |
| <span class="token punctuation">]</span> |
| <span class="token comment">// ...</span> |
| <span class="token punctuation">}</span><span class="token punctuation">;</span></code></pre></div> <!----> <div class="clipboard" data-v-479657ca><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6" data-v-479657ca><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6" data-v-479657ca><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 5H6a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2v-1M8 5a2 2 0 002 2h2a2 2 0 002-2M8 5a2 2 0 012-2h2a2 2 0 012 2m0 0h2a2 2 0 012 2v3m2 4H10m0 0l3-3m-3 3l3 3" data-v-479657ca></path></svg></svg></div></div> <h2 id="continuous-and-piecewise-visual-mapping-components" tabindex="-1">Continuous and Piecewise Visual Mapping Components</h2> <p>The visual mapping component of ECharts is divided into continuous (<a href="https://echarts.apache.org/option.html#visualMap-continuous">visualMapContinuous</a>) and piecewise (<a href="https://echarts.apache.org/option.html#visualMap-piecewise">visualMapPiecewise</a>).</p> <p>Continuous means that the data dimension for visual mapping is a continuous value, while piecewise means that the data is divided into multiple segments or discrete data.</p> <h3 id="continuous-visual-mapping" tabindex="-1">Continuous Visual Mapping</h3> <p>Continuous type visual mapping can determine the range of visual mapping by specifying the maximum and minimum values.</p> <div class="md-code-block"><div class="nuxt-content-highlight"><pre class="language-js line-numbers"><code>option <span class="token operator">=</span> <span class="token punctuation">{</span> |
| visualMap<span class="token operator">:</span> <span class="token punctuation">[</span> |
| <span class="token punctuation">{</span> |
| type<span class="token operator">:</span> <span class="token string">'continuous'</span><span class="token punctuation">,</span> |
| min<span class="token operator">:</span> <span class="token number">0</span><span class="token punctuation">,</span> |
| max<span class="token operator">:</span> <span class="token number">5000</span><span class="token punctuation">,</span> |
| dimension<span class="token operator">:</span> <span class="token number">3</span><span class="token punctuation">,</span> <span class="token comment">// the fourth dimension of series.data (i.e. value[3]) is mapped</span> |
| seriesIndex<span class="token operator">:</span> <span class="token number">4</span><span class="token punctuation">,</span> <span class="token comment">// The fourth series is mapped.</span> |
| inRange<span class="token operator">:</span> <span class="token punctuation">{</span> |
| <span class="token comment">// The visual configuration in the selected range</span> |
| color<span class="token operator">:</span> <span class="token punctuation">[</span><span class="token string">'blue'</span><span class="token punctuation">,</span> <span class="token string">'#121122'</span><span class="token punctuation">,</span> <span class="token string">'red'</span><span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token comment">// A list of colors that defines the graph color mapping</span> |
| <span class="token comment">// the minimum value of the data is mapped to 'blue', and</span> |
| <span class="token comment">// the maximum value is mapped to 'red', // the maximum value is mapped to 'red', // the maximum value is mapped to 'red'.</span> |
| <span class="token comment">// The rest is automatically calculated linearly.</span> |
| symbolSize<span class="token operator">:</span> <span class="token punctuation">[</span><span class="token number">30</span><span class="token punctuation">,</span> <span class="token number">100</span><span class="token punctuation">]</span> <span class="token comment">// Defines the mapping range for the graphic size.</span> |
| <span class="token comment">// The minimum value of the data is mapped to 30, // and the maximum value is mapped to 100.</span> |
| <span class="token comment">// The maximum value is mapped to 100.</span> |
| <span class="token comment">// The rest is calculated linearly automatically.</span> |
| <span class="token punctuation">}</span><span class="token punctuation">,</span> |
| outOfRange<span class="token operator">:</span> <span class="token punctuation">{</span> |
| <span class="token comment">// Check the out of range visual configuration</span> |
| symbolSize<span class="token operator">:</span> <span class="token punctuation">[</span><span class="token number">30</span><span class="token punctuation">,</span> <span class="token number">100</span><span class="token punctuation">]</span> |
| <span class="token punctuation">}</span> |
| <span class="token punctuation">}</span> |
| <span class="token comment">// ...</span> |
| <span class="token punctuation">]</span> |
| <span class="token punctuation">}</span><span class="token punctuation">;</span></code></pre></div> <!----> <div class="clipboard" data-v-479657ca><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6" data-v-479657ca><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-6 w-6" data-v-479657ca><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 5H6a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2v-1M8 5a2 2 0 002 2h2a2 2 0 002-2M8 5a2 2 0 012-2h2a2 2 0 012 2m0 0h2a2 2 0 012 2v3m2 4H10m0 0l3-3m-3 3l3 3" data-v-479657ca></path></svg></svg></div></div> <p>where <a href="https://echarts.apache.org/option.html#visualMap.inRange">visualMap.inRange</a> indicates the style used for data within the data mapping range; while <a href="https://echarts.apache.org/option.html#visualMap.outOfRange">visualMap.outOfRange</a> specifies the style for data outside the mapping range.</p> <p><a href="~visualMap.dimension">visualMap.dimension</a> specifies which dimension of the data will be visually mapped.</p> <h3 id="piecewise-visual-mapping" tabindex="-1">Piecewise Visual Mapping</h3> <p>The piecewise visual mapping component has three modes.</p> <ul><li>Continuous data average segmentation: based on <a href="https://echarts.apache.org/option.html#visualMap-piecewise.splitNumber">visualMap-piecewise.splitNumber</a> to automatically split the data into pieces equally.</li> <li>Continuous data custom segmentation: define the range of each piece based on <a href="https://echarts.apache.org/option.html#visualMap-piecewise.pieces">visualMap-piecewise.pieces</a>.</li> <li>Discrete data (categorical data): categories are defined in <a href="https://echarts.apache.org/option.html#visualMap-piecewise.categories">visualMap-piecewise.categories</a>.</li></ul> <p>To use segmented visual map, you need to set <code>type</code> to <code>'piecewise'</code> and choose one of the above three configuration items.</p></article></div></div> <div class="post-contributors"><h3><span class="inline-block align-middle">Contributors</span> <a target="_blank" href="https://github.com/apache/echarts-handbook/tree/master/contents/en/concepts/visual-map.md" title="Edit this Document" class="inline-block align-middle text-sm"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="h-8 w-8 inline-block align-middle"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z"></path></svg> <span class="inline-block align-middle">Edit this page on GitHub</span></a></h3> <div class="post-contributors-list"><a href="https://github.com/KrzysztofMadejski" target="_blank" class="post-contributor"><img alt="KrzysztofMadejski" src="https://avatars.githubusercontent.com/KrzysztofMadejski?size=60"> <span>KrzysztofMadejski</span></a><a href="https://github.com/pissang" target="_blank" class="post-contributor"><img alt="pissang" src="https://avatars.githubusercontent.com/pissang?size=60"> <span>pissang</span></a></div></div></div></div></div></div> <link rel="stylesheet" href="//fastly.jsdelivr.net/npm/highlight.js@9.12.0/styles/github-gist.min.css"></div></div></div></div><script>window.__NUXT__=function(e,i,t,a,d,l,r,o,n,s,g,c,h,p,m,I,C,u,b,v,A,B,y,G,W,w,f,Z,M,S,Y,V,X,R,F,H,L,x,k,z,N,E,U,T,D,Q,j,J,K,P,O,_,$,q,ee,ie,te,ae,de){return{layout:"default",data:[{html:'<h1 id="visual-map-of-data" tabindex="-1">Visual Map of Data</h1>\n<p>Data visualization is a procedure of mapping data into visual elements. This procedure can also be called visual coding, and visual elements can also be called visual channels.</p>\n<p>Every type of charts in Apache ECharts<sup>TM</sup> has this built-in mapping procedure. For example, line chart map data into <em>lines</em>, bar chart map data into <em>height</em>. Some more complicated charts, like <code>graph</code>, <code>themeRiver</code>, and <code>treemap</code> have their own built-in mapping.</p>\n<p>Besides, ECharts provides <a href="https://echarts.apache.org/option.html#visualMap">visualMap component</a> for general visual mapping. Visual elements allowed in <code>visualMap</code> component are:</p>\n<ul>\n<li><code>symbol</code>, <code>symbolSize</code></li>\n<li><code>color</code>, <code>opacity</code>, <code>colorAlpha</code>,</li>\n<li><code>colorLightness</code>, <code>colorSaturation</code>, <code>colorHue</code></li>\n</ul>\n<p>Next, we are going to introduce how to use <code>visualMap</code> component.</p>\n<h2 id="data-and-dimension" tabindex="-1">Data and Dimension</h2>\n<p>Data are usually stored in <a href="https://echarts.apache.org/option.html#series.data">series.data</a> in ECharts. Depending on chart types, like list, tree, graph, and so on, the form of data may vary somehow. But they have one common feature, that they are a collection of data items. Every data item contains data value, and other information if needed. Every data value can be a single value (one dimension) or an array (multiple dimensions).</p>\n<p>For example, <a href="https://echarts.apache.org/option.html#series.data">series.data</a> is the most common form, which is a <code>list</code>, a common array:</p>\n<md-code-block lang="js" code="\'c2VyaWVzOiB7CiAgZGF0YTogWwogICAgewogICAgICAvLyBldmVyeSBpdGVtIGhlcmUgaXMgYSBkYXRhSXRlbQogICAgICB2YWx1ZTogMjMyMywgLy8gdGhpcyBpcyBkYXRhIHZhbHVlCiAgICAgIGl0ZW1TdHlsZToge30KICAgIH0sCiAgICAxMjEyLCAvLyBpdCBjYW4gYWxzbyBiZSBhIHZhbHVlIG9mIGRhdGFJdGVtLCB3aGljaCBpcyBhIG1vcmUgY29tbW9uIGNhc2UKICAgIDIzMjMsIC8vIGV2ZXJ5IGRhdGEgdmFsdWUgaGVyZSBpcyBvbmUgZGltZW5zaW9uCiAgICA0MzQzLAogICAgMzQzNAogIF07Cn0\'" line-highlights="\'\'" />\n<md-code-block lang="js" code="\'c2VyaWVzOiB7CiAgZGF0YTogWwogICAgewogICAgICAvLyBldmVyeSBpdGVtIGhlcmUgaXMgYSBkYXRhSXRlbQogICAgICB2YWx1ZTogWzM0MzQsIDEyOSwgJ1NhbiBNYXJpbm8nXSwgLy8gdGhpcyBpcyBkYXRhIHZhbHVlCiAgICAgIGl0ZW1TdHlsZToge30KICAgIH0sCiAgICBbMTIxMiwgNTQ1NCwgJ1ZhdGljYW4nXSwgLy8gaXQgY2FuIGFsc28gYmUgYSB2YWx1ZSBvZiBkYXRhSXRlbSwgd2hpY2ggaXMgYSBtb3JlIGNvbW1vbiBjYXNlCiAgICBbMjMyMywgMzIyMywgJ05hdXJ1J10sIC8vIGV2ZXJ5IGRhdGEgdmFsdWUgaGVyZSBpcyB0aHJlZSBkaW1lbnNpb24KICAgIFs0MzQzLCAyMywgJ1R1dmFsdSddIC8vIElmIGlzIHNjYXR0ZXIgY2hhcnQsIHVzdWFsbHkgbWFwIHRoZSBmaXJzdCBkaW1lbnNpb24gdG8geCBheGlzLAogICAgLy8gdGhlIHNlY29uZCBkaW1lbnNpb24gdG8geSBheGlzLAogICAgLy8gYW5kIHRoZSB0aGlyZCBkaW1lbnNpb24gdG8gc3ltYm9sU2l6ZQogIF07Cn0\'" line-highlights="\'\'" />\n<p>Usually the first one or two dimensions are used for mapping. For example, map the first dimension to x axis, and the second dimension to y axis. If you want to represent more dimensions, <code>visualMap</code> is what you need. Most likely, <a href="https://echarts.apache.org/option.html#series-scatter">scatter charts</a> use radius to represent the third dimension.</p>\n<h2 id="the-visualmap-component" tabindex="-1">The visualMap Component</h2>\n<p>visualMap component defines the mapping from <em>which dimension of data</em> to <em>what visual elements</em>.</p>\n<p>The following two types of visualMap components are supported, identified with <a href="https://echarts.apache.org/option.html#visualMap.type">visualMap.type</a>.</p>\n<p>Its structure is defined as:</p>\n<md-code-block lang="js" code="\'b3B0aW9uID0gewogIHZpc3VhbE1hcDogWwogICAgLy8gY2FuIGRlZmluZSBtdWx0aXBsZSB2aXN1YWxNYXAgY29tcG9uZW50cyBhdCB0aGUgc2FtZSB0aW1lCiAgICB7CiAgICAgIC8vIHRoZSBmaXJzdCB2aXN1YWxNYXAgY29tcG9uZW50CiAgICAgIHR5cGU6ICdjb250aW51b3VzJyAvLyBkZWZpbmVkIGFzIGNvbnRpbnVvdXMgdmlzdWFsTWFwCiAgICAgIC8vIC4uLgogICAgfSwKICAgIHsKICAgICAgLy8gdGhlIHNlY29uZCB2aXN1YWxNYXAgY29tcG9uZW50CiAgICAgIHR5cGU6ICdwaWVjZXdpc2UnIC8vIGRlZmluZWQgYXMgZGlzY3JldGUgdmlzdWFsTWFwCiAgICAgIC8vIC4uLgogICAgfQogIF0KICAvLyAuLi4KfTs\'" line-highlights="\'\'" />\n<h2 id="continuous-and-piecewise-visual-mapping-components" tabindex="-1">Continuous and Piecewise Visual Mapping Components</h2>\n<p>The visual mapping component of ECharts is divided into continuous (<a href="https://echarts.apache.org/option.html#visualMap-continuous">visualMapContinuous</a>) and piecewise (<a href="https://echarts.apache.org/option.html#visualMap-piecewise">visualMapPiecewise</a>).</p>\n<p>Continuous means that the data dimension for visual mapping is a continuous value, while piecewise means that the data is divided into multiple segments or discrete data.</p>\n<h3 id="continuous-visual-mapping" tabindex="-1">Continuous Visual Mapping</h3>\n<p>Continuous type visual mapping can determine the range of visual mapping by specifying the maximum and minimum values.</p>\n<md-code-block lang="js" code="\'b3B0aW9uID0gewogIHZpc3VhbE1hcDogWwogICAgewogICAgICB0eXBlOiAnY29udGludW91cycsCiAgICAgIG1pbjogMCwKICAgICAgbWF4OiA1MDAwLAogICAgICBkaW1lbnNpb246IDMsIC8vIHRoZSBmb3VydGggZGltZW5zaW9uIG9mIHNlcmllcy5kYXRhIChpLmUuIHZhbHVlWzNdKSBpcyBtYXBwZWQKICAgICAgc2VyaWVzSW5kZXg6IDQsIC8vIFRoZSBmb3VydGggc2VyaWVzIGlzIG1hcHBlZC4KICAgICAgaW5SYW5nZTogewogICAgICAgIC8vIFRoZSB2aXN1YWwgY29uZmlndXJhdGlvbiBpbiB0aGUgc2VsZWN0ZWQgcmFuZ2UKICAgICAgICBjb2xvcjogWydibHVlJywgJyMxMjExMjInLCAncmVkJ10sIC8vIEEgbGlzdCBvZiBjb2xvcnMgdGhhdCBkZWZpbmVzIHRoZSBncmFwaCBjb2xvciBtYXBwaW5nCiAgICAgICAgLy8gdGhlIG1pbmltdW0gdmFsdWUgb2YgdGhlIGRhdGEgaXMgbWFwcGVkIHRvICdibHVlJywgYW5kCiAgICAgICAgLy8gdGhlIG1heGltdW0gdmFsdWUgaXMgbWFwcGVkIHRvICdyZWQnLCAvLyB0aGUgbWF4aW11bSB2YWx1ZSBpcyBtYXBwZWQgdG8gJ3JlZCcsIC8vIHRoZSBtYXhpbXVtIHZhbHVlIGlzIG1hcHBlZCB0byAncmVkJy4KICAgICAgICAvLyBUaGUgcmVzdCBpcyBhdXRvbWF0aWNhbGx5IGNhbGN1bGF0ZWQgbGluZWFybHkuCiAgICAgICAgc3ltYm9sU2l6ZTogWzMwLCAxMDBdIC8vIERlZmluZXMgdGhlIG1hcHBpbmcgcmFuZ2UgZm9yIHRoZSBncmFwaGljIHNpemUuCiAgICAgICAgLy8gVGhlIG1pbmltdW0gdmFsdWUgb2YgdGhlIGRhdGEgaXMgbWFwcGVkIHRvIDMwLCAvLyBhbmQgdGhlIG1heGltdW0gdmFsdWUgaXMgbWFwcGVkIHRvIDEwMC4KICAgICAgICAvLyBUaGUgbWF4aW11bSB2YWx1ZSBpcyBtYXBwZWQgdG8gMTAwLgogICAgICAgIC8vIFRoZSByZXN0IGlzIGNhbGN1bGF0ZWQgbGluZWFybHkgYXV0b21hdGljYWxseS4KICAgICAgfSwKICAgICAgb3V0T2ZSYW5nZTogewogICAgICAgIC8vIENoZWNrIHRoZSBvdXQgb2YgcmFuZ2UgdmlzdWFsIGNvbmZpZ3VyYXRpb24KICAgICAgICBzeW1ib2xTaXplOiBbMzAsIDEwMF0KICAgICAgfQogICAgfQogICAgLy8gLi4uCiAgXQp9Ow\'" line-highlights="\'\'" />\n<p>where <a href="https://echarts.apache.org/option.html#visualMap.inRange">visualMap.inRange</a> indicates the style used for data within the data mapping range; while <a href="https://echarts.apache.org/option.html#visualMap.outOfRange">visualMap.outOfRange</a> specifies the style for data outside the mapping range.</p>\n<p><a href="~visualMap.dimension">visualMap.dimension</a> specifies which dimension of the data will be visually mapped.</p>\n<h3 id="piecewise-visual-mapping" tabindex="-1">Piecewise Visual Mapping</h3>\n<p>The piecewise visual mapping component has three modes.</p>\n<ul>\n<li>Continuous data average segmentation: based on <a href="https://echarts.apache.org/option.html#visualMap-piecewise.splitNumber">visualMap-piecewise.splitNumber</a> to automatically split the data into pieces equally.</li>\n<li>Continuous data custom segmentation: define the range of each piece based on <a href="https://echarts.apache.org/option.html#visualMap-piecewise.pieces">visualMap-piecewise.pieces</a>.</li>\n<li>Discrete data (categorical data): categories are defined in <a href="https://echarts.apache.org/option.html#visualMap-piecewise.categories">visualMap-piecewise.categories</a>.</li>\n</ul>\n<p>To use segmented visual map, you need to set <code>type</code> to <code>\'piecewise\'</code> and choose one of the above three configuration items.</p>\n',postPath:"en/concepts/visual-map"}],fetch:{},error:a,state:{filled:!1,docVersion:"",ghVersion:"",visibleAffix:!1,homepage:{},adBlocked:!1,focusMode:!1,posts:{zh:[{title:"快速上手",dir:d},{title:"入门篇",dir:l,children:[{title:"获取 ECharts",dir:r},{title:"在项目中引入 ECharts",dir:o},{title:"资源列表",dir:n,draft:e},{title:"寻求帮助",dir:s},{title:"版本特性",dir:g,children:[{title:"ECharts 5 特性介绍",dir:c},{title:"v4 升级 v5 指南",dir:h},{title:5.2,dir:p},{title:5.3,dir:m}]}]},{title:"概念篇",dir:I,children:[{title:"图表容器及大小",dir:C},{title:"配置项",dir:u,draft:e},{title:"系列",dir:b,draft:e},{title:"样式",dir:v},{title:"数据集",dir:A},{title:"数据转换",dir:B},{title:"坐标系",dir:y,draft:e},{title:"坐标轴",dir:G},{title:"视觉映射",dir:t},{title:"图例",dir:W},{title:"事件与行为",dir:w}]},{title:"应用篇",dir:f,children:[{title:"常用图表类型",dir:Z,children:[{title:"柱状图",dir:"bar",children:[{title:"基础柱状图",dir:M},{title:"堆叠柱状图",dir:S},{title:"动态排序柱状图",dir:Y},{title:"极坐标系柱状图",dir:V,draft:e},{title:"阶梯瀑布图",dir:X},{title:"视觉映射的柱状图",dir:t,draft:e}]},{title:"折线图",dir:R,children:[{title:"基础折线图",dir:F},{title:"堆叠折线图",dir:H},{title:"区域面积图",dir:L},{title:"平滑曲线图",dir:x},{title:"阶梯线图",dir:k}]},{title:"饼图",dir:"pie",children:[{title:"基础饼图",dir:z},{title:"圆环图",dir:N},{title:"南丁格尔图（玫瑰图）",dir:E}]},{title:"散点图",dir:U,children:[{title:"基础散点图",dir:T}]}]},{title:D,dir:i,draft:e},{title:"跨平台方案",dir:Q,children:[{title:"服务端渲染",dir:j},{title:"微信小程序",dir:"wechat-app"},{title:"百度智能小程序",dir:"baidu-app"}]},{title:"数据处理",dir:J,children:[{title:"动态的异步数据",dir:K},{title:"数据下钻",dir:P,draft:e}]},{title:"标签",dir:"label",children:[{title:"富文本标签",dir:O}]},{title:"动画",dir:_,children:[{title:"数据过渡动画",dir:$}]},{title:"交互",dir:q,children:[{title:"拖拽的实现",dir:"drag"},{title:"多图联动",dir:ee,draft:e}]}]},{title:"最佳实践",dir:ie,children:[{title:D,dir:i,draft:e},{title:te,dir:ae},{title:"无障碍访问",dir:"aria"}]},{title:"编辑本文档",dir:"meta",children:[{title:"文档编辑指南",dir:de}]}],en:[{title:"Get Started",dir:d},{title:"Basics",dir:l,children:[{title:"Download ECharts",dir:r},{title:"Import ECharts",dir:o},{title:"Resources",dir:n,draft:e},{title:"Get Help",dir:s},{title:"What's New",dir:g,children:[{title:"ECharts 5 Features",dir:c},{title:"Migration from v4 to v5",dir:h},{title:5.2,dir:p},{title:5.3,dir:m}]}]},{title:"Concepts",dir:I,children:[{title:"Chart Container",dir:C},{title:"Chart Option",dir:u,draft:e},{title:"Series",dir:b,draft:e},{title:"Style",dir:v},{title:"Dataset",dir:A},{title:"Data Transform",dir:B},{title:"Coordinate",dir:y,draft:e},{title:"Axis",dir:G},{title:"Visual Mapping",dir:t},{title:"Legend",dir:W},{title:"Event and Action",dir:w}]},{title:"How To Guides",dir:f,children:[{title:"Common Charts",dir:Z,children:[{title:"Bar",dir:"bar",children:[{title:"Basic Bar",dir:M},{title:"Stacked Bar",dir:S},{title:"Bar Racing",dir:Y},{title:"Bar Polar",dir:V,draft:e},{title:"Waterfall",dir:X}]},{title:"Line",dir:R,children:[{title:"Basic Line",dir:F},{title:"Stacked Line",dir:H},{title:"Area Chart",dir:L},{title:"Smoothed Line",dir:x},{title:"Step Line",dir:k}]},{title:"Pie",dir:"pie",children:[{title:"Basic Pie",dir:z},{title:"Ring Style",dir:N},{title:"Rose Style",dir:E}]},{title:"Scatter",dir:U,children:[{title:"Basic Scatter",dir:T}]}]},{title:"Mobile",dir:i,draft:e},{title:"Cross Platform",dir:Q,children:[{title:"Server Side Rendering",dir:j}]},{title:"Data",dir:J,children:[{title:"Dynamic Data",dir:K},{title:"Drilldown",dir:P,draft:e}]},{title:"Label",dir:"label",children:[{title:"Rich Text",dir:O}]},{title:"Animation",dir:_,children:[{title:"Data Transition",dir:$}]},{title:"Interaction",dir:q,children:[{title:"Drag",dir:"drag"},{title:"Connect",dir:ee,draft:e}]}]},{title:"Best Practices",dir:ie,children:[{title:"Mobile Optimization",dir:i,draft:e},{title:te,dir:ae},{title:"Aria",dir:"aria"}]},{title:"Edit Handbook",dir:"meta",children:[{title:"Edit Guide",dir:de}]}]},config:{routerBase:"/handbook",rootPath:"https://echarts.apache.org/handbook/",exampleViewPath:"https://echarts.apache.org/examples/${lang}/view.html?c=",exampleEditorPath:"https://echarts.apache.org/examples/${lang}/editor.html?c=",mainSitePath:"https://echarts.apache.org/",optionPath:"https://echarts.apache.org/option.html#",gitRepo:"apache/echarts-handbook"},i18n:{routeParams:{}}},serverRendered:e,routePath:"/en/concepts/visual-map",config:{_app:{basePath:"/handbook/",assetsPath:"/handbook/_nuxt/",cdnURL:a}}}}(!0,"mobile","visual-map",null,"get-started","basics","download","import","resource","help","release-note","v5-feature","v5-upgrade-guide","5-2-0","5-3-0","concepts","chart-size","options","series","style","dataset","data-transform","coordinate","axis","legend","event","how-to","chart-types","basic-bar","stacked-bar","bar-race","polar-bar","waterfall","line","basic-line","stacked-line","area-line","smooth-line","step-line","basic-pie","doughnut","rose","scatter","basic-scatter","移动端优化","cross-platform","server","data","dynamic-data","drilldown","rich-text","animation","transition","interaction","connect","best-practices","Canvas vs. SVG","canvas-vs-svg","edit-guide")</script><script src="/handbook/_nuxt/5870c6f.js" defer></script><script src="/handbook/_nuxt/js/d63042719a059a581645.js" defer></script><script src="/handbook/_nuxt/js/4f3ab71f990e271ccbe4.js" defer></script><script src="/handbook/_nuxt/js/f74f8c0f406ea2522d04.js" defer></script><script src="/handbook/_nuxt/js/e96421e0f27cc5a35348.js" defer></script><script src="/handbook/_nuxt/js/d6226697ecb43e03cd0d.js" defer></script> |
| <script type="text/javascript">document.getElementById("nav-doc").className="active"</script> |
| <script src="https://fastly.jsdelivr.net/npm/jquery@2.2.4/dist/jquery.min.js"></script> |
| <script src="https://fastly.jsdelivr.net/npm/bootstrap@3.3.7/dist/js/bootstrap.min.js"></script> |
| <script type="text/javascript" src="https://fastly.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script> |
| <script async src="https://www.googletagmanager.com/gtag/js?id=UA-141228404-1"></script> |
| <script>var _hmt=_hmt||[];function gtag(){dataLayer.push(arguments)}!function(){var e=document.createElement("script");e.src="https://hm.baidu.com/hm.js?54b918eee37cb8a7045f0fd0f0b24395";var t=document.getElementsByTagName("script")[0];t.parentNode.insertBefore(e,t)}(),window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","UA-141228404-1")</script> |
| </body> |
| </html> |
