应用场景:类似于微博发布页#话题
、@用户
效果演示:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
dependencies {
implementation 'com.github.lrCzh:xspan:latestVersion'
}
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<com.xh.xspan.XSpanEditText
android:id="@+id/et"
android:layout_width="match_parent"
android:layout_height="200dp"
android:gravity="start|top"
android:hint="请输入"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent"/>
</androidx.constraintlayout.widget.ConstraintLayout>
话题信息
@Parcelize
data class Topic(val id: Int, val name: String) : Parcelable
用户信息
@Parcelize
data class User(val id: Int, val name: String) : Parcelable
TopicSpan
(#话题),继承自TextSpan
@Parcelize
class TopicSpan(val topic: Topic) : TextSpan() {
/**
* 要展示的文本内容
*/
override val displayText = "#${topic.name} "
/**
* 要展示的样式
* 注!!!,实现时只能以直接赋值的方式,不能以自定义属性访问器的方式
*/
override val displaySpan = ForegroundColorSpan(Color.RED)
}
AtSpan
(@用户),继承自TextSpan
,这里实现了IntegratedSpan
接口,表示这个Span
具有一体性,删除时会整个被删除
@Parcelize
class AtSpan(val user: User) : TextSpan(), IntegratedSpan {
/**
* 要展示的文本内容
*/
override val displayText = "@${user.name} "
/**
* 要展示的样式
* 注!!!,实现时只能以直接赋值的方式,不能以自定义属性访问器的方式
*/
override val displaySpan = ForegroundColorSpan(Color.BLUE)
}
// 插入话题
et.insertTextSpan(TopicSpan(Topic(1, "话题1")))
// 插入at
et.insertTextSpan(AtSpan(User(1, "用户1")))
// 获取所有的TopicSpan
et.getSpans(TopicSpan::class.java)
// 获取所有的AtSpan
et.getSpans(AtSpan::class.java)
在XML里面给XSpanEditText
追加两个属性:
specialCharSet
需要触发回调的特殊字符。
interceptSpecialChar
是否拦截该特殊字符的输入。(为 true 时,仅触发回调,但字符不会被输入;为 false 时,触发回调并且能被正常输入)
<com.xh.xspan.XSpanEditText
android:id="@+id/et"
android:layout_width="match_parent"
android:layout_height="200dp"
android:gravity="start|top"
android:hint="请输入"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent"
app:specialCharSet="#@"
app:interceptSpecialChar="false"/>
然后在 Activity 给XSpanEditText
设置回调监听
et.setOnSpecialCharInputAction { specialChar ->
when (specialChar) {
'#' -> {
// 在这里执行输入#的相关操作
Toast.makeText(this@MainActivity, "输入了 #", Toast.LENGTH_SHORT).show()
}
'@' -> {
// 在这里执行输入@的相关操作
Toast.makeText(this@MainActivity, "输入了 @", Toast.LENGTH_SHORT).show()
}
}
}
真·富文本编辑器的演进之路-Span的整体性控制
真·富文本编辑器的演进之路-富文本Span的边界探究
真·富文本编辑器的演进之路-Span开胃菜
SpEditTool