Skip to content
silverpoint
Documentation menu

UI components

UI component reference

The 17 form and display components silverpoint has shipped since 0.3 in React, Vue and Angular (and in Reflex through reflex-silverpoint-react), drawn with the charts' language: an exact frame, tone by hatching or by line weight, keyboard and screen-reader semantics from the native element. The 21 composed components and overlays of 0.7 are indexed at the end.

Actions

A native button, or a link drawn as one.

Button4 states

A native button, or a link with href.

Data entry

Native inputs, checkboxes, radios and ranges in hand-drawn frames: forms submit natively.

Input4 states

A native text input in a framed box.

Checkbox4 states

A native checkbox with an exact tick or dash.

RadioGroup2 states
Ground

A fieldset of native radios.

Switch3 states

A native checkbox with role switch.

Slider2 states

A native range over an exact rail, with marks.

Rate2 states
Quality

Native radios 1..count, each an exact lozenge.

Segmented2 states
Period

Native radios in one frame.

Navigation

Tabs with their panels and an ordered list of steps, with the WAI-ARIA keyboard patterns.

Tabs2 states
Overview: the charts of this view.

A tablist of native buttons, with tab panels.

Steps2 states
  1. Install
  2. Import
  3. Configure
  4. Publish

An ordered list of steps with their status.

Data display

Cards, toned tags, counting badges and captioned rules.

Card2 states
Hits per hour rose through the afternoon and eased at night.

A framed card with header, body and footer.

Tag2 states
draft

A framed, toned label; closable.

Badge3 states
Inbox12

A count or a dot beside its content.

Divider2 states

A rule, optionally captioned.

Feedback

Progress as a line or a circle, alerts by kind, and loading placeholders.

Progress3 states

A progressbar, a line or a circle.

Alert4 states
New ground available
cyanotype ships in 0.2.0.

An alert or a status by kind; closable.

Skeleton2 states
Loading

A loading placeholder.

All components

ComponentGroupWhat it isReact subpathAngular selectorReflex
ButtonActionsA native button, or a link with href.@silverpoint/react/ui/buttonbutton[spButton]sp_button
InputData entryA native text input in a framed box.@silverpoint/react/ui/inputsp-inputsp_input
CheckboxData entryA native checkbox with an exact tick or dash.@silverpoint/react/ui/checkboxsp-checkboxsp_checkbox
RadioGroupData entryA fieldset of native radios.@silverpoint/react/ui/radio-groupsp-radio-groupsp_radio_group
SwitchData entryA native checkbox with role switch.@silverpoint/react/ui/switchsp-switchsp_switch
SliderData entryA native range over an exact rail, with marks.@silverpoint/react/ui/slidersp-slidersp_slider
RateData entryNative radios 1..count, each an exact lozenge.@silverpoint/react/ui/ratesp-ratesp_rate
SegmentedData entryNative radios in one frame.@silverpoint/react/ui/segmentedsp-segmentedsp_segmented
TabsNavigationA tablist of native buttons, with tab panels.@silverpoint/react/ui/tabssp-tabssp_tabs
StepsNavigationAn ordered list of steps with their status.@silverpoint/react/ui/stepssp-stepssp_steps
CardData displayA framed card with header, body and footer.@silverpoint/react/ui/cardsp-cardsp_card
TagData displayA framed, toned label; closable.@silverpoint/react/ui/tagsp-tagsp_tag
BadgeData displayA count or a dot beside its content.@silverpoint/react/ui/badgesp-badgesp_badge
DividerData displayA rule, optionally captioned.@silverpoint/react/ui/dividersp-dividersp_divider
ProgressFeedbackA progressbar, a line or a circle.@silverpoint/react/ui/progresssp-progresssp_progress
AlertFeedbackAn alert or a status by kind; closable.@silverpoint/react/ui/alertsp-alertsp_alert
SkeletonFeedbackA loading placeholder.@silverpoint/react/ui/skeletonsp-skeletonsp_skeleton

Composed components and overlays (0.7)

