软件编程
位置:首页>> 软件编程>> Android编程>> Android自定义view实现滚动选择控件详解

Android自定义view实现滚动选择控件详解

作者:捡一晌贪欢  发布时间:2022-12-05 09:54:06 

标签:Android,滚动选择,自定义,view

前言

上篇文章通过一个有header和footer的滚动控件(Viewgroup)学了下MeasureSpec、onMeasure以及onLayout,接下来就用一个滚动选择的控件(View)来学一下onDraw的使用,并且了解下在XML自定义控件参数。

需求

这里就是一个滚动选择文字的控件,还是挺常见的,之前用别人的,现在选择手撕一个,核心思想如下:

1、有三层不同大小及透明度的选项,选中项放在中间

2、接受一个列表的数据,静态时显示三个值,滚动时显示四个值

3、滑动会造成三个选项滚动,大小透明度发生变化,会有一个新的选项出现

4、滚动一定距离后,判定是否选中一个项目,并触发动画滚动到选定项 效果图

Android自定义view实现滚动选择控件详解

编写代码

老实说下面写的代码并不好,特别是TextItem的绘制,本来是可以通过一个数学函数,根据滑动距离来映射缩放比例及位置的,如有需要可以参考这个控件,忘了是几年前从哪里抄的了,里面对文字的控制写的很好。

下面是我手撕的代码:

