Skip to content
ui8kit

primitive / kit

Kit Box

UI8Kit 3 Box primitive (unstyled), from @ui8kit/registry

Install

npx ui8kit add kit-box

Pulls in: kit-slot, utils

Preview

No static preview for this item: it needs content or a parent that this page cannot supply. The code is below.

Code

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework svelte --dir src --registry-url https://registry.buildy.tw/svelte --strict-cdn
npx ui8kit add kit-box
kit/ui/box/Box.svelte
<!-- Code generated by @ui8kit/codegen. DO NOT EDIT. -->
<!--
  Box renders the requested structural HTML element (default div).
-->
<script lang="ts" module>
  import type { Snippet } from "svelte";

  export type BoxProps = {
    tag?: "div" | "section" | "article" | "aside" | "header" | "footer" | "main" | "nav" | "figure" | "search" | "ul" | "ol" | "li" | "dl" | "dt" | "dd" | "fieldset" | "table" | "thead" | "tbody" | "tfoot" | "tr" | "th" | "td" | "caption" | "colgroup" | "col";
    class?: string;
    children?: Snippet;
    [key: string]: unknown;
  };
</script>

<script lang="ts">
  import { boxClasses } from "./box.shared";
  import { safeRest } from "../../utils/expr";
  import { resolveTag, TagGroup } from "../../utils/tags";

  let {
    tag,
    class: className,
    children,
    ...rawRest
  }: BoxProps = $props();

  const rest = $derived(safeRest(rawRest));
  const cls = $derived(boxClasses({ className }));
  const resolvedTagValue = $derived(resolveTag(tag, "div", TagGroup.Box));
</script>

<svelte:element this={resolvedTagValue} {...(cls ? { class: cls } : {})} {...rest}>
  {@render children?.()}
</svelte:element>
kit/ui/box/box.shared.ts
// Code generated by @ui8kit/codegen. DO NOT EDIT.
// ui.box — shared TypeScript contract (types + classes helpers)

import { cn } from "../../utils";

/** Box renders the requested structural HTML element (default div). */
export type BoxBaseProps = {
  tag?: "div" | "section" | "article" | "aside" | "header" | "footer" | "main" | "nav" | "figure" | "search" | "ul" | "ol" | "li" | "dl" | "dt" | "dd" | "fieldset" | "table" | "thead" | "tbody" | "tfoot" | "tr" | "th" | "td" | "caption" | "colgroup" | "col";
};

export type BoxClassesInput = {
  className?: string;
};

/** Compose Box classes without rendering — the cross-runtime `asChild` substitute. */
export function boxClasses(input: BoxClassesInput = {}): string {
  return cn(input.className);
}

Svelte registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework react --dir src --registry-url https://registry.buildy.tw/react --strict-cdn
npx ui8kit add kit-box
kit/ui/box/box.shared.ts
// Code generated by @ui8kit/codegen. DO NOT EDIT.
// ui.box — shared TypeScript contract (types + classes helpers)

import { cn } from "../../utils";

/** Box renders the requested structural HTML element (default div). */
export type BoxBaseProps = {
  tag?: "div" | "section" | "article" | "aside" | "header" | "footer" | "main" | "nav" | "figure" | "search" | "ul" | "ol" | "li" | "dl" | "dt" | "dd" | "fieldset" | "table" | "thead" | "tbody" | "tfoot" | "tr" | "th" | "td" | "caption" | "colgroup" | "col";
};

export type BoxClassesInput = {
  className?: string;
};

/** Compose Box classes without rendering — the cross-runtime `asChild` substitute. */
export function boxClasses(input: BoxClassesInput = {}): string {
  return cn(input.className);
}
kit/ui/box/box.tsx
// Code generated by @ui8kit/codegen. DO NOT EDIT.
/**
 * Box is the polymorphic structural primitive. `tag` accepts HTML5 structural
 * elements only (sections, lists, tables, fieldset); anything else falls back to div.
 * Forms use the Form primitive (Box no longer accepts `form`).
 */

