refactor: 💡 [HCPSDKFIORIUIKIT-2232]SortFilterView TitleForm (SAP#1022)

* refactor: 💡 [HCPSDKFIORIUIKIT-2232]SortFilterView title type

* refactor: 💡 [HCPSDKFIORIUIKIT-2232]SortFilterView TitleForm

---------

Co-authored-by: dyongxu <61523257+dyongxu@users.noreply.github.com>

Author: restaurantt

Apps/Examples/Examples/FioriSwiftUICore/SortFilter/SortFilterExample.swift

@@ -37,6 +37,9 @@ struct SortFilterExample: View {
         ],
         [
             .datetime(item: .init(name: "Completion Date", value: nil), showsOnFilterFeedbackBar: true)
+        ],
+        [
+            .title(item: .init(name: "Title", text: "This is default text.", placeholder: "Please input", maxTextLength: 20, isCharCountEnabled: true, charCountBeyondLimitMsg: "CharCountBeyondLimit"), showsOnFilterFeedbackBar: true)
         ]
     ]
 

Apps/Examples/Examples/FioriSwiftUICore/SortFilter/SortFilterView+Extensions.swift

@@ -16,6 +16,8 @@ extension View {
             return self.json(item: v)
         case .stepper(let v, _):
             return self.json(item: v)
+        case .title(let v, _):
+            return self.json(item: v)
         }
     }
 
@@ -38,4 +40,8 @@ extension View {
     func json(item: SortFilterItem.StepperItem) -> String {
         "{name: \(item.name), value: \(String(describing: item.value))}"
     }
+    
+    func json(item: SortFilterItem.TitleItem) -> String {
+        "{name: \(item.name), value: \(item.text)}"
+    }
 }

Sources/FioriSwiftUICore/DataTypes/SortFilter+DataType.swift

@@ -18,6 +18,8 @@ public enum SortFilterItem: Identifiable, Hashable {
             return item.id
         case .stepper(let item, _):
             return item.id
+        case .title(let item, _):
+            return item.id
         }
     }
 
@@ -67,6 +69,13 @@ public enum SortFilterItem: Identifiable, Hashable {
     /// 2. A section of view containing a SwiftUI Stepper with Fiori style
     case stepper(item: StepperItem, showsOnFilterFeedbackBar: Bool)
 
+    /// The type of UI control is used to build:
+    ///
+    /// 1. Sort & Filter's menu item associated with a popover containing a SwiftUI TitleFormView with Fiori style
+    ///
+    /// 2. A section of view containing a SwiftUI TitleFormView with Fiori style
+    case title(item: TitleItem, showsOnFilterFeedbackBar: Bool)
+
     public var showsOnFilterFeedbackBar: Bool {
         switch self {
         case .picker(_, let showsOnFilterFeedbackBar):
@@ -81,6 +90,8 @@ public enum SortFilterItem: Identifiable, Hashable {
             return showsOnFilterFeedbackBar
         case .stepper(_, let showsOnFilterFeedbackBar):
             return showsOnFilterFeedbackBar
+        case .title(_, let showsOnFilterFeedbackBar):
+            return showsOnFilterFeedbackBar
         }
     }
 
@@ -117,6 +128,11 @@ public enum SortFilterItem: Identifiable, Hashable {
             hasher.combine(item.originalValue)
             hasher.combine(item.workingValue)
             hasher.combine(item.value)
+        case .title(let item, _):
+            hasher.combine(item.id)
+            hasher.combine(item.originalText)
+            hasher.combine(item.workingText)
+            hasher.combine(item.text)
         }
     }
 }
@@ -242,6 +258,26 @@ extension SortFilterItem {
         }
     }
 
+    var title: TitleItem {
+        get {
+            switch self {
+            case .title(let item, _):
+                return item
+            default:
+                fatalError("Unexpected value \(self)")
+            }
+        }
+        
+        set {
+            switch self {
+            case .title(_, let showsOnFilterFeedbackBar):
+                self = .title(item: newValue, showsOnFilterFeedbackBar: showsOnFilterFeedbackBar)
+            default:
+                fatalError("Unexpected value \(self)")
+            }
+        }
+    }
+    
     var isChanged: Bool {
         switch self {
         case .picker(let item, _):
@@ -256,6 +292,8 @@ extension SortFilterItem {
             return item.isChanged
         case .stepper(let item, _):
             return item.isChanged
+        case .title(let item, _):
+            return item.isChanged
         }
     }
 
@@ -273,6 +311,8 @@ extension SortFilterItem {
             return item.isOriginal
         case .stepper(let item, _):
             return item.isOriginal
+        case .title(let item, _):
+            return item.isOriginal
         }
     }
 
