feat(axis): support dataMin/dataMax to calc a nice axis range

[Justin-ZS]

Brief Information

This pull request is in the type of:

• bug fixing
• new feature
• others

What does this PR do?

Add dataMin and dataMax properties for value axes to extend the axis range while preserving nice scale algorithm.

Fixed issues

• [Feature] able to customize the dataMax/dataMin of axis rather than fixed max/min #20770

Details

Before: What was the problem?

Currently, ECharts provides two ways to set axis range:

1. Let ECharts auto-calculate nice values by default
2. Use min/max to set fixed values, but this disables the nice scale algorithm

There was no way to ensure a specific data point would be included in the axis range while still benefiting from the nice scale algorithm.

After: How does it behave after the fixing?

With the new dataMin/dataMax properties, users can:

• Specify values that should be included in the axis range
• Only affect the range if the specified value extends beyond the actual data range
• Still benefit from ECharts' nice scale algorithm for rounding values

These properties are only effective for value axes (value, log) and have no effect on category axes.

Document Info

One of the following should be checked.

• This PR doesn't relate to document changes
• The document should be updated later
• The document changes have been made in apache/echarts-doc#xxx

Misc

ZRender Changes

• This PR depends on ZRender changes (ecomfe/zrender#xxx).

Related test cases or examples to use the new APIs

Test cases have been included in test/axis-data-min-max.html to verify different scenarios including:

• Basic usage with standard value axes
• Scenarios with negative values
• Usage with log axes
• Verification that they don't affect category axes

Others

Merging options

• Please squash the commits into a single one when merging.

Other information

[echarts-bot]

Thanks for your contribution!
The community will review it ASAP. In the meanwhile, please checkout the coding standard and Wiki about How to make a pull request.

Document changes are required in this PR. Please also make a PR to apache/echarts-doc for document changes and update the issue id in the PR description. When the doc PR is merged, the maintainers will remove the PR: awaiting doc label.

[Justin-ZS]

@Ovilia @100pah Could you help to review the PR? Thanks!

[sjcobb]

I’ve experienced this problem as a user so interested to see how this PR progresses, I will say the naming here is a bit confusing, especially since ECharts already supports a different concept as: min: 'dataMin' and max: ‘dataMax’

[Justin-ZS]

I’ve experienced this problem as a user so interested to see how this PR progresses, I will say the naming here is a bit confusing, especially since ECharts already supports a different concept as: min: 'dataMin' and max: ‘dataMax’

I intentionally use the terms dataMin/dataMax:

1. From a usage perspective, dataMin/dataMax should not be used simultaneously with min/max.
2. If a user does combine them, dataMin/dataMax will affect the result of min: 'dataMin' and max: ‘dataMax’.
   For example: if the original data range is [100, 300], setting { dataMax: 500, max: 'dataMax' } will fix the axis maximum to 500.
   Using the same terms here makes the it more intuitive.
3. I'm open to change the name if the maintainers have any recommendations

[Ovilia]

This seems a little unexpected to me. Have you tried with the callback of axis.min?

yAxis: {
  max: value => Math.max(value, 1000)
}

or simply

yAxis: {
  max: 'dataMax'
}

[Justin-ZS]

This seems a little unexpected to me. Have you tried with the callback of axis.min?

yAxis: {
  max: value => Math.max(value, 1000)
}

or simply

yAxis: {
  max: 'dataMax'
}

Neither approach works in this case.
As described in #20770, we need a simple way to set the axis max to a nice round value.
This feature is particularly valuable when comparing multiple similar charts that should share the same axis range.
With this feature, I can just set the dataMax to the max value of all charts, then all charts will have the same axis range.

[Ovilia]

@Justin-ZS Can you further explain in which case should I set max value to be some rounded value larger than my given value, instead of not setting max at all?

[Justin-ZS]

@Justin-ZS Can you further explain in which case should I set max value to be some rounded value larger than my given value, instead of not setting max at all?

When comparing multiple similar charts. (like sales data from different stores, one chart for one store)
When not setting the max, the axis max of chart 1 is 4000, and the axis max of chart 2 is 3000.
Setting "max" to all charts directly will make them ugly, as the max value could be 3744.55
With this new feature, all axis max will be 4000.