function FieldUiTestTrait::fieldUIAddExistingField

Same name in this branch
  1. 8.9.x core/modules/field_ui/tests/src/Traits/FieldUiTestTrait.php \Drupal\Tests\field_ui\Traits\FieldUiTestTrait::fieldUIAddExistingField()
Same name in other branches
  1. 9 core/modules/field_ui/tests/src/Traits/FieldUiTestTrait.php \Drupal\Tests\field_ui\Traits\FieldUiTestTrait::fieldUIAddExistingField()
  2. 10 core/modules/field_ui/tests/src/Traits/FieldUiTestTrait.php \Drupal\Tests\field_ui\Traits\FieldUiTestTrait::fieldUIAddExistingField()
  3. 11.x core/modules/field_ui/tests/src/Traits/FieldUiTestTrait.php \Drupal\Tests\field_ui\Traits\FieldUiTestTrait::fieldUIAddExistingField()

Adds an existing field through the Field UI.

Parameters

string $bundle_path: Admin path of the bundle that the field is to be attached to.

string $existing_storage_name: The name of the existing field storage for which we want to add a new field.

string $label: (optional) The label of the new field. Defaults to a random string.

array $field_edit: (optional) $edit parameter for drupalPostForm() on the second step ('Field settings' form).

File

core/modules/field_ui/src/Tests/FieldUiTestTrait.php, line 81

Class

FieldUiTestTrait
Provides common functionality for the Field UI test classes.

Namespace

Drupal\field_ui\Tests

Code

public function fieldUIAddExistingField($bundle_path, $existing_storage_name, $label = NULL, array $field_edit = []) {
    $label = $label ?: $this->randomString();
    $initial_edit = [
        'existing_storage_name' => $existing_storage_name,
        'existing_storage_label' => $label,
    ];
    // First step: 'Re-use existing field' on the 'Add field' page.
    $this->drupalPostForm("{$bundle_path}/fields/add-field", $initial_edit, t('Save and continue'));
    // Set the main content to only the content region because the label can
    // contain HTML which will be auto-escaped by Twig.
    $main_content = $this->cssSelect('.region-content');
    $this->setRawContent(reset($main_content)->asXml());
    $this->assertRaw('field-config-edit-form', 'The field config edit form is present.');
    $this->assertNoRaw('<', 'The page does not have double escaped HTML tags.');
    // Second step: 'Field settings' form.
    $this->drupalPostForm(NULL, $field_edit, t('Save settings'));
    $this->assertRaw(t('Saved %label configuration.', [
        '%label' => $label,
    ]), 'Redirected to "Manage fields" page.');
    // Check that the field appears in the overview form.
    $this->assertFieldByXPath('//table[@id="field-overview"]//tr/td[1]', $label, 'Field was created and appears in the overview page.');
}

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