StyleTest.php in Drupal 9

Namespace

Drupal\Tests\views\Kernel\Plugin

File

core/modules/views/tests/src/Kernel/Plugin/StyleTest.php

<?php

namespace Drupal\Tests\views\Kernel\Plugin;

use Drupal\Tests\views\Kernel\ViewsKernelTestBase;
use Drupal\views\Views;
use Drupal\views_test_data\Plugin\views\row\RowTest;
use Drupal\views\Plugin\views\row\Fields;
use Drupal\views\ResultRow;
use Drupal\views_test_data\Plugin\views\style\StyleTest as StyleTestPlugin;

/**
 * Tests general style functionality.
 *
 * @group views
 *
 * @see \Drupal\views_test_data\Plugin\views\style\StyleTest.
 */
class StyleTest extends ViewsKernelTestBase {

  /**
   * {@inheritdoc}
   */
  public static $testViews = [
    'test_view',
  ];

  /**
   * Tests the general rendering of styles.
   */
  public function testStyle() {
    $renderer = $this->container
      ->get('renderer');

    // This run use the test row plugin and render with it.
    $view = Views::getView('test_view');
    $view
      ->setDisplay();
    $style = $view->display_handler
      ->getOption('style');
    $style['type'] = 'test_style';
    $view->display_handler
      ->setOption('style', $style);
    $row = $view->display_handler
      ->getOption('row');
    $row['type'] = 'test_row';
    $view->display_handler
      ->setOption('row', $row);
    $view
      ->initDisplay();
    $view
      ->initStyle();

    // Reinitialize the style as it supports row plugins now.
    $view->style_plugin
      ->init($view, $view->display_handler);
    $this
      ->assertInstanceOf(Rowtest::class, $view->rowPlugin);
    $random_text = $this
      ->randomMachineName();
    $view->rowPlugin
      ->setOutput($random_text);
    $output = $view
      ->preview();
    $output = $renderer
      ->renderRoot($output);
    $this
      ->assertStringContainsString($random_text, (string) $output);

    // Test without row plugin support.
    $view = Views::getView('test_view');
    $view
      ->setDisplay();
    $style = $view->display_handler
      ->getOption('style');
    $style['type'] = 'test_style';
    $view->display_handler
      ->setOption('style', $style);
    $view
      ->initDisplay();
    $view
      ->initStyle();
    $view->style_plugin
      ->setUsesRowPlugin(FALSE);
    $this
      ->assertInstanceOf(StyleTestPlugin::class, $view->style_plugin);
    $this
      ->assertInstanceOf(Fields::class, $view->rowPlugin);
    $random_text = $this
      ->randomMachineName();

    // Set some custom text to the output and make sure that this value is
    // rendered.
    $view->style_plugin
      ->setOutput($random_text);
    $output = $view
      ->preview();
    $output = $renderer
      ->renderRoot($output);
    $this
      ->assertStringContainsString($random_text, (string) $output);
  }

  /**
   * Tests the grouping features of styles.
   */
  public function testGrouping() {
    $this
      ->doTestGrouping(FALSE);
    $this
      ->doTestGrouping(TRUE);
  }

