# FragmentNavigator.Extras.Builder

Artifact: [androidx.navigation:navigation-fragment](https://developer.android.com/jetpack/androidx/releases/navigation) [View Source](https://cs.android.com/search?q=file:androidx/navigation/fragment/FragmentNavigator.kt+class:androidx.navigation.fragment.FragmentNavigator.Extras.Builder) Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/navigation#1.0.0)

*** ** * ** ***

<br />

```
public final class FragmentNavigator.Extras.Builder
```

<br />

*** ** * ** ***

Builder for constructing new `https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras` instances. The resulting instances are immutable.

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras.Builder#Builder()()` |

| ### Public methods |
|---|---|
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras.Builder` | `https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras.Builder#addSharedElement(android.view.View,kotlin.String)(@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/android/view/View.html sharedElement, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html name)` Maps the given View in the current Fragment to the given transition name in the Fragment being navigated to. |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras.Builder` | `https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras.Builder#addSharedElements(kotlin.collections.Map)( @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/util/Map.html<@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/android/view/View.html, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html> sharedElements )` Adds multiple shared elements for mapping Views in the current Fragment to transitionNames in the Fragment being navigated to. |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras` | `https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras.Builder#build()()` Constructs the final `https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras` instance. |

## Public constructors

### Builder

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/navigation#1.0.0)

```
public Builder()
```

## Public methods

### addSharedElement

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/navigation#1.0.0)

```
public final @NonNull FragmentNavigator.Extras.Builder addSharedElement(@NonNull View sharedElement, @NonNull String name)
```

Maps the given View in the current Fragment to the given transition name in the Fragment being navigated to.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/android/view/View.html sharedElement` | A View in the current Fragment to match with a View in the Fragment being navigated to. |
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html name` | The transitionName of the View in the Fragment being navigated to that should be matched to the shared element. |

| Returns |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras.Builder` | this `https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras.Builder` |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/fragment/app/FragmentTransaction#addSharedElement(android.view.View,java.lang.String)` |   |

### addSharedElements

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/navigation#1.0.0)

```
public final @NonNull FragmentNavigator.Extras.Builder addSharedElements(
    @NonNull Map<@NonNull View, @NonNull String> sharedElements
)
```

Adds multiple shared elements for mapping Views in the current Fragment to transitionNames in the Fragment being navigated to.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/util/Map.html<@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/android/view/View.html, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html> sharedElements` | Shared element pairs to add |

| Returns |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras.Builder` | this `https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras.Builder` |

### build

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/navigation#1.0.0)

```
public final @NonNull FragmentNavigator.Extras build()
```

Constructs the final `https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras` instance.

| Returns |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras` | An immutable `https://developer.android.com/reference/androidx/navigation/fragment/FragmentNavigator.Extras` instance. |