#{extends '../../main.html'/}#
#{set title:'Html Reference'/}#
#{set tab:'management'/}#

#{renderTagArgs '../docHome.html'/}#

<h1 id="html">Pulldown Menu</h1>

<p>When doing a Pulldown Menu, you generally want to feed a List of things and the currently selected item
to the page as we do here:</p>

#{form action:@[POST_ENUM_LIST_SINGLE_SELECT]@, class:'form-horizontal'}#

	#{field 'selectedColor', label:'Color'}#
		<select size="1" name="${field.name}$" class="input-xlarge">
			#{list items:colors, as:'c'}#
				#{option value:c, selected:field.flashOrValue}#${c.label}$#{/option}#
			#{/list}#
		</select>
	#{/field}#
  
  <input type="submit" name="submit" value="&{'Save', 'link.save'}&" class="btn btn-primary" />

#{/form}#

<p>The webpieces html code above is:</p>

<pre>
<code>*[#{form action:@[POST_ENUM_LIST_SINGLE_SELECT]@, class:'form-horizontal'}#

	#{field 'selectedColor', label:'Color'}#
		<select size="1" name="${field.name}$" class="input-xlarge">
			#{list items:colors, as:'c'}#
				#{option value:c, selected:field.flashOrValue}#${c.label}$#{/option}#
			#{/list}#
		</select>
	#{/field}#
  
  <input type="submit" name="submit" value="&{'Save', 'link.save'}&" class="btn btn-primary" />

#{/form}#]*</code>
</pre>

<p>Enums have a special webconverter you need to install and the code for that is:</p>

<pre>
<code>*[	public static class WebConverter implements ObjectStringConverter<ColorEnum> {

	    public String objectToString( ColorEnum value ) {
	        if ( value == null ) {
	            return null;
	        }

	        return value.getDatabaseCode();
	    }

	    public ColorEnum stringToObject( String value ) {
	        if ( value == null ) {
	            return null;
	        }

	        return ColorEnum.lookupByCode( value );
	    }

		@Override
		public Class<ColorEnum> getConverterType() {
			return ColorEnum.class;
		}
	}]*</code>
</pre>

<p>Of course, you need to install the converter from one of your GuiceModules.  Once down, it converts
for html pages, cookies(which are string based) or any string to enum conversion needed.  Here is that code:</p>

<pre>
<code>*[Multibinder<ObjectStringConverter> conversionBinder = Multibinder.newSetBinder(binder, ObjectStringConverter.class);
conversionBinder.addBinding().to(ColorEnum.WebConverter.class);]*</code>
</pre>

<p>The webpieces routes for the above is:</p>

<pre>
<code>*[scopedBldr.addRoute(BOTH, HttpMethod.GET , "/examples/enumList", "ExamplesController.enumList", ExampleRouteId.ENUM_LIST_SINGLE_SELECT);
scopedBldr.addRoute(BOTH, HttpMethod.POST, "/examples/postEnumList", "ExamplesController.postEnumList", ExampleRouteId.POST_ENUM_LIST_SINGLE_SELECT);
scopedBldr.addRoute(BOTH, HttpMethod.GET , "/examples/enumListResult", "ExamplesController.enumListResult", ExampleRouteId.ENUM_LIST_SINGLE_SELECT_RESULT);]*</code>
</pre>

<p>The Controller GET and POST methods for this page is:</p>

<pre>
<code>*[	public Render enumList() {
		List<ColorEnum> colorList = Arrays.asList(ColorEnum.values());
		
		return Actions.renderThis(
				"menu", menuCreator.getMenu(),
				"colors", colorList,
				"selectedColor", ColorEnum.GREEN
				);
	}
	
	public Redirect postEnumList(String selectedColor) {
		//We could put the firstName in the url such as /examples/inputResult/{firstName} 
		//or we could save to database
		//or we can put it in flash and for this example, we put it in flash
		Current.flash().put("selectedColor", selectedColor);
		Current.flash().keep();
		return Actions.redirect(ExampleRouteId.ENUM_LIST_SINGLE_SELECT_RESULT);
	}]*</code>
</pre>