  /**
   * Provides reusable code for ::testGrouping().
   */
  protected function doTestGrouping($stripped = FALSE) {
    $view = Views::getView('test_view');
    $view
      ->setDisplay();

    // Setup grouping by the job and the age field.
    $view
      ->initStyle();
    $view->style_plugin->options['grouping'] = [
      [
        'field' => 'job',
      ],
      [
        'field' => 'age',
      ],
    ];

    // Reduce the amount of items to make the test a bit easier.
    // Set up the pager.
    $view->displayHandlers
      ->get('default')
      ->overrideOption('pager', [
      'type' => 'some',
      'options' => [
        'items_per_page' => 3,
      ],
    ]);

    // Add the job and age field.
    $fields = [
      'name' => [
        'id' => 'name',
        'table' => 'views_test_data',
        'field' => 'name',
        'relationship' => 'none',
        'label' => 'Name',
      ],
      'job' => [
        'id' => 'job',
        'table' => 'views_test_data',
        'field' => 'job',
        'relationship' => 'none',
        'label' => 'Job',
      ],
      'age' => [
        'id' => 'age',
        'table' => 'views_test_data',
        'field' => 'age',
        'relationship' => 'none',
        'label' => 'Age',
      ],
    ];
    $view->displayHandlers
      ->get('default')
      ->overrideOption('fields', $fields);

    // Now run the query and groupby the result.
    $this
      ->executeView($view);
    $expected = [];
    $expected['Job: Singer'] = [];
    $expected['Job: Singer']['group'] = 'Job: Singer';
    $expected['Job: Singer']['level'] = 0;
    $expected['Job: Singer']['rows']['Age: 25'] = [];
    $expected['Job: Singer']['rows']['Age: 25']['group'] = 'Age: 25';
    $expected['Job: Singer']['rows']['Age: 25']['level'] = 1;
    $expected['Job: Singer']['rows']['Age: 25']['rows'][0] = new ResultRow([
      'index' => 0,
    ]);
    $expected['Job: Singer']['rows']['Age: 25']['rows'][0]->views_test_data_name = 'John';
    $expected['Job: Singer']['rows']['Age: 25']['rows'][0]->views_test_data_job = 'Singer';
    $expected['Job: Singer']['rows']['Age: 25']['rows'][0]->views_test_data_age = '25';
    $expected['Job: Singer']['rows']['Age: 25']['rows'][0]->views_test_data_id = '1';
    $expected['Job: Singer']['rows']['Age: 27'] = [];
    $expected['Job: Singer']['rows']['Age: 27']['group'] = 'Age: 27';
    $expected['Job: Singer']['rows']['Age: 27']['level'] = 1;
    $expected['Job: Singer']['rows']['Age: 27']['rows'][1] = new ResultRow([
      'index' => 1,
    ]);
    $expected['Job: Singer']['rows']['Age: 27']['rows'][1]->views_test_data_name = 'George';
    $expected['Job: Singer']['rows']['Age: 27']['rows'][1]->views_test_data_job = 'Singer';
    $expected['Job: Singer']['rows']['Age: 27']['rows'][1]->views_test_data_age = '27';
    $expected['Job: Singer']['rows']['Age: 27']['rows'][1]->views_test_data_id = '2';
    $expected['Job: Drummer'] = [];
    $expected['Job: Drummer']['group'] = 'Job: Drummer';
    $expected['Job: Drummer']['level'] = 0;
    $expected['Job: Drummer']['rows']['Age: 28'] = [];
    $expected['Job: Drummer']['rows']['Age: 28']['group'] = 'Age: 28';
    $expected['Job: Drummer']['rows']['Age: 28']['level'] = 1;
    $expected['Job: Drummer']['rows']['Age: 28']['rows'][2] = new ResultRow([
      'index' => 2,
    ]);
    $expected['Job: Drummer']['rows']['Age: 28']['rows'][2]->views_test_data_name = 'Ringo';
    $expected['Job: Drummer']['rows']['Age: 28']['rows'][2]->views_test_data_job = 'Drummer';
    $expected['Job: Drummer']['rows']['Age: 28']['rows'][2]->views_test_data_age = '28';
    $expected['Job: Drummer']['rows']['Age: 28']['rows'][2]->views_test_data_id = '3';

    // Alter the results to support the stripped case.
    if ($stripped) {

      // Add some html to the result and expected value.
      $rand1 = '<a data="' . $this
        ->randomMachineName() . '" />';
      $view->result[0]->views_test_data_job .= $rand1;
      $expected['Job: Singer']['rows']['Age: 25']['rows'][0]->views_test_data_job = 'Singer' . $rand1;
      $expected['Job: Singer']['group'] = 'Job: Singer';
      $rand2 = '<a data="' . $this
        ->randomMachineName() . '" />';
      $view->result[1]->views_test_data_job .= $rand2;
      $expected['Job: Singer']['rows']['Age: 27']['rows'][1]->views_test_data_job = 'Singer' . $rand2;
      $rand3 = '<a data="' . $this
        ->randomMachineName() . '" />';
      $view->result[2]->views_test_data_job .= $rand3;
      $expected['Job: Drummer']['rows']['Age: 28']['rows'][2]->views_test_data_job = 'Drummer' . $rand3;
      $expected['Job: Drummer']['group'] = 'Job: Drummer';
      $view->style_plugin->options['grouping'][0] = [
        'field' => 'job',
        'rendered' => TRUE,
        'rendered_strip' => TRUE,
      ];
      $view->style_plugin->options['grouping'][1] = [
        'field' => 'age',
        'rendered' => TRUE,
        'rendered_strip' => TRUE,
      ];
    }

    // The newer api passes the value of the grouping as well.
    $sets_new_rendered = $view->style_plugin
      ->renderGrouping($view->result, $view->style_plugin->options['grouping'], TRUE);
    $this
      ->assertEquals($expected, $sets_new_rendered);

    // Don't test stripped case, because the actual value is not stripped.
    if (!$stripped) {
      $sets_new_value = $view->style_plugin
        ->renderGrouping($view->result, $view->style_plugin->options['grouping'], FALSE);

      // Reorder the group structure to grouping by value.
      $new_expected = $expected;
      $new_expected['Singer'] = $expected['Job: Singer'];
      $new_expected['Singer']['rows']['25'] = $expected['Job: Singer']['rows']['Age: 25'];
      $new_expected['Singer']['rows']['27'] = $expected['Job: Singer']['rows']['Age: 27'];
      $new_expected['Drummer'] = $expected['Job: Drummer'];
      $new_expected['Drummer']['rows']['28'] = $expected['Job: Drummer']['rows']['Age: 28'];
      unset($new_expected['Job: Singer']);
      unset($new_expected['Singer']['rows']['Age: 25']);
      unset($new_expected['Singer']['rows']['Age: 27']);
      unset($new_expected['Job: Drummer']);
      unset($new_expected['Drummer']['rows']['Age: 28']);
      $this
        ->assertEquals($new_expected, $sets_new_value);
    }

    // Test that grouping works on fields having no label.
    $fields['job']['label'] = '';
    $view
      ->destroy();
    $view
      ->setDisplay();
    $view
      ->initStyle();
    $view->displayHandlers
      ->get('default')
      ->overrideOption('fields', $fields);
    $view->style_plugin->options['grouping'] = [
      [
        'field' => 'job',
      ],
      [
        'field' => 'age',
      ],
    ];
    $this
      ->executeView($view);
    if ($stripped) {
      $view->result[0]->views_test_data_job .= $rand1;
      $view->result[1]->views_test_data_job .= $rand2;
      $view->result[2]->views_test_data_job .= $rand3;
      $view->style_plugin->options['grouping'][0] = [
        'field' => 'job',
        'rendered' => TRUE,
        'rendered_strip' => TRUE,
      ];
      $view->style_plugin->options['grouping'][1] = [
        'field' => 'age',
        'rendered' => TRUE,
        'rendered_strip' => TRUE,
      ];
    }
    $sets_new_rendered = $view->style_plugin
      ->renderGrouping($view->result, $view->style_plugin->options['grouping'], TRUE);

    // Remove labels from expected results.
    foreach ($expected as $job => $data) {
      unset($expected[$job]);
      $job = str_replace('Job: ', '', $job);
      $data['group'] = $job;
      $expected[$job] = $data;
    }
    $this
      ->assertEquals($expected, $sets_new_rendered);
  }

