Published on

6 Easy Ways To Create A Mentions & Hashtags With Tailwind CSS Without Even Thinking About It

Mentions & Hashtags

What is Tailwind CSS?

Tailwind CSS is a utility-first CSS framework that focuses on creating personalized user interfaces quickly. It can gives you all the building blocks you are able to create personalized designs without having to fight to override irritating opinionated styles. Also, Tailwind CSS is a highly configurable, low-level CSS framework.

The description of Mentions & Hashtags ui component

Alpinejs and tailwind mention and hashtags

Why use Tailwind CSS to build a Mentions & Hashtags ui component?

  • It can make the building process of Mentions & Hashtags ui component faster and more easily.
  • Enables building complex responsive layouts and components freely.
  • Minimum lines of CSS code in Mentions & Hashtags component file.

The preview of Mentions & Hashtags ui component

Free download of the Mentions & Hashtags's source code

The source code of Mentions & Hashtags ui component

<div class="min-w-screen min-h-screen bg-gray-50 flex items-center justify-center px-3 py-32" x-data="app()" x-init="setInput($refs.textarea)">
    <div class="w-full max-w-lg relative" @click.outside="onBlur">
        <textarea class="w-full bg-white border-2 border-gray-300 shadow-lg px-3 py-2 rounded-lg focus:outline-none focus:border-indigo-500" rows="6" placeholder="Type @ or # to trigger the mention" @input="onInput" @keydown="onKeyDown" @keyup="onKeyUp" @scroll="onScroll" x-ref="textarea"></textarea>
        <div class="absolute z-30" style="display:none;" :style="`top: ${caretPosition.top-5}px; left: ${caretPosition.left-10}px`" x-show="showPopover" x-transition:enter="transition ease duration-100 transform" x-transition:enter-start="opacity-0 scale-90 translate-y-1" x-transition:enter-end="opacity-100 scale-100 translate-y-0" >
            <span class="absolute top-0 left-0 w-2 h-2 bg-white transform rotate-45 -mt-1 ml-3 border-gray-300 border-r border-b z-20"></span>
            <div class="bg-white overflow-auto rounded-lg shadow-md z-10 py-2 border border-gray-300 text-gray-800 text-xs absolute bottom-full">
                <ul class="list-reset">
                    <template x-if="!displayedItems.length">
                        <li>
                            <span class="block px-4 py-1 text-gray-500 text-nowrap whitespace-nowrap">No results</span>
                        </li>
                    </template>
                    <template x-if="displayedItems.length">
                        <template x-for="(item,index) in displayedItems" :key="item.label+item.value+index">
                            <li @click.prevent="applyMention(index)" class="px-4 py-1 flex no-underline hover:no-underline transition-colors duration-100 text-nowrap whitespace-nowrap" :class="selectedIndex == index ? 'bg-indigo-500 text-white' : 'hover:bg-gray-100'">
                                <span x-text="item.label" class="font-bold"></span>
                                <span x-text="`[${key||''}${item.value}]`" class="ml-2"></span>
                            </li>
                        </template>
                    </template>
                </ul>
            </div>
        </div>
    </div>
</div>

<!-- BUY ME A BEER AND HELP SUPPORT OPEN-SOURCE RESOURCES -->
<div class="flex items-end justify-end fixed bottom-0 right-0 mb-4 mr-4 z-10">
    <div>
        <a title="Buy me a beer" href="https://www.buymeacoffee.com/scottwindon" target="_blank" class="block w-16 h-16 rounded-full transition-all shadow hover:shadow-lg transform hover:scale-110 hover:rotate-12">
            <img class="object-cover object-center w-full h-full rounded-full" src="https://i.pinimg.com/originals/60/fd/e8/60fde811b6be57094e0abc69d9c2622a.jpg"/>
        </a>
    </div>
</div>

