Drupalフォームで説明を表示する方法

フォーム要素の#description属性を使用する方法: DrupalのフォームAPIでは、フォーム要素に#description属性を追加することで、要素の説明を表示することができます。以下は、#description属性を使用した例です。

$form['name'] = [
  '#type' => 'textfield',
  '#title' => '名前',
  '#description' => '名前を入力してください。',
];

テーマレイヤでのフォーム要素の説明のカスタマイズ: フォームの見た目をカスタマイズするには、テーマレイヤでフォーム要素をオーバーライドする方法もあります。以下は、テーマレイヤでフォーム要素の説明をカスタマイズする例です。

function mytheme_form_element($variables) {
  $element = $variables['element'];
  $output = '<div class="description">' . $element['#description'] . '</div>';
  $output .= '<div class="form-item">' . $element['#children'] . '</div>';
  return $output;
}

モジュールでのフォーム要素の説明のカスタマイズ: また、モジュールを使用してフォーム要素の説明をカスタマイズすることもできます。以下は、モジュールでフォーム要素の説明をカスタマイズする例です。

function mymodule_form_alter(&$form, &$form_state, $form_id) {
  if ($form_id == 'myform') {
    $form['name']['#description'] = '名前を入力してください。';
  }
}

以上が、Drupalフォームで説明を表示するいくつかの方法です。ご参考になれば幸いです。