Drupal 8.0.0 beta 12. More info: https://www.drupal.org/node/2514176

core/modules/text/src/Plugin/Field/FieldFormatter/TextDefaultFormatter.php

@@ -0,0 +1,51 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Plugin\Field\FieldFormatter\TextDefaultFormatter.
+ */
+
+namespace Drupal\text\Plugin\Field\FieldFormatter;
+
+use Drupal\Core\Field\FormatterBase;
+use Drupal\Core\Field\FieldItemListInterface;
+
+/**
+ * Plugin implementation of the 'text_default' formatter.
+ *
+ * @FieldFormatter(
+ *   id = "text_default",
+ *   label = @Translation("Default"),
+ *   field_types = {
+ *     "text",
+ *     "text_long",
+ *     "text_with_summary",
+ *   },
+ *   quickedit = {
+ *     "editor" = "plain_text"
+ *   }
+ * )
+ */
+class TextDefaultFormatter extends FormatterBase {
+
+  /**
+   * {@inheritdoc}
+   */
+  public function viewElements(FieldItemListInterface $items) {
+    $elements = array();
+
+    // The ProcessedText element already handles cache context & tag bubbling.
+    // @see \Drupal\filter\Element\ProcessedText::preRenderText()
+    foreach ($items as $delta => $item) {
+      $elements[$delta] = array(
+        '#type' => 'processed_text',
+        '#text' => $item->value,
+        '#format' => $item->format,
+        '#langcode' => $item->getLangcode(),
+      );
+    }
+
+    return $elements;
+  }
+
+}

core/modules/text/src/Plugin/Field/FieldFormatter/TextSummaryOrTrimmedFormatter.php

@@ -0,0 +1,24 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Plugin\Field\FieldFormatter\TextSummaryOrTrimmedFormatter.
+ */
+
+namespace Drupal\text\Plugin\Field\FieldFormatter;
+
+/**
+ * Plugin implementation of the 'text_summary_or_trimmed' formatter.
+ *
+ * @FieldFormatter(
+ *   id = "text_summary_or_trimmed",
+ *   label = @Translation("Summary or trimmed"),
+ *   field_types = {
+ *     "text_with_summary"
+ *   },
+ *   quickedit = {
+ *     "editor" = "form"
+ *   }
+ * )
+ */
+class TextSummaryOrTrimmedFormatter extends TextTrimmedFormatter { }

core/modules/text/src/Plugin/Field/FieldFormatter/TextTrimmedFormatter.php