<script src="https://unpkg.com/alpinejs" defer></script>
<script>
    function app() {
        return {
            keys: ['#', '@'],
            users: [
                {
                    label: "Rodolfo Kidd",
                    value: "rodolfo.kidd",
                },
                {
                    label: "Sheldon Lindsey",
                    value: "sheldonlindsey43",
                },
                {
                    label: "Adan Best",
                    value: "adan_best",
                },
                {
                    label: "Rosemary Hurley",
                    value: "rosemaryhurley22",
                },
                {
                    label: "Allyson Livingston",
                    value: "_allyson_livingston_",
                },
                {
                    label: "Carolina Gray",
                    value: "carolinagray",
                },
                {
                    label: "Howard Tran",
                    value: "howardtran923",
                },
            ],
            tags: [
                {
                    label: "alpine",
                    value: "alpine",
                },
                {
                    label: "alpinestars",
                    value: "alpinestars",
                },
                {
                    label: "alpinebabes",
                    value: "alpinebabes",
                },
                {
                    label: "alpinestar",
                    value: "alpinestar",
                },
                {
                    label: "alpinelake",
                    value: "alpinelake",
                },
                {
                    label: "alpinewhite",
                    value: "alpinewhite",
                },
                {
                    label: "alpineclimbing",
                    value: "alpineclimbing",
                },
                {
                    label: "alpineloop",
                    value: "alpineloop",
                },
                {
                    label: "alpinebreak",
                    value: "alpinebreak",
                },
                {
                    label: "alpineskiing",
                    value: "alpineskiing",
                },
                {
                    label: "alpinea110",
                    value: "alpinea110",
                },
                {
                    label: "alpineski",
                    value: "alpineski",
                },
                {
                    label: "alpinelakeswilderness",
                    value: "alpinelakeswilderness",
                },
                {
                    label: "alpinevillage",
                    value: "alpinevillage",
                },
                {
                    label: "alpinevogue",
                    value: "alpinevogue",
                },
            ],
            items: [],
            placement: 'top-start',
            omitKey: false,
            filteringDisabled: false,
            insertSpace: false,
            mapInsert: null,
            limit: 4,
            key: null,
            oldKey: null,
            searchText: null,
            caretPosition: {
                top: 0,
                left: 0,
            },
            selectedIndex: 0,
            input: null,
            showPopover: false,
            filteredItems:  function() {
              if (!this.searchText || this.filteringDisabled) {
                return this.items
              }
              const searchText = this.searchText.toLowerCase()
              return this.items.filter(item => {
                /** @type {string} */
                let text
                if (item.searchText) {
                  text = item.searchText
                } else if (item.label) {
                  text = item.label
                } else {
                  text = ''
                  for (const key in item) {
                    text += item[key]
                  }
                }
                return text.toLowerCase().includes(searchText)
              })
            },
            displayedItems: [],
            updateDisplayedItems: function() {
                selectedIndex = 0;
                return this.displayedItems = this.filteredItems().slice(0, this.limit)
            },
            //
            isIe: function() {
                const userAgent = typeof window !== 'undefined' ? window.navigator.userAgent : '';
                return userAgent.indexOf('MSIE ') !== -1 || userAgent.indexOf('Trident/') !== -1;
            },
            isFirefox: function() {
                return !(window.mozInnerScreenX == null);
            },
            setInput: function(el) {
                this.input = el;
            },
            getCaretPosition: function(element, position) {
                var mirrorDiv, computed, style;
                // The properties that we copy into a mirrored div.
                // Note that some browsers, such as Firefox,
                // do not concatenate properties, i.e. padding-top, bottom etc. -> padding,
                // so we have to do every single property specifically.
                var properties = [
                    'boxSizing',
                    'width', // on Chrome and IE, exclude the scrollbar, so the mirror div wraps exactly as the textarea does
                    'height',
                    'overflowX',
                    'overflowY', // copy the scrollbar for IE

                    'borderTopWidth',
                    'borderRightWidth',
                    'borderBottomWidth',
                    'borderLeftWidth',

                    'paddingTop',
                    'paddingRight',
                    'paddingBottom',
                    'paddingLeft',

                    // https://developer.mozilla.org/en-US/docs/Web/CSS/font
                    'fontStyle',
                    'fontVariant',
                    'fontWeight',
                    'fontStretch',
                    'fontSize',
                    'lineHeight',
                    'fontFamily',

                    'textAlign',
                    'textTransform',
                    'textIndent',
                    'textDecoration', // might not make a difference, but better be safe

                    'letterSpacing',
                    'wordSpacing'
                ];
                // mirrored div
                mirrorDiv = document.getElementById(element.nodeName + '--mirror-div');
                if (!mirrorDiv) {
                    mirrorDiv = document.createElement('div');
                    mirrorDiv.id = element.nodeName + '--mirror-div';
                    document.body.appendChild(mirrorDiv);
                }

                style = mirrorDiv.style;
                computed = getComputedStyle(element);

                // default textarea styles
                style.whiteSpace = 'pre-wrap';
                if (element.nodeName !== 'INPUT')
                    style.wordWrap = 'break-word'; // only for textarea-s

                // position off-screen
                style.position = 'absolute'; // required to return coordinates properly
                style.top = element.offsetTop + parseInt(computed.borderTopWidth) + 'px';
                style.left = "400px";
                style.visibility = 'hidden'; // not 'display: none' because we want rendering

                // transfer the element's properties to the div
                properties.forEach(function(prop) {
                    style[prop] = computed[prop];
                });

                if (this.isFirefox()) {
                    style.width = parseInt(computed.width) - 2 + 'px' // Firefox adds 2 pixels to the padding - https://bugzilla.mozilla.org/show_bug.cgi?id=753662
                    // Firefox lies about the overflow property for textareas: https://bugzilla.mozilla.org/show_bug.cgi?id=984275
                    if (element.scrollHeight > parseInt(computed.height))
                        style.overflowY = 'scroll';
                } else {
                    style.overflow = 'hidden'; // for Chrome to not render a scrollbar; IE keeps overflowY = 'scroll'
                }

                mirrorDiv.textContent = element.value.substring(0, position);
                // the second special handling for input type="text" vs textarea: spaces need to be replaced with non-breaking spaces - http://stackoverflow.com/a/13402035/1269037
                if (element.nodeName === 'INPUT')
                    mirrorDiv.textContent = mirrorDiv.textContent.replace(/\s/g, "\u00a0");

                var span = document.createElement('span');
                // Wrapping must be replicated *exactly*, including when a long word gets
                // onto the next line, with whitespace at the end of the line before (#7).
                // The  *only* reliable way to do that is to copy the *entire* rest of the
                // textarea's content into the <span> created at the caret position.
                // for inputs, just '.' would be enough, but why bother?
                span.textContent = element.value.substring(position) || '.'; // || because a completely empty faux span doesn't render at all
                mirrorDiv.appendChild(span);

                var coordinates = {
                    top: span.offsetTop + parseInt(computed['borderTopWidth']) - element.scrollTop,
                    left: span.offsetLeft + parseInt(computed['borderLeftWidth']),
                };

                return coordinates;
            },
            onInput: function(e) {
                this.checkKey()
            },
            onBlur: function() {
                this.closeMenu()
            },
            onKeyDown: function(e) {
                if (this.key) {
                    if( this.keys.includes(e.key) ) {
                        return this.cancelEvent(e);
                    }
                    this.updateDisplayedItems();
                    if (e.key === 'ArrowDown' || e.keyCode === 40) {
                        this.selectedIndex++
                        if (this.selectedIndex >= this.displayedItems.length) {
                            this.selectedIndex = 0
                        }
                        this.cancelEvent(e)
                    }
                    if (e.key === 'ArrowUp' || e.keyCode === 38) {
                        this.selectedIndex--
                        if (this.selectedIndex < 0) {
                            this.selectedIndex = this.displayedItems.length - 1
                        }
                        this.cancelEvent(e)
                    }
                    if ((e.key === 'Enter' || e.key === 'Tab' || e.keyCode === 13 || e.keyCode === 9) &&
                        this.displayedItems.length > 0) {
                        this.applyMention(this.selectedIndex)
                        this.cancelEvent(e)
                    }
                    if (e.key === 'Escape' || e.keyCode === 27) {
                        this.closeMenu()
                        this.cancelEvent(e)
                    }
                }
            },
            onKeyUp: function(e) {
                if (this.cancelKeyUp && (e.key === this.cancelKeyUp || e.keyCode === this.cancelKeyCode)) {
                    this.cancelEvent(e)
                }
                this.cancelKeyUp = null
                // IE
                this.cancelKeyCode = null
            },
            cancelEvent: function(e) {
                e.preventDefault()
                e.stopPropagation()
                this.cancelKeyUp = e.key
                // IE
                this.cancelKeyCode = e.keyCode
            },
            onScroll: function() {
                this.updateCaretPosition()
            },
            getSelectionStart: function() {
                return this.input.selectionStart
            },
            setCaretPosition: function(index) {
                this.$nextTick(() => {
                    this.input.selectionEnd = index
                })
            },
            getValue: function() {
                return this.input.value
            },
            setValue: function(value) {
                this.input.value = value
            },
            checkKey: function() {
                const index = this.getSelectionStart()
                if (index >= 0) {
                    const { key, keyIndex } = this.getLastKeyBeforeCaret(index)
                    const searchText = this.lastSearchText = this.getLastSearchText(index, keyIndex)
                    if (!(keyIndex < 1 || /\s/.test(this.getValue()[keyIndex - 1]))) {
                        return false
                    }
                    if (searchText != null) {
                        this.openMenu(key, keyIndex)
                        this.searchText = searchText;
                        this.updateDisplayedItems();
                        return true
                    }
                }
                this.closeMenu()
                return false
            },
            getLastKeyBeforeCaret: function(caretIndex) {
                const [keyData] = this.keys.map(key => ({
                    key,
                    keyIndex: this.getValue().lastIndexOf(key, caretIndex - 1),
                })).sort((a, b) => b.keyIndex - a.keyIndex)
                return keyData
            },
            getLastSearchText: function(caretIndex, keyIndex) {
                if (keyIndex !== -1) {
                    const searchText = this.getValue().substring(keyIndex + 1, caretIndex)
                    // If there is a space we close the menu
                    if (!/\s/.test(searchText)) {
                        return searchText
                    }
                }
                return null
            },
            openMenu: function(key, keyIndex) {
                if (this.key !== key) {
                    this.key = key
                    this.keyIndex = keyIndex
                    this.updateCaretPosition()
                    this.selectedIndex = 0
                    this.showPopover = true;
                    this.items = this.key === '@' ? this.users : this.tags
                }
            },
            closeMenu: function() {
                if (this.key != null) {
                    this.oldKey = this.key
                    this.showPopover = false;
                    this.key = null
                }
            },
            updateCaretPosition: function() {
                if (this.key) {
                    this.caretPosition = this.getCaretPosition(this.input, this.keyIndex);
                }
            },
            applyMention: function(itemIndex) {
                const item = this.displayedItems[itemIndex]
                const value = (this.omitKey ? '' : this.key || '') + String(this.mapInsert ? this.mapInsert(item, this.key) : item.value) + (this.insertSpace ? ' ' : '')
                this.setValue(this.replaceText(this.getValue(), this.searchText, value, this.keyIndex))
                this.setCaretPosition(this.keyIndex + value.length);
                this.closeMenu()
            },
            replaceText: function(text, searchText, newText, index) {
                return text.slice(0, index) + newText + text.slice(index + searchText.length + 1, text.length)
            },
        };
    }