import android.animation.ValueAnimator
import android.annotation.SuppressLint
import android.content.Context
import android.graphics.Canvas
import android.graphics.Color
import android.graphics.Paint
import android.util.AttributeSet
import android.util.TypedValue
import android.view.MotionEvent
import android.view.View
import android.view.View.MeasureSpec.*
import androidx.core.animation.addListener
import com.silencefly96.module_common.R
import kotlin.math.abs
import kotlin.math.min
/**
* 滚动选择文字控件
* 核心思想
* 1、有三层不同大小及透明度的选项,选中项放在中间
* 2、接受一个列表的数据,静态时显示三个值,滚动时显示四个值
* 3、滑动会造成三个选项滚动,大小透明度发生变化,会有一个新的选项出现
* 4、滚动一定距离后,判定是否选中一个项目,并触发动画滚动到选定项
*/
class ScrollSelectView @JvmOverloads constructor(
   context: Context,
   attributeSet: AttributeSet? = null,
   defStyleAttr: Int = 0,
) : View(context, attributeSet, defStyleAttr){
   //默认字体透明度,大小不应该指定,应该根据view的高度按百分比适应
   companion object{
       const val DEFAULT_MAIN_TRANSPARENCY = 255
       const val DEFAULT_SECOND_TRANSPARENCY = (255 * 0.5f).toInt()
       //三种item类型
       const val ITEM_TYPE_MAIN = 1
       const val ITEM_TYPE_SECOND = 2
       const val ITEM_TYPE_NEW = 3
   }
   //两层字体大小及透明度
   private var mainSize: Float = 0f
   private var secondSize: Float = 0f
   private val mainAlpha: Int
   private val secondAlpha: Int
   //主次item高度,由主item所占比例决定
   private val mainItemPercent: Float
   private var mainHeight: Float = 0f
   private var secondHeight: Float = 0f
   //字体相对于框的缩放比例
   private val textScanSize: Int
   //切换项目的y轴滑动距离门限值
   private var itemChangeYCapacity: Float
   //释放滑动动画效果间隔
   private var afterUpAnimatorPeriod: Int
   //数据
   @Suppress("MemberVisibilityCanBePrivate")
   var mData: List<String>? = null
   //选择数据index
   @Suppress("MemberVisibilityCanBePrivate")
   var mCurrentIndex: Int = 0
   //绘制的item列表
   private var mItemList: MutableList<TextItem> = ArrayList()
   //单次事件序列累计滑动值
   private var mScrollY: Float = 0f
   //上次事件纵坐标
   private var mLastY: Float = 0f
   //画笔
   private val mPaint: Paint
   init {
       //读取XML参数,设置相关属性
       val attrArr = context.obtainStyledAttributes(attributeSet, R.styleable.ScrollSelectView)
       //三层字体透明度设置,未设置使用默认值
       mainAlpha = attrArr.getInteger(R.styleable.ScrollSelectView_mainAlpha,
           DEFAULT_MAIN_TRANSPARENCY)
       secondAlpha = attrArr.getInteger(R.styleable.ScrollSelectView_secondAlpha,
           DEFAULT_SECOND_TRANSPARENCY)
       textScanSize = attrArr.getInteger(R.styleable.ScrollSelectView_textScanSize, 2)
       //取到的值限定为dp值,需要转换
       itemChangeYCapacity =
           attrArr.getDimension(R.styleable.ScrollSelectView_changeItemYCapacity, 0f)
       itemChangeYCapacity = dp2px(context, itemChangeYCapacity).toFloat()
       afterUpAnimatorPeriod =
           attrArr.getInteger(R.styleable.ScrollSelectView_afterUpAnimatorPeriod, 300)
       //获取主item所占比例,在onMeasure中计算得到主次item高度
       mainItemPercent = attrArr.getFraction(
           R.styleable.ScrollSelectView_mainItemPercent, 1,1,0.5f)
       //回收
       attrArr.recycle()
       //设置画笔,在构造中初始化,不要写在onDraw里面,onDraw会不断触发
       mPaint = Paint().apply {
           flags = Paint.ANTI_ALIAS_FLAG
           style = Paint.Style.FILL
           //该方法即为设置基线上那个点究竟是left,center,还是right
           textAlign = Paint.Align.CENTER
           color = Color.BLACK
       }
       //创建四个TextItem
       mItemList.apply {
           add(TextItem(ITEM_TYPE_SECOND, true))
           add(TextItem(ITEM_TYPE_MAIN))
           add(TextItem(ITEM_TYPE_SECOND))
           add(TextItem(ITEM_TYPE_NEW))
       }
   }
   //设置控件的默认大小,实际viewgroup不需要
   override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) {
       super.onMeasure(widthMeasureSpec, heightMeasureSpec)
       //根据父容器给定大小,设置自身宽高,wrap_content需要用到默认值
       val width = getSizeFromMeasureSpec(300, widthMeasureSpec)
       val height = getSizeFromMeasureSpec(200, heightMeasureSpec)
       //Log.e("TAG", "onMeasure: height=$height")
       //设置测量宽高,一定要设置,不然错给你看
       setMeasuredDimension(width, height)
       //如果滑动距离门限值没有确定,应该根据view大小设定,默认高度的二分之一
       itemChangeYCapacity = if(itemChangeYCapacity == 0f) height / 2f
           else itemChangeYCapacity
       //有比例计算主次item高度
       mainHeight = height * mainItemPercent
       secondHeight = height * (1 - mainItemPercent) / 2
       //得到自身高度后,就可以按比例设置字体大小了
       mainSize = mainHeight / textScanSize
       secondSize = secondHeight / textScanSize
   }
   //根据MeasureSpec确定默认宽高,MeasureSpec限定了该view可用的大小
   private fun getSizeFromMeasureSpec(defaultSize: Int, measureSpec: Int): Int {
       //获取MeasureSpec内模式和尺寸
       val mod = getMode(measureSpec)
       val size = getSize(measureSpec)
       return when (mod) {
           EXACTLY -> size
           AT_MOST -> min(defaultSize, size)
           else -> defaultSize //MeasureSpec.UNSPECIFIED
       }
   }
   override fun onDraw(canvas: Canvas?) {
       super.onDraw(canvas)
       //绘制显示的text,最多同时显示4个
       //Log.e("TAG", "onDraw: mScrollY=$mScrollY")
       for (item in mItemList) {
           item.draw(mScrollY / itemChangeYCapacity ,mPaint, canvas)
       }
   }
   @SuppressLint("ClickableViewAccessibility")
   override fun onTouchEvent(event: MotionEvent?): Boolean {
       event?.let {
           when(event.action) {
               MotionEvent.ACTION_DOWN -> {
                   //按下开始计算滑动距离
                   mScrollY = 0f
                   mLastY = it.y
               }
               MotionEvent.ACTION_MOVE -> move(event)
               MotionEvent.ACTION_UP -> stopMove()
           }
       }
       //view是最末端了,应该拦截touch事件,不然事件序列将舍弃
       return true
   }
   private fun move(e: MotionEvent) {
       val dy = mLastY - e.y
       //更新mLastY值
       mLastY = e.y
       //设置滑动范围,到达顶部不能下拉,到达底部不能上拉
       if (dy == 0f) return    //为什么会有两次0???
       if (dy < 0 && mCurrentIndex - 1 == 0) return
       if (dy > 0 && mCurrentIndex + 1 == mData!!.size - 1) return
       //累加滑动距离
       mScrollY += dy
       //如果滑动距离切换了选中值,重绘前修改选中值
       if (mScrollY >= itemChangeYCapacity) changeItem(mCurrentIndex + 1)
       else if (mScrollY <= -itemChangeYCapacity) changeItem(mCurrentIndex - 1)
       //滑动后触发重绘,绘制时处理滑动效果
       //Log.e("TAG", "move: mScrollY=$mScrollY")
       invalidate()
   }
   //统一修改mCurrentIndex,各个TextItem需要复位
   private fun changeItem(index: Int) {
       mCurrentIndex = index
       //消耗滑动距离
       mScrollY = 0f
       //对各个TextItem复位,重新调用setup即可
       for (item in mItemList) {
           item.setup()
       }
   }
   private fun stopMove() {
       //结束滑动后判定,滑动距离超过itemChangeYCapacity一半就切换了选中项
       val terminalScrollY: Float = when {
           mScrollY > itemChangeYCapacity / 2f -> itemChangeYCapacity
           mScrollY < -itemChangeYCapacity / 2f -> -itemChangeYCapacity
           //滑动没有达到切换选中项效果,应该恢复到原先状态
           else -> 0f
       }
       //这里使用ValueAnimator处理剩余的距离,模拟滑动到需要的位置
       val animator = ValueAnimator.ofFloat(mScrollY, terminalScrollY)
       //Log.e("TAG", "stopMove: mScrollY=$mScrollY, terminalScrollY=$terminalScrollY")
       animator.addUpdateListener { animation ->
           //Log.e("TAG", "stopMove: " + animation.animatedValue as Float)
           mScrollY = animation.animatedValue as Float
           invalidate()
       }
       //动画结束时要更新选中的项目
       animator.addListener (onEnd = {
           if (mScrollY == itemChangeYCapacity) changeItem(mCurrentIndex + 1)
           else if (mScrollY == -itemChangeYCapacity) changeItem(mCurrentIndex - 1)
       })
       //滑动动画总时间应该和距离有关
       val percent = terminalScrollY / (itemChangeYCapacity / 2f)
       animator.duration = (afterUpAnimatorPeriod * abs(percent)).toLong()
       //animator.duration = afterUpAnimatorPeriod.toLong()
       animator.start()
   }
   //单位转换
   @Suppress("SameParameterValue")
   private fun dp2px(context: Context, dpVal: Float): Int {
       return TypedValue.applyDimension(
           TypedValue.COMPLEX_UNIT_DIP, dpVal, context.resources
               .displayMetrics
       ).toInt()
   }
   //依赖于控件宽高及数据,需要在onMeasure之后初始化一下
   inner class TextItem(
       private val type: Int,
       //上下两个次item移动时是对称的,要创建时确定
       private val isTopSecond: Boolean = false
   ){
       private var index: Int = 0
       private var x: Float = 0f
       private var y: Float = 0f
       private var textSize: Float = 0f
       private var alpha: Int = 0
       private var height: Float = 0f
       private var dSize = 0f
       private var dAlpha = 0
       private var dY = 0f
       private var isInit = false
       fun setup() {
           //x为中心即可
           x = measuredWidth / 2f
           //根据类型设置属性
           when(type) {
               ITEM_TYPE_MAIN -> {
                   index = mCurrentIndex
                   y = measuredHeight / 2f
                   textSize = mainSize
                   alpha = mainAlpha
                   height = mainHeight
               }
               ITEM_TYPE_SECOND -> {
                   index = if (isTopSecond) mCurrentIndex - 1
                       else mCurrentIndex + 1
                   y = if (isTopSecond) secondHeight / 2f
                       else measuredHeight - secondHeight / 2f
                   textSize = secondSize
                   alpha = secondAlpha
                   height = secondHeight
               }
               else -> {
                   index = mCurrentIndex + 2
                   //初始化时未确定位置
                   y = 0F
                   textSize = 0f
                   alpha = 0
                   height = 0f
               }
           }
       }
       private fun calculate(delta: Float) {
           //根据类型得到变化值
           when(type) {
               ITEM_TYPE_MAIN -> {
                   //无论向那边移动都应该是变小
                   dSize = (mainSize - secondSize) * -abs(delta)
                   dAlpha = ((mainAlpha - secondAlpha) * -abs(delta)).toInt()
                   //主次item中线之间的距离,delta>0页面上移,y减小
                   dY = (mainHeight + secondHeight) / 2f * -delta
               }
               ITEM_TYPE_SECOND -> {
                   //以上面为准,下面对称即可
                   if (isTopSecond && delta > 0 || !isTopSecond && delta < 0) {
                       //项目变为消失,值变小
                       dSize = secondSize * -abs(delta)
                       dAlpha = (secondAlpha * -abs(delta)).toInt()
                       //消失的高度为次item的高度一半
                       //上面item消失时y减小,下面item消失时y增加
                       dY = secondHeight / 2f *
                               if (isTopSecond) -abs(delta) else abs(delta)
                   }else {
                       //项目变为选中,值变大
                       dSize = (mainSize - secondSize) * abs(delta)
                       dAlpha = ((mainAlpha - secondAlpha) * abs(delta)).toInt()
                       //上面item变为选中时y增加,下面item变为选中时y减小
                       dY = (mainHeight + secondHeight) / 2f *
                               if (isTopSecond) abs(delta) else -abs(delta)
                   }
               }
               else -> {
                   //新项目终态就是次item,无论怎么移动值都是变大的
                   dSize = secondSize * abs(delta)
                   dAlpha = (secondAlpha * abs(delta)).toInt()
                   //从边沿移动到次item位置,即次item高度一半
                   //delta>0从下面出现,y应该变小,delta<0从上面出现,y变大
                   dY = secondHeight / 2f * -delta
                   //移动时才确定新item的y和index
                   y = if (delta > 0) measuredHeight.toFloat() else 0f
                   index = if (delta > 0) mCurrentIndex + 2 else mCurrentIndex - 2
               }
           }
       }
       fun draw(delta: Float, paint: Paint, canvas: Canvas?) {
           //确保在onMeasure后初始化
           if (!isInit) {
               setup()
               isInit = true
           }
           //计算属性变化
           calculate(delta)
           //修改画笔并绘制,注意变化的值都是相对于原来的值,不要去修改原来的值
           paint.textSize = textSize + dSize
           paint.alpha = alpha + dAlpha
           canvas?.drawText(getText(), x, getBaseline(paint, y + dY), paint)
       }
       private fun getText(): String {
           //判定范围
           if (index < 0 || index >= mData!!.size) return ""
           return mData!![index]
       }
       private fun getBaseline(paint: Paint, tempY: Float): Float {
           //绘制字体的参数,受字体大小样式影响
           val fmi = paint.fontMetricsInt
           //top为基线到字体上边框的距离(负数),bottom为基线到字体下边框的距离(正数)
           //基线中间点的y轴计算公式,即中心点加上字体高度的一半,基线中间点x就是中心点x
           return tempY - (fmi.top + fmi.bottom) / 2f
       }
   }
}

