/**
*Gets a form element instance according to the context obtained from the within the Kernel::getSAPI method
*
*@param string $type The *type* of the element, input, select, etc>
*@param ElementConfigInterface The configuration for said element.
*@param string $ui User Interface for the given element type, web, cli, etc
*/
public static function getInstanceFromUIContext($type, $ui = NULL)
{
$type = trim($type);
/**
*An element type is mandatory. This "type" is the type of element one wishes to create
*an input element, a select element, etc.
*/
if (empty($type)) {
throw new \InvalidArgumentException("Must specify element type!");
}
/**
* If no $ui is specified, autodetect the user interface through the Kernel::getSAPI object
*/
if ($ui === NULL) {
$ui = Kernel::getSAPI()->getName();
}
$class = self::getElementClassByTypeAndUI($type, $ui);
/**
* Return a new element type instance, configured with a name, a value and a layout container.
*/
return new $class();
}
/**
* Gets a form instance according to the context obtained from the within the Kernel::getSAPI method
*
* @return \apf\ui\form\Cli If the autodetected context is cli or if the $ui argument is equal to cli
* @return \apf\ui\form\Web If the autodetected context is web or if the $ui argument is equal to web
*/
public static function getInstanceFromUIContext($ui = NULL)
{
/**
* If no $ui is specified, autodetect it through the Kernel::getSAPI object
*/
if ($ui === NULL) {
$ui = Kernel::getSAPI()->getName();
}
/**
* Compose the class name
*/
$class = sprintf('\\apf\\ui\\form\\%s', ucwords($ui));
/**
* Corroborate that the given form UI class does in fact exists
*/
if (!class_exists($class)) {
throw new \InvalidArgumentException("No Form UI named \"{$ui}\" was found, perhaps you'd like to help and create it?");
}
/**
* Create a new form instance of the corresponding form considering the context
* where PHP is being called, i.e cli, web, etc
*/
return new $class();
}