</script>

How to build a Mentions & Hashtags with Tailwind CSS?

Install tailwind css of verion 2.2.4

Use the script html tag to import the script of Tailwind CSS of the version 2.2.4

<script src="https://cdn.tailwindcss.com"></script>

All the unility class needed to build a Mentions & Hashtags component

  • min-w-screen
  • min-h-screen
  • bg-gray-50
  • flex
  • px-3
  • py-32
  • w-full
  • max-w-lg
  • relative
  • bg-white
  • border-2
  • border-gray-300
  • py-2
  • focus:border-indigo-500
  • absolute
  • z-30
  • top-0
  • left-0
  • w-2
  • h-2
  • -mt-1
  • ml-3
  • border-r
  • border-b
  • z-20
  • overflow-auto
  • z-10
  • text-gray-800
  • text-xs
  • bottom-full
  • block
  • px-4
  • py-1
  • text-gray-500
  • text-nowrap
  • bg-indigo-500
  • text-white
  • hover:bg-gray-100
  • ml-2
  • fixed
  • bottom-0
  • right-0
  • mb-4
  • mr-4
  • w-16
  • h-16
  • h-full

47 steps to build a Mentions & Hashtags component with Tailwind CSS

  1. Set the minimum width/height of an element using the min-w-screen utilities.

  2. Set the minimum width/height of an element using the min-h-screen utilities.

  3. Control the background color of an element to gray-50 using the bg-gray-50 utilities.

  4. Use flex to create a block-level flex container.

  5. Control the horizontal padding of an element to 0.75rem using the px-3 utilities.

  6. Control the vertical padding of an element to 8rem using the py-32 utilities.

  7. Use w-full to set an element to a 100% based width.

  8. Set the maximum width/height of an element using the max-w-lg utilities.

  9. Use relative to position an element according to the normal flow of the document.

  10. Control the background color of an element to white using the bg-white utilities.

  11. Control the border color of an element to 0.5rem using the border-2 utilities.

  12. Control the border color of an element to gray-300 using the border-gray-300 utilities.

  13. Control the vertical padding of an element to 0.5rem using the py-2 utilities.

  14. Control the border color of an element to indigo-500 using the focus:border-indigo-500 utilities on focus.

  15. Use absolute to position an element outside of the normal flow of the document, causing neighboring elements to act as if the element doesn’t exist.

  16. Control the stack order (or three-dimensional positioning) of an element to 30 in Tailwind, regardless of order it has been displayed, using the z-30 utilities.

  17. Use the top-0 utilities to set the top position of a positioned element to 0rem.

  18. Use the left-0 utilities to set the left position of a positioned element to 0rem.

  19. Use w-2 to set an element to a fixed width(0.5rem).

  20. Use h-2 to set an element to a fixed height(0.5rem).

  21. Control the margin on top side of an element to -0.25rem using the -mt-1 utilities.

  22. Control the margin on left side of an element to 0.75rem using the ml-3 utilities.

  23. Control the border color of an element to r using the border-r utilities.

  24. Control the border color of an element to b using the border-b utilities.

  25. Control the stack order (or three-dimensional positioning) of an element to 20 in Tailwind, regardless of order it has been displayed, using the z-20 utilities.

  26. Use overflow-auto to add scrollbars to an element in the event that its content overflows the bounds of that element. Unlike .overflow-scroll, which always shows scrollbars, this utility will only show them if scrolling is necessary.

  27. Control the stack order (or three-dimensional positioning) of an element to 10 in Tailwind, regardless of order it has been displayed, using the z-10 utilities.

  28. Control the text color of an element to gray-800 using the text-gray-800 utilities.

  29. Control the text color of an element to xs using the text-xs utilities.

  30. Use the bottom-full utilities to set the bottom position of a positioned element to full.

  31. Use inline utilities to put the element on its own line and fill its parent.

  32. Control the horizontal padding of an element to 1rem using the px-4 utilities.

  33. Control the vertical padding of an element to 0.25rem using the py-1 utilities.

  34. Control the text color of an element to gray-500 using the text-gray-500 utilities.

  35. Control the text color of an element to nowrap using the text-nowrap utilities.

  36. Control the background color of an element to indigo-500 using the bg-indigo-500 utilities.

  37. Control the text color of an element to white using the text-white utilities.

  38. Control the background color of an element to gray-100 using the hover:bg-gray-100 utilities on hover.

  39. Control the margin on left side of an element to 0.5rem using the ml-2 utilities.

  40. Use fixed to position an element relative to the browser window.

  41. Use the bottom-0 utilities to set the bottom position of a positioned element to 0rem.

  42. Use the right-0 utilities to set the right position of a positioned element to 0rem.

  43. Control the margin on bottom side of an element to 1rem using the mb-4 utilities.

  44. Control the margin on right side of an element to 1rem using the mr-4 utilities.

  45. Use w-16 to set an element to a fixed width(4rem).

  46. Use h-16 to set an element to a fixed height(4rem).

  47. Use h-full to set an element’s height to 100% of its parent, as long as the parent has a defined height.

Conclusion

The above is a step-by-step tutorial on how to use Tailwind CSS to build a Mentions & Hashtags components, learn and follow along to implement your own components.