主要问题

自定义XML参数

这个网上应该有很多教程了,主要就是要创建一个value里面的xml来定义属性,在XML使用的使用引入命名空间,并使用这些属性,最后在控件代码中读取参数值。下面是这个控件的自定义属性:

res->value->scrolll_select_view_style.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <declare-styleable name="ScrollSelectView">
       <attr name="mainAlpha" format="integer"/>
       <attr name="secondAlpha" format="integer"/>
       <attr name="textScanSize" format="integer"/>
       <attr name="changeItemYCapacity" format="dimension"/>
       <attr name="afterUpAnimatorPeriod" format="integer"/>
       <attr name="mainItemPercent" format="fraction"/>
   </declare-styleable>
</resources>

这里有六个控制属性,mainAlpha和secondAlpha是设定中间和第二层文字的透明度,值为[0,255];textScanSize是文字相对于文字框的缩放比例,比如设置为2的话文字大小就是文字框的一半;changeItemYCapacity是滑动导致item切换的距离,单位为dp,即手指滑过这么长的距离就切换了选中项;afterUpAnimatorPeriod是手指抬起时,恢复到默认状态或者跳转到指定状态的最大时间间隔,动画时间会根据滑动距离占changeItemYCapacity的比例计算得到;mainItemPercent是中间item占整个控件的高度比例,大小为[0,100],第二层的item的高度为剩下高度的一半。

