@gerhobbelt/markdown-it-checkbox

1.2.0-3 • Public • Published

markdown-it-checkbox

NPM version Build Status Coverage Status Dependency Status devDependency Status

Plugin to create checkboxes for markdown-it markdown parser.

This plugin allows to create checkboxes for tasklists as discussed here.

Usage

Install

node.js, browser:

npm install @gerhobbelt/markdown-it-checkbox --save

Use

var md = require('@gerhobbelt/markdown-it')()
            .use(require('@gerhobbelt/markdown-it-checkbox'));

md.render('[ ] unchecked') // =>
// <p>
//  <input type="checkbox" id="checkbox0">
//  <label for="checkbox0">unchecked</label>
// </p>

md.render('[x] checked') // =>
// <p>
//  <input type="checkbox" id="checkbox0" checked="">
//  <label for="checkbox0">checked</label>
// </p>

Differences in browser. If you load script directly into the page, without package system, module will add itself globally as window.markdownitCheckbox.

Options

var md = require('@gerhobbelt/markdown-it')()
            .use(require('@gerhobbelt/markdown-it-checkbox'),{
              divWrap: true,
              divClass: 'cb',
              idPrefix: 'cbx_',
              readonly: true
            });

md.render('[ ] unchecked') // =>
// <p>
//  <div classname="cb">
//    <input type="checkbox" id="cbx_0" readonly="">
//    <label for="cbx_0">unchecked</label>
//  </div>
// </p>

divWrap

  • Type: Boolean
  • Default: false

wrap div arround checkbox. this makes it possible to use it for example with Awesome Bootstrap Checkbox.

divClass

  • Type: String
  • Default: checkbox

classname of div wrapper. will only be used if divWrap is enanbled.

idPrefix

  • Type: String
  • Default: checkbox

the id of the checkboxs input contains the prefix and an incremental number starting with 0. i.e. checkbox1 for the 2nd checkbox.

readonly

  • Type: Boolean
  • Default: false

set the input to be readonly. this ensures that users cannot toggle the checkbox in the browser.

License

MIT License © 2015 Markus Cecot

Package Sidebar

Install

npm i @gerhobbelt/markdown-it-checkbox

Weekly Downloads

21

Version

1.2.0-3

License

MIT

Unpacked Size

228 kB

Total Files

18

Last publish

Collaborators

  • gerhobbelt