SettingsTrayTestBase.php

Same filename in other branches
  1. 8.9.x core/modules/settings_tray/tests/src/FunctionalJavascript/SettingsTrayTestBase.php
  2. 10 core/modules/settings_tray/tests/src/FunctionalJavascript/SettingsTrayTestBase.php
  3. 11.x core/modules/settings_tray/tests/src/FunctionalJavascript/SettingsTrayTestBase.php

Namespace

Drupal\Tests\settings_tray\FunctionalJavascript

File

core/modules/settings_tray/tests/src/FunctionalJavascript/SettingsTrayTestBase.php

View source
<?php

namespace Drupal\Tests\settings_tray\FunctionalJavascript;

use Drupal\block\Entity\Block;
use Drupal\Tests\contextual\FunctionalJavascript\ContextualLinkClickTrait;
use Drupal\Tests\system\FunctionalJavascript\OffCanvasTestBase;

/**
 * Base class for Settings Tray tests.
 */
class SettingsTrayTestBase extends OffCanvasTestBase {
    use ContextualLinkClickTrait;
    
    /**
     * {@inheritdoc}
     */
    protected static $modules = [
        'settings_tray',
        // Add test module to override CSS pointer-events properties because they
        // cause test failures.
'settings_tray_test_css',
    ];
    const TOOLBAR_EDIT_LINK_SELECTOR = '#toolbar-bar div.contextual-toolbar-tab button';
    const LABEL_INPUT_SELECTOR = 'input[data-drupal-selector="edit-settings-label"]';
    
    /**
     * Open block form by clicking the element found with a css selector.
     *
     * @param string $block_selector
     *   A css selector selects the block or an element within it.
     * @param string $contextual_link_container
     *   The element that contains the contextual links. If none provide the
     *   $block_selector will be used.
     */
    protected function openBlockForm($block_selector, $contextual_link_container = '') {
        if (!$contextual_link_container) {
            $contextual_link_container = $block_selector;
        }
        // Ensure that contextual link element is present because this is required
        // to open the off-canvas dialog in edit mode.
        $contextual_link = $this->assertSession()
            ->waitForElement('css', "{$contextual_link_container} .contextual-links a");
        $this->assertNotEmpty($contextual_link);
        // When page first loads Edit Mode is not triggered until first contextual
        // link is added.
        $this->assertElementVisibleAfterWait('css', '.dialog-off-canvas-main-canvas.js-settings-tray-edit-mode');
        // Ensure that all other Ajax activity is completed.
        $this->assertSession()
            ->assertWaitOnAjaxRequest();
        $block = $this->getSession()
            ->getPage()
            ->find('css', $block_selector);
        $block->mouseOver();
        $block->click();
        $this->waitForOffCanvasToOpen();
        $this->assertOffCanvasBlockFormIsValid();
    }
    
    /**
     * Enables edit mode by pressing edit button in the toolbar.
     */
    protected function enableEditMode() {
        $this->pressToolbarEditButton();
        $this->assertEditModeEnabled();
    }
    
    /**
     * Disables edit mode by pressing edit button in the toolbar.
     */
    protected function disableEditMode() {
        $this->assertSession()
            ->assertWaitOnAjaxRequest();
        $this->pressToolbarEditButton();
        $this->assertEditModeDisabled();
    }
    
    /**
     * Press the toolbar Edit button provided by the contextual module.
     */
    protected function pressToolbarEditButton() {
        $this->assertSession()
            ->waitForElement('css', '[data-contextual-id] .contextual-links a');
        $edit_button = $this->getSession()
            ->getPage()
            ->find('css', static::TOOLBAR_EDIT_LINK_SELECTOR);
        $this->getSession()
            ->executeScript("jQuery('[data-quickedit-entity-id]').trigger('mouseleave')");
        $edit_button->mouseOver();
        $edit_button->press();
    }
    
