Unclear docs for headerDataGetter and headerRenderer usage

[hipertracker]

What is exactly the headerDataGetter meaning? The documentation is laconic and unclear. It just says that this is "Function that is called to get the data for the header row." But what data format should be returned? And how such data is used? By headerRenderer? HOW? It is completely unclear and implicit.

I know that:

• headerRenderer is rendered only once and it has not access to dynamic state.
• headerDataGetter has access to the state but it's output is not rendered as HTML.

The problem is: to render HTML in the header I need headerRenderer. But to have this content dynamic I need headerDataGetter. So I need both of them but I do not know how headerDataGetter is used by headerRenderer (or vice-versa?) The rendered result is a magic merge from both parts. How it works? How both API function are related to each other?

[ehzhang]

@hipertracker sorry for the frustration!

Right now, the way that the table works is that headerDataGetter is a function used by each column to get that header's "data", which is the label value given as the first argument to the headerRenderer function. In order to determine whether or not the header will need to re-render using the headerRenderer function, the table checks for any changes in the return value of the headerDataGetter. No data changes, no re-render.

The headerDataGetter function has a single argument, which is the column number, which you canu se to get a label.

I agree that the documentation isn't clear about how this works, and it's definitely quite confusing. As referenced in #155 , future versions will have a different API dealing with this data vs render problem.

[jasongonzales23]

This discussion in thei issue helped me figure this confusing API out, but a simple example would probably help for the time being.

[musbaig]

+1 👍