import { forwardRef, type ReactNode, type HTMLAttributes, type ElementType, type Ref } from "react";
import { boxClasses } from "./box.shared";
import { safeRest } from "../../utils/expr";
import { resolveTag, TagGroup } from "../../utils/tags";
import { Slot } from "../slot/slot";

/**
 * Box renders the requested structural HTML element (default div).
 */
export type BoxProps = Omit<HTMLAttributes<HTMLElement>, "className" | "children" | "tag"> & {
  tag?: "div" | "section" | "article" | "aside" | "header" | "footer" | "main" | "nav" | "figure" | "search" | "ul" | "ol" | "li" | "dl" | "dt" | "dd" | "fieldset" | "table" | "thead" | "tbody" | "tfoot" | "tr" | "th" | "td" | "caption" | "colgroup" | "col";
  className?: string;
  children?: ReactNode;
  asChild?: boolean;
};

export const Box = forwardRef<HTMLElement, BoxProps>(function Box(
  { tag, className, children, asChild, ...rawRest },
  ref
) {
  const rest = safeRest(rawRest);
  const cls = boxClasses({ className });
  const resolvedTagValue = resolveTag(tag, "div", TagGroup.Box);
  const Tag = resolvedTagValue as ElementType;
  if (asChild) {
    return (
      <Slot ref={ref} className={cls} {...rest}>
        {children}
      </Slot>
    );
  }
  return (
    <Tag ref={ref as Ref<HTMLElement>} className={cls || undefined} {...rest}>
      {children}
    </Tag>
  );
});
Box.displayName = "Box";

React registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework vue --dir src --registry-url https://registry.buildy.tw/vue --strict-cdn
npx ui8kit add kit-box
kit/ui/box/Box.vue
<!-- Code generated by @ui8kit/codegen. DO NOT EDIT. -->
<!--
  Box renders the requested structural HTML element (default div).
-->
<script setup lang="ts">
import { computed, useAttrs } from "vue";
import { boxClasses } from "./box.shared";
import { safeRest } from "../../utils/expr";
import { resolveTag, TagGroup } from "../../utils/tags";

defineOptions({ name: "Box", inheritAttrs: false });

const props = defineProps<{
  tag?: "div" | "section" | "article" | "aside" | "header" | "footer" | "main" | "nav" | "figure" | "search" | "ul" | "ol" | "li" | "dl" | "dt" | "dd" | "fieldset" | "table" | "thead" | "tbody" | "tfoot" | "tr" | "th" | "td" | "caption" | "colgroup" | "col";
}>();

const attrs = useAttrs();
const callerClass = computed(() => attrs.class as string | undefined);
const restAttrs = computed(() => {
  const { class: _class, ...restEntries } = attrs;
  return safeRest(restEntries);
});
const cls = computed(() => boxClasses({ className: callerClass.value }));
const resolvedTagValue = computed(() => resolveTag(props.tag, "div", TagGroup.Box));
</script>

<template>
  <component :is="resolvedTagValue" :class="cls || undefined" v-bind="restAttrs">
    <slot />
  </component>
</template>
kit/ui/box/box.shared.ts
// Code generated by @ui8kit/codegen. DO NOT EDIT.
// ui.box — shared TypeScript contract (types + classes helpers)

import { cn } from "../../utils";

/** Box renders the requested structural HTML element (default div). */
export type BoxBaseProps = {
  tag?: "div" | "section" | "article" | "aside" | "header" | "footer" | "main" | "nav" | "figure" | "search" | "ul" | "ol" | "li" | "dl" | "dt" | "dd" | "fieldset" | "table" | "thead" | "tbody" | "tfoot" | "tr" | "th" | "td" | "caption" | "colgroup" | "col";
};

export type BoxClassesInput = {
  className?: string;
};

/** Compose Box classes without rendering — the cross-runtime `asChild` substitute. */
export function boxClasses(input: BoxClassesInput = {}): string {
  return cn(input.className);
}

