Issue #2840529 by navneet0693, eojthebrave, Torenware, andypost: Reordering the sub-demos for Form API Example

Author: navneet0693

fapi_example/fapi_example.links.menu.yml

@@ -5,55 +5,64 @@ fapi_example.description:
   route_name: fapi_example.description
 
 fapi_example.simple_form:
-  title: Simple Form API Example
+  title: Simple Form
   description: A simple form example with submit processing.
   route_name: fapi_example.simple_form
   parent: fapi_example.description
+  weight: -9
+
+fapi_example.multistep_form:
+  title: Multistep Form
+  description: Multistep form example with submit processing.
+  route_name: fapi_example.multistep_form
+  parent: fapi_example.description
+  weight: -8
 
 fapi_example.input_demo:
-  title: Demo of Common Input Elements
+  title: Common Input Elements
   description: A form to demonstrate input elements.
   route_name: fapi_example.input_demo
   parent: fapi_example.description
+  weight: -7
 
-fapi_example.state_demo:
-  title: Demo of Form State Binding
-  description: A form to demonstrate binding of form state.
-  route_name: fapi_example.state_demo
+fapi_example.build_demo:
+  title: Build Form Demo
+  description: Demonstrates the order of firing of from controller methods.
+  route_name: fapi_example.build_demo
   parent: fapi_example.description
+  weight: -6
 
 fapi_example.container_demo:
-  title: Container Demo
+  title: Container Elements
   description: A form to demonstrate use of containers.
   route_name: fapi_example.container_demo
   parent: fapi_example.description
+  weight: -5
+
+fapi_example.state_demo:
+  title: Form State Binding
+  description: A form to demonstrate binding of form state.
+  route_name: fapi_example.state_demo
+  parent: fapi_example.description
+  weight: -4
 
 fapi_example.vertical_tabs_demo:
-  title: VerticalTabs Demo
+  title: Vertical Tab Elements
   description: A form to demonstrate use of vertical tabs.
   route_name: fapi_example.vertical_tabs_demo
   parent: fapi_example.description
+  weight: -3
 
 fapi_example.ajax_demo:
-  title: Ajax Form Example
+  title: Ajax Form
   description: A form to demonstrate use of AJAX.
   route_name: fapi_example.ajax_demo
   parent: fapi_example.description
-
-fapi_example.build_demo:
-  title: Build Form Demo
-  description: Demonstrates the order of firing of from controller methods.
-  route_name: fapi_example.build_demo
-  parent: fapi_example.description
+  weight: -2
 
 fapi_example.ajax_addmore:
-  title: Ajax Add more button
+  title: Add-more Button
   description: Form with 'add more' and 'remove' buttons.
   route_name: fapi_example.ajax_addmore
   parent: fapi_example.description
-
-fapi_example.multistep_form:
-  title: Multistep Form API Example
-  description: Multistep form example with submit processing.
-  route_name: fapi_example.multistep_form
-  parent: fapi_example.description
+  weight: -1

fapi_example/fapi_example.module

@@ -19,23 +19,25 @@
  *   \Drupal::formBuilder()->getForm()
  *   - fapi_example.routing.yml
  *
- * In addition to the simple  example described above this module provides
+ * In addition to the simple example described above this module provides
  * examples that demonstrate:
+ * - Elements used for data input
+ *   -\Drupal\fapi_example\Form\InputDemo
  * - The order of execution of form controller methods
  *   - \Drupal\fapi_example\Form\BuildDemo
- * - Populating a portion on a form with Ajax callbacks
- *   - \Drupal\fapi_example\Form\AjaxDemo
  * - Container elements used to group items
  *   - \Drupal\fapi_example\Form\ContainerDemo
- * - Elements used for data input
- *   - \Drupal\fapi_example\Form\InputDemo
- * - Modal form creation
- *   - \Drupal\fapi_example\Controller\Page
- *   - \Drupal\fapi_example\Form\ModalForm
  * - Hiding elements based on the state of other elements
  *   - \Drupal\fapi_example\Form\StateDemo
  * - Vertical Tabs elements in forms
  *   - \Drupal\fapi_example\Form\VerticalTabsDemo
+ * - Populating a portion on a form with Ajax callbacks
+ *   - \Drupal\fapi_example\Form\AjaxDemo
+ * - Adding additional fields to a form with Ajax callbacks
+ *   - \Drupal\fapi_example\Form\AjaxAddMore
+ * - Modal form creation
+ *   - \Drupal\fapi_example\Controller\Page
+ *   - \Drupal\fapi_example\Form\ModalForm
  *
  * @} End of "defgroup field_example".
  */

fapi_example/fapi_example.routing.yml

@@ -22,55 +22,55 @@ fapi_example.simple_form:
   path: 'examples/fapi-example/simple-form'
   defaults:
     _form:  '\Drupal\fapi_example\Form\SimpleForm'
