Saving a layout
Save every group's sizes and collapsed panels as one JSON document, restore it before the first render, and validate what comes back from storage.
The whole layout of a model (every group, each panel's size, which panels are collapsed and the size each one expands back to) is one JSON document. The package gives you the document, its JSON Schema and its validator; where it is stored, when, and under which key is yours.
The document
model.get("splitter-json");
// {
// version: 1,
// groups: [
// { id: "persistent", panels: [{ id: "sidebar", size: 25 }, { id: "main", size: 75 }] },
// { id: "persistent-main", panels: [
// { id: "editor", size: 100 },
// { id: "terminal", size: 0, collapsed: true, restoreSize: 30 },
// ] },
// ],
// }It names groups and panels by id, so give every saved group and panel an explicit id.
Constraints are not in it: they come back with the markup. See
The JSON document.
Save on every commit, restore before the first render
"use client";
import { createSplitterModel, Splitter, type SplitterJson, validateSplitter } from "@fragiola/splitter-react";
import { useEffect, useState } from "react";
const KEY = "my-app:layout";
/** The saved layout's model; a document that is missing or invalid starts from the defaults. */
function restore() {
let saved: unknown;
try {
saved = JSON.parse(localStorage.getItem(KEY) ?? "null");
} catch {
saved = null;
}
const valid = saved !== null && validateSplitter(saved).length === 0;
return createSplitterModel(valid ? (saved as SplitterJson) : undefined);
}
export function PersistentLayout() {
const [model] = useState(restore);
useEffect(
() =>
model.subscribe((event) => {
if (event.transient) return; // a drag in progress: save its release only
try {
localStorage.setItem(KEY, JSON.stringify(model.get("splitter-json")));
} catch {
// storage blocked or full: the layout still works, it is just not saved
}
}),
[model],
);
return (
<Splitter.Group id="persistent" model={model} className="h-96">
<Splitter.Panel id="sidebar" defaultSize="25%" minSize="10%">
…
</Splitter.Panel>
<Splitter.Separator aria-label="Resize sidebar" className="w-1" />
<Splitter.Panel id="main">
<Splitter.Group id="persistent-main" orientation="vertical" className="h-full">
<Splitter.Panel id="editor" minSize="20%">
…
</Splitter.Panel>
<Splitter.Separator aria-label="Resize editor" className="h-1" />
<Splitter.Panel id="terminal" defaultSize="30%" minSize="15%" collapsible>
…
</Splitter.Panel>
</Splitter.Group>
</Splitter.Panel>
</Splitter.Group>
);
}createSplitterModel(json)restores the document before the group renders, so the first paint already has the saved sizes: there is no default layout flashing first.- One
model.subscribecovers every group of the model, nested ones included.onLayoutCommiton a group works too, for that group only. validateSplitterreturns the problems of a document (empty when it is valid). Loading an invalid one directly throws aSplitterValidationErrorwith everyissueand its JSON path, so validate whatever comes from storage, a server or a user.
The example's _kit/persistence.ts is the same code as small helpers (load, save,
forget) to copy into your app.
Panels that are not in the document
A declared panel the document does not name takes its defaultSize, and a group the user never
changed is not in the document at all: it starts from its defaults again. A saved group whose panels
have not all registered yet waits: its layout applies once the group holds exactly its saved
panels. Until then splitter-json writes it back as it was loaded, so saving a page that does
not render every group does not lose the others' layouts.
Resetting
group.reset puts a group back to its default layout; run it on every group to forget the user's
changes, and remove the stored document so the next load starts fresh:
for (const group of model.get("groups")) {
model.run("group.reset", { groupId: group.id });
}
localStorage.removeItem(KEY);On the server
The document is plain JSON and the core runs in Node: a server can validate it, store it per user, and render the page with it. See Server rendering.
Conditional panels
Show and hide panels by rendering them conditionally. Each lands where the markup puts it, with its separator; the group remembers each set's sizes.
Undo and redo
Build undo and redo from two verbs, model.subscribe and a batch of group.set-layout, so a whole drag is one step and every group comes back at once.