Package: Controls

Class: Zebra_Form_Label

source file: /includes/Label.php

Class Overview

XSS_Clean
|
--Zebra_Form_Control
|
--Zebra_Form_Label

Class for labels

Author(s):

Copyright:

  • (c) 2006 - 2013 Stefan Gabos

Methods

Inherited properties

Class: Zebra_Form_Control

Zebra_Form_Control::$attributes
Zebra_Form_Control::$private_attributes
Zebra_Form_Control::$rules

Inherited methods

Class: Zebra_Form_Control

Zebra_Form_Control::change_case()
Call this method to instruct the script to force all letters typed by the user, to either uppercase or lowercase, in real-time.
Zebra_Form_Control::disable_spam_filter()
Disables the SPAM filter for the control.
Zebra_Form_Control::disable_xss_filters()
Disables XSS filtering of the control's submitted value.
Zebra_Form_Control::get_attributes()
Returns the values of requested attributes.
Zebra_Form_Control::get_submitted_value()
Returns the control's value after the form is submitted.
Zebra_Form_Control::lock()
Locks the control's value. A locked control will preserve its default value after the form is submitted even if the user altered it.
Zebra_Form_Control::reset()
Resets the control's submitted value (empties text fields, unchecks radio buttons/checkboxes, etc).
Zebra_Form_Control::set_attributes()
Sets one or more of the control's attributes.
Zebra_Form_Control::set_rule()
Sets a single or an array of validation rules for the control.
Zebra_Form_Control::_render_attributes()
Converts the array with control's attributes to valid HTML markup interpreted by the toHTML() method

Class: XSS_Clean

XSS_Clean::sanitize()
Sanitizes submitted data so that Cross Site Scripting Hacks can be prevented.

Class methods

constructor __construct()

void __construct ( string $id , string $attach_to , mixed $caption , [ array $attributes = ''] )

Add an <label> control to the form.

Do not instantiate this class directly! Use the add() method instead!

  1. // create a new form
  2. $form = new Zebra_Form('my_form');
  3.  
  4. // add a label, attached to a textbox control
  5. $form->add('label', 'label_my_text', 'my_text', 'Enter some text:');
  6.  
  7. // add a text control to the form
  8. $obj = $form->add('text', 'my_text');
  9.  
  10. // don't forget to always call this method before rendering the form
  11. if ($form->validate()) {
  12.     // put code here
  13. }
  14.  
  15. // output the form using an automatically generated template
  16. $form->render();
Parameters:
string $id

Unique name to identify the control in the form.

This is the name of the variable to be used in the template file, containing the generated HTML for the control.

  1. // in a template file, in order to print the generated HTML
  2. // for a control named "my_label", one would use:
  3. echo $my_label;
string $attach_to

The id attribute of the control to attach the note to.

Notice that this must be the "id" attribute of the control you are attaching the label to, and not the "name" attribute!

This is important as while most of the controls have their id attribute set to the same value as their name attribute, for checkboxes, selects and radio buttons this is different.

Exception to the rule:

Just like in the case of notes, if you want a master label, a label that is attached to a group of checkboxes/radio buttons rather than individual controls, this attribute must instead refer to the name of the controls (which, for groups of checkboxes/radio buttons, is one and the same). This is important because if the group of checkboxes/radio buttons have the required rule set, this is the only way in which the "required" symbol (the red asterisk) will be attached to the master label instead of being attached to the first checkbox/radio button from the group.
mixed $caption

Caption of the label.

Putting a $ (dollar) sign before a character will turn that specific character into the accesskey.
If you need the dollar sign in the label, escape it with \ (backslash)
array $attributes

(Optional) An array of attributes valid for label elements (style, etc)

Must be specified as an associative array, in the form of attribute => value.

  1. // setting the "style" attribute
  2. $obj = $form->add(
  3.     'label',
  4.     'label_my_text',
  5.     'my_text',
  6.     'My Label:'
  7.     array(
  8.         'style' => 'font-weight: normal'
  9.     )
  10. );

Special attribute:

When setting the special attribute inside to true, the label will appear inside the control is attached to (if the control the label is attached to is a textbox or a textarea) and will disappear when the control will receive focus. When the "inside" attribute is set to TRUE, the label will not be available in the template file as it will be contained by the control the label is attached to!

  1. $form->add('label', 'my_label', 'my_control', 'My Label:', array('inside' => true));

Sometimes, when using floats, the inside-labels will not be correctly positioned as jQuery will return invalid numbers for the parent element's position; If this is the case, make sure you enclose the form in a div with position:relative to fix this issue.

See set_attributes() on how to set attributes, other than through the constructor.

The following attributes are automatically set when the control is created and should not be altered manually:
id, for
Top

method toHTML()

string toHTML ( )

Generates the control's HTML code.

This method is automatically called by the render() method!

Tags:
return: The control's HTML code
Top