「#markup」フォーム要素に子を含めることはできません

フォームを持っていますが、フォームがレンダリングされているときに「#markup」要素の子が表示されません。

$form['html'] = array(
  '#type' => 'markup',
  '#markup' => '<h2>My Heading</h2>',
  '#tree' => true,
);

$form['html']['element'] = array(
  '#type' => 'textfield',
  '#title' => 'Foo',
);

この例では、「要素」フォームフィールドはレンダリングされません。

これはDrupalのバグですか、それとも何か特別なことをする必要がありますか？

フォームAPIのリファレンスページで「#tree」が「#markup」要素でサポートされていると報告されているため、「＃tree」を「#markup」要素で使用できないのはDrupalのバグのようです。

回避策として、次のコードのように、「＃prefix」プロパティを使用することもできます。

$form['html']['element'] = array(
  '#type' => 'textfield',
  '#title' => 'Foo',
  '#prefix' => '<h2>My Heading</h2>',
);

期待どおりにレンダリングされない場合は、コードから "#tree"を削除するだけでよく<h2>My Heading</h2>、フォームフィールドの前にタグをレンダリングするだけでよい場合は、不要と思われます。フォームAPIは、配列に表示される順序に従って要素をレンダリングします。順序を変更したい場合は、 " #weight "プロパティを使用できます。

$form['html'] = array(
 '#type' => 'markup',
 '#markup' => '<h2>My Heading</h2>',
);

$form['html']['element'] = array(
  '#type' => 'textfield',
  '#title' => 'Foo',
);

もう少し正確に言うと、#markuptype要素の子はレンダリングされません。ただし、フォームの目的で処理されます。