# EmoticonsBoard

**Repository Path**: liuqiusong/EmoticonsBoard

## Basic Information

- **Project Name**: EmoticonsBoard
- **Description**: Function keyboard and emotions.  Android表情键盘，可动态更新表情。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-10-28
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EmoticonsBoard
受XhsEmoticonsKeyboard的启发，重新设计了框架，添加了动态更新表情包的功能。使用EmoticonPacksAdapter，可以轻松的增减表情。

新增代码使用Kotlin开发。

![Art](https://github.com/llwl1982/EmoticonsBoard/blob/master/doc/overlook.gif)

# Gradle Dependency

```xml  
allprojects {
    repositories {
        jcenter()
    }
}
```
and:

```xml
dependencies { 
    compile 'im.ll:emoticonsboard:1.0.0'
}
```
# Struct
<img src="doc/screenshot.jpg" width="40%"/> 
<img src="doc/core.jpg" width="60%"/> 


EmoticonsBoard通过设置EmoticonPacksAdapter来展示表情。EmoticonPacksAdapter包含了一个EmoticonPack的列表，用来承载表情数据。每个EmoticonPack代表了一个表情集合。PageFactory用来创建展示表情的View，表情是以Page的形式展示的。
通过自定义不同的PageFactory就可以以不同方式展示表情。

# Samples Usage
## XML

```xml
<github.ll.emotionboard.EmoticonsBoard xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <ListView
            android:layout_width="match_parent"
            android:layout_height="match_parent"/>
    </LinearLayout>

</github.ll.emotionboard.EmoticonsBoard>

```
<mark>EmoticonsBoard can only has one child view</mark>

## Set Adapter

Java code:

```
EmoticonsBoard ekBar;

List<EmoticonPack> packs = new ArrayList<EmoticonPack>;
init packs...

EmoticonPacksAdapter adapter = new EmoticonPacksAdapter(packs);
ekBar.setAdapter(adapter);
```
For details refer to the demo source



## Update data

![Art](https://github.com/llwl1982/EmoticonsBoard/blob/master/doc/change_data.gif)

Kotlin code:

```
private var adapter: EmoticonPacksAdapter? = null
private lateinit var mEmojiPack: EmoticonPack<Emoticon>
...
val emoticon = Emoticon()
emoticon.code = "new emoji"
emoticon.uri = "xxx"

mEmojiPack.emoticons.add(emoticon)
mEmojiPack.emoticons.add(emoticon)
mEmojiPack.isDataChanged = true
adapter?.notifyDataSetChanged()
```
<mark>Make modified emoticonPack's isDataChanged to true is very important </mark>