Documentation
¶
Overview ¶
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
templ: version: v0.3.1020
Index ¶
- Variables
- func ComponentDocs(doc ComponentDoc) templ.Component
- func ComponentLink(tagName, url string) templ.Component
- func EventLink(name, url string) templ.Component
- func LandingPage() templ.Component
- func Page(currentPath, title, morpheusVersion string) templ.Component
- func PageAlert(morpheusVersion string) templ.Component
- func PageAvatar(morpheusVersion string) templ.Component
- func PageAvatars(morpheusVersion string) templ.Component
- func PageBadge(morpheusVersion string) templ.Component
- func PageBoundary(morpheusVersion string) templ.Component
- func PageBreadcrumb(morpheusVersion string) templ.Component
- func PageBundleBuilder(morpheusVersion string) templ.Component
- func PageButton(morpheusVersion string) templ.Component
- func PageButtonGroup(morpheusVersion string) templ.Component
- func PageCard(morpheusVersion string) templ.Component
- func PageCarousel(morpheusVersion string) templ.Component
- func PageCheckbox(morpheusVersion string) templ.Component
- func PageClipcopy(morpheusVersion string) templ.Component
- func PageColorField(morpheusVersion string) templ.Component
- func PageCombobox(morpheusVersion string) templ.Component
- func PageComponents(morpheusVersion string) templ.Component
- func PageCondition(morpheusVersion string) templ.Component
- func PageContextMenu(morpheusVersion string) templ.Component
- func PageDatalist(morpheusVersion string) templ.Component
- func PageDebug(morpheusVersion string) templ.Component
- func PageDebugBorders(morpheusVersion string) templ.Component
- func PageDialog(morpheusVersion string) templ.Component
- func PageDoc(currentPath, title, morpheusVersion string) templ.Component
- func PageDrawer(morpheusVersion string) templ.Component
- func PageElastic(morpheusVersion string) templ.Component
- func PageFrameworks(morpheusVersion string) templ.Component
- func PageGettingStarted(morpheusVersion string) templ.Component
- func PageIcon(morpheusVersion string) templ.Component
- func PageIndex(morpheusVersion string) templ.Component
- func PageInputGroup(morpheusVersion string) templ.Component
- func PageKbd(morpheusVersion string) templ.Component
- func PageKeys(morpheusVersion string) templ.Component
- func PageLayout(morpheusVersion string) templ.Component
- func PageLightbox(morpheusVersion string) templ.Component
- func PageLink(morpheusVersion string) templ.Component
- func PageMenu(morpheusVersion string) templ.Component
- func PageNavgroup(morpheusVersion string) templ.Component
- func PageOptgroup(morpheusVersion string) templ.Component
- func PageOption(morpheusVersion string) templ.Component
- func PagePagination(morpheusVersion string) templ.Component
- func PagePersist(morpheusVersion string) templ.Component
- func PagePopover(morpheusVersion string) templ.Component
- func PageProgress(morpheusVersion string) templ.Component
- func PageProjectStatus(morpheusVersion string) templ.Component
- func PageRadioGroup(morpheusVersion string) templ.Component
- func PageRating(morpheusVersion string) templ.Component
- func PageResizable(morpheusVersion string) templ.Component
- func PageRevealable(morpheusVersion string) templ.Component
- func PageSelect(morpheusVersion string) templ.Component
- func PageServerDriven(morpheusVersion string) templ.Component
- func PageSidebar(morpheusVersion string) templ.Component
- func PageSkeleton(morpheusVersion string) templ.Component
- func PageSlider(morpheusVersion string) templ.Component
- func PageSliderRange(morpheusVersion string) templ.Component
- func PageSortable(morpheusVersion string) templ.Component
- func PageSpinner(morpheusVersion string) templ.Component
- func PageSwitch(morpheusVersion string) templ.Component
- func PageTabs(morpheusVersion string) templ.Component
- func PageTextInput(morpheusVersion string) templ.Component
- func PageTextarea(morpheusVersion string) templ.Component
- func PageTheming(morpheusVersion string) templ.Component
- func PageToaster(morpheusVersion string) templ.Component
- func PageToggle(morpheusVersion string) templ.Component
- func PageToggleGroup(morpheusVersion string) templ.Component
- func PageTooltip(morpheusVersion string) templ.Component
- func PageTree(morpheusVersion string) templ.Component
- func Playground(opts PlaygroundOpts) templ.Component
- func SetInlineThemeDefaultCSS(css string)
- func W3CEventURL(name string) string
- type Assignee
- type BoundaryScopes
- type BundleManifestEntry
- type ComponentDoc
- type DemoFrameOpts
- type DocAttribute
- type DocCSSProp
- type DocEvent
- type DocPart
- type DocSlot
- type DocState
- type LazyNode
- type Member
- type NavLink
- type PlaygroundOpts
- type PlaygroundState
Constants ¶
This section is empty.
Variables ¶
var ComponentLinks = []NavLink{ {href.PageAlert(), "Alert"}, {href.PageAvatar(), "Avatar"}, {href.PageAvatars(), "Avatars"}, {href.PageBadge(), "Badge"}, {href.PageBreadcrumb(), "Breadcrumb"}, {href.PageButton(), "Button"}, {href.PageButtonGroup(), "Button group"}, {href.PageCard(), "Card"}, {href.PageCarousel(), "Carousel"}, {href.PageCheckbox(), "Checkbox"}, {href.PageClipcopy(), "Clipcopy"}, {href.PageCombobox(), "Combobox"}, {href.PageContextMenu(), "Context menu"}, {href.PageColorField(), "Color field"}, {href.PageDialog(), "Dialog"}, {href.PageDrawer(), "Drawer"}, {href.PageElastic(), "Elastic"}, {href.PageIcon(), "Icon"}, {href.PageInputGroup(), "Input group"}, {href.PageKbd(), "Kbd"}, {href.PageLayout(), "Layout"}, {href.PageLightbox(), "Lightbox"}, {href.PageLink(), "Link"}, {href.PageMenu(), "Menu"}, {href.PageNavgroup(), "Navgroup"}, {href.PagePagination(), "Pagination"}, {href.PagePopover(), "Popover"}, {href.PageProgress(), "Progress"}, {href.PageRadioGroup(), "Radio group"}, {href.PageRating(), "Rating"}, {href.PageResizable(), "Resizable"}, {href.PageRevealable(), "Revealable"}, {href.PageSelect(), "Select"}, {href.PageSidebar(), "Sidebar"}, {href.PageSkeleton(), "Skeleton"}, {href.PageSlider(), "Slider"}, {href.PageSliderRange(), "Slider range"}, {href.PageSortable(), "Sortable"}, {href.PageSpinner(), "Spinner"}, {href.PageSwitch(), "Switch"}, {href.PageTabs(), "Tabs"}, {href.PageTextInput(), "Text input"}, {href.PageTextarea(), "Textarea"}, {href.PageToaster(), "Toaster"}, {href.PageToggle(), "Toggle"}, {href.PageToggleGroup(), "Toggle group"}, {href.PageTooltip(), "Tooltip"}, {href.PageTree(), "Tree"}, }
ComponentLinks lists all per-component pages in the order they appear in the sidebar. Adding a new <neo-X> page is a two-step:
- Create page_X.go + page_X.templ that follow the existing pattern (`Page<Name>` struct + `pageX()` template wrapped in `@appLayout("/x")`).
- Append the entry here so the sidebar surfaces it.
var DataLinks = []NavLink{ {href.PageOption(), "Option"}, {href.PageOptgroup(), "Optgroup"}, {href.PageDatalist(), "Datalist"}, }
DataLinks lists the data components: elements that only carry option data for a control to read. They render nothing and have no behavior of their own, which sets them apart from the headless-but-functional UtilityLinks.
var LazyTreeData = []LazyNode{ {Path: "src", Label: "src", Children: []LazyNode{ {Path: "src/components", Label: "components", Children: []LazyNode{ {Path: "src/components/Button.tsx", Label: "Button.tsx"}, {Path: "src/components/Card.tsx", Label: "Card.tsx"}, {Path: "src/components/Modal.tsx", Label: "Modal.tsx"}, }}, {Path: "src/hooks", Label: "hooks", Children: []LazyNode{ {Path: "src/hooks/useDebounce.ts", Label: "useDebounce.ts"}, {Path: "src/hooks/useMediaQuery.ts", Label: "useMediaQuery.ts"}, }}, {Path: "src/App.tsx", Label: "App.tsx"}, }}, {Path: "docs", Label: "docs", Children: []LazyNode{ {Path: "docs/intro.md", Label: "intro.md"}, {Path: "docs/guide", Label: "guide", Children: []LazyNode{ {Path: "docs/guide/setup.md", Label: "setup.md"}, {Path: "docs/guide/usage.md", Label: "usage.md"}, }}, {Path: "docs/api.md", Label: "api.md"}, }}, {Path: "tests", Label: "tests", Children: []LazyNode{ {Path: "tests/unit", Label: "unit", Children: []LazyNode{ {Path: "tests/unit/parser.test.ts", Label: "parser.test.ts"}, {Path: "tests/unit/router.test.ts", Label: "router.test.ts"}, }}, {Path: "tests/integration.test.ts", Label: "integration.test.ts"}, }}, }
var SectionLinks = []NavLink{ {href.PageGettingStarted(), "Getting started"}, {href.PageFrameworks(), "Frameworks"}, {href.PageTheming(), "Theming"}, {href.PageServerDriven(), "Server-driven architecture"}, {href.PageProjectStatus(), "Status & Contribution"}, }
var UtilityLinks = []NavLink{ {href.PageBoundary(), "Boundary"}, {href.PageCondition(), "Condition"}, {href.PageKeys(), "Keys"}, {href.PagePersist(), "Persist"}, }
Functions ¶
func ComponentDocs ¶
func ComponentDocs(doc ComponentDoc) templ.Component
func ComponentLink ¶
func LandingPage ¶
LandingPage is the bare marketing-style shell: same head as Page, but no sidebar frame, breadcrumb header, or settings panel.
func PageAvatar ¶
func PageAvatars ¶
func PageBoundary ¶
func PageBreadcrumb ¶
func PageBundleBuilder ¶
func PageButton ¶
func PageButtonGroup ¶
func PageCarousel ¶
func PageCheckbox ¶
func PageClipcopy ¶
func PageColorField ¶
func PageCombobox ¶
func PageComponents ¶
func PageCondition ¶
func PageContextMenu ¶
func PageDatalist ¶
func PageDebug ¶
PageDebug: hidden /debug/ harness, full-page fat morph every 2s. Verifies popover-hosted components stay open + keep focus across morph cycles. Simulator + injected trigger carry data-ignore-morph so they survive each patch. Not linked from navigation.
func PageDebugBorders ¶
PageDebugBorders: hidden /debug-borders/ harness for visually auditing border width/color consistency across every bordered control, standalone and composed inside input groups. Custom top bar flips theme, color mode, and high contrast so the same grid can be compared across every combination. Not linked from navigation.
func PageDialog ¶
func PageDoc ¶
PageDoc wraps Page with docs-specific frame so a single edit ripples to every doc page. Non-doc shells (LandingPage, …) keep using Page directly.
func PageDrawer ¶
func PageElastic ¶
func PageFrameworks ¶
func PageGettingStarted ¶
func PageInputGroup ¶
func PageLayout ¶
func PageLightbox ¶
func PageNavgroup ¶
func PageOptgroup ¶
func PageOption ¶
func PagePagination ¶
func PagePersist ¶
func PagePopover ¶
func PageProgress ¶
func PageProjectStatus ¶
func PageRadioGroup ¶
func PageRating ¶
func PageResizable ¶
func PageRevealable ¶
func PageSelect ¶
func PageServerDriven ¶
func PageSidebar ¶
func PageSkeleton ¶
func PageSlider ¶
func PageSliderRange ¶
func PageSortable ¶
func PageSpinner ¶
func PageSwitch ¶
func PageTextInput ¶
func PageTextarea ¶
func PageTheming ¶
func PageToaster ¶
func PageToggle ¶
func PageToggleGroup ¶
func PageTooltip ¶
func Playground ¶
func Playground(opts PlaygroundOpts) templ.Component
Playground renders the reusable component-doc playground shell. State templates are trusted docs source and become editable in-page.
func SetInlineThemeDefaultCSS ¶
func SetInlineThemeDefaultCSS(css string)
SetInlineThemeDefaultCSS sets the CSS [pageHead] inlines in place of the theme-default.css <link>. internal/cmd/gen calls it with the built min/theme-default.css before rendering pages.
func W3CEventURL ¶
Types ¶
type BoundaryScopes ¶
DemoFrameOpts configures demoFrameWith, the wrapper every per-page demo composes around its content. BoundaryScopes tunes the <neo-boundary> scopes on a preview region. The zero value keeps the default scopes (dismiss + positioning) and renders no attribute. Any non-zero field renders an explicit scope="…" token list: NoDismiss / NoPositioning drop a default scope, Scroll / Stacking add an opt-in one. See the Boundary page.
type BundleManifestEntry ¶
type BundleManifestEntry struct {
ID string `json:"id"`
Name string `json:"name"`
Bound bool `json:"bound"`
// JS is the TypeScript module filename under static/bundle-src/
// (e.g. "neo-button.ts"), or "" when the node has no module.
JS string `json:"js"`
// CSS is the stylesheet module filename under static/bundle-css/.
CSS string `json:"css"`
// Owners (bound nodes only) are the selectable ids that pull this
// node in; it's in the bundle when any owner is selected. Mirrors
// the graph's bundleSpanDisabled rule.
Owners []string `json:"owners,omitempty"`
}
BundleManifestEntry is one row of dst/static/bundle-manifest.json, consumed by static/min/bundlebuilder.min.js to assemble the selected bundle in the browser.
func BundleManifestEntries ¶
func BundleManifestEntries() []BundleManifestEntry
BundleManifestEntries is the full node set with the asset wiring the in-browser builder needs. Order matches bundleNodes (sorted).
type ComponentDoc ¶
type ComponentDoc struct {
// Prefix namespaces the per-section anchored h3 ids when more than
// one ComponentDoc renders on the same page (e.g. menu / menuitem /
// submenu on /menu/). Empty Prefix yields "attributes" / "slots" /
// "events"; a non-empty Prefix yields "<prefix>-attributes" etc.
Prefix string
Attributes []DocAttribute
States []DocState
Slots []DocSlot
Events []DocEvent
Parts []DocPart
CSSProps []DocCSSProp
}
type DemoFrameOpts ¶
type DemoFrameOpts struct {
Width string
Height string
StageMinHeight string
StageMaxHeight string
StageMinWidth string
StageMaxWidth string
StageClass string
StageHandles neo.ResizableHandles
// Boundary opts out of individual <neo-boundary> scopes for the
// stage's overlays (default: all scopes on).
Boundary BoundaryScopes
// StageAttrs is the escape hatch for stage attributes the dedicated
// fields above don't cover (e.g. data-attr:width, min-width).
StageAttrs templ.Attributes
// HTMLSource / TemplSource non-empty adds source tabs to the footer.
HTMLSource string
TemplSource string
CSSSource string
// TSXSource / TypeScriptSource add React (.tsx) and ambient-types
// (.ts) tabs, used by the framework-integration pages.
TSXSource string
TypeScriptSource string
// ScriptSource is typically embedded from the .js module the page
// also loads at runtime so the tab can't drift from reality.
ScriptSource string
// DefaultTab overrides which footer tab opens first (e.g. "tsx").
// Empty starts the demo collapsed on the "hide" tab.
DefaultTab string
}
type DocAttribute ¶
type DocAttribute struct {
Name string
Type string
Default string
// Reflected marks an attribute the component writes back to the DOM
// as its state changes (internal -> attribute). Observed marks one the
// component reacts to when changed from outside, e.g. author, morph, or
// framework binding (attribute -> internal). Independent: an attribute
// can be both, either, or neither. Each renders a badge in the Type
// column.
Reflected bool
Observed bool
Description templ.Component
}
type DocCSSProp ¶
DocCSSProp documents a CSS custom property the component reads. Name is the full property (e.g. "--neo-card-gap"); Default is the fallback value.
type DocPart ¶
DocPart documents a shadow ::part() exposed for page CSS. Name is the bare part name; it renders as ::part(<Name>).
type DocState ¶
DocState documents a CSS custom state the component sets on itself as its internal state changes. Name is the bare state name; it renders as :state(<Name>). States are not attributes: nothing outside the component sets them, and a morph cannot strip them.
type PlaygroundOpts ¶
type PlaygroundOpts struct {
ID string
// Height is optional. An empty value tracks preview content until
// the user resizes the viewport. The playground is always full
// content width; the preview stage is resizable from its edges.
Height neo.CSSUnit
// MinWidth sets the preview stage's minimum width (the resizable's
// left/right drag lower bound). Empty defaults to "14rem"; raise it for
// components that need room to stay legible when dragged narrow (e.g. a
// sidebar shell).
MinWidth neo.CSSUnit
States []PlaygroundState
// Autoplay starts cycling through enabled states on connect (once in
// view). Off by default; the user can still opt in via the toolbar.
Autoplay bool
// Boundary opts out of individual <neo-boundary> scopes for the
// preview's overlays (default: all scopes on).
Boundary BoundaryScopes
}
type PlaygroundState ¶
Source Files
¶
- alert_demo.go
- avatar_demo.go
- avatars_demo.go
- badge_demo.go
- boundary_demo.go
- breadcrumb_demo.go
- bundle_manifest.go
- button_demo.go
- buttongroup_demo.go
- card_demo.go
- carousel_demo.go
- checkbox_demo.go
- clipcopy_demo.go
- color_field_demo.go
- combobox_async_demo.go
- combobox_demo.go
- component_docs.go
- component_docs_templ.go
- component_link_templ.go
- condition_demo.go
- contextmenu_demo.go
- data.go
- dialog_demo.go
- drawer_async_demo.go
- drawer_demo.go
- elastic_demo.go
- example_source.go
- frameworks_demo.go
- getting_started_demo.go
- icon_demo.go
- input_group_demo.go
- kbd_demo.go
- keys_demo.go
- landing_suggest.go
- layout_demo.go
- lightbox_demo.go
- link_demo.go
- menu_demo.go
- navgroup_demo.go
- page_alert_templ.go
- page_avatar_templ.go
- page_avatars_templ.go
- page_badge_templ.go
- page_boundary_templ.go
- page_breadcrumb_templ.go
- page_bundle_builder.go
- page_bundle_builder_templ.go
- page_button_templ.go
- page_buttongroup_templ.go
- page_card_templ.go
- page_carousel_templ.go
- page_checkbox_templ.go
- page_clipcopy_templ.go
- page_color_field_templ.go
- page_combobox_templ.go
- page_components_templ.go
- page_condition_templ.go
- page_contextmenu_templ.go
- page_datalist.go
- page_datalist_templ.go
- page_debug_borders_templ.go
- page_debug_templ.go
- page_dialog_templ.go
- page_drawer_templ.go
- page_elastic_templ.go
- page_frameworks_templ.go
- page_getting_started_templ.go
- page_icon_templ.go
- page_index_templ.go
- page_input_group_templ.go
- page_kbd_templ.go
- page_keys_templ.go
- page_layout_templ.go
- page_lightbox_templ.go
- page_link_templ.go
- page_menu_templ.go
- page_navgroup_templ.go
- page_optgroup_templ.go
- page_option_templ.go
- page_pagination_templ.go
- page_persist_templ.go
- page_popover_templ.go
- page_progress_templ.go
- page_project_status_templ.go
- page_radio_group_templ.go
- page_rating_templ.go
- page_resizable_templ.go
- page_revealable_templ.go
- page_select_templ.go
- page_server_driven_templ.go
- page_sidebar_templ.go
- page_skeleton_templ.go
- page_slider_range_templ.go
- page_slider_templ.go
- page_sortable_templ.go
- page_spinner_templ.go
- page_switch_templ.go
- page_tabs_templ.go
- page_text_input_templ.go
- page_textarea_templ.go
- page_theming_templ.go
- page_toaster_templ.go
- page_toggle_group_templ.go
- page_toggle_templ.go
- page_tooltip_templ.go
- page_tree_templ.go
- pagination_demo.go
- persist_demo.go
- playground.go
- playground_templ.go
- popover_async_demo.go
- popover_demo.go
- progress_demo.go
- radio_group_demo.go
- rating_demo.go
- react_demo.go
- resizable_demo.go
- revealable_demo.go
- select_async_demo.go
- select_demo.go
- server_driven_demo.go
- sidebar_demo.go
- site.go
- site_templ.go
- skeleton_demo.go
- slider_demo.go
- slider_range_demo.go
- sortable_demo.go
- spinner_demo.go
- switch_demo.go
- tabs_demo.go
- text_input_demo.go
- textarea_demo.go
- theme_inline.go
- theming.go
- toaster_demo.go
- toggle_demo.go
- toggle_group_demo.go
- tooltip_demo.go
- tree_demo.go