Vue registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework solid --dir src --registry-url https://registry.buildy.tw/solid --strict-cdn
npx ui8kit add kit-box
kit/ui/box/box.shared.ts
// Code generated by @ui8kit/codegen. DO NOT EDIT.
// ui.box — shared TypeScript contract (types + classes helpers)

import { cn } from "../../utils";

/** Box renders the requested structural HTML element (default div). */
export type BoxBaseProps = {
  tag?: "div" | "section" | "article" | "aside" | "header" | "footer" | "main" | "nav" | "figure" | "search" | "ul" | "ol" | "li" | "dl" | "dt" | "dd" | "fieldset" | "table" | "thead" | "tbody" | "tfoot" | "tr" | "th" | "td" | "caption" | "colgroup" | "col";
};

export type BoxClassesInput = {
  className?: string;
};

/** Compose Box classes without rendering — the cross-runtime `asChild` substitute. */
export function boxClasses(input: BoxClassesInput = {}): string {
  return cn(input.className);
}
kit/ui/box/box.solid.tsx
// Code generated by @ui8kit/codegen. DO NOT EDIT.
/**
 * Box is the polymorphic structural primitive. `tag` accepts HTML5 structural
 * elements only (sections, lists, tables, fieldset); anything else falls back to div.
 * Forms use the Form primitive (Box no longer accepts `form`).
 */

import { splitProps, type JSX, type Component } from "solid-js";
import { Dynamic } from "solid-js/web";
import { boxClasses } from "./box.shared";
import { safeRest } from "../../utils/expr";
import { resolveTag, TagGroup } from "../../utils/tags";

/**
 * Box renders the requested structural HTML element (default div).
 */
export type BoxProps = Omit<JSX.HTMLAttributes<HTMLElement>, "class" | "className" | "children" | "tag"> & {
  tag?: "div" | "section" | "article" | "aside" | "header" | "footer" | "main" | "nav" | "figure" | "search" | "ul" | "ol" | "li" | "dl" | "dt" | "dd" | "fieldset" | "table" | "thead" | "tbody" | "tfoot" | "tr" | "th" | "td" | "caption" | "colgroup" | "col";
  class?: string;
  className?: string;
  children?: JSX.Element;
};

export const Box: Component<BoxProps> = (props) => {
  const [local, rest] = splitProps(props, ["tag", "class", "className", "children"]);
  const resolvedTagValue = () => resolveTag(local.tag, "div", TagGroup.Box);
  const cls = () => boxClasses({ className: local.class ?? local.className });
  return (
    <Dynamic component={resolvedTagValue()} {...(cls() ? { class: cls() } : {})} {...safeRest(rest)}>
      {local.children}
    </Dynamic>
  );
};

Solid registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework templ --dir src --registry-url https://registry.buildy.tw/templ --strict-cdn
npx ui8kit add kit-box
ui/box/box.templ
// Code generated by @ui8kit/codegen. DO NOT EDIT.

/*
Box is the polymorphic structural primitive. `tag` accepts HTML5 structural
elements only (sections, lists, tables, fieldset); anything else falls back to div.
Forms use the Form primitive (Box no longer accepts `form`).
*/

package box

import (
	uiutils "github.com/ui8kit/codegen/generated/templ/utils"
)

// BoxProps configures Box.
type BoxProps struct {
	// Class — token class names supplied by the consumer
	Class string
	// Tag — HTML5 structural tag (default div)
	Tag string
	Attrs templ.Attributes
}

// BoxClasses composes Box classes without rendering —
// the server-composition escape hatch for custom root elements (no asChild in templ).
func BoxClasses(p BoxProps) string {
	return uiutils.Cn(p.Class)
}

