Joomla! Documentation™

Description

Loads a element type

<! removed transcluded page call, red link never existed >

Syntax

& loadElement($type, $new=false)

Parameter Name	Default Value	Description
$type		elementType
$new	false

Returns

object

Defined in

libraries/joomla/html/parameter.php

Importing

jimport( 'joomla.html.parameter' );

Source Body

function &loadElement( $type, $new = false )
{
        $false = false;
        $signature = md5( $type  );

        if( (isset( $this->_elements[$signature] ) && !is_a($this->_elements[$signature], '__PHP_Incomplete_Class'))  && $new === false ) {
                return  $this->_elements[$signature];
        }

        $elementClass   =       'JElement'.$type;
        if( !class_exists( $elementClass ) )
        {
                if( isset( $this->_elementPath ) ) {
                        $dirs = $this->_elementPath;
                } else {
                        $dirs = array();
                }

                $file = JFilterInput::clean(str_replace('_', DS, $type).'.php', 'path');

                jimport('joomla.filesystem.path');
                if ($elementFile = JPath::find($dirs, $file)) {
                        include_once $elementFile;
                } else {
                        return $false;
                }
        }

        if( !class_exists( $elementClass ) ) {
                return $false;
        }

        $this->_elements[$signature] = new $elementClass($this);

        return $this->_elements[$signature];
}

<! removed transcluded page call, red link never existed >