This repository has been archived on 2023-08-07. You can view files and clone it, but cannot push or open issues or pull requests.
temple/lib/temple/ast/components.ex

105 lines
2.4 KiB
Elixir
Raw Normal View History

defmodule Temple.Ast.Components do
2021-01-02 18:21:48 +00:00
@moduledoc false
@behaviour Temple.Parser
use TypedStruct
2021-04-09 03:04:26 +00:00
typedstruct do
field :function, function()
field :arguments, map()
field :slots, [function()]
end
@impl true
2021-01-02 18:21:48 +00:00
def applicable?({:c, _, _}) do
true
end
def applicable?(_), do: false
@impl true
def run({:c, _meta, [component_function | args]}) do
{do_and_else, args} =
args
|> Temple.Ast.Utils.split_args()
2021-04-09 03:04:26 +00:00
{do_and_else, arguments} = Temple.Ast.Utils.consolidate_blocks(do_and_else, args)
2021-04-09 03:04:26 +00:00
{default_slot, {_, named_slots}} =
if children = do_and_else[:do] do
Macro.prewalk(
children,
{component_function, []},
fn
{:c, _, [name | _]} = node, {_, named_slots} ->
{node, {name, named_slots}}
{:slot, _, [name | args]} = node, {^component_function, named_slots} ->
{arguments, slot} = split_assigns_and_children(args, nil)
if is_nil(slot) do
{node, {component_function, named_slots}}
else
Dynamic Attributes (#190) * Move directories for ast tests to match convention * feat!: Rename `:let` to `:let!` We use the "bang" style as the reserved keyword to differentiate it from other possible attributes. * feat: use Phoenix.HTML as the default engine I am choosing to leverage this library in order to quickly get dynamic attributes (see #183) up and running. This also ensures that folks who wish to use Temple outside of a Phoenix project with get some nice HTML functions as well as properly escaped HTML out of the box. This can be made optional if Temple becomes decoupled from the render and it including HTML specific packages becomes a strange. * feat: Allow user to make their own Component module The component module is essentially to defer compiling functions that the user might not need. The component, render_slot, and inner_block functions are only mean to be used when there isn't another implementation. In the case of a LiveView application, LiveView is providing the component runtime implementation. This was causing some compile time warnings for temple, because it was using the LiveView engine at compile time (for Temple, not the user's application) and LiveView hadn't been compiled or loaded. So, now we defer this to the user to make their own module and import it where necessary. * feat: Pass dynamic attributes with the :rest! attribute The :rest! attribute can be used to pass in a dynamic list of attributes to be mixed into the static ones at runtime. Since this cannot be properly escaped by any engine, we have to mark it as safe and then allow the function to escape it for us. I decided to leverage the `attributes_escape/1` function from `phoenix_html`. There isn't really any point in making my own version of this or vendoring it. Now you can also pass a variable as the attributes as well if you only want to pass through attributes from a calling component. The :rest! attribute also works with components, allowing you to pass a dynamic list of args into them. Fixes #183 * Move test components to their own file. * docs(components): Update documentation on Temple.Components * docs(guides): Mention attributes_escape/1 function in the guides * chore(test): Move helper to it's own module * feat: rest! support for slots * docs(guides): Dynamic attributes * ci: downgrade runs-on to support OTP 23
2023-01-21 11:44:29 +00:00
{parameter, attributes} = Keyword.pop(arguments || [], :let!)
new_slot = {name, %{parameter: parameter, slot: slot, attributes: attributes}}
{nil, {component_function, named_slots ++ [new_slot]}}
end
node, acc ->
{node, acc}
end
)
else
{nil, {nil, %{}}}
end
2021-04-09 03:04:26 +00:00
children =
if default_slot == nil do
2021-04-09 03:04:26 +00:00
[]
else
[
Temple.Ast.new(
Temple.Ast.Slottable,
name: :inner_block,
content: Temple.Parser.parse(default_slot)
)
]
end
slots =
for {name, %{slot: slot, parameter: parameter, attributes: attributes}} <- named_slots do
Temple.Ast.new(
Temple.Ast.Slottable,
name: name,
content: Temple.Parser.parse(slot),
parameter: parameter,
attributes: attributes
)
2021-04-09 03:04:26 +00:00
end
2021-03-15 04:46:16 +00:00
slots = children ++ slots
Temple.Ast.new(__MODULE__,
function: component_function,
arguments: arguments,
slots: slots
2021-03-15 04:46:16 +00:00
)
end
defp split_assigns_and_children(args, empty) do
case args do
[arguments, [do: block]] ->
{arguments, block}
[[do: block]] ->
{empty, block}
[arguments] ->
{arguments, nil}
_ ->
{empty, nil}
end
end
end