Installation.

Install the package

Use the same published version as this showcase, or review the upstream release notes before updating.

This package’s license: MIT. Retain upstream and bundled third-party notices when redistributing.

Mount your first view

Import the package to register . Assign its model with tabs, groups and command callbacks. Shadow DOM styles are included.

<ribbon-web id="ribbon"></ribbon-web><div class="panel" style="margin-top:24px"><p class="hint">LIVE DOCUMENT PREVIEW</p><h1 id="heading">Make room for ideas.</h1><p id="copy">A ribbon can be powerful without getting in the way. Try Bold, Accent or a different tab.</p><output id="status">Ready for your next command.</output></div>

The complete executable source is in the usage guide. Imports shown here are intended for a bundler or a browser import map; bare npm imports do not resolve in ordinary HTML by themselves.

Own the lifetime

Release application-owned command subscriptions and bindings on unmount. Keep command state in a model rather than duplicating it in the UI.

The playground replaces its entire isolated frame on each run. In your application, use the framework’s unmount or disposal hook instead. Do not dispose a shared model while another view still owns it.

Know the contract

Source repositories can contain work newer than the published package. The showcase uses @wieslawsoltes/ribbon-web@0.1.1.