コアポイント

• Drupal 8は、ブロックの新しい概念をプラグインとして導(dǎo)入し、サイト全體に再利用できるようにします。ブロックはUIで作成し、複數(shù)回使用できます。
Drupal 8では、構(gòu)成可能なテキストを返すカスタムブロックを作成できます。これは、UIに新しいブロックタイプを作成し、サイト全體で再利用することで実行できます。
Drupal 8を使用すると、ブロックに構(gòu)成フォームを追加できます。これにより、ユーザーはブロックを編集し、テキストフィールドに名前を指定すると、ブロックがその名前に挨拶を表示します。
Drupal 8モジュール開発には、単純なフォームの作成が含まれます。フォーム定義関數(shù)は、クラスでグループ化されます。提出されたフォーム値は、畫面に単純に印刷されて、どのように機(jī)能するかを示します。
• Drupal 8では、カスタムモジュールでフォームクラスを定義することにより、カスタムフォームを作成できます。フォームクラスは、「Formbase」クラスを拡張し、3つのメソッドを?qū)g裝する必要があります。

執(zhí)筆時(shí)點(diǎn)でDrupal 8の進(jìn)行中の開発プロセスにより、一部のコードパーツが時(shí)代遅れになる可能性があることに注意してください。このリポジトリをチェックしてください。サンプルコードを更新して、最新のDrupal 8バージョンで動(dòng)作させるようにしました。

このシリーズの最初の部分では、基本から始めてDrupal 8モジュール開発を?qū)Wびます。 Drupalがモジュールに必要なファイルをどのように理解しているか、ルーティングプロセスの仕組み、および構(gòu)成方法でプログラムでメニューリンクを作成する方法を?qū)Wびました。 このチュートリアルでは、このリポジトリにあるサンドボックスモジュールをさらに見て、ブロックとフォームの2つの重要な機(jī)能を調(diào)べます。これを行うには、構(gòu)成可能なテキストを返すカスタムブロックを作成します。その後、ユーザーがサビされた値を畫面に印刷するためのシンプルなフォームを作成します。

drupal 8ブロック

D8のブロックAPIのクールな新しい変更は、プラグインとしてそれらを作成することにより、ブロックをより顕著にすることです（まったく新しい概念）。これは、UIにブロックを作成してサイト全體で再利用できるため、再利用可能な機(jī)能（バックグラウンド）であることを意味します。1回だけのブロックを使用することに限定されなくなりました。 デフォルトで畫面に印刷するシンプルなブロックタイプを作成しましょう

hello world！

。モジュールのルートにあるSRC/プラグイン/ブロックフォルダーでクラスファイルを使用する必要があります。もちろん、新しいブロックタイプのデモブロックに名前を付けましょう。もちろん、demoblock.phpという名前のファイルにある必要があります。このファイルでは、以下から始めることができます。

<?php
namespace Drupal\demo\Plugin\Block;

use Drupal\block\BlockBase;
use Drupal\Core\Session\AccountInterface;

/**
 * Provides a 'Demo' block.
 *
 * @Block(
 *   id = "demo_block",
 *   admin_label = @Translation("Demo block"),
 * )
 */

class DemoBlock extends BlockBase {

  /**
   * {@inheritdoc}
   */
  public function build() {
    return array(
      '#markup' => $this->t('Hello World!'),
    );
  }

  /**
   * {@inheritdoc}
   */
  public function access(AccountInterface $account) {
    return $account->hasPermission('access content');
  }

}

他のすべてのクラスファイルと同様に、クラスの最初の名前を付けます。次に、ブロックベースクラスを使用して、拡張できるようにし、AccountInterfaceクラスを使用して、現(xiàn)在ログインしているユーザーにアクセスできるようにします。次は、Drupal 7：コメントで確かに見たことがないものです。

アノテーションは、クラス定義と同じファイルのコメントブロックにあるPHPディスカバリーツールです。これらのアノテーションを使用して、Drupalに、ID demo_blockおよびadmin_labelを

demo block（翻訳システムに渡す）で新しいブロックタイプ（@block）を登録したいことを知らせます。

次に、ブロックベースクラスを獨(dú)自のデモブロックに拡張し、2つの方法（実裝する最も一般的な方法）を?qū)g裝します。 Build（）メソッドは、ブロックが印刷するレンダリング可能な配列を返すため、最も重要です。 Access（）メソッドは、アクセスを制御してこのブロックを表示します。それに渡された引數(shù)は、AccountInterfaceクラスのインスタンスであり、その場(chǎng)合は現(xiàn)在のユーザーです。

注意すべきもう1つの興味深いことは、翻訳にグローバルにt（）関數(shù)を使用せず、代わりにクラスの親クラスで実裝されているt（）メソッドを參照することです。

