See Release Notes
Long Term Support Release
<?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * TinyMCE custom steps definitions. * * @package editor_tiny * @category test * @copyright 2022 Andrew Lyons <andrew@nicols.co.uk> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ use Behat\Behat\Hook\Scope\BeforeScenarioScope; use Behat\Mink\Exception\DriverException; use Behat\Mink\Exception\ExpectationException; // NOTE: no MOODLE_INTERNAL test here, this file may be required by behat before including /config.php. require_once(__DIR__ . '/../../../../behat/behat_base.php'); require_once(__DIR__ . '/editor_tiny_helpers.php'); /** * TinyMCE custom behat step definitions. * * @package editor_tiny * @category test * @copyright 2022 Andrew Lyons <andrew@nicols.co.uk> */ class behat_editor_tiny extends behat_base implements \core_behat\settable_editor { use editor_tiny_helpers; /** * Set Tiny as default editor before executing Tiny tests. * * This step is required to ensure that TinyMCE is set as the current default editor as it may * not always be the default editor. * * Any Scenario, or Feature, which has the `editor_tiny` tag, or any `tiny_*` tag will have * this step executed before the Scenario. * * @BeforeScenario * @param BeforeScenarioScope $scope The Behat Scope */ public function set_default_editor_flag(BeforeScenarioScope $scope): void { // This only applies to a scenario which matches the editor_tiny, or an tiny subplugin. $callback = function (string $tag): bool { return $tag === 'editor_tiny' || substr($tag, 0, 5) === 'tiny_'; }; if (!self::scope_tags_match($scope, $callback)) { // This scope does not require TinyMCE. Exit now. return; } // TinyMCE is a JavaScript editor so require JS here. $this->require_javascript(); $this->execute('behat_general::the_default_editor_is_set_to', ['tiny']); } /** * Click on a button for the specified TinyMCE editor. * * @When /^I click on the "(?P<button_string>(?:[^"]|\\")*)" button for the "(?P<locator_string>(?:[^"]|\\")*)" TinyMCE editor$/ * * @param string $button The label of the button * @param string $locator The locator for the editor */ public function i_click_on_button(string $button, string $locator): void { $this->require_tiny_tags(); $container = $this->get_editor_container_for_locator($locator); $this->execute('behat_general::i_click_on_in_the', [$button, 'button', $container, 'NodeElement']); } /** * Confirm that the button state of the specified button/editor combination matches the expectation. * * @Then /^the "(?P<button_string>(?:[^"]|\\")*)" button of the "(?P<locator_string>(?:[^"]|\\")*)" TinyMCE editor has state "(?P<state_string>(?:[^"]|\\")*)"$/ * * @param string $button The text name of the button * @param string $locator The locator string for the editor * @param string $state The state of the button * @throws ExpectationException Thrown if the button state is not correct */ public function button_state_is(string $button, string $locator, string $state): void { $this->require_tiny_tags(); $container = $this->get_editor_container_for_locator($locator); $button = $this->find_button($button, false, $container); $buttonstate = $button->getAttribute('aria-pressed'); if ($buttonstate !== $state) { throw new ExpectationException("Button '{$button}' is in state '{$buttonstate}' not '{$state}'", $this->getSession()); } } /** * Click on a button for the specified TinyMCE editor. * * @When /^I click on the "(?P<menuitem_string>(?:[^"]|\\")*)" menu item for the "(?P<locator_string>(?:[^"]|\\")*)" TinyMCE editor$/ * * @param string $menuitem The label of the menu item * @param string $locator The locator for the editor */ public function i_click_on_menuitem_in_menu(string $menuitem, string $locator): void { $this->require_tiny_tags(); $container = $this->get_editor_container_for_locator($locator); $menubar = $container->find('css', '[role="menubar"]'); $menus = array_map(function(string $value): string { return trim($value); }, explode('>', $menuitem)); // Open the menu bar. $mainmenu = array_shift($menus); $this->execute('behat_general::i_click_on_in_the', [$mainmenu, 'button', $menubar, 'NodeElement']); foreach ($menus as $menuitem) { // Find the menu that was opened. $openmenu = $this->find('css', '.tox-selected-menu'); // Move the mouse to the first item in the list. // This is required because WebDriver takes the shortest path to the next click location, // which will mean crossing across other menu items. $firstlink = $openmenu->find('css', "[role^='menuitem'] .tox-collection__item-icon"); $firstlink->mouseover(); // Now match by title where the role matches any menuitem, or menuitemcheckbox, or menuitem*. $link = $openmenu->find('css', "[title='{$menuitem}'][role^='menuitem']"); $this->execute('behat_general::i_click_on', [$link, 'NodeElement']); } } /** * Select the element type/index for the specified TinyMCE editor. * * @When /^I select the "(?P<textlocator_string>(?:[^"]|\\")*)" element in position "(?P<position_int>(?:[^"]|\\")*)" of the "(?P<locator_string>(?:[^"]|\\")*)" TinyMCE editor$/ * @param string $textlocator The type of element to select (for example `p` or `span`) * @param int $position The zero-indexed position * @param string $locator The editor to select within */ public function select_text(string $textlocator, int $position, string $locator): void { $this->require_tiny_tags(); $editor = $this->get_textarea_for_locator($locator); $editorid = $editor->getAttribute('id'); // Ensure that a name is set on the iframe relating to the editorid. $js = <<<EOF< const element = instance.dom.select("${textlocator}")[${position}];> const element = instance.dom.select("{$textlocator}")[{$position}];instance.selection.select(element); EOF; $this->execute_javascript_for_editor($editorid, $js); } /** * Upload a file in the file picker using the repository_upload plugin. * * Note: This step assumes we are already in the file picker. * Note: This step is for use by TinyMCE and will be removed once an appropriate step is added to core. * See MDL-76001 for details. * * @Given /^I upload "(?P<filepath_string>(?:[^"]|\\")*)" to the file picker for TinyMCE$/ */ public function i_upload_a_file_in_the_filepicker(string $filepath): void { if (!$this->has_tag('javascript')) { throw new DriverException('The file picker is only available with javascript enabled'); } if (!$this->has_tag('_file_upload')) { throw new DriverException('File upload tests must have the @_file_upload tag on either the scenario or feature.'); } if (!$this->has_tag('editor_tiny')) { throw new DriverException('This step is intended for use in TinyMCE. Please vote for MDL-76001'); } $filepicker = $this->find('dialogue', get_string('filepicker', 'core_repository')); $this->execute('behat_general::i_click_on_in_the', [ get_string('pluginname', 'repository_upload'), 'link', $filepicker, 'NodeElement', ]); $reporegion = $filepicker->find('css', '.fp-repo-items'); $fileinput = $this->find('field', get_string('attachment', 'core_repository'), false, $reporegion); $filepath = $this->normalise_fixture_filepath($filepath); $fileinput->attachFile($filepath); $this->execute('behat_general::i_click_on_in_the', [ get_string('upload', 'repository'), 'button', $reporegion, 'NodeElement', ]); } /** * Select in the editor. * * @param string $locator * @param string $type * @param string $editorlocator * * @Given /^I select the "(?P<locator_string>(?:[^"]|\\")*)" "(?P<type_string>(?:[^"]|\\")*)" in the "(?P<editorlocator_string>(?:[^"]|\\")*)" TinyMCE editor$/ */ public function select_in_editor(string $locator, string $type, string $editorlocator): void { $this->require_tiny_tags(); $editor = $this->get_textarea_for_locator($editorlocator); $editorid = $editor->getAttribute('id'); // Get the iframe name for this editor. $iframename = $this->get_editor_iframe_name($editorlocator); // Switch to it. $this->execute('behat_general::switch_to_iframe', [$iframename]); // Find the element. $element = $this->find($type, $locator); $xpath = $element->getXpath(); // Switch back to the main window. $this->execute('behat_general::switch_to_the_main_frame', []); // Select the Node using the xpath. $js = <<<EOF const editorDocument = instance.getDoc(); const element = editorDocument.evaluate(< "${xpath}",> "{$xpath}",editorDocument, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null ).singleNodeValue; instance.selection.select(element); EOF; $this->execute_javascript_for_editor($editorid, $js); } /** * Expand all of the TinyMCE toolbars. * * @Given /^I expand all toolbars for the "(?P<editorlocator_string>(?:[^"]|\\")*)" TinyMCE editor$/ * * @param string $locator */ public function expand_all_toolbars(string $editorlocator): void { $this->require_tiny_tags(); $editor = $this->get_editor_container_for_locator($editorlocator); try { $button = $this->find('button', get_string('tiny:more...', 'editor_tiny'), false, $editor); } catch (ExpectationException $e) { // No more button, so no need to expand. return; } if ($button->getAttribute(('aria-pressed')) === 'false') { $this->execute('behat_general::i_click_on', [$button, 'NodeElement']); } } /** * Switch to the TinyMCE iframe using a selector. * * @param string $editorlocator * * @When /^I switch to the "(?P<editorlocator_string>(?:[^"]|\\")*)" TinyMCE editor iframe$/ */ public function switch_to_tiny_iframe(string $editorlocator): void { $this->require_tiny_tags(); // Get the iframe name for this editor. $iframename = $this->get_editor_iframe_name($editorlocator); // Switch to it. $this->execute('behat_general::switch_to_iframe', [$iframename]); } }