// Box renders the Box contract.
templ Box(p BoxProps) {
	switch uiutils.ResolveTag(p.Tag, "div", uiutils.TagGroupBox) {
	case "section":
		<section
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</section>
	case "article":
		<article
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</article>
	case "aside":
		<aside
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</aside>
	case "header":
		<header
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</header>
	case "footer":
		<footer
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</footer>
	case "main":
		<main
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</main>
	case "nav":
		<nav
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</nav>
	case "figure":
		<figure
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</figure>
	case "search":
		<search
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</search>
	case "ul":
		<ul
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</ul>
	case "ol":
		<ol
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</ol>
	case "li":
		<li
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</li>
	case "dl":
		<dl
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</dl>
	case "dt":
		<dt
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</dt>
	case "dd":
		<dd
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</dd>
	case "fieldset":
		<fieldset
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</fieldset>
	case "table":
		<table
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</table>
	case "thead":
		<thead
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</thead>
	case "tbody":
		<tbody
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</tbody>
	case "tfoot":
		<tfoot
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</tfoot>
	case "tr":
		<tr
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</tr>
	case "th":
		<th
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</th>
	case "td":
		<td
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</td>
	case "caption":
		<caption
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</caption>
	case "colgroup":
		<colgroup
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</colgroup>
	case "col":
		<col
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</col>
	default:
		<div
			if BoxClasses(p) != "" {
				class={ BoxClasses(p) }
			}
			{ uiutils.RestAttrs(p.Attrs, false)... }
		>
			{ children... }
		</div>
	}
}

