@pattern-lab/plugin-tab
v6.1.0
Published
![license](https://img.shields.io/github/license/pattern-lab/patternlab-node.svg) [![npm](https://img.shields.io/npm/v/@pattern-lab/plugin-tab.svg)](https://www.npmjs.com/package/@pattern-lab/plugin-tab) [![Join the chat at Gitter](https://badges.gitter.i
Downloads
860
Keywords
Readme
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 @pattern-lab/plugin-tab --save
Or add it directly to your project's package.json
file and run npm install
During installation, the plugin is added as a key to the plugins
object in your main Pattern Lab project's patternlab-config.json
file
If you don't see this object, try running
npm run postinstall
within the root of your project.
Configuration
Post-installation, you will see the following in your patternlab-config.json
:
Example:
"plugins": {
"@pattern-lab/plugin-tab": {
"enabled": true,
"initialized": false,
"options": {
"tabsToAdd": []
}
}
}
Add file extensions to this array as strings. Example: "tabsToAdd": ["scss", "js"]
. You are all set now.
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 an scss
tab:
./_patterns/foo/bar
├── pattern.mustache (the pattern template)
├── pattern.md (optional pattern-specific documentation and metadata)
├── pattern.json (optional pattern-specific data)
└── pattern.scss (a file matching the tab you added.)
Enabling / Disabling the Plugin
After install, you may manually enable or disable the plugin by finding the @pattern-lab/plugin-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.