Bs_FormFieldSelect

Methods inherited from Bs_FormField

Methods inherited from Bs_FormElement

Methods inherited from Bs_Object

Public Method Summary

Private Method Summary

Fields inherited from Bs_FormField

Fields inherited from Bs_FormElement

Private Field Summary

Private Constant Summary

Public Method Details

some html code

Warning: documentation is missing.

Warning: documentation is missing.

Warning: documentation is missing.

(bool)TRUE if ok, (string)error message if not.

Warning: documentation is missing.

(bool)TRUE if ok, (string)error message if not.

Private Method Details

i think, maybe an array is possible too.)

Private Field Details

>><<

how large the select field should be displayed. needs to be >1 for multiple.
if not set it won't be written to the client, which equals to a value of '1'.

>><<

if the user is able to select multiple values, not just one.
$size needs to be >1 then. if not set it's FALSE.

>><<

how to fill in the option tags for this select field.
one of 'eval' or 'hard'.if not set, the one var that is used is used :) if both are used(speaking of $optionsHard and $optionsEval) then $optionsHard isthe default.

>><<

made up in _prepareOptions() using $optionsHard and $optionsEval.

>><<

the options that are selectable for the user.
the following data structures are allowed:array('1'=>'one', '2'=>'two', '4'=>'four');array('en'=>array('1'=>'one','2'=>'two','3'=>'three'), 'de'=>array('1'=>'eins','2'=>'zwei','3'=>'drei'), 'fr'=>array('1'=>'un','2'=>'deux','3'=>'trois'));while these are not:'one';array('one', 'two', 'three');array('en'=>'one', 'de'=>'eins', 'fr'=>'un');array('en'=>array('one','two','three'), 'de'=>array('eins','zwei','drei'), 'fr'=>array('un','deux','trois'));because it would not be possible to know the difference sometimes.this means: even if you have only one default value, it must be an array. and you alwaysneed key=>val, even if the key and the value is the same.

>><<

php code to be evaluated. has to return an array (hash or vector)
that will be used for the option tags of this select field.the code is executed in $this->_prepareOptions() so it's in thescope of a method of this object. this means you can use varsfrom here etc.language dependant. ya know what i mean.

>><<

the min length the field value needs to be. if it's not a $must field,
a value shorter than $minLength is not accepted while an empty value is.note I: for the field types 'checkbox' and 'radio' this setting is ignored.because the user cannot do anything about it. it's up to the webmasternot to do shit.note II: for the field type 'select' it's the number of min. selectable elements.if it doesn't have the 'multiple' property the setting is ignored.

>><<

the max length the field value can be.
if the form tag supports it, it will be directly added like this:<input maxlength=$maxLength>it will be checked serverside anyway. someone could hack it.if not set, it'll be something that makes sense based on $bsDataType:number => 20 username => 20 domain => 80 datetime => 19text => 500 password => 20 host => 80 timestamp => 8blob => 65535 zipcode => 10 date => 10html => 65535 price => 20 time => 8email => 80 creditcard => 16 month => 2url => 200 ip => 15 year => 4there's room for more logic: if the value is made up based on $bsDataType (list above)and $dbDataType is set, the value should be no bigger than the db field types max length,eg char/varchar=255, int=11, blob=65535, ...note I: for the field types 'checkbox' and 'radio' this setting is ignored.because the user cannot do anything about it. it's up to the webmasternot to do shit.note II: for the field type 'select' it's the number of max. selectable elements.if it doesn't have the 'multiple' property the setting is ignored.

Private Constant Details