@@ -296,6 +336,9 @@ extension SortFilterItem {
         case .stepper(var item, _):
             item.cancel()
             self.stepper = item
+        case .title(var item, _):
+            item.cancel()
+            self.title = item
         }
     }
 
@@ -319,6 +362,9 @@ extension SortFilterItem {
         case .stepper(var item, _):
             item.reset()
             self.stepper = item
+        case .title(var item, _):
+            item.reset()
+            self.title = item
         }
     }
 
@@ -342,6 +388,9 @@ extension SortFilterItem {
         case .stepper(var item, _):
             item.apply()
             self.stepper = item
+        case .title(var item, _):
+            item.apply()
+            self.title = item
         }
     }
 }
@@ -1039,4 +1088,91 @@ public extension SortFilterItem {
             self.workingValue == self.originalValue
         }
     }
+    
+    /// Data structure for title type
+    struct TitleItem: Identifiable, Equatable {
+        public var id: String
+        public var name: String
+        public let icon: String?
+        
+        public var text: String
+        var workingText: String
+        let originalText: String
+        public var isSecureEnabled: Bool? = false
+        public var placeholder: String?
+        public var controlState: ControlState = .normal
+        public var errorMessage: String?
+        public var maxTextLength: Int?
+        public let hintText: String?
+        public let hidesReadOnlyHint: Bool
+        public let isCharCountEnabled: Bool
+        public let allowsBeyondLimit: Bool
+        public let charCountReachLimitMessage: String?
+        public let charCountBeyondLimitMsg: String?
+        
+        /// Create a textfiled.
+        /// - Parameters:
+        ///   - id: The unique identifier for TitleItem.
+        ///   - name: Item name.
+        ///   - text: The text in textfield.
+        ///   - isSecureEnabled: A boolean value to indicate to whether the textfield is secure textfield.
+        ///   - placeholder: A text for placeholder of textfield.
+        ///   - controlState: A state for textfield.
+        ///   - errorMessage: A text when the text of textfield not satisfy conditions.
+        ///   - maxTextLength: A maximum value for text length.
+        ///   - hidesReadOnlyHint: A boolean value to indicate to hide read only hint or not.
+        ///   - isCharCountEnabled: A boolean value to indicate to display char count or not.
+        ///   - allowsBeyondLimit: A boolean value to indicate to allows inputting text beyond maximum char count limit or not.
+        ///   - charCountReachLimitMessage: A text for char count reach maximum limit.
+        ///   - charCountBeyondLimitMsg: A text for char beyond maximum limit.
+        ///   - icon: The icon image in the item bar.
+        ///   - hintText: The hint text of the textfiled.
+        public init(id: String = UUID().uuidString, name: String, text: String, isSecureEnabled: Bool? = false, placeholder: String? = nil, controlState: ControlState = .normal, errorMessage: String? = nil, maxTextLength: Int? = nil, hidesReadOnlyHint: Bool = false, isCharCountEnabled: Bool = false, allowsBeyondLimit: Bool = false, charCountReachLimitMessage: String? = nil, charCountBeyondLimitMsg: String? = nil, icon: String? = nil, hintText: String? = nil) {
+            self.id = id
+            self.name = name
+            self.text = text
+            self.workingText = text
+            self.originalText = text
+            self.icon = icon
+            self.isSecureEnabled = isSecureEnabled
+            self.placeholder = placeholder
+            self.controlState = controlState
+            self.errorMessage = errorMessage
+            self.maxTextLength = maxTextLength
+            self.hidesReadOnlyHint = hidesReadOnlyHint
+            self.isCharCountEnabled = isCharCountEnabled
+            self.allowsBeyondLimit = allowsBeyondLimit
+            self.charCountReachLimitMessage = charCountReachLimitMessage
+            self.charCountBeyondLimitMsg = charCountBeyondLimitMsg
+            self.hintText = hintText
+        }
+        
+        mutating func reset() {
+            self.workingText = self.originalText
+        }
+        
+        mutating func cancel() {
+            self.workingText = self.text
+        }
+        
+        mutating func apply() {
+            self.text = self.workingText
+        }
+        
+        var isChecked: Bool {
+            !self.text.isEmpty
+        }
+        
+        var isChanged: Bool {
+            self.text != self.workingText
+        }
+        
+        var isOriginal: Bool {
+            self.workingText == self.originalText
+        }
+        
+        var label: String {
+            "\(self.name): \(self.text)"
+        }
+    }
 }