Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Soreine/draft-js-simpledecorator
Create a Draft.Decorator simply, with more flexibility than Draft.CompositeDecorator
https://github.com/Soreine/draft-js-simpledecorator
Last synced: 3 months ago
JSON representation
Create a Draft.Decorator simply, with more flexibility than Draft.CompositeDecorator
- Host: GitHub
- URL: https://github.com/Soreine/draft-js-simpledecorator
- Owner: Soreine
- License: mit
- Created: 2016-06-10T10:09:55.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-02-13T09:16:32.000Z (over 7 years ago)
- Last Synced: 2024-04-15T04:23:30.727Z (7 months ago)
- Language: JavaScript
- Size: 7.81 KB
- Stars: 25
- Watchers: 2
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-draft-js - Draft.js SimpleDecorator - Easily create flexible decorators. (Common Utilities)
README
# draft-js-simpledecorator
[](http://badge.fury.io/js/draft-js-simpledecorator)
#### Description
Create some `Draft.Decorators` as simply as with `Draft.CompositeDecorator`, but with the possibility to pass custom `props` to your decorating component.
#### Why ?
When making `Decorators`, you normally either implement the [`DecoratorType` interface](interface) yourself (tedious), or use the convenient [`Draft.CompositeDecorator`](composite). `Draft.CompositeDecorator` asks to define a `strategy` and to provide a rendering `component`. The `strategy` function simply tells what part of the document should be decorated by the `component`. But **you have no way to pass custom `props` to the `component`**.
`SimpleDecorator` implements the `DecoratorType` interface for you, and still offers the flexibility of passing custom `props` in your `strategy`.
#### Installation
```
$ npm install draft-js-simpledecorator
```
#### Usage
This module uses the same convention than `Draft.CompositeDecorator`, and ask to provide a `strategy` and a `component`.
```js
var Draft = require('draft-js');
var SimpleDecorator = require('draft-js-simpledecorator');
var decorator = new SimpleDecorator(
function strategy(contentBlock, callback, contentState) {
// Decorate any span of text in the content block,
// providing custom props!
var customProps = {};
callback(start, end, customProps);
},
function component(props) {
// return some React.Component
}
);
var editorState = Draft.EditorState.createEmpty(decorator)
```
#### Example: Coloring hexadecimal color codes
Below is an example decorator that finds any _hexadecimal color code_ (ex: `#ffca40`), and color them accordingly:
```jsx
const hexColorDecorator = new SimpleDecorator(
function strategy(contentBlock, callback, contentState) {
const text = contentBlock.getText()
// Match text like #ac00ff and #EEE
let HEX_COLOR = /#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})/g
// For all Hex color matches
let match
while ((match = HEX_COLOR.exec(text)) !== null) {
// Decorate the color code
let colorText = match[0]
let start = match.index
let end = start + colorText.length
let props = {
color: colorText
}
callback(start, end, props)
}
},
/**
* @prop {String} color
*/
function component(props) {
// Colorize the text with the given color
return { props.children }
}
)
```
To do that in Draft, you would not be able to use `Draft.CompositeDecorator`. Instead, you would have to re-implement the [`DecoratorType` interface](interface) yourself.
#### See also
`Draft.CompositeDecorator` permits to define multiple decorators. To do so with `SimpleDecorator`, you can use [MultiDecorators](https://github.com/SamyPesse/draft-js-multidecorators), which allows to easily compose any decorator.
[interface]: https://github.com/facebook/draft-js/blob/master/src/model/decorators/DraftDecoratorType.js
[composite]: https://facebook.github.io/draft-js/docs/api-reference-composite-decorator.html