react-native-rich-text-input v0.15.1

react-native-rich-text-input

Native component that allows you to add different rich text abilities

No webviews, no turbo-module-like tricks, just straight up native UITextView for iOS and EditText for Android

Note from author

I've been having a really good time developing this thing for Android, but iOS has driven me into a deepest pit of despair where things are so bad that you honestly believe that God left us because we invented Swift and Objective-C.

I'm temporarily (foreverily) dropping support for iOS devices and will focus more on Android, since I can't take iOS's bs anymore. So iOS contributors are welcome.

Installation

npm install react-native-rich-text-input

or

yarn add react-native-rich-text-input

Installation for iOS

cd ios && pod install

Installation for Android

No specific installation needed, just install the lib and launch the project

Usage

import RichTextInput,  { type RichTextRef, type RichTextChangeEvent } from 'react-native-rich-text-input';

// ...

const ref = useRef<RichTextRef>(null);

const handleFocus = () => {
    ref.current?.focus();
};

const handleBlur = () => {
    ref.current?.blur();
};

const handleUnderlinePress = () => {
    ref.current?.toggleUnderline();
};

const handleBoldPress = () => {
    ref.current?.toggleBold();
};

const handleStrikePress = () => {
    ref.current?.toggleStrike();
};

const handleItalicPress = () => {
    ref.current?.toggleItalic();
};

const handleGetHTML = async () => {
    console.log(ref.current?.getHTML());
};

const handleChange = (event: RichTextChangeEvent) => {
    console.log(event.nativeEvent.text);
};

// NOTE: will automatically convert html to rich text
const handleInsertText = () => {
    ref.current?.insertText('<p dir="ltr"><u>some</u> <b>text</b></p>');
};

const handleFocus = () => {
    ref.current?.focus();
};

const handleBlur = () => {
    ref.current?.blur();
};

// NOTE: you are responsible for valid selection and URL format
// This will embed a link to selected portion of text
// arg0 - start of the text
// arg1 - end of the text
// arg2 - link itself to be embedded in range of arg0...arg1
const handleEmbedLink = () => {
    ref.current?.embedLink(0, 5, 'https://www.google.com');
};

// arg0 - position of link in text
const handleRemoveLink = () => {
    ref.current?.removeLink(1);
};

const handleGetSelection = () => {
    console.log(ref.current?.getSelection());
};

// arg0 - position of link in text
const handleGetLink = () => {
    console.log(ref.current?.getLink(1));
};

<RichTextInput
    ref={ref}
    placeholder="I am the angry placeholder"
    onChange={handleChange}
    style={{height: 200, width: "100%"}}
/>

What was done

1. Setting placeholder (iOS, Android)
2. Select a portion of text and add different styles (bold, italic, underline, strikethrough) (iOS, Android)
3. Add native context menu for formatting (iOS, Android)
4. Add onChange prop (iOS, Android)
5. Return text without markdown (iOS, Android)
6. Add method that returns rich text in HTML (iOS, Android)
7. Add method to set default text (Android)
8. Add focus and blur methods (iOS, Android)
9. Link embedding (+-iOS, Android)
10. Link deletion (iOS, Android)
11. Add method to return current selection (Android)
12. Add getting link from specified position (Android)

TODO

1. Ability to enable certain format and apply it without selecting a portion of text
2. Returning active formats for a selection
3. Add convertation to markdown (not sure about this for now)
4. Add method to return current selection (iOS)
5. Add proper HTML creation from attributedString in iOS
6. Fix iOS link embedding (wrong ranges of links)

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

Note from author: if you have requests regarding new props, bugs and stuff - please open up an issue and I will take a look at it

License

MIT

Made with create-react-native-library