それだけです。キャッシュをクリアして、ブロックレイアウト構(gòu)成ページに移動(dòng)できます。クールなことは、右側(cè)にブロックタイプがあること（それらを通してフィルタリングできる）で、これらの種類のブロックの1つ以上をサイトのさまざまな領(lǐng)域に配置できることです。

DRUPAL 8ブロック構(gòu)成< UIで使用する新しいブロックタイプを作成する方法を?qū)Wんだので、APIをより深く掘り下げて、構(gòu)成フォームを追加しましょう。ブロックを編集し、テキストフィールドに名前を指定することを可能にします。ブロックは、world

に挨拶するのではなく、その名前に挨拶します。

最初に、テキストフィールドを含むフォームを定義する必要があります。したがって、デモブロッククラスでは、blockform（）と呼ばれる新しいメソッドを追加できます。

このフォームAPI実裝は、Drupal 7に非常によく似ている必要があります。ただし、ここにはいくつかの新しいコンテンツがあります。最初に、親クラスから$フォーム配列を取得します（したがって、獨(dú)自のフィールドを追加して既存のフォームを構(gòu)築します）。標(biāo)準(zhǔn)のoopのもの。次に、このブロックの構(gòu)成を取得して保存します。ブロックベースクラスは、これを行うgetConfiguration（）メソッドを定義します。 demo_block_settings値を#default_valueが設(shè)定された場(chǎng)合に備えて配置します。

次に、このフォームの提出ハンドラーであり、フィールドの値を処理し、Chunkの構(gòu)成に保存します。

/**
 * {@inheritdoc}
 */
public function blockForm($form, &$form_state) {

  $form = parent::blockForm($form, $form_state);

  $config = $this->getConfiguration();

  $form['demo_block_settings'] = array(
    '#type' => 'textfield',
    '#title' => $this->t('Who'),
    '#description' => $this->t('Who do you want to say hello to?'),
    '#default_value' => isset($config['demo_block_settings']) ? $config['demo_block_settings'] : '',
  );

  return $form;
}

このメソッドはデモブロッククラスにもあり、それが行うのは、Demo_block_settingsフィールドの値をブロック構(gòu)成の新しいアイテムとして保存することだけです（一貫性のためのキーと同じ名前を使用）。

最後に、尋ねる名前を含めるには、build（）メソッドを調(diào)整する必要があります：

<?php
namespace Drupal\demo\Plugin\Block;

use Drupal\block\BlockBase;
use Drupal\Core\Session\AccountInterface;

/**
 * Provides a 'Demo' block.
 *
 * @Block(
 *   id = "demo_block",
 *   admin_label = @Translation("Demo block"),
 * )
 */

class DemoBlock extends BlockBase {

  /**
   * {@inheritdoc}
   */
  public function build() {
    return array(
      '#markup' => $this->t('Hello World!'),
    );
  }

  /**
   * {@inheritdoc}
   */
  public function access(AccountInterface $account) {
    return $account->hasPermission('access content');
  }

}

これまでのところ、これは非常に簡(jiǎn)単に見えるはずです。私たちは、ブロックの構(gòu)成を検索し、フィールドの値が設(shè)定されている場(chǎng)合は、印刷されたステートメントに使用します。そうでない場(chǎng)合、一般的なステートメントが使用されます。ゾーンに割り當(dāng)てたブロックを編集し、要求する名前を追加することで、キャッシュをクリアしてテストできます。注意すべきことの1つは、畫面に印刷する際にユーザーの入力をクリーンアップする責(zé)任がまだあるということです。簡(jiǎn)潔にするために、私はこれらの手順を含めませんでした。

drupal 8 form

このチュートリアルで探索する最後のことは、シンプルなフォームを作成する方法です。スペースの制限のため、その構(gòu)成管理の側(cè)面（フォームで送信された構(gòu)成値を保存する）をカバーしません。代わりに、送信された値が畫面に単純に印刷されて、どのように機(jī)能するかを示す単純なフォーム定義を説明します。

Drupal 8では、フォーム定義関數(shù)がクラスにグループ化されています。それでは、src/form/demoform.phpで単純なDemoformクラスを定義しましょう。

OOPの側(cè)面とは別に、すべてがDrupal 7に非常に似ている必要があります。フォームAPIはほとんど変更されていません（いくつかの新しいフォーム要素とそのようなカプセル化を追加することを除きます）。では、上記で何が起こったのでしょうか？

/**
 * {@inheritdoc}
 */
