Você pode simplesmente tema de todas as formas como quiser. Eu não gosto do método do @rpayanm, porque é difícil de manter e de fácil leitura, com formas grandes esse não é o caso, apenas invólucro único e estrutura simples.
Todo formulário que tenta usar o tema é igual ao nome da máquina. Você pode encontrar esse nome de modelo em $form['#theme']apenas alter, é sempre (ou na maioria das vezes) o mesmo que nome da máquina de identificação de formulário. O que você precisa fazer é registrar um modelo para ele. Você precisa implementar hook_theme(). Você pode gravá-lo em CUSTOMMODULE.module ou em THEMENAME.theme. A chave do tema deve ser a mesma que em $form['#theme'], para que seja usada automaticamente, caso contrário, você precisará adicionar uma nova via alteração de formulário.
/**
* Implements hook_theme().
*/
function MODULENAME_theme($existing, $type, $theme, $path) {
return [
'FORM_ID_THEME' => [
'template' => 'custom-form-template-name',
'render element' => 'form',
]
];
}
Drupal passa a variável $ form com form.
Então você deve criar custom-form-template-name.html.twig(com o nome do seu modelo de hook_theme ()).
O modelo mínimo é
{{ form }}
Você também pode imprimir todos os campos do formulário em que deseja
{{ form.field_name }}
Aqui você pode fazer o que quiser com a marcação.
Você também pode passar dados adicionais para o modelo implementando template_preprocess_TEMPALTENAME
function template_preprocess_FORM_ID_THEME(&$variables) {
$variables['example'] = 'This is added via preprocess';
}
E então use no template
{{ example }}
<div class="first-field">
{{ form.first_field }}
</div>
<div class="second-field">
{{ form.second_field }}
</div>
<div class="buttons">
{{ form.submit }}
{{ form.preview }}
</div>
{#
Don't forget to add printing form special info at the end.
Without this data form will not working propertly.
#}
{{ form.form_build_id }}
{{ form.form_token }}
{{ form.form_id }}
Eu acho que esse método é mais flexível, limpo e poderoso.
Ps desculpe pelo meu inglês, espero que alguém edite e corrija meus erros :)
Exemplo de forma complexa usando este método.
