Package com.onec.ui.divkit

Class ShellLayoutBuilder

java.lang.Object

com.onec.ui.divkit.ShellLayoutBuilder

public final class ShellLayoutBuilder
extends Object

Emits the app chrome as two independent DivKit cards — the topbar (brand + actions) and the nav — so the client can position them per NavStyle: nav as a horizontal TOPBAR, a vertical SIDEBAR rail, or a pinned BOTTOM_BAR. Splitting them lets a sidebar sit beside content and a bottom bar pin below it; a single combined card couldn't do both.

Navigation/profile/logout intents are onec:// action URLs the host maps to routes, profile re-fetches, and session calls.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	ShellLayoutBuilder.Logo	A branding logo for the shell header / mobile menu: the (theme-resolved) image URL plus optional fixed width/height in dp.
static final record	ShellLayoutBuilder.NavItem
static final record	ShellLayoutBuilder.NavSection
static final record	ShellLayoutBuilder.ProfileLink

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ACTIVE_VAR	The DivKit variable holding the current route.

Method Summary

Modifier and Type	Method	Description
static Map<String,Object>	account(String userName, List<ShellLayoutBuilder.ProfileLink> profiles, String activeProfileId, Palette p)	The account island: the signed-in user, any persona switcher, and the theme / sign-out actions.
static Map<String,Object>	menu(String brand, ShellLayoutBuilder.Logo logo, List<ShellLayoutBuilder.NavSection> nav, String userName, List<ShellLayoutBuilder.ProfileLink> profiles, String activeProfileId, Palette p)	The full-screen mobile menu: every navigation destination grouped by section as tappable rows, with the account block (persona switcher, theme, sign-out) below.
static Map<String,Object>	nav(String brand, ShellLayoutBuilder.Logo logo, List<ShellLayoutBuilder.NavSection> nav, NavStyle style, boolean compact, Palette p)	The navigation card, shaped for the chosen NavStyle.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

ACTIVE_VAR

public static final String ACTIVE_VAR

The DivKit variable holding the current route. Nav item colors bind to it via expressions, so the active highlight follows navigation client-side without re-fetching the shell — the host updates this one variable on each route change.

See Also:

• Constant Field Values

Method Details

account

public static Map<String,Object> account(String userName,
 List<ShellLayoutBuilder.ProfileLink> profiles,
 String activeProfileId,
 Palette p)

The account island: the signed-in user, any persona switcher, and the theme / sign-out actions. On desktop it sits under the nav rail; on mobile it's served as the /account page (reached from a bottom-bar tab).

nav

public static Map<String,Object> nav(String brand,
 ShellLayoutBuilder.Logo logo,
 List<ShellLayoutBuilder.NavSection> nav,
 NavStyle style,
 boolean compact,
 Palette p)

The navigation card, shaped for the chosen NavStyle. The client positions it (beside / below content); this only decides its inner layout. Built from native DivKit primitives so every official SDK renders it.

logo (a configured branding ShellLayoutBuilder.Logo, or null) replaces the text brand in the sidebar header when present.

menu

public static Map<String,Object> menu(String brand,
 ShellLayoutBuilder.Logo logo,
 List<ShellLayoutBuilder.NavSection> nav,
 String userName,
 List<ShellLayoutBuilder.ProfileLink> profiles,
 String activeProfileId,
 Palette p)

The full-screen mobile menu: every navigation destination grouped by section as tappable rows, with the account block (persona switcher, theme, sign-out) below. It's the overflow target for the bottom bar's "More" tab, so nothing the bar can't fit becomes unreachable.