GeChiUIAutop
JavaScript port of GeChiUI's automatic paragraph function autop and the removep reverse behavior.
Installation
Install the module
npm install @gechiui/autop --saveThis package assumes that your code will run in an ES2015+ environment. If you're using an environment that has limited or no support for such language features and APIs, you should include the polyfill shipped in @gechiui/babel-preset-default in your code.
API
autop
Replaces double line-breaks with paragraph elements.
A group of regex replaces used to identify text formatted with newlines and
replace double line-breaks with HTML paragraph tags. The remaining line-
breaks after conversion become <br /> tags, unless br is set to 'false'.
Usage
import { autop } from '@gechiui/autop';
autop( 'my text' ); // "<p>my text</p>"Parameters
- text
string: The text which has to be formatted. - br
boolean: Optional. If set, will convert all remaining line- breaks after paragraphing. Default true.
Returns
string: Text which has been converted into paragraph tags.
removep
Replaces <p> tags with two line breaks. "Opposite" of autop().
Replaces <p> tags with two line breaks except where the <p> has attributes.
Unifies whitespace. Indents <li>, <dt> and <dd> for better readability.
Usage
import { removep } from '@gechiui/autop';
removep( '<p>my text</p>' ); // "my text"Parameters
- html
string: The content from the editor.
Returns
string: The content with stripped paragraph tags.
Contributing to this package
This is an individual package that's part of the Gutenberg project. The project is organized as a monorepo. It's made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to npm and used by GeChiUI as well as other software projects.
To find out more about contributing to this package or Gutenberg as a whole, please read the project's main contributor guide.
