JFormHelper
JForm's helper class.
Provides a storage for filesystem's paths where JForm's entities reside and methods for creating those entities. Also stores objects with entities' prototypes for further reusing.
package |
Joomla.Platform |
---|---|
subpackage |
Form |
since |
11.1 |
Methods
addFieldPath
Method to add a path to the list of field include paths.
addFieldPath(mixed $new = null) : array
since |
11.1 |
---|
Arguments
- $new
mixed
A path or array of paths to add.
Response
array
The list of paths that have been added.
addFormPath
Method to add a path to the list of form include paths.
addFormPath(mixed $new = null) : array
since |
11.1 |
---|
Arguments
- $new
mixed
A path or array of paths to add.
Response
array
The list of paths that have been added.
addPath
Method to add a path to the list of include paths for one of the form's entities.
addPath(string $entity, mixed $new = null) : array
Currently supported entities: field, rule and form. You are free to support your own in a subclass.
since |
11.1 |
---|
Arguments
- $entity
string
Form's entity name for which paths will be added.- $new
mixed
A path or array of paths to add.
Response
array
The list of paths that have been added.
addRulePath
Method to add a path to the list of rule include paths.
addRulePath(mixed $new = null) : array
since |
11.1 |
---|
Arguments
- $new
mixed
A path or array of paths to add.
Response
array
The list of paths that have been added.
loadClass
Load a class for one of the form's entities of a particular type.
loadClass(string $entity, string $type) : mixed
Currently, it makes sense to use this method for the "field" and "rule" entities (but you can support more entities in your subclass).
since |
11.1 |
---|
Arguments
- $entity
string
One of the form entities (field or rule).- $type
string
Type of an entity.
Response
mixed
Class name on success or false otherwise.
loadFieldClass
Attempt to import the JFormField class file if it isn't already imported.
loadFieldClass(string $type) : mixed
You can use this method outside of JForm for loading a field for inheritance or composition.
since |
11.1 |
---|
Arguments
- $type
string
Type of a field whose class should be loaded.
Response
mixed
Class name on success or false otherwise.
loadFieldType
Method to load a form field object given a type.
loadFieldType(string $type, boolean $new = true) : mixed
since |
11.1 |
---|
Arguments
- $type
string
The field type.- $new
boolean
Flag to toggle whether we should get a new instance of the object.
Response
mixed
JFormField object on success, false otherwise.
loadRuleClass
Attempt to import the JFormRule class file if it isn't already imported.
loadRuleClass(string $type) : mixed
You can use this method outside of JForm for loading a rule for inheritance or composition.
since |
11.1 |
---|
Arguments
- $type
string
Type of a rule whose class should be loaded.
Response
mixed
Class name on success or false otherwise.
loadRuleType
Method to load a form rule object given a type.
loadRuleType(string $type, boolean $new = true) : mixed
since |
11.1 |
---|
Arguments
- $type
string
The rule type.- $new
boolean
Flag to toggle whether we should get a new instance of the object.
Response
mixed
JFormRule object on success, false otherwise.
loadType
Method to load a form entity object given a type.
loadType(string $entity, string $type, boolean $new = true) : mixed
Each type is loaded only once and then used as a prototype for other objects of same type. Please, use this method only with those entities which support types (forms don't support them).
since |
11.1 |
---|
Arguments
- $entity
string
The entity.- $type
string
The entity type.- $new
boolean
Flag to toggle whether we should get a new instance of the object.
Response
mixed
Entity object on success, false otherwise.
Properties
paths
Array with paths where entities(field, rule, form) can be found.
Array's structure:
paths:
{ENTITY_NAME}:
- /path/1
- /path/2
since |
11.1 |
---|
Type(s)
array
entities
Static array of JForm's entity objects for re-use.
Prototypes for all fields and rules are here.
Array's structure:
entities:
{ENTITY_NAME}:
{KEY}: {OBJECT}
since |
11.1 |
---|
Type(s)
array