kitepdf-compose-viewer/io.github.yuroyami.kitepdf.compose/KiteSelectionMenu

KiteSelectionMenu

fun BoxScope.KiteSelectionMenu(state: KiteDocViewState, items: List<KiteSelectionMenuItem>, modifier: Modifier = Modifier, highlightColors: List<Color> = emptyList(), onHighlightColorPicked: (KiteTextSelection, Color) -> Unit? = null, clearSelectionOnColorPick: Boolean = true, alignment: Alignment = Alignment.TopCenter, showWhileSelecting: Boolean = false, containerColor: Color = KiteSelectionMenuDefaults.ContainerColor, contentColor: Color = KiteSelectionMenuDefaults.ContentColor, container: @Composable (selection: KiteTextSelection, content: @Composable () -> Unit) -> Unit? = null, itemContent: @Composable (item: KiteSelectionMenuItem, selection: KiteTextSelection) -> Unit? = null, colorSwatch: @Composable (color: Color, onPick: () -> Unit) -> Unit? = null)

The selection context menu: place it in KiteDocView's overlay slot and it appears whenever text is selected, listing items and, when highlightColors is non-empty, a wrapping row of colour swatches.

It waits for the finger to lift. While KiteDocViewState.selectionInProgress is true the menu stays hidden, because a popup over the page mid-drag covers the very words being chosen; it appears the moment the drag ends.

Every visual layer is replaceable:

container swaps the card the menu sits in (the default is a white rounded card); its content argument is the laid-out menu body.
itemContent swaps how one action renders (the default is a pill chip).
colorSwatch swaps how one colour renders (the default is a circle).
For a completely different menu, skip this composable and build your own against KiteDocViewState.selection and KiteDocViewState.selectionInProgress; this one is the default, not the contract.

KiteDocView(state, overlay = {
    KiteSelectionMenu(
        state = state,
        items = listOf(
            KiteSelectionMenuItem("Copy") { clipboard.setText(AnnotatedString(it.text)) },
            KiteSelectionMenuItem("Highlight") { marks.add(it) },
        ),
        highlightColors = listOf(Color.Yellow, Color.Green, Color.Cyan),
        onHighlightColorPicked = { sel, color -> marks.add(sel, color) },
    )
})