o-lee-test-component
A short description of what the component does.
Instructions for the component. We've broken this down by Markup, JavaScript, Sass, etc. You may add more sections as needed.
Usage
Check out how to include Origami components in your project to get started with o-lee-test-component.
Markup
Markup documentation for the component. Including css classes, data attributes, and tags for variations of the component. Demo markup is also shown in the registry. For complex markup it can be useful to describe the markup and link to the registry demos for a full example. Remember to start your codeblocks with three backticks and "html" so your markup is syntax highlighted correctly.
<div data-o-component="o-lee-test-component" class='o-lee-test-component'>
</div>JavaScript
JavaScript documentation. Including how to initialise the component, available options, and common usecases. For complex components it may be helpful to document apis with JSDoc and link to the components JSDocs in the Origami Registry. Remember to start your codeblocks with three backticks and "js" so your js is syntax highlighted correctly.
JavaScript is initialised automatically for Origami Build Service users. If your project is using a manual build process, initialise o-lee-test-component manually.
For example call the init method to initialise all o-lee-test-component instances in the document:
import oLeeTestComponent from 'o-lee-test-component';
oLeeTestComponent.init();Or pass an element to initialise a specific o-lee-test-component instance:
import oLeeTestComponent from 'o-lee-test-component';
const oLeeTestComponentElement = document.getElementById('#my-o-lee-test-component-element');
oLeeTestComponent.init(oLeeTestComponentElement);Learn more about Origami component initialisation.
Troubleshooting
Answers to questions or problems that come up repeatedly. It's likely you can delete this section for now. Remember to remove it from the table of contents.
Contributing
Contributing documentation for non typical components. It's likely you can delete this section if your component conforms with other components. Remember to update the table of contents is you remove this section.
Migration
Guides to upgrade from one major version of a component to another.
This section includes a table of major versions with links to MIGRATION.md.
MIGRATION.md would provide upgrade instructions, but since this is a new component there is no MIGRATION.md.
Delete this section, including from the table of contents, until there is a second major version of this component.
| State | Major Version | Last Minor Release | Migration guide |
|---|---|---|---|
| ✨ active | 3 | N/A | migrate to v3 |
| ⚠ maintained | 2 | 2.0 | migrate to v2 |
| ╳ deprecated | 1 | 1.0 | N/A |
Contact
If you have any questions or comments about this component, or need help using it, please either raise an issue, visit ##origami-support or email origami.support@ft.com.
Licence
This software is published by the Financial Times under the MIT licence.