Phoenx form path with Map.put - what does it do?

I’m currently building a small Website using Elixir and Phoenix and I found this line of code in the form.html for my users resource. Can somebody explain to me what this line of code does and what to do with it?

<%= render "form_new.html", Map.put(assigns, :action, user_path(@conn, :create)) %>

I tried reading the documentation for Map.put , but it didn’t seem to be releated in any way. I’m confused because of the user_path which I don’t understand why it has to be there and also because with normal render functions the value should have been asigned to a variable.

@Jeykey Let’s split it on parts:

user_path(@conn, :create)

This one generates local path which type is String.t(). Local path is relative part to your server which means that it does not include protocol, domain and port information for example: /users/create. This path would be used in HTML form element in action attribute.

user_path/2 is function imported from your router Helpers sub-module (for example MyAppWeb.Router.Helpers). This one is generated based on your routes. For more details please see documentation pages.

Name assigns usually is a map which is used by Phoenix templates.

Map.put(assigns, :action, user_path(@conn, :create))

Map.put/3 function is really simple. For any map it adds or overrides (if key exist) specific value which could be accessed by specific key. For example:

original_map = %{a: 5}
modified_map = Map.put(original_map, :b, 10)
modified_map.b # returns: 10

Finally render/2 function simply renders specific template (here: "form_new.html") with specified assigns (here: assigns with added :action key)

Helpful resources:

  1. Map.put/3 information at Elixir documentation
  2. Helpers information at Phoenix documentation
  3. Assigns information at render/3 documentation
1 Like