    /**
     * Assert that edit mode has been properly disabled.
     */
    protected function assertEditModeDisabled() {
        $web_assert = $this->assertSession();
        $page = $this->getSession()
            ->getPage();
        $this->getSession()
            ->executeScript("jQuery('[data-quickedit-entity-id]').trigger('mouseleave')");
        $page->find('css', static::TOOLBAR_EDIT_LINK_SELECTOR)
            ->mouseOver();
        $this->assertTrue($page->waitFor(10, function ($page) {
            return !$page->find('css', '.contextual .trigger:not(.visually-hidden)');
        }));
        // Contextual triggers should be hidden.
        $web_assert->elementExists('css', '.contextual .trigger.visually-hidden');
        // No contextual triggers should be not hidden.
        $web_assert->elementNotExists('css', '.contextual .trigger:not(.visually-hidden)');
        // The toolbar edit button should read "Edit".
        $web_assert->elementContains('css', static::TOOLBAR_EDIT_LINK_SELECTOR, 'Edit');
        // The main canvas element should NOT have the "js-settings-tray-edit-mode"
        // class.
        $web_assert->elementNotExists('css', '.dialog-off-canvas-main-canvas.js-settings-tray-edit-mode');
    }
    
    /**
     * Assert that edit mode has been properly enabled.
     */
    protected function assertEditModeEnabled() {
        $web_assert = $this->assertSession();
        $page = $this->getSession()
            ->getPage();
        // Move the mouse over the toolbar button so that isn't over a contextual
        // links area which cause the contextual link to be shown.
        $page->find('css', static::TOOLBAR_EDIT_LINK_SELECTOR)
            ->mouseOver();
        $this->assertTrue($page->waitFor(10, function ($page) {
            return !$page->find('css', '.contextual .trigger.visually-hidden');
        }));
        // No contextual triggers should be hidden.
        $web_assert->elementNotExists('css', '.contextual .trigger.visually-hidden');
        // The toolbar edit button should read "Editing".
        $web_assert->elementContains('css', static::TOOLBAR_EDIT_LINK_SELECTOR, 'Editing');
        // The main canvas element should have the "js-settings-tray-edit-mode" class.
        $web_assert->elementExists('css', '.dialog-off-canvas-main-canvas.js-settings-tray-edit-mode');
    }
    
    /**
     * Asserts that Off-Canvas block form is valid.
     */
    protected function assertOffCanvasBlockFormIsValid() {
        $web_assert = $this->assertSession();
        // Confirm that Block title display label has been changed.
        $web_assert->elementTextContains('css', '.form-item-settings-label-display label', 'Display block title');
        // Confirm Block title label is shown if checkbox is checked.
        if ($this->getSession()
            ->getPage()
            ->find('css', 'input[name="settings[label_display]"]')
            ->isChecked()) {
            $this->assertTrue($this->isLabelInputVisible(), 'Label is visible');
            $web_assert->elementTextContains('css', '.form-item-settings-label label', 'Block title');
        }
        else {
            $this->assertFalse($this->isLabelInputVisible(), 'Label is not visible');
        }
        // Check that common block form elements exist.
        $web_assert->elementExists('css', static::LABEL_INPUT_SELECTOR);
        $web_assert->elementExists('css', 'input[data-drupal-selector="edit-settings-label-display"]');
        // Check that advanced block form elements do not exist.
        $web_assert->elementNotExists('css', 'input[data-drupal-selector="edit-visibility-request-path-pages"]');
        $web_assert->elementNotExists('css', 'select[data-drupal-selector="edit-region"]');
    }
    
    /**
     * {@inheritdoc}
     */
    protected function getTestThemes() {
        // Remove 'claro' theme. Settings Tray "Edit Mode" will not work with this
        // theme because it removes all contextual links.
        return array_filter(parent::getTestThemes(), function ($theme) {
            return $theme !== 'claro';
        });
    }
    
    /**
     * Gets the block CSS selector.
     *
     * @param \Drupal\block\Entity\Block $block
     *   The block.
     *
     * @return string
     *   The CSS selector.
     */
    public function getBlockSelector(Block $block) {
        return '#block-' . str_replace('_', '-', $block->id());
    }
    
    /**
     * Determines if the label input is visible.
     *
     * @return bool
     *   TRUE if the label is visible, FALSE if it is not.
     */
    protected function isLabelInputVisible() {
        return $this->getSession()
            ->getPage()
            ->find('css', static::LABEL_INPUT_SELECTOR)
            ->isVisible();
    }

}

Classes

Title Deprecated Summary
SettingsTrayTestBase Base class for Settings Tray tests.

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