>插件類型。 我們不是_info，而是在其方法的註釋和邏輯中構(gòu)建一個帶有元數(shù)據(jù)的插件類。 DsField> hook_ds_field_info()

插件類VocabularyTerms> >我們的示例創(chuàng)建了一個DS字段（在名為“演示”的自定義模塊中），顯示了可配置詞彙的分類術(shù)語，僅限於文章節(jié)點。 插件類（

>中，並註釋如下：> VocabularyTerms src/plugins/DsField

namespace Drupal\demo\Plugin\DsField;

use Drupal\ds\Plugin\DsField\DsFieldBase;

/**
 * Plugin displaying terms from a selected taxonomy vocabulary.
 *
 * @DsField(
 *   id = "vocabulary_terms",
 *   title = @Translation("Vocabulary Terms"),
 *   entity_type = "node",
 *   provider = "demo",
 *   ui_limit = {"article|*"}
 * )
 */
class VocabularyTerms extends DsFieldBase {
}

為了允許詞彙選擇，我們實現(xiàn)了設置默認詞彙（“ tags”）：

defaultConfiguration()formatters（例如，鏈接或未鏈接的術(shù)語列表）是使用

/**
 * {@inheritdoc}
 */
public function defaultConfiguration() {
  return ['vocabulary' => 'tags'];
}

formatters()

/**
 * {@inheritdoc}
 */
public function formatters() {
  return ['linked' => 'Linked', 'unlinked' => 'Unlinked'];
}

>配置摘要和設置表單

> 方法提供了所選配置的UI摘要：>

settingsSummary()

/**
 * {@inheritdoc}
 */
public function settingsSummary($settings) {
  $config = $this->getConfiguration();
  return isset($config['vocabulary']) && $config['vocabulary'] ? ['Vocabulary: ' . \Drupal::entityTypeManager()->getStorage('taxonomy_vocabulary')->load($config['vocabulary'])->label()] : ['No vocabulary selected.'];
}

方法創(chuàng)建用於詞彙選擇的UI：>

settingsForm()

/**
 * {@inheritdoc}
 */
public function settingsForm($form, FormStateInterface $form_state) {
  $config = $this->getConfiguration();
  $vocabularies = \Drupal::entityTypeManager()->getStorage('taxonomy_vocabulary')->loadMultiple();
  $options = [];
  foreach ($vocabularies as $vocabulary) {
    $options[$vocabulary->id()] = $vocabulary->label();
  }
  $form['vocabulary'] = [
    '#type' => 'select',
    '#title' => $this->t('Vocabulary'),
    '#default_value' => $config['vocabulary'],
    '#options' => $options,
  ];
  return $form;
}

方法查詢並呈現(xiàn)術(shù)語：> 輔助方法（

）根據(jù)所選格式處理術(shù)語格式。 記住要注入服務，而不是在生產(chǎn)環(huán)境中使用靜態(tài)調(diào)用。 build()

/**
 * {@inheritdoc}
 */
public function build() {
  $config = $this->getConfiguration();
  if (!isset($config['vocabulary']) || !$config['vocabulary']) {
    return [];
  }

  $query = \Drupal::entityTypeManager()->getStorage('taxonomy_term')->getQuery();
  $query->condition('vid', $config['vocabulary']);
  $tids = $query->execute();
  $terms = \Drupal::entityTypeManager()->getStorage('taxonomy_term')->loadMultiple($tids);

  return [
    '#theme' => 'item_list',
    '#items' => $this->buildTermList($terms),
  ];
}

buildTermList()buildTermListItem()結(jié)論

該綜合指南演示了在Drupal 8中創(chuàng)建自定義DS字段，並展示了插件系統(tǒng)的功能和靈活性。 請記住在實施代碼後清除緩存。 這種增強的方法為擴展顯示套件功能提供了一種可靠且可維護的方法。 >