Skip to content

kommitters/editorjs-toggle-block

🚨 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 Toggle Block

stability-alpha Coverage Status CII Best Practices OpenSSF Scorecard

Toggle block tool for Editor.js

Installation

Install via NPM

$ npm i --save-dev editorjs-toggle-block

Include module at your application

import ToggleBlock from 'editorjs-toggle-block';

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-toggle-block"></script>

Usage

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

const editor = EditorJS({
  tools: {
    toggle: {
      class: ToggleBlock,
      inlineToolbar: true,
    },
  },
});

Shortcuts

  1. Type the > character followed by Space to create a new toggle.
  2. Type Shift + Tab to extract a nested block.
  3. Type Tab to insert an existing block into a toggle.

Development

Development mode

$ npm run build:dev

Using the Playground

To test the functionality of the plugin, you can use the provided playground:

  1. Navigate to the playground folder in the project directory.
  2. Open the index.html file in your web browser.
  3. Experiment the plugin's behavior.

Production release

  1. Create a production bundle
    $ npm run build
  2. Commit dist/bundle.js

Run tests

$ npm run 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