Components
The full catalog of components currently shipped by ChuFix UI and their status.
Overview
P0–P11 + 8 templates + 22 data visualization components are all materialized, 151+ components total, covering every visual unit in the ProtoForge design — form / feedback / container / navigation / data display / editor / system shell / multi-window / chart / template.
Form
Icon
169 built-in SVG icons with typed names, inlined directly by React / Vue components.
Button
5 variants, 3 sizes, 2 semantic tones, loading state.
Input
3 variants, 3 sizes; clearable, prefix/suffix, error state.
Switch
Native input role=switch semantics preserved; supports loading and disabled states.
Checkbox
3 sizes, indeterminate state, native input semantics preserved.
Radio
Radio + RadioGroup combo, mutually exclusive, keyboard reachable.
Textarea
Same color system as Input; autoResize, character count, resize control.
Select
Config-driven options API; clearable, keyboard navigation, disabled items.
SearchInput
Preset search icon + clear button + optional shortcut hint.
NumberInput
+/− stepper, min/max/step constraints, arrow keys, auto clamp.
Slider
Single-value range drag; ticks, bubbles, full ←→↑↓ keyboard support.
InputGroup
Compose Input/Button/Select/static labels into a single control with shared outer radius and border.
OtpInput
Fixed-cell numeric input with auto-advance, Backspace, and full-string paste distribution.
Form
Form wrapper that unifies label / hint / error display and adopts existing inputs.
Combobox
Editable variant of Select; type to filter, optionally allow new entries.
TagInput
Multi-tag input control; Enter to add, Backspace to remove, paste for bulk import, validation.
Dropzone
Drag and click double trigger; built-in file list, progress bar, and reject callback.
KVEditor
Edit HTTP headers / query params / env vars; toggle column and description column optional.
Mention
Type @ in a textarea to trigger a candidate dropdown; ↑↓ Enter / Tab to select.
ColorPicker
HSV palette + hue / alpha sliders + HEX / RGB / HSL inputs + preset swatches.
DatePicker
Month panel with day / month / year view switch; min/max/disabledDate constraints, clearable.
DateRangePicker
Side-by-side dual months, hover preview, last 7 / 30 / 90 day quick presets.
Calendar
Embedded month view with optional week numbers; shares date utils with DatePicker.
Cascader
Column-by-column expand picker for multi-level options; path selection for region / department / category.
TimePicker
Trigger + three-column scrolling panel for hour / minute / second; HH:mm and HH:mm:ss precisions.
Transfer
Two-column list with arrows in between; move items between “available / selected” with search.
TimeRangePicker
Two TimePickers combined to pick a “start – end” time range.
Container
Card
3 variants; Header / Body / Footer three-section layout; clickable whole card.
PageHeader
All-in-one page header with title + description + breadcrumb + actions + toolbar + tabs.
AppShell
CSS Grid layout for header + sidebar + main + aside + footer; site-wide scaffold.
Splitter
Drag the divider to resize panels on either side; horizontal and vertical, keyboard reachable.
Data display
Tag
3 variants, 5 tones, 3 sizes; closable and rounded.
Badge
Standalone pill or anchored to a child’s corner; dot/count forms, overflow shows +.
Avatar
Image / initials / icon with automatic fallback; AvatarGroup overlapping layout.
List
General-purpose list; single / multi select, grouping, card style, custom render.
DescriptionList
dt / dd style key-value display; horizontal or vertical, multi-column, optional border.
Stat / KPI
Metric card with number + label + trend; dashboard staple.
Table
Column-definition API; sorting, row selection, 3 variants, custom render.
DataGrid
Heavy-duty grid — column drag-resize, double-click cell editing, sticky header scroll.
TreeView
Nested tree display; single / checkbox (with cascade) selection, expand / collapse, custom icons.
Kbd
Tiny typographic control for shortcuts; supports key combos and custom separators.
Link
4 variants; auto-detects external links, can be disabled, design-consistent style.
Code
InlineCode + CodeBlock; supports title, language tag, line numbers, copy button.
AspectRatio
Container that locks the child’s aspect ratio; image / video / iframe placeholder.
Rating
Star rating with integer / half-star precision; readonly / disabled, optional value display.
Toc
Article side table of contents; depth-based indent, manual or scroll-aware tracking.
ScrollArea
Themed scrollbar container; gutter stable + overscroll contain.
JsonViewer
Collapsible JSON tree view; values colored by type, deep-expand and type badges supported.
JsonDiff
Line-level LCS diff between two JSON values; tinted by add / del / eq.
Kanban
Multi-column card board; HTML5 drag to move cards across columns, WIP limit and accent color per column.
Image
Image container with shimmer loading placeholder, error fallback, and native lazy loading.
Carousel
Horizontal carousel for images or custom content; autoplay, loop, indicators, prev/next controls.
Statistic
Large number + thousand separators / prefix-suffix / countdown; top-of-dashboard metric.
Timeline
Sequential event stream with dot / line / timestamp; changelog and audit trail.
Marquee
Horizontal continuous scroll for announcements / tickers / logo walls; pauses on hover.
ImagePreview
Full-screen image viewer with wheel zoom + mouse drag + keyboard +/− / 0 / Esc controls.
Highlight
Highlight matched keywords inside long text; for search result lists and hit markers.
TextEllipsis
Multi-line text overflow ellipsis with optional “expand/collapse”; the button only appears when actually truncated.
CountDown
Standalone countdown supporting DD/HH/mm/ss/SSS placeholders; zero-out callback.
CalendarHeatmap
52 weeks × 7 days grid colored by intensity; activity / contribution stats.
QRCode
Pure client-side, zero-dependency encoder; auto picks version 1–40, 4 error-correction levels.
Navigation
Tabs
line / segmented / pill variants; controlled and uncontrolled; items array API.
Breadcrumb
Current location trail; last item is non-clickable, separator is customizable.
Pagination
Number buttons + prev/next + jump input; auto-calculated ellipses.
Dropdown
Items array API; full ↑↓ Enter Esc keyboard support; groups and danger items.
Stepper
Multi-step flow progress; 3 variants, horizontal or vertical, clickable to switch.
Sidebar
Vertical primary navigation; groups, nested submenus, badges, collapsible icon mode.
NavMenu
Top horizontal navigation; each item can attach a rich panel (multi-column links + descriptions).
SegmentedControl
Semantic alias for Tabs segmented variant; for view / time-period switching.
Anchor
Explicit anchor list; highlights the current section while scrolling, smooth scrolls on click.
Layout and state
Divider
Horizontal / vertical divider; 3 line styles, optional label and position.
Empty
Placeholder for empty lists / tables / search results; optional icon and action button.
Progress
Linear / circular progress; 5 semantic tones, indeterminate state.
Spinner
Spinning ring loading icon; 3 sizes × 6 tones, optional text label.
Accordion
Single / multi-expand modes; 3 border styles (bordered / flush / separated).
BackTop
Sticky button that appears past a scroll threshold; smooth-scrolls to the container top.
Affix
Switches an element to fixed positioning when it scrolls past; for toolbars / anchors / submit bars.
Watermark
Overlay tilted, repeated text watermark on a content container to trace leaks.
FloatButton
Round button anchored to a viewport corner; supports tooltip and badge.
InfiniteScroll
Auto-loads the next page when scrolled to the bottom; based on IntersectionObserver.
Tour
Step-by-step highlight on key UI elements + explanation popover for new-feature onboarding.
Feedback and overlays
Modal
Built-in portal, focus trap, scroll lock, ESC / mask close, enter/exit animations.
Tooltip
4 placements; auto edge-avoidance; hover and focus dual trigger; non-blocking.
Toast
Imperative API + single-mount Toaster; 5 semantics, 6 positions, auto-dismiss.
Alert
4 tones × 3 variants; inline static message with title, icon, and close button.
Skeleton
text / circle / rect shapes; shimmer animation; multi-line text placeholder helper.
Drawer
Edge-anchored variant of Modal; slides from any side. Shares portal / focus trap / scroll lock.
Popover
Interactive variant of Tooltip; supports any rich content, forms, and buttons.
Banner
Full-width top notice; 6 tones × 2 variants, closable, can stick to top.
Result
Full-page feedback for success / failure / error states; supports 404 / 403 / 500 placeholders.
Editor
CodeEditor
Lightweight code editing container: textarea + line numbers + Tab indent. For full syntax / completion, plug in Monaco / CodeMirror.
DiffEditor
Line-level LCS diff; split / unified modes; line numbers + +/- markers.
MarkdownEditor
Built-in minimal markdown renderer; split / edit / preview modes.
RegexBuilder
Live-compile + match testing; friendly error messages; flags toggled via chips.
AnsiText
Parses ANSI escape sequences and renders colored spans; pure display, no xterm.js dependency.
System shell
TitleBar
Desktop-app window title bar. macOS-style traffic-light + centered title; Windows / Linux-style min/max/close + left-aligned.
StatusBar
Editor bottom bar. Three slots (left / center / right); 6 semantic tones.
MenuBar
App-top menu bar (File / Edit / View style); shortcuts, separators, danger items.
NotificationCenter
Notification history panel with unread count, mark-all-read, and clear controls.
GlobalSearch
Full-screen overlay app-level search; category switch + grouped list + path / badge / shortcut.
Multi-window layout
DockLayout
Recursive split + tabbed pane shell for desktop apps. v1 declarative; v2 adds drag-rearrange.
DetachedPanel
Draggable floating panel teleported to body; pairs with TearOffTab / DockLayout’s detach action.
FloatingInspector
Corner-anchored collapsible inspector panel; for performance monitoring / debug overlays.
TearOffTabs
Fires a tear-off event when a tab is dragged past a threshold; consumer decides whether to spawn DetachedPanel or a new window.
Data visualization
Sparkline
Inline mini trend line; common as the trend line on a KPI card.
LineChart
Multi-series line chart; smooth curves, gridlines, x/y axis labels.
AreaChart
Area chart with stacked mode and smooth curve support.
BarChart
Single-series vertical bar chart.
Histogram
Binned histogram, one bar per bin.
StackedBar100
Horizontal 100% stacked bars; suited to share-of-total distributions.
BulletChart
Single-value progress bar + target line + qualitative bands.
CandlestickChart
OHLC candlestick chart; green up / red down; wick + body.
DonutChart
Hollow pie chart; can host a value/label in the center.
FunnelChart
Layer-by-layer narrowing conversion funnel; absolute values per layer.
Treemap
Hierarchical area-rectangle chart; single-level slice-and-dice layout.
SankeyDiagram
Node + weighted-edge flow diagram; node height = flow.
ScatterPlot
2D scatter; can be tinted by group.
BoxPlot
Five-number summary + outliers for statistical distribution.
RadarChart
Multi-axis polygon chart for comparing dimensions; supports multiple series.
RidgePlot
Vertically stacked density curves for multiple groups.
Gauge
Ring-shaped current-value gauge; 4 tones.
MetricCard
Value + unit + delta + embedded sparkline trend.
TimingBar
Horizontal request waterfall with one segment per phase.
LatencyHeatmap
2D matrix heatmap; green→yellow→red OKLCH hue lerp.
ConnectionGraph
Node + edge graph; default circular equidistant layout.
ChartCrosshair
Crosshair locator + tooltip helper that drops into any SVG chart.
ChartToolbar
Chart-header toolbar: title + legend toggle + zoom/export/refresh buttons.
Templates / page modules
ProtocolPane
Protocol monitor shell with SSE / MQTT / Kafka / gRPC tabs.
NetworkPane
Network capture pane with HAR / Hex / PCAP / Cert / Cookie tabs.
SqlWorkbench
SQL workbench shell with Editor / Console / History tabs.
TerminalPane
Terminal pane shell with Terminal / Output / CommandLine tabs.
CrashPane
Crash Dialog / Stack Trace / Dump Uploader / Safe Mode tabs.
PluginPane
Plugin center pane with Card / Manifest / Permission / Marketplace tabs.
DomainPane
API debugging pane with Collection / Request / Response / Mock / Workflow tabs.
OnboardingFlow
Onboarding flow shell with First-Run Wizard / Hotspot Tour / Full Flow tabs.
反馈与讨论
Components · Discussion