Components
Links
Links
One link component for plain anchors, live patches and live redirects - pick the navigation mode with link_type. It also underpins button, tab and dropdown items, so everything that navigates shares the same grammar.
Types
heex
Copy
<.a to="/" class="" label="Link" />
<.a link_type="live_patch" to="/" class="" label="Link" />
<.a link_type="live_redirect" to="/" class="" label="Link" />
<!-- We use Phoenix.HTML.Link.link() -->
<.a to="/" method="put" class="" label="Link" />
Every variant renders Phoenix.Component.link/1 under the hood, with a different attribute:
link_type="a"becomes a plainhreflink_type="live_patch"becomespatchlink_type="live_redirect"becomesnavigate
All props are forwarded, so you can do something like this:
heex
Copy
<.a to="/logout" method={:delete} class="" label="Logout" />
Properties
elixir
Copy
# <.a>
attr(:class, :string, default: "", doc: "CSS class for link")
attr(:link_type, :string, default: "a", values: ["a", "live_patch", "live_redirect", "button"])
attr(:label, :string, default: nil, doc: "label your link")
attr(:to, :string, default: nil, doc: "link path")
attr(:disabled, :boolean, default: false, doc: "disables your link")
attr(:rest, :global, include: ~w(method download))
slot(:inner_block, required: false)