1.5 Template Project

The Joomla! Documentation Working Group is running a project to develop detailed reference and tutorial material on Joomla! 1.5 templates.  There is a project page on the documentation wiki where you can see the work in progress and help us by contributing your knowledge.

Who's Online

We have 8 guests online

Help Site License

The Joomla! Help Site content is copyright © 2005 - 2008 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution NonCommercial ShareAlike 2.5. Some parts of this website may be subject to other licenses.
Home arrow Developer Manual arrow 11. API Reference arrow mosHTML::yesnoSelectList

mosHTML::yesnoSelectList PDF Print E-mail

Last reviewed: Not reviewed
phpDocumentor

mosHTML::yesnoSelectList

A convenient method of building an HTML select list consisting of just a 'No' and a 'Yes' option.  The words for 'Yes' and 'No' are taken from the current language settings. The HTML field will return a '0' is the user selects 'no' or '1' if the user selects 'yes'.

Syntax

string yesnoSelectList ( string $tag_name, string $tag_attribs, mixed $selected [, string $yes [, string $no ]] )

$tag_name
is the name attribute of the HTML <select> tag.
$tag_attribs
is a string containing any additional attributes that you want to assign to the HTML <select> tag.
$selected
is either a string value for a single value select list or an array for a multiple value select list.
$yes
is a string containing the word for 'Yes' that will be displayed to the user. This parameter is optional and if omitted will default to the word for 'Yes' taken from the current language settings.
$no
is a string containing the word for 'No' that will be displayed to the user. This parameter is optional and if omitted will default to the word for 'No' taken from the current language settings.

Examples

Example 1: A simple yes/no select field with 'No' selected by default

$html = mosHTML::yesnoSelectList( 'show_banners', 'class="inputbox"', '0' );
echo $html;

which produces:

<select name="show_banners" class="inputbox">
  <option value="0" selected="selected">No</option>
  <option value="1">Yes</option>
</select>
 

which renders as:

Example 2: A select list for 'On' or 'Off' with 'On' selected by default.

$html = mosHTML::yesnoSelectList( 'myswitch', 'class="inputbox"', '1', 'On', 'Off' );
echo $html;

which produces:

<select name="myswitch" class="inputbox">
  <option value="0">Off</option>
  <option value="1" selected="selected">On</option>
</select>

 which renders as:


Please report any errors on this page to the Developer Documentation Forum.


Last Updated ( Saturday, 03 September 2005 )
 
< Prev   Next >