feat(label): support align for min/max labels

[Ovilia]

Brief Information

This pull request is in the type of:

• bug fixing
• new feature
• others

What does this PR do?

In some cases, especially when the canvas size is limited, we wish to confine the axis labels to be within an area rather than may be outside of the canvas when the label text is long. In this PR, I proposed a way to set align/verticalAlign for the first and last labels so that we can make sure they are within the boundary of the grid area.

Fixed issues

#19215

Details

Before: What was the problem?

The first and last label may be too long to be displayed when the text is long and the canvas size is limited.

After: How does it behave after the fixing?

When setting alignMinLabel: 'left', alignMaxLabel: 'right' we can make sure the text is within the grid's width and the inner labels may hide when overlap.

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 doc: add doc for 5.5.0 pull requets echarts-doc#384

Misc

ZRender Changes

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

Related test cases or examples to use the new APIs

N.A.

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.

The pull request is marked to be PR: author is committer because you are a committer of this project.

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.

[github-actions]

The changes brought by this PR can be previewed at: https://echarts.apache.org/examples/editor?version=PR-19228@3ea1970

[harshsharma-11]

@Ovilia hllo mam myself harsh ,mam i am new to apache so i want to join its slack but i don't have email auhtorised by apache with workspace @apache.org so how can i join the slack

[Ovilia]

@Ovilia hllo mam myself harsh ,mam i am new to apache so i want to join its slack but i don't have email auhtorised by apache with workspace @apache.org so how can i join the slack

Hi, we don't use Slack. Please subscribe our mailing list.

[harshsharma-11]

@Ovilia hllo mam myself harsh ,mam i am new to apache so i want to join its slack but i don't have email auhtorised by apache with workspace @apache.org so how can i join the slack

Hi, we don't use Slack. Please subscribe our mailing list.

okk sure mam

[pissang]

Will it be more flexible if we can provide something like minLabelStyle / maxLabelStyle?

[Ovilia]

Will it be more flexible if we can provide something like minLabelStyle / maxLabelStyle?

@pissang Thanks for reminding. I think it should be enough with alignment for the first and last label, because the first / last label should not be more important than the others (think the case with dataZoom, where the first label is not fixed). The reason why we need alignMinLabel and alignMaxLabel is to avoid overriding the canvas, instead of wanting to make them distinctive. Also, if we provide minLabelStyle / maxLabelStyle with exact attributes like axisLabel, it may bring more bugs without a thorough test.

So, I would suggest provide alignMinLabel and alignMaxLabel unless developers expressed requirements beyout that. Hope this makes sense to you. Thanks.

[echarts-bot]

Congratulations! Your PR has been merged. Thanks for your contribution! 👍