src/chart/pie/PieSeries.ts - echarts - Git at Google

 /*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

 import createListSimply from '../helper/createListSimply';
 import * as zrUtil from 'zrender/src/core/util';
 import * as modelUtil from '../../util/model';
 import {getPercentWithPrecision} from '../../util/number';
 import {makeSeriesEncodeForNameBased} from '../../data/helper/sourceHelper';
 import LegendVisualProvider from '../../visual/LegendVisualProvider';
 import SeriesModel from '../../model/Series';
 import {
     SeriesOption,
     CallbackDataParams,
     CircleLayoutOptionMixin,
     LabelLineOption,
     ItemStyleOption,
     BoxLayoutOptionMixin,
     OptionDataValueNumeric,
     SeriesEncodeOptionMixin,
     OptionDataItemObject,
     StatesOptionMixin,
     SeriesLabelOption,
     DefaultEmphasisFocus
 } from '../../util/types';
 import List from '../../data/List';

 interface PieItemStyleOption extends ItemStyleOption {
     // can be 10
     // which means that both innerCornerRadius and outerCornerRadius are 10
     // can also be an array [20, 10]
     // which means that innerCornerRadius is 20
     // and outerCornerRadius is 10
     // can also be a string or string array, such as ['20%', '50%']
     // which means that innerCornerRadius is 20% of the innerRadius
     // and outerCornerRadius is half of outerRadius.
     borderRadius?: (number | string)[] | number | string
 }

 export interface PieStateOption {
     // TODO: TYPE Color Callback
     itemStyle?: PieItemStyleOption
     label?: PieLabelOption
     labelLine?: PieLabelLineOption
 }
 interface PieLabelOption extends Omit<SeriesLabelOption, 'rotate' | 'position'> {
     rotate?: number
     alignTo?: 'none' | 'labelLine' | 'edge'
     edgeDistance?: string | number
     bleedMargin?: number
     distanceToLabelLine?: number

     position?: SeriesLabelOption['position'] | 'outer' | 'inner' | 'center'
 }

 interface PieLabelLineOption extends LabelLineOption {
     /**
      * Max angle between labelLine and surface normal.
      * 0 - 180
      */
     maxSurfaceAngle?: number
 }

 interface ExtraStateOption {
     emphasis?: {
         focus?: DefaultEmphasisFocus
         scale?: boolean
         scaleSize?: number
     }
 }

 export interface PieDataItemOption extends
     OptionDataItemObject<OptionDataValueNumeric>,
     PieStateOption, StatesOptionMixin<PieStateOption, ExtraStateOption> {

     cursor?: string
 }
 export interface PieSeriesOption extends
     Omit<SeriesOption<PieStateOption, ExtraStateOption>, 'labelLine'>, PieStateOption,
     CircleLayoutOptionMixin,
     BoxLayoutOptionMixin,
     SeriesEncodeOptionMixin {

     type?: 'pie'

     roseType?: 'radius' | 'area'

     clockwise?: boolean
     startAngle?: number
     minAngle?: number
     minShowLabelAngle?: number

     selectedOffset?: number

     avoidLabelOverlap?: boolean
     percentPrecision?: number

     stillShowZeroSum?: boolean

     animationType?: 'expansion' | 'scale'
     animationTypeUpdate?: 'transition' | 'expansion'

     data?: OptionDataValueNumeric[] | OptionDataValueNumeric[][] | PieDataItemOption[]
 }

 class PieSeriesModel extends SeriesModel<PieSeriesOption> {

     static type = 'series.pie' as const;

     useColorPaletteOnData = true;

     /**
      * @overwrite
      */
     init(option: PieSeriesOption): void {
         super.init.apply(this, arguments as any);

         // Enable legend selection for each data item
         // Use a function instead of direct access because data reference may changed
         this.legendVisualProvider = new LegendVisualProvider(
             zrUtil.bind(this.getData, this), zrUtil.bind(this.getRawData, this)
         );

         this._defaultLabelLine(option);
     }

     /**
      * @overwrite
      */
     mergeOption(): void {
         super.mergeOption.apply(this, arguments as any);
     }

     /**
      * @overwrite
      */
     getInitialData(this: PieSeriesModel): List {
         return createListSimply(this, {
             coordDimensions: ['value'],
             encodeDefaulter: zrUtil.curry(makeSeriesEncodeForNameBased, this)
         });
     }

     /**
      * @overwrite
      */
     getDataParams(dataIndex: number): CallbackDataParams {
         const data = this.getData();
         const params = super.getDataParams(dataIndex);
         // FIXME toFixed?

         const valueList: number[] = [];
         data.each(data.mapDimension('value'), function (value: number) {
             valueList.push(value);
         });

         params.percent = getPercentWithPrecision(
             valueList,
             dataIndex,
             data.hostModel.get('percentPrecision')
         );

         params.$vars.push('percent');
         return params;
     }

     private _defaultLabelLine(option: PieSeriesOption): void {
         // Extend labelLine emphasis
         modelUtil.defaultEmphasis(option, 'labelLine', ['show']);

         const labelLineNormalOpt = option.labelLine;
         const labelLineEmphasisOpt = option.emphasis.labelLine;
         // Not show label line if `label.normal.show = false`
         labelLineNormalOpt.show = labelLineNormalOpt.show
             && option.label.show;
         labelLineEmphasisOpt.show = labelLineEmphasisOpt.show
             && option.emphasis.label.show;
     }

     static defaultOption: Omit<PieSeriesOption, 'type'> = {
         zlevel: 0,
         z: 2,
         legendHoverLink: true,

         // 默认全局居中
         center: ['50%', '50%'],
         radius: [0, '75%'],
         // 默认顺时针
         clockwise: true,
         startAngle: 90,
         // 最小角度改为0
         minAngle: 0,

         // If the angle of a sector less than `minShowLabelAngle`,
         // the label will not be displayed.
         minShowLabelAngle: 0,

         // 选中时扇区偏移量
         selectedOffset: 10,

         // 选择模式，默认关闭，可选single，multiple
         // selectedMode: false,
         // 南丁格尔玫瑰图模式，'radius'（半径） | 'area'（面积）
         // roseType: null,

         percentPrecision: 2,

         // If still show when all data zero.
         stillShowZeroSum: true,

         // cursor: null,

         left: 0,
         top: 0,
         right: 0,
         bottom: 0,
         width: null,
         height: null,

         label: {
             // color: 'inherit',
             // If rotate around circle
             rotate: 0,
             show: true,
             overflow: 'truncate',
             // 'outer', 'inside', 'center'
             position: 'outer',
             // 'none', 'labelLine', 'edge'. Works only when position is 'outer'
             alignTo: 'none',
             // Closest distance between label and chart edge.
             // Works only position is 'outer' and alignTo is 'edge'.
             edgeDistance: '25%',
             // Works only position is 'outer' and alignTo is not 'edge'.
             bleedMargin: 10,
             // Distance between text and label line.
             distanceToLabelLine: 5
             // formatter: 标签文本格式器，同Tooltip.formatter，不支持异步回调
             // 默认使用全局文本样式，详见TEXTSTYLE
             // distance: 当position为inner时有效，为label位置到圆心的距离与圆半径(环状图为内外半径和)的比例系数
         },
         // Enabled when label.normal.position is 'outer'
         labelLine: {
             show: true,
             // 引导线两段中的第一段长度
             length: 15,
             // 引导线两段中的第二段长度
             length2: 15,
             smooth: false,
             minTurnAngle: 90,
             maxSurfaceAngle: 90,
             lineStyle: {
                 // color: 各异,
                 width: 1,
                 type: 'solid'
             }
         },
         itemStyle: {
             borderWidth: 1
         },

         labelLayout: {
             // Hide the overlapped label.
             hideOverlap: true
         },

         emphasis: {
             scale: true,
             scaleSize: 5
         },

         // If use strategy to avoid label overlapping
         avoidLabelOverlap: true,

         // Animation type. Valid values: expansion, scale
         animationType: 'expansion',

         animationDuration: 1000,

         // Animation type when update. Valid values: transition, expansion
         animationTypeUpdate: 'transition',

         animationEasingUpdate: 'cubicInOut',
         animationDurationUpdate: 500,
         animationEasing: 'cubicInOut'
     };

 }

 export default PieSeriesModel;
	/*
	* Licensed to the Apache Software Foundation (ASF) under one
	* or more contributor license agreements. See the NOTICE file
	* distributed with this work for additional information
	* regarding copyright ownership. The ASF licenses this file
	* to you under the Apache License, Version 2.0 (the
	* "License"); you may not use this file except in compliance
	* with the License. You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing,
	* software distributed under the License is distributed on an
	* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	* KIND, either express or implied. See the License for the
	* specific language governing permissions and limitations
	* under the License.
	*/

	import createListSimply from '../helper/createListSimply';
	import * as zrUtil from 'zrender/src/core/util';
	import * as modelUtil from '../../util/model';
	import {getPercentWithPrecision} from '../../util/number';
	import {makeSeriesEncodeForNameBased} from '../../data/helper/sourceHelper';
	import LegendVisualProvider from '../../visual/LegendVisualProvider';
	import SeriesModel from '../../model/Series';
	import {
	SeriesOption,
	CallbackDataParams,
	CircleLayoutOptionMixin,
	LabelLineOption,
	ItemStyleOption,
	BoxLayoutOptionMixin,
	OptionDataValueNumeric,
	SeriesEncodeOptionMixin,
	OptionDataItemObject,
	StatesOptionMixin,
	SeriesLabelOption,
	DefaultEmphasisFocus
	} from '../../util/types';
	import List from '../../data/List';

	interface PieItemStyleOption extends ItemStyleOption {
	// can be 10
	// which means that both innerCornerRadius and outerCornerRadius are 10
	// can also be an array [20, 10]
	// which means that innerCornerRadius is 20
	// and outerCornerRadius is 10
	// can also be a string or string array, such as ['20%', '50%']
	// which means that innerCornerRadius is 20% of the innerRadius
	// and outerCornerRadius is half of outerRadius.
	borderRadius?: (number \| string)[] \| number \| string
	}

	export interface PieStateOption {
	// TODO: TYPE Color Callback
	itemStyle?: PieItemStyleOption
	label?: PieLabelOption
	labelLine?: PieLabelLineOption
	}
	interface PieLabelOption extends Omit<SeriesLabelOption, 'rotate' \| 'position'> {
	rotate?: number
	alignTo?: 'none' \| 'labelLine' \| 'edge'
	edgeDistance?: string \| number
	bleedMargin?: number
	distanceToLabelLine?: number

	position?: SeriesLabelOption['position'] \| 'outer' \| 'inner' \| 'center'
	}

	interface PieLabelLineOption extends LabelLineOption {
	/**
	* Max angle between labelLine and surface normal.
	* 0 - 180
	*/
	maxSurfaceAngle?: number
	}

	interface ExtraStateOption {
	emphasis?: {
	focus?: DefaultEmphasisFocus
	scale?: boolean
	scaleSize?: number
	}
	}

	export interface PieDataItemOption extends
	OptionDataItemObject<OptionDataValueNumeric>,
	PieStateOption, StatesOptionMixin<PieStateOption, ExtraStateOption> {

	cursor?: string
	}
	export interface PieSeriesOption extends
	Omit<SeriesOption<PieStateOption, ExtraStateOption>, 'labelLine'>, PieStateOption,
	CircleLayoutOptionMixin,
	BoxLayoutOptionMixin,
	SeriesEncodeOptionMixin {

	type?: 'pie'

	roseType?: 'radius' \| 'area'

	clockwise?: boolean
	startAngle?: number
	minAngle?: number
	minShowLabelAngle?: number

	selectedOffset?: number

	avoidLabelOverlap?: boolean
	percentPrecision?: number

	stillShowZeroSum?: boolean

	animationType?: 'expansion' \| 'scale'
	animationTypeUpdate?: 'transition' \| 'expansion'

	data?: OptionDataValueNumeric[] \| OptionDataValueNumeric[][] \| PieDataItemOption[]
	}

	class PieSeriesModel extends SeriesModel<PieSeriesOption> {

	static type = 'series.pie' as const;

	useColorPaletteOnData = true;

	/**
	* @overwrite
	*/
	init(option: PieSeriesOption): void {
	super.init.apply(this, arguments as any);

	// Enable legend selection for each data item
	// Use a function instead of direct access because data reference may changed
	this.legendVisualProvider = new LegendVisualProvider(
	zrUtil.bind(this.getData, this), zrUtil.bind(this.getRawData, this)
	);

	this._defaultLabelLine(option);
	}

	/**
	* @overwrite
	*/
	mergeOption(): void {
	super.mergeOption.apply(this, arguments as any);
	}

	/**
	* @overwrite
	*/
	getInitialData(this: PieSeriesModel): List {
	return createListSimply(this, {
	coordDimensions: ['value'],
	encodeDefaulter: zrUtil.curry(makeSeriesEncodeForNameBased, this)
	});
	}

	/**
	* @overwrite
	*/
	getDataParams(dataIndex: number): CallbackDataParams {
	const data = this.getData();
	const params = super.getDataParams(dataIndex);
	// FIXME toFixed?

	const valueList: number[] = [];
	data.each(data.mapDimension('value'), function (value: number) {
	valueList.push(value);
	});

	params.percent = getPercentWithPrecision(
	valueList,
	dataIndex,
	data.hostModel.get('percentPrecision')
	);

	params.$vars.push('percent');
	return params;
	}

	private _defaultLabelLine(option: PieSeriesOption): void {
	// Extend labelLine emphasis
	modelUtil.defaultEmphasis(option, 'labelLine', ['show']);

	const labelLineNormalOpt = option.labelLine;
	const labelLineEmphasisOpt = option.emphasis.labelLine;
	// Not show label line if `label.normal.show = false`
	labelLineNormalOpt.show = labelLineNormalOpt.show
	&& option.label.show;
	labelLineEmphasisOpt.show = labelLineEmphasisOpt.show
	&& option.emphasis.label.show;
	}

	static defaultOption: Omit<PieSeriesOption, 'type'> = {
	zlevel: 0,
	z: 2,
	legendHoverLink: true,

	// 默认全局居中
	center: ['50%', '50%'],
	radius: [0, '75%'],
	// 默认顺时针
	clockwise: true,
	startAngle: 90,
	// 最小角度改为0
	minAngle: 0,

	// If the angle of a sector less than `minShowLabelAngle`,
	// the label will not be displayed.
	minShowLabelAngle: 0,

	// 选中时扇区偏移量
	selectedOffset: 10,

	// 选择模式，默认关闭，可选single，multiple
	// selectedMode: false,
	// 南丁格尔玫瑰图模式，'radius'（半径） \| 'area'（面积）
	// roseType: null,

	percentPrecision: 2,

	// If still show when all data zero.
	stillShowZeroSum: true,

	// cursor: null,

	left: 0,
	top: 0,
	right: 0,
	bottom: 0,
	width: null,
	height: null,

	label: {
	// color: 'inherit',
	// If rotate around circle
	rotate: 0,
	show: true,
	overflow: 'truncate',
	// 'outer', 'inside', 'center'
	position: 'outer',
	// 'none', 'labelLine', 'edge'. Works only when position is 'outer'
	alignTo: 'none',
	// Closest distance between label and chart edge.
	// Works only position is 'outer' and alignTo is 'edge'.
	edgeDistance: '25%',
	// Works only position is 'outer' and alignTo is not 'edge'.
	bleedMargin: 10,
	// Distance between text and label line.
	distanceToLabelLine: 5
	// formatter: 标签文本格式器，同Tooltip.formatter，不支持异步回调
	// 默认使用全局文本样式，详见TEXTSTYLE
	// distance: 当position为inner时有效，为label位置到圆心的距离与圆半径(环状图为内外半径和)的比例系数
	},
	// Enabled when label.normal.position is 'outer'
	labelLine: {
	show: true,
	// 引导线两段中的第一段长度
	length: 15,
	// 引导线两段中的第二段长度
	length2: 15,
	smooth: false,
	minTurnAngle: 90,
	maxSurfaceAngle: 90,
	lineStyle: {
	// color: 各异,
	width: 1,
	type: 'solid'
	}
	},
	itemStyle: {
	borderWidth: 1
	},

	labelLayout: {
	// Hide the overlapped label.
	hideOverlap: true
	},

	emphasis: {
	scale: true,
	scaleSize: 5
	},

	// If use strategy to avoid label overlapping
	avoidLabelOverlap: true,

	// Animation type. Valid values: expansion, scale
	animationType: 'expansion',

	animationDuration: 1000,

	// Animation type when update. Valid values: transition, expansion
	animationTypeUpdate: 'transition',

	animationEasingUpdate: 'cubicInOut',
	animationDurationUpdate: 500,
	animationEasing: 'cubicInOut'
	};

	}

	export default PieSeriesModel;