ash_hq/lib/ash_hq_web/components/doc_sidebar.ex

228 lines
7.5 KiB
Elixir
Raw Normal View History

2022-03-29 11:05:19 +13:00
defmodule AshHqWeb.Components.DocSidebar do
@moduledoc """
Renders the sidebar data, and uses `Phoenix.LiveView.JS` to manage selection/collapsible state.
"""
use Surface.LiveComponent
2022-03-29 11:05:19 +13:00
alias AshHqWeb.Components.Search
2022-09-27 12:30:56 +13:00
alias Phoenix.LiveView.JS
alias Surface.Components.LivePatch
2022-03-29 11:05:19 +13:00
prop libraries, :any
prop remove_version, :any
prop selected_versions, :any
prop class, :any
prop sidebar_data, :any, default: []
2022-03-29 11:05:19 +13:00
def render(assigns) do
~F"""
2022-08-31 20:11:15 +12:00
<aside
id={@id}
class={"grid pb-36 z-40 bg-white dark:bg-base-dark-850", @class}
2022-08-31 20:11:15 +12:00
aria-label="Sidebar"
>
<div class="flex flex-col px-1">
<div class="text-black dark:text-white text-sm w-full px-2 mb-2">
Including Libraries:
2022-08-31 20:11:15 +12:00
</div>
<AshHqWeb.Components.VersionPills
id={"#{@id}-version-pills"}
libraries={@libraries}
remove_version={@remove_version}
selected_versions={@selected_versions}
/>
<ul class="ml-1">
{#for %{name: name, id: id, categories: categories} <- @sidebar_data}
<li id={"sidebar-#{id}"}>
<button
class="flex flex-row items-start w-full text-left rounded-lg hover:bg-base-light-100 dark:hover:bg-base-dark-750"
phx-click={collapse("sidebar-#{id}")}
>
<div
class={"chevron mr-0.5 mt-1.5 origin-center", "rotate-[-90deg]": !has_active?(categories)}
id={"sidebar-#{id}-chevron"}
>
<Heroicons.Outline.ChevronDownIcon class="w-3 h-3" />
</div>
{name}
</button>
<ul
class="ml-2"
id={"sidebar-#{id}-contents"}
style={if !has_active?(categories), do: "display: none", else: ""}
>
{#for {category, items} <- categories}
<li class="pt-1" id={"sidebar-#{id}-#{slug(category)}"}>
<button
class="flex flex-row items-start w-full text-left rounded-lg hover:bg-base-light-100 dark:hover:bg-base-dark-750"
phx-click={collapse("sidebar-#{id}-#{slug(category)}")}
>
<div
class={"chevron mr-0.5 mt-1.5 origin-center", "rotate-[-90deg]": !has_active?(items)}
id={"sidebar-#{id}-#{slug(category)}-chevron"}
>
<Heroicons.Outline.ChevronDownIcon class="w-3 h-3" />
</div>
<span class="text-base-light-500 dark:text-base-dark-300">{category}</span>
</button>
<ul
class="ml-2"
id={"sidebar-#{id}-#{slug(category)}-contents"}
style={if !has_active?(items), do: "display: none", else: ""}
>
{#for {library, items} <- items}
<li class="pt-1" id={"sidebar-#{id}-#{slug(category)}-#{slug(library)}"}>
<span class="text-base-light-500 dark:text-base-dark-300">{library}</span>
<ul class="ml-2">
{#for %{name: item_name, to: to, id: item_id, active?: active?} <- items}
{id = id(category, library, item_name, id, item_id)
nil}
<li
id={id}
class={
"rounded-lg hover:bg-base-light-100 dark:hover:bg-base-dark-750",
"bg-base-light-200 dark:bg-base-dark-700 active-sidebar-nav": active?
}
>
<LivePatch
to={to}
opts={phx_click: mark_active(id)}
class="flex flex-row items-start w-full text-left text-base-light-900 dark:text-base-dark-100"
>
{render_icon(name, category, item_name, "h-4 w-4 flex-none mt-1 mx-1", assigns)}
{item_name}
</LivePatch>
</li>
{/for}
</ul>
</li>
{/for}
</ul>
</li>
{/for}
</ul>
</li>
{/for}
</ul>
</div>
2022-03-29 11:05:19 +13:00
</aside>
"""
end
# def render_icon(assigns, "Guide") do
# ~F"""
# <Heroicons.Outline.BookOpenIcon class="h-4 w-4 flex-none mt-1 mr-1" />
# """
# end
2022-03-30 17:40:17 +13:00
# def render_icon(assigns, "Api") do
# ~F"""
# <Heroicons.Outline.SwitchHorizontalIcon class="h-4 w-4 flex-none mt-1 mx-1" />
# """
# end
2022-03-29 11:05:19 +13:00
# def render_icon(assigns, "DataLayer") do
# ~F"""
# <Heroicons.Outline.DatabaseIcon class="h-4 w-4 flex-none mt-1 mx-1" />
# """
# end
2022-03-29 11:05:19 +13:00
# def render_icon(assigns, "Notifier") do
# ~F"""
# <Heroicons.Outline.MailIcon class="h-4 w-4 flex-none mt-1 mx-1" />
# """
# end
2022-03-29 11:05:19 +13:00
# def render_icon(assigns, "Registry") do
# ~F"""
# <Heroicons.Outline.ViewListIcon class="h-4 w-4 flex-none mt-1 mx-1" />
# """
# end
2022-03-29 11:05:19 +13:00
defp render_icon("Mix Tasks", _, _, item_classes, assigns) do
Search.icon_for_type("Mix Task", item_classes, assigns)
2022-03-29 11:05:19 +13:00
end
defp render_icon("Code", _, _, item_classes, assigns) do
Search.icon_for_type("Module", item_classes, assigns)
end
defp render_icon("DSLs & Extensions", type, _item_name, item_classes, assigns) do
Search.icon_for_type(type, item_classes, assigns)
2022-03-29 11:05:19 +13:00
end
defp render_icon("Guides", "Tutorials", _item_name, item_classes, assigns) do
Search.icon_for_type("Tutorial", item_classes, assigns)
end
defp render_icon("Guides", category, _item_name, item_classes, assigns) do
type =
case category do
"Tutorials" ->
"Tutorial"
"How To" ->
"How To"
"Topics" ->
"Topic"
_ ->
"Guide"
end
2022-04-05 18:20:36 +12:00
Search.icon_for_type(type, item_classes, assigns)
end
defp render_icon(_name, _category, _item_name, item_classes, assigns) do
Search.icon_for_type("Unknown", item_classes, assigns)
end
defp id(category, library, name, id, item_id) do
if category == "Tutorials" && library == "Ash" && name == "Get Started" do
"get-started-guide"
else
"sidebar-#{id}-#{slug(category)}-#{slug(library)}-#{item_id}"
end
end
defp has_active?(list) when is_list(list), do: Enum.any?(list, &has_active?/1)
defp has_active?({_, list}), do: has_active?(list)
defp has_active?(%{active?: true}), do: true
defp has_active?(_), do: false
def mark_active(js \\ %JS{}, id) do
js
|> JS.remove_class(
"bg-base-light-200 dark:bg-base-dark-700 active-sidebar-nav",
to: ".active-sidebar-nav"
)
|> JS.add_class(
"bg-base-light-200 dark:bg-base-dark-700 active-sidebar-nav",
to: "##{id}"
)
end
def collapse(js \\ %JS{}, id) do
js
|> JS.remove_class(
"rotate-[-90deg]",
to: "##{id}-chevron.rotate-\\[-90deg\\]"
)
|> JS.add_class(
"rotate-[-90deg]",
to: "##{id}-chevron:not(.rotate-\\[-90deg\\])"
)
|> JS.toggle(to: "##{id}-contents")
2022-03-29 11:05:19 +13:00
end
2022-09-27 12:30:56 +13:00
defp slug(string) do
string
|> String.downcase()
|> String.replace(" ", "_")
|> String.replace(~r/[^a-z0-9-_]/, "-")
2022-09-27 12:30:56 +13:00
end
2022-03-29 11:05:19 +13:00
end