blob: 533d82b8c548f7f38b9bd3a094b1e692206cdfbd [file] [log] [blame]
<!DOCTYPE html><html lang="zh-CN"><head><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1" user-scalable="no"><meta name="description" content="ECharts, a powerful, interactive charting and visualization library for browser"><link rel="shortcut icon" href="https://echarts.cdn.apache.org/zh/images/favicon.png"><link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/bootstrap@3.3.7/dist/css/bootstrap.min.css"><!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries--><!--[if lt IE 9]><script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script><script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script><![endif]--><link rel="stylesheet" type="text/css" href="https://echarts.cdn.apache.org/zh/css/main.css?_v_=1590053981732"><script>window.EC_WWW_LANG = 'zh';
</script><script type="text/javascript" src="https://echarts.cdn.apache.org/zh/vendors/pace/pace.min.js"></script><script id="font-hack" type="text/javascript">if (/windows/i.test(navigator.userAgent)) {
var el = document.createElement('style');
el.innerHTML = ''
+ '@font-face {font-family:"noto-thin";src:local("Microsoft Yahei");}'
+ '@font-face {font-family:"noto-light";src:local("Microsoft Yahei");}';
document.head.insertBefore(el, document.getElementById('font-hack'));
}
</script><title>FAQ - Apache ECharts (incubating)</title><script type="text/javascript" src="https://cdn.jsdelivr.net/npm/jquery@2.2.4/dist/jquery.min.js"></script></head><!--[if lte IE 8]><body class="lower-ie"><div id="lowie-main"><img src="https://echarts.cdn.apache.org/zh/images/forie.png" alt="ie tip"></div></body><![endif]-->
<!--[if (gt IE 8)|!(IE)]><body class="ECharts FAQ"></body><![endif]--><div id="apache-banner"><div class="txt"><p>Apache ECharts 是一个正在由 Apache 孵化器赞助的 Apache 开源基金会孵化的项目。</p><p>我们正在处理将本站跳转到 <a href="https://echarts.apache.org" target="_blank">https://echarts.apache.org</a> 的迁移工作。您可以现在就前往我们的 Apache 官网。</p></div><a href="https://echarts.apache.org" target="_blank" onclick="logApache()" class="btn"><div>访问官网</div></a><a href="javascript:;" onclick="closeApacheBanner(true)" class="close-btn">x</a></div><div id="main"><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/zh/index.html" class="navbar-brand"><img src="https://echarts.cdn.apache.org/zh/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/zh/index.html">首页</a></li><li id="nav-doc" class="dropdown"><a href="#" data-toggle="dropdown" class="dropdown-toggle">文档<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://echarts.apache.org/zh/feature.html">特性</a></li><li><a href="https://echarts.apache.org/zh/tutorial.html">教程</a></li><li><a href="https://echarts.apache.org/zh/api.html">API</a></li><li><a href="https://echarts.apache.org/zh/cheat-sheet.html">术语速查手册<span class="new">NEW</span></a></li><li><a href="https://echarts.apache.org/zh/option.html">配置项手册</a></li><li><a href="https://echarts.apache.org/zh/option-gl.html">GL 配置项手册</a></li><li><a href="https://echarts.apache.org/zh/changelog.html">版本记录</a></li></ul></li><li id="nav-download" class="dropdown"><a href="#" data-toggle="dropdown" class="dropdown-toggle">下载<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://echarts.apache.org/zh/download.html">下载</a></li><li><a href="https://echarts.apache.org/zh/download-theme.html">主题下载</a></li><li><a href="https://echarts.apache.org/zh/download-extension.html">扩展下载</a></li></ul></li><li id="nav-examples"><a href="#" data-toggle="dropdown" class="dropdown-toggle">实例<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://echarts.apache.org/examples/zh/index.html">官方实例</a></li><li><a href="https://echarts.apache.org/examples/zh/index.html#chart-type-globe">GL 实例</a></li></ul></li><li id="nav-community"><a href="#" data-toggle="dropdown" class="dropdown-toggle">社区<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://gallery.echartsjs.com">Gallery</a></li><li><a href="https://efe.baidu.com/tags/ECharts/">博客</a></li></ul></li><li id="nav-tool"><a href="#" data-toggle="dropdown" class="dropdown-toggle">工具<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://echarts.apache.org/zh/spreadsheet.html">表格工具</a></li><li><a href="https://www.echartsjs.com/theme-builder/">主题构建工具</a></li></ul></li><li id="nav-contribute"><a href="#" data-toggle="dropdown" class="dropdown-toggle">贡献<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://github.com/apache/incubator-echarts" target="_blank">源码(GitHub)</a></li><li><a href="https://github.com/apache/incubator-echarts/issues" target="_blank">Issues</a></li><li><a href="https://echarts.apache.org/zh/coding-standard.html">代码规范</a></li></ul></li><li id="nav-about"><a href="#" data-toggle="dropdown" class="dropdown-toggle">关于<b class="caret"></b></a><ul class="dropdown-menu"><li><a href="https://echarts.apache.org/zh/committers.html">贡献者列表</a></li><li><a href="https://www.apache.org/licenses/">版权声明</a></li><li><a href="https://echarts.apache.org/zh/maillist.html">邮件列表</a></li><li><a href="https://echarts.apache.org/zh/dependencies.html">依赖项</a></li><li><a href="https://echarts.apache.org/zh/faq.html">常见问题</a></li></ul></li></ul><ul class="nav navbar-nav navbar-right"><li id="nav-github"><a href="https://github.com/ecomfe/echarts" target="_blank"><img src="https://echarts.cdn.apache.org/zh/images/github.png" width="18"></a></li><li id="nav-homeen"><a href="javascript:;" onclick="changeLang('en')">EN</a></li></ul></div></div></nav><div class="page-info"><div class="container"><h1>FAQ</h1><p>常见问题的解答</p></div></div><div id="faq-page" class="page-content single-page"><div class="page-nav"><h4>常见问题</h4><ul></ul></div><div class="page-detail"><h2 id="ask-questions">通用问题</h2><h3>有技术问题怎么办?</h3><p>1)建议您在提问前,大致阅读一下<a href="https://echarts.apache.org/en/option.html">配置项手册</a>左侧导航,了解 ECharts 有哪些配置项,并且在相关的组件下查找是否有实现您需要功能的配置项;</p><p>2)查看本页常见问题的解答;</p><p>3)建议在 <a href="https://gallery.echartsjs.com/editor.html">ECharts Gallery</a> 上添加图表,复现你的问题,如果无法使用代码描述需求,可以尝试提供设计稿或画个草图;</p><p>4)推荐在 <a href="https://stackoverflow.com">stackoverflow.com</a><a href="https://www.oschina.net/question/tag/echarts">开源中国</a><a href="https://segmentfault.com/t/echarts">segmentfault.com</a> 等问答平台上提问,附上图表链接。</p><h3>ECharts 可以免费商用吗?</h3><p>可以,ECharts 基于 <a href="./license.html">Apache License 2.0</a> 开源。</p><h2 id="axis">坐标轴</h2><h3>坐标轴标签显示空间不够怎么办?</h3><p>可以用 <a href="https://echarts.apache.org/en/option.html#xAxis.interval">interval</a> 控制每隔多少显示标签,设为 <code>0</code> 则显示所有标签。</p><p>或者,可以设置 <a href="https://echarts.apache.org/en/option.html#yAxis.axisLabel.rotate">axisLabel.rotate</a>,将标签旋转一定角度。</p><h3>把坐标轴设置在右侧好像没有效果?</h3><p>需要将 <a href="https://echarts.apache.org/en/option.html#yAxis.axisLine.onZero">onZero</a> 设为 <code>false</code> 才行。</p><h3>如何强制显示坐标轴第一个/最后一个标签?</h3><p>ECharts 3.5.2 版本起,支持 <a href="https://echarts.apache.org/en/option.html#xAxis.axisLabel.showMinLabel">axisLabel.showMinLabel</a> 以及 <a href="https://echarts.apache.org/en/option.html#xAxis.axisLabel.showMaxLabel">axisLabel.showMaxLabel</a>,分别用来控制第一个/最后一个标签是否强制显示,设为 <code>true</code> 则强制显示。</p><p>如果不方便更新版本,可以参考<a href="https://gallery.echartsjs.com/editor.html?c=xry06afSje">这个例子</a>实现同样的效果。</p><h2 id="legend">图例 legend</h2><h3>图例区域太大导致遮挡住图表怎么办?</h3><p>可以设置 <a href="https://echarts.apache.org/en/option.html#grid">grid</a> 控制图表区域位置。例如将 <code>grid.top</code> 设置得大一些,可以将绘图区域下移。</p><p>在未来的版本中,我们计划会将布局做得更智能,自动处理这些遮挡问题。</p><h2 id="line-chart">折线图</h2><h3>坐标轴刻度好像和数据不匹配?</h3><p>请检查一下是否设置了 <code>stack</code>,如果不是想做堆积折线图的话,应该将其去掉。</p><h2 id="bar-chart">柱状图</h2><h3>为什么数据值很小的时候,y 轴的刻度会消失?</h3><p>ECharts 3.5.2 版本修复了该问题。</p><h2 id="map-chart">地图</h2><h3>图表上的省份名称重叠,如何修改名称的位置?</h3><p>可以修改地图文件(JS 或 JSON)中对应省份的 <code>cp</code> 坐标,或者通过 <code>echarts.getMap('china')</code> 修改已加载的地图数据。</p><p>更详细的做法请参考:<a href="https://github.com/ecomfe/echarts/issues/4379#issuecomment-257765948">GitHub</a></p><h3>其他国家的地图在哪里下载?</h3><p>可以在<a href="https://github.com/echarts-maps/echarts-countries-js">这里</a>下载到其他国家的地图信息。</p><h3>如何获取地图的缩放事件?</h3><p>首先,需要将系列的 <a href="https://echarts.apache.org/en/option.html#series-map.roam">roam</a> 设置为 <code>true</code>,然后可以监听 <code>'georoam'</code> 事件。例:</p><pre><code>myChart.on('georoam', function (params) {
console.log(params);
});</code></pre><p>参见这个<a href="https://gallery.echartsjs.com/editor.html?c=xHyqn_rQ6g">完整的例子</a></p><h3>如何制作自定义地图?</h3><p>ECharts 地图在地图坐标的基础上进行过<a href="https://github.com/ecomfe/echarts/blob/8eeb7e5abe207d0536c62ce1f4ddecc6adfdf85e/src/util/mapData/rawData/encode.js">额外的编码</a>。可以使用 <a href="https://github.com/giscafer/mapshaper-plus">mapshaper-plus</a> 工具,上传自定义的 geojson 文件,生成 ECharts 可以使用的地图文件。</p><h2 id="baidu-map">百度地图</h2><h3>如何结合百度地图使用 ECharts?</h3><ol><li>引入 <code>echarts.js</code><code>bmap.js</code> 以及 <code>https://api.map.baidu.com/api?v=2.0&ak=这里填在百度开发平台注册得到的 access key</code></li><li><code>option</code> 中设置 <code>bmap</code>,参考<a href="https://gallery.echartsjs.com/editor.html?c=effectScatter-bmap">这个例子</a></li><li>如需获得百度地图实例,可以通过 <code>chart.getModel().getComponent('bmap').getBMap()</code>,然后根据<a href="https://developer.baidu.com/map/reference/index.php?title=Class:%E6%80%BB%E7%B1%BB/%E6%A0%B8%E5%BF%83%E7%B1%BB">百度地图 API</a> 做进一步设置。</li></ol><p><a href="https://gallery.echartsjs.com/explore.html#components=bmap~sort=rank~timeframe=all~author=all">Gallery</a> 上有更多百度地图的例子,可作为参考。</p><h2 id="gauge-chart">仪表盘</h2><h3>怎么设置仪表盘颜色?</h3><p>可以使用 <a href="https://echarts.apache.org/en/option.html#series-gauge.axisLine.lineStyle.color">axisLine.lineStyle.color</a> 设置。</p><h2 id="event">事件处理</h2><h3>如何获取图表点击等事件?</h3><p>参考<a href="https://echarts.apache.org/en/tutorial.html#Events%20and%20Actions%20in%20ECharts">官网教程</a>。ECharts 支持的事件类型请参考<a href="https://echarts.apache.org/en/api.html#events">相关 API</a></p><h2 id="others">其他</h2><h3>图表为什么不显示?</h3><p>你可以检查以下情况:</p><ul><li><code>echarts.js</code> 是否正常被加载;</li><li><code>echarts</code> 变量是否存在;</li><li>调用 <code>echarts.init</code> 的时候,DOM 容器是否有宽高。</li></ul><h3>ECharts 有哪些学习资料?</h3><p>官网是最好的学习平台。此外,在 <a href="https://gallery.echartsjs.com">ECharts Gallery</a> 上学习别人的作品也是一个不错的选择。</p><p>ECharts 相关项目及资源请参见 <a href="https://github.com/ecomfe/awesome-echarts">awesome-echarts</a></p></div></div></div><script type="text/javascript" src="https://cdn.jsdelivr.net/npm/bootstrap@3.3.7/dist/js/bootstrap.min.js"></script><script type="text/javascript" src="https://echarts.cdn.apache.org/zh/js/common.js"></script><script type="text/javascript">document.getElementById('nav-about').className = 'active';</script><!-- Baidu Tongji--><script type="text/javascript">var _hmt = _hmt || [];
(function() {
var hm = document.createElement("script");
hm.src = "https://hm.baidu.com/hm.js?54b918eee37cb8a7045f0fd0f0b24395";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
</script><!-- Google Analytics--><script type="text/javascript" async src="https://www.googletagmanager.com/gtag/js?id=UA-141228404-1"></script><script type="text/javascript">window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'UA-141228404-1');</script></html>