Class DynamicBottomBar

Restores the live dynamic bottom bar to its initial eitriConfig.dynamicBottomBar state — the colors, icons, titles, badges, font and layout it had on first render. This undoes every prior updateStyle call in one operation.

Because updateStyle is purely additive (it never resets a field to its default), this is the only way to revert the bar. The tab count is never changed; like updateStyle, an icon is re-downloaded only when its URL differs from the one currently shown (avoids flicker).

const modules = await Eitri.modules();
const resetStyle = modules?.dynamicBottomBar?.resetStyle;
if (!resetStyle) return;

await resetStyle(); // bar looks exactly as it did on first render
Copy

Updates the live dynamic bottom bar's visuals with a partial merge: only the fields present in style change; omitted fields keep their current values.

Tabs are targeted by index through a sparse items list — each entry must carry its index and only the provided sub-fields (title / icon) are applied to that tab. The tab count is never changed by this method.

This method is purely additive: a field changes only when a present, non-empty value is supplied. Omitting a key — or passing null — leaves that field unchanged. To undo previous changes and return the bar to its initial eitriConfig.dynamicBottomBar state, call resetStyle instead — updateStyle has no per-field "reset to default" semantics.

To change a tab's badge content (set/update/remove the badge text), use the updateTabBadge method instead — updateStyle only restyles badges through the global badgeBackground / badgeTextColor colors. See BottomBar.updateTabBadge.

Behavior notes:

• An icon is only re-downloaded when its URL differs from the current one (avoids flicker). The URL must be https (non-https URLs are rejected and the icon is left unchanged). Provide a transparent-background raster image (PNG); the bar tints it with the bar colors.
• Colors (backgroundColor, selectedColor, unselectedColor) are applied to the live bar and re-tint icons/labels immediately.
• badgeBackground / badgeTextColor are global (apply to all badges). Changing them re-colors badges already on screen and applies to future badges. The default (when never set on the live bar nor in the initial config) is a red background + white text. These can also be set in the initial eitriConfig.dynamicBottomBar config.
• fontFamily selects a font bundled with the brand for the tab labels. The font must already ship with the app (no runtime download). It is a per-platform object because the two platforms reference fonts by different identifiers: fontFamily.android is the Android res/font resource name (e.g. "baloo2_regular"), and fontFamily.ios is the iOS PostScript name (e.g. "Baloo2-Regular"). When a name isn't bundled/registered, labels fall back to the system font. Can also be set in the initial eitriConfig.dynamicBottomBar config.
• selectedFontFamily is the same per-platform bundled-font selector as fontFamily, but for the selected tab's label. When omitted (never set on the live bar nor in the initial config), the selected tab uses fontFamily. Can also be set in the initial eitriConfig.dynamicBottomBar config.
• topBorder is the bar's top border: topBorder.thickness (in dp/pt) and topBorder.color (hex string). Setting topBorder.thickness to 0 (or any value <= 0) removes the border, even when a color is set. Otherwise the border renders whenever a thickness greater than zero or a color is set; when both are absent the border is removed. When the border is active, each sub-field falls back on its own: an omitted thickness defaults to 1dp/pt, and an omitted/invalid color defaults to #DBDDE0. Can also be set in the initial eitriConfig.dynamicBottomBar config.
• iconSize / labelFontSize / iconLabelSpacing / paddingTop / paddingBottom are classic-theme sizing fields, plain numbers. The bar height is not configurable — it is sized to its content (paddingTop + icon [+ iconLabelSpacing + label] + paddingBottom). iconSize and labelFontSize are applied only when a value greater than zero is supplied (an omitted or <= 0 value keeps the theme default, respectively 24 and 12). iconLabelSpacing, paddingTop and paddingBottom accept zero (a negative value is ignored) — iconLabelSpacing: 0 places the icon flush against the label; their defaults are 2, 6 and 6. In the initial eitriConfig.dynamicBottomBar config these live under the classic node.

const modules = await Eitri.modules();
const updateStyle = modules?.dynamicBottomBar?.updateStyle;
if (!updateStyle) return;

// change only the selected color
await updateStyle({ selectedColor: "#FF0000" });

// relabel + change icon of tab 0
await updateStyle({
  items: [
    { index: 0, title: "Casa", icon: "https://example.com/home.png" },
  ],
});
Copy