zrender.js 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341
  1. /*!
  2. * ZRender, a high performance 2d drawing library.
  3. *
  4. * Copyright (c) 2013, Baidu Inc.
  5. * All rights reserved.
  6. *
  7. * LICENSE
  8. * https://github.com/ecomfe/zrender/blob/master/LICENSE
  9. */
  10. import env from './core/env.js';
  11. import * as zrUtil from './core/util.js';
  12. import Handler from './Handler.js';
  13. import Storage from './Storage.js';
  14. import Animation, { getTime } from './animation/Animation.js';
  15. import HandlerProxy from './dom/HandlerProxy.js';
  16. import { lum } from './tool/color.js';
  17. import { DARK_MODE_THRESHOLD } from './config.js';
  18. import Group from './graphic/Group.js';
  19. var painterCtors = {};
  20. var instances = {};
  21. function delInstance(id) {
  22. delete instances[id];
  23. }
  24. function isDarkMode(backgroundColor) {
  25. if (!backgroundColor) {
  26. return false;
  27. }
  28. if (typeof backgroundColor === 'string') {
  29. return lum(backgroundColor, 1) < DARK_MODE_THRESHOLD;
  30. }
  31. else if (backgroundColor.colorStops) {
  32. var colorStops = backgroundColor.colorStops;
  33. var totalLum = 0;
  34. var len = colorStops.length;
  35. for (var i = 0; i < len; i++) {
  36. totalLum += lum(colorStops[i].color, 1);
  37. }
  38. totalLum /= len;
  39. return totalLum < DARK_MODE_THRESHOLD;
  40. }
  41. return false;
  42. }
  43. var ZRender = (function () {
  44. function ZRender(id, dom, opts) {
  45. var _this = this;
  46. this._sleepAfterStill = 10;
  47. this._stillFrameAccum = 0;
  48. this._needsRefresh = true;
  49. this._needsRefreshHover = false;
  50. this._darkMode = false;
  51. opts = opts || {};
  52. this.dom = dom;
  53. this.id = id;
  54. var storage = new Storage();
  55. var rendererType = opts.renderer || 'canvas';
  56. if (!painterCtors[rendererType]) {
  57. rendererType = zrUtil.keys(painterCtors)[0];
  58. }
  59. if (process.env.NODE_ENV !== 'production') {
  60. if (!painterCtors[rendererType]) {
  61. throw new Error("Renderer '" + rendererType + "' is not imported. Please import it first.");
  62. }
  63. }
  64. opts.useDirtyRect = opts.useDirtyRect == null
  65. ? false
  66. : opts.useDirtyRect;
  67. var painter = new painterCtors[rendererType](dom, storage, opts, id);
  68. var ssrMode = opts.ssr || painter.ssrOnly;
  69. this.storage = storage;
  70. this.painter = painter;
  71. var handlerProxy = (!env.node && !env.worker && !ssrMode)
  72. ? new HandlerProxy(painter.getViewportRoot(), painter.root)
  73. : null;
  74. var useCoarsePointer = opts.useCoarsePointer;
  75. var usePointerSize = (useCoarsePointer == null || useCoarsePointer === 'auto')
  76. ? env.touchEventsSupported
  77. : !!useCoarsePointer;
  78. var defaultPointerSize = 44;
  79. var pointerSize;
  80. if (usePointerSize) {
  81. pointerSize = zrUtil.retrieve2(opts.pointerSize, defaultPointerSize);
  82. }
  83. this.handler = new Handler(storage, painter, handlerProxy, painter.root, pointerSize);
  84. this.animation = new Animation({
  85. stage: {
  86. update: ssrMode ? null : function () { return _this._flush(false); }
  87. }
  88. });
  89. if (!ssrMode) {
  90. this.animation.start();
  91. }
  92. }
  93. ZRender.prototype.add = function (el) {
  94. if (this._disposed || !el) {
  95. return;
  96. }
  97. this.storage.addRoot(el);
  98. el.addSelfToZr(this);
  99. this.refresh();
  100. };
  101. ZRender.prototype.remove = function (el) {
  102. if (this._disposed || !el) {
  103. return;
  104. }
  105. this.storage.delRoot(el);
  106. el.removeSelfFromZr(this);
  107. this.refresh();
  108. };
  109. ZRender.prototype.configLayer = function (zLevel, config) {
  110. if (this._disposed) {
  111. return;
  112. }
  113. if (this.painter.configLayer) {
  114. this.painter.configLayer(zLevel, config);
  115. }
  116. this.refresh();
  117. };
  118. ZRender.prototype.setBackgroundColor = function (backgroundColor) {
  119. if (this._disposed) {
  120. return;
  121. }
  122. if (this.painter.setBackgroundColor) {
  123. this.painter.setBackgroundColor(backgroundColor);
  124. }
  125. this.refresh();
  126. this._backgroundColor = backgroundColor;
  127. this._darkMode = isDarkMode(backgroundColor);
  128. };
  129. ZRender.prototype.getBackgroundColor = function () {
  130. return this._backgroundColor;
  131. };
  132. ZRender.prototype.setDarkMode = function (darkMode) {
  133. this._darkMode = darkMode;
  134. };
  135. ZRender.prototype.isDarkMode = function () {
  136. return this._darkMode;
  137. };
  138. ZRender.prototype.refreshImmediately = function (noAnimationUpdate) {
  139. if (this._disposed) {
  140. return;
  141. }
  142. this._refresh({
  143. animUpdate: !noAnimationUpdate,
  144. refresh: true,
  145. refreshHover: false
  146. });
  147. };
  148. ZRender.prototype._refresh = function (opt) {
  149. if (opt.animUpdate) {
  150. this.animation.update(true);
  151. }
  152. this._needsRefresh = this._needsRefreshHover = false;
  153. this.painter.refresh({
  154. refresh: opt.refresh,
  155. refreshHover: opt.refreshHover
  156. });
  157. this._needsRefresh = this._needsRefreshHover = false;
  158. };
  159. ZRender.prototype.refresh = function () {
  160. if (this._disposed) {
  161. return;
  162. }
  163. this._needsRefresh = true;
  164. this.animation.start();
  165. };
  166. ZRender.prototype.flush = function () {
  167. if (this._disposed) {
  168. return;
  169. }
  170. this._flush(true);
  171. };
  172. ZRender.prototype._flush = function (animationUpdate) {
  173. var triggerRendered;
  174. var start = getTime();
  175. var needsRefresh = this._needsRefresh;
  176. var needsRefreshHover = this._needsRefreshHover;
  177. if (needsRefresh || needsRefreshHover) {
  178. triggerRendered = true;
  179. this._refresh({
  180. animUpdate: animationUpdate,
  181. refresh: needsRefresh,
  182. refreshHover: needsRefreshHover
  183. });
  184. }
  185. var end = getTime();
  186. if (triggerRendered) {
  187. this._stillFrameAccum = 0;
  188. this.trigger('rendered', {
  189. elapsedTime: end - start
  190. });
  191. }
  192. else if (this._sleepAfterStill > 0) {
  193. this._stillFrameAccum++;
  194. if (this._stillFrameAccum > this._sleepAfterStill) {
  195. this.animation.stop();
  196. }
  197. }
  198. };
  199. ZRender.prototype.setSleepAfterStill = function (stillFramesCount) {
  200. this._sleepAfterStill = stillFramesCount;
  201. };
  202. ZRender.prototype.wakeUp = function () {
  203. if (this._disposed) {
  204. return;
  205. }
  206. this.animation.start();
  207. this._stillFrameAccum = 0;
  208. };
  209. ZRender.prototype.refreshHover = function () {
  210. this._needsRefreshHover = true;
  211. };
  212. ZRender.prototype.refreshHoverImmediately = function () {
  213. if (this._disposed) {
  214. return;
  215. }
  216. this._refresh({
  217. animUpdate: false,
  218. refresh: false,
  219. refreshHover: true
  220. });
  221. };
  222. ZRender.prototype.resize = function (opts) {
  223. if (this._disposed) {
  224. return;
  225. }
  226. opts = opts || {};
  227. this.painter.resize(opts.width, opts.height);
  228. this.handler.resize();
  229. };
  230. ZRender.prototype.clearAnimation = function () {
  231. if (this._disposed) {
  232. return;
  233. }
  234. this.animation.clear();
  235. };
  236. ZRender.prototype.getWidth = function () {
  237. if (this._disposed) {
  238. return;
  239. }
  240. return this.painter.getWidth();
  241. };
  242. ZRender.prototype.getHeight = function () {
  243. if (this._disposed) {
  244. return;
  245. }
  246. return this.painter.getHeight();
  247. };
  248. ZRender.prototype.setCursorStyle = function (cursorStyle) {
  249. if (this._disposed) {
  250. return;
  251. }
  252. this.handler.setCursorStyle(cursorStyle);
  253. };
  254. ZRender.prototype.findHover = function (x, y) {
  255. if (this._disposed) {
  256. return;
  257. }
  258. return this.handler.findHover(x, y);
  259. };
  260. ZRender.prototype.on = function (eventName, eventHandler, context) {
  261. if (!this._disposed) {
  262. this.handler.on(eventName, eventHandler, context);
  263. }
  264. return this;
  265. };
  266. ZRender.prototype.off = function (eventName, eventHandler) {
  267. if (this._disposed) {
  268. return;
  269. }
  270. this.handler.off(eventName, eventHandler);
  271. };
  272. ZRender.prototype.trigger = function (eventName, event) {
  273. if (this._disposed) {
  274. return;
  275. }
  276. this.handler.trigger(eventName, event);
  277. };
  278. ZRender.prototype.clear = function () {
  279. if (this._disposed) {
  280. return;
  281. }
  282. var roots = this.storage.getRoots();
  283. for (var i = 0; i < roots.length; i++) {
  284. if (roots[i] instanceof Group) {
  285. roots[i].removeSelfFromZr(this);
  286. }
  287. }
  288. this.storage.delAllRoots();
  289. this.painter.clear();
  290. };
  291. ZRender.prototype.dispose = function () {
  292. if (this._disposed) {
  293. return;
  294. }
  295. this.animation.stop();
  296. this.clear();
  297. this.storage.dispose();
  298. this.painter.dispose();
  299. this.handler.dispose();
  300. this.animation =
  301. this.storage =
  302. this.painter =
  303. this.handler = null;
  304. this._disposed = true;
  305. delInstance(this.id);
  306. };
  307. return ZRender;
  308. }());
  309. export function init(dom, opts) {
  310. var zr = new ZRender(zrUtil.guid(), dom, opts);
  311. instances[zr.id] = zr;
  312. return zr;
  313. }
  314. export function dispose(zr) {
  315. zr.dispose();
  316. }
  317. export function disposeAll() {
  318. for (var key in instances) {
  319. if (instances.hasOwnProperty(key)) {
  320. instances[key].dispose();
  321. }
  322. }
  323. instances = {};
  324. }
  325. export function getInstance(id) {
  326. return instances[id];
  327. }
  328. export function registerPainter(name, Ctor) {
  329. painterCtors[name] = Ctor;
  330. }
  331. var ssrDataGetter;
  332. export function getElementSSRData(el) {
  333. if (typeof ssrDataGetter === 'function') {
  334. return ssrDataGetter(el);
  335. }
  336. }
  337. export function registerSSRDataGetter(getter) {
  338. ssrDataGetter = getter;
  339. }
  340. export var version = '6.1.0';
  341. ;