github.com/Azareal/Gosora@v0.0.0-20210729070923-553e66b59003/public/jquery-emojiarea/README.md (about)

     1  *NOTICE* This extends the [original plugin](https://github.com/diy/jquery-emojiarea) by groups. (See screenshot at dropdown menu)
     2  
     3  #### About this extension
     4  This was originally created for my project *The Msngr*, which should have become an open-source end-to-end encrypted messanger. I am always happy about an attribution to me and my website, e.g. [\<a href="https://pius-ladenburger.de">Pius Ladenburger\</a>](https://pius-ladenburger.de).
     5  
     6  I hope this helps you and makes your day easier.
     7  
     8  #.emojiarea()
     9  
    10  A small **6kb** [jQuery](http://jquery.com/) plugin for turning regular textareas into ones that support emojis, WYSIWYG style! Set up a list of available emojis, call `$('textarea').emojiarea()` and you're done (basically). There's a plain-text fallback, so if the browser doesn't support [contentEditable](http://caniuse.com/#search=contenteditable), it will degrade gracefully—the user will still be able to use the dropdown menu of emojis.
    11  
    12  ![Screenshot](http://i.imgur.com/C4Z8F.gif)
    13  
    14  ```html
    15  <textarea>Hello :smile:</textarea>
    16  <script type="text/javascript">$('textarea').emojiarea();</script>
    17  ```
    18  
    19  ## Configuration
    20  
    21  ### Dropdown Menu
    22  
    23  ![Dropdown Screenshot](http://i.imgur.com/EuTTpHk.png)
    24  
    25  By default, the plugin will insert a link after the editor that toggles the emoji selector when clicked.
    26  
    27  ```html
    28  <a href="javascript:void(0)" class="emoji-button">Emojis</a>
    29  ```
    30  
    31  If you wish change this behavior and have the button placed before the editor, or change the label of the link, use:
    32  
    33  ```javascript
    34  $('textarea').emojiarea({
    35      buttonLabel: 'Add Emoji',
    36      buttonPosition: 'before'
    37  });
    38  ```
    39  
    40  Alternatively, if you wish to use your own button:
    41  
    42  ```javascript
    43  $('textarea').emojiarea({button: '#your-button'});
    44  ```
    45  
    46  For customizing the visual appearance, see the [CSS / Skinning](#css--skinning) section.
    47  
    48  ### Available Emojis
    49  
    50  ```javascript
    51  $.emojiarea.path = '/path/to/folder/with/icons';
    52  $.emojiarea.icons = {
    53      ':smile:'     : 'smile.png',
    54      ':angry:'     : 'angry.png',
    55      ':flushed:'   : 'flushed.png',
    56      ':neckbeard:' : 'neckbeard.png',
    57      ':laughing:'  : 'laughing.png'
    58  };
    59  ```
    60  
    61  ### Defaults
    62  
    63  If you wish to set the defaults for `$().emojiarea()`, extend `$.emojiarea.defaults` like so:
    64  
    65  ```javascript
    66  $.extend($.emojiarea.defaults, {
    67      buttonPosition: 'before'
    68  });
    69  ```
    70  
    71  For a basic set of emojis, see "packs/basic". 
    72  
    73  ## CSS / Skinning
    74  
    75  See [jquery.emojiarea.css](https://github.com/diy/jquery-emojiarea/blob/master/jquery.emojiarea.css) for the few fundamental CSS styles needed for this to work.
    76  
    77  Basically, you'll want to adjust the following styles:
    78  
    79  ```css
    80  .emoji-wysiwyg-editor /* the editor box itself */
    81  .emoji-menu > div /* the dropdown menu with options */
    82  .emoji-wysiwyg-editor img /* the emoji images in the editor */
    83  ```
    84  
    85  ## Footnotes
    86  
    87  * Huge props to [Tim Down](http://stackoverflow.com/users/96100/tim-down) for the many insightful answers on Stack Overflow having to deal with cross-browser selection handling.
    88  * If you have a really rad set of emojis and would like to share, please fork this, add them to "packs/", and submit a pull request!
    89  * For a giant list of emojis (used by Github, Basecamp, et al), see ["Emoji cheat sheet"](http://www.emoji-cheat-sheet.com/).
    90  
    91  ## License
    92  
    93  Copyright &copy; 2012 DIY Co and 2015 Pius Ladenburger
    94  
    95  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
    96  
    97  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.
    98  
    99  I am always happy about an attribution to me and my website, e.g. [\<a href="https://pius-ladenburger.de">Pius Ladenburger\</a>](https://pius-ladenburger.de)