Merge pull request #515 from Esri/df/formViewAddGroupElementDescriptions

`FormView` - Add group element descriptions

Author: dfeinzimer

Sources/ArcGISToolkit/Components/FormView/GroupView.swift

@@ -50,9 +50,15 @@ struct GroupView<Content>: View where Content: View {
 
     var body: some View {
         DisclosureGroup(self.element.label, isExpanded: $isExpanded) {
-            ForEach(visibleElements, id: \.label) { formElement in
-                if let element = formElement as? FieldFormElement {
-                    viewCreator(element)
+            Group {
+                Text(element.description)
+                    .accessibilityIdentifier("\(element.label) Description")
+                    .font(.subheadline)
+                Divider()
+                ForEach(visibleElements, id: \.label) { formElement in
+                    if let element = formElement as? FieldFormElement {
+                        viewCreator(element)
+                    }
                 }
             }
             // Reapply leading alignment for content within the DisclosureGroup

UI Test Runner/UITests/FormViewTests.swift

@@ -1274,6 +1274,7 @@ final class FormViewTests: XCTestCase {
         let collapsedGroup = app.disclosureTriangles["Group with Multiple Form Elements 2"]
         let expandedGroupFirstElement = app.staticTexts["MultiLine Text"]
         let expandedGroup = app.disclosureTriangles["Group with Multiple Form Elements"]
+        let expandedGroupDescription = app.staticTexts["Group with Multiple Form Elements Description"]
         let formTitle = app.staticTexts["group_formelement_UI_not_editable"]
         let formViewTestsButton = app.buttons["FormView Tests"]
 
@@ -1295,6 +1296,16 @@ final class FormViewTests: XCTestCase {
             "The first group header doesn't exist."
         )
 
+        XCTAssertTrue(
+            expandedGroupDescription.exists,
+            "The expanded group's description doesn't exist."
+        )
+        
+        XCTAssertEqual(
+            expandedGroupDescription.label,
+            "This Group is 'Expand initial state'\nThis group is Visible"
+        )
+        
         // Confirm the first element of the expanded group exists.
         XCTAssertTrue(
             expandedGroupFirstElement.exists,
@@ -1320,6 +1331,7 @@ final class FormViewTests: XCTestCase {
         let formViewTestsButton = app.buttons["FormView Tests"]
         let showElementsButton = app.buttons["show invisible form element"]
         let hiddenElementsGroup = app.disclosureTriangles["Group with children that are visible dependent"]
+        let hiddenElementsGroupDescription = app.staticTexts["Group with children that are visible dependent Description"]
         let groupElement = app.staticTexts["single line text 3"]
 
         app.launch()
@@ -1340,6 +1352,16 @@ final class FormViewTests: XCTestCase {
             "The group header doesn't exist."
         )
 
+        XCTAssertTrue(
+            hiddenElementsGroupDescription.exists,
+            "The expanded group's description doesn't exist."
+        )
+        
+        XCTAssertEqual(
+            hiddenElementsGroupDescription.label,
+            "The Form Elements in this group need the Radio button \"show invisible form elements\" to be selected, if you want to see them"
+        )
+        
         // Confirm the first element of the conditional group doesn't exist.
         XCTAssertFalse(
             groupElement.exists,