Grid.php

Same filename in other branches
  1. 9 core/modules/views/src/Plugin/views/style/Grid.php
  2. 10 core/modules/views/src/Plugin/views/style/Grid.php
  3. 11.x core/modules/views/src/Plugin/views/style/Grid.php

Namespace

Drupal\views\Plugin\views\style

File

core/modules/views/src/Plugin/views/style/Grid.php

View source
<?php

namespace Drupal\views\Plugin\views\style;

use Drupal\Component\Utility\Html;
use Drupal\Core\Form\FormStateInterface;

/**
 * Style plugin to render each item in a grid cell.
 *
 * @ingroup views_style_plugins
 *
 * @ViewsStyle(
 *   id = "grid",
 *   title = @Translation("Grid"),
 *   help = @Translation("Displays rows in a grid."),
 *   theme = "views_view_grid",
 *   display_types = {"normal"}
 * )
 */
class Grid extends StylePluginBase {
    
    /**
     * {@inheritdoc}
     */
    protected $usesRowPlugin = TRUE;
    
    /**
     * {@inheritdoc}
     */
    protected function defineOptions() {
        $options = parent::defineOptions();
        $options['columns'] = [
            'default' => '4',
        ];
        $options['automatic_width'] = [
            'default' => TRUE,
        ];
        $options['alignment'] = [
            'default' => 'horizontal',
        ];
        $options['col_class_custom'] = [
            'default' => '',
        ];
        $options['col_class_default'] = [
            'default' => TRUE,
        ];
        $options['row_class_custom'] = [
            'default' => '',
        ];
        $options['row_class_default'] = [
            'default' => TRUE,
        ];
        return $options;
    }
    
    /**
     * {@inheritdoc}
     */
    public function buildOptionsForm(&$form, FormStateInterface $form_state) {
        parent::buildOptionsForm($form, $form_state);
        $form['columns'] = [
            '#type' => 'number',
            '#title' => $this->t('Number of columns'),
            '#default_value' => $this->options['columns'],
            '#required' => TRUE,
            '#min' => 1,
        ];
        $form['automatic_width'] = [
            '#type' => 'checkbox',
            '#title' => $this->t('Automatic width'),
            '#description' => $this->t('The width of each column will be calculated automatically based on the number of columns provided. If additional classes are entered or a theme injects classes based on a grid system, disabling this option may prove beneficial.'),
            '#default_value' => $this->options['automatic_width'],
        ];
        $form['alignment'] = [
            '#type' => 'radios',
            '#title' => $this->t('Alignment'),
            '#options' => [
                'horizontal' => $this->t('Horizontal'),
                'vertical' => $this->t('Vertical'),
            ],
            '#default_value' => $this->options['alignment'],
            '#description' => $this->t('Horizontal alignment will place items starting in the upper left and moving right. Vertical alignment will place items starting in the upper left and moving down.'),
        ];
        $form['col_class_default'] = [
            '#title' => $this->t('Default column classes'),
            '#description' => $this->t('Add the default views column classes like views-col, col-1 and clearfix to the output. You can use this to quickly reduce the amount of markup the view provides by default, at the cost of making it more difficult to apply CSS.'),
            '#type' => 'checkbox',
            '#default_value' => $this->options['col_class_default'],
        ];
        $form['col_class_custom'] = [
            '#title' => $this->t('Custom column class'),
            '#description' => $this->t('Additional classes to provide on each column. Separated by a space.'),
            '#type' => 'textfield',
            '#default_value' => $this->options['col_class_custom'],
        ];
        if ($this->usesFields()) {
            $form['col_class_custom']['#description'] .= ' ' . $this->t('You may use field tokens from as per the "Replacement patterns" used in "Rewrite the output of this field" for all fields.');
        }
        $form['row_class_default'] = [
            '#title' => $this->t('Default row classes'),
            '#description' => $this->t('Adds the default views row classes like views-row, row-1 and clearfix to the output. You can use this to quickly reduce the amount of markup the view provides by default, at the cost of making it more difficult to apply CSS.'),
            '#type' => 'checkbox',
            '#default_value' => $this->options['row_class_default'],
        ];
        $form['row_class_custom'] = [
            '#title' => $this->t('Custom row class'),
            '#description' => $this->t('Additional classes to provide on each row. Separated by a space.'),
            '#type' => 'textfield',
            '#default_value' => $this->options['row_class_custom'],
        ];
        if ($this->usesFields()) {
            $form['row_class_custom']['#description'] .= ' ' . $this->t('You may use field tokens from as per the "Replacement patterns" used in "Rewrite the output of this field" for all fields.');
        }
    }
    
    /**
     * Return the token-replaced row or column classes for the specified result.
     *
     * @param int $result_index
     *   The delta of the result item to get custom classes for.
     * @param string $type
     *   The type of custom grid class to return, either "row" or "col".
     *
     * @return string
     *   A space-delimited string of classes.
     */
    public function getCustomClass($result_index, $type) {
        $class = $this->options[$type . '_class_custom'];
        if ($this->usesFields() && $this->view->field) {
            $class = strip_tags($this->tokenizeValue($class, $result_index));
        }
        $classes = explode(' ', $class);
        foreach ($classes as &$class) {
            $class = Html::cleanCssIdentifier($class);
        }
        return implode(' ', $classes);
    }

}

Classes

Title Deprecated Summary
Grid Style plugin to render each item in a grid cell.

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