Add button link attribute

Nesting a button inside an anchor tag is not valid HTML. This change
introduces a new `link` attribute in the `button` core component that,
when present, will render the button as an anchor tag instead.

Fixes #5770.
References #5814.

Author: SteffenDE

installer/templates/phx_web/components/core_components.ex

@@ -215,28 +215,45 @@ defmodule <%= @web_namespace %>.CoreComponents do
   @doc """
   Renders a button.
 
+  If `link` is passed as an attribute, the button will render as an HTML link.
+
   ## Examples
 
       <.button>Send!</.button>
       <.button phx-click="go" class="ml-2">Send!</.button>
+      <.button link={%{patch: ~p"/page"}}>Go to page</.button>
+
   """
   attr :type, :string, default: nil
+  attr :link, :map, default: nil, doc: "attributes passed to `Phoenix.Component.link/1`"
   attr :class, :string, default: nil
   attr :rest, :global, include: ~w(disabled form name value)
 
   slot :inner_block, required: true
 
   def button(assigns) do
-    ~H"""
-    <button
-      type={@type}
-      class={[
+    assigns =
+      assigns
+      |> assign(:classes, [
         "phx-submit-loading:opacity-75 rounded-lg bg-zinc-900 hover:bg-zinc-700 py-2 px-3",
         "text-sm font-semibold leading-6 text-white active:text-white/80",
-        @class
-      ]}
-      {@rest}
-    >
+        assigns.class
+      ])
+
+    button_base(assigns)
+  end
+
+  def button_base(%{link: link} = assigns) when not is_nil(link) do
+    ~H"""
+    <.link class={@classes} {@link} {@rest}>
+      <%%= render_slot(@inner_block) %>
+    </.link>
+    """
+  end
+
+  def button_base(assigns) do
+    ~H"""
+    <button type={@type} class={@classes} {@rest}>
       <%%= render_slot(@inner_block) %>
     </button>
     """

priv/templates/phx.gen.html/index.html.heex

@@ -1,9 +1,7 @@
 <.header>
   Listing <%= schema.human_plural %>
   <:actions>
-    <.link href={~p"<%= schema.route_prefix %>/new"}>
-      <.button>New <%= schema.human_singular %></.button>
-    </.link>
+    <.button link={%{href: ~p"<%= schema.route_prefix %>/new"}}>New <%= schema.human_singular %></.button>
   </:actions>
 </.header>
 

priv/templates/phx.gen.html/show.html.heex

@@ -2,9 +2,7 @@
   <%= schema.human_singular %> <%%= @<%= schema.singular %>.id %>
   <:subtitle>This is a <%= schema.singular %> record from your database.</:subtitle>
   <:actions>
-    <.link href={~p"<%= schema.route_prefix %>/#{@<%= schema.singular %>}/edit"}>
-      <.button>Edit <%= schema.singular %></.button>
-    </.link>
+    <.button link={%{href: ~p"<%= schema.route_prefix %>/#{@<%= schema.singular %>}/edit"}}>Edit <%= schema.singular %></.button>
   </:actions>
 </.header>
 

priv/templates/phx.gen.live/core_components.ex

@@ -215,28 +215,45 @@ defmodule <%= @web_namespace %>.CoreComponents do
   @doc """
   Renders a button.
 
+  If `link` is passed as an attribute, the button will render as an HTML link.
+
   ## Examples
 
       <.button>Send!</.button>
       <.button phx-click="go" class="ml-2">Send!</.button>
+      <.button link={%{patch: ~p"/page"}}>Go to page</.button>
+
   """
   attr :type, :string, default: nil
+  attr :link, :map, default: nil, doc: "attributes passed to `Phoenix.Component.link/1`"
   attr :class, :string, default: nil
   attr :rest, :global, include: ~w(disabled form name value)
 
   slot :inner_block, required: true
 
   def button(assigns) do
-    ~H"""
-    <button
-      type={@type}
-      class={[
+    assigns =
+      assigns
+      |> assign(:classes, [
         "phx-submit-loading:opacity-75 rounded-lg bg-zinc-900 hover:bg-zinc-700 py-2 px-3",
         "text-sm font-semibold leading-6 text-white active:text-white/80",
-        @class
-      ]}
-      {@rest}
-    >
+        assigns.class
+      ])
+
+    button_base(assigns)
+  end
+
+  def button_base(%{link: link} = assigns) when not is_nil(link) do
+    ~H"""
+    <.link class={@classes} {@link} {@rest}>
+      <%%= render_slot(@inner_block) %>
+    </.link>
+    """
+  end
+
+  def button_base(assigns) do
+    ~H"""
+    <button type={@type} class={@classes} {@rest}>
       <%%= render_slot(@inner_block) %>
     </button>
     """

priv/templates/phx.gen.live/index.html.heex

@@ -1,9 +1,7 @@
 <.header>
   Listing <%= schema.human_plural %>
   <:actions>
-    <.link patch={~p"<%= schema.route_prefix %>/new"}>
-      <.button>New <%= schema.human_singular %></.button>
-    </.link>
+    <.button link={%{patch: ~p"<%= schema.route_prefix %>/new"}}>New <%= schema.human_singular %></.button>
   </:actions>
 </.header>
 

priv/templates/phx.gen.live/show.html.heex

@@ -2,9 +2,12 @@
   <%= schema.human_singular %> <%%= @<%= schema.singular %>.id %>
   <:subtitle>This is a <%= schema.singular %> record from your database.</:subtitle>
   <:actions>
-    <.link patch={~p"<%= schema.route_prefix %>/#{@<%= schema.singular %>}/show/edit"} phx-click={JS.push_focus()}>
-      <.button>Edit <%= schema.singular %></.button>
-    </.link>
+    <.button
+      link={%{patch: ~p"<%= schema.route_prefix %>/#{@<%= schema.singular %>}/show/edit"}}
+      phx-click={JS.push_focus()}
+    >
+      Edit <%= schema.singular %>
+    </.button>
   </:actions>
 </.header>