From 834090dba9a652ca85213ca0d245f550e9f38bc7 Mon Sep 17 00:00:00 2001
From: Mark Story <mark@mark-story.com>
Date: Tue, 28 Jan 2025 00:01:30 -0500
Subject: [PATCH] Document changes in cakephp/cakephp#18158

---
 en/appendices/5-2-migration-guide.rst | 2 ++
 en/views/helpers/form.rst             | 5 +++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/en/appendices/5-2-migration-guide.rst b/en/appendices/5-2-migration-guide.rst
index 79877bdace..48b89a093c 100644
--- a/en/appendices/5-2-migration-guide.rst
+++ b/en/appendices/5-2-migration-guide.rst
@@ -93,6 +93,8 @@ View
    templates using ``DELETE`` method.
 - ``HtmlHelper::importmap()`` was added. This method allows you to define
   import maps for your JavaScript files.
+- ``FormHelper`` now uses the ``containerClass`` template to apply a class to
+  the form control div. The default value is ``input``.
 
 Error
 -----
diff --git a/en/views/helpers/form.rst b/en/views/helpers/form.rst
index ea60026133..af54ba2b5a 100644
--- a/en/views/helpers/form.rst
+++ b/en/views/helpers/form.rst
@@ -376,13 +376,14 @@ methods of FormHelper.
 
 By default the ``control()`` method will employ the following widget templates::
 
-    'inputContainer' => '<div class="input {{type}}{{required}}">{{content}}</div>'
+    'inputContainer' => '<div class="{{constainerClass}} {{type}}{{required}}">{{content}}</div>'
     'input' => '<input type="{{type}}" name="{{name}}"{{attrs}}>'
     'requiredClass' => 'required'
+    'containerClass' => 'input'
 
 In case of validation errors it will also use::
 
-    'inputContainerError' => '<div class="input {{type}}{{required}} error">{{content}}{{error}}</div>'
+    'inputContainerError' => '<div class="{{containerClass}} {{type}}{{required}} error">{{content}}{{error}}</div>'
 
 The type of control created (when we provide no additional options to specify the
 generated element type) is inferred via model introspection and