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

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

>中，并注釋如下：> 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 {
}

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

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

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

formatters()

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

>配置摘要和設(shè)置表單

> 方法提供了所選配置的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ù)語格式。 記住要注入服務(wù)，而不是在生產(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)的功能和靈活性。 請記住在實(shí)施代碼后清除緩存。 這種增強(qiáng)的方法為擴(kuò)展顯示套件功能提供了一種可靠且可維護(hù)的方法。>