Paint的初始化

Paint的初始化也是一个老生常谈的问题了,不能在onDraw里面创建,因为onDraw会频繁被调用,同类对象也不应该在onDraw里面创建。

控件的默认大小

自定义view需要在onMeasure设定默认大小,不然使用wrap_content的时候会出问题,前几篇文章和注释都写的很清楚了。

和宽高有关的默认属性设置

所有和控件宽高有关的默认属性都需要在onMeasure中设置,另外TextItem的setup中用到了measuredWidth和measuredHeight,也需要在onMeasure后初始化,这里就在第一次绘制的时候初始化了。

文字绘制到中心位置

通过paint要将文字绘制到中心位置,需要结合textAlign(Paint.Align.CENTER)和fontMetricsInt计算得到绘制的纵坐标位置。

滑动逻辑处理

因为这个继承的是View,所以在onTouchEvent中消耗事件即可,一定要对ACTION_DOWN事件返回true。

移动时做了三步操作,一是判定是否能够移动,二是累加移动dy并触发重绘,三是判断滑动距离是否切换了选中值,达到切换条件时,应该修改选中的index、累加的滑动距离,并将各个item重置到原来的位置及状态(ps.好像就是改了个index。。。)。这里有点不太好理解,就是每当滑动达到切换条件后,就修改选中,重置各个item,逻辑上是一个跳跃性修改,但是对于draw来说,只是绘制的新的图像罢了。

