Digital ACT-191 ONEAPP-6827 story: added new breadcrumbItem component

VDS.xcodeproj/project.pbxproj

@@ -7,8 +7,11 @@
 	objects = {
 
 /* Begin PBXBuildFile section */
+		1832AC572BA0791D008AE476 /* BreadcrumbCellItem.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1832AC562BA0791D008AE476 /* BreadcrumbCellItem.swift */; };
 		186B2A8A2B88DA7F001AB71F /* TextAreaChangeLog.txt in Resources */ = {isa = PBXBuildFile; fileRef = 186B2A892B88DA7F001AB71F /* TextAreaChangeLog.txt */; };
 		18792A902B7431F2008C0D29 /* ButtonIconBadgeIndicatorModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 18792A8F2B7431F2008C0D29 /* ButtonIconBadgeIndicatorModel.swift */; };
+		18A65A022B96E848006602CC /* Breadcrumbs.swift in Sources */ = {isa = PBXBuildFile; fileRef = 18A65A012B96E848006602CC /* Breadcrumbs.swift */; };
+		18A65A042B96F050006602CC /* BreadcrumbItem.swift in Sources */ = {isa = PBXBuildFile; fileRef = 18A65A032B96F050006602CC /* BreadcrumbItem.swift */; };
 		18BDEE822B75316E00452358 /* ButtonIconChangeLog.txt in Resources */ = {isa = PBXBuildFile; fileRef = 18BDEE812B75316E00452358 /* ButtonIconChangeLog.txt */; };
 		445BA07829C07B3D0036A7C5 /* Notification.swift in Sources */ = {isa = PBXBuildFile; fileRef = 445BA07729C07B3D0036A7C5 /* Notification.swift */; };
 		44604AD429CE186A00E62B51 /* NotificationButtonModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 44604AD329CE186A00E62B51 /* NotificationButtonModel.swift */; };
@@ -175,8 +178,11 @@
 /* End PBXContainerItemProxy section */
 
 /* Begin PBXFileReference section */
+		1832AC562BA0791D008AE476 /* BreadcrumbCellItem.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BreadcrumbCellItem.swift; sourceTree = "<group>"; };
 		186B2A892B88DA7F001AB71F /* TextAreaChangeLog.txt */ = {isa = PBXFileReference; lastKnownFileType = text; path = TextAreaChangeLog.txt; sourceTree = "<group>"; };
 		18792A8F2B7431F2008C0D29 /* ButtonIconBadgeIndicatorModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ButtonIconBadgeIndicatorModel.swift; sourceTree = "<group>"; };
+		18A65A012B96E848006602CC /* Breadcrumbs.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Breadcrumbs.swift; sourceTree = "<group>"; };
+		18A65A032B96F050006602CC /* BreadcrumbItem.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BreadcrumbItem.swift; sourceTree = "<group>"; };
 		18BDEE812B75316E00452358 /* ButtonIconChangeLog.txt */ = {isa = PBXFileReference; lastKnownFileType = text; path = ButtonIconChangeLog.txt; sourceTree = "<group>"; };
 		445BA07729C07B3D0036A7C5 /* Notification.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Notification.swift; sourceTree = "<group>"; };
 		44604AD329CE186A00E62B51 /* NotificationButtonModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotificationButtonModel.swift; sourceTree = "<group>"; };
@@ -356,6 +362,16 @@
 /* End PBXFrameworksBuildPhase section */
 
 /* Begin PBXGroup section */
