All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.
- Added support popoverComponent on the
MentionSuggestions
component. Thanks to @samdroid-apps - Introduced a new configuration option
mentionTrigger
. By default it is set to@
. As before by default typing@
will trigger the search for mentions. You can provide a custom character or string to change when the search is triggered. #320 Thanks to @yjang1031 - MentionSuggestions accepts a new prop
entryComponent
. The passed component is used as the template for each of the suggestions' entry. #317. Thanks to @Zhouzi defaultEntryComponent
component is passedsearchValue
prop to enable more customizations when displaying the the MentionSuggestions. Thanks to @nishp1- The config now accepts a new prop
mentionComponent
. If provided the passed component is used to render a Mention. #271. Thanks to @alexkuz - Introduced the
mentionRegExp
configuration to overwrite the regular expression for initiating the dropdown. By default this supports any alphanumeric character as well as Chinese, Japanese & Korean characters. - Added support for Chinese words. Thanks to @mzbac
- Added support for Japanese characters (hiragana & katakana).
- Added support for Korean characters (Hangul Syllables & Hangul Compatibility Jamo). Thanks to @FourwingsY
- Added
onAddMention
prop to MentionSuggestions. The first argument of this callback will contain the mention entry.
- Fix bug that selects candidate on hitting return key even if the dropdown was closed. Thanks to @ngs #720
- Fix issue with: add two mentions in the Custom Mention Component Example editor, then press backspace key, will remove the first one. Thanks to @chenyuejie #693
- Prevents inserting the selected item on Enter or Tab when there's no trigger in sight and dropdown is not rendered. Thanks to @alexfedoseev #706
- Reopens mentions dropdown if new suggestions are available. Thanks to @jameskraus #659
- Solved a bug with @ being placed in the beginning. Thanks to @hjyue1 #621
- Fixed "Cannot read property 'getBoundingClientRect' of null" issue. Thanks to @ismyrnow #666
- Mentions popover showed up when typing before a @ #323 Thanks to @nishp1
- Only pass element properties to the root Div of MentionSuggestions to remove the "Unknown prop warning" in React 15.2.0
- Fixed bug where a user typed @xxx (invalid mention) and hit Enter. #416
- Fixed bug where press up arrow would not cycle back to the bottom of suggestions
- Fixed race condition where the SuggestionPortal would unregister and not register again when inputting Japanese, etc.
- Fixed bug where
mentionPrefix
does not appear ineditorState
.mentionPrefix
is no longer passed tomentionComponent
. - Fixed bug where
onSearchChange
didn't fire when a user switched between two different mention autocompletions with the same search value. Now it will triggeronSearchChange
in such a case.
- Accepts plain JavaScript Objects for mentions from now on. Until now it only accepted an
Immutable.Map
. This change would make it play nicer together withconvertFromRaw
by default. Thanks to @anderslemke #326 positionSuggestions
now works by default with non-static parents. Thanks to @Zhouzi #309 #206 #283 #289
MentionSuggestions
now acceptsonOpen
andonClose
props. These callbacks are triggered when the popover has opened or closed.
- Fix rendering the MentionSuggestions in IE11 by avoiding to render an Immutable List #266 #270
- Fix React 0.14.x support by returning
<noscript />
instead ofnull
#267
- Make sure there is no autocomplete on tab after deleting a mention #234
- Instead of the popover inline it is now exported as
MentionSuggestions
and can be placed anywhere in the DOM. It's recommended to place it right after the Editor. This change was important to avoid selection issues trigged bycontentEditable={false}
. mentions
has been renamed tosuggestions
and now has to be directly provided to theMentionSuggestions
component as property.- Moved to a flat configuration. Instead of plugin properties (decorators & hooks) being stored within pluginProps they now moved to the root object. See the changes here #150 as well as the initial discussion here #143
- Improved the regex and now test for a whitespace in front of the
@
to make sure it doesn't match on normal text like an email #104 - Moved the option
theme
from an Immutable Map to a JavaScript object. This is more likely to become a standard. - Improved styling and added animations for the Suggestions overlay as well as the hover on a single suggestion.
- Updated the theme properties.
- Fix using backspace to close the autocomplete suggestions after typing an
@
#110
- The config now takes a property
entityMutability
. A developer can choose between 'IMMUTABLE', 'SEGMENTED' & 'MUTABLE'. Read in detail about it here. - The config now takes a property
positionSuggestions
. The function can be used to manipulate the position of the popover containing the suggestions. It receives one object as arguments containing the visible rectangle surrounding the decorated search string including the @. In addition the object contains prevProps, prevState, state & props. An object should be returned which can contain all sorts of styles. The defined properties will be applied as inline-styles. - Introduce a new config property:
mentionPrefix
. By default it is an empty String. For Twitter or Slack like mention behaviour you can provide an@
.
const mentionPlugin = createMentionPlugin({ entityMutability: 'IMMUTABLE' });
- The
MentionSuggestions
component now takes a propertyonSearchChange
which will trigger whenever the search value of changes. - The module now exports
defaultSuggestionsFilter
for convenience. As first argument it takes the search term as a String. The second argument is the Immutable list of mentions. The function returns the filter list based on substring matches.
- Fix issue with showing two menus at the same time #132
- When typing ahead to 0 results and then back the first item must be still selected. #149
It's not recommended to use the version 0.0.0 - 0.0.2