🚨 URGENT: Maintenance Transition 🚨

This project is officially entering a period of passive maintenance and will no longer receive active development or major bug fixes from kommit.

We are fully committed to keeping this project alive within the open-source community! We believe in the value this project provides, and we are actively seeking new, passionate contributors to take over ownership.

🚀 Take Over This Project!

We need a reliable steward for the future development of this repository.

Why Take Ownership?

Full Control: Gain administrative rights and full control over the project's direction.

Visibility: Showcase your expertise by leading an established open-source project.

Impact: Directly support the users who rely on this plugin.

How to Request Ownership

To apply for project ownership, you must create an issue using our dedicated template:

1. Go to the Issues page
2. Select the "Project Ownership / Maintainer Request" template
3. Fill out all required sections completely
4. Submit the issue for review

Important: Ownership requests submitted through other channels (comments, pull requests, emails) will not be considered. Please use the official issue template to ensure your application is properly reviewed.

EditorJS Tooltip Inline-tool

Tooltip for Editor.js.

Notes

• Adds a tooltip as an inline-tool in Editor.js.
• Custom styles to the selected text.
• Custom tooltip location.
• Custom styles to the tooltips.

Installation

Install via NPM

Get the package

$ npm i --save-dev editorjs-tooltip

Include module at your application

import Tooltip from 'editorjs-tooltip';

Load from CDN

You can load a specific version of the package from jsDelivr CDN.

Require this script on a page with Editor.js.

<script src="https://cdn.jsdelivr.net/npm/editorjs-tooltip"></script>

Usage

Add a new Tool to the tools property of the Editor.js initial config.

const editor = EditorJS({
  tools: {
    tooltip: {
      class: Tooltip,
      config: {
        location: 'left',
        underline: true,
        placeholder: 'Enter a tooltip',
        highlightColor: '#FFEFD5',
        backgroundColor: '#154360',
        textColor: '#FDFEFE',
        holder: 'editorId',
      }
    }
  }
});

Select some text, click on the tooltip button in the inline-tools bar, and type the tooltip in the input, when the key enter is pressed, the tooltip will be created.

Note: Use the holder field to indicate the EditorJS Id passed in the div tag, by default the holder field is 'editorjs'.

Config Params

Field	Type	Description
location	String (top, bottom, left, right)	Where to place the tooltip. Default value is bottom.
underline	Boolean	Add underline text decoration to the text wrapped by the tooltip. Default is false.
placeholder	String	Placeholder text for the tooltip input. Default is 'Add a tooltip'.
highlightColor	String or Hexadecimal	Background color of the text wrapped by the tooltip.
backgroundColor	String or Hexadecimal	Background color of the tooltip container.
textColor	String or Hexadecimal	Text color of the tooltip.
holder	String	ID of the HTML element that contains the EditorJS instance. Default is 'editorjs'.

Output data

Selected text will be wrapped in a span tag with a cdx-tooltip class and with a data-tooltip, it contains the tooltip text.

{
    "type" : "text",
    "data" : {
        "text" : "It is a text to the <span class=\"cdx-tooltip\" data-tooltip =\"tooltip\" >tooltip</span> inline-tool."
    }
}

Development

Development mode

$ yarn build:dev

Production release

1. Create a production bundle

$ yarn build

2. Commit dist/bundle.js

Run Linter The linter tool will help you by analyzing source code and fix common errors, or by following the style conventions defined.

$ yarn lint .

Run tests

$ yarn test

Code of conduct

We welcome everyone to contribute. Make sure you have read the CODE_OF_CONDUCT before.

Contributing

For information on how to contribute, please refer to our CONTRIBUTING guide.

Changelog

Features and bug fixes are listed in the CHANGELOG file.

License

This library is licensed under an MIT license. See LICENSE for details.

Acknowledgements

Made with 💙 by kommitters Open Source