
| Current Path : /var/www/html/rocksensor2/web/core/modules/views/tests/src/Functional/Plugin/ |
Linux ift1.ift-informatik.de 5.4.0-216-generic #236-Ubuntu SMP Fri Apr 11 19:53:21 UTC 2025 x86_64 |
| Current File : /var/www/html/rocksensor2/web/core/modules/views/tests/src/Functional/Plugin/ExposedFormTest.php |
<?php
declare(strict_types=1);
namespace Drupal\Tests\views\Functional\Plugin;
use Drupal\Component\Utility\Html;
use Drupal\entity_test\Entity\EntityTest;
use Drupal\Tests\system\Functional\Cache\AssertPageCacheContextsAndTagsTrait;
use Drupal\Tests\views\Functional\ViewTestBase;
use Drupal\views\ViewExecutable;
use Drupal\views\Views;
use Drupal\views\Entity\View;
use Drupal\views\Plugin\views\filter\FilterPluginBase;
/**
* Tests exposed forms functionality.
*
* @group views
* @group #slow
*/
class ExposedFormTest extends ViewTestBase {
use AssertPageCacheContextsAndTagsTrait;
/**
* Views used by this test.
*
* @var array
*/
public static $testViews = ['test_exposed_form_buttons', 'test_exposed_block', 'test_exposed_form_sort_items_per_page', 'test_exposed_form_pager', 'test_remember_selected'];
/**
* {@inheritdoc}
*/
protected static $modules = ['node', 'views_ui', 'block', 'entity_test'];
/**
* {@inheritdoc}
*/
protected $defaultTheme = 'starterkit_theme';
/**
* Nodes to test.
*
* @var \Drupal\node\NodeInterface[]
*/
protected $nodes = [];
/**
* {@inheritdoc}
*/
protected function setUp($import_test_views = TRUE, $modules = ['views_test_config']): void {
parent::setUp($import_test_views, $modules);
$this->enableViewsTestModule();
$this->drupalCreateContentType(['type' => 'article']);
$this->drupalCreateContentType(['type' => 'page']);
$this->nodes = [];
// Create some random nodes.
for ($i = 0; $i < 5; $i++) {
$this->nodes[] = $this->drupalCreateNode(['type' => 'article']);
$this->nodes[] = $this->drupalCreateNode(['type' => 'page']);
}
}
/**
* Tests the submit button.
*/
public function testSubmitButton(): void {
// Test the submit button value defaults to 'Apply'.
$this->drupalGet('test_exposed_form_buttons');
$this->assertSession()->statusCodeEquals(200);
$this->helperButtonHasLabel('edit-submit-test-exposed-form-buttons', 'Apply');
// Rename the label of the submit button.
$view = Views::getView('test_exposed_form_buttons');
$view->setDisplay();
$exposed_form = $view->display_handler->getOption('exposed_form');
$exposed_form['options']['submit_button'] = $expected_label = $this->randomMachineName();
$view->display_handler->setOption('exposed_form', $exposed_form);
$view->save();
// Make sure the submit button label changed.
$this->drupalGet('test_exposed_form_buttons');
$this->helperButtonHasLabel('edit-submit-test-exposed-form-buttons', $expected_label);
// Make sure an empty label uses the default 'Apply' button value too.
$view = Views::getView('test_exposed_form_buttons');
$view->setDisplay();
$exposed_form = $view->display_handler->getOption('exposed_form');
$exposed_form['options']['submit_button'] = '';
$view->display_handler->setOption('exposed_form', $exposed_form);
$view->save();
// Make sure the submit button label shows 'Apply'.
$this->drupalGet('test_exposed_form_buttons');
$this->helperButtonHasLabel('edit-submit-test-exposed-form-buttons', 'Apply');
}
/**
* Tests the exposed form with a non-standard identifier.
*/
public function testExposedIdentifier(): void {
// Alter the identifier of the filter to a random string.
$view = Views::getView('test_exposed_form_buttons');
$view->setDisplay();
$identifier = 'new_identifier';
$view->displayHandlers->get('default')->overrideOption('filters', [
'type' => [
'exposed' => TRUE,
'field' => 'type',
'id' => 'type',
'table' => 'node_field_data',
'plugin_id' => 'in_operator',
'entity_type' => 'node',
'entity_field' => 'type',
'expose' => [
'identifier' => $identifier,
'label' => 'Content: Type',
'operator_id' => 'type_op',
'reduce' => FALSE,
'description' => 'Exposed overridden description',
],
],
]);
$view->save();
$this->drupalGet('test_exposed_form_buttons', ['query' => [$identifier => 'article']]);
$this->assertSession()->fieldValueEquals(Html::getId('edit-' . $identifier), 'article');
// Alter the identifier of the filter to a random string containing
// restricted characters.
$view = Views::getView('test_exposed_form_buttons');
$view->setDisplay();
$identifier = 'bad identifier';
$view->displayHandlers->get('default')->overrideOption('filters', [
'type' => [
'exposed' => TRUE,
'field' => 'type',
'id' => 'type',
'table' => 'node_field_data',
'plugin_id' => 'in_operator',
'entity_type' => 'node',
'entity_field' => 'type',
'expose' => [
'identifier' => $identifier,
'label' => 'Content: Type',
'operator_id' => 'type_op',
'reduce' => FALSE,
'description' => 'Exposed overridden description',
],
],
]);
$this->executeView($view);
$errors = $view->validate();
$expected = [
'default' => ['This identifier has illegal characters.'],
'page_1' => ['This identifier has illegal characters.'],
];
$this->assertEquals($expected, $errors);
foreach (FilterPluginBase::RESTRICTED_IDENTIFIERS as $restricted_identifier) {
$view = Views::getView('test_exposed_form_buttons');
$view->setDisplay();
$view->displayHandlers->get('default')->overrideOption('filters', [
'type' => [
'exposed' => TRUE,
'field' => 'type',
'id' => 'type',
'table' => 'node_field_data',
'plugin_id' => 'in_operator',
'entity_type' => 'node',
'entity_field' => 'type',
'expose' => [
'identifier' => $restricted_identifier,
'label' => 'Content: Type',
'operator_id' => 'type_op',
'reduce' => FALSE,
'description' => 'Exposed overridden description',
],
],
]);
$this->executeView($view);
$errors = $view->validate();
$expected = [
'default' => ['This identifier is not allowed.'],
'page_1' => ['This identifier is not allowed.'],
];
$this->assertEquals($expected, $errors);
}
}
/**
* Tests whether the reset button works on an exposed form.
*/
public function testResetButton(): void {
// Test the button is hidden when there is no exposed input.
$this->drupalGet('test_exposed_form_buttons');
$this->assertSession()->fieldNotExists('edit-reset');
$this->drupalGet('test_exposed_form_buttons', ['query' => ['type' => 'article']]);
// Test that the type has been set.
$this->assertSession()->fieldValueEquals('edit-type', 'article');
// Test the reset works.
$this->drupalGet('test_exposed_form_buttons', ['query' => ['op' => 'Reset']]);
$this->assertSession()->statusCodeEquals(200);
// Test the type has been reset.
$this->assertSession()->fieldValueEquals('edit-type', 'All');
// Test the button is hidden after reset.
$this->assertSession()->fieldNotExists('edit-reset');
// Test the reset works with type set.
$this->drupalGet('test_exposed_form_buttons', ['query' => ['type' => 'article', 'op' => 'Reset']]);
$this->assertSession()->statusCodeEquals(200);
$this->assertSession()->fieldValueEquals('edit-type', 'All');
// Test the button is hidden after reset.
$this->assertSession()->fieldNotExists('edit-reset');
// Rename the label of the reset button.
$view = Views::getView('test_exposed_form_buttons');
$view->setDisplay();
$exposed_form = $view->display_handler->getOption('exposed_form');
$exposed_form['options']['reset_button_label'] = $expected_label = $this->randomMachineName();
$exposed_form['options']['reset_button'] = TRUE;
$view->display_handler->setOption('exposed_form', $exposed_form);
$view->save();
// Look whether the reset button label changed.
$this->drupalGet('test_exposed_form_buttons', ['query' => ['type' => 'article']]);
$this->assertSession()->statusCodeEquals(200);
$this->helperButtonHasLabel('edit-reset', $expected_label);
}
/**
* Tests the exposed block functionality.
*
* @dataProvider providerTestExposedBlock
*/
public function testExposedBlock($display): void {
$view = Views::getView('test_exposed_block');
$view->setDisplay($display);
$block = $this->drupalPlaceBlock('views_exposed_filter_block:test_exposed_block-' . $display);
// Set label to display on the exposed filter form block.
$block->getPlugin()->setConfigurationValue('label_display', TRUE);
$block->save();
// Assert that the only two occurrences of `$view->getTitle()` are the title
// and h2 tags.
$this->drupalGet('test_exposed_block');
$this->assertSession()->elementContains('css', 'title', $view->getTitle());
$this->assertSession()->elementExists('xpath', '//h2[text()="' . $view->getTitle() . '"]');
$this->assertSession()->pageTextMatchesCount(2, '/' . $view->getTitle() . '/');
// Set a custom label on the exposed filter form block.
$block->getPlugin()->setConfigurationValue('views_label', '<strong>Custom</strong> title<script>alert("hacked!");</script>');
$block->save();
// Test that the content block label is found.
$this->drupalGet('test_exposed_block');
$this->assertSession()->responseContains('<strong>Custom</strong> titlealert("hacked!");');
// Set label to hidden on the exposed filter form block.
$block->getPlugin()->setConfigurationValue('label_display', FALSE);
$block->save();
// Test that the label is removed.
// Assert that the only occurrence of `$view->getTitle()` is the title tag
// now that label has been removed.
$this->drupalGet('test_exposed_block');
$this->assertSession()->responseNotContains('<strong>Custom</strong> titlealert("hacked!");');
$this->assertSession()->elementContains('css', 'title', $view->getTitle());
$this->assertSession()->pageTextMatchesCount(1, '/' . $view->getTitle() . '/');
// Test there is an exposed form in a block.
$this->assertSession()->elementsCount('xpath', '//div[@id="' . Html::getUniqueId('block-' . $block->id()) . '"]/form/@id', 1);
// Test there is not an exposed form in the view page content area.
$xpath = $this->assertSession()->buildXPathQuery('//div[@class="view-content"]/form/@id', [
':id' => Html::getUniqueId('block-' . $block->id()),
]);
$this->assertSession()->elementNotExists('xpath', $xpath);
// Test there is only one views exposed form on the page.
$xpath = '//form[@id="' . $this->getExpectedExposedFormId($view) . '"]';
$this->assertSession()->elementsCount('xpath', $xpath, 1);
$element = $this->assertSession()->elementExists('xpath', $xpath);
// Test that the correct option is selected after form submission.
$this->assertCacheContext('url');
$this->assertTrue($this->assertSession()->optionExists('Content: Type', 'All')->isSelected());
$arguments = [
'All' => ['article', 'page'],
'article' => ['article'],
'page' => ['page'],
];
foreach ($arguments as $argument => $bundles) {
$element->find('css', 'select')->selectOption($argument);
$element->findButton('Apply')->click();
$this->assertCacheContext('url');
$this->assertTrue($this->assertSession()->optionExists('Content: Type', $argument)->isSelected());
$this->assertNodesExist($bundles);
}
$element->findButton('Reset')->click();
$this->assertNodesExist($arguments['All']);
}
/**
* Data provider for testing different types of displays.
*
* @return array
* Array of display names to test.
*/
public static function providerTestExposedBlock() {
return [
'page_display' => ['page_1'],
'block_display' => ['block_1'],
];
}
/**
* Tests the input required exposed form type.
*/
public function testExposedForm(): void {
$this->testFormErrorWithExposedForm();
$this->testInputRequired();
$this->testTextInputRequired();
$this->testRememberSelected();
}
/**
* Tests the input required exposed form type.
*/
protected function testInputRequired(): void {
$view = View::load('test_exposed_form_buttons');
$display = &$view->getDisplay('default');
$display['display_options']['exposed_form']['type'] = 'input_required';
$view->save();
$this->drupalGet('test_exposed_form_buttons');
$this->assertSession()->statusCodeEquals(200);
$this->helperButtonHasLabel('edit-submit-test-exposed-form-buttons', 'Apply');
// Ensure that no results are displayed by default when no input is
// provided.
$this->assertSession()->elementNotExists('xpath', "//div[contains(@class, 'views-row')]");
$this->drupalGet('test_exposed_form_buttons', ['query' => ['type' => 'article']]);
// Ensure that results are displayed by default when input is provided.
$this->assertSession()->elementsCount('xpath', "//div[contains(@class, 'views-row')]", 5);
}
/**
* Tests the "on demand text" for the input required exposed form type.
*/
protected function testTextInputRequired(): void {
$view = Views::getView('test_exposed_form_buttons');
$display = &$view->storage->getDisplay('default');
$display['display_options']['exposed_form']['type'] = 'input_required';
// Set up the "on demand text".
// @see https://www.drupal.org/node/535868
$on_demand_text = 'Select any filter and click Apply to see results.';
$display['display_options']['exposed_form']['options']['text_input_required'] = $on_demand_text;
$display['display_options']['exposed_form']['options']['text_input_required_format'] = filter_default_format();
$view->save();
// Ensure that the "on demand text" is displayed when no exposed filters are
// applied.
$this->drupalGet('test_exposed_form_buttons');
$this->assertSession()->pageTextContains('Select any filter and click Apply to see results.');
// Ensure that the "on demand text" is not displayed when an exposed filter
// is applied.
$this->drupalGet('test_exposed_form_buttons', ['query' => ['type' => 'article']]);
$this->assertSession()->pageTextNotContains($on_demand_text);
}
/**
* Tests exposed forms with exposed sort and items per page.
*/
public function testExposedSortAndItemsPerPage(): void {
for ($i = 0; $i < 50; $i++) {
$entity = EntityTest::create([]);
$entity->save();
}
$contexts = [
'languages:language_interface',
'entity_test_view_grants',
'theme',
'url.query_args',
'languages:language_content',
];
$this->drupalGet('test_exposed_form_sort_items_per_page');
$this->assertCacheContexts($contexts);
$this->assertIds(range(1, 10, 1));
$this->drupalGet('test_exposed_form_sort_items_per_page', ['query' => ['sort_order' => 'DESC']]);
$this->assertCacheContexts($contexts);
$this->assertIds(range(50, 41, 1));
$this->drupalGet('test_exposed_form_sort_items_per_page', ['query' => ['sort_order' => 'DESC', 'items_per_page' => 25]]);
$this->assertCacheContexts($contexts);
$this->assertIds(range(50, 26, 1));
$this->drupalGet('test_exposed_form_sort_items_per_page', ['query' => ['sort_order' => 'DESC', 'items_per_page' => 25, 'offset' => 10]]);
$this->assertCacheContexts($contexts);
$this->assertIds(range(40, 16, 1));
$view = Views::getView('test_exposed_form_sort_items_per_page');
$view->setDisplay();
$sorts = $view->display_handler->getOption('sorts');
// Change the label to something with special characters.
$sorts['id']['expose']['label'] = $expected_label = "<script>alert('unsafe&dangerous');</script>";
// Use a custom sort field identifier.
$sorts['id']['expose']['field_identifier'] = $field_identifier = $this->randomMachineName() . '-_.~';
$view->display_handler->setOption('sorts', $sorts);
$view->save();
// Test label escaping.
$this->drupalGet('test_exposed_form_sort_items_per_page');
$options = $this->assertSession()->selectExists('edit-sort-by')->findAll('css', 'option');
$this->assertCount(1, $options);
// Check option existence by option label.
$this->assertSession()->optionExists('Sort by', $expected_label);
// Check option existence by option value.
$this->assertSession()->optionExists('Sort by', $field_identifier);
$escape_1 = Html::escape($expected_label);
$escape_2 = Html::escape($escape_1);
// Make sure we see the single-escaped string in the raw output.
$this->assertSession()->responseContains($escape_1);
// But no double-escaped string.
$this->assertSession()->responseNotContains($escape_2);
// And not the raw label, either.
$this->assertSession()->responseNotContains($expected_label);
// Check that the custom field identifier is used in the URL query string.
$this->submitForm(['sort_order' => 'DESC'], 'Apply');
$this->assertCacheContexts($contexts);
$this->assertIds(range(50, 41));
$url = $this->getSession()->getCurrentUrl();
$this->assertStringContainsString('sort_by=' . urlencode($field_identifier), $url);
}
/**
* Checks whether the specified ids are the ones displayed in the view output.
*
* @param int[] $ids
* The ids to check.
*
* @internal
*/
protected function assertIds(array $ids): void {
$elements = $this->cssSelect('div.view-test-exposed-form-sort-items-per-page div.views-row span.field-content');
$actual_ids = [];
foreach ($elements as $element) {
$actual_ids[] = (int) $element->getText();
}
$this->assertSame($ids, $actual_ids);
}
/**
* Returns a views exposed form ID.
*
* @param \Drupal\views\ViewExecutable $view
* The view to create an ID for.
*
* @return string
* The form ID.
*/
protected function getExpectedExposedFormId(ViewExecutable $view) {
return Html::cleanCssIdentifier('views-exposed-form-' . $view->storage->id() . '-' . $view->current_display);
}
/**
* Tests a view which is rendered after a form with a validation error.
*/
protected function testFormErrorWithExposedForm(): void {
$this->drupalGet('views_test_data_error_form_page');
$this->assertSession()->statusCodeEquals(200);
$form = $this->cssSelect('form.views-exposed-form');
$this->assertNotEmpty($form, 'The exposed form element was found.');
// Ensure the exposed form is rendered before submitting the normal form.
$this->assertSession()->responseContains("Apply");
$this->assertSession()->responseContains('<div class="views-row">');
$this->submitForm([], 'Submit');
$this->assertSession()->statusCodeEquals(200);
$form = $this->cssSelect('form.views-exposed-form');
$this->assertNotEmpty($form, 'The exposed form element was found.');
// Ensure the exposed form is rendered after submitting the normal form.
$this->assertSession()->responseContains("Apply");
$this->assertSession()->responseContains('<div class="views-row">');
}
/**
* Tests the exposed form with a pager.
*/
public function testExposedFilterPagination(): void {
$this->drupalCreateContentType(['type' => 'post']);
// Create some random nodes.
for ($i = 0; $i < 5; $i++) {
$this->drupalCreateNode(['type' => 'post']);
}
$this->drupalGet('test_exposed_form_pager');
$this->getSession()->getPage()->fillField('type[]', 'post');
$this->getSession()->getPage()->fillField('created[min]', '-1 month');
$this->getSession()->getPage()->fillField('created[max]', '+1 month');
// Ensure the filters can be applied.
$this->getSession()->getPage()->pressButton('Apply');
$this->assertTrue($this->assertSession()->optionExists('type[]', 'post')->isSelected());
$this->assertSession()->fieldValueEquals('created[min]', '-1 month');
$this->assertSession()->fieldValueEquals('created[max]', '+1 month');
// Ensure the filters are still applied after pressing next.
$this->clickLink('Next ›');
$this->assertTrue($this->assertSession()->optionExists('type[]', 'post')->isSelected());
$this->assertSession()->fieldValueEquals('created[min]', '-1 month');
$this->assertSession()->fieldValueEquals('created[max]', '+1 month');
}
/**
* Asserts that nodes of only given bundles exist.
*
* @param array $bundles
* Bundles of nodes.
*
* @internal
*/
protected function assertNodesExist(array $bundles): void {
foreach ($this->nodes as $node) {
if (in_array($node->bundle(), $bundles)) {
$this->assertSession()->pageTextContains($node->label());
}
else {
$this->assertSession()->pageTextNotContains($node->label());
}
}
}
/**
* Tests the "Remember the last selection" functionality.
*/
protected function testRememberSelected(): void {
$this->drupalGet('test_remember_selected');
$this->getSession()->getPage()->fillField('type', 'page');
$this->getSession()->getPage()->pressButton('Apply');
// Reload the page and ensure the filter is selected.
$this->drupalGet('test_remember_selected');
$this->assertTrue($this->assertSession()->optionExists('type', 'page')->isSelected());
}
}