function show

Same name in other branches
  1. 7.x includes/common.inc \show()
  2. 9 core/includes/common.inc \show()
  3. 10 core/includes/common.inc \show()
  4. 11.x core/includes/common.inc \show()

Shows a hidden element for later rendering.

You can also use render($element), which shows the element while rendering it.

The first time render() or drupal_render() is called on an element tree, as each element in the tree is rendered, it is marked with a #printed flag and the rendered children of the element are cached. Subsequent calls to render() or drupal_render() will not traverse the child tree of this element again: they will just use the cached children. So if you want to show an element, be sure to call show() on the element before its parent tree is rendered for the first time, as it will have no effect on subsequent renderings of the parent tree.

Parameters

$element: The element to be shown.

Return value

The element.

See also

render()

hide()

2 calls to show()
render in core/includes/common.inc
Renders an element.
template_preprocess_file_widget_multiple in core/modules/file/file.field.inc
Prepares variables for multi file form widget templates.
10 string references to 'show'
DisplayPluginBase::optionsSummary in core/modules/views/src/Plugin/views/display/DisplayPluginBase.php
Provides the default summary for options in the views UI.
Node::buildFilters in core/modules/node/src/Plugin/views/wizard/Node.php
Overrides Drupal\views\Plugin\views\wizard\WizardPluginBase::buildFilters().
Node::defaultDisplayFiltersUser in core/modules/node/src/Plugin/views/wizard/Node.php
Retrieves filter information based on user input for the default display.
NodeRevision::defaultDisplayFiltersUser in core/modules/node/src/Plugin/views/wizard/NodeRevision.php
Retrieves filter information based on user input for the default display.
ViewAddForm::form in core/modules/views_ui/src/ViewAddForm.php
Gets the actual form array to be built.

... See full list

File

core/includes/common.inc, line 934

Code

function show(&$element) {
    $element['#printed'] = FALSE;
    return $element;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.