The Tab plugin allows you to define additional code tabs to the pattern viewer / modal.
JavaScript
Latest commit c13eec8 Nov 2, 2016 @bmuenzenmeyer bmuenzenmeyer committed on GitHub Merge pull request #14 from pattern-lab/dev
1.0.0

README.md

license npm Gitter

Tab Plugin for Pattern Lab Node

The Tab Plugin allows Pattern Lab Node users to see sibling files next to a pattern in the filesystem, displaying them as additional tabs alongside the template and HTML tabs in both the Style Guide frontend and the single-pattern info modal.

Read more about Pattern Lab Node Plugins

Installation

To add the Tab Plugin to your project using npm type:

npm install plugin-node-tab --save

Or add it directly to your project's package.json file and run npm install

At time of installation, the plugin will prompt you for what filetypes you want to add tabs for.

$ Specify filetype(s) to create a tab for. Separate multiple filetypes with a space, pipe or comma. Example: js css >>>

Post-installation, the plugin should be added as a key to the plugins object in your main Pattern Lab project's patternlab-config.json file.

Example:

"plugins": {
  "plugin-node-tab": {
    "enabled": true,
    "initialized": false
  }
}

Expected Structure

With the Tab Plugin installed, you can now accompany pattern template files with the file types of your choice and expect Pattern Lab to show them as tabs. The file structure would be similar to that of pattern.json or pattern.md files, except that it will be pattern.<<type>>.

For example, if we added acss tab:

./_patterns/foo/bar
├── pattern.mustache (the pattern template)
├── pattern.md (optional pattern-specific documentation and metadata)
├── pattern.json (optional pattern-specific data)
└── pattern.css (the tab you added.)

Enabling / Disabling the Plugin

After install, you may manually enable or disable the plugin by finding the plugin-node-tab key within your main Pattern Lab project's patternlab-config.json file and setting the enabled flag. In the future this will be possible via CLI.