feat: add PanguTextPatcher

This commit is contained in:
2025-03-05 21:48:55 +08:00
parent 6946e5e9be
commit 15e07c01dd
4 changed files with 150 additions and 17 deletions

View File

@@ -0,0 +1,52 @@
/*
* PanguText - A typographic solution for the optimal alignment of CJK characters, English words, and half-width digits.
* Copyright (C) 2019 HighCapable
* https://github.com/BetterAndroid/PanguText
*
* Apache License Version 2.0
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* This file is created by fankes on 2025/3/4.
*/
package com.highcapable.pangutext.android.factory
import android.view.View
import android.view.ViewGroup
import android.widget.TextView
import com.highcapable.betterandroid.ui.extension.view.walkThroughChildren
import com.highcapable.pangutext.android.PanguText
import com.highcapable.pangutext.android.PanguTextConfig
/**
* Patcher for [PanguText].
*/
object PanguTextPatcher {
/**
* Patch [PanguText] to the view.
* @param view the view or view group.
* @param config the configuration of [PanguText].
*/
@JvmOverloads
@JvmStatic
fun patch(view: View, config: PanguTextConfig = PanguText.globalConfig) {
when (view) {
is TextView -> PanguWidget.startInjection(view, config = config)
is ViewGroup ->
view.walkThroughChildren()
.filterIsInstance<TextView>()
.forEach { PanguWidget.startInjection(it, config = config) }
}
}
}

View File

@@ -85,44 +85,59 @@ internal object PanguWidget {
}
// Ignore if the instance is not a [TextView].
if (instance !is TextView) return null
var config = PanguText.globalConfig
return startInjection(instance, attrs)
}
/**
* Start the injection of [PanguText] to the given [TextView].
* @param instance the instance of [TextView].
* @param attrs the attributes.
* @param config the configuration of [PanguText].
* @return [TV]
*/
inline fun <reified TV : TextView> startInjection(
instance: TV,
attrs: AttributeSet? = null,
config: PanguTextConfig = PanguText.globalConfig
): TV {
var sConfig = config
if (instance is PanguTextView) {
val configCopy = config.copy()
val configCopy = sConfig.copy()
instance.configurePanguText(configCopy)
config = configCopy
if (!config.isEnabled) return instance
sConfig = configCopy
if (!sConfig.isEnabled) return instance
} else instance.obtainStyledAttributes(attrs, R.styleable.PanguTextHelper) {
val isEnabled = it.getBooleanOrNull(R.styleable.PanguTextHelper_panguText_enabled)
val isProcessedSpanned = it.getBooleanOrNull(R.styleable.PanguTextHelper_panguText_processedSpanned)
val isAutoRemeasureText = it.getBooleanOrNull(R.styleable.PanguTextHelper_panguText_autoRemeasureText)
val cjkSpacingRatio = it.getFloatOrNull(R.styleable.PanguTextHelper_panguText_cjkSpacingRatio)
val excludePatterns = it.getStringOrNull(R.styleable.PanguTextHelper_panguText_excludePatterns)
?.split(TEXT_REGEX_SPLITE_SYMBOL)?.mapNotNull { regex ->
?.split(TEXT_REGEX_SPLITE_SYMBOL)?.mapNotNull { regex ->
runCatching { regex.toRegex() }.onFailure { th ->
Log.e(PangutextAndroidProperties.PROJECT_NAME, "Invalid exclude pattern of $instance: $regex", th)
}.getOrNull()
}?.toTypedArray() ?: emptyArray()
if (isEnabled == false) return instance
if (isProcessedSpanned != null || isAutoRemeasureText != null || cjkSpacingRatio != null || excludePatterns.isNotEmpty()) {
val configCopy = config.copy()
configCopy.isProcessedSpanned = isProcessedSpanned ?: config.isProcessedSpanned
configCopy.isAutoRemeasureText = isAutoRemeasureText ?: config.isAutoRemeasureText
configCopy.cjkSpacingRatio = cjkSpacingRatio ?: config.cjkSpacingRatio
val configCopy = sConfig.copy()
configCopy.isProcessedSpanned = isProcessedSpanned ?: sConfig.isProcessedSpanned
configCopy.isAutoRemeasureText = isAutoRemeasureText ?: sConfig.isAutoRemeasureText
configCopy.cjkSpacingRatio = cjkSpacingRatio ?: sConfig.cjkSpacingRatio
if (excludePatterns.isNotEmpty()) {
config.excludePatterns.clear()
config.excludePatterns.addAll(excludePatterns)
}; config = configCopy
sConfig.excludePatterns.clear()
sConfig.excludePatterns.addAll(excludePatterns)
}; sConfig = configCopy
}
}
when (instance.javaClass.name) {
// Specialize those components because loading "hint" style after [doOnAttachRepeatable] causes problems.
"com.google.android.material.textfield.TextInputEditText",
"com.google.android.material.textfield.MaterialAutoCompleteTextView" -> {
instance.injectPanguText(config = config)
instance.doOnAttachRepeatable(config) { it.injectRealTimePanguText(injectHint = false, config) }
instance.injectPanguText(config = sConfig)
instance.doOnAttachRepeatable(sConfig) { it.injectRealTimePanguText(injectHint = false, sConfig) }
}
else -> instance.doOnAttachRepeatable(config) {
it.injectRealTimePanguText(config = config)
else -> instance.doOnAttachRepeatable(sConfig) {
it.injectRealTimePanguText(config = sConfig)
}
}; return instance
}