ILIAS\UI\Implementation\DefaultRenderer Class Reference

Renderer that dispatches rendering of UI components to a Renderer found in the same namespace as the component to be renderered. More...

Inheritance diagram for ILIAS\UI\Implementation\DefaultRenderer:

Collaboration diagram for ILIAS\UI\Implementation\DefaultRenderer:

Public Member Functions
	__construct (Render\Loader $component_renderer_loader)
	render ($component)
	Render given component.If an array of components is passed, this method returns a concatenated output of each rendered component, in the same order as given in the array Parameters Component|Component[] $component Returns string More...
	renderAsync ($component)
	Same as render, except that this version also returns any javascript code bound to the on load event, wrapped in a script tag.All javascript code stored for rendering will be removed after this output so it will not be rendered twice if render async is called multiple times. Parameters Component|Component[] $component Returns string More...
	withAdditionalContext (Component $context)
	Get a new renderer with an additional context.A context makes it possible to use another renderer for (some) components when they are renderer as subcomponents of a certain components. The use case that spawned this functionality is the observation, that e.g. items representing repository objects are renderer in different lists, where the individual items look different every time but are morally the same item. Another use case could be a special rendering of input fields in filters over tables.If a component wants to render itself differently in different contexts, it must implement a RendererFactory. The class contains directions how to do that. Parameters Component $context Returns Renderer More...

Protected Member Functions
	getRendererFor (Component $component)
	Get a renderer for a certain Component class. More...
	getContexts ()
	Get the contexts that are added via withAdditionalContext where most recently added contexts come last. More...

Private Attributes
	$component_renderer_loader
	$contexts = []

Detailed Description

Renderer that dispatches rendering of UI components to a Renderer found in the same namespace as the component to be renderered.

Definition at line 15 of file DefaultRenderer.php.

Constructor & Destructor Documentation

__construct()

ILIAS\UI\Implementation\DefaultRenderer::__construct

(

Render\Loader

$component_renderer_loader

)

Definition at line 27 of file DefaultRenderer.php.

References ILIAS\UI\Implementation\DefaultRenderer\$component_renderer_loader.

    {
        $this->component_renderer_loader = $component_renderer_loader;
    }

Member Function Documentation

getContexts()

ILIAS\UI\Implementation\DefaultRenderer::getContexts ( )

protected

Get the contexts that are added via withAdditionalContext where most recently added contexts come last.

Returns

Component[]

Definition at line 107 of file DefaultRenderer.php.

References ILIAS\UI\Implementation\DefaultRenderer\$contexts.

Referenced by ILIAS\UI\Implementation\DefaultRenderer\getRendererFor().

    {
        return $this->contexts;
    }

Here is the caller graph for this function:

getRendererFor()

ILIAS\UI\Implementation\DefaultRenderer::getRendererFor ( Component  $component )

protected

Get a renderer for a certain Component class.

Either initializes a new renderer or uses a cached one initialized before.

Parameters

Component

$component

Exceptions

Definition at line 86 of file DefaultRenderer.php.

References ILIAS\UI\Implementation\DefaultRenderer\getContexts().

Referenced by ILIAS\UI\Implementation\DefaultRenderer\render().

    {
        return $this->component_renderer_loader->getRendererFor($component, $this->getContexts());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

render()

ILIAS\UI\Implementation\DefaultRenderer::render

(

$component

)

Render given component.If an array of components is passed, this method returns a concatenated output of each rendered component, in the same order as given in the array

Parameters

Component|Component[]

$component

Returns

string

Implements ILIAS\UI\Renderer.

Definition at line 35 of file DefaultRenderer.php.

References $out, and ILIAS\UI\Implementation\DefaultRenderer\getRendererFor().

Referenced by ILIAS\UI\Implementation\DefaultRenderer\renderAsync().

    {
        $out = '';
        if (is_array($component)) {
            foreach ($component as $_component) {
                $renderer = $this->getRendererFor($_component);
                $out .= $renderer->render($_component, $this);
            }
        } else {
            $renderer = $this->getRendererFor($component);
            $out = $renderer->render($component, $this);
        }

        return $out;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

renderAsync()

ILIAS\UI\Implementation\DefaultRenderer::renderAsync

(

$component

)

Same as render, except that this version also returns any javascript code bound to the on load event, wrapped in a script tag.All javascript code stored for rendering will be removed after this output so it will not be rendered twice if render async is called multiple times.

Parameters

Component|Component[]

$component

Returns

string

Implements ILIAS\UI\Renderer.

Definition at line 54 of file DefaultRenderer.php.

References $out, and ILIAS\UI\Implementation\DefaultRenderer\render().

    {
        $out = '';

        if (is_array($component)) {
            foreach ($component as $_component) {
                $out .= $this->render($_component) .
                $this->component_renderer_loader
                        ->getRendererFactoryFor($_component)
                        ->getJSBinding()
                        ->getOnLoadCodeAsync();
            }
        } else {
            $out =  $this->render($component) .
            $this->component_renderer_loader
                    ->getRendererFactoryFor($component)
                    ->getJSBinding()
                    ->getOnLoadCodeAsync();
        }
        return $out;
    }

Here is the call graph for this function:

withAdditionalContext()

ILIAS\UI\Implementation\DefaultRenderer::withAdditionalContext

(

Component

$context

)

Get a new renderer with an additional context.A context makes it possible to use another renderer for (some) components when they are renderer as subcomponents of a certain components. The use case that spawned this functionality is the observation, that e.g. items representing repository objects are renderer in different lists, where the individual items look different every time but are morally the same item. Another use case could be a special rendering of input fields in filters over tables.If a component wants to render itself differently in different contexts, it must implement a RendererFactory. The class contains directions how to do that.

Parameters

Component

$context

Returns

Renderer

Implements ILIAS\UI\Renderer.

Definition at line 94 of file DefaultRenderer.php.

    {
        $clone = clone $this;
        $clone->contexts[] = $context;
        return $clone;
    }

Field Documentation

$component_renderer_loader

ILIAS\UI\Implementation\DefaultRenderer::$component_renderer_loader

private

Definition at line 20 of file DefaultRenderer.php.

Referenced by ILIAS\UI\Implementation\DefaultRenderer\__construct().

$contexts

ILIAS\UI\Implementation\DefaultRenderer::$contexts = []

private

Definition at line 25 of file DefaultRenderer.php.

Referenced by ILIAS\UI\Implementation\DefaultRenderer\getContexts().

---

The documentation for this class was generated from the following file:

• src/UI/Implementation/DefaultRenderer.php