3 namespace Drupal\Core\Field;
5 use Drupal\Core\Entity\FieldableEntityInterface;
6 use Drupal\Core\Form\FormStateInterface;
9 * Defines a item list class for entity reference fields.
11 class EntityReferenceFieldItemList extends FieldItemList implements EntityReferenceFieldItemListInterface {
16 public function getConstraints() {
17 $constraints = parent::getConstraints();
18 $constraint_manager = $this->getTypedDataManager()->getValidationConstraintManager();
19 $constraints[] = $constraint_manager->create('ValidReference', []);
26 public function referencedEntities() {
27 if ($this->isEmpty()) {
31 // Collect the IDs of existing entities to load, and directly grab the
32 // "autocreate" entities that are already populated in $item->entity.
33 $target_entities = $ids = [];
34 foreach ($this->list as $delta => $item) {
35 if ($item->target_id !== NULL) {
36 $ids[$delta] = $item->target_id;
38 elseif ($item->hasNewEntity()) {
39 $target_entities[$delta] = $item->entity;
43 // Load and add the existing entities.
45 $target_type = $this->getFieldDefinition()->getSetting('target_type');
46 $entities = \Drupal::entityManager()->getStorage($target_type)->loadMultiple($ids);
47 foreach ($ids as $delta => $target_id) {
48 if (isset($entities[$target_id])) {
49 $target_entities[$delta] = $entities[$target_id];
52 // Ensure the returned array is ordered by deltas.
53 ksort($target_entities);
56 return $target_entities;
62 public static function processDefaultValue($default_value, FieldableEntityInterface $entity, FieldDefinitionInterface $definition) {
63 $default_value = parent::processDefaultValue($default_value, $entity, $definition);
66 // Convert UUIDs to numeric IDs.
68 foreach ($default_value as $delta => $properties) {
69 if (isset($properties['target_uuid'])) {
70 $uuids[$delta] = $properties['target_uuid'];
74 $target_type = $definition->getSetting('target_type');
75 $entity_ids = \Drupal::entityQuery($target_type)
76 ->condition('uuid', $uuids, 'IN')
78 $entities = \Drupal::entityManager()
79 ->getStorage($target_type)
80 ->loadMultiple($entity_ids);
83 foreach ($entities as $id => $entity) {
84 $entity_uuids[$entity->uuid()] = $id;
86 foreach ($uuids as $delta => $uuid) {
87 if (isset($entity_uuids[$uuid])) {
88 $default_value[$delta]['target_id'] = $entity_uuids[$uuid];
89 unset($default_value[$delta]['target_uuid']);
92 unset($default_value[$delta]);
97 // Ensure we return consecutive deltas, in case we removed unknown UUIDs.
98 $default_value = array_values($default_value);
100 return $default_value;
106 public function defaultValuesFormSubmit(array $element, array &$form, FormStateInterface $form_state) {
107 $default_value = parent::defaultValuesFormSubmit($element, $form, $form_state);
109 // Convert numeric IDs to UUIDs to ensure config deployability.
111 foreach ($default_value as $delta => $properties) {
112 if (isset($properties['entity']) && $properties['entity']->isNew()) {
113 // This may be a newly created term.
114 $properties['entity']->save();
115 $default_value[$delta]['target_id'] = $properties['entity']->id();
116 unset($default_value[$delta]['entity']);
118 $ids[] = $default_value[$delta]['target_id'];
120 $entities = \Drupal::entityManager()
121 ->getStorage($this->getSetting('target_type'))
122 ->loadMultiple($ids);
124 foreach ($default_value as $delta => $properties) {
125 unset($default_value[$delta]['target_id']);
126 $default_value[$delta]['target_uuid'] = $entities[$properties['target_id']]->uuid();
128 return $default_value;