# FragmentTransaction Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary:[Constants](https://developer.android.com/reference/android/app/FragmentTransaction#constants)\|[Ctors](https://developer.android.com/reference/android/app/FragmentTransaction#pubctors)\|[Methods](https://developer.android.com/reference/android/app/FragmentTransaction#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/app/FragmentTransaction#inhmethods) # FragmentTransaction *** ** * ** *** [Kotlin](https://developer.android.com/reference/kotlin/android/app/FragmentTransaction "View this page in Kotlin")\|Java ` public abstract class FragmentTransaction ` ` extends `[Object](https://developer.android.com/reference/java/lang/Object)` `` ` |---|---------------------------------| | [java.lang.Object](https://developer.android.com/reference/java/lang/Object) || | ↳ | android.app.FragmentTransaction |
*** ** * ** ***
**This class was deprecated in API level 28.** Use the[Support Library](https://developer.android.com/tools/extras/support-library)[FragmentTransaction](https://developer.android.com/reference/androidx/fragment/app/FragmentTransaction.html) API for performing a set of Fragment operations. ### Developer Guides For more information about using fragments, read the[Fragments](https://developer.android.com/guide/components/fragments)developer guide.
## Summary | ### Constants || |-------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `int` | [TRANSIT_ENTER_MASK](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_ENTER_MASK) Bit mask that is set for all enter transitions. | | `int` | [TRANSIT_EXIT_MASK](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_EXIT_MASK) Bit mask that is set for all exit transitions. | | `int` | [TRANSIT_FRAGMENT_CLOSE](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_FRAGMENT_CLOSE) Fragment is being removed from the stack | | `int` | [TRANSIT_FRAGMENT_FADE](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_FRAGMENT_FADE) Fragment should simply fade in or out; that is, no strong navigation associated with it except that it is appearing or disappearing for some reason. | | `int` | [TRANSIT_FRAGMENT_OPEN](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_FRAGMENT_OPEN) Fragment is being added onto the stack | | `int` | [TRANSIT_NONE](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_NONE) No animation for transition. | | `int` | [TRANSIT_UNSET](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_UNSET) Not set up for a transition. | | ### Public constructors || |------------------------------------------------------------------------------------------------------------------------------|---| | ` `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction#FragmentTransaction())`() ` | | ### Public methods || |------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[add](https://developer.android.com/reference/android/app/FragmentTransaction#add(android.app.Fragment,%20java.lang.String))`(`[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment, `[String](https://developer.android.com/reference/java/lang/String)` tag) ` Calls[add(int, android.app.Fragment, java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#add(int,%20android.app.Fragment,%20java.lang.String))with a 0 containerViewId. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[add](https://developer.android.com/reference/android/app/FragmentTransaction#add(int,%20android.app.Fragment))`(int containerViewId, `[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment) ` Calls[add(int, android.app.Fragment, java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#add(int,%20android.app.Fragment,%20java.lang.String))with a null tag. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[add](https://developer.android.com/reference/android/app/FragmentTransaction#add(int,%20android.app.Fragment,%20java.lang.String))`(int containerViewId, `[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment, `[String](https://developer.android.com/reference/java/lang/String)` tag) ` Add a fragment to the activity state. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[addSharedElement](https://developer.android.com/reference/android/app/FragmentTransaction#addSharedElement(android.view.View,%20java.lang.String))`(`[View](https://developer.android.com/reference/android/view/View)` sharedElement, `[String](https://developer.android.com/reference/java/lang/String)` name) ` Used with to map a View from a removed or hidden Fragment to a View from a shown or added Fragment. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[addToBackStack](https://developer.android.com/reference/android/app/FragmentTransaction#addToBackStack(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` name) ` Add this transaction to the back stack. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[attach](https://developer.android.com/reference/android/app/FragmentTransaction#attach(android.app.Fragment))`(`[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment) ` Re-attach a fragment after it had previously been detached from the UI with[detach(android.app.Fragment)](https://developer.android.com/reference/android/app/FragmentTransaction#detach(android.app.Fragment)). | | ` abstract int` | ` `[commit](https://developer.android.com/reference/android/app/FragmentTransaction#commit())`() ` Schedules a commit of this transaction. | | ` abstract int` | ` `[commitAllowingStateLoss](https://developer.android.com/reference/android/app/FragmentTransaction#commitAllowingStateLoss())`() ` Like[commit()](https://developer.android.com/reference/android/app/FragmentTransaction#commit())but allows the commit to be executed after an activity's state is saved. | | ` abstract void` | ` `[commitNow](https://developer.android.com/reference/android/app/FragmentTransaction#commitNow())`() ` Commits this transaction synchronously. | | ` abstract void` | ` `[commitNowAllowingStateLoss](https://developer.android.com/reference/android/app/FragmentTransaction#commitNowAllowingStateLoss())`() ` Like[commitNow()](https://developer.android.com/reference/android/app/FragmentTransaction#commitNow())but allows the commit to be executed after an activity's state is saved. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[detach](https://developer.android.com/reference/android/app/FragmentTransaction#detach(android.app.Fragment))`(`[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment) ` Detach the given fragment from the UI. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[disallowAddToBackStack](https://developer.android.com/reference/android/app/FragmentTransaction#disallowAddToBackStack())`() ` Disallow calls to[addToBackStack(java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#addToBackStack(java.lang.String)). | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[hide](https://developer.android.com/reference/android/app/FragmentTransaction#hide(android.app.Fragment))`(`[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment) ` Hides an existing fragment. | | ` abstract boolean` | ` `[isAddToBackStackAllowed](https://developer.android.com/reference/android/app/FragmentTransaction#isAddToBackStackAllowed())`() ` Returns true if this FragmentTransaction is allowed to be added to the back stack. | | ` abstract boolean` | ` `[isEmpty](https://developer.android.com/reference/android/app/FragmentTransaction#isEmpty())`() ` | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[remove](https://developer.android.com/reference/android/app/FragmentTransaction#remove(android.app.Fragment))`(`[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment) ` Remove an existing fragment. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[replace](https://developer.android.com/reference/android/app/FragmentTransaction#replace(int,%20android.app.Fragment,%20java.lang.String))`(int containerViewId, `[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment, `[String](https://developer.android.com/reference/java/lang/String)` tag) ` Replace an existing fragment that was added to a container. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[replace](https://developer.android.com/reference/android/app/FragmentTransaction#replace(int,%20android.app.Fragment))`(int containerViewId, `[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment) ` Calls[replace(int, android.app.Fragment, java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#replace(int,%20android.app.Fragment,%20java.lang.String))with a null tag. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[runOnCommit](https://developer.android.com/reference/android/app/FragmentTransaction#runOnCommit(java.lang.Runnable))`(`[Runnable](https://developer.android.com/reference/java/lang/Runnable)` runnable) ` Add a Runnable to this transaction that will be run after this transaction has been committed. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[setBreadCrumbShortTitle](https://developer.android.com/reference/android/app/FragmentTransaction#setBreadCrumbShortTitle(int))`(int res) ` Set the short title to show as a bread crumb when this transaction is on the back stack, as used by[FragmentBreadCrumbs](https://developer.android.com/reference/android/app/FragmentBreadCrumbs). | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[setBreadCrumbShortTitle](https://developer.android.com/reference/android/app/FragmentTransaction#setBreadCrumbShortTitle(java.lang.CharSequence))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` text) ` Like[setBreadCrumbShortTitle(int)](https://developer.android.com/reference/android/app/FragmentTransaction#setBreadCrumbShortTitle(int))but taking a raw string; this method is*not*recommended, as the string can not be changed later if the locale changes. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[setBreadCrumbTitle](https://developer.android.com/reference/android/app/FragmentTransaction#setBreadCrumbTitle(int))`(int res) ` Set the full title to show as a bread crumb when this transaction is on the back stack, as used by[FragmentBreadCrumbs](https://developer.android.com/reference/android/app/FragmentBreadCrumbs). | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[setBreadCrumbTitle](https://developer.android.com/reference/android/app/FragmentTransaction#setBreadCrumbTitle(java.lang.CharSequence))`(`[CharSequence](https://developer.android.com/reference/java/lang/CharSequence)` text) ` Like[setBreadCrumbTitle(int)](https://developer.android.com/reference/android/app/FragmentTransaction#setBreadCrumbTitle(int))but taking a raw string; this method is*not*recommended, as the string can not be changed later if the locale changes. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[setCustomAnimations](https://developer.android.com/reference/android/app/FragmentTransaction#setCustomAnimations(int,%20int,%20int,%20int))`(int enter, int exit, int popEnter, int popExit) ` Set specific animation resources to run for the fragments that are entering and exiting in this transaction. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[setCustomAnimations](https://developer.android.com/reference/android/app/FragmentTransaction#setCustomAnimations(int,%20int))`(int enter, int exit) ` Set specific animation resources to run for the fragments that are entering and exiting in this transaction. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[setPrimaryNavigationFragment](https://developer.android.com/reference/android/app/FragmentTransaction#setPrimaryNavigationFragment(android.app.Fragment))`(`[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment) ` Set a currently active fragment in this FragmentManager as the primary navigation fragment. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[setReorderingAllowed](https://developer.android.com/reference/android/app/FragmentTransaction#setReorderingAllowed(boolean))`(boolean reorderingAllowed) ` Sets whether or not to allow optimizing operations within and across transactions. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[setTransition](https://developer.android.com/reference/android/app/FragmentTransaction#setTransition(int))`(int transit) ` Select a standard transition animation for this transaction. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[setTransitionStyle](https://developer.android.com/reference/android/app/FragmentTransaction#setTransitionStyle(int))`(int styleRes) ` Set a custom style resource that will be used for resolving transit animations. | | ` abstract `[FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | ` `[show](https://developer.android.com/reference/android/app/FragmentTransaction#show(android.app.Fragment))`(`[Fragment](https://developer.android.com/reference/android/app/Fragment)` fragment) ` Shows a previously hidden fragment. | | ### Inherited methods | |-----------------------|---| | From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | || ## Constants ### TRANSIT_ENTER_MASK Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int TRANSIT_ENTER_MASK ``` Bit mask that is set for all enter transitions.
Constant Value: 4096 (0x00001000) ### TRANSIT_EXIT_MASK Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int TRANSIT_EXIT_MASK ``` Bit mask that is set for all exit transitions.
Constant Value: 8192 (0x00002000) ### TRANSIT_FRAGMENT_CLOSE Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int TRANSIT_FRAGMENT_CLOSE ``` Fragment is being removed from the stack
Constant Value: 8194 (0x00002002) ### TRANSIT_FRAGMENT_FADE Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int TRANSIT_FRAGMENT_FADE ``` Fragment should simply fade in or out; that is, no strong navigation associated with it except that it is appearing or disappearing for some reason.
Constant Value: 4099 (0x00001003) ### TRANSIT_FRAGMENT_OPEN Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int TRANSIT_FRAGMENT_OPEN ``` Fragment is being added onto the stack
Constant Value: 4097 (0x00001001) ### TRANSIT_NONE Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int TRANSIT_NONE ``` No animation for transition.
Constant Value: 0 (0x00000000) ### TRANSIT_UNSET Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public static final int TRANSIT_UNSET ``` Not set up for a transition.
Constant Value: -1 (0xffffffff) ## Public constructors ### FragmentTransaction ``` public FragmentTransaction () ```

## Public methods ### add Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction add (Fragment fragment, String tag) ``` Calls[add(int, android.app.Fragment, java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#add(int,%20android.app.Fragment,%20java.lang.String))with a 0 containerViewId.
| Parameters || |------------|-------------------| | `fragment` | `Fragment`
| | `tag` | `String`
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### add Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction add (int containerViewId, Fragment fragment) ``` Calls[add(int, android.app.Fragment, java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#add(int,%20android.app.Fragment,%20java.lang.String))with a null tag.
| Parameters || |-------------------|-------------------| | `containerViewId` | `int`
| | `fragment` | `Fragment`
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### add Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction add (int containerViewId, Fragment fragment, String tag) ``` Add a fragment to the activity state. This fragment may optionally also have its view (if[Fragment.onCreateView](https://developer.android.com/reference/android/app/Fragment#onCreateView(android.view.LayoutInflater,%20android.view.ViewGroup,%20android.os.Bundle))returns non-null) inserted into a container view of the activity.
| Parameters || |-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `containerViewId` | `int`: Optional identifier of the container this fragment is to be placed in. If 0, it will not be placed in a container.
| | `fragment` | `Fragment`: The fragment to be added. This fragment must not already be added to the activity.
| | `tag` | `String`: Optional tag name for the fragment, to later retrieve the fragment with[FragmentManager.findFragmentByTag(String)](https://developer.android.com/reference/android/app/FragmentManager#findFragmentByTag(java.lang.String)).
| | Returns || |------------------------------------------------------------------------------------------------|-------------------------------------------------------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | Returns the same FragmentTransaction instance.
| ### addSharedElement Added in[API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction addSharedElement (View sharedElement, String name) ``` Used with to map a View from a removed or hidden Fragment to a View from a shown or added Fragment.
| Parameters || |-----------------|---------------------------------------------------------------------------------------------------------| | `sharedElement` | `View`: A View in a disappearing Fragment to match with a View in an appearing Fragment.
| | `name` | `String`: The transitionName for a View in an appearing Fragment to match to the shared element.
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### addToBackStack Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction addToBackStack (String name) ``` Add this transaction to the back stack. This means that the transaction will be remembered after it is committed, and will reverse its operation when later popped off the stack.
| Parameters || |--------|-----------------------------------------------------------------------| | `name` | `String`: An optional name for this back stack state, or null.
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### attach Added in[API level 13](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction attach (Fragment fragment) ``` Re-attach a fragment after it had previously been detached from the UI with[detach(android.app.Fragment)](https://developer.android.com/reference/android/app/FragmentTransaction#detach(android.app.Fragment)). This causes its view hierarchy to be re-created, attached to the UI, and displayed.
| Parameters || |------------|-------------------------------------------------| | `fragment` | `Fragment`: The fragment to be attached.
| | Returns || |------------------------------------------------------------------------------------------------|-------------------------------------------------------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | Returns the same FragmentTransaction instance.
| ### commit Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract int commit () ``` Schedules a commit of this transaction. The commit does not happen immediately; it will be scheduled as work on the main thread to be done the next time that thread is ready. A transaction can only be committed with this method prior to its containing activity saving its state. If the commit is attempted after that point, an exception will be thrown. This is because the state after the commit can be lost if the activity needs to be restored from its state. See[commitAllowingStateLoss()](https://developer.android.com/reference/android/app/FragmentTransaction#commitAllowingStateLoss())for situations where it may be okay to lose the commit.

| Returns || |-------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `int` | Returns the identifier of this transaction's back stack entry, if[addToBackStack(java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#addToBackStack(java.lang.String))had been called. Otherwise, returns a negative number.
| ### commitAllowingStateLoss Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract int commitAllowingStateLoss () ``` Like[commit()](https://developer.android.com/reference/android/app/FragmentTransaction#commit())but allows the commit to be executed after an activity's state is saved. This is dangerous because the commit can be lost if the activity needs to later be restored from its state, so this should only be used for cases where it is okay for the UI state to change unexpectedly on the user.
| Returns || |-------|--------| | `int` |
| ### commitNow Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract void commitNow () ``` Commits this transaction synchronously. Any added fragments will be initialized and brought completely to the lifecycle state of their host and any removed fragments will be torn down accordingly before this call returns. Committing a transaction in this way allows fragments to be added as dedicated, encapsulated components that monitor the lifecycle state of their host while providing firmer ordering guarantees around when those fragments are fully initialized and ready. Fragments that manage views will have those views created and attached. Calling`commitNow`is preferable to calling[commit()](https://developer.android.com/reference/android/app/FragmentTransaction#commit())followed by[FragmentManager.executePendingTransactions()](https://developer.android.com/reference/android/app/FragmentManager#executePendingTransactions())as the latter will have the side effect of attempting to commit*all*currently pending transactions whether that is the desired behavior or not. Transactions committed in this way may not be added to the FragmentManager's back stack, as doing so would break other expected ordering guarantees for other asynchronously committed transactions. This method will throw[IllegalStateException](https://developer.android.com/reference/java/lang/IllegalStateException)if the transaction previously requested to be added to the back stack with[addToBackStack(java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#addToBackStack(java.lang.String)). A transaction can only be committed with this method prior to its containing activity saving its state. If the commit is attempted after that point, an exception will be thrown. This is because the state after the commit can be lost if the activity needs to be restored from its state. See[commitAllowingStateLoss()](https://developer.android.com/reference/android/app/FragmentTransaction#commitAllowingStateLoss())for situations where it may be okay to lose the commit.

### commitNowAllowingStateLoss Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract void commitNowAllowingStateLoss () ``` Like[commitNow()](https://developer.android.com/reference/android/app/FragmentTransaction#commitNow())but allows the commit to be executed after an activity's state is saved. This is dangerous because the commit can be lost if the activity needs to later be restored from its state, so this should only be used for cases where it is okay for the UI state to change unexpectedly on the user.
### detach Added in[API level 13](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction detach (Fragment fragment) ``` Detach the given fragment from the UI. This is the same state as when it is put on the back stack: the fragment is removed from the UI, however its state is still being actively managed by the fragment manager. When going into this state its view hierarchy is destroyed.
| Parameters || |------------|-------------------------------------------------| | `fragment` | `Fragment`: The fragment to be detached.
| | Returns || |------------------------------------------------------------------------------------------------|-------------------------------------------------------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | Returns the same FragmentTransaction instance.
| ### disallowAddToBackStack Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction disallowAddToBackStack () ``` Disallow calls to[addToBackStack(java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#addToBackStack(java.lang.String)). Any future calls to addToBackStack will throw[IllegalStateException](https://developer.android.com/reference/java/lang/IllegalStateException). If addToBackStack has already been called, this method will throw IllegalStateException.
| Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### hide Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction hide (Fragment fragment) ``` Hides an existing fragment. This is only relevant for fragments whose views have been added to a container, as this will cause the view to be hidden.
| Parameters || |------------|-----------------------------------------------| | `fragment` | `Fragment`: The fragment to be hidden.
| | Returns || |------------------------------------------------------------------------------------------------|-------------------------------------------------------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | Returns the same FragmentTransaction instance.
| ### isAddToBackStackAllowed Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract boolean isAddToBackStackAllowed () ``` Returns true if this FragmentTransaction is allowed to be added to the back stack. If this method would return false,[addToBackStack(java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#addToBackStack(java.lang.String))will throw[IllegalStateException](https://developer.android.com/reference/java/lang/IllegalStateException).
| Returns || |-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `boolean` | True if[addToBackStack(java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#addToBackStack(java.lang.String))is permitted on this transaction.
| ### isEmpty Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract boolean isEmpty () ```

| Returns || |-----------|---------------------------------------------------------------------------| | `boolean` | `true`if this transaction contains no operations,`false`otherwise.
| ### remove Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction remove (Fragment fragment) ``` Remove an existing fragment. If it was added to a container, its view is also removed from that container.
| Parameters || |------------|------------------------------------------------| | `fragment` | `Fragment`: The fragment to be removed.
| | Returns || |------------------------------------------------------------------------------------------------|-------------------------------------------------------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | Returns the same FragmentTransaction instance.
| ### replace Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction replace (int containerViewId, Fragment fragment, String tag) ``` Replace an existing fragment that was added to a container. This is essentially the same as calling[remove(android.app.Fragment)](https://developer.android.com/reference/android/app/FragmentTransaction#remove(android.app.Fragment))for all currently added fragments that were added with the same containerViewId and then[add(int, android.app.Fragment, java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#add(int,%20android.app.Fragment,%20java.lang.String))with the same arguments given here.
| Parameters || |-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `containerViewId` | `int`: Identifier of the container whose fragment(s) are to be replaced.
| | `fragment` | `Fragment`: The new fragment to place in the container.
| | `tag` | `String`: Optional tag name for the fragment, to later retrieve the fragment with[FragmentManager.findFragmentByTag(String)](https://developer.android.com/reference/android/app/FragmentManager#findFragmentByTag(java.lang.String)).
| | Returns || |------------------------------------------------------------------------------------------------|-------------------------------------------------------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | Returns the same FragmentTransaction instance.
| ### replace Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction replace (int containerViewId, Fragment fragment) ``` Calls[replace(int, android.app.Fragment, java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#replace(int,%20android.app.Fragment,%20java.lang.String))with a null tag.
| Parameters || |-------------------|-------------------| | `containerViewId` | `int`
| | `fragment` | `Fragment`
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### runOnCommit Added in[API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction runOnCommit (Runnable runnable) ``` Add a Runnable to this transaction that will be run after this transaction has been committed. If fragment transactions are[optimized](https://developer.android.com/reference/android/app/FragmentTransaction#setReorderingAllowed(boolean))this may be after other subsequent fragment operations have also taken place, or operations in this transaction may have been optimized out due to the presence of a subsequent fragment transaction in the batch. If a transaction is committed using[commitAllowingStateLoss()](https://developer.android.com/reference/android/app/FragmentTransaction#commitAllowingStateLoss())this runnable may be executed when the FragmentManager is in a state where new transactions may not be committed without allowing state loss. `runOnCommit`may not be used with transactions[added to the back stack](https://developer.android.com/reference/android/app/FragmentTransaction#addToBackStack(java.lang.String))as Runnables cannot be persisted with back stack state.[IllegalStateException](https://developer.android.com/reference/java/lang/IllegalStateException)will be thrown if[addToBackStack(java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#addToBackStack(java.lang.String))has been previously called for this transaction or if it is called after a call to`runOnCommit`.

| Parameters || |------------|------------------------------------| | `runnable` | `Runnable`: Runnable to add
| | Returns || |------------------------------------------------------------------------------------------------|---------------------------------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | this FragmentTransaction
| | Throws || |--------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------| | [IllegalStateException](https://developer.android.com/reference/java/lang/IllegalStateException) | if[addToBackStack(java.lang.String)](https://developer.android.com/reference/android/app/FragmentTransaction#addToBackStack(java.lang.String))has been called | ### setBreadCrumbShortTitle Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction setBreadCrumbShortTitle (int res) ``` Set the short title to show as a bread crumb when this transaction is on the back stack, as used by[FragmentBreadCrumbs](https://developer.android.com/reference/android/app/FragmentBreadCrumbs).
| Parameters || |-------|-------------------------------------------------------| | `res` | `int`: A string resource containing the title.
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### setBreadCrumbShortTitle Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction setBreadCrumbShortTitle (CharSequence text) ``` Like[setBreadCrumbShortTitle(int)](https://developer.android.com/reference/android/app/FragmentTransaction#setBreadCrumbShortTitle(int))but taking a raw string; this method is*not*recommended, as the string can not be changed later if the locale changes.
| Parameters || |--------|-----------------------| | `text` | `CharSequence`
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### setBreadCrumbTitle Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction setBreadCrumbTitle (int res) ``` Set the full title to show as a bread crumb when this transaction is on the back stack, as used by[FragmentBreadCrumbs](https://developer.android.com/reference/android/app/FragmentBreadCrumbs).
| Parameters || |-------|-------------------------------------------------------| | `res` | `int`: A string resource containing the title.
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### setBreadCrumbTitle Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction setBreadCrumbTitle (CharSequence text) ``` Like[setBreadCrumbTitle(int)](https://developer.android.com/reference/android/app/FragmentTransaction#setBreadCrumbTitle(int))but taking a raw string; this method is*not*recommended, as the string can not be changed later if the locale changes.
| Parameters || |--------|-----------------------| | `text` | `CharSequence`
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### setCustomAnimations Added in[API level 13](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction setCustomAnimations (int enter, int exit, int popEnter, int popExit) ``` Set specific animation resources to run for the fragments that are entering and exiting in this transaction. The`popEnter`and`popExit`animations will be played for enter/exit operations specifically when popping the back stack.
| Parameters || |------------|--------------| | `enter` | `int`
| | `exit` | `int`
| | `popEnter` | `int`
| | `popExit` | `int`
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### setCustomAnimations Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction setCustomAnimations (int enter, int exit) ``` Set specific animation resources to run for the fragments that are entering and exiting in this transaction. These animations will not be played when popping the back stack.
| Parameters || |---------|--------------| | `enter` | `int`
| | `exit` | `int`
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### setPrimaryNavigationFragment Added in[API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction setPrimaryNavigationFragment (Fragment fragment) ``` Set a currently active fragment in this FragmentManager as the primary navigation fragment. The primary navigation fragment's[child FragmentManager](https://developer.android.com/reference/android/app/Fragment#getChildFragmentManager())will be called first to process delegated navigation actions such as[FragmentManager.popBackStack()](https://developer.android.com/reference/android/app/FragmentManager#popBackStack())if no ID or transaction name is provided to pop to. Navigation operations outside of the fragment system may choose to delegate those actions to the primary navigation fragment as returned by[FragmentManager.getPrimaryNavigationFragment()](https://developer.android.com/reference/android/app/FragmentManager#getPrimaryNavigationFragment()). The fragment provided must currently be added to the FragmentManager to be set as a primary navigation fragment, or previously added as part of this transaction.

| Parameters || |------------|---------------------------------------------------------------------------| | `fragment` | `Fragment`: the fragment to set as the primary navigation fragment
| | Returns || |------------------------------------------------------------------------------------------------|----------------------------------------------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | the same FragmentTransaction instance
| ### setReorderingAllowed Added in[API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction setReorderingAllowed (boolean reorderingAllowed) ``` Sets whether or not to allow optimizing operations within and across transactions. This will remove redundant operations, eliminating operations that cancel. For example, if two transactions are executed together, one that adds a fragment A and the next replaces it with fragment B, the operations will cancel and only fragment B will be added. That means that fragment A may not go through the creation/destruction lifecycle. The side effect of removing redundant operations is that fragments may have state changes out of the expected order. For example, one transaction adds fragment A, a second adds fragment B, then a third removes fragment A. Without removing the redundant operations, fragment B could expect that while it is being created, fragment A will also exist because fragment A will be removed after fragment B was added. With removing redundant operations, fragment B cannot expect fragment A to exist when it has been created because fragment A's add/remove will be optimized out. It can also reorder the state changes of Fragments to allow for better Transitions. Added Fragments may have[Fragment.onCreate(Bundle)](https://developer.android.com/reference/android/app/Fragment#onCreate(android.os.Bundle))called before replaced Fragments have[Fragment.onDestroy()](https://developer.android.com/reference/android/app/Fragment#onDestroy())called. The default is`false`for applications targeting version versions prior to O and`true`for applications targeting O and later.
| Parameters || |---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------| | `reorderingAllowed` | `boolean`:`true`to enable optimizing out redundant operations or`false`to disable optimizing out redundant operations on this transaction.
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### setTransition Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction setTransition (int transit) ``` Select a standard transition animation for this transaction. May be one of[TRANSIT_NONE](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_NONE),[TRANSIT_FRAGMENT_OPEN](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_FRAGMENT_OPEN),[TRANSIT_FRAGMENT_CLOSE](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_FRAGMENT_CLOSE), or[TRANSIT_FRAGMENT_FADE](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_FRAGMENT_FADE).
| Parameters || |-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `transit` | `int`: Value is[TRANSIT_NONE](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_NONE),[TRANSIT_FRAGMENT_OPEN](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_FRAGMENT_OPEN),[TRANSIT_FRAGMENT_CLOSE](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_FRAGMENT_CLOSE), or[TRANSIT_FRAGMENT_FADE](https://developer.android.com/reference/android/app/FragmentTransaction#TRANSIT_FRAGMENT_FADE)
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### setTransitionStyle Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction setTransitionStyle (int styleRes) ``` Set a custom style resource that will be used for resolving transit animations.
| Parameters || |------------|--------------| | `styleRes` | `int`
| | Returns || |------------------------------------------------------------------------------------------------|--------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) |
| ### show Added in[API level 11](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public abstract FragmentTransaction show (Fragment fragment) ``` Shows a previously hidden fragment. This is only relevant for fragments whose views have been added to a container, as this will cause the view to be shown.
| Parameters || |------------|----------------------------------------------| | `fragment` | `Fragment`: The fragment to be shown.
| | Returns || |------------------------------------------------------------------------------------------------|-------------------------------------------------------| | [FragmentTransaction](https://developer.android.com/reference/android/app/FragmentTransaction) | Returns the same FragmentTransaction instance.
|