nav-bar
The bar across the top of a site: the brand, the main links, and actions such as Sign in. The current page's link is marked aria-current="page". When the bar is too narrow for the links (its own width, not the screen's), they fold behind a Menu button. links is [{ label, href, current? }].
This one has no events: it shows what it's given.
Source: nav-bar.zb, and its registry item.
Install
npx shadcn@latest add https://zubra-js.github.io/zubra-ui/r/nav-bar.jsonpnpm dlx shadcn@latest add https://zubra-js.github.io/zubra-ui/r/nav-bar.jsonyarn dlx shadcn@latest add https://zubra-js.github.io/zubra-ui/r/nav-bar.jsonbunx --bun shadcn@latest add https://zubra-js.github.io/zubra-ui/r/nav-bar.json
npx shadcn@latest add https://zubra-js.github.io/zubra-ui/r/element/nav-bar.jsonpnpm dlx shadcn@latest add https://zubra-js.github.io/zubra-ui/r/element/nav-bar.jsonyarn dlx shadcn@latest add https://zubra-js.github.io/zubra-ui/r/element/nav-bar.jsonbunx --bun shadcn@latest add https://zubra-js.github.io/zubra-ui/r/element/nav-bar.json
npx shadcn@latest add https://zubra-js.github.io/zubra-ui/r/src/nav-bar.jsonpnpm dlx shadcn@latest add https://zubra-js.github.io/zubra-ui/r/src/nav-bar.jsonyarn dlx shadcn@latest add https://zubra-js.github.io/zubra-ui/r/src/nav-bar.jsonbunx --bun shadcn@latest add https://zubra-js.github.io/zubra-ui/r/src/nav-bar.json
<link rel="stylesheet" href="https://zubra-js.github.io/zubra-ui/themes/default.css">
<script type="module" src="https://zubra-js.github.io/zubra-ui/cdn/nav-bar.js"></script>The compiled install writes src/components/zubra/nav-bar.js and the theme, and adds @zubra/runtime to your dependencies. The one-file install writes the same path as a plain custom element that needs nothing installed (or download it and load it with a <script type="module">); it's smaller on a page with one to three components, the shared runtime with more.
Usage
<nav-bar brand="Bakehouse" href="#home">
<action-button slot="actions" variant="outline" href="#signin">Sign in</action-button>
</nav-bar>
<script type="module">
import './components/zubra/nav-bar.js';
import './components/zubra/action-button.js';
const element = document.querySelector('nav-bar');
element.links = [
{ label: 'Recipes', href: '#recipes', current: true },
{ label: 'Classes', href: '#classes' },
{ label: 'Shop', href: '#shop' },
{ label: 'About', href: '#about' },
];
</script>import './components/zubra/nav-bar.js';
import './components/zubra/action-button.js';
const links = [
{ label: 'Recipes', href: '#recipes', current: true },
{ label: 'Classes', href: '#classes' },
{ label: 'Shop', href: '#shop' },
{ label: 'About', href: '#about' },
];
export function NavBarExample() {
return (
<nav-bar brand="Bakehouse" href="#home" links={links}>
<action-button slot="actions" variant="outline" href="#signin">Sign in</action-button>
</nav-bar>
);
}<script setup>
import './components/zubra/nav-bar.js';
import './components/zubra/action-button.js';
const links = [
{ label: 'Recipes', href: '#recipes', current: true },
{ label: 'Classes', href: '#classes' },
{ label: 'Shop', href: '#shop' },
{ label: 'About', href: '#about' },
];
</script>
<template>
<nav-bar brand="Bakehouse" href="#home" :links.prop="links">
<action-button slot="actions" variant="outline" href="#signin">Sign in</action-button>
</nav-bar>
</template>
<!-- vite.config.js: vue({ template: { compilerOptions: { isCustomElement: (tag) => tag.includes('-') } } }) --><script>
import './components/zubra/nav-bar.js';
import './components/zubra/action-button.js';
const links = [
{ label: 'Recipes', href: '#recipes', current: true },
{ label: 'Classes', href: '#classes' },
{ label: 'Shop', href: '#shop' },
{ label: 'About', href: '#about' },
];
</script>
<nav-bar brand="Bakehouse" href="#home" {links}>
<action-button slot="actions" variant="outline" href="#signin">Sign in</action-button>
</nav-bar>import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import './components/zubra/nav-bar.js';
import './components/zubra/action-button.js';
@Component({
selector: 'app-nav-bar-example',
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
<nav-bar brand="Bakehouse" href="#home" [links]="links">
<action-button slot="actions" variant="outline" href="#signin">Sign in</action-button>
</nav-bar>
`,
})
export class NavBarExample {
links = [
{ label: 'Recipes', href: '#recipes', current: true },
{ label: 'Classes', href: '#classes' },
{ label: 'Shop', href: '#shop' },
{ label: 'About', href: '#about' },
];
}API
| Property | Type | Default |
|---|---|---|
brand | string | "" |
href | string | "/" |
linksproperty only | { label, href, current }[] | [] |
label | string | "Main" |
| Slot | For |
|---|---|
actions | Buttons or links at the end. |
brand | The logo or name (defaults to brand, linked to href). |
Size
1.4 KB gzipped for the component, plus the runtime, which every Zubra component on a page shares (up to 22.1 KB, all of it). On its own, with the parts of the runtime it uses, it's 18.2 KB.