Changelog

Unreleased

This version breaks with the existing API quite a lot 🔥, since we changed the library to take advantage of the recent develpments in Phoenix and LiveView.

Breaking

All ui_* component helpers are now instead HEEx function components. They will expect the options and arguments now through component attributes. The only exception is ui_button, which still delegate to the linkhelper given via link_fn, but is also available as component. In order to migrate to the new components update to Phoenix 1.6.0 and LiveView 1.17.0 and change all templates from *.html.eex to *.html.heex to be able to use the new component syntax. After that you can change your previous `ui*` helpers to use the new syntax:

<%= ui_badge("foo", variant: "warning") %> => <.ui_badge variant: "warning">foo</.ui_badge>

If you have contexts, where you do not want to use heex templates yet, you can call the functions via Phoenix.LiveView.Helpers.component/2.

Below is a list of changes that happened besides the componentization:

  • Renamed ui_error_tag to ui_error
  • ui_input dropped datetime input type (was not working anyways)
  • ui_input dropped radio input type (use ui_unwrapped_input with radio_button instead)
  • ui_input dropped textarea input type (use ui_textarea instead)
  • Removed ui_time/2 without replacement for now
  • Removed xclassnames/1. Use classnames/1 from the same module instead.
  • classnames/1 now returns false instead of empty string when there is no class set.
  • Removed BitstylesPhoenix.Components module. Instead of use BitstylesPhoenix.Components do use BitstylesPhoenix.
  • Removed all e2e_classname options. Use class instead, which will trim the e2e classes by default (like before).
  • Changed trim_e2e_classes config. In order to migrate change the following
    config :bitstyles_phoenix, :trim_e2e_classes, false
    =>
    config :bitstyles_phoenix, :trim_e2e_classes, [enabled: false]

Added

  • All components now accept extra attributes that are passed on to the outermost parent attribute.
  • Config option to configure classnames/1 prefixes to remove other prefixes than e2e- instead (e.g. test-).
  • Backwards compatibility option for different versions of bitstyles (see bitstyles_version config option)
  • The BitstylesPhoenix.Icon components file attribute can now get a default value via icon_file application config.
  • ui_dropdown and ui_js_dropdown (Live/Alpine3) components
  • BitstylesPhoenix.Live and BitstylesPhoenix.Alpine3 for quick imports of the live and alpine3 components
  • Integration tests and example configuration with the demo app
  • Added ui_icon_button/2 & ui_icon_button/3 as helpers.
  • Added various new components: Button, Tabs, Breadcrumbs, Sidebar, Dropdown, Content ...
  • Added icon option to ui_button.
  • Added support for :datetime type in ui_input, rendered as Browser-native datetime input element

Changed

  • Added dependency to phoenix_live_view >= 1.17.0 (for using sigil_H/1 and new component syntax)
  • Doctest now use floki to prettify the output HTML, so docs will be a nicer read.
  • classnames/1 is now imported by default with use BitstylesPhoenix
  • Updated to bitstyles v3.0.0
  • ui_errors now uses larger padding

v0.8.0

Changed

  • Updated phoenix_html dependency to ~> 3. See its changelog for backwards incompatible changes.

v0.7.0

  • Added link_fn option in ui_button to support LiveView's live_patch/live_redirect

v0.6.0

Changed

  • Updated dependencies

Breaking

  • Update to bitstyles 1.5.0 (Update flash component padding)

v0.5.1

Fixed

v0.5.0

Added

  • Better documentation for form helpers

Changes

  • Multiple errors on ones field are now rendered as a list

Breaking/Bugfix

  • Do not forward options from form helpers to each label anymore, but instead pass options through label_opts.
  • Drop hidden and reset input types for ui_input.

Deprecations

  • deprecated ui_error/2 in favour of the new ui_errors/2

v0.4.0

Added

  • BitstylesPhoenix.UseSVG.ui_svg/2 to display inline svg references with <use> tags and support for external SVGs.
  • Make BitstylesPhoenix.Icon.ui_icon/2 use ui_svg internally to support the external option.

Fixes

  • Fix icons in docs for BitstylesPhoenix.Icon.ui_icon/2.

v0.3.0

Changes

  • Examples and showcases are now inlined and doctested, to assure they won't break and to be more scalable for more components.
  • Restructured top level module doc

Added

  • Badge component
  • Flash component
  • New option to specify pixel width & height for SVG icons
  • Added a CHANGELOG.md, this file

Breaking

  • Moved components from BitstylesPhoenix.Components.* to BitstylesPhoenix.*. Not actionable if you use use BitstylesPhoenix.Components