Request updated suggestionbox javascript API docs

[shadowcreeper]

I would like to request that the suggestionbox javascript API  documentation be updated.

For instance...

1.  The method to open the suggestion list (so we can fake a combobox  down-arrow icon): The undocumented callSuggestion(ignoreMinChars)  method.

2. The method to close the suggestion list without  modifying the input's contents (as a loss of focus would produce). The  undocumented hide() method?

3. A way to tell whether the  suggestion box is currently open or not. The undocumented "active"  property?

etc...

The documentation currently only  mentions the getSelectedItems() method.

Thanks.

[ilya_shaikovsky]

for 3.x first components (SB came in first release) we unfortunatelly have no well designed API which were intended to be used from external JS and not just within the component. And them was not checked with QE for external usage. So we document API only for components designed later(as remember after 3.2) to include in docs only tested JS api.

In 4.x we will do our best to eliminate this issue.

And b.t.w. callSuggestion(ignoreMinChars) - was intended to be documented and if not - it's a real issue.

One more note - we have no plans for 3.x releases anymore soo all such information will be just added to wiki knowledgebase if found instead of commit's in reference guide. I will ceck the problem with callSuggestion and will add if not exist. But if in future you will be able to use some not announced methods successfully and will be able to make sample contribution to our wiki - it will helps other community a lot!

[shadowcreeper]

Ok, thanks for the info.

I added an article explaining how I did it: http://community.jboss.org/docs/DOC-15632?uniqueTitle=false

Alternate link: http://community.jboss.org/wiki/Howtomakearichsuggestionboxlooklikeacombobox

It's not pretty, but it's there.

[ilya_shaikovsky]

hi!

many thanks for your efforst. I made cosmetic corrections and linked from knowledgebase main page.