滑动结束后触发动画滚动到选定项

当滑动结束后应该将控件滑动到一个选中项,即让选中项放置到中间,有三种情况,一个是没有切换,一个是上一个index,一个是后一个index。这里利用了ValueAnimator去模拟滑动,首先计算到最终状态的滑动距离,然后从当前滑动距离不断更新,最后到达最终状态的滑动距离。只要更新累加的滑动值,触发重绘,在onDraw中会和move一样进行处理。最后在动画结束后,要和move一样切换选中值及一些其他操作。

滑动导致的文字的绘制

文字的绘制我封装到了TextItem这个内部类里,还是比较复杂,可能有三层item吧,不应该搞太多的。

绘制逻辑主要分成两部分,一部分是静态的位置及状态,一部分是滑动导致的变化值计算。静态的位置及状态写在setup里面,还是比较简单的,就是根据type去确定。

滑动导致的变化值计算就复杂多了,主要就是根据滑动距离和滑动切换项目的门限值确定一个百分比delta,再根据delta去计算变换的属性值。实际上想简单点,不就是属性变大或者属性变小的问题么,首先根据delta的正负值确定滑动的方向,再通过滑动方向去确定该类型的item应该属性变大或者属性变小,一个一个去设置就行了,就是代码比较多而已。

写到这里我发现前面我说应该用一个数学函数去映射的,我这abs(delta)不就是一个映射函数么。。果然写代码和写文章更能让直接深刻理解内容。这里abs(delta)换成抛物线确实可能会好看些,有机会改改。

使用

使用起来很简单,直接设定数据和初始index就可以,暂时没有动态切换,可以重写下setter函数,invalidate()就可以了。

xml

<com.silencefly96.module_common.view.ScrollSelectView
       android:id="@+id/hhView"
       android:layout_width="match_parent"
       android:layout_height="300dp"
       android:background="@color/teal_700"
       app:layout_constraintLeft_toLeftOf="parent"
       app:layout_constraintRight_toRightOf="parent"
       app:layout_constraintTop_toTopOf="parent"/>

code

binding.hhView.mData = ArrayList<String>().apply{
           add("第一个")
           add("第二个")
           add("第三个")
           add("第四个")
           add("第五个")
       }
       binding.hhView.mCurrentIndex = 2

范围限定偶尔不生效

实际运行起来我发现对范围限定偶尔会不生效,暂时还没有解决,应该是动画没有完成就滑动造成的,不太好办,当然这个控件主要目的是学习onDraw,写的这么复杂了,目的已经达到了,要学习绘制的话后面再写几个控件吧。

来源:https://blog.csdn.net/lfq88/article/details/127262915

0
投稿

猜你喜欢

手机版 软件编程 asp之家 www.aspxhome.com