Typo3 Formidable > Reference > elements > renderlet:SELECTOR

renderlet:SELECTOR

Reference

Go to Top
path data type req default uobj description
all     This control has applied all the common properties of renderlet.

See renderlet:* section for the complete list of common properties to use.
availablerenderlet renderlet:LISTBOX  Defines a renderlet:LISTBOX, the list of available items to choose from.
You have to provide /data/items to fill it with your content.

Example:
  1. <renderlet:SELECTOR name="myselector">
  2.     <available>
  3.         <data>
  4.             <items>
  5.                 <item caption="My first" value="1" />
  6.                 <item caption="My second" value="2" />
  7.                 <item caption="My third" value="3" />
  8.             </items>
  9.         </data>
  10.     </available>
  11. </renderlet:SELECTOR>
As on any renderlet, you can of course define, for instance, events: 
  1. <renderlet:SELECTOR name="myselector">
  2.     <available>
  3.         <data>
  4.             <items>
  5.                 <item caption="My first" value="1" />
  6.                 <item caption="My second" value="2" />
  7.                 <item caption="My third" value="3" />
  8.             </items>
  9.         </data>
  10.         <onChange runat="client">
  11.             <userobj>
  12.                 <php><![CDATA[
  13.                     return $this->majixDebug("I'm changed!");
  14.                 ]]></php>
  15.             </userobj>
  16.         </onChange>
  17.     </available>
  18. </renderlet:SELECTOR>


Note: the type of this renderlet is forced to LISTBOX
selectedrenderlet renderlet:LISTBOX  Defines a renderlet:LISTBOX, the list of selected items.
Just as for /available, you may customize any aspect of this renderlet.

Note: the type of this renderlet is forced to LISTBOX
buttonUprenderlet renderlet:IMAGE  Defines a renderlet:IMAGE representing the button that moves the selected items up in the list.
Just as for /available, you may customize any aspect of this renderlet.
You may even change the type of the renderlet.

For instance, to make it a plain button instead of an image:
  1. <renderlet:SELECTOR name="myselector">
  2.     <!-- ... -->
  3.     <buttonUp type="BUTTON" label="Up" />
  4. </renderlet:SELECTOR>
buttonDownrenderlet renderlet:IMAGE  Defines a renderlet:IMAGE representing the button that moves the selected items down in the list.
Just as for /buttonUp, you may customize any aspect of this renderlet.
You may even change the type of the renderlet.
buttonToprenderlet renderlet:IMAGE  Defines a renderlet:IMAGE representing the button that moves the selected items at the top of the list.
Just as for /buttonUp, you may customize any aspect of this renderlet.
You may even change the type of the renderlet.
buttonBottomrenderlet renderlet:IMAGE  Defines a renderlet:IMAGE representing the button that moves the selected items at the bottom of the list.
Just as for /buttonUp, you may customize any aspect of this renderlet.
You may even change the type of the renderlet.
buttonRemoverenderlet renderlet:IMAGE  Defines a renderlet:IMAGE representing the button that removes the selected items from the list.
Just as for /buttonUp, you may customize any aspect of this renderlet.
You may even change the type of the renderlet.
customRenderletrenderlet    Defines whatever additional renderlet you might need to enrich the SELECTOR.
Just as for /buttonUp, you may customize any aspect of this renderlet.
Note: You have to provide a type for this renderlet, as it does not define a default renderlet-type.

Example adding an image with an attached onclick-event:
  1. <renderlet:SELECTOR name="myselector">
  2.     <!-- ... -->
  3.     <customRenderlet
  4.         type="IMAGE"
  5.         path="EXT:ameos_formidable/api/base/rdt_selector/res/img/add.gif">
  6.         <onclick runat="client">
  7.             <userobj>
  8.                 <php><![CDATA[
  9.             return $this->majixDebug("You clicked on ADD");
  10.                 ]]></php>
  11.             </userobj>
  12.         </onclick>
  13.     </customRenderlet>
  14. </renderlet:SELECTOR>