* fix: keep bookmark density consistent * fix: prioritize bookmark titles in compact rows * fix: preserve compact bookmark text fallback
52 lines
2.2 KiB
Plaintext
52 lines
2.2 KiB
Plaintext
---
|
|
title: "Bookmarks"
|
|
description: "Keeps useful links together"
|
|
hide_title: true
|
|
---
|
|
|
|
import { WidgetInteractionGuide } from "@site/src/components/widgets/interactions";
|
|
|
|
import { AddingWidget } from "@site/src/components/widgets/adding";
|
|
import { WidgetConfig } from "@site/src/components/widgets/configuration";
|
|
import { WidgetHeader } from "@site/src/components/widgets/header";
|
|
import { bookmarksWidget } from ".";
|
|
|
|
<WidgetHeader widget={bookmarksWidget} categories={["Links", "Apps"]} />
|
|
|
|
The Bookmarks widget keeps direct URLs and Homarr Apps in one ordered list. URLs do not require an App record; Homarr
|
|
uses the site's favicon when available. Choose adaptive, compact-grid, or other layouts from the widget configuration.
|
|
Vertical uses consistent compact rows and keeps bookmark names visible whenever the widget is wide enough, regardless
|
|
of how many bookmarks are configured. Adaptive and grid layouts reduce card height and spacing to show as many
|
|
bookmarks as possible before scrolling. Horizontal uses a compact, centered scrolling row with narrower cards in
|
|
one-row widgets. Horizontal, vertical, compact-grid, and icon-only layouts keep their gaps tight. Compact grid also
|
|
preserves its configured columns when the dashboard is scaled. Bookmark cards, icons, text, and gaps keep the same
|
|
visual density when a low-column dashboard is enlarged to fill the screen.
|
|
|
|
### Screenshots
|
|
|
|
import gridIconsOnly from "./img/grid-icons-only.png";
|
|
import gridWithTitle from "./img/grid-with-title.png";
|
|
import verticalListAll from "./img/vertical-list-all.png";
|
|
import verticalListSimple from "./img/vertical-list-simple.png";
|
|
|
|
<div className='flex gap-1'>
|
|
<div className='flex flex-col gap-1'>
|
|
<img src={gridIconsOnly} alt="bookmarks grid icons-only" width={128} height={128} />
|
|
<img src={verticalListSimple} alt="bookmarks vertical-list no-domain" width={128} height={128} />
|
|
</div>
|
|
|
|
<img src={gridWithTitle} alt="bookmarks grid with-title" width={256 + 4} height={256 + 4} />
|
|
<img src={verticalListAll} alt="bookmarks vertical-list all-elements" width={128} height={256 + 4} />
|
|
|
|
</div>
|
|
|
|
<WidgetInteractionGuide />
|
|
|
|
### Adding the widget
|
|
|
|
<AddingWidget />
|
|
|
|
### Configuration
|
|
|
|
<WidgetConfig configuration={bookmarksWidget.configuration} />
|