本文介绍如何在 android 的 recyclerview 中，依据游戏关卡完成状态（如仅当上一关通过后才解锁下一关）动态启用或禁用列表项的点击功能，并同步更新视觉样式。
本文介绍如何在 android 的 recyclerview 中，依据游戏关卡完成状态（如仅当上一关通过后才解锁下一关）动态启用或禁用列表项的点击功能，并同步更新视觉样式。
在实现游戏关卡列表时，常见的需求是：关卡必须按顺序解锁——只有 Level 1 完成后，Level 2 才可点击；Level 2 完成后，Level 3 才激活，依此类推。这并非简单设置 setEnabled(false)，而是需在 RecyclerView.Adapter 中结合业务逻辑与 UI 状态进行精细化控制。
核心实现位于 onBindViewHolder() 方法中。该方法为每个可见 ViewHolder 绑定数据，是动态配置交互行为与样式的最佳时机。你需要：
-
在数据模型中记录关卡状态（例如
LevelItem类包含isCompleted: Boolean和isUnlocked: Boolean字段）； -
在 Adapter 中根据当前 position 推导是否可点击（例如：
position == 0总是可点击；position > 0时，仅当items[position - 1].isCompleted为true才解锁当前项）； - 在 ViewHolder 内统一处理点击逻辑与视觉反馈。
以下是一个精简但完整的实现示例：
class LevelAdapter(
private val onLevelClick: (Int) -> Unit
) : RecyclerView.Adapter<LevelAdapter.LevelViewHolder>() {
private val items = mutableListOf<LevelItem>()
inner class LevelViewHolder(private val binding: ItemLevelBinding) :
RecyclerView.ViewHolder(binding.root) : View.OnClickListener {
init {
binding.root.setOnClickListener(this)
}
override fun onClick(v: View?) {
val position = adapterPosition
if (position != RecyclerView.NO_POSITION && binding.root.isEnabled) {
onLevelClick(position)
}
}
fun bind(level: LevelItem, isUnlocked: Boolean) {
binding.tvLevelName.text = level.name
binding.root.isEnabled = isUnlocked
binding.root.alpha = if (isUnlocked) 1.0f else 0.5f
binding.ivLock.visibility = if (isUnlocked) View.GONE else View.VISIBLE
}
companion object {
fun from(parent: ViewGroup): LevelViewHolder {
val binding = ItemLevelBinding.inflate(
LayoutInflater.from(parent.context), parent, false
)
return LevelViewHolder(binding)
}
}
}
override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): LevelViewHolder {
return LevelViewHolder.from(parent)
}
override fun onBindViewHolder(holder: LevelViewHolder, position: Int) {
val currentItem = items[position]
// 核心逻辑：第0项始终可点击；其余项仅当上一项已完成时才解锁
val isUnlocked = position == 0 || items.getOrNull(position - 1)?.isCompleted == true
holder.bind(currentItem, isUnlocked)
}
override fun getItemCount() = items.size
fun submitList(newItems: List<LevelItem>) {
items.clear()
items.addAll(newItems)
notifyDataSetChanged()
}
}? 关键注意事项：
- ❗切勿在
onCreateViewHolder()中设置点击事件或状态——它只负责创建 ViewHolder，不感知具体数据；所有状态绑定必须在onBindViewHolder()中完成； - ✅ 使用
view.isEnabled控制点击可用性，同时配合alpha、图标（如锁形图标）、文字颜色等提供清晰的视觉反馈； - ⚠️ 若关卡状态可能异步更新（如网络回调完成某关），请确保调用
notifyItemChanged(position)而非全局notifyDataSetChanged()，以提升性能并避免闪烁； - ? 进阶建议：将解锁逻辑抽离为独立函数（如
canUnlockAt(position: Int): Boolean），便于单元测试与复用。
通过这种方式，你不仅能精准控制每项的可点击性，还能让 UI 始终与游戏进度保持一致，为玩家提供直观、流畅的关卡导航体验。
