dojox.editor.plugins.ShowBlockNodes

Authors:Jared Jurkiewicz
Project owner:Jared Jurkiewicz
Available:since V1.4

Have you ever wanted to see what the HTML layout being generated by the editor was? Not the source view, but just a nice ‘hint’ to how the document is being structured in HTML in terms of its block node layout. If so, then this plugin is for you!

Features

Once required in and enabled, this plugin provides the following features to dijit.Editor.

  • Button with icon in toolbar for toggling the view of block nodes in the editor.
  • Keyboard hotkey: CTRL-SHIFT-F9 for toggling the ShowBlockNodes on and off.
  • Dynamic styling in the page to enable/disable the showing of the block nodes. It does not affect or alter any of the HTML within the actual editor body, making it safe to use.

Usage

Basic Usage

Usage of this plugin is quite simple and painless. The first thing you need to do is require into the page you’re using the editor. This is done in the same spot all your dojo.require calls are made, usually a head script tag. For example:

dojo.require("dijit.Editor");
dojo.require("dojox.editor.plugins.ShowblockNodes");

Once it has been required in, all you have to do is include it in the list of extraPlugins (or the plugins property if you're reorganizing the toolbar) for you want to load into the editor. For example:

<div dojoType="dijit.Editor" id="editor" extraPlugins="['showblocknodes']"></div>

You also need to include the CSS for it. For example:

<style>
  @import "dojox/editor/plugins/resources/css/ShowBlockNodes.css";
</style>

And that's it. The editor instance you can reference by 'dijit.byId("editor")' is now enabled with the ShowBlockNodes plugin! You can use the button or hotkey to toggle the mode as you desire..

Examples

Basic Usage

<script>
  dojo.require("dijit.form.Button");
  dojo.require("dijit.Editor");
  dojo.require("dojox.editor.plugins.ShowBlockNodes");
</script>
<style>
  @import "{{baseUrl}}dojox/editor/plugins/resources/css/ShowBlockNodes.css";
</style>
<b>Toggle the show block nodes button or use CTRL-SHIFT-F9, to show and hide block nodes in the page.</b>
<br>
<div dojoType="dijit.Editor" height="250px"id="input" extraPlugins="['showblocknodes']">
<div>
<br>
blah blah & blah!
<br>
</div>
<br>
<table>
<tbody>
<tr>
<td style="border-style:solid; border-width: 2px; border-color: gray;">One cell</td>
<td style="border-style:solid; border-width: 2px; border-color: gray;">
Two cell
</td>
</tr>
</tbody>
</table>
<ul>
<li>item one</li>
<li>
item two
</li>
</ul>
</div>
Error in the documentation? Can’t find what you are looking for? Let us know!