public function blockForm($form, &$form_state) {

  $form = parent::blockForm($form, $form_state);

  $config = $this->getConfiguration();

  $form['demo_block_settings'] = array(
    '#type' => 'textfield',
    '#title' => $this->t('Who'),
    '#description' => $this->t('Who do you want to say hello to?'),
    '#default_value' => isset($config['demo_block_settings']) ? $config['demo_block_settings'] : '',
  );

  return $form;
}

最初に、クラスに名前を付け、

コアフォームベースクラスを使用して、獨(dú)自のDemoFormクラスで拡張できるようにします。次に、4つのメソッドを?qū)g裝します。そのうち3つは非常に馴染みがあるはずです。 getFormid（）メソッドは新しくて必須であり、フォームのマシン名を返すためにのみ使用されます。 buildform（）メソッドは再び必須であり、フォームを構(gòu)築します。どうやって？ Drupal 7から慣れているように。 VALIDATEFORM（）メソッドはオプションであり、その目的もD7から非常に明確にする必要があります。最後に、submitform（）メソッドはコミット処理を?qū)g行します。非常に論理的で整理されています。

では、このフォームで何を達(dá)成したいですか？ユーザーに記入したい電子メールフィールド（Drupal 8の新しいフォーム要素）があります。デフォルトでは、Drupalは入力された値が実際に電子メールアドレスであるかどうかをチェックします。しかし、検証関數(shù)では、それが.comの電子メールアドレスであることを確認(rèn)し、そうでない場(chǎng)合は、そのフィールドにフォームエラーを設(shè)定します。最後に、送信ハンドラーはページにメッセージを印刷するだけです。

このフォームを使用するために必要な最後のことは、ルートを提供することです。したがって、demo.routing.ymlファイルを編集して、次を追加します。

これは、前の投稿で簡(jiǎn)単なページをルーティングしたものと似ている必要があります。唯一の重要な違いは、デフォルトでは_FORMを使用して、ターゲットがフォームクラスであることを指定することです。したがって、値は作成したクラス名です。

キャッシュをクリアしてデモ/フォームに移動(dòng)してフォームを表示してテストします。

/**
* {@inheritdoc}
*/
public function blockSubmit($form, &$form_state) {

 $this->setConfigurationValue('demo_block_settings', $form_state['values']['demo_block_settings']);

}

Drupal_get_form（）に精通していて、以前にDrupal 7で行ったようなフォームをロードする方法を知りたい場(chǎng)合、答えはグローバルDrupalクラスにあります。フォームを取得するには、そのformbuilder（）メソッドを使用して、次のことを行うことができます。

<?php
namespace Drupal\demo\Plugin\Block;

use Drupal\block\BlockBase;
use Drupal\Core\Session\AccountInterface;

/**
 * Provides a 'Demo' block.
 *
 * @Block(
 *   id = "demo_block",
 *   admin_label = @Translation("Demo block"),
 * )
 */

class DemoBlock extends BlockBase {

  /**
   * {@inheritdoc}
   */
  public function build() {
    return array(
      '#markup' => $this->t('Hello World!'),
    );
  }

  /**
   * {@inheritdoc}
   */
  public function access(AccountInterface $account) {
    return $account->hasPermission('access content');
  }

}

$フォームを返すことができます。これは、フォームのレンダリング可能な配列になります。

結(jié)論

この記事では、Drupal 8モジュールの開発を調(diào)査し、ブロックとフォームの2つの新しいトピックを紹介し続けます。 UIでブロックを作成するために使用できる獨(dú)自のブロックタイプを作成する方法を?qū)Wびました。また、カスタム構(gòu)成を追加し、後で使用するために値を保存する方法も學(xué)びました。フォームに関しては、Formbaseクラスの簡(jiǎn)単な実裝が見られました。これは、ユーザーがサビされた値を畫面に印刷するために使用しています。

次のチュートリアルでは、構(gòu)成フォームについてすぐに學(xué)びます。 Drupal 8構(gòu)成システムを使用して、ユーザーがサビされた値を保存します。さらに、サービスコンテナと依存関係の注入と、Drupal 8での作業(yè)方法について學(xué)びます。じゃあね。

Drupal 8モジュールの構(gòu)築に関するよくある質(zhì)問：ブロックとフォーム（FAQ）

Drupal 8モジュールの基本構(gòu)造は何ですか？

Drupal 8モジュールは、基本的に特定の機(jī)能を含むファイルのセットであり、PHPで記述されています。 Drupal 8モジュールの基本構(gòu)造には、.info.ymlファイル、.moduleファイル、および.css、.js、.twigなどのその他のオプションファイルが含まれます。 .info.ymlファイルは、モジュールの名前、説明、パッケージ、タイプ、およびコア互換性をリストするために使用されます。 .moduleファイルは、実際のP??HPコードの配置場(chǎng)所です。