silverpoint 0.8.0 adds 21 more on the same subpaths, for 38 in all: SpSurface and SpGlyph, the building blocks, the composed components and the overlays. Each has a page with a live demo, its code in React, Vue, Angular and Reflex, its events and its props; Composed components shows them all on one page.

ComponentWhat it isReact subpathAngular selectorReflex
SpSurfaceThe root contract on any element: the ground's class, a hand-drawn frame (control, pill, box, card or round) and a hatched tone (1–4, or a state such as selected or primary).@silverpoint/react/ui/surface[spSurface]sp_surface
SpGlyphOne exact 16×16 mark of UI_GLYPHS — tick, cross, chevrons, arrows, sort marks… — stroked with the text colour, never inked.@silverpoint/react/ui/glyphsp-glyphsp_glyph
SpTableCard-framed table: small-caps header, tabular figures, hatched striping, sortable headers with aria-sort.@silverpoint/react/ui/tablesp-tablesp_table · sort_rows
SpPaginationPrevious and next, first and last, a window around the current page (heightened); on_change(page).@silverpoint/react/ui/paginationsp-paginationsp_pagination
SpBreadcrumbA <nav> of links separated by hairline slashes; the last item is the current page.@silverpoint/react/ui/breadcrumbsp-breadcrumbsp_breadcrumb
SpAvatar · SpAvatarGroupA portrait or the person's initials in a drawn round (or square) frame; groups overlap.@silverpoint/react/ui/avatarsp-avatar · sp-avatar-groupsp_avatar · sp_avatar_group
SpStatisticA small-caps title, a large tabular figure, prefix and suffix, and a trend arrow.@silverpoint/react/ui/statisticsp-statisticsp_statistic
SpDescriptionsA label–value grid (a <dl>), optionally card-framed; one column on narrow containers.@silverpoint/react/ui/descriptionssp-descriptionssp_descriptions
SpTimelineListA vertical list of events: done (hatched), current (heightened), pending and error.@silverpoint/react/ui/timeline-listsp-timeline-listsp_timeline_list
SpCollapse · SpCollapseItemPanels that open and close, on native <details>; accordion=True keeps one open.@silverpoint/react/ui/collapsesp-collapse · sp-collapse-itemsp_collapse · sp_collapse_item
SpEmptyThe empty state: a lightly hatched, drawn tray, a line of italic text and actions.@silverpoint/react/ui/emptysp-emptysp_empty
SpResultThe outcome of an operation: a drawn round mark (tick, info, warning, cross), title and subtitle.@silverpoint/react/ui/resultsp-resultsp_result
SpTextareaMulti-line text on the SpInput contract: drawn frame, italic placeholder, counter and message.@silverpoint/react/ui/textareasp-textareasp_textarea
SpInputNumberA number field with exact − and + steppers, clamped to min and max; on_change receives the number.@silverpoint/react/ui/input-numbersp-input-numbersp_input_number
SpModalA dialog on a card frame over a hatched backdrop: focus trapped, Escape closes it.@silverpoint/react/ui/modalsp-modalsp_modal
SpDrawerThe same dialog, sliding in from any edge (side='end', the default, 'start', 'top' or 'bottom').@silverpoint/react/ui/drawersp-drawersp_drawer
SpPopoverAnchored content on a card frame, placed by the core on the Popover API; Escape or a click outside closes it.@silverpoint/react/ui/popoversp-popoversp_popover
SpTooltipA short label shown on hover or keyboard focus, after a delay.@silverpoint/react/ui/tooltipsp-tooltipsp_tooltip
SpSelectA single choice with typeahead: the chosen option ticked, the highlighted one heightened.@silverpoint/react/ui/selectsp-selectsp_select
SpDropdownMenuCommands with shortcuts, separators, labels and a danger item; on_select(key).@silverpoint/react/ui/dropdown-menusp-dropdown-menusp_dropdown_menu
SpToast · SpToasterNotices that stack in a corner and dismiss themselves; error and warning are announced assertively.@silverpoint/react/ui/toastsp-toast · sp-toastersp_toast · sp_toaster