/*
* Copyright 2022 The Android Open Source Project
*
* 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
*
* http://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.
*/
package androidx.emoji2.emojipicker
import android.content.Context
import android.content.res.TypedArray
import android.util.AttributeSet
import android.view.View
import android.view.ViewGroup
import android.widget.FrameLayout
import androidx.core.util.Consumer
import androidx.core.view.ViewCompat
import androidx.emoji2.emojipicker.EmojiPickerConstants.DEFAULT_MAX_RECENT_ITEM_ROWS
import androidx.recyclerview.widget.GridLayoutManager
import androidx.recyclerview.widget.LinearLayoutManager
import androidx.recyclerview.widget.RecyclerView
import kotlin.coroutines.EmptyCoroutineContext
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
import kotlinx.coroutines.withContext
/**
* The emoji picker view that provides up-to-date emojis in a vertical scrollable view with a
* clickable horizontal header.
*/
class EmojiPickerView @JvmOverloads constructor(
context: Context,
attrs: AttributeSet? = null,
defStyleAttr: Int = 0
) :
FrameLayout(context, attrs, defStyleAttr) {
/**
* The number of rows of the emoji picker.
*
* Default value([EmojiPickerConstants.DEFAULT_BODY_ROWS]: 7.5) will be used if emojiGridRows
* is set to non-positive value. Float value indicates that we will display partial of the last
* row and have content down, so the users get the idea that they can scroll down for more
* contents.
* @attr ref androidx.emoji2.emojipicker.R.styleable.EmojiPickerView_emojiGridRows
*/
var emojiGridRows: Float = EmojiPickerConstants.DEFAULT_BODY_ROWS
set(value) {
field = if (value > 0) value else EmojiPickerConstants.DEFAULT_BODY_ROWS
// this step is to ensure the layout refresh when emojiGridRows is reset
if (isLaidOut) {
showEmojiPickerView()
}
}
/**
* The number of columns of the emoji picker.
*
* Default value([EmojiPickerConstants.DEFAULT_BODY_COLUMNS]: 9) will be used if
* emojiGridColumns is set to non-positive value.
* @attr ref androidx.emoji2.emojipicker.R.styleable.EmojiPickerView_emojiGridColumns
*/
var emojiGridColumns: Int = EmojiPickerConstants.DEFAULT_BODY_COLUMNS
set(value) {
field = if (value > 0) value else EmojiPickerConstants.DEFAULT_BODY_COLUMNS
// this step is to ensure the layout refresh when emojiGridColumns is reset
if (isLaidOut) {
showEmojiPickerView()
}
}
private val stickyVariantProvider = StickyVariantProvider(context)
private val scope = CoroutineScope(EmptyCoroutineContext)
private var recentEmojiProvider: RecentEmojiProvider = DefaultRecentEmojiProvider(context)
private val recentItems: MutableList<EmojiViewData> = mutableListOf()
private lateinit var recentItemGroup: ItemGroup
private lateinit var emojiPickerItems: EmojiPickerItems
private lateinit var bodyAdapter: EmojiPickerBodyAdapter
private var onEmojiPickedListener: Consumer<EmojiViewItem>? = null
init {
val typedArray: TypedArray =
context.obtainStyledAttributes(attrs, R.styleable.EmojiPickerView, 0, 0)
emojiGridRows = typedArray.getFloat(
R.styleable.EmojiPickerView_emojiGridRows,
EmojiPickerConstants.DEFAULT_BODY_ROWS
)
emojiGridColumns = typedArray.getInt(
R.styleable.EmojiPickerView_emojiGridColumns,
EmojiPickerConstants.DEFAULT_BODY_COLUMNS
)
typedArray.recycle()
scope.launch(Dispatchers.IO) {
val load = launch { BundledEmojiListLoader.load(context) }
refreshRecentItems()
load.join()
withContext(Dispatchers.Main) {
showEmojiPickerView()
}
}
}
private fun createEmojiPickerBodyAdapter(
emojiPickerItems: EmojiPickerItems,
): EmojiPickerBodyAdapter {
return EmojiPickerBodyAdapter(
context,
emojiGridColumns,
emojiGridRows,
stickyVariantProvider,
emojiPickerItems,
onEmojiPickedListener = { emojiViewItem ->
onEmojiPickedListener?.accept(emojiViewItem)
scope.launch {
recentEmojiProvider.recordSelection(emojiViewItem.emoji)
refreshRecentItems()
}
}
)
}
private fun showEmojiPickerView() {
emojiPickerItems = EmojiPickerItems(buildList {
add(ItemGroup(
R.drawable.quantum_gm_ic_access_time_filled_vd_theme_24,
CategoryTitle(context.getString(R.string.emoji_category_recent)),
recentItems,
forceContentSize = DEFAULT_MAX_RECENT_ITEM_ROWS * emojiGridColumns,
emptyPlaceholderItem = PlaceholderText(
context.getString(R.string.emoji_empty_recent_category)
)
).also { recentItemGroup = it })
for ((headerIconId, name, emojis) in BundledEmojiListLoader.getCategorizedEmojiData()) {
add(
ItemGroup(
headerIconId,
CategoryTitle(name),
emojis.map {
EmojiViewData(stickyVariantProvider[it.emoji])
},
)
)
}
})
val bodyLayoutManager = GridLayoutManager(
context,
emojiGridColumns,
LinearLayoutManager.VERTICAL,
/* reverseLayout = */ false
).apply {
spanSizeLookup = object : GridLayoutManager.SpanSizeLookup() {
override fun getSpanSize(position: Int): Int {
return if (emojiPickerItems.getBodyItem(position).occupyEntireRow)
emojiGridColumns
else 1
}
}
}
val headerAdapter =
EmojiPickerHeaderAdapter(context, emojiPickerItems, onHeaderIconClicked = {
bodyLayoutManager.scrollToPositionWithOffset(
emojiPickerItems.firstItemPositionByGroupIndex(it),
0
)
})
// clear view's children in case of resetting layout
super.removeAllViews()
with(inflate(context, R.layout.emoji_picker, this)) {
// set headerView
ViewCompat.requireViewById<RecyclerView>(this, R.id.emoji_picker_header).apply {
layoutManager =
object : LinearLayoutManager(
context,
HORIZONTAL,
/* reverseLayout = */ false
) {
override fun checkLayoutParams(lp: RecyclerView.LayoutParams): Boolean {
lp.width =
(width - paddingStart - paddingEnd) / emojiPickerItems.numGroups
return true
}
}
adapter = headerAdapter
}
// set bodyView
ViewCompat.requireViewById<RecyclerView>(this, R.id.emoji_picker_body).apply {
layoutManager = bodyLayoutManager
adapter = createEmojiPickerBodyAdapter(emojiPickerItems).also { bodyAdapter = it }
addOnScrollListener(object : RecyclerView.OnScrollListener() {
override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
super.onScrolled(recyclerView, dx, dy)
val position =
bodyLayoutManager.findFirstCompletelyVisibleItemPosition()
headerAdapter.selectedGroupIndex =
emojiPickerItems.groupIndexByItemPosition(position)
}
})
// Disable item insertion/deletion animation. This keeps view holder unchanged when
// item updates.
itemAnimator = null
setRecycledViewPool(RecyclerView.RecycledViewPool().apply {
setMaxRecycledViews(
ItemType.EMOJI.ordinal,
EmojiPickerConstants.EMOJI_VIEW_POOL_SIZE
)
})
}
}
}
private suspend fun refreshRecentItems() {
val recent = recentEmojiProvider.getRecentEmojiList()
recentItems.clear()
recentItems.addAll(recent.map {
EmojiViewData(
it,
updateToSticky = false,
)
})
}
/**
* This function is used to set the custom behavior after clicking on an emoji icon. Clients
* could specify their own behavior inside this function.
*/
fun setOnEmojiPickedListener(onEmojiPickedListener: Consumer<EmojiViewItem>?) {
this.onEmojiPickedListener = onEmojiPickedListener
}
fun setRecentEmojiProvider(recentEmojiProvider: RecentEmojiProvider) {
this.recentEmojiProvider = recentEmojiProvider
scope.launch {
refreshRecentItems()
if (::emojiPickerItems.isInitialized) {
val range = emojiPickerItems.groupRange(recentItemGroup)
withContext(Dispatchers.Main) {
bodyAdapter.notifyItemRangeChanged(range.first, range.last + 1)
}
}
}
}
/**
* The following functions disallow clients to add view to the EmojiPickerView
*
* @param child the child view to be added
* @throws UnsupportedOperationException
*/
override fun addView(child: View?) {
if (childCount > 0)
throw UnsupportedOperationException(EmojiPickerConstants.ADD_VIEW_EXCEPTION_MESSAGE)
else super.addView(child)
}
/**
* @param child
* @param params
* @throws UnsupportedOperationException
*/
override fun addView(child: View?, params: ViewGroup.LayoutParams?) {
if (childCount > 0)
throw UnsupportedOperationException(EmojiPickerConstants.ADD_VIEW_EXCEPTION_MESSAGE)
else super.addView(child, params)
}
/**
* @param child
* @param index
* @throws UnsupportedOperationException
*/
override fun addView(child: View?, index: Int) {
if (childCount > 0)
throw UnsupportedOperationException(EmojiPickerConstants.ADD_VIEW_EXCEPTION_MESSAGE)
else super.addView(child, index)
}
/**
* @param child
* @param index
* @param params
* @throws UnsupportedOperationException
*/
override fun addView(child: View?, index: Int, params: ViewGroup.LayoutParams?) {
if (childCount > 0)
throw UnsupportedOperationException(EmojiPickerConstants.ADD_VIEW_EXCEPTION_MESSAGE)
else super.addView(child, index, params)
}
/**
* @param child
* @param width
* @param height
* @throws UnsupportedOperationException
*/
override fun addView(child: View?, width: Int, height: Int) {
if (childCount > 0)
throw UnsupportedOperationException(EmojiPickerConstants.ADD_VIEW_EXCEPTION_MESSAGE)
else super.addView(child, width, height)
}
/**
* The following functions disallow clients to remove view from the EmojiPickerView
* @throws UnsupportedOperationException
*/
override fun removeAllViews() {
throw UnsupportedOperationException(EmojiPickerConstants.REMOVE_VIEW_EXCEPTION_MESSAGE)
}
/**
* @param child
* @throws UnsupportedOperationException
*/
override fun removeView(child: View?) {
throw UnsupportedOperationException(EmojiPickerConstants.REMOVE_VIEW_EXCEPTION_MESSAGE)
}
/**
* @param index
* @throws UnsupportedOperationException
*/
override fun removeViewAt(index: Int) {
throw UnsupportedOperationException(EmojiPickerConstants.REMOVE_VIEW_EXCEPTION_MESSAGE)
}
/**
* @param child
* @throws UnsupportedOperationException
*/
override fun removeViewInLayout(child: View?) {
throw UnsupportedOperationException(EmojiPickerConstants.REMOVE_VIEW_EXCEPTION_MESSAGE)
}
/**
* @param start
* @param count
* @throws UnsupportedOperationException
*/
override fun removeViews(start: Int, count: Int) {
throw UnsupportedOperationException(EmojiPickerConstants.REMOVE_VIEW_EXCEPTION_MESSAGE)
}
/**
* @param start
* @param count
* @throws UnsupportedOperationException
*/
override fun removeViewsInLayout(start: Int, count: Int) {
throw UnsupportedOperationException(EmojiPickerConstants.REMOVE_VIEW_EXCEPTION_MESSAGE)
}
}