You are here

public function ElementsLabelsTest::testFormLabels in Drupal 8

Same name and namespace in other branches
  1. 9 core/modules/system/tests/src/Functional/Form/ElementsLabelsTest.php \Drupal\Tests\system\Functional\Form\ElementsLabelsTest::testFormLabels()
  2. 10 core/modules/system/tests/src/Functional/Form/ElementsLabelsTest.php \Drupal\Tests\system\Functional\Form\ElementsLabelsTest::testFormLabels()

Test form elements, labels, title attributes and required marks output correctly and have the correct label option class if needed.

File

core/modules/system/tests/src/Functional/Form/ElementsLabelsTest.php, line 31

Class

ElementsLabelsTest
Tests form element labels, required markers and associated output.

Namespace

Drupal\Tests\system\Functional\Form

Code

public function testFormLabels() {
  $this
    ->drupalGet('form_test/form-labels');

  // Check that the checkbox/radio processing is not interfering with
  // basic placement.
  $elements = $this
    ->xpath('//input[@id="edit-form-checkboxes-test-third-checkbox"]/following-sibling::label[@for="edit-form-checkboxes-test-third-checkbox" and @class="option"]');
  $this
    ->assertTrue(isset($elements[0]), 'Label follows field and label option class correct for regular checkboxes.');

  // Make sure the label is rendered for checkboxes.
  $elements = $this
    ->xpath('//input[@id="edit-form-checkboxes-test-0"]/following-sibling::label[@for="edit-form-checkboxes-test-0" and @class="option"]');
  $this
    ->assertTrue(isset($elements[0]), 'Label 0 found checkbox.');
  $elements = $this
    ->xpath('//input[@id="edit-form-radios-test-second-radio"]/following-sibling::label[@for="edit-form-radios-test-second-radio" and @class="option"]');
  $this
    ->assertTrue(isset($elements[0]), 'Label follows field and label option class correct for regular radios.');

  // Make sure the label is rendered for radios.
  $elements = $this
    ->xpath('//input[@id="edit-form-radios-test-0"]/following-sibling::label[@for="edit-form-radios-test-0" and @class="option"]');
  $this
    ->assertTrue(isset($elements[0]), 'Label 0 found radios.');

  // Exercise various defaults for checkboxes and modifications to ensure
  // appropriate override and correct behavior.
  $elements = $this
    ->xpath('//input[@id="edit-form-checkbox-test"]/following-sibling::label[@for="edit-form-checkbox-test" and @class="option"]');
  $this
    ->assertTrue(isset($elements[0]), 'Label follows field and label option class correct for a checkbox by default.');

  // Exercise various defaults for textboxes and modifications to ensure
  // appropriate override and correct behavior.
  $elements = $this
    ->xpath('//label[@for="edit-form-textfield-test-title-and-required" and @class="js-form-required form-required"]/following-sibling::input[@id="edit-form-textfield-test-title-and-required"]');
  $this
    ->assertTrue(isset($elements[0]), 'Label precedes textfield, with required marker inside label.');
  $elements = $this
    ->xpath('//input[@id="edit-form-textfield-test-no-title-required"]/preceding-sibling::label[@for="edit-form-textfield-test-no-title-required" and @class="js-form-required form-required"]');
  $this
    ->assertTrue(isset($elements[0]), 'Label tag with required marker precedes required textfield with no title.');
  $elements = $this
    ->xpath('//input[@id="edit-form-textfield-test-title-invisible"]/preceding-sibling::label[@for="edit-form-textfield-test-title-invisible" and @class="visually-hidden"]');
  $this
    ->assertTrue(isset($elements[0]), 'Label preceding field and label class is visually-hidden.');
  $elements = $this
    ->xpath('//input[@id="edit-form-textfield-test-title"]/preceding-sibling::span[@class="js-form-required form-required"]');
  $this
    ->assertFalse(isset($elements[0]), 'No required marker on non-required field.');
  $elements = $this
    ->xpath('//input[@id="edit-form-textfield-test-title-after"]/following-sibling::label[@for="edit-form-textfield-test-title-after" and @class="option"]');
  $this
    ->assertTrue(isset($elements[0]), 'Label after field and label option class correct for text field.');
  $elements = $this
    ->xpath('//label[@for="edit-form-textfield-test-title-no-show"]');
  $this
    ->assertFalse(isset($elements[0]), 'No label tag when title set not to display.');
  $elements = $this
    ->xpath('//div[contains(@class, "js-form-item-form-textfield-test-title-invisible") and contains(@class, "form-no-label")]');
  $this
    ->assertTrue(isset($elements[0]), 'Field class is form-no-label when there is no label.');

  // Check #field_prefix and #field_suffix placement.
  $elements = $this
    ->xpath('//span[@class="field-prefix"]/following-sibling::div[@id="edit-form-radios-test"]');
  $this
    ->assertTrue(isset($elements[0]), 'Properly placed the #field_prefix element after the label and before the field.');
  $elements = $this
    ->xpath('//span[@class="field-suffix"]/preceding-sibling::div[@id="edit-form-radios-test"]');
  $this
    ->assertTrue(isset($elements[0]), 'Properly places the #field_suffix element immediately after the form field.');

  // Check #prefix and #suffix placement.
  $elements = $this
    ->xpath('//div[@id="form-test-textfield-title-prefix"]/following-sibling::div[contains(@class, \'js-form-item-form-textfield-test-title\')]');
  $this
    ->assertTrue(isset($elements[0]), 'Properly places the #prefix element before the form item.');
  $elements = $this
    ->xpath('//div[@id="form-test-textfield-title-suffix"]/preceding-sibling::div[contains(@class, \'js-form-item-form-textfield-test-title\')]');
  $this
    ->assertTrue(isset($elements[0]), 'Properly places the #suffix element before the form item.');

  // Check title attribute for radios and checkboxes.
  $elements = $this
    ->xpath('//div[@id="edit-form-checkboxes-title-attribute"]');
  $this
    ->assertEqual($elements[0]
    ->getAttribute('title'), 'Checkboxes test' . ' (' . t('Required') . ')', 'Title attribute found.');
  $elements = $this
    ->xpath('//div[@id="edit-form-radios-title-attribute"]');
  $this
    ->assertEqual($elements[0]
    ->getAttribute('title'), 'Radios test' . ' (' . t('Required') . ')', 'Title attribute found.');
  $elements = $this
    ->xpath('//fieldset[@id="edit-form-checkboxes-title-invisible--wrapper"]/legend/span[contains(@class, "visually-hidden")]');
  $this
    ->assertTrue(!empty($elements), "Title/Label not displayed when 'visually-hidden' attribute is set in checkboxes.");
  $elements = $this
    ->xpath('//fieldset[@id="edit-form-radios-title-invisible--wrapper"]/legend/span[contains(@class, "visually-hidden")]');
  $this
    ->assertTrue(!empty($elements), "Title/Label not displayed when 'visually-hidden' attribute is set in radios.");
}