templ registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework twig --dir src --registry-url https://registry.buildy.tw/twig --strict-cdn
npx ui8kit add kit-box
ui/box/Box.html.twig
{# Code generated by @ui8kit/codegen. DO NOT EDIT. #}
{# Box — Box renders the requested structural HTML element (default div). #}
{# @param class (string) #}
{# @param tag (string) #}
{# @param attrs (attrs) #}
{# @param children (children) #}
{% set class = class|default('') %}
{% set tag = tag|default('') %}
{% set attrs = attrs|default([]) %}
{% set children = children|default('') %}
{% set uiTag = ui8kit_resolve_tag(tag, 'div', 'Box') %}
{% if (uiTag is same as('section')) %}<section{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</section>{% elseif (uiTag is same as('article')) %}<article{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</article>{% elseif (uiTag is same as('aside')) %}<aside{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</aside>{% elseif (uiTag is same as('header')) %}<header{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</header>{% elseif (uiTag is same as('footer')) %}<footer{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</footer>{% elseif (uiTag is same as('main')) %}<main{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</main>{% elseif (uiTag is same as('nav')) %}<nav{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</nav>{% elseif (uiTag is same as('figure')) %}<figure{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</figure>{% elseif (uiTag is same as('search')) %}<search{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</search>{% elseif (uiTag is same as('ul')) %}<ul{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</ul>{% elseif (uiTag is same as('ol')) %}<ol{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</ol>{% elseif (uiTag is same as('li')) %}<li{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</li>{% elseif (uiTag is same as('dl')) %}<dl{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</dl>{% elseif (uiTag is same as('dt')) %}<dt{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</dt>{% elseif (uiTag is same as('dd')) %}<dd{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</dd>{% elseif (uiTag is same as('fieldset')) %}<fieldset{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</fieldset>{% elseif (uiTag is same as('table')) %}<table{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</table>{% elseif (uiTag is same as('thead')) %}<thead{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</thead>{% elseif (uiTag is same as('tbody')) %}<tbody{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</tbody>{% elseif (uiTag is same as('tfoot')) %}<tfoot{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</tfoot>{% elseif (uiTag is same as('tr')) %}<tr{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</tr>{% elseif (uiTag is same as('th')) %}<th{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</th>{% elseif (uiTag is same as('td')) %}<td{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</td>{% elseif (uiTag is same as('caption')) %}<caption{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</caption>{% elseif (uiTag is same as('colgroup')) %}<colgroup{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</colgroup>{% elseif (uiTag is same as('col')) %}<col{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{% else %}<div{{ ui8kit_attrs({'class': ui8kit_or_null(ui8kit_classes('boxClasses', {'class': class, 'tag': tag}))}, attrs) }}>{{ children|raw }}</div>{% endif %}

Twig registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework latte --dir src --registry-url https://registry.buildy.tw/latte --strict-cdn
npx ui8kit add kit-box
ui/box/Box.latte
{* Code generated by @ui8kit/codegen. DO NOT EDIT. *}
{* Box — Box renders the requested structural HTML element (default div). *}
{parameters
  string $class = '',
  string $tag = '',
  array $attrs = [],
  string $children = '',
}
{var $uiTag = \UI8Kit\Latte\Rt::resolveTag($tag, 'div', 'Box')}
{if ($uiTag === 'section')}<section n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</section>{elseif ($uiTag === 'article')}<article n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</article>{elseif ($uiTag === 'aside')}<aside n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</aside>{elseif ($uiTag === 'header')}<header n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</header>{elseif ($uiTag === 'footer')}<footer n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</footer>{elseif ($uiTag === 'main')}<main n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</main>{elseif ($uiTag === 'nav')}<nav n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</nav>{elseif ($uiTag === 'figure')}<figure n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</figure>{elseif ($uiTag === 'search')}<search n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</search>{elseif ($uiTag === 'ul')}<ul n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</ul>{elseif ($uiTag === 'ol')}<ol n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</ol>{elseif ($uiTag === 'li')}<li n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</li>{elseif ($uiTag === 'dl')}<dl n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</dl>{elseif ($uiTag === 'dt')}<dt n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</dt>{elseif ($uiTag === 'dd')}<dd n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</dd>{elseif ($uiTag === 'fieldset')}<fieldset n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</fieldset>{elseif ($uiTag === 'table')}<table n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</table>{elseif ($uiTag === 'thead')}<thead n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</thead>{elseif ($uiTag === 'tbody')}<tbody n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</tbody>{elseif ($uiTag === 'tfoot')}<tfoot n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</tfoot>{elseif ($uiTag === 'tr')}<tr n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</tr>{elseif ($uiTag === 'th')}<th n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</th>{elseif ($uiTag === 'td')}<td n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</td>{elseif ($uiTag === 'caption')}<caption n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</caption>{elseif ($uiTag === 'colgroup')}<colgroup n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</colgroup>{elseif ($uiTag === 'col')}<col n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{else}<div n:attr="[
  'class' => \UI8Kit\Latte\Rt::orNull(\UI8Kit\Latte\Classes::boxClasses(['class' => $class, 'tag' => $tag])),
  ...\UI8Kit\Latte\Rt::restAttrs($attrs),
]">{$children|noescape}</div>{/if}

Latte registry item (JSON)

Point the CLI at this runtime once, then add the item:

npx ui8kit init --yes --framework jinja2 --dir src --registry-url https://registry.buildy.tw/jinja2 --strict-cdn
npx ui8kit add kit-box
ui/box/box.html.j2
{#- Code generated by @ui8kit/codegen. DO NOT EDIT.
    Box: Box renders the requested structural HTML element (default div).
    Props (p): Class (string), Tag (string), Attrs (attrs), Children (children).
    children: TRUSTED HTML printed with |safe — never pass unescaped user input.
    Classes without rendering: box_classes(p) (no asChild in Jinja2). -#}
{%- set tag1 = ui_resolve_tag(ui_def(p['Tag'], ''), 'div', ['div', 'section', 'article', 'aside', 'header', 'footer', 'main', 'nav', 'figure', 'search', 'ul', 'ol', 'li', 'dl', 'dt', 'dd', 'fieldset', 'table', 'thead', 'tbody', 'tfoot', 'tr', 'th', 'td', 'caption', 'colgroup', 'col']) %}<{{ tag1 }}
  {%- with cls = box_classes(p) %}{%- if cls %} class="{{ cls }}"{%- endif %}{%- endwith %}
  {{ ui_attr_html(ui_def(p['Attrs'], {})) }}
>{%- if not ui_is_void(tag1) %}{{ children|default('', true)|safe }}</{{ tag1 }}>{%- endif %}

Jinja2 registry item (JSON)

Props

Names and types come from the xgen specs of the source. Standard HTML attributes (id, role, tabIndex, aria-*) pass through to the root element; the class prop is className in React.

No props data for this item.