March 22, 2018

How to Add Emoji Picker in Text Fields

Emojis have become a basic part of any writing these days. And I have no doubt that, sooner or later, you’ll need to have them supported in one of your applications.

I was looking, the other day, for a package to add a slack-like emoji picker in one of my textarea fields. But, unfortunately, I didn’t find a nice one that integrates easily with VueJS. However, I did find a package that provides a component that displays only the emoji picker and give me the needed information about the emoji to add.

So I decided to create a simple component that uses that picker to add the clicked emojis in the textarea field. And in this tutorial I’m going to show you how I did it.

Preparing the component

In this step, we’re going to create our component and add the textarea into it along with the necessary bindings.

We’ll name the component TextareaEmojiPicker. So create TextareaEmojiPicker.vue in your components directory and put this into it:

<template>
  <div class="textarea-emoji-picker">
    <textarea
      ref="textarea"
      class="textarea"
      :value="value"
      @input="$emit('input', $event.target.value)"
    ></textarea>
  </div>
</template>

<script>
  export default {
    props: {
      value: {
        type: String,
        default: ''
      }
    }
  }
</script>

<style scoped>
  * {
    box-sizing: border-box;
  }

  .textarea-emoji-picker {
    position: relative;
    width: 400px;
    margin: 0 auto;
  }

  .textarea {
    width: 100%;
    min-height: 300px;
    outline: none;
    box-shadow: none;
    padding: 10px 28px 10px 10px;
    font-size: 15px;
    border: 1px solid #bababa;
    color: #333;
    border-radius: 2px;
    box-shadow: 0px 2px 4px 0 rgba(0, 0, 0, 0.1) inset;
    resize: vertical;
  }

  .emoji-mart {
    position: absolute;
    top: 33px;
    right: 10px;
  }

  .emoji-trigger {
    position: absolute;
    top: 10px;
    right: 10px;
    cursor: pointer;
    height: 20px;
  }

  .emoji-trigger path {
    transition: 0.1s all;
  }

  .emoji-trigger:hover path {
    fill: #000000;
  }

  .emoji-trigger.triggered path {
    fill: darken(#fec84a, 15%);
  }
</style>

For now, we only have the textarea element in this component. To allow for v-model on this component, we made it accept value prop and emit an input event.

Try to use that component in your page, like this:

<template>
  <div class="home-page">
    <textarea-emoji-picker v-model="text" />
  </div>
</template>

<script>
  import TextareaEmojiPicker from './TextareaEmojiPicker'
  export default {
    name: 'HomePage',
    components: { TextareaEmojiPicker },
    data() {
      return {
        text: ''
      }
    }
  }
</script>

<style scoped>
  .home-page {
    padding-top: 50px;
  }
</style>

Adding the emoji picker

There’s an excellent emoji picker component called Emoji Mart. The main job of this component is to display a nice picker (similar to slack) and return an emoji object when an emoji is clicked. This emoji object contains, among other things, the unicode value that represents it — we’ll use this value to display them in our textarea.

This component was originally created in React, but since we’re using Vue here, we’ll install the vue version of it:

npm install --save emoji-mart-vue

Now include that component in TextareaEmojiPicker component:

<script>
import { Picker } from 'emoji-mart-vue'

export default {
  components: { Picker },
  // ...
}

Then, use it at the top of our component:

<div class="textarea-emoji-picker">
  <picker title="Pick your emoji..." emoji="point_up" />
</div>

If you check the browser now, you’ll see the picker open — which does nothing at the moment.

Adding a trigger button

Obviously, we shouldn’t keep the picker open by default. We should instead have a button to toggle it.

Before we add that button, we need to have a flag to determine if the picker should open or not. Define it in data(), like this:

data () {
  return {
    showEmojiPicker: false
  }
}

Now let’s add the trigger button below <picker/>:

<span
  class="emoji-trigger"
  :class="{ 'triggered': showEmojiPicker }"
  @mousedown.prevent="toggleEmojiPicker"
>
  <svg style="width:20px;height:20px" viewBox="0 0 24 24">
    <path
      fill="#888888"
      d="M20,12A8,8 0 0,0 12,4A8,8 0 0,0 4,12A8,8 0 0,0 12,20A8,8 0 0,0 20,12M22,12A10,10 0 0,1 12,22A10,10 0 0,1 2,12A10,10 0 0,1 12,2A10,10 0 0,1 22,12M10,9.5C10,10.3 9.3,11 8.5,11C7.7,11 7,10.3 7,9.5C7,8.7 7.7,8 8.5,8C9.3,8 10,8.7 10,9.5M17,9.5C17,10.3 16.3,11 15.5,11C14.7,11 14,10.3 14,9.5C14,8.7 14.7,8 15.5,8C16.3,8 17,8.7 17,9.5M12,17.23C10.25,17.23 8.71,16.5 7.81,15.42L9.23,14C9.68,14.72 10.75,15.23 12,15.23C13.25,15.23 14.32,14.72 14.77,14L16.19,15.42C15.29,16.5 13.75,17.23 12,17.23Z"
    />
  </svg>
</span>

Note how we attached a mousedown.prevent event listener to that button instead of click. We did this to prevent the textarea from losing its focus when the picker opens.

Now let’s define that method, like this:

methods: {
  toggleEmojiPicker () {
    this.showEmojiPicker = !this.showEmojiPicker
  }
}

Lastly, we should use that flag on our picker via v-show:

<picker v-show="showEmojiPicker" title="Pick your emoji..." emoji="point_up" />

Just in case you’re wondering, we used v-show instead of v-if to avoid instantiating the picker each time it’s toggled. So we just instantiate it once and then keep toggling it using css display:none, which is clearly faster.

Adding emojis

Now we get to the last piece of our component. As I mentioned earlier, we need to read the unicode value of the clicked emoji. And to get that value, we have to listen to @select event on <picker> component:

<picker
  v-show="showEmojiPicker"
  title="Pick your emoji..."
  emoji="point_up"
  @select="addEmoji"
/>

Now let me show you how to define that method and then explain it:

addEmoji (emoji) {
  const textarea = this.$refs.textarea
  const cursorPosition = textarea.selectionEnd
  const start = this.value.substring(0, textarea.selectionStart)
  const end = this.value.substring(textarea.selectionStart)
  const text = start + emoji.native + end
  this.$emit('input', text)
  textarea.focus()
  this.$nextTick(() => {
    textarea.selectionEnd = cursorPosition + emoji.native.length
  })
}

We add the emoji in three steps. First, we split the text in the textarea into two pieces: from the beginning to the current cursor position and from the current cursor position to the end. We named them start and end, respectively.

Second, we concatenate the first part, the emoji, and the second part together and store them in text constant. And then we use that value to update the current text in the textarea.

Third, we re-focus on the textarea, and then move the cursor after the added emoji.

Note how we needed to reposition the cursor in the $nextTick callback to wait until the focusing is done in the previous tick.

That’s it! Now you should have an emoji picker in your textarea.

Note: the code of this demo can be found on GitHub.

Stay up-to-date on the latest projects and articles from me