This looks simple enough, but need to review the use of "caption" in the context of our support for WAI-ARIA roles to ensure no conflict is created by adding it, etc.

I did some investigation and attempted to add this feature.

The good news is that there are no conflicts with the roles we currently use. According to the W3C specifications the caption element can be used with any other ARIA attributes. The only case where it shouldn't be used is when a table is used for layout purposes and not to display data; that is when it has the 'presentation' role. The following pages are used for reference:

http://www.w3.org/TR/2013/WD-aria-in-html-20130214/
http://www.w3.org/TR/wai-aria/roles

The only issue is when we have scrolling and staticHeader enabled, since in this case we render two <table> elements: one for the headers and one for the data. So, the <caption> element would naturally go in the table that actually displays the data. The problem is that, because this caption text is rendered on top of the table, this breaks the flow with the header table, and the table as a whole doesn't look as good. We might say that we could simply render the <caption> element in the header table, so that the caption appears an top of the whole ACE data table, as we know it. However, this could be misleading for people who actually need this feature, as the header table contains no data. So, we might simply go ahead and implement this feature, even if it doesn't look as good on tables with scrolling and staticHeaders enabled, or we could simply not supported in such case.

Attached screenshot of how the caption looks on a table with scrolling=true and staticHeaders="true.

Fortunately, if the text is too long, it wraps around, without appearing outside the table.

It's also very easy to style it using normal CSS. In the screenshot the text colour was changed to red, Hiding the text from view is just a matter of adding display:none;.

Okay, I'd say go ahead and commit this and document the styling strategy in the wiki page for the attribute.

Committed improvement to 3.3 EE maintenance branch at revision 43628 and to 4.0 trunk at revision 43629.

Added caption attribute test to QA ace:dataTable test apps: /captionAttributeTest.jsf
http://dev.icesoft.com/svn/repo/qa/trunk/Regression-Icefaces4/Sparkle/Nightly/dataTable (IF4 trunk regressions)
http://dev.icesoft.com/svn/repo/qa/trunk/Regression-Icefaces2/Sparkle/Nightly/dataTable (EE-3.3-maintenance branch regressions)

Verified with IF4 trunk / EE-3.3-maintenance r43636 in IE10, Chrome39, FF34 by running all showcase > ace:dataTable, and the QA dataTable test app regression tests.