Class: HTML_QuickForm2_Rule_Callback

Source Location: /HTML_QuickForm2-2.0.0RC1/HTML/QuickForm2/Rule/Callback.php

Class Overview

HTML_QuickForm2_Rule
   |
   --HTML_QuickForm2_Rule_Callback

Rule checking the value via a callback function (method)

Author(s):

Bertrand Mansion <golgote at mamasam.com>
Alexey Borzov <avb at php.net>

Version:

Release: 2.0.0RC1

Child classes:

HTML_QuickForm2_Rule_NotCallback: Rule checking the value via a callback function (method) with logical negation

Inherited Variables

Class: HTML_QuickForm2_Rule

HTML_QuickForm2_Rule::$chainedRules
HTML_QuickForm2_Rule::$config
HTML_QuickForm2_Rule::$message
HTML_QuickForm2_Rule::$owner

Inherited Methods

Class: HTML_QuickForm2_Rule

HTML_QuickForm2_Rule::__construct(): Class constructor
HTML_QuickForm2_Rule::and_(): Adds a rule to the chain with an "and" operator
HTML_QuickForm2_Rule::getConfig(): Returns the rule's configuration data
HTML_QuickForm2_Rule::getJavascript(): Returns the client-side representation of the Rule
HTML_QuickForm2_Rule::getJavascriptCallback(): Returns the client-side validation callback
HTML_QuickForm2_Rule::getJavascriptTriggers(): Returns IDs of form fields that should trigger "live" Javascript validation
HTML_QuickForm2_Rule::getMessage(): Returns the error message output by the rule
HTML_QuickForm2_Rule::getOwnJavascriptTriggers(): Returns IDs of form fields that should trigger "live" Javascript validation
HTML_QuickForm2_Rule::mergeConfig(): Merges local configuration with that provided for registerRule()
HTML_QuickForm2_Rule::or_(): Adds a rule to the chain with an "or" operator
HTML_QuickForm2_Rule::setConfig(): Sets configuration data for the rule
HTML_QuickForm2_Rule::setMessage(): Sets the error message output by the rule
HTML_QuickForm2_Rule::setOwner(): Sets the element that will be validated by this rule
HTML_QuickForm2_Rule::setOwnerError(): Sets the error message on the owner element
HTML_QuickForm2_Rule::validate(): Performs validation
HTML_QuickForm2_Rule::validateOwner(): Validates the owner element

Class Details

[line 90]
Rule checking the value via a callback function (method)

The Rule needs a valid callback as a configuration parameter for its work, it may also be given additional arguments to pass to the callback alongside the element's value. See mergeConfig() for description of possible ways to pass configuration parameters.

The callback will be called with element's value as the first argument, if additional arguments were provided they'll be passed as well. It is expected to return false if the value is invalid and true if it is valid.

Checking that the value is not empty:

 $str->addRule('callback', 'The field should not be empty', 'strlen');

Checking that the value is in the given array:

 $meta->addRule('callback', 'Unknown variable name',
                array('callback' => 'in_array',
                      'arguments' => array(array('foo', 'bar', 'baz'))));

The same, but with rule registering first:

 HTML_QuickForm2_Factory::registerRule(
     'in_array', 'HTML_QuickForm2_Rule_Callback',
     'HTML/QuickForm2/Rule/Callback.php', 'in_array'
 );
 $meta->addRule('in_array', 'Unknown variable name', array(array('foo', 'bar', 'baz')));

Author: Bertrand Mansion <golgote@mamasam.com>
Author: Alexey Borzov <avb@php.net>
Version: Release: 2.0.0RC1
Link: http://pear.php.net/package/HTML_QuickForm2
License: New BSD License

[ Top ]

Method Detail

arrayHasSomeKeys [line 169]

bool arrayHasSomeKeys(
mixed
$search, 
$keys)

Tests whether a given value is an array containing at least one of the given keys

Access: protected

Parameters:

mixed	`$search`	—	if not an array, method will return false
array	`$keys`	—	keys to test for

[ Top ]

findJavascriptName [line 135]

string findJavascriptName(
)

Finds a name for Javascript callback function

The method first checks whether javascript callback 'js_callback' was provided to the Rule and returns that if found.

If an explicit 'js_callback' was not provided, it tries to generate a name equal (for a given value of "equal") to PHP callback name. This may be useful if e.g. using HTML_AJAX package to generate class stubs in JS and in similar circumstances.

If a callback does not have a name (it is a lambda function or a closure) then an exception will be raised.

Access: protected

[ Top ]

getJavascriptCallback [line 106]

void getJavascriptCallback(
)

Access: protected

Overridden in child classes as:

HTML_QuickForm2_Rule_NotCallback::getJavascriptCallback()

Overrides HTML_QuickForm2_Rule::getJavascriptCallback() (Returns the client-side validation callback)

[ Top ]

mergeConfig [line 204]

mixed mergeConfig(
mixed
$localConfig, mixed
$globalConfig)

Merges local configuration with that provided for registerRule()

"Global" configuration may be passed to HTML_QuickForm2_Factory::registerRule() in either of the following formats

callback
array(['callback' => callback][, 'arguments' => array(...)][, 'js_callback' => string])

"Local" configuration may be passed to the constructor in either of the following formats

callback or arguments (interpretation depends on whether the global configuration already contains the callback)
array(['callback' => callback][, 'arguments' => array(...)][, 'js_callback' => string])

As usual, global config overrides local one. It is a good idea to use the associative array format to prevent ambiguity.

Return: Merged configuration
Access: public

Overrides HTML_QuickForm2_Rule::mergeConfig() (Merges local configuration with that provided for registerRule())

Parameters:

mixed	`$localConfig`	—	Local configuration
mixed	`$globalConfig`	—	Global configuration

[ Top ]

setConfig [line 236]

HTML_QuickForm2_Rule setConfig(
callback|array
$config)

Sets the callback to use for validation and its additional arguments

Throws: HTML_QuickForm2_InvalidArgumentException if callback is missing or invalid or additional arguments is not an array
Access: public

Overrides HTML_QuickForm2_Rule::setConfig() (Sets configuration data for the rule)

Parameters:

callback|array $config — Callback or array ('callback' => validation callback [, 'arguments' => additional arguments] [, 'js_callback' => javascript callback for client-side validation])

[ Top ]

validateOwner [line 97]

bool validateOwner(
)

Validates the owner element

Return: the value returned by a callback function
Access: protected

Overridden in child classes as:

HTML_QuickForm2_Rule_NotCallback::validateOwner(): Validates the owner element

Overrides HTML_QuickForm2_Rule::validateOwner() (Validates the owner element)

[ Top ]