Make required fields in dates and address fragments configurable (#558)

* Make required fields in dates and address fragments configurable

* Remove unnecessary code from date.html

* Remove unnecessary date information from README

* Add link to actions

README.md

@@ -669,6 +669,23 @@ Here is an example of using it with the `screenWithOneInput` fragment:
 
 Note that passing `required=true` here will append the red `(required)` to the label.
 
+#### Special situation for requiring address fields
+
+Sometimes you may want to apply custom validations to address fields through [Actions](#actions) that effectively
+make the address field required. In these situations because you are not using annotations to make the
+address fields required, the library won't pick up on the fact that the fields should be marked as required.
+
+To handle this situation, we have provided a special attribute `requireAddressFields` which is a boolean
+that can be passed when calling the address input fragment like so:
+```html
+<th:block th:replace="~{fragments/inputs/address ::
+    address(requireAddressFields=true,
+    inputName='residentialAddress')}"/>
+
+```
+This will apply the red `(required)` to the address fields in the UI. Note it will not do so for the 
+street address line 2 as these are typically considered optional.
+
 ## Dynamic Input Fields
 
 A field is dynamic if it is unknown exactly how many of them will be submitted on a given form

src/main/resources/templates/fragments/inputs/address.html

@@ -1,6 +1,7 @@
 <th:block
     th:fragment="address(validate, inputName)"
     th:with="
+    requireAddressFields=${requireAddressFields ?: false},
     streetAddressLabelDefault=#{address.street-address-1},
     streetAddress2LabelDefault=#{address.street-address-2},
     cityLabelDefault=#{address.city},
@@ -20,6 +21,7 @@
 >
   <th:block th:replace="~{fragments/inputs/text ::
                   text(inputName=${streetAddressInputName},
+                  required=${requireAddressFields},
                   label=${streetAddressLabel},
                   helpText=${streetAddressHelpText})}"/>
   <th:block th:replace="~{fragments/inputs/text ::
@@ -28,14 +30,17 @@
                   helpText=${streetAddress2HelpText})}"/>
   <th:block th:replace="~{fragments/inputs/text ::
                   text(inputName=${cityInputName},
+                  required=${requireAddressFields},
                   label=${cityLabel},
                   helpText=${cityHelpText})}"/>
   <th:block th:replace="~{fragments/inputs/state ::
                   state(inputName=${stateInputName},
+                  required=${requireAddressFields},
                   label=${stateLabel},
                   helpText=${stateHelpText})}"/>
   <th:block th:replace="~{fragments/inputs/text ::
                   text(inputName=${zipCodeInputName},
+                  required=${requireAddressFields},
                   label=${zipCodeLabel},
                   helpText=${zipCodeHelpText})}"/>
   <input type="hidden"