You are here

function render in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 core/includes/common.inc \render()

Renders an element.

This function renders an element. The top level element is shown with show() before rendering, so it will always be rendered even if hide() had been previously used on it.

Parameters

$element: The element to be rendered.

Return value

The rendered element.

See also

\Drupal\Core\Render\RendererInterface

show()

hide()

3 calls to render()
Field::render_item in core/modules/views/src/Plugin/views/field/Field.php
Renders a single item of a row.
shortcut_preprocess_page_title in core/modules/shortcut/shortcut.module
Implements hook_preprocess_HOOK() for page title templates.
template_preprocess_file_widget_multiple in core/modules/file/file.field.inc
Prepares variables for multi file form widget templates.
20 string references to 'render'
CacheFactoryTest::testCacheFactoryWithCustomizedDefaultBackend in core/tests/Drupal/Tests/Core/Cache/CacheFactoryTest.php
Test that the cache factory falls back to customized default service.
CacheFactoryTest::testCacheFactoryWithDefaultSettings in core/tests/Drupal/Tests/Core/Cache/CacheFactoryTest.php
Test that the cache factory falls back to the built-in default service.
CacheFactoryTest::testCacheFactoryWithSpecifiedPerBinBackend in core/tests/Drupal/Tests/Core/Cache/CacheFactoryTest.php
Test that the cache factory picks the correct per-bin service.
ClearTest::setUp in core/modules/system/src/Tests/Cache/ClearTest.php
Sets up a Drupal site for running functional and integration tests.
core.services.yml in core/core.services.yml
core/core.services.yml

... See full list

File

core/includes/common.inc, line 923
Common functions that many Drupal modules will need to reference.

Code

function render(&$element) {
  if (!$element && $element !== 0) {
    return NULL;
  }
  if (is_array($element)) {

    // Early return if this element was pre-rendered (no need to re-render).
    if (isset($element['#printed']) && $element['#printed'] == TRUE && isset($element['#markup']) && strlen($element['#markup']) > 0) {
      return $element['#markup'];
    }
    show($element);
    return \Drupal::service('renderer')
      ->render($element);
  }
  else {

    // Safe-guard for inappropriate use of render() on flat variables: return
    // the variable as-is.
    return $element;
  }
}