@@ -0,0 +1,131 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Plugin\Field\FieldFormatter\TextTrimmedFormatter.
+ */
+namespace Drupal\text\Plugin\Field\FieldFormatter;
+
+use Drupal\Core\Field\FormatterBase;
+use Drupal\Core\Field\FieldItemListInterface;
+use Drupal\Core\Form\FormStateInterface;
+
+/**
+ * Plugin implementation of the 'text_trimmed' formatter.
+ *
+ * Note: This class also contains the implementations used by the
+ * 'text_summary_or_trimmed' formatter.
+ *
+ * @see \Drupal\text\Field\Formatter\TextSummaryOrTrimmedFormatter
+ *
+ * @FieldFormatter(
+ *   id = "text_trimmed",
+ *   label = @Translation("Trimmed"),
+ *   field_types = {
+ *     "text",
+ *     "text_long",
+ *     "text_with_summary"
+ *   },
+ *   quickedit = {
+ *     "editor" = "form"
+ *   }
+ * )
+ */
+class TextTrimmedFormatter extends FormatterBase {
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function defaultSettings() {
+    return array(
+      'trim_length' => '600',
+    ) + parent::defaultSettings();
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function settingsForm(array $form, FormStateInterface $form_state) {
+    $element['trim_length'] = array(
+      '#title' => t('Trimmed limit'),
+      '#type' => 'number',
+      '#field_suffix' => t('characters'),
+      '#default_value' => $this->getSetting('trim_length'),
+      '#description' => t('If the summary is not set, the trimmed %label field will end at the last full sentence before this character limit.', array('%label' => $this->fieldDefinition->getLabel())),
+      '#min' => 1,
+      '#required' => TRUE,
+    );
+    return $element;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function settingsSummary() {
+    $summary = array();
+    $summary[] = t('Trimmed limit: @trim_length characters', array('@trim_length' => $this->getSetting('trim_length')));
+    return $summary;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function viewElements(FieldItemListInterface $items) {
+    $elements = array();
+
+    $render_as_summary = function (&$element) {
+      // Make sure any default #pre_render callbacks are set on the element,
+      // because text_pre_render_summary() must run last.
+      $element += \Drupal::service('element_info')->getInfo($element['#type']);
+      // Add the #pre_render callback that renders the text into a summary.
+      $element['#pre_render'][] = '\Drupal\text\Plugin\field\FieldFormatter\TextTrimmedFormatter::preRenderSummary';
+      // Pass on the trim length to the #pre_render callback via a property.
+      $element['#text_summary_trim_length'] = $this->getSetting('trim_length');
+    };
+
+    // The ProcessedText element already handles cache context & tag bubbling.
+    // @see \Drupal\filter\Element\ProcessedText::preRenderText()
+    foreach ($items as $delta => $item) {
+      $elements[$delta] = array(
+        '#type' => 'processed_text',
+        '#text' => NULL,
+        '#format' => $item->format,
+        '#langcode' => $item->getLangcode(),
+      );
+
+      if ($this->getPluginId() == 'text_summary_or_trimmed' && !empty($item->summary)) {
+        $elements[$delta]['#text'] = $item->summary;
+      }
+      else {
+        $elements[$delta]['#text'] = $item->value;
+        $render_as_summary($elements[$delta]);
+      }
+    }
+
+    return $elements;
+  }
+
+  /**
+   * Pre-render callback: Renders a processed text element's #markup as a summary.
+   *
+   * @param array $element
+   *   A structured array with the following key-value pairs:
+   *   - #markup: the filtered text (as filtered by filter_pre_render_text())
+   *   - #format: containing the machine name of the filter format to be used to
+   *     filter the text. Defaults to the fallback format. See
+   *     filter_fallback_format().
+   *   - #text_summary_trim_length: the desired character length of the summary
+   *     (used by text_summary())
+   *
+   * @return array
+   *   The passed-in element with the filtered text in '#markup' trimmed.
+   *
+   * @see filter_pre_render_text()
+   * @see text_summary()
+   */
+  public static function preRenderSummary(array $element) {
+    $element['#markup'] = text_summary($element['#markup'], $element['#format'], $element['#text_summary_trim_length']);
+    return $element;
+  }
+
+}

core/modules/text/src/Plugin/Field/FieldType/TextItem.php

@@ -0,0 +1,98 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Plugin\Field\FieldType\TextItem.
+ */
+
+namespace Drupal\text\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldStorageDefinitionInterface;
+use Drupal\Core\Form\FormStateInterface;
+
+/**
+ * Plugin implementation of the 'text' field type.
+ *
+ * @FieldType(
+ *   id = "text",
+ *   label = @Translation("Text (formatted)"),
+ *   description = @Translation("This field stores a text with a text format."),
+ *   category = @Translation("Text"),
+ *   default_widget = "text_textfield",
+ *   default_formatter = "text_default"
+ * )
+ */
+class TextItem extends TextItemBase {
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function defaultStorageSettings() {
+    return array(
+      'max_length' => 255,
+    ) + parent::defaultStorageSettings();
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function schema(FieldStorageDefinitionInterface $field_definition) {
+    return array(
+      'columns' => array(
+        'value' => array(
+          'type' => 'varchar',
+          'length' => $field_definition->getSetting('max_length'),
+        ),
+        'format' => array(
+          'type' => 'varchar',
+          'length' => 255,
+        ),
+      ),
+      'indexes' => array(
+        'format' => array('format'),
+      ),
+    );
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function getConstraints() {
+    $constraint_manager = \Drupal::typedDataManager()->getValidationConstraintManager();
+    $constraints = parent::getConstraints();
+
+    if ($max_length = $this->getSetting('max_length')) {
+      $constraints[] = $constraint_manager->create('ComplexData', array(
+        'value' => array(
+          'Length' => array(
+            'max' => $max_length,
+            'maxMessage' => t('%name: the text may not be longer than @max characters.', array('%name' => $this->getFieldDefinition()->getLabel(), '@max' => $max_length)),
+          )
+        ),
+      ));
+    }
+
+    return $constraints;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function storageSettingsForm(array &$form, FormStateInterface $form_state, $has_data) {
+    $element = array();
+
+    $element['max_length'] = array(
+      '#type' => 'number',
+      '#title' => t('Maximum length'),
+      '#default_value' => $this->getSetting('max_length'),
+      '#required' => TRUE,
+      '#description' => t('The maximum length of the field in characters.'),
+      '#min' => 1,
+      '#disabled' => $has_data,
+    );
+    $element += parent::storageSettingsForm($form, $form_state, $has_data);
+
+    return $element;
+  }
+
+}

core/modules/text/src/Plugin/Field/FieldType/TextItemBase.php

@@ -0,0 +1,99 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Plugin\Field\FieldType\TextItemBase.
+ */
+
+namespace Drupal\text\Plugin\Field\FieldType;
+
+use Drupal\Component\Utility\Random;
+use Drupal\Core\Field\FieldDefinitionInterface;
+use Drupal\Core\Field\FieldItemBase;
+use Drupal\Core\Field\FieldStorageDefinitionInterface;
+use Drupal\Core\TypedData\DataDefinition;
+
+/**
+ * Base class for 'text' configurable field types.
+ */
+abstract class TextItemBase extends FieldItemBase {
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function propertyDefinitions(FieldStorageDefinitionInterface $field_definition) {
+    $properties['value'] = DataDefinition::create('string')
+      ->setLabel(t('Text'))
+      ->setRequired(TRUE);
+
+    $properties['format'] = DataDefinition::create('filter_format')
+      ->setLabel(t('Text format'));
+
+    $properties['processed'] = DataDefinition::create('string')
+      ->setLabel(t('Processed text'))
+      ->setDescription(t('The text with the text format applied.'))
+      ->setComputed(TRUE)
+      ->setClass('\Drupal\text\TextProcessed')
+      ->setSetting('text source', 'value');
+
+    return $properties;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function applyDefaultValue($notify = TRUE) {
+    // Default to a simple \Drupal\Component\Utility\SafeMarkup::checkPlain().
+    // @todo: Add in the filter default format here.
+    $this->setValue(array('format' => NULL), $notify);
+    return $this;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function isEmpty() {
+    $value = $this->get('value')->getValue();
+    return $value === NULL || $value === '';
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function onChange($property_name, $notify = TRUE) {
+    // Unset processed properties that are affected by the change.
+    foreach ($this->definition->getPropertyDefinitions() as $property => $definition) {
+      if ($definition->getClass() == '\Drupal\text\TextProcessed') {
+        if ($property_name == 'format' || ($definition->getSetting('text source') == $property_name)) {
+          $this->writePropertyValue($property, NULL);
+        }
+      }
+    }
+    parent::onChange($property_name, $notify);
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function generateSampleValue(FieldDefinitionInterface $field_definition) {
+    $random = new Random();
+    $settings = $field_definition->getSettings();
+
+    if (empty($settings['max_length'])) {
+      // Textarea handling
+      $value = $random->paragraphs();
+    }
+    else {
+      // Textfield handling.
+      $value = substr($random->sentences(mt_rand(1, $settings['max_length'] / 3), FALSE), 0, $settings['max_length']);
+    }
+
+    $values = array(
+      'value' => $value,
+      'summary' => $value,
+      'format' => filter_fallback_format(),
+    );
+    return $values;
+  }
+
+}

core/modules/text/src/Plugin/Field/FieldType/TextLongItem.php

@@ -0,0 +1,47 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Plugin\Field\FieldType\TextLongItem.
+ */
+
+namespace Drupal\text\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldStorageDefinitionInterface;
+
+/**
+ * Plugin implementation of the 'text_long' field type.
+ *
+ * @FieldType(
+ *   id = "text_long",
+ *   label = @Translation("Text (formatted, long)"),
+ *   description = @Translation("This field stores a long text with a text format."),
+ *   category = @Translation("Text"),
+ *   default_widget = "text_textarea",
+ *   default_formatter = "text_default"
+ * )
+ */
+class TextLongItem extends TextItemBase {
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function schema(FieldStorageDefinitionInterface $field_definition) {
+    return array(
+      'columns' => array(
+        'value' => array(
+          'type' => 'text',
+          'size' => 'big',
+        ),
+        'format' => array(
+          'type' => 'varchar_ascii',
+          'length' => 255,
+        ),
+      ),
+      'indexes' => array(
+        'format' => array('format'),
+      ),
+    );
+  }
+
+}

core/modules/text/src/Plugin/Field/FieldType/TextWithSummaryItem.php

@@ -0,0 +1,106 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Plugin\Field\FieldType\TextWithSummaryItem.
+ */
+
+namespace Drupal\text\Plugin\Field\FieldType;
+
+use Drupal\Core\Field\FieldStorageDefinitionInterface;
+use Drupal\Core\Form\FormStateInterface;
+use Drupal\Core\TypedData\DataDefinition;
+
+/**
+ * Plugin implementation of the 'text_with_summary' field type.
+ *
+ * @FieldType(
+ *   id = "text_with_summary",
+ *   label = @Translation("Text (formatted, long, with summary)"),
+ *   description = @Translation("This field stores long text with a format and an optional summary."),
+ *   category = @Translation("Text"),
+ *   default_widget = "text_textarea_with_summary",
+ *   default_formatter = "text_default"
+ * )
+ */
+class TextWithSummaryItem extends TextItemBase {
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function defaultFieldSettings() {
+    return array(
+      'display_summary' => 0,
+    ) + parent::defaultFieldSettings();
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function propertyDefinitions(FieldStorageDefinitionInterface $field_definition) {
+    $properties = parent::propertyDefinitions($field_definition);
+
+    $properties['summary'] = DataDefinition::create('string')
+      ->setLabel(t('Summary'));
+
+    $properties['summary_processed'] = DataDefinition::create('string')
+      ->setLabel(t('Processed summary'))
+      ->setDescription(t('The summary text with the text format applied.'))
+      ->setComputed(TRUE)
+      ->setClass('\Drupal\text\TextProcessed')
+      ->setSetting('text source', 'summary');
+
+    return $properties;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function schema(FieldStorageDefinitionInterface $field_definition) {
+    return array(
+      'columns' => array(
+        'value' => array(
+          'type' => 'text',
+          'size' => 'big',
+        ),
+        'summary' => array(
+          'type' => 'text',
+          'size' => 'big',
+        ),
+        'format' => array(
+          'type' => 'varchar_ascii',
+          'length' => 255,
+        ),
+      ),
+      'indexes' => array(
+        'format' => array('format'),
+      ),
+    );
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function isEmpty() {
+    $value = $this->get('summary')->getValue();
+    return parent::isEmpty() && ($value === NULL || $value === '');
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function fieldSettingsForm(array $form, FormStateInterface $form_state) {
+    $element = array();
+    $settings = $this->getSettings();
+
+    $element['display_summary'] = array(
+      '#type' => 'checkbox',
+      '#title' => t('Summary input'),
+      '#default_value' => $settings['display_summary'],
+      '#description' => t('This allows authors to input an explicit summary, to be displayed instead of the automatically trimmed text when using the "Summary or trimmed" display type.'),
+    );
+
+    return $element;
+  }
+
+}

core/modules/text/src/Plugin/Field/FieldWidget/TextareaWidget.php

@@ -0,0 +1,53 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Plugin\Field\FieldWidget\TextareaWidget.
+ */
+
+namespace Drupal\text\Plugin\Field\FieldWidget;
+
+use Drupal\Core\Field\FieldItemListInterface;
+use Drupal\Core\Field\Plugin\Field\FieldWidget\StringTextareaWidget;
+use Drupal\Core\Form\FormStateInterface;
+use Symfony\Component\Validator\ConstraintViolationInterface;
+
+/**
+ * Plugin implementation of the 'text_textarea' widget.
+ *
+ * @FieldWidget(
+ *   id = "text_textarea",
+ *   label = @Translation("Text area (multiple rows)"),
+ *   field_types = {
+ *     "text_long"
+ *   }
+ * )
+ */
+class TextareaWidget extends StringTextareaWidget {
+
+  /**
+   * {@inheritdoc}
+   */
+  public function formElement(FieldItemListInterface $items, $delta, array $element, array &$form, FormStateInterface $form_state) {
+    $main_widget = parent::formElement($items, $delta, $element, $form, $form_state);
+
+    $element = $main_widget['value'];
+    $element['#type'] = 'text_format';
+    $element['#format'] = $items[$delta]->format;
+    $element['#base_type'] = $main_widget['value']['#type'];
+    return $element;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function errorElement(array $element, ConstraintViolationInterface $violation, array $form, FormStateInterface $form_state) {
+    if ($violation->arrayPropertyPath == array('format') && isset($element['format']['#access']) && !$element['format']['#access']) {
+      // Ignore validation errors for formats if formats may not be changed,
+      // i.e. when existing formats become invalid. See filter_process_format().
+      return FALSE;
+    }
+    return $element;
+  }
+
+}

core/modules/text/src/Plugin/Field/FieldWidget/TextareaWithSummaryWidget.php

@@ -0,0 +1,98 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Plugin\Field\FieldWidget\TextareaWithSummaryWidget.
+ */
+
+namespace Drupal\text\Plugin\Field\FieldWidget;
+
+use Drupal\Core\Form\FormStateInterface;
+use Drupal\text\Plugin\Field\FieldWidget\TextareaWidget;
+use Symfony\Component\Validator\ConstraintViolationInterface;
+use Drupal\Core\Field\FieldItemListInterface;
+
+/**
+ * Plugin implementation of the 'text_textarea_with_summary' widget.
+ *
+ * @FieldWidget(
+ *   id = "text_textarea_with_summary",
+ *   label = @Translation("Text area with a summary"),
+ *   field_types = {
+ *     "text_with_summary"
+ *   }
+ * )
+ */
+class TextareaWithSummaryWidget extends TextareaWidget {
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function defaultSettings() {
+    return array(
+      'rows' => '9',
+      'summary_rows' => '3',
+      'placeholder' => '',
+    ) + parent::defaultSettings();
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function settingsForm(array $form, FormStateInterface $form_state) {
+    $element = parent::settingsForm($form, $form_state);
+    $element['summary_rows'] = array(
+      '#type' => 'number',
+      '#title' => t('Summary rows'),
+      '#default_value' => $this->getSetting('summary_rows'),
+      '#required' => TRUE,
+      '#min' => 1,
+    );
+    return $element;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function settingsSummary() {
+    $summary = parent::settingsSummary();
+
+    $summary[] = t('Number of summary rows: !rows', array('!rows' => $this->getSetting('summary_rows')));
+
+    return $summary;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  function formElement(FieldItemListInterface $items, $delta, array $element, array &$form, FormStateInterface $form_state) {
+    $element = parent::formElement($items, $delta, $element, $form, $form_state);
+
+    $display_summary = $items[$delta]->summary || $this->getFieldSetting('display_summary');
+    $element['summary'] = array(
+      '#type' => $display_summary ? 'textarea' : 'value',
+      '#default_value' => $items[$delta]->summary,
+      '#title' => t('Summary'),
+      '#rows' => $this->getSetting('summary_rows'),
+      '#description' => t('Leave blank to use trimmed value of full text as the summary.'),
+      '#attached' => array(
+        'library' => array('text/drupal.text'),
+      ),
+      '#attributes' => array('class' => array('js-text-summary', 'text-summary')),
+      '#prefix' => '<div class="js-text-summary-wrapper text-summary-wrapper">',
+      '#suffix' => '</div>',
+      '#weight' => -10,
+    );
+
+    return $element;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function errorElement(array $element, ConstraintViolationInterface $violation, array $form, FormStateInterface $form_state) {
+    $element = parent::errorElement($element, $violation, $form, $form_state);
+    return ($element === FALSE) ? FALSE : $element[$violation->arrayPropertyPath[0]];
+  }
+
+}

core/modules/text/src/Plugin/Field/FieldWidget/TextfieldWidget.php

@@ -0,0 +1,53 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Plugin\Field\FieldWidget\TextfieldWidget.
+ */
+
+namespace Drupal\text\Plugin\Field\FieldWidget;
+
+use Drupal\Core\Field\FieldItemListInterface;
+use Drupal\Core\Field\Plugin\Field\FieldWidget\StringTextfieldWidget;
+use Drupal\Core\Form\FormStateInterface;
+use Symfony\Component\Validator\ConstraintViolationInterface;
+
+/**
+ * Plugin implementation of the 'text_textfield' widget.
+ *
+ * @FieldWidget(
+ *   id = "text_textfield",
+ *   label = @Translation("Text field"),
+ *   field_types = {
+ *     "text"
+ *   },
+ * )
+ */
+class TextfieldWidget extends StringTextfieldWidget {
+
+  /**
+   * {@inheritdoc}
+   */
+  public function formElement(FieldItemListInterface $items, $delta, array $element, array &$form, FormStateInterface $form_state) {
+    $main_widget = parent::formElement($items, $delta, $element, $form, $form_state);
+
+    $element = $main_widget['value'];
+    $element['#type'] = 'text_format';
+    $element['#format'] = isset($items[$delta]->format) ? $items[$delta]->format : NULL;
+    $element['#base_type'] = $main_widget['value']['#type'];
+    return $element;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function errorElement(array $element, ConstraintViolationInterface $violation, array $form, FormStateInterface $form_state) {
+    if ($violation->arrayPropertyPath == array('format') && isset($element['format']['#access']) && !$element['format']['#access']) {
+      // Ignore validation errors for formats if formats may not be changed,
+      // i.e. when existing formats become invalid. See filter_process_format().
+      return FALSE;
+    }
+    return $element;
+  }
+
+}

core/modules/text/src/Tests/Formatter/TextFormatterTest.php

@@ -0,0 +1,99 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Tests\Formatter\TextFormatterTest.
+ */
+
+namespace Drupal\text\Tests\Formatter;
+
+use Drupal\filter\Entity\FilterFormat;
+use Drupal\system\Tests\Entity\EntityUnitTestBase;
+
+/**
+ * Tests the text formatters functionality.
+ *
+ * @group text
+ */
+class TextFormatterTest extends EntityUnitTestBase {
+
+  /**
+   * The entity type used in this test.
+   *
+   * @var string
+   */
+  protected $entityType = 'entity_test';
+
+  /**
+   * The bundle used in this test.
+   *
+   * @var string
+   */
+  protected $bundle = 'entity_test';
+
+  /**
+   * Modules to enable.
+   *
+   * @var array
+   */
+  public static $modules = array('text');
+
+  /**
+   * {@inheritdoc}
+   */
+  protected function setUp() {
+    parent::setUp();
+
+    entity_create('filter_format', array(
+      'format' => 'my_text_format',
+      'name' => 'My text format',
+      'filters' => array(
+        'filter_autop' => array(
+          'module' => 'filter',
+          'status' => TRUE,
+        ),
+      ),
+    ))->save();
+
+    entity_create('field_storage_config', array(
+      'field_name' => 'formatted_text',
+      'entity_type' => $this->entityType,
+      'type' => 'text',
+      'settings' => array(),
+    ))->save();
+    entity_create('field_config', array(
+      'entity_type' => $this->entityType,
+      'bundle' => $this->bundle,
+      'field_name' => 'formatted_text',
+      'label' => 'Filtered text',
+    ))->save();
+  }
+
+  /**
+   * Tests all text field formatters.
+   */
+  public function testFormatters() {
+    $formatters = array(
+      'text_default',
+      'text_trimmed',
+      'text_summary_or_trimmed',
+    );
+
+    // Create the entity to be referenced.
+    $entity = entity_create($this->entityType, array('name' => $this->randomMachineName()));
+    $entity->formatted_text = array(
+      'value' => 'Hello, world!',
+      'format' => 'my_text_format',
+    );
+    $entity->save();
+
+    foreach ($formatters as $formatter) {
+      // Verify the text field formatter's render array.
+      $build = $entity->get('formatted_text')->view(array('type' => $formatter));
+      \Drupal::service('renderer')->renderRoot($build[0]);
+      $this->assertEqual($build[0]['#markup'], "<p>Hello, world!</p>\n");
+      $this->assertEqual($build[0]['#cache']['tags'], FilterFormat::load('my_text_format')->getCacheTags(), format_string('The @formatter formatter has the expected cache tags when formatting a formatted text field.', array('@formatter' => $formatter)));
+    }
+  }
+
+}

core/modules/text/src/Tests/TextFieldTest.php

@@ -0,0 +1,187 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Tests\TextFieldTest.
+ */
+
+namespace Drupal\text\Tests;
+
+use Drupal\Component\Utility\Unicode;
+use Drupal\field\Tests\String\StringFieldTest;
+
+/**
+ * Tests the creation of text fields.
+ *
+ * @group text
+ */
+class TextFieldTest extends StringFieldTest {
+
+  /**
+   * A user with relevant administrative privileges.
+   *
+   * @var \Drupal\user\UserInterface
+   */
+  protected $adminUser;
+
+  protected function setUp() {
+    parent::setUp();
+
+    $this->adminUser = $this->drupalCreateUser(array('administer filters'));
+  }
+
+  // Test fields.
+
+  /**
+   * Test text field validation.
+   */
+  function testTextFieldValidation() {
+    // Create a field with settings to validate.
+    $max_length = 3;
+    $field_name = Unicode::strtolower($this->randomMachineName());
+    $field_storage = entity_create('field_storage_config', array(
+      'field_name' => $field_name,
+      'entity_type' => 'entity_test',
+      'type' => 'text',
+      'settings' => array(
+        'max_length' => $max_length,
+      )
+    ));
+    $field_storage->save();
+    entity_create('field_config', array(
+      'field_storage' => $field_storage,
+      'bundle' => 'entity_test',
+    ))->save();
+
+    // Test validation with valid and invalid values.
+    $entity = entity_create('entity_test');
+    for ($i = 0; $i <= $max_length + 2; $i++) {
+      $entity->{$field_name}->value = str_repeat('x', $i);
+      $violations = $entity->{$field_name}->validate();
+      if ($i <= $max_length) {
+        $this->assertEqual(count($violations), 0, "Length $i does not cause validation error when max_length is $max_length");
+      }
+      else {
+        $this->assertEqual(count($violations), 1, "Length $i causes validation error when max_length is $max_length");
+      }
+    }
+  }
+
+  /**
+   * Test widgets.
+   */
+  function testTextfieldWidgets() {
+    $this->_testTextfieldWidgets('text', 'text_textfield');
+    $this->_testTextfieldWidgets('text_long', 'text_textarea');
+  }
+
+  /**
+   * Test widgets + 'formatted_text' setting.
+   */
+  function testTextfieldWidgetsFormatted() {
+    $this->_testTextfieldWidgetsFormatted('text', 'text_textfield');
+    $this->_testTextfieldWidgetsFormatted('text_long', 'text_textarea');
+  }
+
+  /**
+   * Helper function for testTextfieldWidgetsFormatted().
+   */
+  function _testTextfieldWidgetsFormatted($field_type, $widget_type) {
+    /** @var \Drupal\Core\Render\RendererInterface $renderer */
+    $renderer = $this->container->get('renderer');
+
+    // Create a field.
+    $field_name = Unicode::strtolower($this->randomMachineName());
+    $field_storage = entity_create('field_storage_config', array(
+      'field_name' => $field_name,
+      'entity_type' => 'entity_test',
+      'type' => $field_type
+    ));
+    $field_storage->save();
+    entity_create('field_config', array(
+      'field_storage' => $field_storage,
+      'bundle' => 'entity_test',
+      'label' => $this->randomMachineName() . '_label',
+    ))->save();
+    entity_get_form_display('entity_test', 'entity_test', 'default')
+      ->setComponent($field_name, array(
+        'type' => $widget_type,
+      ))
+      ->save();
+    entity_get_display('entity_test', 'entity_test', 'full')
+      ->setComponent($field_name)
+      ->save();
+
+    // Disable all text formats besides the plain text fallback format.
+    $this->drupalLogin($this->adminUser);
+    foreach (filter_formats() as $format) {
+      if (!$format->isFallbackFormat()) {
+        $this->drupalPostForm('admin/config/content/formats/manage/' . $format->id() . '/disable', array(), t('Disable'));
+      }
+    }
+    $this->drupalLogin($this->webUser);
+
+    // Display the creation form. Since the user only has access to one format,
+    // no format selector will be displayed.
+    $this->drupalGet('entity_test/add');
+    $this->assertFieldByName("{$field_name}[0][value]", '', 'Widget is displayed');
+    $this->assertNoFieldByName("{$field_name}[0][format]", '', 'Format selector is not displayed');
+
+    // Submit with data that should be filtered.
+    $value = '<em>' . $this->randomMachineName() . '</em>';
+    $edit = array(
+      "{$field_name}[0][value]" => $value,
+    );
+    $this->drupalPostForm(NULL, $edit, t('Save'));
+    preg_match('|entity_test/manage/(\d+)|', $this->url, $match);
+    $id = $match[1];
+    $this->assertText(t('entity_test @id has been created.', array('@id' => $id)), 'Entity was created');
+
+    // Display the entity.
+    $entity = entity_load('entity_test', $id);
+    $display = entity_get_display($entity->getEntityTypeId(), $entity->bundle(), 'full');
+    $content = $display->build($entity);
+    $this->setRawContent($renderer->renderRoot($content));
+    $this->assertNoRaw($value, 'HTML tags are not displayed.');
+    $this->assertEscaped($value, 'Escaped HTML is displayed correctly.');
+
+    // Create a new text format that does not escape HTML, and grant the user
+    // access to it.
+    $this->drupalLogin($this->adminUser);
+    $edit = array(
+      'format' => Unicode::strtolower($this->randomMachineName()),
+      'name' => $this->randomMachineName(),
+    );
+    $this->drupalPostForm('admin/config/content/formats/add', $edit, t('Save configuration'));
+    filter_formats_reset();
+    $format = entity_load('filter_format', $edit['format']);
+    $format_id = $format->id();
+    $permission = $format->getPermissionName();
+    $roles = $this->webUser->getRoles();
+    $rid = $roles[0];
+    user_role_grant_permissions($rid, array($permission));
+    $this->drupalLogin($this->webUser);
+
+    // Display edition form.
+    // We should now have a 'text format' selector.
+    $this->drupalGet('entity_test/manage/' . $id);
+    $this->assertFieldByName("{$field_name}[0][value]", NULL, 'Widget is displayed');
+    $this->assertFieldByName("{$field_name}[0][format]", NULL, 'Format selector is displayed');
+
+    // Edit and change the text format to the new one that was created.
+    $edit = array(
+      "{$field_name}[0][format]" => $format_id,
+    );
+    $this->drupalPostForm(NULL, $edit, t('Save'));
+    $this->assertText(t('entity_test @id has been updated.', array('@id' => $id)), 'Entity was updated');
+
+    // Display the entity.
+    $this->container->get('entity.manager')->getStorage('entity_test')->resetCache(array($id));
+    $entity = entity_load('entity_test', $id);
+    $display = entity_get_display($entity->getEntityTypeId(), $entity->bundle(), 'full');
+    $content = $display->build($entity);
+    $this->setRawContent($renderer->renderRoot($content));
+    $this->assertRaw($value, 'Value is displayed unfiltered');
+  }
+
+}

core/modules/text/src/Tests/TextSummaryTest.php

@@ -0,0 +1,221 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Tests\TextSummaryTest.
+ */
+
+namespace Drupal\text\Tests;
+
+use Drupal\simpletest\KernelTestBase;
+
+/**
+ * Tests text_summary() with different strings and lengths.
+ *
+ * @group text
+ */
+class TextSummaryTest extends KernelTestBase {
+
+  public static $modules = array('system', 'user', 'filter', 'text');
+
+  protected function setUp() {
+    parent::setUp();
+
+    $this->installSchema('system', 'url_alias');
+    $this->installConfig(array('text'));
+  }
+
+  /**
+   * Tests an edge case where the first sentence is a question and
+   * subsequent sentences are not. This edge case is documented at
+   * https://www.drupal.org/node/180425.
+   */
+  function testFirstSentenceQuestion() {
+    $text = 'A question? A sentence. Another sentence.';
+    $expected = 'A question? A sentence.';
+    $this->assertTextSummary($text, $expected, NULL, 30);
+  }
+
+  /**
+   * Test summary with long example.
+   */
+  function testLongSentence() {
+    $text = 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. ' . // 125
+            'Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. ' . // 108
+            'Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. ' . // 103
+            'Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.'; // 110
+    $expected = 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. ' .
+                'Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. ' .
+                'Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.';
+    // First three sentences add up to: 336, so add one for space and then 3 to get half-way into next word.
+    $this->assertTextSummary($text, $expected, NULL, 340);
+  }
+
+  /**
+   * Test various summary length edge cases.
+   */
+  function testLength() {
+    entity_create('filter_format', array(
+      'format' => 'autop',
+      'filters' => array(
+        'filter_autop' => array(
+          'status' => 1,
+        ),
+      ),
+    ))->save();
+    entity_create('filter_format', array(
+      'format' => 'autop_correct',
+      'filters' => array(
+        'filter_autop' => array(
+          'status' => 1,
+        ),
+        'filter_htmlcorrector' => array(
+          'status' => 1,
+        ),
+      ),
+    ))->save();
+
+    // This string tests a number of edge cases.
+    $text = "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>";
+
+    // The summaries we expect text_summary() to return when $size is the index
+    // of each array item.
+    // Using no text format:
+    $format = NULL;
+    $i = 0;
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<", $format, $i++);
+    $this->assertTextSummary($text, "<p", $format, $i++);
+    $this->assertTextSummary($text, "<p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\n", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nH", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n<", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+
+    // Using a text format with filter_autop enabled.
+    $format = 'autop';
+    $i = 0;
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<", $format, $i++);
+    $this->assertTextSummary($text, "<p", $format, $i++);
+    $this->assertTextSummary($text, "<p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+
+    // Using a text format with filter_autop and filter_htmlcorrector enabled.
+    $format = 'autop_correct';
+    $i = 0;
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "", $format, $i++);
+    $this->assertTextSummary($text, "<p></p>", $format, $i++);
+    $this->assertTextSummary($text, "<p></p>", $format, $i++);
+    $this->assertTextSummary($text, "<p></p>", $format, $i++);
+    $this->assertTextSummary($text, "<p></p>", $format, $i++);
+    $this->assertTextSummary($text, "<p></p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+    $this->assertTextSummary($text, "<p>\nHi\n</p>\n<p>\nfolks\n<br />\n!\n</p>", $format, $i++);
+  }
+
+  /**
+   * Calls text_summary() and asserts that the expected teaser is returned.
+   */
+  function assertTextSummary($text, $expected, $format = NULL, $size = NULL) {
+    $summary = text_summary($text, $format, $size);
+    $this->assertIdentical($summary, $expected, format_string('<pre style="white-space: pre-wrap">@actual</pre> is identical to <pre style="white-space: pre-wrap">@expected</pre>', array(
+      '@actual' => $summary,
+      '@expected' => $expected,
+    )));
+  }
+
+}

core/modules/text/src/Tests/TextWithSummaryItemTest.php

@@ -0,0 +1,117 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\Tests\TextWithSummaryItemTest.
+ */
+
+namespace Drupal\text\Tests;
+
+use Drupal\Core\Field\FieldItemListInterface;
+use Drupal\Core\Field\FieldItemInterface;
+use Drupal\field\Tests\FieldUnitTestBase;
+
+/**
+ * Tests using entity fields of the text summary field type.
+ *
+ * @group text
+ */
+class TextWithSummaryItemTest extends FieldUnitTestBase {
+
+  /**
+   * Modules to enable.
+   *
+   * @var array
+   */
+  public static $modules = array('filter');
+
+  /**
+   * Field storage entity.
+   *
+   * @var \Drupal\field\Entity\FieldStorageConfig.
+   */
+  protected $fieldStorage;
+
+  /**
+   * Field entity.
+   *
+   * @var \Drupal\field\Entity\FieldConfig
+   */
+  protected $field;
+
+
+  protected function setUp() {
+    parent::setUp();
+
+    $this->installEntitySchema('entity_test_rev');
+
+    // Create the necessary formats.
+    $this->installConfig(array('filter'));
+    entity_create('filter_format', array(
+      'format' => 'no_filters',
+      'filters' => array(),
+    ))->save();
+  }
+
+  /**
+   * Tests processed properties.
+   */
+  public function testCrudAndUpdate() {
+    $entity_type = 'entity_test';
+    $this->createField($entity_type);
+
+    // Create an entity with a summary and no text format.
+    $entity = entity_create($entity_type);
+    $entity->summary_field->value = $value = $this->randomMachineName();
+    $entity->summary_field->summary = $summary = $this->randomMachineName();
+    $entity->summary_field->format = NULL;
+    $entity->name->value = $this->randomMachineName();
+    $entity->save();
+
+    $entity = entity_load($entity_type, $entity->id());
+    $this->assertTrue($entity->summary_field instanceof FieldItemListInterface, 'Field implements interface.');
+    $this->assertTrue($entity->summary_field[0] instanceof FieldItemInterface, 'Field item implements interface.');
+    $this->assertEqual($entity->summary_field->value, $value);
+    $this->assertEqual($entity->summary_field->summary, $summary);
+    $this->assertNull($entity->summary_field->format);
+    // Even if no format is given, if text processing is enabled, the default
+    // format is used.
+    $this->assertEqual($entity->summary_field->processed, "<p>$value</p>\n");
+    $this->assertEqual($entity->summary_field->summary_processed, "<p>$summary</p>\n");
+
+    // Change the format, this should update the processed properties.
+    $entity->summary_field->format = 'no_filters';
+    $this->assertEqual($entity->summary_field->processed, $value);
+    $this->assertEqual($entity->summary_field->summary_processed, $summary);
+
+    // Test the generateSampleValue() method.
+    $entity = entity_create($entity_type);
+    $entity->summary_field->generateSampleItems();
+    $this->entityValidateAndSave($entity);
+  }
+
+  /**
+   * Creates a text_with_summary field storage and field.
+   *
+   * @param string $entity_type
+   *   Entity type for which the field should be created.
+   */
+  protected function createField($entity_type) {
+    // Create a field .
+    $this->fieldStorage = entity_create('field_storage_config', array(
+      'field_name' => 'summary_field',
+      'entity_type' => $entity_type,
+      'type' => 'text_with_summary',
+      'settings' => array(
+        'max_length' => 10,
+      )
+    ));
+    $this->fieldStorage->save();
+    $this->field = entity_create('field_config', array(
+      'field_storage' => $this->fieldStorage,
+      'bundle' => $entity_type,
+    ));
+    $this->field->save();
+  }
+
+}

core/modules/text/src/TextProcessed.php

@@ -0,0 +1,74 @@
+<?php
+
+/**
+ * @file
+ * Contains \Drupal\text\TextProcessed.
+ */
+
+namespace Drupal\text;
+
+use Drupal\Component\Utility\SafeMarkup;
+use Drupal\Core\TypedData\DataDefinitionInterface;
+use Drupal\Core\TypedData\TypedDataInterface;
+use Drupal\Core\TypedData\TypedData;
+
+/**
+ * A computed property for processing text with a format.
+ *
+ * Required settings (below the definition's 'settings' key) are:
+ *  - text source: The text property containing the to be processed text.
+ */
+class TextProcessed extends TypedData {
+
+  /**
+   * Cached processed text.
+   *
+   * @var string|null
+   */
+  protected $processed = NULL;
+
+  /**
+   * Overrides TypedData::__construct().
+   */
+  public function __construct(DataDefinitionInterface $definition, $name = NULL, TypedDataInterface $parent = NULL) {
+    parent::__construct($definition, $name, $parent);
+
+    if ($definition->getSetting('text source') === NULL) {
+      throw new \InvalidArgumentException("The definition's 'text source' key has to specify the name of the text property to be processed.");
+    }
+  }
+
+  /**
+   * Implements \Drupal\Core\TypedData\TypedDataInterface::getValue().
+   */
+  public function getValue($langcode = NULL) {
+    if ($this->processed !== NULL) {
+      return $this->processed;
+    }
+
+    $item = $this->getParent();
+    $text = $item->{($this->definition->getSetting('text source'))};
+
+    // Avoid running check_markup() or
+    // \Drupal\Component\Utility\SafeMarkup::checkPlain() on empty strings.
+    if (!isset($text) || $text === '') {
+      $this->processed = '';
+    }
+    else {
+      $this->processed = check_markup($text, $item->format, $item->getLangcode());
+    }
+    return $this->processed;
+  }
+
+  /**
+   * Implements \Drupal\Core\TypedData\TypedDataInterface::setValue().
+   */
+  public function setValue($value, $notify = TRUE) {
+    $this->processed = $value;
+    // Notify the parent of any changes.
+    if ($notify && isset($this->parent)) {
+      $this->parent->onChange($this->name);
+    }
+  }
+
+}