-    _title: 'Simple Form API Example'
+    _title: 'Simple Form'
   requirements:
     _permission: 'access content'
 
 fapi_example.input_demo:
   path: 'examples/fapi-example/input-demo'
   defaults:
     _form:  '\Drupal\fapi_example\Form\InputDemo'
-    _title: 'Demo of Common Input Elements'
+    _title: 'Common Input Elements'
   requirements:
     _permission: 'access content'
 
 fapi_example.state_demo:
   path: 'examples/fapi-example/state-demo'
   defaults:
     _form:  '\Drupal\fapi_example\Form\StateDemo'
-    _title: 'Demo of Form State Binding'
+    _title: 'Form State Binding'
   requirements:
     _permission: 'access content'
 
 fapi_example.container_demo:
   path: 'examples/fapi-example/container-demo'
   defaults:
     _form:  '\Drupal\fapi_example\Form\ContainerDemo'
-    _title: 'Container Demo'
+    _title: 'Container Elements'
   requirements:
     _permission: 'access content'
 
 fapi_example.vertical_tabs_demo:
   path: 'examples/fapi-example/vertical-tabs-demo'
   defaults:
     _form:  '\Drupal\fapi_example\Form\VerticalTabsDemo'
-    _title: 'VerticalTabs Demo'
+    _title: 'Vertical Tab Elements'
   requirements:
     _permission: 'access content'
 
 fapi_example.modal_form:
   path: 'examples/fapi-example/modal-form'
   defaults:
     _form:  '\Drupal\fapi_example\Form\ModalForm'
-    _title: 'Modal Form Example'
+    _title: 'Modal Form'
   requirements:
     _permission: 'access content'
 
 fapi_example.ajax_demo:
   path: 'examples/fapi-example/ajax-demo'
   defaults:
     _form:  '\Drupal\fapi_example\Form\AjaxDemo'
-    _title: 'Ajax Form Example'
+    _title: 'Ajax Form'
   requirements:
     _permission: 'access content'
 
@@ -86,14 +86,14 @@ fapi_example.ajax_addmore:
   path: 'examples/fapi-example/ajax-addmore'
   defaults:
     _form:  '\Drupal\fapi_example\Form\AjaxAddMore'
-    _title: 'Add-more button'
+    _title: 'Add-more Button'
   requirements:
     _permission: 'access content'
 
 fapi_example.multistep_form:
   path: 'examples/fapi-example/multistep-form'
   defaults:
     _form: '\Drupal\fapi_example\Form\MultistepForm'
-    _title: 'Multistep Form Example'
+    _title: 'Multistep Form'
   requirements:
     _permission: 'access content'

fapi_example/src/Controller/Page.php

@@ -26,15 +26,17 @@ public function description() {
       '#items' => [
         Link::createFromRoute($this->t('Simple Form'), 'fapi_example.simple_form'),
         Link::createFromRoute($this->t('Multistep Form'), 'fapi_example.multistep_form'),
-        Link::createFromRoute($this->t('Input Demo'), 'fapi_example.input_demo'),
-        Link::createFromRoute($this->t('Form State Example'), 'fapi_example.state_demo'),
-        Link::createFromRoute($this->t('Container Demo'), 'fapi_example.container_demo'),
-        Link::createFromRoute($this->t('Vertical Tab Demo'), 'fapi_example.vertical_tabs_demo'),
-        Link::createFromRoute($this->t('Ajax Demo'), 'fapi_example.ajax_demo'),
+        Link::createFromRoute($this->t('Common Input Elements'), 'fapi_example.input_demo'),
+        Link::createFromRoute($this->t('Build Form Demo'), 'fapi_example.build_demo'),
+        Link::createFromRoute($this->t('Container Elements'), 'fapi_example.container_demo'),
+        Link::createFromRoute($this->t('Form State Binding'), 'fapi_example.state_demo'),
+        Link::createFromRoute($this->t('Vertical Tab Elements'), 'fapi_example.vertical_tabs_demo'),
+        Link::createFromRoute($this->t('Ajax Form'), 'fapi_example.ajax_demo'),
+        Link::createFromRoute($this->t('Add-more Button'), 'fapi_example.ajax_addmore'),
 
         // Attributes are used by the core dialog libraries to invoke the modal.
         Link::createFromRoute(
-          $this->t('Modal Example'),
+          $this->t('Modal Form'),
           'fapi_example.modal_form',
            [],
            [
@@ -44,9 +46,6 @@ public function description() {
              ],
            ]
         ),
-
-        Link::createFromRoute($this->t('Build Demo'), 'fapi_example.build_demo'),
-        Link::createFromRoute($this->t('Ajax Add More Demo'), 'fapi_example.ajax_addmore'),
       ],
     ];