ScrollTarget
scrolls to the block when the server changes the target · scope · scroll_to
Smoothly scrolls to a [data-block] block when the server changes the target.
The server changes the target and the panel scrolls (and scroll_to)
Contratos
Cláusulas, vigência e reajuste.
Alternativas
Fornecedores comparados lado a lado.
Histórico
Compras anteriores e variação de preço.
Anexos
Propostas, e-mails e planilhas.
<%!-- o servidor guarda o target; o hook rola o painel até [data-block="<target>"] a cada mudança. scroll_to: LedgerUI.scroll_to(socket, ~s(#doc [data-block="historico"]), block: "start") --%> <.live_component module={LedgerShowcaseWeb.Demos.ScrollDemo} id="st-demo" />
Usage
<.scroll_target id="detail-st" target={@focus} block="start" scope="#detail-doc" />
Rules
- It scrolls once on each
targetchange (also on mount with one); the same value does not scroll again. scopelimits the search to a container, for two panels with the same block names.LedgerUI.scroll_to/3scrolls to any selector, once, without a component.- With
prefers-reduced-motion: reducethe scroll is instant.
API reference
Todos os function components, atributos, valores e slots que este componente cobre.
scroll_target/1: scrolls smoothly to a block when the server changes target.
<.scroll_target id="purchase-detail-1" target={@focus} block="nearest" />
<section data-block="contracts">...</section>
<section data-block="alternatives">...</section>
Renders a hidden element; the hook LedgerUI.ScrollTarget
(priv/static/ledger_ui/hooks/scroll_target.js) scrolls to [data-block="<target>"] once each
time target changes (also when it mounts with one). A re-render with the same target does
not scroll; nil or "" does nothing. With prefers-reduced-motion: reduce the scroll is
instant. A target with no matching element does nothing.
block is where the element lands (start, center, end, nearest).
Scope
By default the block is searched in the whole document (the first [data-block=...]). Set
scope to a CSS selector to search only inside that container, so two panels that use the
same block names do not clash:
<.scroll_target id="st-1" target={@focus} scope="#purchase-detail-1" />
From the server
LedgerUI.scroll_to(socket, selector, opts) scrolls to any selector, once, with no component
(block: and scope: as above):
{:noreply, LedgerUI.scroll_to(socket, ~s([data-block="contracts"]), block: "start")}
<.scroll_target>
| Attr | Type | Default | Values / notes |
|---|---|---|---|
id (required) |
:string |
Needed by the hook. | |
target |
:string |
nil |
Value of data-block to scroll to; scrolls on change. |
block |
:string |
"nearest" |
start, center, end, nearest |
scope |
:string |
nil |
Selector of the container searched; the whole document when nil. |
Any other HTML/phx attribute goes to the root element.