NavigationBarItem

代表 Material Design NavigationBar 中的单个目标项。 本接口是对 Jetpack Compose androidx.compose.material3.NavigationBarItem 组件的封装。

NavigationBarItem 的推荐配置取决于其所在的 NavigationBar 中包含的项数:

  • 三个目标:为所有目标显示图标和文本标签。

  • 四个目标:激活的目标显示图标和文本标签。未激活的目标显示图标,并建议显示文本标签。

  • 五个目标:激活的目标显示图标和文本标签。未激活的目标使用图标,如果空间允许,也使用文本标签。

当被选中时,NavigationBarItem 总是会显示其文本标签(如果存在)。

Author

M8Test, [email protected], https://m8test.com

Functions

Link copied to clipboard
abstract fun DisposableEffect(disposableEffectBuilder: DisposableEffect.() -> Unit)
Link copied to clipboard
Link copied to clipboard
abstract fun <V> getCompositionLocalValue(compositionLocal: ProvidableCompositionLocal<V>): V?

获取 compositionLocal 的值

Link copied to clipboard
abstract fun getContext(): ScriptContext

获取脚本上下文对象 ScriptContext.

Link copied to clipboard
abstract fun LaunchedEffect(launchedEffectBuilder: LaunchedEffect.() -> Unit)
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
abstract fun setAlwaysShowLabel(value: Boolean)

设置是否始终显示此项的标签。如果为 false,则标签仅在此项被选中时显示。

Link copied to clipboard
abstract fun setColors(colorsBuilder: NavigationBarItemColors.() -> Unit)

设置 NavigationBarItemColors,它将被用于解析此项在不同状态下的颜色。 可参考 NavigationBarItemDefaults.colors

Link copied to clipboard
abstract fun setEnabled(value: Boolean)

设置此项的启用状态。当值为 false 时,此组件将不会响应用户输入, 并且在视觉上和无障碍服务中都将显示为禁用状态。

Link copied to clipboard
abstract fun setIcon(slotBuilder: UnitScopeSlot.() -> Unit)

设置此项的图标,通常是一个 Icon 可组合项。

Link copied to clipboard
abstract fun setInteractionSource(interactionSource: MutableInteractionSource)

设置用于观察和发出此组件交互的 MutableInteractionSource

Link copied to clipboard
abstract fun setLabel(slotBuilder: UnitScopeSlot.() -> Unit)

设置此项的可选文本标签。

Link copied to clipboard
abstract fun setModifier(modifierBuilder: T.() -> Unit)
Link copied to clipboard
abstract fun setOnClick(callback: () -> Unit)

设置当此项被点击时要执行的回调函数。

Link copied to clipboard
abstract fun setSelected(value: Boolean)

设置此项是否被选中。

Link copied to clipboard
abstract fun setVisible(visible: Boolean)

设置显示/隐藏当前 Composable

Link copied to clipboard
abstract fun SideEffect(sideEffectBuilder: SideEffect.() -> Unit)
Link copied to clipboard

设置所有需要用到的聚合状态,例如 DrawerState, BottomSheetState 等

Link copied to clipboard
abstract fun trackSingleState(state: SingleState)

添加当前 Composable 需要监听的状态,如果状态改变的话 Composable 会重组