(_ titleResource: LocalizedStringResource, value: P?) where Label == Text, P : Decodable, P : Encodable, P : Hashable ``` ## Parameters `titleResource` A localized string that describes the view that this link presents. `value` An optional value to present. When someone taps or clicks the link, SwiftUI stores a copy of the value. Pass a `nil` value to disable the link. ## Discussion When someone activates the navigation link that this initializer creates, SwiftUI looks for a nearby [`navigationDestination(for:destination:)`](/documentation/SwiftUI/View/navigationDestination(for:destination:)) view modifier with a `data` input parameter that matches the type of this initializer’s `value` input, with one of the following outcomes: - If SwiftUI finds a matching modifier within the view hierarchy of an enclosing [`NavigationStack`](/documentation/SwiftUI/NavigationStack), it pushes the modifier’s corresponding `destination` view onto the stack. - If SwiftUI finds a matching modifier in the view hierarchy of a stack that’s in a later column of a [`NavigationSplitView`](/documentation/SwiftUI/NavigationSplitView), it puts the modifier’s destination view as the first and only item onto the stack while preserving the stack’s root view. - If there’s no matching modifier, but the link appears in a [`List`](/documentation/SwiftUI/List) with selection inside a leading column of a navigation split view, the link updates the selection, which might affect the appearance of a trailing view. For an example of this, see [`NavigationLink`](/documentation/SwiftUI/NavigationLink). - In other cases, the link doesn’t do anything. Because this initializer takes a value that conforms to the protocol, you ensure that a [`NavigationPath`](/documentation/SwiftUI/NavigationPath) that includes this link can produce a non-`nil` value for its [`codable`](/documentation/SwiftUI/NavigationPath/codable) property. This helps to make the path serializable. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)