Drupal 8でカスタムブロックを作成する方法は？

Drupal 8でカスタムブロックを作成するには、新しいカスタムモジュールの作成とブロックプラグインの定義が含まれます。ブロックプラグインは、ブロックのプロパティとメソッドを定義するPHPクラスファイルです。モジュールの「SRC/プラグイン/ブロック」ディレクトリに配置する必要があります。ブロックプラグインクラスは、「ブロックベース」クラスを拡張し、「build（）」メソッドを?qū)g裝して、ブロックコンテンツのレンダリング可能な配列を返す必要があります。

Drupal 8でカスタムフォームを作成する方法は？

Drupal 8でカスタムフォームを作成するには、新しいカスタムモジュールを作成し、そこでフォームクラスを定義することが含まれます。フォームクラスは、フォームのプロパティとメソッドを定義するPHPクラスファイルです。モジュールの「src/form」ディレクトリに配置する必要があります。フォームクラスは、「Formbase」クラスを拡張し、3つのメソッドを?qū)g裝する必要があります。 「buildform（）」メソッドはフォームアレイを返し、「submitform（）」メソッドはフォームの送信を処理します。

Drupal 8サイトの特定の領(lǐng)域にブロックを表示する方法は？

Drupal 8サイトの特定の領(lǐng)域にブロックを表示するには、管理インターフェイスのブロックレイアウトページに移動(dòng)する必要があります。ここでは、ブロックをトピックのあらゆる領(lǐng)域に割り當(dāng)てることができます。パス、コンテンツタイプ、ユーザーロールなどに基づいて、ブロックの可視性設(shè)定を構(gòu)成することもできます。

Drupal 8カスタムフォームの入力を確認(rèn)する方法は？

drupal 8カスタムフォームへの入力を確認(rèn)するには、フォームクラスの「validateform（）」メソッドをオーバーライドできます。フォームを送信するとき、この方法は「submitform（）」メソッドの前に呼び出されます。 「validateform（）」メソッドでは、検証ロジックを追加し、「setError（）」メソッドを呼び出して、フォーム要素のエラーメッセージを設(shè)定できます（検証が失敗した場(chǎng)合）。

Drupal 8の既存のフォームを変更する方法は？

Drupal 8の既存のフォームを変更するには、モジュールに「hook_form_form_id_alter（）」関數(shù)を?qū)g裝できます。この関數(shù)は、フォームを構(gòu)築するときに呼び出されます。これにより、フォームアレイを変更できます。 「form_id」は、変更するフォームのIDに置き換える必要があります。

Drupal 8でフォームをプログラム的に送信する方法は？

Drupal 8のフォームをプログラム的に送信するには、フォームクラスのインスタンスを作成し、「submitform（）」メソッドを呼び出すことができます。ただし、このメソッドを呼び出す前に、フォーム狀態(tài)オブジェクトを準(zhǔn)備し、フォーム要素の値を設(shè)定する必要があります。

Drupal 8で構(gòu)成フォームを作成する方法は？

Drupal 8で構(gòu)成フォームを作成するには、「Formbase」クラスの代わりに「configformbase」クラスを拡張するフォームクラスを定義できます。 「configformbase」クラスは、「geteditableconfignames（）」や「config（）」など、構(gòu)成データを処理する他の方法を提供します。構(gòu)成データはDrupal構(gòu)成システムに保存され、コードのどこからでもアクセスできます。

Drupal 8でマルチステップフォームを作成する方法は？

Drupal 8でマルチステップフォームを作成するには、FormStateInterfaceオブジェクトを使用してステップ間でデータを保存できます。 「buildform（）」メソッドでは、フォーム狀態(tài)の現(xiàn)在のステップを確認(rèn)し、各ステップの別のフォームアレイを返すことができます。 「submitform（）」メソッドでは、現(xiàn)在のステップを確認(rèn)してから、データを保存して次のステップに移動(dòng)するか、最終的なコミットを処理できます。

Drupal 8でAjaxフォームを作成する方法は？

Drupal 8にAjaxフォームを作成するには、「burtionform（）」メソッドのフォーム要素に「#ajax」屬性を追加できます。このプロパティは、要素がトリガーされたときに呼び出されるコールバック関數(shù)を指定する配列である必要があります。コールバック関數(shù)は、更新するフォームの一部またはAJAXコマンドのセットを返す必要があります。

この改訂された出力は、元の畫像形式と配置を維持し、FAQSセクションは繰り返しを避け、妥當(dāng)な長(zhǎng)さを維持するために大幅に凝縮されています。

以上がDrupal 8モジュールの構(gòu)築：ブロックとフォームの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語 Web サイトの他の関連記事を參照してください。