mirror of https://github.com/status-im/reagent.git
359 lines
17 KiB
Markdown
359 lines
17 KiB
Markdown
# Changelog
|
||
|
||
## Unreleased
|
||
|
||
**[compare](https://github.com/reagent-project/reagent/compare/v0.8.1...master)**
|
||
|
||
- Fix using metadata to set React key with Fragment shortcut (`:<>`) ([#401](https://github.com/reagent-project/reagent/issues/401))
|
||
- Create React Component without `create-react-class` ([#416](https://github.com/reagent-project/reagent/issues/416))
|
||
- Allow any number of arguments for `reagent.core/merge-props` and
|
||
ensure `:class` is merged correctly when it is defined as collection. ([#412](https://github.com/reagent-project/reagent/issues/412))
|
||
- Add `reagent.core/class-names` utility functions which can be used
|
||
to normalize and combine `:class` values (similar to `classnames` JS library)
|
||
- Fix comparing Reagent `PartialFn` to `nil` ([#385](https://github.com/reagent-project/reagent/issues/385))
|
||
- Reagent no longer abuses `aget` or `aset` for accessing objects, and instead
|
||
uses correct Object interop forms, allowing use of ClojureScript `:checked-arrays :warn` option.
|
||
- **Removed `reagent.interop` namespace**
|
||
- These macros where bad practice and don't work properly if
|
||
React code is optimized by Closure. Proper object interop forms or `goog.object` functions
|
||
should be used instead.
|
||
|
||
## 0.8.1 (2018-05-15)
|
||
|
||
**[compare](https://github.com/reagent-project/reagent/compare/v0.8.0...v0.8.1)**
|
||
|
||
- Fix problem which caused using e.g. `:class` property with custom HTML element to break normal elements
|
||
- Fix problem using keyword or symbol as `:class` together with element tag class shorthand, e.g. `[:p.a {:class :b}]` ([#367](https://github.com/reagent-project/reagent/issues/367))
|
||
- Added support for using keywords and symbols in `:class` collection
|
||
- Removed component type assertion for `:>` ([#369](https://github.com/reagent-project/reagent/issues/369), [#372](https://github.com/reagent-project/reagent/pull/372))
|
||
- This caused problems with React Context where component is Plain JS object with special properties
|
||
- `React/createElement` will still provide error if `:>` is used with invalid values
|
||
- Handle exceptions from `not=` in Reagent `component-did-update` method ([#350](https://github.com/reagent-project/reagent/pull/350), [#344](https://github.com/reagent-project/reagent/pull/344))
|
||
|
||
## 0.8.0 (2018-04-19)
|
||
|
||
**[compare](https://github.com/reagent-project/reagent/compare/v0.8.0-rc1...v0.8.0)**
|
||
|
||
- Reagent documentation is now maintained as part of the repository, in [doc](./doc) folder.
|
||
- Default to React 16
|
||
- Apply vector metadata to the outermost element when using nesting shorthand ([#262](https://github.com/reagent-project/reagent/issues/262))
|
||
- Add `:<>` shorthand for [React Fragments](https://reactjs.org/docs/fragments.html) ([#352](https://github.com/reagent-project/reagent/pull/352)])
|
||
- Fix `:class` property with custom elements ([#322](https://github.com/reagent-project/reagent/issues/322))
|
||
- `:class` property now supports collections of strings ([#154](https://github.com/reagent-project/reagent/pull/154))
|
||
- Added `IWithMeta` to `RAtom` ([#314](https://github.com/reagent-project/reagent/pull/314))
|
||
- Support for using Reagent together with React from npm
|
||
|
||
#### Read [0.8 upgrade guide](./doc/0.8-upgrade.md) for more information.
|
||
|
||
## 0.8.0-rc1 (2018-04-11)
|
||
|
||
**[compare](https://github.com/reagent-project/reagent/compare/v0.8.0-alpha2...v0.8.0-rc1)**
|
||
|
||
Unless defaulting to React 16 causes problems, final release should follow soon.
|
||
|
||
- Reagent documentation is now maintained as part of the repository, in [doc](./doc) folder.
|
||
- Default to React 16
|
||
- Apply vector metadata to the outermost element when using nesting shorthand ([#262](https://github.com/reagent-project/reagent/issues/262))
|
||
- Add `:<>` shorthand for [React Fragments](https://reactjs.org/docs/fragments.html) ([#352](https://github.com/reagent-project/reagent/pull/352)])
|
||
- Fix `:class` property with custom elements ([#322](https://github.com/reagent-project/reagent/issues/322))
|
||
- Remove synthetic input support (added in previous alpha) ([#351](https://github.com/reagent-project/reagent/pull/351))
|
||
|
||
## 0.8.0-alpha2 (2017-10-20)
|
||
|
||
**[compare](https://github.com/reagent-project/reagent/compare/v0.8.0-alpha1...v0.8.0-alpha2)**
|
||
|
||
- Reagent still uses React 15 by default, but tests are now running and pass with React 16
|
||
- [Error boundaries](https://reactjs.org/blog/2017/07/26/error-handling-in-react-16.html)
|
||
are [supported](https://github.com/reagent-project/reagent/blob/master/test/reagenttest/testreagent.cljs#L1003-L1004)
|
||
([#272](https://github.com/reagent-project/reagent/issues/272))
|
||
- Update Cljsjs dependencies or Node packages to use React 16
|
||
- `:class` property now supports collections of strings
|
||
([#154](https://github.com/reagent-project/reagent/pull/154))
|
||
- ~~Support for marking React components as `synthetic-input`, which will fix
|
||
problems with cursor jumping around
|
||
([#282](https://github.com/reagent-project/reagent/pull/282))~~
|
||
- This was reverted due to not working for all use cases ([#351](https://github.com/reagent-project/reagent/pull/351))
|
||
- Added `IWithMeta` to `RAtom` ([#314](https://github.com/reagent-project/reagent/pull/314))
|
||
|
||
## 0.8.0-alpha1 (2017-07-31)
|
||
|
||
**[compare](https://github.com/reagent-project/reagent/compare/v0.7.0...v0.8.0-alpha1)**
|
||
|
||
**BREAKING**: Requires ClojureScript version 1.9.854
|
||
|
||
This version changes how Reagent depends on React. New ClojureScript
|
||
improves support for [npm packages](https://clojurescript.org/news/2017-07-12-clojurescript-is-not-an-island-integrating-node-modules)
|
||
and also improves the way code can refer to objects from foreign-libs,
|
||
making the transition from foreign libs, like Cljsjs packages, to npm easy: [global exports](https://clojurescript.org/news/2017-07-30-global-exports)
|
||
|
||
Previously Reagent required foreign-lib namespace `cljsjs.react` and a few others.
|
||
This worked well when using Cljsjs React package, but in other environments,
|
||
like Node, React-native and when using npm packages, users had to
|
||
exclude Cljsjs packages and create empty files providing these `cljsjs.*` namespaces.
|
||
|
||
With global-exports, foreign-libs can be used like they were real namespaces:
|
||
|
||
```cljs
|
||
(ns ... (:require [react-dom :as react-dom]))
|
||
|
||
(react-dom/render ...)
|
||
```
|
||
|
||
The same code will in all the environments, and is compiled different based on
|
||
compile target and on how the dependency is provided. When targeting
|
||
browser and using foreign libs, ClojureScript compiler uses the `:global-exports`
|
||
definition to resolve the function from global JS var:
|
||
|
||
```js
|
||
var a = window.ReactDOM;
|
||
a.render(...)
|
||
```
|
||
|
||
When targeting browser but using node_modules with Closure module processing,
|
||
the CommonJS (or ES6) module is converted to a Closure module, named
|
||
by `module$` and the path of the file, and the generated code is same as
|
||
if this was a Cljs or Closure module:
|
||
|
||
```js
|
||
module$foo$bar$react$react-dom.render(...)
|
||
```
|
||
|
||
Then targeting NodeJS the object is retrieved using `require` call:
|
||
|
||
```js
|
||
var a = require("react-dom");
|
||
a.render(...)
|
||
```
|
||
|
||
This change requires use of ClojureScript 1.9.854, using the latest Cljsjs
|
||
React packages (15.6.1-1), and it is not yet sure how well other React
|
||
libraries work with these changes, or how this will work with React-native.
|
||
Currently it looks like all the Cljsjs React libraries need to be updated
|
||
to use require `react` instead of `cljsjs.react`, as the foreign-lib
|
||
namespace was renamed to match the npm package.
|
||
|
||
React-with-addons bundle [has been deprecated](https://facebook.github.io/react/docs/addons.html) and Cljsjs no longer provides new versions
|
||
of that package. The latest React-with-addons version won't work with Reagent 0.8.
|
||
For animation utils use [react-transition-group](https://github.com/cljsjs/packages/tree/master/react-transition-group) package instead. [React-dom/test-utils](https://facebook.github.io/react/docs/test-utils.html) and [react-addons-perf](https://facebook.github.io/react/docs/perf.html) are not currently packaged as browserified files, so their use would require Webpack, or they might work with Closure module processing (TODO: Provide example).
|
||
|
||
#### Read [0.8 upgrade guide](./doc/0.8-upgrade.md) for more information.
|
||
|
||
#### Which libraries work together with Reagent 0.8:
|
||
|
||
| JS library type | Foreign library (Cljsjs) | Node module |
|
||
|---|---|---|
|
||
| Library updated to require `react`, `react-dom` names | Yes | Yes |
|
||
| Library requiring `cljsjs.react` and `cljsjs.react.dom` names | Yes | No |
|
||
|
||
Examples of libraries not yet updated: Devcards, Sablono. These will for now only work when using Cljsjs React.
|
||
|
||
## 0.7.0 (2017-06-27)
|
||
|
||
**[compare](https://github.com/reagent-project/reagent/compare/v0.6.2...v0.7.0)**
|
||
|
||
- Fixed a warning with recent ClojureScript (1.9.660+) versions about
|
||
a variadic method signature in `reagent/impl/util.cljs`.
|
||
- `reagent.core/partial` and `wrap` used a bad deftype ([#303](https://github.com/reagent-project/reagent/pull/303))
|
||
- React updated to 15.5.4 ([#292](https://github.com/reagent-project/reagent/issues/292))
|
||
- Uses [create-react-class](https://www.npmjs.com/package/create-react-class) instead of
|
||
deprecated `React.createClass`
|
||
- Reagent has now dependency on `cljsjs/create-react-class`, if you are using other
|
||
methods to provide React, you need to exclude this Cljsjs dependency and provide the library yourself.
|
||
- Self-host compatibility ([#283](https://github.com/reagent-project/reagent/pull/283))
|
||
- Removed deprecated `reagent.interop/.'` and `reagent.interop/.!` macros
|
||
- Improved assert messages all around ([#301](https://github.com/reagent-project/reagent/pull/301)).
|
||
|
||
## 0.6.2 (2017-05-19)
|
||
|
||
**[compare](https://github.com/reagent-project/reagent/compare/v0.6.1...v0.6.2)**
|
||
|
||
- React updated to 15.4.2
|
||
- Fixes a problem with `number` inputs, ([#289](https://github.com/reagent-project/reagent/issues/289), [facebook/react#8717](https://github.com/facebook/react/issues/8717))
|
||
|
||
## 0.6.1 (2017-03-10)
|
||
|
||
**[compare](https://github.com/reagent-project/reagent/compare/v0.6.0...v0.6.1)**
|
||
|
||
- Fix :ref on inputs ([#259](https://github.com/reagent-project/reagent/issues/259))
|
||
- React updated to 15.4.0 ([#275](https://github.com/reagent-project/reagent/issues/275), [#276](https://github.com/reagent-project/reagent/issues/276))
|
||
- **BREAKING:** `reagent.core` no longer provides `render-to-string` or `render-to-static-markup` functions
|
||
- `reagent.dom.server` includes the same functions
|
||
- This is due to change in React packaging, including React-dom-server would increase the file size considerably, so now it is only included when `reagent.dom.server` is used
|
||
|
||
## 0.6.0
|
||
|
||
- React updated to 15.2.1
|
||
|
||
- Fix input on-change events in IE11
|
||
|
||
|
||
## 0.6.0-rc
|
||
|
||
- React updated to 15.1.0
|
||
|
||
- Symbols and keywords are now allowed in Hiccup content. They are converted using `name`.
|
||
|
||
- Any object hat satisfies IPrintWithWriter is also allowed, and is converted using `pr-str`.
|
||
|
||
- Bug fixes, improved error handling/reporting, and lots of testing.
|
||
|
||
|
||
## 0.6.0-alpha
|
||
|
||
### Breaking changes
|
||
|
||
- Reagent now depends on `cljsjs/react-dom` and `cljsjs/react-dom-server`, rather than on `cljsjs/react` directly.
|
||
|
||
- Reactions are now asynchronous, just like Reagent components. `flush` forces outstanding reactions to run.
|
||
|
||
- Reactions now only trigger updates of dependent components if their value change, as reported by `=` (previously, `identical?` was used).
|
||
|
||
- The macros `.'` and `.!` in `reagent.interop` have been renamed to `$` and `$!` respectively.
|
||
|
||
|
||
### News
|
||
|
||
- React updated to 0.14.3
|
||
|
||
- Added `reagent.dom` and `reagent.dom.server` namespaces, corresponding to new React packages.
|
||
|
||
- `create-class` now returns a normal React class, that can be used directly from javascript.
|
||
|
||
- Add `track`: turns a function call into a reactive value.
|
||
|
||
- Add `track!`: eager version of `track`.
|
||
|
||
- Add `dispose!`: stop the derefable returned by `track!` from updating.
|
||
|
||
- Add `with-let` macro: simpler handling of lifecycle in components and reactions.
|
||
|
||
- Add `rswap!`: works like `swap!`, except that recursive calls are allowed, and they always return nil.
|
||
|
||
- `cursor` now shares state between all instances corresponding to a given set of parameters.
|
||
|
||
- `next-tick` now evokes its argument function at a clearly defined time (immediately before rendering, which is in turn triggered using requestAnimationFrame).
|
||
|
||
- `after-update` is a new function, similar to `next-tick`, except that the function is evoked immediately after rendering.
|
||
|
||
- Support `[:> nativeComp {:foo "bar"}]`
|
||
|
||
- Reagent now falls back to using `require` if global `React` is undefined, to simplify use with e.g webpack and node.js.
|
||
|
||
|
||
|
||
## 0.5.1
|
||
|
||
- React updated to 0.13.3
|
||
|
||
- Deprecate calling the result of `create-class` as a function (i.e always use hiccup forms to call Reagent components).
|
||
|
||
- Hiccup syntax has been extended to allow nested elements to be defined using '>' as part of the keyword name.
|
||
|
||
- Add `force-update` for completeness.
|
||
|
||
- Try harder to maintain cursor position in inputs.
|
||
|
||
- Simplify examples, taking advantage of new figwheel.
|
||
|
||
- Better warnings and error messages.
|
||
|
||
|
||
## 0.5.0
|
||
|
||
- React updated to 0.12.2
|
||
|
||
- Reagent no longer bundles React. Instead it uses cljsjs/react as a dependency. This means that you should no longer specify React in `:preamble` in your project.clj.
|
||
|
||
- ClojureScript 0.0-2816 or later is required.
|
||
|
||
- `adapt-react-class` makes it easier to use "native" React components with Reagent.
|
||
|
||
- `reactify-component` makes it easier to use Reagent components in JSX.
|
||
|
||
- `cursor` is re-written, to be more efficient and flexible.
|
||
|
||
- `render` now forces a deep update of all components, to make it more convenient to use with e.g. figwheel.
|
||
|
||
- Renamed `as-component` to `as-element`, to match React's new terminology better (old name still works, though, for backward compatiblity).
|
||
|
||
- Stop wrapping native components. This reduces the number of components created a lot, and can speed up some things substantially (especially render-to-string, that is not bound by browser performance). This is made possible by a new way of keeping track of which order to re-render dirty components.
|
||
|
||
- Added `create-element` to make it easier to embed native React
|
||
components in Reagent ones.
|
||
|
||
- Arguments to components are now compared using simple `=`, instead of the old, rather complicated heuristics. **NOTE**: This means all arguments to a component function must be comparable with `=` (which means that they cannot be for example infinite `seq`s).
|
||
|
||
- Reagent now creates all React components using `React.createElement` (required for React 0.12).
|
||
|
||
- `render-component` is now `render`, and `render-component-to-string` is `render-to-string`, in order to match React 0.12 (but the old names still work).
|
||
|
||
- Add `render-to-static-markup`. This works exactly like `render-to-string`, except that it doesn't produce `data-react-id` etc.
|
||
|
||
- `create-class` now takes a Reagent-style render function (i.e with the same arguments you pass to the component), called `:reagent-render`.
|
||
|
||
|
||
|
||
## 0.4.3
|
||
|
||
- React updated to 0.11.2
|
||
|
||
- Add reagent.core/cursor
|
||
|
||
- Add javascript interop macros .' and .!
|
||
|
||
- Add force-update-all to make LightTable integration easier
|
||
|
||
- Some performance optimizations
|
||
|
||
|
||
## 0.4.2
|
||
|
||
- Allow multi-methods as component functions.
|
||
|
||
- Tweak performance by avoiding `clojure.core/memoize`.
|
||
|
||
- Bugfix: Allow on-change handler on controlled inputs to keep value unchanged.
|
||
|
||
|
||
## 0.4.1
|
||
|
||
- Made Reagent compatible with ClojureScript 0.0-2173. `reagent.core/atom` now implements the necessary IAtom, ISwap and IReset protocols. Reagent should still be compatible with older ClojureScript versions, but you will get a lot of compilation warnings.
|
||
|
||
|
||
## 0.4.0
|
||
|
||
- Breaking change: Component functions can get arbitrary arguments, and not just vectors and maps. This is a breaking change, but behaviour is unchanged if you pass a map as the first argument (as in all the examples in the old documentation).
|
||
|
||
- React updated to 0.9.0.
|
||
|
||
- You can now use any object that satisfies `ifn?` as a component function, and not just plain functions. That includes functions defined with deftype, defrecord, etc, as well as collections like maps.
|
||
|
||
- `reagent.core/set-state` and `reagent.core/replace-state` are now implemented using a `reagent.core/atom`, and are consequently async.
|
||
|
||
- Keys associated with items in a seq (e.g ”dynamic children” in React parlance) can now be specified with meta-data, as well as with a `:key` item in the first parameter as before. In other words, these two forms are now equivalent: `^{:key foo} [:li bar]` and `[:li {:key foo} bar]`.
|
||
|
||
- Performance has been improved. For example, there is now practically no overhead for tracking derefs in components that don’t use atoms. Allocations and memory use have also been reduced.
|
||
|
||
- Intro and examples have been tweaked a little to take advantage of the new calling conventions.
|
||
|
||
|
||
## 0.3.0
|
||
|
||
- Changes in application state are now rendered asynchronously, using requestAnimationFrame.
|
||
|
||
- Reagent now does proper batching of updates corresponding to changed atoms, i.e parents are rendered before children, and children are only re-rendered once.
|
||
|
||
- Add `reagent.core/flush` to render changes immediately.
|
||
|
||
- Bugfix: Allow dynamic id with hiccup-style class names.
|
||
|
||
|
||
## 0.2.1
|
||
|
||
- Bugfix: allow data-* and aria-* attributes to be passed through unchanged.
|
||
|
||
|
||
## 0.2.0
|
||
|
||
- Rename Cloact to Reagent, due to popular disgust with the old name...
|