+		18A65A002B96E7E1006602CC /* Breadcrumbs */ = {
+			isa = PBXGroup;
+			children = (
+				18A65A012B96E848006602CC /* Breadcrumbs.swift */,
+				18A65A032B96F050006602CC /* BreadcrumbItem.swift */,
+				1832AC562BA0791D008AE476 /* BreadcrumbCellItem.swift */,
+			);
+			path = Breadcrumbs;
+			sourceTree = "<group>";
+		};
 		445BA07629C07ABA0036A7C5 /* Notification */ = {
 			isa = PBXGroup;
 			children = (
@@ -489,6 +505,7 @@
 			children = (
 				EA4DB2FE28DCBC1900103EE3 /* Badge */,
 				EAD062AE2A3B87210015965D /* BadgeIndicator */,
+				18A65A002B96E7E1006602CC /* Breadcrumbs */,
 				EA0FC2BE2912D18200DF80B4 /* Buttons */,
 				EAF7F092289985E200B287F5 /* Checkbox */,
 				EA985BF3296C609E00F2FF2E /* Icon */,
@@ -994,10 +1011,12 @@
 				EAF7F0A6289B0CE000B287F5 /* Resetable.swift in Sources */,
 				EA985C2D296F03FE00F2FF2E /* TileletIconModels.swift in Sources */,
 				EA89200428AECF4B006B9984 /* UITextField+Publisher.swift in Sources */,
+				18A65A022B96E848006602CC /* Breadcrumbs.swift in Sources */,
 				EA0D1C3F2A6AD5E200E5C127 /* Typography+ContentSizeCategory.swift in Sources */,
 				EA5F86C82A1BD99100BC83E4 /* TabModel.swift in Sources */,
 				EA0D1C432A6AD70900E5C127 /* VDSTypography.swift in Sources */,
 				EA297A5729FB0A360031ED56 /* AppleGuidelinesTouchable.swift in Sources */,
+				1832AC572BA0791D008AE476 /* BreadcrumbCellItem.swift in Sources */,
 				EA3361C328902D960071C351 /* Toggle.swift in Sources */,
 				EAF7F0A0289AB7EC00B287F5 /* View.swift in Sources */,
 				EA89201328B568D8006B9984 /* RadioBoxItem.swift in Sources */,
@@ -1005,6 +1024,7 @@
 				EA3362402892EF6C0071C351 /* Label.swift in Sources */,
 				EAB2376229E9880400AABE9A /* TrailingTooltipLabel.swift in Sources */,
 				EAB2376A29E9E59100AABE9A /* TooltipLaunchable.swift in Sources */,
+				18A65A042B96F050006602CC /* BreadcrumbItem.swift in Sources */,
 				EAB2375D29E8789100AABE9A /* Tooltip.swift in Sources */,
 				71BFA70A2B7F70E6000DCE33 /* Dropshadowable.swift in Sources */,
 				EA0D1C452A6AD73000E5C127 /* RawRepresentable.swift in Sources */,

VDS/Components/Breadcrumbs/BreadcrumbCellItem.swift

@@ -0,0 +1,17 @@
+//
+//  BreadcrumbCellItem.swift
+//  VDS
+//
+//  Created by Kanamarlapudi, Vasavi on 11/03/24.
+//
+
+import UIKit
+import VDSColorTokens
+
+///This is customised view for Breadcrumb cell item
+final class BreadcrumbCellItem: UICollectionViewCell {
+    
+    ///Identifier for the PaginationCellItem
+    static let identifier: String = String(describing: BreadcrumbCellItem.self)
+   
+}

VDS/Components/Breadcrumbs/BreadcrumbItem.swift

@@ -0,0 +1,125 @@
+//
+//  BreadcrumbItem.swift
+//  VDS
+//
+//  Created by Kanamarlapudi, Vasavi on 05/03/24.
+//
+
+import Foundation
+import VDSColorTokens
+import VDSFormControlsTokens
+import Combine
+
+/// A Breadcrumb Item contains href(link) and selected flag.
+/// Breadcrumb links to its respective page if it is not disabled.
+/// Breadcrumb contains text with a separator by default, highlights text in bold without a separator if selected.
+@objc (VDSBreadcrumbItem)
+open class BreadcrumbItem: ButtonBase {
+   
+    //--------------------------------------------------
+    // MARK: - Initializers
+    //--------------------------------------------------
+    required public init() {
+        super.init(frame: .zero)
+    }
+    
+    public override init(frame: CGRect) {
+        super.init(frame: .zero)
+    }
+    
+    public required init?(coder: NSCoder) {
+        super.init(coder: coder)
+    }
+    
+    //--------------------------------------------------
+    // MARK: - Public Properties
+    //--------------------------------------------------
+    /// The Breadcrumb link to links to its respective page.
+    open var link: String? { didSet { setNeedsUpdate() } }
+    
+    /// TextStyle used on the titleLabel.
+    open override var textStyle: TextStyle { isSelected ? TextStyle.boldBodySmall : TextStyle.bodySmall }
+        
+    /// If true, it will be rendered as selected.
+    open var selectable: Bool = false {
+        didSet {
+            //update selected state
+            if selectable{
+                isSelected = true
+            } else {
+                isSelected = false
+            }
+            setNeedsUpdate()
+        }
+    }
+    
+    /// UIColor used on the titleLabel text.
+    open override var textColor: UIColor {
+        textColorConfiguration.getColor(self)
+    }
+        
+    /// The natural size for the receiving view, considering only properties of the view itself.
+    open override var intrinsicContentSize: CGSize {
+        return titleLabel?.intrinsicContentSize ?? super.intrinsicContentSize
+    }
+           
+    //--------------------------------------------------
+    // MARK: - Private Properties
+    //--------------------------------------------------
+    var separator = " /"
+    
+    private var textColorConfiguration = ControlColorConfiguration().with {
+        $0.setSurfaceColors(VDSColor.elementsPrimaryOnlight, VDSColor.elementsPrimaryOndark, forState: .normal)
+        $0.setSurfaceColors(VDSColor.interactiveActiveOnlight, VDSColor.interactiveActiveOndark, forState: .highlighted)
+        $0.setSurfaceColors(VDSColor.elementsPrimaryOnlight, VDSColor.elementsPrimaryOndark, forState: .selected)
+    }
+          
+    //--------------------------------------------------
+    // MARK: - Overrides
+    //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
+    open override func setup() {
+        super.setup()
+        isAccessibilityElement = true
+        accessibilityTraits = .button
+        accessibilityLabel = "Breadcrumb"
+    }
+
+    /// Used to make changes to the View based off a change events or from local properties.
+    open override func updateView() {
+        //always call last so the label is rendered
+        if (text != nil) {
+            var newText: String = text ?? ""
+            if isSelected {
+                if newText.contains(separator) {
+                    let result = newText.dropLast(2)
+                    newText = String(result)
+                }
+            } else {
+                if !newText.contains(separator) {
+                    newText = (text ?? "") + separator
+                }
+            }
+            print("newText:\(newText), isSelected: \(isSelected)")
+            text = newText
+            if let titleLabel {
+                titleLabel.text = text
+            }
+        }
+        super.updateView()
+
+    }
+
+    /// Resets to default settings.
+    open override func reset() {
+        super.reset()
+        shouldUpdateView = false
+        text = nil
+        link = nil
+        accessibilityCustomActions = []
+        isAccessibilityElement = true
+        accessibilityTraits = .button
+        shouldUpdateView = true
+        setNeedsUpdate()
+    }
+}

VDS/Components/Breadcrumbs/Breadcrumbs.swift

@@ -0,0 +1,18 @@
+//
+//  Breadcrumbs.swift
+//  VDS
+//
+//  Created by Kanamarlapudi, Vasavi on 11/03/24.
+//
+
+import Foundation
+import VDSColorTokens
+import Combine
+
+/// A Breadcrumbs contains BreadcrumbItems. 
+/// It contains Breadcrumb Item Default, Breadcrumb Item Selected, Separator.
+/// Breadcrumbs are secondary navigation that use a hierarchy of internal links to tell customers where they are in an experience. Each breadcrumb links to its respective page, except for that of current page.
+@objc(VDSBreadcrumbs)
+open class Breadcrumbs: View {
+    
+}