function template_preprocess_views_view_fields

Same name in other branches
  1. 9 core/modules/views/views.theme.inc \template_preprocess_views_view_fields()
  2. 8.9.x core/modules/views/views.theme.inc \template_preprocess_views_view_fields()
  3. 10 core/modules/views/views.theme.inc \template_preprocess_views_view_fields()

Prepares variables for views fields templates.

Default template: views-view-fields.html.twig.

Parameters

array $variables: An associative array containing:

  • view: The view object.
  • options: An array of options. Each option contains:
    • inline: An array that contains the fields that are to be displayed inline.
    • default_field_elements: If default field wrapper elements are to be provided.
    • hide_empty: Whether the field is to be hidden if empty.
    • element_default_classes: If the default classes are to be added.
    • separator: A string to be placed between inline fields to keep them visually distinct.
  • row: An array containing information about the current row.

File

core/modules/views/views.theme.inc, line 91

Code

function template_preprocess_views_view_fields(&$variables) {
    $view = $variables['view'];
    // Loop through the fields for this view.
    $previous_inline = FALSE;
    // Ensure it's at least an empty array.
    $variables['fields'] = [];
    
    /** @var \Drupal\views\ResultRow $row */
    $row = $variables['row'];
    foreach ($view->field as $id => $field) {
        // Render this even if set to exclude so it can be used elsewhere.
        $field_output = $view->style_plugin
            ->getField($row->index, $id);
        $empty = $field->isValueEmpty($field_output, $field->options['empty_zero']);
        if (empty($field->options['exclude']) && (!$empty || empty($field->options['hide_empty']) && empty($variables['options']['hide_empty']))) {
            $object = new stdClass();
            $object->handler = $view->field[$id];
            $object->inline = !empty($variables['options']['inline'][$id]);
            // Set up default value of the flag that indicates whether to display a
            // colon after the label.
            $object->has_label_colon = FALSE;
            $object->element_type = $object->handler
                ->elementType(TRUE, !$variables['options']['default_field_elements'], $object->inline);
            if ($object->element_type) {
                $attributes = [];
                if ($object->handler->options['element_default_classes']) {
                    $attributes['class'][] = 'field-content';
                }
                if ($classes = $object->handler
                    ->elementClasses($row->index)) {
                    $attributes['class'][] = $classes;
                }
                $object->element_attributes = new Attribute($attributes);
            }
            $object->content = $field_output;
            if (isset($view->field[$id]->field_alias) && isset($row->{$view->field[$id]->field_alias})) {
                $object->raw = $row->{$view->field[$id]->field_alias};
            }
            else {
                // Make sure it exists to reduce NOTICE.
                $object->raw = NULL;
            }
            if (!empty($variables['options']['separator']) && $previous_inline && $object->inline && $object->content) {
                $object->separator = [
                    '#markup' => $variables['options']['separator'],
                ];
            }
            $object->class = Html::cleanCssIdentifier($id);
            $previous_inline = $object->inline;
            // Set up field wrapper element.
            $object->wrapper_element = $object->handler
                ->elementWrapperType(TRUE, TRUE);
            if ($object->wrapper_element === '' && $variables['options']['default_field_elements']) {
                $object->wrapper_element = $object->inline ? 'span' : 'div';
            }
            // Set up field wrapper attributes if field wrapper was set.
            if ($object->wrapper_element) {
                $attributes = [];
                if ($object->handler->options['element_default_classes']) {
                    $attributes['class'][] = 'views-field';
                    $attributes['class'][] = 'views-field-' . $object->class;
                }
                if ($classes = $object->handler
                    ->elementWrapperClasses($row->index)) {
                    $attributes['class'][] = $classes;
                }
                $object->wrapper_attributes = new Attribute($attributes);
            }
            // Set up field label
            $object->label = $view->field[$id]
                ->label();
            // Set up field label wrapper and its attributes.
            if ($object->label) {
                // Add a colon in a label suffix.
                if ($object->handler->options['element_label_colon']) {
                    $object->label_suffix = ': ';
                    $object->has_label_colon = TRUE;
                }
                // Set up label HTML element.
                $object->label_element = $object->handler
                    ->elementLabelType(TRUE, !$variables['options']['default_field_elements']);
                // Set up label attributes.
                if ($object->label_element) {
                    $attributes = [];
                    if ($object->handler->options['element_default_classes']) {
                        $attributes['class'][] = 'views-label';
                        $attributes['class'][] = 'views-label-' . $object->class;
                    }
                    // Set up field label.
                    $element_label_class = $object->handler
                        ->elementLabelClasses($row->index);
                    if ($element_label_class) {
                        $attributes['class'][] = $element_label_class;
                    }
                    $object->label_attributes = new Attribute($attributes);
                }
            }
            $variables['fields'][$id] = $object;
        }
    }
}

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