File Source for HTMLRadioGroup.class.php

<?php
/**
* For including this file you have to define the constant "CLASSPATH".
* Because every include in the framework depends on the CLASSPATH definition.
* The CLASSPATH means the relative path to the folder that contains the
* framework GilliGan.
*
* @package forms
* @subpackage items
*/
if( !defined( "CLASSPATH" ) )
{
echo "<h3>You have to define the constant CLASSPATH!</h3>\n";
echo "Example: define( 'CLASSPATH', '../path/to/classes/' );\n";
exit();
}
/**
*
*/
require_once( CLASSPATH."forms/items/ABSTHTMLFormItem.class.php" );
/**
* @package forms
* @subpackage items
* @abstract
* @version 0.2.23
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @license http://www.gnu.org/copyleft/lesser.html
* GNU Lesser General Public License
* @copyright Copyright (C) 2004 Daniel PlÃ¼cken <daniel@debakel.net>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307 USA
*/
class HTMLRadioGroup extends ABSTHTMLFormItem
{
/**
* @var array
* @public
*/
var $radioButtonsLabels = array();
/**
* @var string
* @public
*/
var $radioButtonsLabelsInlineStyle = "display: inline";
/**
* @var array
* @public
*/
var $radioButtonsValues = array();
/**
* @var array
* @public
*/
var $radioButtonsOnMouseUp;
/**
* Stores whether the radio buttons should arrange horizontal; Arrangement
* with or without breaks.
*
* @var array
* @public
*/
var $horizontal = false;
/**
* Constructor
*
* @version 1.2
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param string $name Name of the radio button group.
* @param array $labelArr Array with the label of each radio
* button.
* @param array $valueArr Array with the value of each radio
* button.
* @param string $selectedValue Value to be select.
* @param string $horizontal Whether the radio buttons should
* arrange horizontal.
* @return HTMLRadioGroup
*/
function HTMLRadioGroup(
$name = "",
$labelArr = array(),
$valueArr = array(),
$selectedValue = "",
$horizontal = false
)
{
if(
is_array( $labelArr )
|| is_array( $valueArr )
)
{
$this->radioButtonsLabels = $labelArr;
$this->radioButtonsValues = $valueArr;
}
$this->name = $name;
$this->id = $name;
$this->value = $selectedValue;
$this->horizontal = $horizontal;
}
/**
* Adds a new radiobutton to the group.
*
* @version 1.1
* @since 0.1.1
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param array $label
* @param array $value
* @or
* @param string $label
* @param string $value
* @return void
*/
function addButton( $label = "", $value = "" )
{
if(
is_array( $label )
|| is_array( $value )
)
{
for( $i = 0; $i < max( count( $label ), count( $value ) ); $i++ )
{
$this->radioButtonsLabels[] = $label[$i];
$this->radioButtonsValues[] = $value[$i];
}
}
else
{
$this->radioButtonsLabels[] = $label;
$this->radioButtonsValues[] = $value;
}
}
/**
* Adding an array to this object, that carries the javascript for the
* onMouseup-tag of each radiobutton.
*
* @version 1.0
* @since 0.1.8
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param array $array Array with the javascripts of each radio button
* they should execute on left mouse button up.
* @return void
*/
function setMouseUpArray( $array )
{
if ( is_array( $array ) )
$this->radioButtonsOnMouseUp = $array;
}
/**
* Returns a string which contains a function of a javascript to check the
* radiobutton which value is the given one.
*
* @version 1.0
* @since 0.1.6
* @static
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return string
*/
function getJSFunctions()
{
$out = " function setRadio( field, wert )\r\n";
$out .= " {\r\n";
$out .= " Ã¼for( i = 0; i < field.length; i++ )\r\n";
$out .= " if( field[i].value == wert )\r\n";
$out .= " field[i].checked = true;\r\n";
$out .= " }\r\n";
return $out;
}
/**
* Returns an if-order of a javascript to check whether this item is NOT
* filled
*
* @version 1.2
* @since 0.1.4
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param string $formName
* @return string
*/
function getCheckOrder()
{
for( $i = 0; $i < count( $this->radioButtonsValues ); $i++ )
if( $i == 0 )
$out = "document.".$this->parentform->name."."
.$this->name."[0].checked != true";
else
$out .= "\r\n && document.".$this->parentform->name."."
.$this->name."[".$i."].checked != true";
return $out;
}
/**
* Set the value of inline styles of the labels for the radiobuttons of the
* group.
*
* @version 1.0
* @since 0.2.22
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param string $string
* @return void
*/
function setLabelFreeStyle( $string )
{ $this->radioButtonsLabelsInlineStyle = $string; }
/**
* Generates the sourcecode to build this object and returns it.
*
* @version 1.0
* @since 0.1.5
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return string
*/
function getPHPSource()
{
$out .= "unset( \x24LabelArr );\r\n";
$out .= "unset( \x24ValueArr );\r\n";
$cntLab = count( $this->radioButtonsLabels );
$cntVal = count( $this->radioButtonsValues );
if( !empty( $cntLab ) )
{
$out .= "\x24LabelArr = array(\r\n";
for( $i = 0; $i < $cntLab ; $i++ )
{
$comma = ( $cntLab - 1 != $i )
? ","
: "";
$out .= " \""
.$this->radioButtonsLabels[$i]."\"".$comma."\r\n";
}
$out .= " );\r\n";
}
if( !empty( $cntVal ) )
{
$out .= "\x24ValueArr = array(\r\n";
for( $i = 0; $i < $cntVal ; $i++ )
{
$comma = ( $cntVal - 1 != $i )
? ","
: "";
$out .= " \""
.$this->radioButtonsValues[$i]."\"".$comma."\r\n";
}
$out .= " );\r\n";
}
$out .= "unset( \x24value );\r\n";
$out .= "\x24value = \x24_POST[\"".$this->getName()."\"]\r\n"
." .\x24_GET[\"".$this->getName()."\"];\r\n";
$out .= "\x24input[] = new HTMLRadioGroup(\r\n"
." \"".$this->getName()."\",\r\n"
." \x24LabelArr,\r\n"
." \x24ValueArr,\r\n"
." \x24value,\r\n"
." ".( empty( $this->horizontal )
? "false"
: "true"
)."\r\n"
." );\r\n";
/*
$tmp = $this->getSelectedValue();
$out .= !empty( $tmp )
? "if( \x24value === \"\" )\r\n"
." \x24input[count(\x24input)-1]->setSelectedValue( \"".$tmp."\" );\r\n"
: "\r\n";
*/
return $out;
}
/**
* Returns a generated string based on the attributes of this object.
*
* @version 1.72
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param string forminput POST or GET or REQUEST
* @return string
*/
function get( $forminput = "" )
{
$this->idExists( $this->id, true );
$out = "";
for( $i = 0; $i < count( $this->radioButtonsValues ); $i++ )
{
$out .= "<input type=\"radio\"\r\n"
." name=\"".$this->name."\"\r\n"
." id=\"".$this->id."_".$i."\"";
$out .= !empty( $this->style_class )
? "\r\n class=\""
.$this->style_class."\""
: "";
$out .= !empty( $this->freestyle )
? "\r\n style=\""
.$this->freestyle."\""
: "";
$out .= !empty( $this->radioButtonsValues[$i] )
? "\r\n value=\""
.$this->radioButtonsValues[$i]."\""
: "";
$out .= !empty( $this->radioButtonsOnMouseUp[$i] )
? "\r\n onMouseup=\""
.$this->radioButtonsOnMouseUp[$i]."\""
: "";
$out .= (
$this->enabled
&& $this->manipulateable
)
? ""
: " disabled=\"disabled\"";
if(
$forminput == "POST"
|| $forminput == "GET"
|| $forminput == "REQUEST"
)
$out .= "<? if( \x24_".$forminput."['".$this->name."'] "
."== '".$this->radioButtonsValues[$i]."' ) "
."echo ' checked'; ?>";
else
$out .= (
$this->value == $this->radioButtonsValues[$i]
|| (
$this->value == "on"
&& $this->radioButtonsValues[$i] == 0
)
)
? "\r\n checked=\"checked\""
: "";
$out .= "\r\n/>".(
!empty( $this->radioButtonsLabels[$i] )
? "<label for=\"".$this->id."_".$i."\""
.(
!empty( $this->radioButtonsLabelsInlineStyle )
? " style=\"{$this->radioButtonsLabelsInlineStyle}\""
: ""
)
.">"
.$this->radioButtonsLabels[$i]."</label>"
: ""
);
if(
$i + 1 != count( $this->radioButtonsValues )
&& !$this->
horizontal
)
$out .= "<br>\r\n";
}
return $out;
}
} // END of class HTMLRadioGroup

Source for file HTMLRadioGroup.class.php