![Coveralls](https://img.shields.io/coveralls/github/BartOtten/phoenix_live_head)
[![Build Status](https://github.com/BartOtten/phoenix_live_head/actions/workflows/elixir.yml/badge.svg?event=push)](https://github.com/BartOtten/phoenix_live_head/actions/workflows/elixir.yml)
[![Last Updated](https://img.shields.io/github/last-commit/BartOtten/phoenix_live_head.svg)](https://github.com/BartOtten/phoenix_live_head/commits/main)
[![Hex.pm](https://img.shields.io/hexpm/v/phoenix_live_head)](https://hex.pm/packages/phoenix_live_head)
![Hex.pm](https://img.shields.io/hexpm/l/phoenix_live_head)

# Phoenix Live Head

  Provides commands for manipulating the HTML Head of Phoenix Live View applications
  while minimizing data over the wire.

  The available command actions support a variety of utility operations useful for
  HTML Head manipulation. Such as setting or removing tag attributes and
  adding or removing CSS classes. 

  > #### Note {: .info}
  > When using this lib directly, consider publishing a high-level lib
  > like [Phx.Live.Favicon](https://hexdocs.pm/phoenix_live_favicon/). 
  > High-level libs provide a cleaner syntax and specific documentation
  > for their intended usage.

## Documentation
Documentation can be found at [HexDocs](https://hexdocs.pm/phoenix_live_head).

## Support, Feature Requests and Contributing
See [CONTRIBUTING](CONTRIBUTING.md)


## Installation

The package can be installed by adding `phoenix_live_head` to your list of 
dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:phoenix_live_head, "~> 0.2.0"}
  ]
end
```

To include the necessary client side Javascript, import the module in `assets/js/app.js`

```javascript
import "phoenix_html"
// Establish Phoenix Socket and LiveView configuration.
import { Socket } from "phoenix"
import { LiveSocket } from "../vendor/phoenix_live_view/"
import topbar from "../vendor/topbar"
import "phoenix_live_head" // <-- ADD HERE.
```

## Development

- Assets can be build using `mix assets.build`
- Override `:phoenix_live_head` in your test application with a local path:
```elixir
# example
def deps do
  [
    {:phoenix_live_head, path: "../phoenix_live_head", override: true}
  ]
end
```