Customize Text Selection Menu

[patrickjsalmon]

Hi!

New to Readium, but very impressed with everything. Can't thank this community enough for what has been built. I'm working on a new EPUB reader app, and I need to customize the native iOS text selection menu (add new customized buttons and change the style of it. I know injecting Java into WKWebView is a bit tricky for this - do you all have any guidance on how best to do this? Couldn't find relevant discussions here addressing.

Let me know if you have any questions, and thanks in advance for any help.

[mickael-menu]

If you want to add a new entry in the text selection menu, you can add a new custom editing action when initializing the navigator:

swift-toolkit/TestApp/Sources/Reader/EPUB/EPUBViewController.swift

Lines 42 to 46 in efba3a0

	editingActions: EditingAction.defaultActions
	.appending(EditingAction(
	title: "Highlight",
	action: #selector(highlightSelection)
	)),

Then implement the callback in the responder chain (so usually a parent view controller of the navigator), with @objc:

swift-toolkit/TestApp/Sources/Reader/EPUB/EPUBViewController.swift

Lines 94 to 100 in efba3a0

	@objc func highlightSelection() {
	if let selection = navigator.currentSelection {
	let highlight = Highlight(bookId: bookId, locator: selection.locator, color: .yellow)
	saveHighlight(highlight)
	navigator.clearSelection()
	}
	}

As far as I know, you cannot customize the style of the native iOS text selection menu. However, you can prevent it from appearing and design your own menu by implementing this delegate method:

swift-toolkit/Sources/Navigator/SelectableNavigator.swift

Lines 34 to 37 in efba3a0

	/// Returns whether the default edit menu (`UIMenuController`) should be displayed for the given `selection`.
	///
	/// To implement a custom selection pop-up, return false and display your own view using `selection.frame`.
	func navigator(_ navigator: SelectableNavigator, shouldShowMenuForSelection selection: Selection) -> Bool

You can use selection.frame to get the rectangle of the selection in the view coordinates of the navigator.

[patrickjsalmon]

Mickael,

Hey, sorry for the delay, but I'm really grateful for this breakdown and guidance. I'll be working to implement this ASAP and will let you know if there are any issues. Hoping your work on this thread will help guide others, too.

Really appreciative!

Have a great day!

-Patrick