phoenix_webcomponent
v3.2.4
Published
[![release](https://github.com/gsmlg-dev/phoenix_webcomponent/actions/workflows/test-and-release.yml/badge.svg)](https://github.com/gsmlg-dev/phoenix_webcomponent/actions/workflows/test-and-release.yml)
Downloads
47
Readme
Phoenix.WebComponent
Collection of helpers to generate and manipulate Web Component.
Although this project was originally extracted from Phoenix, it does not depend on Phoenix and can be used with any Plug application (or even without Plug).
See the docs for more information.
About at Web Component
Install
Add deps in mix.exs
{:phoenix_webcomponent, "~> 3.0"},
Include in phoenix view helpers
defp html_helpers do
quote do
# import all helper functions
use Phoenix.WebComponent
# or
use Phoenix.WebComponent, :alias
...
end
end
Include javascript
import 'phoenix_webcomponent';
Web Componet library is now external
npm install @gsmlg/lit
Import css
@import 'phoenix_webcomponent/priv/static/phoenix_webcomponent.css';
Use custom hook
import "phoenix_webcomponent";
const PhxWCHook = window.__PhxWCHook__;
const liveSocket = new LiveSocket("/live", Socket, {hooks: { PhxWCHook }});
Send custom events to live view:
<Element phx-wc-send-sync-content="load_content" phx-hook="PhxWCHook" />
<Element phx-wc-send-sync-content="load_content;loadAccepted" phx-hook="PhxWCHook" />
- In the first element, when element trigger customEvents
sync-content
, also usepushEvent
sendload_content
to live view. - Second element are same as first, but will call
loadAccepted
on element when receive server send feedback.
Receive live view event:
<Element phx-wc-receive-update_content="updateContent" phx-hook="PhxWCHook" />
<!-- equal -->
<Element phx-wc-receive="update_content;updateContent" phx-hook="PhxWCHook" />
- In this case, when live view fire
update_content
event, also triggerupdateContent
method on elmenet. - If value(
updateContent
) is empty, trigger a same eventupdate_content
on element.
Import CSS
import "phoenix_webcomponent/priv/static/phoenix_webcomponent.css"