## 0.6.0 (2020-01-22) ### Deprecations LiveView `mount/2` has been deprecated in favor of `mount/3`. The params are now passed as the first argument to `mount/3`, followed by the session and socket. ### Backwards incompatible changes - The socket session now accepts only string keys ### Enhancements - Allow window beforeunload to be cancelled without losing websocket connection ### Bug Fixes - Fix handle_params not decoding URL path parameters properly - Fix LiveViewTest error when routing at root path - Fix URI encoded params failing to be decoded in `handle_params` - Fix component target failing to locate correct component when the target is on an input tag ## 0.5.2 (2020-01-17) ### Bug Fixes - Fix optimization bug causing some DOM nodes to be removed on updates ## 0.5.1 (2020-01-15) ### Bug Fixes - Fix phx-change bug causing phx-target to not be used ## 0.5.0 (2020-01-15) LiveView now makes the connection session automatically available in LiveViews. However, to do so, you need to configure your endpoint accordingly, **otherwise LiveView will fail to connect**. The steps are: 1) Find `plug Plug.Session, ...` in your endpoint.ex and move the options `...` to a module attribute: @session_options [ ... ] 2) Change the `plug Plug.Session` to use said attribute: plug Plug.Session, @session_options 3) Also pass the `@session_options` to your LiveView socket: socket "/live", Phoenix.LiveView.Socket, websocket: [connect_info: [session: @session_options]] 4) You should define the CSRF meta tag inside in your layout, before `app.js` is included: <%= csrf_meta_tag() %> 5) Then in your app.js: let csrfToken = document.querySelector("meta[name='csrf-token']").getAttribute("content"); let liveSocket = new LiveSocket("/live", Socket, {params: {_csrf_token: csrfToken}}); Also note that **the session from now on will have string keys**. LiveView will warn if atom keys are used. ### Enhancements - Respect new tab behavior in `live_link` - Add `beforeUpdate` and `beforeDestroy` JS hooks - Make all assigns defined on the socket mount available on the layout on first render - Provide support for live layouts with new `:layout` option - Detect duplicate IDs on the front-end when DEBUG mode is enabled - Automatically forward the session to LiveView - Support "live_socket_id" session key for identifying (and disconnecting) LiveView sockets - Add support for `hibernate_after` on LiveView processes - Support redirecting to full URLs on `live_redirect` and `redirect` - Add `offsetX` and `offsetY` to click event metadata - Allow `live_link` and `live_redirect` to exist anywhere in the page and it will always target the main LiveView (the one defined at the router) ### Backwards incompatible changes - `phx-target="window"` has been removed in favor of `phx-window-keydown`, `phx-window-focus`, etc, and the `phx-target` binding has been repurposed for targetting LiveView and LiveComponent events from the client - `Phoenix.LiveView` no longer defined `live_render` and `live_link`. These functions have been moved to `Phoenix.LiveView.Helpers` which can now be fully imported in your views. In other words, replace `import Phoenix.LiveView, only: [live_render: ..., live_link: ...]` by `import Phoenix.LiveView.Helpers` ## 0.4.1 (2019-11-07) ### Bug Fixes - Fix bug causing blurred inputs ## 0.4.0 (2019-11-07) ### Enhancements - Add `Phoenix.LiveComponent` to compartmentalize state, markup, and events in LiveView - Handle outdated clients by refreshing the page with jitter when a valid, but outdated session is detected - Only dispatch live link clicks to router LiveView - Refresh the page for graceful error recovery on failed mount when the socket is in a connected state ### Bug Fixes - Fix `phx-hook` destroyed callback failing to be called in certain cases - Fix back/forward bug causing LiveView to fail to remount ## 0.3.1 (2019-09-23) ### Backwards incompatible changes - `live_isolated` in tests no longer requires a router and a pipeline (it now expects only 3 arguments) - Raise if `handle_params` is used on a non-router LiveView ### Bug Fixes - [LiveViewTest] Fix function clause errors caused by HTML comments ## 0.3.0 (2019-09-19) ### Enhancements - Add `phx-debounce` and `phx-throttle` bindings to rate limit events ### Backwards incompatible changes - IE11 support now requires two additional polyfills, `mdn-polyfills/CustomEvent` and `mdn-polyfills/String.prototype.startsWith` ### Bug Fixes - Fix IE11 support caused by unsupported `getAttributeNames` lookup - Fix Floki dependency compilation warnings ## 0.2.1 (2019-09-17) ### Bug Fixes - [LiveView.Router] Fix module concat failing to build correct layout module when using custom namespace - [LiveViewTest] Fix `phx-update` append/prepend containers not building proper DOM content - [LiveViewTest] Fix `phx-update` append/prepend containers not updating existing child containers with matching IDs ## 0.2.0 (2019-09-12) ### Enhancements - [LiveView] Add new `:container` option to `use Phoenix.LiveView` - [LiveViewTest] Add `live_isolated` test helper for testing LiveViews which are not routable ### Backwards incompatible changes - Replace `configure_temporary_assigns/2` with 3-tuple mount return, supporting a `:temporary_assigns` key - Do not allow `redirect`/`live_redirect` on mount nor in child live views - All `phx-update` containers now require a unique ID - `LiveSocket` JavaScript constructor now requires explicit dependency injection of Phoenix Socket constructor. For example: ```javascript import {Socket} from "phoenix" import LiveSocket from "phoenix_live_view" let liveSocket = new LiveSocket("/live", Socket, {...}) ``` ### Bug Fixes - Fix `phx-update=append/prepend` failing to join new nested live views or wire up new phx-hooks - Fix number input handling causing some browsers to reset form fields on invalid inputs - Fix multi-select decoding causing server error - Fix multi-select change tracking failing to submit an event when a value is deselected - Fix live redirect loop triggered under certain scenarios - Fix params failing to update on re-mounts after live_redirect - Fix blur event metadata being sent with type of `"focus"` ## 0.1.2 ### Backwards incompatible changes - `phx-value` has no effect, use `phx-value-*` instead - The `:path_params` key in session has no effect (use `handle_params` in `LiveView` instead) ## 0.1.1 (2019-08-27) ### Enhancements - Use optimized `insertAdjacentHTML` for faster append/prepend and proper css animation handling - Allow for replacing previously appended/prepended elements by replacing duplicate IDs during append/prepend instead of adding new DOM nodes ### Bug Fixes - Fix duplicate append/prepend updates when parent content is updated - Fix JS hooks not being applied for appending and prepended content ## 0.1.0 (2019-08-25) ### Enhancements - The LiveView `handle_in/3` callback now receives a map of metadata about the client event - For `phx-change` events, `handle_in/3` now receives a `"_target"` param representing the keyspace of the form input name which triggered the change - Multiple values may be provided for any phx binding by using the `phx-value-` prefix, such as `phx-value-myval1`, `phx-value-myval2`, etc - Add control over the DOM patching via `phx-update`, which can be set to `"replace"`, `"append"`, `"prepend"` or `"ignore"` ### Backwards incompatible changes - `phx-ignore` was renamed to `phx-update="ignore"`