<?xml version="1.0" encoding="UTF-8"?>
<section>
<sectioninfo>
<keywordset>
    <keyword>rich:suggestionBox</keyword>
</keywordset>
</sectioninfo>
<section>
<title>Description</title>
    <para>The component adds on-keypress suggestions capabilities to any input text component 
    (like <emphasis role="bold"><property>&lt;h:inputText&gt;</property></emphasis>). When a key 
    is pressed in the field Ajax request is sent to the server. When the suggestion action returns a 
    list of possible values, it pop ups them inside the 
      <emphasis role="bold"><property>&lt;div&gt;</property></emphasis> element bellow the input.</para>
    <figure>
        <title><emphasis role="bold"><property>&lt;rich:suggestionBox&gt;</property></emphasis> component</title>
    <mediaobject> 
        <imageobject>
            <imagedata fileref="images/suggestionbox_init.png"/>
        </imageobject>
    </mediaobject>
    </figure>
    </section>
 <section>
    <title>Key Features</title>
    <itemizedlist>
        <listitem><para>Fully skinnable component</para></listitem>
        <listitem><para>Adds <emphasis><property>&quot;onkeypress&quot;</property></emphasis> suggestions capabilities to any input text component</para></listitem>
        <listitem><para>Performs suggestion via Ajax requests without any line of JavaScript code written 
        by you</para></listitem>
        <listitem><para>Possible to render table as a popup suggestion</para></listitem>
        <listitem><para>Can be pointed to any Ajax request status indicator of the page</para></listitem>
        <listitem><para>Easily customizable size of suggestion popup</para></listitem>
        <listitem><para>Setting rules that appear between cells within a table of popup values</para></listitem>
        <listitem><para><emphasis 

><property>&quot;Event queue&quot;</property></emphasis> and <emphasis 

><property>&quot;request delay&quot;</property></emphasis> attributes present to divide
 frequently requests</para></listitem>
        <listitem><para>Managing area of components submitted on Ajax request</para></listitem>
        <listitem><para>Flexible list of components to update after Ajax request managed by attributes</para></listitem>
        <listitem><para>Setting restriction to Ajax request generation</para></listitem>
        <listitem><para>Easily setting action to collect suggestion data</para></listitem>   
        <listitem><para>Keyboard navigation support</para></listitem>   
    </itemizedlist>
	</section>
</section>