Table
Render typed tabular data with responsive layouts, row headers, selection, hierarchy, and actions.
Default
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type TeamMember =
{ id: int
name: string
email: string
role: string }
let teamMembers =
[ { id = 1
name = "Alex Morgan"
email = "[email protected]"
role = "Owner" }
{ id = 2
name = "Jamie Lee"
email = "[email protected]"
role = "Member" }
{ id = 3
name = "Riley Chen"
email = "[email protected]"
role = "Member" }
{ id = 4
name = "Sam Rivera"
email = "[email protected]"
role = "Guest" } ]
let teamTableHeader =
fveTableHeader {
fveTableRow {
fveTableHead { "Name" }
fveTableHead { "Email" }
fveTableHead { "Role" }
}
}
let teamTableRows (members: TeamMember list) =
fragment {
for person in members do
fveTableRow {
fveTableHead {
_scope "row"
_mobile Mobile.Primary
_class "font-medium"
person.name
}
fveTableCell {
_label "Email"
person.email
}
fveTableCell {
_label "Role"
person.role
}
}
}
let simpleTeamTable =
fveTable {
_ariaLabel "Team members"
teamTableHeader
fveTableBody { teamTableRows teamMembers }
}On this page
Installation
Copy this component and its required dependencies into the consumer-owned Components project.
dotnet fve add table --config src/Acme.Components/fve.jsonAdd to src/Acme.Web/js/app.js once, alongside your other component imports:
import '../../Acme.Components/Components/Assets/table.js';The CLI resolves dependencies and preserves consumer-authored files. See Installation for project initialization, Tailwind, the shared runtime, and building/loading your app entry.
Usage
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type TeamMember =
{ id: int
name: string
email: string
role: string }
let teamMembers =
[ { id = 1
name = "Alex Morgan"
email = "[email protected]"
role = "Owner" }
{ id = 2
name = "Jamie Lee"
email = "[email protected]"
role = "Member" }
{ id = 3
name = "Riley Chen"
email = "[email protected]"
role = "Member" }
{ id = 4
name = "Sam Rivera"
email = "[email protected]"
role = "Guest" } ]
let teamTableHeader =
fveTableHeader {
fveTableRow {
fveTableHead { "Name" }
fveTableHead { "Email" }
fveTableHead { "Role" }
}
}
let teamTableRows (members: TeamMember list) =
fragment {
for person in members do
fveTableRow {
fveTableHead {
_scope "row"
_mobile Mobile.Primary
_class "font-medium"
person.name
}
fveTableCell {
_label "Email"
person.email
}
fveTableCell {
_label "Role"
person.role
}
}
}
let simpleTeamTable =
fveTable {
_ariaLabel "Team members"
teamTableHeader
fveTableBody { teamTableRows teamMembers }
}Comfortable rows
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type TeamMember =
{ id: int
name: string
email: string
role: string }
let teamMembers =
[ { id = 1
name = "Alex Morgan"
email = "[email protected]"
role = "Owner" }
{ id = 2
name = "Jamie Lee"
email = "[email protected]"
role = "Member" }
{ id = 3
name = "Riley Chen"
email = "[email protected]"
role = "Member" }
{ id = 4
name = "Sam Rivera"
email = "[email protected]"
role = "Guest" } ]
let teamTableHeader =
fveTableHeader {
fveTableRow {
fveTableHead { "Name" }
fveTableHead { "Email" }
fveTableHead { "Role" }
}
}
let teamTableRows (members: TeamMember list) =
fragment {
for person in members do
fveTableRow {
fveTableHead {
_scope "row"
_mobile Mobile.Primary
_class "font-medium"
person.name
}
fveTableCell {
_label "Email"
person.email
}
fveTableCell {
_label "Role"
person.role
}
}
}
let comfortableTeamTable =
fveTable {
_ariaLabel "Team members with comfortable rows"
_density Density.Comfortable
teamTableHeader
fveTableBody { teamTableRows teamMembers }
}Hover highlighting
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type TeamMember =
{ id: int
name: string
email: string
role: string }
let teamMembers =
[ { id = 1
name = "Alex Morgan"
email = "[email protected]"
role = "Owner" }
{ id = 2
name = "Jamie Lee"
email = "[email protected]"
role = "Member" }
{ id = 3
name = "Riley Chen"
email = "[email protected]"
role = "Member" }
{ id = 4
name = "Sam Rivera"
email = "[email protected]"
role = "Guest" } ]
let teamTableHeader =
fveTableHeader {
fveTableRow {
fveTableHead { "Name" }
fveTableHead { "Email" }
fveTableHead { "Role" }
}
}
let teamTableRows (members: TeamMember list) =
fragment {
for person in members do
fveTableRow {
fveTableHead {
_scope "row"
_mobile Mobile.Primary
_class "font-medium"
person.name
}
fveTableCell {
_label "Email"
person.email
}
fveTableCell {
_label "Role"
person.role
}
}
}
let hoverTeamTable =
fveTable {
_ariaLabel "Team members with hover highlighting"
_hoverRows true
_style "--fve-table-row-hover:var(--fve-brand-subtle)"
teamTableHeader
fveTableBody { teamTableRows teamMembers }
}Use _hoverRows true to opt in. The optional --fve-table-row-hover token changes only this table. By default, hover composites a subtle dark/light wash into the table’s opaque background; sticky cells reuse the same color. Selected rows keep their selected background, and keyboard focus remains independent.
With status values
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type TeamMember =
{ id: int
name: string
email: string
role: string }
let teamMembers =
[ { id = 1
name = "Alex Morgan"
email = "[email protected]"
role = "Owner" }
{ id = 2
name = "Jamie Lee"
email = "[email protected]"
role = "Member" }
{ id = 3
name = "Riley Chen"
email = "[email protected]"
role = "Member" }
{ id = 4
name = "Sam Rivera"
email = "[email protected]"
role = "Guest" } ]
let memberStatusTable =
fveTable {
_ariaLabel "Team member status"
fveTableHeader {
fveTableRow {
fveTableHead { "Name" }
fveTableHead { "Email" }
fveTableHead { "Status" }
}
}
fveTableBody {
for person in teamMembers do
fveTableRow {
fveTableHead {
_scope "row"
person.name
}
fveTableCell { person.email }
fveTableCell {
if person.role = "Guest" then
fveBadge {
_color Color.Warning
"Invited"
}
else
fveBadge {
_color Color.Success
"Active"
}
}
}
}
}With checkboxes
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type TeamMember =
{ id: int
name: string
email: string
role: string }
let teamMembers =
[ { id = 1
name = "Alex Morgan"
email = "[email protected]"
role = "Owner" }
{ id = 2
name = "Jamie Lee"
email = "[email protected]"
role = "Member" }
{ id = 3
name = "Riley Chen"
email = "[email protected]"
role = "Member" }
{ id = 4
name = "Sam Rivera"
email = "[email protected]"
role = "Guest" } ]
let selectableTeamTable =
let keys =
teamMembers
|> List.map (fun person -> string person.id)
|> System.Text.Json.JsonSerializer.Serialize
fveTable {
_id "team-member-selection"
_ariaLabel "Selectable team members"
_dataSignals "{tableMemberSelection:[]}"
_dataOn ("fve-selection-clear", "$tableMemberSelection = []")
_dataEffect
"el.dispatchEvent(new CustomEvent('fve-table-selection-change', {bubbles:true, detail:{keys:Array.from($tableMemberSelection)}}))"
output {
_role "status"
_ariaLive "polite"
_class "sr-only"
_dataText "$tableMemberSelection.length + ' selected'"
"0 selected"
}
fveTableHeader {
fveTableRow {
fveTableHead {
fveCheckbox {
_class "fve-table-checkbox"
_ariaLabel "Select all rows on this page"
_dataEffect
$"el.checked = $tableMemberSelection.length === {teamMembers.Length}; el.indeterminate = $tableMemberSelection.length > 0 && !el.checked"
_dataOn ("change", $"$tableMemberSelection = el.checked ? {keys} : []")
}
}
fveTableHead { "Name" }
fveTableHead { "Email" }
fveTableHead { "Role" }
}
}
fveTableBody {
for person in teamMembers do
let key = string person.id
fveTableRow {
_dataAttr ("data-selected", $"$tableMemberSelection.includes('{key}') ? 'true' : 'false'")
fveTableCell {
fveCheckbox {
_name "memberIds"
_value key
_class "fve-table-checkbox"
_ariaLabel ("Select " + person.name)
_dataEffect $"el.checked = $tableMemberSelection.includes('{key}')"
_dataOn (
"change",
$"$tableMemberSelection = el.checked ? [...$tableMemberSelection.filter(key => key !== '{key}'), '{key}'] : $tableMemberSelection.filter(key => key !== '{key}')"
)
}
}
fveTableHead {
_scope "row"
person.name
}
fveTableCell { person.email }
fveTableCell { person.role }
}
}
}Scrollable rows and sticky headings
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type TeamMember =
{ id: int
name: string
email: string
role: string }
let teamMembers =
[ { id = 1
name = "Alex Morgan"
email = "[email protected]"
role = "Owner" }
{ id = 2
name = "Jamie Lee"
email = "[email protected]"
role = "Member" }
{ id = 3
name = "Riley Chen"
email = "[email protected]"
role = "Member" }
{ id = 4
name = "Sam Rivera"
email = "[email protected]"
role = "Guest" } ]
let teamTableHeader =
fveTableHeader {
fveTableRow {
fveTableHead { "Name" }
fveTableHead { "Email" }
fveTableHead { "Role" }
}
}
let teamTableRows (members: TeamMember list) =
fragment {
for person in members do
fveTableRow {
fveTableHead {
_scope "row"
_mobile Mobile.Primary
_class "font-medium"
person.name
}
fveTableCell {
_label "Email"
person.email
}
fveTableCell {
_label "Role"
person.role
}
}
}
let scrollableTeamTable =
fveTable {
_ariaLabel "Team members in a bounded viewport"
_class "h-28"
_scrollRows true
teamTableHeader
fveTableBody { teamTableRows teamMembers }
}Stacked on mobile
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type TeamMember =
{ id: int
name: string
email: string
role: string }
let teamMembers =
[ { id = 1
name = "Alex Morgan"
email = "[email protected]"
role = "Owner" }
{ id = 2
name = "Jamie Lee"
email = "[email protected]"
role = "Member" }
{ id = 3
name = "Riley Chen"
email = "[email protected]"
role = "Member" }
{ id = 4
name = "Sam Rivera"
email = "[email protected]"
role = "Guest" } ]
let teamTableHeader =
fveTableHeader {
fveTableRow {
fveTableHead { "Name" }
fveTableHead { "Email" }
fveTableHead { "Role" }
}
}
let teamTableRows (members: TeamMember list) =
fragment {
for person in members do
fveTableRow {
fveTableHead {
_scope "row"
_mobile Mobile.Primary
_class "font-medium"
person.name
}
fveTableCell {
_label "Email"
person.email
}
fveTableCell {
_label "Role"
person.role
}
}
}
let mobileTeamTable =
fveTable {
_ariaLabel "Team members as mobile records"
_mobileLayout MobileLayout.Records
teamTableHeader
fveTableBody { teamTableRows teamMembers }
}Sortable records
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type TeamMember =
{ id: int
name: string
email: string
role: string }
let teamMembers =
[ { id = 1
name = "Alex Morgan"
email = "[email protected]"
role = "Owner" }
{ id = 2
name = "Jamie Lee"
email = "[email protected]"
role = "Member" }
{ id = 3
name = "Riley Chen"
email = "[email protected]"
role = "Member" }
{ id = 4
name = "Sam Rivera"
email = "[email protected]"
role = "Guest" } ]
let teamTableRows (members: TeamMember list) =
fragment {
for person in members do
fveTableRow {
fveTableHead {
_scope "row"
_mobile Mobile.Primary
_class "font-medium"
person.name
}
fveTableCell {
_label "Email"
person.email
}
fveTableCell {
_label "Role"
person.role
}
}
}
type TeamMemberSort =
| NameAscending
| NameDescending
| RoleAscending
| RoleDescending
let private teamMemberSortUrl sort direction =
$"/components/table?sort={sort}&direction={direction}"
let private sortFor column current =
match column, current with
| "name", NameAscending
| "role", RoleAscending -> "ascending", "desc"
| "name", NameDescending
| "role", RoleDescending -> "descending", "asc"
| _ -> "unsorted", "asc"
let private teamSortHeading (column: string) (heading: string) current =
let state, next = sortFor column current
fveTableHead {
if state <> "unsorted" then
_ariaSort state
a {
_href (teamMemberSortUrl column next)
_class "fve-table-sort-control"
_ariaLabel $"Sort by {heading}; currently {state}"
_dataOn (
"click",
"if (evt.button === 0 && !evt.metaKey && !evt.ctrlKey && !evt.shiftKey && !evt.altKey) { evt.preventDefault(); @get(el.getAttribute('href').replace('/components/table?', '/components/table/sort?'), { filterSignals: { exclude: /.*/ }, retry: 'never' }) }"
)
heading
span {
_ariaHidden true
if state = "ascending" then "↑"
elif state = "descending" then "↓"
else "↕"
}
}
}
let sortableTeamTable current =
let members =
match current with
| NameAscending -> teamMembers |> List.sortBy _.name
| NameDescending -> teamMembers |> List.sortByDescending _.name
| RoleAscending -> teamMembers |> List.sortBy _.role
| RoleDescending -> teamMembers |> List.sortByDescending _.role
fveTable {
_ariaLabel "Sortable team members"
_mobileLayout MobileLayout.Records
fveTableHeader {
fveTableRow {
teamSortHeading "name" "Name" current
fveTableHead { "Email" }
teamSortHeading "role" "Role" current
}
}
fveTableBody { teamTableRows members }
}Hierarchical items
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type HierarchyItem =
{ key: string
ancestors: string list
level: int
name: string
kind: string
count: int
hasChildren: bool }
let hierarchyItems =
[ { key = "projects"
ancestors = []
level = 0
name = "Projects"
kind = "Folder"
count = 24
hasChildren = true }
{ key = "website"
ancestors = [ "projects" ]
level = 1
name = "Website"
kind = "Folder"
count = 12
hasChildren = true }
{ key = "notes"
ancestors = [ "projects"; "website" ]
level = 2
name = "Project notes"
kind = "Document"
count = 1
hasChildren = false }
{ key = "design"
ancestors = [ "projects"; "website" ]
level = 2
name = "Design files"
kind = "Folder"
count = 11
hasChildren = false }
{ key = "research"
ancestors = [ "projects" ]
level = 1
name = "Research"
kind = "Folder"
count = 12
hasChildren = false }
{ key = "shared"
ancestors = []
level = 0
name = "Shared files"
kind = "Folder"
count = 8
hasChildren = true }
{ key = "guide"
ancestors = [ "shared" ]
level = 1
name = "Team guide"
kind = "Document"
count = 1
hasChildren = false } ]
let hierarchicalItemTable =
fveTable {
_ariaLabel "Item hierarchy"
_mobileLayout MobileLayout.Records
_dataSignals "{itemHierarchyExpanded:['projects','website','shared']}"
fveTableHeader {
fveTableRow {
fveTableHead { "Name" }
fveTableHead { "Type" }
fveTableHead {
_class "text-right"
"Items"
}
}
}
fveTableBody {
for row in hierarchyItems do
let key = System.Text.Json.JsonSerializer.Serialize row.key
let ancestors = System.Text.Json.JsonSerializer.Serialize row.ancestors
let expanded = $"$itemHierarchyExpanded.includes({key})"
fveTableRow {
_id ("hierarchy-" + row.key)
_dataShow $"{ancestors}.every(key => $itemHierarchyExpanded.includes(key))"
fveTableHead {
_scope "row"
_mobile Mobile.Primary
span {
_class "inline-flex items-center gap-2"
_style $"padding-inline-start:{row.level}rem"
if row.hasChildren then
button {
_type "button"
_class
"inline-flex size-8 items-center justify-center rounded focus-visible:outline-2 focus-visible:outline-[var(--fve-brand-ring)]"
_dataAttr ("aria-expanded", expanded)
_dataAttr (
"aria-label",
$"({expanded} ? 'Collapse ' : 'Expand ') + {System.Text.Json.JsonSerializer.Serialize row.name}"
)
_dataOn (
"click",
$"$itemHierarchyExpanded = {expanded} ? $itemHierarchyExpanded.filter(key => key !== {key}) : [...$itemHierarchyExpanded, {key}]"
)
span {
_ariaHidden true
_dataText $"{expanded} ? '▾' : '▸'"
}
}
else
span {
_ariaHidden true
_class "inline-block size-8"
}
a {
_href "/components/table"
_class "font-medium text-[var(--fve-brand-text)]"
row.name
}
}
}
fveTableCell {
_label "Type"
row.kind
}
fveTableCell {
_label "Items"
_class "text-right"
string row.count
}
}
}
}Row actions
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
let moreActionsIcon = fveIcon { _name IconName.EllipsisHorizontal; _variant IconVariant.Micro }
type RowActionAccount = { id: int; name: string; canDelete: bool }
let rowActionAccounts =
[ { id = 101; name = "Operating checking"; canDelete = false }
{ id = 104; name = "Savings"; canDelete = false }
{ id = 105; name = "Unassigned expense"; canDelete = true } ]
let rowActionMenu prefix (account: RowActionAccount) =
let href = $"/examples/application/accounts/{account.id}"
fveDropdownMenu {
_id ($"{prefix}-{account.id}")
_class "ms-auto shrink-0"
_ariaLabel ("Actions for " + account.name)
fveDropdownMenuTrigger {
fveButton {
_variant ButtonVariant.Ghost
_size Size.Small
_class "aria-expanded:bg-[var(--fve-surface-active)]"
moreActionsIcon
}
}
fveDropdownMenuItem { _href href; "Open account" }
fveDropdownMenuItem { _href (href + "/edit"); "Edit account" }
fveDropdownMenuSeparator { () }
fveDropdownMenuItem {
_href (href + "/delete")
_color Color.Error
_disabled (not account.canDelete)
if not account.canDelete then _description "Has a balance or recorded transactions"
"Delete account"
}
}
let rowActionsTable =
fveTable {
_ariaLabel "Accounts with row actions"
fveTableHeader {
fveTableRow { fveTableHead { "Account" }; fveTableHead { _class "text-right"; "Actions" } }
}
fveTableBody {
for account in rowActionAccounts do
fveTableRow {
fveTableHead { _scope "row"; _mobile Mobile.Primary; account.name }
fveTableCell {
_label "Actions"; _class "fve-table-actions text-right"
rowActionMenu "table-row-actions" account
}
}
}
}This example also uses Button, DropdownMenu, Icon. See their Installation sections for any additional setup.
Compose Button and Dropdown menu in an actions column; Table does not own record operations. The optional installation links below lead to their focused component recipes.
Empty state
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
let teamTableHeader =
fveTableHeader {
fveTableRow {
fveTableHead { "Name" }
fveTableHead { "Email" }
fveTableHead { "Role" }
}
}
let emptyTeamTable =
fveTable {
_ariaLabel "Empty team members"
teamTableHeader
fveTableBody { () }
fveTableEmpty {
fveEmptyState {
_label "No team members"
_description "Team members will appear here when added."
}
}
}Infinite scroll
open Giraffe
open Microsoft.Extensions.DependencyInjection
open StarFederation.Datastar
open StarFederation.Datastar.DependencyInjection
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
type TeamMember =
{ id: int
name: string
email: string
role: string }
let teamTableHeader =
fveTableHeader {
fveTableRow {
fveTableHead { "Name" }
fveTableHead { "Email" }
fveTableHead { "Role" }
}
}
let infiniteTeamMembers =
[ for number in 1..24 ->
{ id = number
name = $"Team member {number}"
email = $"member{number}@fve.meiermade.com"
role = "Member" } ]
let infiniteTeamRows offset =
fragment {
for person in infiniteTeamMembers |> List.skip offset |> List.truncate 8 do
fveTableRow {
_id $"infinite-person-{person.id}"
fveTableHead {
_scope "row"
person.name
}
fveTableCell { person.email }
fveTableCell { person.role }
}
let next = min (offset + 8) infiniteTeamMembers.Length
if next < infiniteTeamMembers.Length then
fveTableRow {
_id $"people-more-{next}"
_dataOnIntersect (
[ "once" ],
$"@get('/components/table/more?offset={next}', {{filterSignals: {{exclude: /.*/}}, retry: 'never'}})"
)
fveTableCell {
_colspan 3
span {
_role "status"
"Loading more members…"
}
}
}
}
let infiniteTeamTable =
fveTable {
_id "infinite-team-table"
_ariaLabel "More team members"
_class "h-64"
_scrollRows true
teamTableHeader
fveTableBody { infiniteTeamRows 0 }
}
let tableMoreHandler: HttpHandler =
fun _ context ->
task {
match Int32.TryParse(context.Request.Query["offset"].ToString()) with
| true, offset when offset > 0 && offset < infiniteTeamMembers.Length && offset % 8 = 0 ->
do! System.Threading.Tasks.Task.Delay(300, context.RequestAborted)
let datastar = context.RequestServices.GetRequiredService<IDatastarService>()
do!
datastar.PatchElementsAsync(
infiniteTeamRows offset |> Render.toString,
PatchElementsOptions(
Selector = $"#people-more-{offset}",
PatchMode = ElementPatchMode.Replace
),
context.RequestAborted
)
return Some context
| _ ->
context.Response.StatusCode <- 400
return Some context
}
let tableMoreRoutes: HttpHandler =
Giraffe.Core.GET >=> route "/components/table/more" >=> tableMoreHandlerScroll the rows. The loading row replaces itself with the next batch; the final batch has no loading row.
API reference
type Surface =
| Panel
| Plain
type MobileLayout =
| Scroll
| Records
type Mobile =
| Field
| Primary
| Summary
| Actions
type TableBuilder
type TableSectionBuilder
type TablePartBuilder
module TableDsl =
val fveTable : TableBuilder
val fveTableHeader : TableSectionBuilder
val fveTableBody : TableSectionBuilder
val fveTableFooter : TableSectionBuilder
val fveTableCaption : TableSectionBuilder
val fveTableEmpty : TableSectionBuilder
val fveTableRow : TablePartBuilder
val fveTableHead : TablePartBuilder
val fveTableCell : TablePartBuilder
module TableAttributes =
val Html._surface.Static : value:Surface -> HtmlAttribute
val Html._mobileLayout.Static : value:MobileLayout -> HtmlAttribute
val Html._mobile.Static : value:Mobile -> HtmlAttribute
val Html._scrollRows.Static : value:bool -> HtmlAttribute
val Html._hoverRows.Static : value:bool -> HtmlAttribute