pull/497/head
gedoor
4 years ago
parent
d5183123c0
commit
922b3f5943
@ -0,0 +1,5 @@ |
||||
# 源规则帮助 |
||||
|
||||
* [书源帮助文档](https://alanskycn.gitee.io/teachme/Rule/source.html) |
||||
* [订阅源帮助文档](https://alanskycn.gitee.io/teachme/Rule/rss.html) |
||||
|
||||
@ -0,0 +1,437 @@ |
||||
package io.legado.app.ui.widget.text |
||||
|
||||
import android.app.Activity |
||||
import android.graphics.RectF |
||||
import android.text.Selection |
||||
import android.text.Spannable |
||||
import android.text.Spanned |
||||
import android.text.method.LinkMovementMethod |
||||
import android.text.style.BackgroundColorSpan |
||||
import android.text.style.ClickableSpan |
||||
import android.text.style.URLSpan |
||||
import android.text.util.Linkify |
||||
import android.view.* |
||||
import android.widget.TextView |
||||
import io.legado.app.R |
||||
import io.legado.app.ui.widget.text.BetterLinkMovementMethod.LongPressTimer.OnTimerReachedListener |
||||
|
||||
class BetterLinkMovementMethod protected constructor() : LinkMovementMethod() { |
||||
private var onLinkClickListener: OnLinkClickListener? = null |
||||
private var onLinkLongClickListener: OnLinkLongClickListener? = null |
||||
private val touchedLineBounds = RectF() |
||||
private var isUrlHighlighted = false |
||||
private var clickableSpanUnderTouchOnActionDown: ClickableSpan? = null |
||||
private var activeTextViewHashcode = 0 |
||||
private var ongoingLongPressTimer: LongPressTimer? = null |
||||
private var wasLongPressRegistered = false |
||||
|
||||
interface OnLinkClickListener { |
||||
/** |
||||
* @param textView The TextView on which a click was registered. |
||||
* @param url The clicked URL. |
||||
* @return True if this click was handled. False to let Android handle the URL. |
||||
*/ |
||||
fun onClick(textView: TextView?, url: String?): Boolean |
||||
} |
||||
|
||||
interface OnLinkLongClickListener { |
||||
/** |
||||
* @param textView The TextView on which a long-click was registered. |
||||
* @param url The long-clicked URL. |
||||
* @return True if this long-click was handled. False to let Android handle the URL (as a short-click). |
||||
*/ |
||||
fun onLongClick(textView: TextView?, url: String?): Boolean |
||||
} |
||||
|
||||
/** |
||||
* Set a listener that will get called whenever any link is clicked on the TextView. |
||||
*/ |
||||
fun setOnLinkClickListener(clickListener: OnLinkClickListener?): BetterLinkMovementMethod { |
||||
if (this === singleInstance) { |
||||
throw UnsupportedOperationException( |
||||
"Setting a click listener on the instance returned by getInstance() is not supported to avoid memory " + |
||||
"leaks. Please use newInstance() or any of the linkify() methods instead." |
||||
) |
||||
} |
||||
onLinkClickListener = clickListener |
||||
return this |
||||
} |
||||
|
||||
/** |
||||
* Set a listener that will get called whenever any link is clicked on the TextView. |
||||
*/ |
||||
fun setOnLinkLongClickListener(longClickListener: OnLinkLongClickListener?): BetterLinkMovementMethod { |
||||
if (this === singleInstance) { |
||||
throw UnsupportedOperationException( |
||||
"Setting a long-click listener on the instance returned by getInstance() is not supported to avoid " + |
||||
"memory leaks. Please use newInstance() or any of the linkify() methods instead." |
||||
) |
||||
} |
||||
onLinkLongClickListener = longClickListener |
||||
return this |
||||
} |
||||
|
||||
override fun onTouchEvent(textView: TextView, text: Spannable, event: MotionEvent): Boolean { |
||||
if (activeTextViewHashcode != textView.hashCode()) { |
||||
// Bug workaround: TextView stops calling onTouchEvent() once any URL is highlighted. |
||||
// A hacky solution is to reset any "autoLink" property set in XML. But we also want |
||||
// to do this once per TextView. |
||||
activeTextViewHashcode = textView.hashCode() |
||||
textView.autoLinkMask = 0 |
||||
} |
||||
val clickableSpanUnderTouch = findClickableSpanUnderTouch(textView, text, event) |
||||
if (event.action == MotionEvent.ACTION_DOWN) { |
||||
clickableSpanUnderTouchOnActionDown = clickableSpanUnderTouch |
||||
} |
||||
val touchStartedOverAClickableSpan = clickableSpanUnderTouchOnActionDown != null |
||||
return when (event.action) { |
||||
MotionEvent.ACTION_DOWN -> { |
||||
clickableSpanUnderTouch?.let { highlightUrl(textView, it, text) } |
||||
if (touchStartedOverAClickableSpan && onLinkLongClickListener != null) { |
||||
val longClickListener: OnTimerReachedListener = |
||||
object : OnTimerReachedListener { |
||||
override fun onTimerReached() { |
||||
wasLongPressRegistered = true |
||||
textView.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS) |
||||
removeUrlHighlightColor(textView) |
||||
dispatchUrlLongClick(textView, clickableSpanUnderTouch) |
||||
} |
||||
} |
||||
startTimerForRegisteringLongClick(textView, longClickListener) |
||||
} |
||||
touchStartedOverAClickableSpan |
||||
} |
||||
MotionEvent.ACTION_UP -> { |
||||
// Register a click only if the touch started and ended on the same URL. |
||||
if (!wasLongPressRegistered && touchStartedOverAClickableSpan && clickableSpanUnderTouch === clickableSpanUnderTouchOnActionDown) { |
||||
dispatchUrlClick(textView, clickableSpanUnderTouch) |
||||
} |
||||
cleanupOnTouchUp(textView) |
||||
|
||||
// Consume this event even if we could not find any spans to avoid letting Android handle this event. |
||||
// Android's TextView implementation has a bug where links get clicked even when there is no more text |
||||
// next to the link and the touch lies outside its bounds in the same direction. |
||||
touchStartedOverAClickableSpan |
||||
} |
||||
MotionEvent.ACTION_CANCEL -> { |
||||
cleanupOnTouchUp(textView) |
||||
false |
||||
} |
||||
MotionEvent.ACTION_MOVE -> { |
||||
// Stop listening for a long-press as soon as the user wanders off to unknown lands. |
||||
if (clickableSpanUnderTouch !== clickableSpanUnderTouchOnActionDown) { |
||||
removeLongPressCallback(textView) |
||||
} |
||||
if (!wasLongPressRegistered) { |
||||
// Toggle highlight. |
||||
if (clickableSpanUnderTouch != null) { |
||||
highlightUrl(textView, clickableSpanUnderTouch, text) |
||||
} else { |
||||
removeUrlHighlightColor(textView) |
||||
} |
||||
} |
||||
touchStartedOverAClickableSpan |
||||
} |
||||
else -> false |
||||
} |
||||
} |
||||
|
||||
private fun cleanupOnTouchUp(textView: TextView) { |
||||
wasLongPressRegistered = false |
||||
clickableSpanUnderTouchOnActionDown = null |
||||
removeUrlHighlightColor(textView) |
||||
removeLongPressCallback(textView) |
||||
} |
||||
|
||||
/** |
||||
* Determines the touched location inside the TextView's text and returns the ClickableSpan found under it (if any). |
||||
* |
||||
* @return The touched ClickableSpan or null. |
||||
*/ |
||||
protected fun findClickableSpanUnderTouch( |
||||
textView: TextView, |
||||
text: Spannable, |
||||
event: MotionEvent |
||||
): ClickableSpan? { |
||||
// So we need to find the location in text where touch was made, regardless of whether the TextView |
||||
// has scrollable text. That is, not the entire text is currently visible. |
||||
var touchX = event.x.toInt() |
||||
var touchY = event.y.toInt() |
||||
|
||||
// Ignore padding. |
||||
touchX -= textView.totalPaddingLeft |
||||
touchY -= textView.totalPaddingTop |
||||
|
||||
// Account for scrollable text. |
||||
touchX += textView.scrollX |
||||
touchY += textView.scrollY |
||||
val layout = textView.layout |
||||
val touchedLine = layout.getLineForVertical(touchY) |
||||
val touchOffset = layout.getOffsetForHorizontal(touchedLine, touchX.toFloat()) |
||||
touchedLineBounds.left = layout.getLineLeft(touchedLine) |
||||
touchedLineBounds.top = layout.getLineTop(touchedLine).toFloat() |
||||
touchedLineBounds.right = layout.getLineWidth(touchedLine) + touchedLineBounds.left |
||||
touchedLineBounds.bottom = layout.getLineBottom(touchedLine).toFloat() |
||||
return if (touchedLineBounds.contains(touchX.toFloat(), touchY.toFloat())) { |
||||
// Find a ClickableSpan that lies under the touched area. |
||||
val spans = text.getSpans(touchOffset, touchOffset, ClickableSpan::class.java) |
||||
for (span in spans) { |
||||
if (span is ClickableSpan) { |
||||
return span |
||||
} |
||||
} |
||||
// No ClickableSpan found under the touched location. |
||||
null |
||||
} else { |
||||
// Touch lies outside the line's horizontal bounds where no spans should exist. |
||||
null |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* Adds a background color span at <var>clickableSpan</var>'s location. |
||||
*/ |
||||
protected fun highlightUrl(textView: TextView, clickableSpan: ClickableSpan?, text: Spannable) { |
||||
if (isUrlHighlighted) { |
||||
return |
||||
} |
||||
isUrlHighlighted = true |
||||
val spanStart = text.getSpanStart(clickableSpan) |
||||
val spanEnd = text.getSpanEnd(clickableSpan) |
||||
val highlightSpan = BackgroundColorSpan(textView.highlightColor) |
||||
text.setSpan(highlightSpan, spanStart, spanEnd, Spannable.SPAN_INCLUSIVE_INCLUSIVE) |
||||
textView.setTag(R.id.bettermovementmethod_highlight_background_span, highlightSpan) |
||||
Selection.setSelection(text, spanStart, spanEnd) |
||||
} |
||||
|
||||
/** |
||||
* Removes the highlight color under the Url. |
||||
*/ |
||||
protected fun removeUrlHighlightColor(textView: TextView) { |
||||
if (!isUrlHighlighted) { |
||||
return |
||||
} |
||||
isUrlHighlighted = false |
||||
val text = textView.text as Spannable |
||||
val highlightSpan = |
||||
textView.getTag(R.id.bettermovementmethod_highlight_background_span) as BackgroundColorSpan |
||||
text.removeSpan(highlightSpan) |
||||
Selection.removeSelection(text) |
||||
} |
||||
|
||||
protected fun startTimerForRegisteringLongClick( |
||||
textView: TextView, |
||||
longClickListener: OnTimerReachedListener? |
||||
) { |
||||
ongoingLongPressTimer = LongPressTimer() |
||||
ongoingLongPressTimer!!.setOnTimerReachedListener(longClickListener) |
||||
textView.postDelayed( |
||||
ongoingLongPressTimer, |
||||
ViewConfiguration.getLongPressTimeout().toLong() |
||||
) |
||||
} |
||||
|
||||
/** |
||||
* Remove the long-press detection timer. |
||||
*/ |
||||
protected fun removeLongPressCallback(textView: TextView) { |
||||
if (ongoingLongPressTimer != null) { |
||||
textView.removeCallbacks(ongoingLongPressTimer) |
||||
ongoingLongPressTimer = null |
||||
} |
||||
} |
||||
|
||||
protected fun dispatchUrlClick(textView: TextView, clickableSpan: ClickableSpan?) { |
||||
val clickableSpanWithText = ClickableSpanWithText.ofSpan(textView, clickableSpan) |
||||
val handled = onLinkClickListener != null && onLinkClickListener!!.onClick( |
||||
textView, |
||||
clickableSpanWithText.text() |
||||
) |
||||
if (!handled) { |
||||
// Let Android handle this click. |
||||
clickableSpanWithText.span()!!.onClick(textView) |
||||
} |
||||
} |
||||
|
||||
protected fun dispatchUrlLongClick(textView: TextView, clickableSpan: ClickableSpan?) { |
||||
val clickableSpanWithText = ClickableSpanWithText.ofSpan(textView, clickableSpan) |
||||
val handled = onLinkLongClickListener != null && onLinkLongClickListener!!.onLongClick( |
||||
textView, |
||||
clickableSpanWithText.text() |
||||
) |
||||
if (!handled) { |
||||
// Let Android handle this long click as a short-click. |
||||
clickableSpanWithText.span()!!.onClick(textView) |
||||
} |
||||
} |
||||
|
||||
protected class LongPressTimer : Runnable { |
||||
private var onTimerReachedListener: OnTimerReachedListener? = null |
||||
|
||||
interface OnTimerReachedListener { |
||||
fun onTimerReached() |
||||
} |
||||
|
||||
override fun run() { |
||||
onTimerReachedListener!!.onTimerReached() |
||||
} |
||||
|
||||
fun setOnTimerReachedListener(listener: OnTimerReachedListener?) { |
||||
onTimerReachedListener = listener |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* A wrapper to support all [ClickableSpan]s that may or may not provide URLs. |
||||
*/ |
||||
protected class ClickableSpanWithText protected constructor( |
||||
private val span: ClickableSpan?, |
||||
private val text: String |
||||
) { |
||||
fun span(): ClickableSpan? { |
||||
return span |
||||
} |
||||
|
||||
fun text(): String { |
||||
return text |
||||
} |
||||
|
||||
companion object { |
||||
fun ofSpan(textView: TextView, span: ClickableSpan?): ClickableSpanWithText { |
||||
val s = textView.text as Spanned |
||||
val text: String |
||||
text = if (span is URLSpan) { |
||||
span.url |
||||
} else { |
||||
val start = s.getSpanStart(span) |
||||
val end = s.getSpanEnd(span) |
||||
s.subSequence(start, end).toString() |
||||
} |
||||
return ClickableSpanWithText(span, text) |
||||
} |
||||
} |
||||
} |
||||
|
||||
companion object { |
||||
private var singleInstance: BetterLinkMovementMethod? = null |
||||
private const val LINKIFY_NONE = -2 |
||||
|
||||
/** |
||||
* Return a new instance of BetterLinkMovementMethod. |
||||
*/ |
||||
fun newInstance(): BetterLinkMovementMethod { |
||||
return BetterLinkMovementMethod() |
||||
} |
||||
|
||||
/** |
||||
* @param linkifyMask One of [Linkify.ALL], [Linkify.PHONE_NUMBERS], [Linkify.MAP_ADDRESSES], |
||||
* [Linkify.WEB_URLS] and [Linkify.EMAIL_ADDRESSES]. |
||||
* @param textViews The TextViews on which a [BetterLinkMovementMethod] should be registered. |
||||
* @return The registered [BetterLinkMovementMethod] on the TextViews. |
||||
*/ |
||||
fun linkify(linkifyMask: Int, vararg textViews: TextView): BetterLinkMovementMethod { |
||||
val movementMethod = newInstance() |
||||
for (textView in textViews) { |
||||
addLinks(linkifyMask, movementMethod, textView) |
||||
} |
||||
return movementMethod |
||||
} |
||||
|
||||
/** |
||||
* Like [.linkify], but can be used for TextViews with HTML links. |
||||
* |
||||
* @param textViews The TextViews on which a [BetterLinkMovementMethod] should be registered. |
||||
* @return The registered [BetterLinkMovementMethod] on the TextViews. |
||||
*/ |
||||
fun linkifyHtml(vararg textViews: TextView): BetterLinkMovementMethod { |
||||
return linkify(LINKIFY_NONE, *textViews) |
||||
} |
||||
|
||||
/** |
||||
* Recursively register a [BetterLinkMovementMethod] on every TextView inside a layout. |
||||
* |
||||
* @param linkifyMask One of [Linkify.ALL], [Linkify.PHONE_NUMBERS], [Linkify.MAP_ADDRESSES], |
||||
* [Linkify.WEB_URLS] and [Linkify.EMAIL_ADDRESSES]. |
||||
* @return The registered [BetterLinkMovementMethod] on the TextViews. |
||||
*/ |
||||
fun linkify(linkifyMask: Int, viewGroup: ViewGroup): BetterLinkMovementMethod { |
||||
val movementMethod = newInstance() |
||||
rAddLinks(linkifyMask, viewGroup, movementMethod) |
||||
return movementMethod |
||||
} |
||||
|
||||
/** |
||||
* Like [.linkify], but can be used for TextViews with HTML links. |
||||
* |
||||
* @return The registered [BetterLinkMovementMethod] on the TextViews. |
||||
*/ |
||||
fun linkifyHtml(viewGroup: ViewGroup): BetterLinkMovementMethod { |
||||
return linkify(LINKIFY_NONE, viewGroup) |
||||
} |
||||
|
||||
/** |
||||
* Recursively register a [BetterLinkMovementMethod] on every TextView inside a layout. |
||||
* |
||||
* @param linkifyMask One of [Linkify.ALL], [Linkify.PHONE_NUMBERS], [Linkify.MAP_ADDRESSES], |
||||
* [Linkify.WEB_URLS] and [Linkify.EMAIL_ADDRESSES]. |
||||
* @return The registered [BetterLinkMovementMethod] on the TextViews. |
||||
*/ |
||||
fun linkify(linkifyMask: Int, activity: Activity): BetterLinkMovementMethod { |
||||
// Find the layout passed to setContentView(). |
||||
val activityLayout = |
||||
(activity.findViewById<View>(Window.ID_ANDROID_CONTENT) as ViewGroup).getChildAt(0) as ViewGroup |
||||
val movementMethod = newInstance() |
||||
rAddLinks(linkifyMask, activityLayout, movementMethod) |
||||
return movementMethod |
||||
} |
||||
|
||||
/** |
||||
* Like [.linkify], but can be used for TextViews with HTML links. |
||||
* |
||||
* @return The registered [BetterLinkMovementMethod] on the TextViews. |
||||
*/ |
||||
fun linkifyHtml(activity: Activity): BetterLinkMovementMethod { |
||||
return linkify(LINKIFY_NONE, activity) |
||||
} |
||||
|
||||
/** |
||||
* Get a static instance of BetterLinkMovementMethod. Do note that registering a click listener on the returned |
||||
* instance is not supported because it will potentially be shared on multiple TextViews. |
||||
*/ |
||||
val instance: BetterLinkMovementMethod? |
||||
get() { |
||||
if (singleInstance == null) { |
||||
singleInstance = BetterLinkMovementMethod() |
||||
} |
||||
return singleInstance |
||||
} |
||||
|
||||
// ======== PUBLIC APIs END ======== // |
||||
private fun rAddLinks( |
||||
linkifyMask: Int, |
||||
viewGroup: ViewGroup, |
||||
movementMethod: BetterLinkMovementMethod |
||||
) { |
||||
for (i in 0 until viewGroup.childCount) { |
||||
val child = viewGroup.getChildAt(i) |
||||
if (child is ViewGroup) { |
||||
// Recursively find child TextViews. |
||||
rAddLinks(linkifyMask, child, movementMethod) |
||||
} else if (child is TextView) { |
||||
addLinks(linkifyMask, movementMethod, child) |
||||
} |
||||
} |
||||
} |
||||
|
||||
private fun addLinks( |
||||
linkifyMask: Int, |
||||
movementMethod: BetterLinkMovementMethod, |
||||
textView: TextView |
||||
) { |
||||
textView.movementMethod = movementMethod |
||||
if (linkifyMask != LINKIFY_NONE) { |
||||
Linkify.addLinks(textView, linkifyMask) |
||||
} |
||||
} |
||||
} |
||||
} |
||||
Loading…
Reference in new issue