Faq Split
Questions beside the heading, a help card, a picture or a finder, or as cards in three or four columns.
Install
npx ui8kit add faq-splitPulls in: box, button, compose, faq-cards, faq-disclosures, faq-finder, faq-help, faq-list, feature-grid, kit-box, kit-button, media-frame, section-frame, utils
Preview
Questions, answered
The short version of what people ask us most.
How do I start a new site?
Pick a template, change the texts in one dictionary and publish. Most sites are live in an hour.
Can I use my own domain?
Yes. Point your domain at the site and we issue the certificate for you.
When am I billed?
On the same day each month. You can switch to yearly billing and save two months.
Do you give refunds?
Within 30 days of a payment, no questions asked.
How do I invite my team?
Open the settings, add their addresses and choose what each person can edit.
Can I take my content with me?
Every plan exports all pages and texts as plain files at any time.
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-cdnnpx ui8kit add faq-split<!-- Code generated by packages/kit-compose/src/organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT. -->
<!--
Questions in a split or as cards. Axes: layout (head: the heading and an action beside the disclosures, aside:
the disclosures beside a help card, media: the disclosures and an action beside a picture, search: a finder
beside a picture, cards: the questions as cards), cards (grid3, grid4, icons), mediaSide, tone.
-->
<script lang="ts" module>
import type { Snippet } from "svelte";
import type { Question, FaqSplitLabels } from "./faq-split.types";
import type { Feature } from "./feature-grid.types";
import type { FaqTab } from "./faq-list.types";
export type FaqSplitProps = {
id: string;
title: string;
lead?: string;
badge?: string;
items: Question[];
channels: Feature[];
topics: FaqTab[];
labels: FaqSplitLabels;
layout?: "head" | "aside" | "media" | "search" | "cards";
cards?: "grid3" | "grid4" | "icons";
mediaSide?: "end" | "start";
tone?: "default" | "muted";
image?: string;
imageAlt?: string;
landmarkLabel?: string;
};
</script>
<script lang="ts">
import Box from "../compose/Box.svelte";
import Button from "../compose/Button.svelte";
import FaqCards from "../components/faq-cards.svelte";
import FaqDisclosures from "../components/faq-disclosures.svelte";
import FaqFinder from "../components/faq-finder.svelte";
import FaqHelp from "../components/faq-help.svelte";
import MediaFrame from "../components/media-frame.svelte";
import SectionFrame from "../components/section-frame.svelte";
import { tpl } from "../utils";
let {
id,
title,
lead = "",
badge = "",
items,
channels,
topics,
labels,
layout = "head",
cards = "grid3",
mediaSide = "end",
tone = "default",
image,
imageAlt,
landmarkLabel,
}: FaqSplitProps = $props();
</script>
{#if ((items?.length ?? 0) > 0)}
{#if ((layout as string) === "cards")}
<SectionFrame id={id} title={title} lead={lead} heading={{ badge }} tone={tone} landmarkLabel={landmarkLabel}>
<FaqCards items={items} labels={labels} cards={cards} />
</SectionFrame>
{/if}
{#if ((layout as string) === "head")}
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: "end", align: "start" }}
landmarkLabel={landmarkLabel}
>
<Box>
<Button variant="default" size="default">
{labels.cta}
</Button>
</Box>
{#snippet aside()}
<FaqDisclosures items={items} name={tpl("{0}-faq", id)} />
{/snippet}
</SectionFrame>
{/if}
{#if ((layout as string) === "aside")}
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: "end", align: "start" }}
landmarkLabel={landmarkLabel}
>
<FaqDisclosures items={items} name={tpl("{0}-faq", id)} />
{#snippet aside()}
<FaqHelp labels={labels} channels={channels} landmarkLabel={landmarkLabel} />
{/snippet}
</SectionFrame>
{/if}
{#if ((layout as string) === "media")}
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: mediaSide, align: "start" }}
landmarkLabel={landmarkLabel}
>
<FaqDisclosures items={items} name={tpl("{0}-faq", id)} />
<Box>
<Button variant="default" size="default">
{labels.cta}
</Button>
</Box>
{#snippet aside()}
<MediaFrame alt={(imageAlt ? imageAlt : title)} src={image} ratio="4/3" />
{/snippet}
</SectionFrame>
{/if}
{#if ((layout as string) === "search")}
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: mediaSide }}
landmarkLabel={landmarkLabel}
>
<FaqFinder items={items} labels={labels} topics={topics} />
{#snippet aside()}
<MediaFrame alt={(imageAlt ? imageAlt : title)} src={image} ratio="4/3" />
{/snippet}
</SectionFrame>
{/if}
{/if}
// Code generated by packages/kit-compose/src/organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT.
export type Question = {
id: string;
question: string;
answer: string;
category: string;
icon: string;
href?: string;
};
export type FaqSplitLabels = {
cta: string;
more: string;
asideTitle: string;
asideText: string;
asideCta: string;
search: string;
popular: string;
query?: string;
};
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-cdnnpx ui8kit add faq-split// Code generated by packages/kit-compose/src/organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT.
/**
* Questions in a split or as cards. Axes: layout (head: the heading and an action beside the disclosures, aside:
* the disclosures beside a help card, media: the disclosures and an action beside a picture, search: a finder
* beside a picture, cards: the questions as cards), cards (grid3, grid4, icons), mediaSide, tone.
*/
import { type ReactNode } from "react";
import { Box, Button } from "../compose";
import { FaqCards } from "../components/faq-cards";
import { FaqDisclosures } from "../components/faq-disclosures";
import { FaqFinder } from "../components/faq-finder";
import { FaqHelp } from "../components/faq-help";
import { MediaFrame } from "../components/media-frame";
import { SectionFrame } from "../components/section-frame";
import { tpl } from "../utils";
import type { Question, FaqSplitLabels } from "./faq-split.types";
import type { Feature } from "./feature-grid.types";
import type { FaqTab } from "./faq-list.types";
export type FaqSplitProps = {
id: string;
title: string;
lead?: string;
badge?: string;
items: Question[];
channels: Feature[];
topics: FaqTab[];
labels: FaqSplitLabels;
layout?: "head" | "aside" | "media" | "search" | "cards";
cards?: "grid3" | "grid4" | "icons";
mediaSide?: "end" | "start";
tone?: "default" | "muted";
image?: string;
imageAlt?: string;
landmarkLabel?: string;
};
export function FaqSplit({
id,
title,
lead = "",
badge = "",
items,
channels,
topics,
labels,
layout = "head",
cards = "grid3",
mediaSide = "end",
tone = "default",
image,
imageAlt,
landmarkLabel,
}: FaqSplitProps) {
return (
<>
{((items?.length ?? 0) > 0) ? (
<>
{((layout as string) === "cards") ? (
<SectionFrame id={id} title={title} lead={lead} heading={{ badge }} tone={tone} landmarkLabel={landmarkLabel}>
<FaqCards items={items} labels={labels} cards={cards} />
</SectionFrame>
) : null}
{((layout as string) === "head") ? (
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: "end", align: "start" }}
landmarkLabel={landmarkLabel}
aside={(
<FaqDisclosures items={items} name={tpl("{0}-faq", id)} />
)}
>
<Box>
<Button variant="default" size="default">
{labels.cta}
</Button>
</Box>
</SectionFrame>
) : null}
{((layout as string) === "aside") ? (
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: "end", align: "start" }}
landmarkLabel={landmarkLabel}
aside={(
<FaqHelp labels={labels} channels={channels} landmarkLabel={landmarkLabel} />
)}
>
<FaqDisclosures items={items} name={tpl("{0}-faq", id)} />
</SectionFrame>
) : null}
{((layout as string) === "media") ? (
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: mediaSide, align: "start" }}
landmarkLabel={landmarkLabel}
aside={(
<MediaFrame alt={(imageAlt ? imageAlt : title)} src={image} ratio="4/3" />
)}
>
<FaqDisclosures items={items} name={tpl("{0}-faq", id)} />
<Box>
<Button variant="default" size="default">
{labels.cta}
</Button>
</Box>
</SectionFrame>
) : null}
{((layout as string) === "search") ? (
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: mediaSide }}
landmarkLabel={landmarkLabel}
aside={(
<MediaFrame alt={(imageAlt ? imageAlt : title)} src={image} ratio="4/3" />
)}
>
<FaqFinder items={items} labels={labels} topics={topics} />
</SectionFrame>
) : null}
</>
) : null}
</>
);
}
// Code generated by packages/kit-compose/src/organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT.
export type Question = {
id: string;
question: string;
answer: string;
category: string;
icon: string;
href?: string;
};
export type FaqSplitLabels = {
cta: string;
more: string;
asideTitle: string;
asideText: string;
asideCta: string;
search: string;
popular: string;
query?: string;
};
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-cdnnpx ui8kit add faq-split// Code generated by packages/kit-compose/src/organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT.
export type Question = {
id: string;
question: string;
answer: string;
category: string;
icon: string;
href?: string;
};
export type FaqSplitLabels = {
cta: string;
more: string;
asideTitle: string;
asideText: string;
asideCta: string;
search: string;
popular: string;
query?: string;
};
<!-- Code generated by packages/kit-compose/src/organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT. -->
<!--
Questions in a split or as cards. Axes: layout (head: the heading and an action beside the disclosures, aside:
the disclosures beside a help card, media: the disclosures and an action beside a picture, search: a finder
beside a picture, cards: the questions as cards), cards (grid3, grid4, icons), mediaSide, tone.
-->
<script lang="ts">
import type { Question, FaqSplitLabels } from "./faq-split.types";
import type { Feature } from "./feature-grid.types";
import type { FaqTab } from "./faq-list.types";
export type FaqSplitProps = {
id: string;
title: string;
lead?: string;
badge?: string;
items: Question[];
channels: Feature[];
topics: FaqTab[];
labels: FaqSplitLabels;
layout?: "head" | "aside" | "media" | "search" | "cards";
cards?: "grid3" | "grid4" | "icons";
mediaSide?: "end" | "start";
tone?: "default" | "muted";
image?: string;
imageAlt?: string;
landmarkLabel?: string;
};
</script>
<script setup lang="ts">
import Box from "../compose/Box.vue";
import Button from "../compose/Button.vue";
import FaqCards from "../components/faq-cards.vue";
import FaqDisclosures from "../components/faq-disclosures.vue";
import FaqFinder from "../components/faq-finder.vue";
import FaqHelp from "../components/faq-help.vue";
import MediaFrame from "../components/media-frame.vue";
import SectionFrame from "../components/section-frame.vue";
import { tpl } from "../utils";
const {
id,
title,
lead = "",
badge = "",
items,
channels,
topics,
labels,
layout = "head",
cards = "grid3",
mediaSide = "end",
tone = "default",
image,
imageAlt,
landmarkLabel,
} = defineProps<FaqSplitProps>();
</script>
<template>
<template v-if="((items?.length ?? 0) > 0)">
<SectionFrame v-if="((layout as string) === 'cards')"
:id="id"
:title="title"
:lead="lead"
:heading="{ badge }"
:tone="tone"
:landmarkLabel="landmarkLabel"
>
<FaqCards :items="items" :labels="labels" :cards="cards" />
</SectionFrame>
<SectionFrame v-if="((layout as string) === 'head')"
:id="id"
:title="title"
:lead="lead"
:heading="{ badge }"
:tone="tone"
layout="split"
:media="{ show: true, side: 'end', align: 'start' }"
:landmarkLabel="landmarkLabel"
>
<Box>
<Button variant="default" size="default">
{{ labels.cta }}
</Button>
</Box>
<template #aside>
<FaqDisclosures :items="items" :name="tpl('{0}-faq', id)" />
</template>
</SectionFrame>
<SectionFrame v-if="((layout as string) === 'aside')"
:id="id"
:title="title"
:lead="lead"
:heading="{ badge }"
:tone="tone"
layout="split"
:media="{ show: true, side: 'end', align: 'start' }"
:landmarkLabel="landmarkLabel"
>
<FaqDisclosures :items="items" :name="tpl('{0}-faq', id)" />
<template #aside>
<FaqHelp :labels="labels" :channels="channels" :landmarkLabel="landmarkLabel" />
</template>
</SectionFrame>
<SectionFrame v-if="((layout as string) === 'media')"
:id="id"
:title="title"
:lead="lead"
:heading="{ badge }"
:tone="tone"
layout="split"
:media="{ show: true, side: mediaSide, align: 'start' }"
:landmarkLabel="landmarkLabel"
>
<FaqDisclosures :items="items" :name="tpl('{0}-faq', id)" />
<Box>
<Button variant="default" size="default">
{{ labels.cta }}
</Button>
</Box>
<template #aside>
<MediaFrame :alt="(imageAlt ? imageAlt : title)" :src="image" ratio="4/3" />
</template>
</SectionFrame>
<SectionFrame v-if="((layout as string) === 'search')"
:id="id"
:title="title"
:lead="lead"
:heading="{ badge }"
:tone="tone"
layout="split"
:media="{ show: true, side: mediaSide }"
:landmarkLabel="landmarkLabel"
>
<FaqFinder :items="items" :labels="labels" :topics="topics" />
<template #aside>
<MediaFrame :alt="(imageAlt ? imageAlt : title)" :src="image" ratio="4/3" />
</template>
</SectionFrame>
</template>
</template>
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-cdnnpx ui8kit add faq-split// Code generated by packages/kit-compose/src/organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT.
/**
* Questions in a split or as cards. Axes: layout (head: the heading and an action beside the disclosures, aside:
* the disclosures beside a help card, media: the disclosures and an action beside a picture, search: a finder
* beside a picture, cards: the questions as cards), cards (grid3, grid4, icons), mediaSide, tone.
*/
import { type JSX } from "solid-js";
import { Box, Button } from "../compose";
import { FaqCards } from "../components/faq-cards";
import { FaqDisclosures } from "../components/faq-disclosures";
import { FaqFinder } from "../components/faq-finder";
import { FaqHelp } from "../components/faq-help";
import { MediaFrame } from "../components/media-frame";
import { SectionFrame } from "../components/section-frame";
import { tpl } from "../utils";
import type { Question, FaqSplitLabels } from "./faq-split.types";
import type { Feature } from "./feature-grid.types";
import type { FaqTab } from "./faq-list.types";
export type FaqSplitProps = {
id: string;
title: string;
lead?: string;
badge?: string;
items: Question[];
channels: Feature[];
topics: FaqTab[];
labels: FaqSplitLabels;
layout?: "head" | "aside" | "media" | "search" | "cards";
cards?: "grid3" | "grid4" | "icons";
mediaSide?: "end" | "start";
tone?: "default" | "muted";
image?: string;
imageAlt?: string;
landmarkLabel?: string;
};
export function FaqSplit({
id,
title,
lead = "",
badge = "",
items,
channels,
topics,
labels,
layout = "head",
cards = "grid3",
mediaSide = "end",
tone = "default",
image,
imageAlt,
landmarkLabel,
}: FaqSplitProps) {
return (
<>
{((items?.length ?? 0) > 0) ? (
<>
{((layout as string) === "cards") ? (
<SectionFrame id={id} title={title} lead={lead} heading={{ badge }} tone={tone} landmarkLabel={landmarkLabel}>
<FaqCards items={items} labels={labels} cards={cards} />
</SectionFrame>
) : null}
{((layout as string) === "head") ? (
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: "end", align: "start" }}
landmarkLabel={landmarkLabel}
aside={(
<FaqDisclosures items={items} name={tpl("{0}-faq", id)} />
)}
>
<Box>
<Button variant="default" size="default">
{labels.cta}
</Button>
</Box>
</SectionFrame>
) : null}
{((layout as string) === "aside") ? (
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: "end", align: "start" }}
landmarkLabel={landmarkLabel}
aside={(
<FaqHelp labels={labels} channels={channels} landmarkLabel={landmarkLabel} />
)}
>
<FaqDisclosures items={items} name={tpl("{0}-faq", id)} />
</SectionFrame>
) : null}
{((layout as string) === "media") ? (
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: mediaSide, align: "start" }}
landmarkLabel={landmarkLabel}
aside={(
<MediaFrame alt={(imageAlt ? imageAlt : title)} src={image} ratio="4/3" />
)}
>
<FaqDisclosures items={items} name={tpl("{0}-faq", id)} />
<Box>
<Button variant="default" size="default">
{labels.cta}
</Button>
</Box>
</SectionFrame>
) : null}
{((layout as string) === "search") ? (
<SectionFrame
id={id}
title={title}
lead={lead}
heading={{ badge }}
tone={tone}
layout="split"
media={{ show: true, side: mediaSide }}
landmarkLabel={landmarkLabel}
aside={(
<MediaFrame alt={(imageAlt ? imageAlt : title)} src={image} ratio="4/3" />
)}
>
<FaqFinder items={items} labels={labels} topics={topics} />
</SectionFrame>
) : null}
</>
) : null}
</>
);
}
// Code generated by packages/kit-compose/src/organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT.
export type Question = {
id: string;
question: string;
answer: string;
category: string;
icon: string;
href?: string;
};
export type FaqSplitLabels = {
cta: string;
more: string;
asideTitle: string;
asideText: string;
asideCta: string;
search: string;
popular: string;
query?: string;
};
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-cdnnpx ui8kit add faq-split// Code generated by packages/kit-compose/src/server-organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT.
// Source: packages/compose-gen/specs/organisms/faq-split.json
package blocks
import (
"github.com/ui8kit/codegen/generated/templ/ui/box"
"github.com/ui8kit/codegen/generated/templ/ui/button"
"github.com/ui8kit/codegen/generated/templ/compose"
uiutils "github.com/ui8kit/codegen/generated/templ/orgutils"
)
// FaqSplitProps are the props of FaqSplit; the values are the JSON shapes of the TypeScript props.
type FaqSplitProps struct {
Id any `json:"id"`
Title any `json:"title"`
Lead any `json:"lead"`
Badge any `json:"badge"`
Items any `json:"items"`
Channels any `json:"channels"`
Topics any `json:"topics"`
Labels any `json:"labels"`
Layout any `json:"layout"`
Cards any `json:"cards"`
MediaSide any `json:"mediaSide"`
Tone any `json:"tone"`
Image any `json:"image"`
ImageAlt any `json:"imageAlt"`
LandmarkLabel any `json:"landmarkLabel"`
}
// Questions in a split or as cards. Axes: layout (head: the heading and an action beside the disclosures, aside: the disclosures beside a help card, media: the disclosures and an action beside a picture, search: a finder beside a picture, cards: the questions as cards), cards (grid3, grid4, icons), mediaSide, tone.
templ FaqSplit(p FaqSplitProps) {
{{ vId := p.Id }}
{{ vTitle := p.Title }}
{{ vLead := uiutils.Def(p.Lead, "") }}
{{ vBadge := uiutils.Def(p.Badge, "") }}
{{ vItems := p.Items }}
{{ vChannels := p.Channels }}
{{ vTopics := p.Topics }}
{{ vLabels := p.Labels }}
{{ vLayout := uiutils.Def(p.Layout, "head") }}
{{ vCards := uiutils.Def(p.Cards, "grid3") }}
{{ vMediaSide := uiutils.Def(p.MediaSide, "end") }}
{{ vTone := uiutils.Def(p.Tone, "default") }}
{{ vImage := p.Image }}
{{ vImageAlt := p.ImageAlt }}
{{ vLandmarkLabel := p.LandmarkLabel }}
if uiutils.Gt(uiutils.Len(vItems), float64(0)) {
if uiutils.Eq(vLayout, "cards") {
@SectionFrame(SectionFrameProps{Id: vId, Title: vTitle, Lead: vLead, Heading: map[string]any{"badge": vBadge}, Tone: vTone, LandmarkLabel: vLandmarkLabel}) {
@FaqCards(FaqCardsProps{Items: vItems, Labels: vLabels, Cards: vCards})
}
}
if uiutils.Eq(vLayout, "head") {
@SectionFrame(SectionFrameProps{Id: vId, Title: vTitle, Lead: vLead, Heading: map[string]any{"badge": vBadge}, Tone: vTone, Layout: "split", Media: map[string]any{"show": true, "side": "end", "align": "start"}, LandmarkLabel: vLandmarkLabel, Aside: faqSplitFill1(p, vId, vItems)}) {
@compose.Box(compose.BoxProps{BoxProps: box.BoxProps{}}) {
@compose.Button(compose.ButtonProps{Variant: "default", Size: "default", ButtonProps: button.ButtonProps{}}) {
{ uiutils.Text(uiutils.Get(vLabels, "cta")) }
}
}
}
}
if uiutils.Eq(vLayout, "aside") {
@SectionFrame(SectionFrameProps{Id: vId, Title: vTitle, Lead: vLead, Heading: map[string]any{"badge": vBadge}, Tone: vTone, Layout: "split", Media: map[string]any{"show": true, "side": "end", "align": "start"}, LandmarkLabel: vLandmarkLabel, Aside: faqSplitFill2(p, vChannels, vLabels, vLandmarkLabel)}) {
@FaqDisclosures(FaqDisclosuresProps{Items: vItems, Name: uiutils.Tpl("{0}-faq", vId)})
}
}
if uiutils.Eq(vLayout, "media") {
@SectionFrame(SectionFrameProps{Id: vId, Title: vTitle, Lead: vLead, Heading: map[string]any{"badge": vBadge}, Tone: vTone, Layout: "split", Media: map[string]any{"show": true, "side": vMediaSide, "align": "start"}, LandmarkLabel: vLandmarkLabel, Aside: faqSplitFill3(p, vTitle, vImage, vImageAlt)}) {
@FaqDisclosures(FaqDisclosuresProps{Items: vItems, Name: uiutils.Tpl("{0}-faq", vId)})
@compose.Box(compose.BoxProps{BoxProps: box.BoxProps{}}) {
@compose.Button(compose.ButtonProps{Variant: "default", Size: "default", ButtonProps: button.ButtonProps{}}) {
{ uiutils.Text(uiutils.Get(vLabels, "cta")) }
}
}
}
}
if uiutils.Eq(vLayout, "search") {
@SectionFrame(SectionFrameProps{Id: vId, Title: vTitle, Lead: vLead, Heading: map[string]any{"badge": vBadge}, Tone: vTone, Layout: "split", Media: map[string]any{"show": true, "side": vMediaSide}, LandmarkLabel: vLandmarkLabel, Aside: faqSplitFill4(p, vTitle, vImage, vImageAlt)}) {
@FaqFinder(FaqFinderProps{Items: vItems, Labels: vLabels, Topics: vTopics})
}
}
}
}
templ faqSplitFill1(p FaqSplitProps, vId any, vItems any) {
@FaqDisclosures(FaqDisclosuresProps{Items: vItems, Name: uiutils.Tpl("{0}-faq", vId)})
}
templ faqSplitFill2(p FaqSplitProps, vChannels any, vLabels any, vLandmarkLabel any) {
@FaqHelp(FaqHelpProps{Labels: vLabels, Channels: vChannels, LandmarkLabel: vLandmarkLabel})
}
templ faqSplitFill3(p FaqSplitProps, vTitle any, vImage any, vImageAlt any) {
@MediaFrame(MediaFrameProps{Alt: uiutils.Cond(uiutils.T(vImageAlt), vImageAlt, vTitle), Src: vImage, Ratio: "4/3"})
}
templ faqSplitFill4(p FaqSplitProps, vTitle any, vImage any, vImageAlt any) {
@MediaFrame(MediaFrameProps{Alt: uiutils.Cond(uiutils.T(vImageAlt), vImageAlt, vTitle), Src: vImage, Ratio: "4/3"})
}
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-cdnnpx ui8kit add faq-split{#- Code generated by packages/kit-compose/src/server-organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT.
Source: packages/compose-gen/specs/organisms/faq-split.json
Questions in a split or as cards. Axes: layout (head: the heading and an action beside the disclosures, aside: the disclosures beside a help card, media: the disclosures and an action beside a picture, search: a finder beside a picture, cards: the questions as cards), cards (grid3, grid4, icons), mediaSide, tone.
Props (p): id, title, lead, badge, items, channels, topics, labels, layout, cards, mediaSide, tone, image, imageAlt, landmarkLabel. -#}
{%- set v_id = (p.id ?? null) -%}
{%- set v_title = (p.title ?? null) -%}
{%- set v_lead = (p.lead ?? '') -%}
{%- set v_badge = (p.badge ?? '') -%}
{%- set v_items = (p.items ?? null) -%}
{%- set v_channels = (p.channels ?? null) -%}
{%- set v_topics = (p.topics ?? null) -%}
{%- set v_labels = (p.labels ?? null) -%}
{%- set v_layout = (p.layout ?? 'head') -%}
{%- set v_cards = (p.cards ?? 'grid3') -%}
{%- set v_mediaSide = (p.mediaSide ?? 'end') -%}
{%- set v_tone = (p.tone ?? 'default') -%}
{%- set v_image = (p.image ?? null) -%}
{%- set v_imageAlt = (p.imageAlt ?? null) -%}
{%- set v_landmarkLabel = (p.landmarkLabel ?? null) -%}
{%- if og_t(og_gt(og_len(v_items), 0)) %}
{%- if og_t(og_eq(v_layout, 'cards')) %}
{%- set c_1 -%}
{{ include('blocks/faq-cards.html.twig', {'p': {'items': v_items, 'labels': v_labels, 'cards': v_cards}}, with_context = false) }}
{%- endset -%}
{{ include('blocks/section-frame.html.twig', {'p': {'id': v_id, 'title': v_title, 'lead': v_lead, 'heading': {'badge': v_badge}, 'tone': v_tone, 'landmarkLabel': v_landmarkLabel}, 'children': og_markup(c_1)}, with_context = false) }}
{%- endif %}
{%- if og_t(og_eq(v_layout, 'head')) %}
{%- set f_4 -%}
{{ include('blocks/faq-disclosures.html.twig', {'p': {'items': v_items, 'name': og_tpl('{0}-faq', [v_id])}}, with_context = false) }}
{%- endset -%}
{%- set c_5 -%}
{%- set c_3 -%}
{%- set c_2 -%}
{{ og_text(og_get(v_labels, ['cta'])) }}
{%- endset -%}
{{ include('compose/Button.html.twig', {'variant': 'default', 'size': 'default', 'children': c_2}, with_context = false) }}
{%- endset -%}
{{ include('compose/Box.html.twig', {'children': c_3}, with_context = false) }}
{%- endset -%}
{{ include('blocks/section-frame.html.twig', {'p': {'id': v_id, 'title': v_title, 'lead': v_lead, 'heading': {'badge': v_badge}, 'tone': v_tone, 'layout': 'split', 'media': {'show': true, 'side': 'end', 'align': 'start'}, 'landmarkLabel': v_landmarkLabel, 'aside': og_markup(f_4)}, 'children': og_markup(c_5)}, with_context = false) }}
{%- endif %}
{%- if og_t(og_eq(v_layout, 'aside')) %}
{%- set f_6 -%}
{{ include('blocks/faq-help.html.twig', {'p': {'labels': v_labels, 'channels': v_channels, 'landmarkLabel': v_landmarkLabel}}, with_context = false) }}
{%- endset -%}
{%- set c_7 -%}
{{ include('blocks/faq-disclosures.html.twig', {'p': {'items': v_items, 'name': og_tpl('{0}-faq', [v_id])}}, with_context = false) }}
{%- endset -%}
{{ include('blocks/section-frame.html.twig', {'p': {'id': v_id, 'title': v_title, 'lead': v_lead, 'heading': {'badge': v_badge}, 'tone': v_tone, 'layout': 'split', 'media': {'show': true, 'side': 'end', 'align': 'start'}, 'landmarkLabel': v_landmarkLabel, 'aside': og_markup(f_6)}, 'children': og_markup(c_7)}, with_context = false) }}
{%- endif %}
{%- if og_t(og_eq(v_layout, 'media')) %}
{%- set f_10 -%}
{{ include('blocks/media-frame.html.twig', {'p': {'alt': (og_t(v_imageAlt) ? v_imageAlt : v_title), 'src': v_image, 'ratio': '4/3'}}, with_context = false) }}
{%- endset -%}
{%- set c_11 -%}
{{ include('blocks/faq-disclosures.html.twig', {'p': {'items': v_items, 'name': og_tpl('{0}-faq', [v_id])}}, with_context = false) }}
{%- set c_9 -%}
{%- set c_8 -%}
{{ og_text(og_get(v_labels, ['cta'])) }}
{%- endset -%}
{{ include('compose/Button.html.twig', {'variant': 'default', 'size': 'default', 'children': c_8}, with_context = false) }}
{%- endset -%}
{{ include('compose/Box.html.twig', {'children': c_9}, with_context = false) }}
{%- endset -%}
{{ include('blocks/section-frame.html.twig', {'p': {'id': v_id, 'title': v_title, 'lead': v_lead, 'heading': {'badge': v_badge}, 'tone': v_tone, 'layout': 'split', 'media': {'show': true, 'side': v_mediaSide, 'align': 'start'}, 'landmarkLabel': v_landmarkLabel, 'aside': og_markup(f_10)}, 'children': og_markup(c_11)}, with_context = false) }}
{%- endif %}
{%- if og_t(og_eq(v_layout, 'search')) %}
{%- set f_12 -%}
{{ include('blocks/media-frame.html.twig', {'p': {'alt': (og_t(v_imageAlt) ? v_imageAlt : v_title), 'src': v_image, 'ratio': '4/3'}}, with_context = false) }}
{%- endset -%}
{%- set c_13 -%}
{{ include('blocks/faq-finder.html.twig', {'p': {'items': v_items, 'labels': v_labels, 'topics': v_topics}}, with_context = false) }}
{%- endset -%}
{{ include('blocks/section-frame.html.twig', {'p': {'id': v_id, 'title': v_title, 'lead': v_lead, 'heading': {'badge': v_badge}, 'tone': v_tone, 'layout': 'split', 'media': {'show': true, 'side': v_mediaSide}, 'landmarkLabel': v_landmarkLabel, 'aside': og_markup(f_12)}, 'children': og_markup(c_13)}, with_context = false) }}
{%- endif %}
{%- endif %}
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-cdnnpx ui8kit add faq-split{* Code generated by packages/kit-compose/src/server-organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT.
Source: packages/compose-gen/specs/organisms/faq-split.json
Questions in a split or as cards. Axes: layout (head: the heading and an action beside the disclosures, aside: the disclosures beside a help card, media: the disclosures and an action beside a picture, search: a finder beside a picture, cards: the questions as cards), cards (grid3, grid4, icons), mediaSide, tone.
Props (p): id, title, lead, badge, items, channels, topics, labels, layout, cards, mediaSide, tone, image, imageAlt, landmarkLabel. *}
{var $v_id = ($p['id'] ?? null)}
{var $v_title = ($p['title'] ?? null)}
{var $v_lead = ($p['lead'] ?? '')}
{var $v_badge = ($p['badge'] ?? '')}
{var $v_items = ($p['items'] ?? null)}
{var $v_channels = ($p['channels'] ?? null)}
{var $v_topics = ($p['topics'] ?? null)}
{var $v_labels = ($p['labels'] ?? null)}
{var $v_layout = ($p['layout'] ?? 'head')}
{var $v_cards = ($p['cards'] ?? 'grid3')}
{var $v_mediaSide = ($p['mediaSide'] ?? 'end')}
{var $v_tone = ($p['tone'] ?? 'default')}
{var $v_image = ($p['image'] ?? null)}
{var $v_imageAlt = ($p['imageAlt'] ?? null)}
{var $v_landmarkLabel = ($p['landmarkLabel'] ?? null)}
{if og_t(og_gt(og_len($v_items), 0))}
{if og_t(og_eq($v_layout, 'cards'))}
{capture $c_1}
{=og_include('blocks/faq-cards.latte', ['p' => ['items' => $v_items, 'labels' => $v_labels, 'cards' => $v_cards]])|noescape}
{/capture}
{=og_include('blocks/section-frame.latte', ['p' => ['id' => $v_id, 'title' => $v_title, 'lead' => $v_lead, 'heading' => ['badge' => $v_badge], 'tone' => $v_tone, 'landmarkLabel' => $v_landmarkLabel], 'children' => og_markup($c_1)])|noescape}
{/if}
{if og_t(og_eq($v_layout, 'head'))}
{capture $f_4}
{=og_include('blocks/faq-disclosures.latte', ['p' => ['items' => $v_items, 'name' => og_tpl('{0}-faq', [$v_id])]])|noescape}
{/capture}
{capture $c_5}
{capture $c_3}
{capture $c_2}
{=og_text(og_get($v_labels, ['cta']))}
{/capture}
{=og_include('compose/Button.latte', ['variant' => 'default', 'size' => 'default', 'children' => (string) $c_2])|noescape}
{/capture}
{=og_include('compose/Box.latte', ['children' => (string) $c_3])|noescape}
{/capture}
{=og_include('blocks/section-frame.latte', ['p' => ['id' => $v_id, 'title' => $v_title, 'lead' => $v_lead, 'heading' => ['badge' => $v_badge], 'tone' => $v_tone, 'layout' => 'split', 'media' => ['show' => true, 'side' => 'end', 'align' => 'start'], 'landmarkLabel' => $v_landmarkLabel, 'aside' => og_markup($f_4)], 'children' => og_markup($c_5)])|noescape}
{/if}
{if og_t(og_eq($v_layout, 'aside'))}
{capture $f_6}
{=og_include('blocks/faq-help.latte', ['p' => ['labels' => $v_labels, 'channels' => $v_channels, 'landmarkLabel' => $v_landmarkLabel]])|noescape}
{/capture}
{capture $c_7}
{=og_include('blocks/faq-disclosures.latte', ['p' => ['items' => $v_items, 'name' => og_tpl('{0}-faq', [$v_id])]])|noescape}
{/capture}
{=og_include('blocks/section-frame.latte', ['p' => ['id' => $v_id, 'title' => $v_title, 'lead' => $v_lead, 'heading' => ['badge' => $v_badge], 'tone' => $v_tone, 'layout' => 'split', 'media' => ['show' => true, 'side' => 'end', 'align' => 'start'], 'landmarkLabel' => $v_landmarkLabel, 'aside' => og_markup($f_6)], 'children' => og_markup($c_7)])|noescape}
{/if}
{if og_t(og_eq($v_layout, 'media'))}
{capture $f_10}
{=og_include('blocks/media-frame.latte', ['p' => ['alt' => (og_t($v_imageAlt) ? $v_imageAlt : $v_title), 'src' => $v_image, 'ratio' => '4/3']])|noescape}
{/capture}
{capture $c_11}
{=og_include('blocks/faq-disclosures.latte', ['p' => ['items' => $v_items, 'name' => og_tpl('{0}-faq', [$v_id])]])|noescape}
{capture $c_9}
{capture $c_8}
{=og_text(og_get($v_labels, ['cta']))}
{/capture}
{=og_include('compose/Button.latte', ['variant' => 'default', 'size' => 'default', 'children' => (string) $c_8])|noescape}
{/capture}
{=og_include('compose/Box.latte', ['children' => (string) $c_9])|noescape}
{/capture}
{=og_include('blocks/section-frame.latte', ['p' => ['id' => $v_id, 'title' => $v_title, 'lead' => $v_lead, 'heading' => ['badge' => $v_badge], 'tone' => $v_tone, 'layout' => 'split', 'media' => ['show' => true, 'side' => $v_mediaSide, 'align' => 'start'], 'landmarkLabel' => $v_landmarkLabel, 'aside' => og_markup($f_10)], 'children' => og_markup($c_11)])|noescape}
{/if}
{if og_t(og_eq($v_layout, 'search'))}
{capture $f_12}
{=og_include('blocks/media-frame.latte', ['p' => ['alt' => (og_t($v_imageAlt) ? $v_imageAlt : $v_title), 'src' => $v_image, 'ratio' => '4/3']])|noescape}
{/capture}
{capture $c_13}
{=og_include('blocks/faq-finder.latte', ['p' => ['items' => $v_items, 'labels' => $v_labels, 'topics' => $v_topics]])|noescape}
{/capture}
{=og_include('blocks/section-frame.latte', ['p' => ['id' => $v_id, 'title' => $v_title, 'lead' => $v_lead, 'heading' => ['badge' => $v_badge], 'tone' => $v_tone, 'layout' => 'split', 'media' => ['show' => true, 'side' => $v_mediaSide], 'landmarkLabel' => $v_landmarkLabel, 'aside' => og_markup($f_12)], 'children' => og_markup($c_13)])|noescape}
{/if}
{/if}
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-cdnnpx ui8kit add faq-split{#- Code generated by packages/kit-compose/src/server-organisms.ts from packages/compose-gen/specs (compose-gen organism emitters on kit-compose). DO NOT EDIT.
Source: packages/compose-gen/specs/organisms/faq-split.json
Questions in a split or as cards. Axes: layout (head: the heading and an action beside the disclosures, aside: the disclosures beside a help card, media: the disclosures and an action beside a picture, search: a finder beside a picture, cards: the questions as cards), cards (grid3, grid4, icons), mediaSide, tone.
Props (p): id, title, lead, badge, items, channels, topics, labels, layout, cards, mediaSide, tone, image, imageAlt, landmarkLabel. -#}
{%- set v_id = og_def(p['id'], none) -%}
{%- set v_title = og_def(p['title'], none) -%}
{%- set v_lead = og_def(p['lead'], '') -%}
{%- set v_badge = og_def(p['badge'], '') -%}
{%- set v_items = og_def(p['items'], none) -%}
{%- set v_channels = og_def(p['channels'], none) -%}
{%- set v_topics = og_def(p['topics'], none) -%}
{%- set v_labels = og_def(p['labels'], none) -%}
{%- set v_layout = og_def(p['layout'], 'head') -%}
{%- set v_cards = og_def(p['cards'], 'grid3') -%}
{%- set v_mediaSide = og_def(p['mediaSide'], 'end') -%}
{%- set v_tone = og_def(p['tone'], 'default') -%}
{%- set v_image = og_def(p['image'], none) -%}
{%- set v_imageAlt = og_def(p['imageAlt'], none) -%}
{%- set v_landmarkLabel = og_def(p['landmarkLabel'], none) -%}
{%- if og_t(og_gt(og_len(v_items), 0)) %}
{%- if og_t(og_eq(v_layout, 'cards')) %}
{%- set c_1 -%}
{{ og_include('blocks/faq-cards.html.j2', {'p': {'items': v_items, 'labels': v_labels, 'cards': v_cards}}) }}
{%- endset -%}
{{ og_include('blocks/section-frame.html.j2', {'p': {'id': v_id, 'title': v_title, 'lead': v_lead, 'heading': {'badge': v_badge}, 'tone': v_tone, 'landmarkLabel': v_landmarkLabel}, 'children': og_markup(c_1)}) }}
{%- endif %}
{%- if og_t(og_eq(v_layout, 'head')) %}
{%- set f_4 -%}
{{ og_include('blocks/faq-disclosures.html.j2', {'p': {'items': v_items, 'name': og_tpl('{0}-faq', [v_id])}}) }}
{%- endset -%}
{%- set c_5 -%}
{%- set c_3 -%}
{%- set c_2 -%}
{{ og_text(og_get(v_labels, ['cta'])) }}
{%- endset -%}
{{ og_include('compose/button.html.j2', {'p': {'Variant': 'default', 'Size': 'default'}, 'children': c_2}) }}
{%- endset -%}
{{ og_include('compose/box.html.j2', {'p': {}, 'children': c_3}) }}
{%- endset -%}
{{ og_include('blocks/section-frame.html.j2', {'p': {'id': v_id, 'title': v_title, 'lead': v_lead, 'heading': {'badge': v_badge}, 'tone': v_tone, 'layout': 'split', 'media': {'show': true, 'side': 'end', 'align': 'start'}, 'landmarkLabel': v_landmarkLabel, 'aside': og_markup(f_4)}, 'children': og_markup(c_5)}) }}
{%- endif %}
{%- if og_t(og_eq(v_layout, 'aside')) %}
{%- set f_6 -%}
{{ og_include('blocks/faq-help.html.j2', {'p': {'labels': v_labels, 'channels': v_channels, 'landmarkLabel': v_landmarkLabel}}) }}
{%- endset -%}
{%- set c_7 -%}
{{ og_include('blocks/faq-disclosures.html.j2', {'p': {'items': v_items, 'name': og_tpl('{0}-faq', [v_id])}}) }}
{%- endset -%}
{{ og_include('blocks/section-frame.html.j2', {'p': {'id': v_id, 'title': v_title, 'lead': v_lead, 'heading': {'badge': v_badge}, 'tone': v_tone, 'layout': 'split', 'media': {'show': true, 'side': 'end', 'align': 'start'}, 'landmarkLabel': v_landmarkLabel, 'aside': og_markup(f_6)}, 'children': og_markup(c_7)}) }}
{%- endif %}
{%- if og_t(og_eq(v_layout, 'media')) %}
{%- set f_10 -%}
{{ og_include('blocks/media-frame.html.j2', {'p': {'alt': (v_imageAlt if og_t(v_imageAlt) else v_title), 'src': v_image, 'ratio': '4/3'}}) }}
{%- endset -%}
{%- set c_11 -%}
{{ og_include('blocks/faq-disclosures.html.j2', {'p': {'items': v_items, 'name': og_tpl('{0}-faq', [v_id])}}) }}
{%- set c_9 -%}
{%- set c_8 -%}
{{ og_text(og_get(v_labels, ['cta'])) }}
{%- endset -%}
{{ og_include('compose/button.html.j2', {'p': {'Variant': 'default', 'Size': 'default'}, 'children': c_8}) }}
{%- endset -%}
{{ og_include('compose/box.html.j2', {'p': {}, 'children': c_9}) }}
{%- endset -%}
{{ og_include('blocks/section-frame.html.j2', {'p': {'id': v_id, 'title': v_title, 'lead': v_lead, 'heading': {'badge': v_badge}, 'tone': v_tone, 'layout': 'split', 'media': {'show': true, 'side': v_mediaSide, 'align': 'start'}, 'landmarkLabel': v_landmarkLabel, 'aside': og_markup(f_10)}, 'children': og_markup(c_11)}) }}
{%- endif %}
{%- if og_t(og_eq(v_layout, 'search')) %}
{%- set f_12 -%}
{{ og_include('blocks/media-frame.html.j2', {'p': {'alt': (v_imageAlt if og_t(v_imageAlt) else v_title), 'src': v_image, 'ratio': '4/3'}}) }}
{%- endset -%}
{%- set c_13 -%}
{{ og_include('blocks/faq-finder.html.j2', {'p': {'items': v_items, 'labels': v_labels, 'topics': v_topics}}) }}
{%- endset -%}
{{ og_include('blocks/section-frame.html.j2', {'p': {'id': v_id, 'title': v_title, 'lead': v_lead, 'heading': {'badge': v_badge}, 'tone': v_tone, 'layout': 'split', 'media': {'show': true, 'side': v_mediaSide}, 'landmarkLabel': v_landmarkLabel, 'aside': og_markup(f_12)}, 'children': og_markup(c_13)}) }}
{%- endif %}
{%- endif %}
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.
Questions in a split or as cards. Axes: layout (head: the heading and an action beside the disclosures, aside: the disclosures beside a help card, media: the disclosures and an action beside a picture, search: a finder beside a picture, cards: the questions as cards), cards (grid3, grid4, icons), mediaSide, tone.
| Prop | Type | Default | Description |
|---|---|---|---|
| id (required) | string | - | |
| title (required) | string | - | |
| lead | string | "" | |
| badge | string | "" | a short pill above the heading |
| items (required) | Question[] | - | |
| channels (required) | Feature[] | - | the ways to reach the team (aside layout) |
| topics (required) | FaqTab[] | - | the topic buttons of the finder (search layout) |
| labels (required) | FaqSplitLabels | - | |
| layout | "head" | "aside" | "media" | "search" | "cards" | "head" | |
| cards | "grid3" | "grid4" | "icons" | "grid3" | |
| mediaSide | "end" | "start" | "end" | |
| tone | "default" | "muted" | "default" | |
| image | string | - | address of the picture (an https URL or a path); none: the placeholder |
| imageAlt | string | - | alt text of the picture; none: the title |
| landmarkLabel | string | - | accessible name of the landmark of this component when the page shows it more than once (a variant); replaces the heading name of the root landmark, follows the name of a nested one |