Browser
Frame rendered content with a truthful browser title and address.
Default
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
let defaultBrowser =
fveBrowser {
div {
_class "p-[12px] text-center"
"Content preview"
}
}On this page
Installation
Copy this component and its required dependencies into the consumer-owned Components project.
dotnet fve add browser --config src/Acme.Components/fve.jsonNo additional JavaScript import is required.
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
let defaultBrowser =
fveBrowser {
div {
_class "p-[12px] text-center"
"Content preview"
}
}With an address bar
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
let browserWithAddress =
fveBrowser {
_address "https://fve.meiermade.com/components/browser"
div {
_class "grid min-h-64 content-center gap-3 bg-[var(--fve-surface-subtle)] p-[12px] text-center"
strong {
_class "text-lg"
"Content preview"
}
p {
_class "text-sm text-[var(--fve-muted-text)]"
"Rendered HTML"
}
}
}Review controls and expansion
open System
open FSharp.ViewEngine
open Acme.Components
open type Html
open type Svg
open type Datastar
let fixtureWindowControl (navigation: HtmlAttribute list) (path: string) (id: string) (expanded: bool) =
let label =
(if expanded then "Restore " else "Expand ")
+ (if id = "browser-review" then
"Browser fixture"
else
"Phone fixture")
let separator = if path.Contains('?') then "&" else "?"
fveLink {
_id ("fve-fixture-" + id + (if expanded then "-restorer" else "-launcher"))
yield! navigation
_variant LinkVariant.Outline
_color Color.Neutral
_size Size.Small
_href (
if expanded then
path + separator + "fveAppReturn=" + id
else
path + separator + "expanded=1"
)
_ariaLabel label
_title label
if expanded then
_data ("fve-app-mode-exit", "true")
else
_data ("review-expand", "true")
_dataInit (
"if (new URL(location.href).searchParams.get('fveAppReturn') === "
+ System.Text.Json.JsonSerializer.Serialize id
+ ") { el.focus({preventScroll:true}); el.scrollIntoView({block:'center'}) }"
)
fveIcon {
_name (if expanded then IconName.ArrowsPointingIn else IconName.ArrowsPointingOut)
_variant IconVariant.Mini
}
}
let browserReviewStates =
[ "summary", "Summary", "An overview of the content under review."
"details", "Details", "Supporting details for the same content."
"empty", "Empty", "No items to display in this state." ]
let browserReviewHref expanded state =
"/components/browser?state=" + state + (if expanded then "&expanded=1" else "")
let browserReviewDirection (filterNavigation: HtmlAttribute list) expanded state offset =
let index = browserReviewStates |> List.findIndex (fun (key, _, _) -> key = state)
let label, icon = if offset < 0 then "Back", IconName.ChevronLeft else "Forward", IconName.ChevronRight
let content = fveIcon { _name icon; _variant IconVariant.Mini }
match List.tryItem (index + offset) browserReviewStates with
| Some (key, _, _) ->
fveLink {
_href (browserReviewHref expanded key)
yield! filterNavigation
_variant LinkVariant.Outline
_color Color.Neutral
_size Size.Small
_ariaLabel label
_title label
content
}
| None ->
fveButton {
_variant ButtonVariant.Outline
_size Size.Small
_disabled true
_ariaLabel label
_title label
content
}
let browserReviewFrame navigation (filterNavigation: HtmlAttribute list) expanded requested =
let state, title, description =
browserReviewStates
|> List.tryFind (fun (key, _, _) -> key = requested)
|> Option.defaultValue browserReviewStates.Head
fveBrowser {
_id "browser-review-frame"
_expanded expanded
_address (browserReviewHref expanded state)
_data ("review-state", state)
fveBrowserWindowControls {
_class "w-48 max-w-full gap-1"
browserReviewDirection filterNavigation expanded state -1
fveDropdownMenu {
_id "browser-review-state"
_class "min-w-0 flex-1"
fveDropdownMenuTrigger {
_ariaLabel ("Review state: " + title)
fveButton {
_variant ButtonVariant.Outline
_size Size.Small
_class "w-full justify-between"
span { _class "min-w-0 truncate"; title }
fveIcon { _name IconName.ChevronDown; _variant IconVariant.Mini }
}
}
for key, label, _ in browserReviewStates do
fveDropdownMenuItem {
_href (browserReviewHref expanded key)
yield! filterNavigation
_ariaCurrent (if key = state then "true" else "false")
label
if key = state then
fveDropdownMenuItemTrailing { fveIcon { _name IconName.Check; _variant IconVariant.Mini } }
}
}
browserReviewDirection filterNavigation expanded state 1
}
div {
_class "grid min-h-64 content-center gap-3 p-6 text-center"
strong { _class "text-lg"; title }
p { description }
}
fveBrowserToolbarActions {
fixtureWindowControl navigation (browserReviewHref false state) "browser-review" expanded
}
}
let browserWithControls = browserReviewFrame [] [] false "summary"This example also uses Icon. See their Installation sections for any additional setup.
Back/Forward links and the state menu navigate between real server-rendered states. The address and selected state remain accurate when expanded or restored. The fixed-width navigation group keeps the state selector between Back and Forward without shifting the arrows. Browser inherits its host’s theme. Install button, link, icon and dropdown-menu; import Assets/button.js and Assets/dropdown-menu.js. fveBrowserWindowControls and fveBrowserToolbarActions accept host-owned controls; _expanded fills the viewport. The host reads the state and expanded query parameters and renders browserReviewFrame; Browser itself does not own routes or history.
API reference
module BrowserDsl =
val fveBrowser : ComponentElementBuilder
val fveBrowserWindowControls : ComponentElementBuilder
val fveBrowserToolbarActions : ComponentElementBuilder
module BrowserAttributes =
val Html._address.Static : value:string -> HtmlAttribute