  /**
   * Tests custom CSS row classes.
   */
  public function testCustomRowClasses() {
    $view = Views::getView('test_view');
    $view
      ->setDisplay();

    // Setup some random css class.
    $view
      ->initStyle();
    $random_name = $this
      ->randomMachineName();
    $view->style_plugin->options['row_class'] = $random_name . " test-token-{{ name }}";
    $output = $view
      ->preview();
    $html_dom = $this
      ->getHtmlDom($this->container
      ->get('renderer')
      ->renderRoot($output));
    $rows = $html_dom->body->div->div;
    $count = 0;
    foreach ($rows as $row) {
      $attributes = $row
        ->attributes();
      $class = (string) $attributes['class'][0];
      $this
        ->assertStringContainsString($random_name, $class);

      // Check token replacement.
      $name = $view->field['name']
        ->getValue($view->result[$count]);
      $this
        ->assertStringContainsString("test-token-{$name}", $class);
      $count++;
    }
  }

  /**
   * Returns a view output as SimpleXMLElement.
   *
   * @return \SimpleXMLElement|null
   *   The HTML DOM.
   */
  protected function getHtmlDom($output) {
    $html_dom = new \DOMDocument();
    @$html_dom
      ->loadHTML($output);
    if ($html_dom) {

      // It's much easier to work with simplexml than DOM, luckily enough
      // we can just simply import our DOM tree.
      return simplexml_import_dom($html_dom);
    }
    return NULL;
  }

}

Classes

Name	Description
StyleTest	Tests general style functionality.