OudsNavigationButton

fun OudsNavigationButton(onClick: () -> Unit, modifier: Modifier = Modifier, chevron: OudsNavigationButtonChevron = OudsNavigationButtonDefaults.Chevron, label: String? = null, enabled: Boolean = true, loader: OudsButtonLoader? = null, appearance: OudsNavigationButtonAppearance = OudsNavigationButtonDefaults.Appearance, interactionSource: MutableInteractionSource? = null)

Navigation button is a UI element that allows to move between different pages within a multipage interface. Navigation button is typically arrange in sequence to indicate the user's current position and provide controls to access previous, next, or specific pages.

Note that if it is placed in an OudsColoredBox, its monochrome variant is automatically displayed.

Rounded corners can be enabled or disabled using the com.orange.ouds.theme.OudsThemeSettings.roundedCornerButtons property in the settings of the theme provided when calling the com.orange.ouds.core.theme.OudsTheme method.

Design

NameNavigation Button
Guidelinesunified-design-system.orange.com
Version3.2.1

Parameters

onClick

Callback invoked when the button is clicked.

modifier

Modifier applied to the button.

chevron

Chevron of the navigation button. See OudsNavigationButtonChevron for allowed values.

label

Label displayed in the button describing the navigation action. This makes the action more explicit and accessible especially for new users or in contexts where clarity is critical.

enabled

Controls the enabled state of the button when there is no loader. When false, this button will not be clickable. Has no effect if loader is provided.

loader

An optional loading progress indicator displayed in the button to indicate an ongoing operation.

appearance

Appearance of the button among OudsNavigationButtonAppearance values. A button with OudsNavigationButtonAppearance.Brand is not allowed as a direct or indirect child of an OudsColoredBox and will throw an IllegalStateException.

interactionSource

An optional hoisted MutableInteractionSource for observing and emitting interactions for this button. Note that if null is provided, interactions will still happen internally.

Samples

OudsNavigationButton(
    label = "Next",
    chevron = OudsNavigationButtonChevron.Next,
    onClick = { /* Navigate to next screen */ }
)
OudsNavigationButton(
    chevron = OudsNavigationButtonChevron.Next,
    onClick = { /* Navigate to next screen */ }
)