### Documentation for custom series `renderItem` is missing any mention of how 
to apply styling set in `series[i].emphasis`.

All examples in the documentation show application of `style: api.style()` in 
`renderItem`, but that doesn't do anything about `emphasis`. After catching the 
`api` in runtime and examining its contract, I found that it also provides a 
`styleEmphasis` method and that I can set the returned object's `styleEmphasis` 
to control its emphasis styling.

### Version & Environment [版本及环境]

_Irrelevant._

### Expected behaviour [期望结果]

Documentation for custom series' `renderItem` should clearly describe how to 
apply emphasis styling.

### ECharts option

```javascript
option = {
  // ...
  series: [{
    type: 'custom',
    itemStyle: {
      color: 'red'
    },
    emphasis: {
      itemStyle: {
        color: 'cyan'
      }
    },
    renderItem(params, api) {
      // ...
      return {
        // ...,
        style: api.style(), // the documentation shows this ...
        styleEmphasis: api.styleEmphasis() // ... but never mentions this
      }
    },
    // ...
  }]
}
```


[ Full content available at: 
https://github.com/apache/incubator-echarts/issues/8941 ]
This message was relayed via gitbox.apache.org for [email protected]

Reply via email to