Changelog of @hackage/react-flux 1.2.3

1.2.3

  • Add rawJsRendering function which allows you to inject arbitrary javascript code into the rendering function of a view. This is quite low-level and should be a last resort, but it can be used if you have especially tricky 3rd-party React classes. Having said that, I suggest you try other approaches first.

  • Add transHandler and liftViewToStateHandler utility functions which can be used to transform the handler that a ReactElementM lives in.

1.2.2

  • Update the test suite to use hspec-webdriver-1.2. There was no change to any code besides the test suite.

1.2.1

  • A few fixes to get the haddock documentation (hopefully) working on hackage, no functional change to any code in this release.

1.2.0

  • (Breaking Change) Add timeout support to the AJAX functionality. This has three changes. First, the AJAX code moved into it's own module React.Flux.Ajax which is not re-exported by React.Flux. Second, the AjaxRequest has a new entry reqTimeout to optionally specify a timeout value. Finally, the jsonAjax function now takes a RequestTimeout as the first parameter.

  • reactRender and reactRenderToString now error when executed if you call them when compiling with GHC instead of GHCJS. These functions only work when using GHCJS to compile because for the actual rendering we rely on the React javascript code. In addition, there are a few haddock updates about this change.

1.1.1

  • When compiling with GHC (not GHCJS), add fake instances for FromJSVal to allow more programs to compile with GHC. (Thanks Sönke Hahn!)

  • Export functions timeToJSVal and dateToJSVal from React.Flux.Addons.Intl. These functions, which have been used internally for a while, convert a Haskell Day or UTCTime to a JavaScript date. They are useful outside of react-flux when you want to pass dates or times to messages.

  • Some haddock improvements to React.Flux.Addons.Intl.

1.1.0

  • Breaking Change - I removed the use of String and replaced it with either Text or JSString (from the Data.JSString module in ghcjs-base). If a value was just going to be passed straight into react, I made it a JSString and if the value was intended to be manipulated in Haskell I used Text. The main changes are:

    * `elemText` used to (confusingly) take a `String`.  Now there are three functions: `elemString`,
  `elemText`, and `elemJSString` that take a `String`, `Text`, and `JSString` value respectively.

* The type of `$=` now uses JSString.  `$=` is intended only to avoid ambiguity when using
  overloaded strings and string constants and `JSString` has an `IsString` instance.

* There is a new property creator `&=` which instead of converting to Aeson and then to a javascript
  value like `@=` does, `&=` uses the `ToJSVal` class from `GHCJS.Foreign.Marshal` to convert values
  directly to javascript.

* Several functions had their type changed to instead of taking a String as a param take a Text or
  JSString as a parameter

    Despite being quite a large change, it didn't take much effort for me to convert my application to this new API. You can see the conversion of the todo example application here: https://bitbucket.org/wuzzeb/react-flux/commits/a630da5f9032745ab92da6e3d9f9038915b9b319 The main things that required changing are:

    * Converting between `String` and `JSString` is done via `pack` and `unpack` in `Data.JSString`.
  Converting between `Text` and `JSString` is done via `textToJSString` and `textFromJSString`
  in the `Data.JSString.Text` module.  In fact, this conversion needed to happen in only a
  few places for me because for the most part the `IsString` instance and `OverloadedStrings`
  extension properly converted the string literals to the proper type.  A few places I needed to
  use `<>` from `Data.Monoid` to concatenate `JSString`s.

* A few places I was accidentally using `$=` for non-literal strings.  Switching these to `&=`
  was enough, since `&=` is polymorphic over the type of the property value.

* Most places using `elemText` had an error, but here it was straightforward to switch to
  either `elemString` or keep `elemText` and use `Text` values inside my store.

  • React-flux has used the shouldComponentUpdate lifetime method to prevent re-rendering in some cases, but it was finicky and sometimes wouldn't work (not a correctness bug, just a missed performance improvement). I now better understand when it works and does not work, and edited the documentation to explain this and what you can do in your own code (primarily add bang patterns to force thunks). The new documentation is at the end of the main module page.

  • The shouldComponentUpdate lifetime method now knows about view props which are tuples of size two or three, and will be able to skip re-rendering as long as each component of the tuple is unchanged (and is not a thunk).

  • React.Flux.Addons.Intl now uses a new type IntlProperty defined in the module instead of using the pair type from aeson. This allows passing arbitrary JSVals to i18n functions instead of just aeson values. This causes API breakage in formattedNumberProp, formattedDateProp, pluralProp, messageProp, and messageProp'.

  • Ability to export react views to JavaScript. callbackViewWithProps inside React.Flux.PropertiesAndEvents allows you to create a javascript function which returns a renderable and then pass that JavaScript function to a foreign JavaScript class. This is useful for example for fixed-data-table and ReactNative's ListView among others. Secondly, exportViewToJavaScript from React.Flux allows just exporting a view to a JavaScript function, which is useful to embed a Haskell application into a larger JavaScript React application.

  • Add a style combinator to easily write inline styles on elements.

  • Add viewWithIKey and viewWithSKey for views with integer and string keys. The old viewWithKey was akward to use when OverloadedStrings was enabled.

1.0.7

  • Fix the build when building with GHC instead of GHCJS (an import was incorrectly protected by CPP)

1.0.6

  • Fix a rare bug in stateful view event handlers: occasionally deepseq was not called and so there was a race between react reusing the event and the haskell code extracting data from the event.
  • Add overlapping pragmas to the Callback instances, making the callback function easier to use without requiring explicit type signatures. This change is backwards compatible.
  • Some minor documentation updates.

1.0.5

  • Fix a bug in the jsonAjax implementation: the request body was not properly JSON encoded.

1.0.4

  • Add helper functions ajax and jsonAjax to React.Flux.Combinators to assist with sending a request to the backend and turning the response into actions. See the haddocks for more information.

  • Everything in react-flux is working with no changes against React 15 release candidate 1, although react-bootstrap is currently not compatible (https://github.com/react-bootstrap/react-bootstrap/issues/1686).

  • Everything in React.Flux.Addons.Intl is working with no changes with react-intl 2.0 release candidate 1.

1.0.3

  • I switched to using stack to build, and updated the documentation to explain how to use stack. It is still possible to use cabal but I suggest using stack. There is no functionality change in this release, just updated documentation.

1.0.2

1.0.1

  • Add formatting support for properties to React.Flux.Addons.Intl. These are needed for example to translate the placeholder text for an input element. This improvement caused a few changes to the types the Internal module.

  • Add a new example purecss-side-menu showing a responsive side menu built with PureCSS.

  • Add classNames function to React.Flux.PropertiesAndEvents to allow easily setting class names based on calculations.

  • Add a new module React.Flux.Combinators which is re-exported by React.Flux. The Combinators module contains useful utilities that while not required, make your life a little simpler.

1.0.0

  • Bindings to react-intl (http://formatjs.io/react/) for i18n support. This is useful even if your app is a single language, as it allows easy number, date, relative time, and message formatting like pluralization. It also supports multiple locales and translations of messages.

  • The type of callback has extended to allow arbitrary function properties to be passed to foreign classes. The old callback accepted callbacks of type Aeson.Value -> handler while the new callback allows functions of any number of arguments, as long as each argument implements FromJSVal. Since Aeson.Value implements FromJSVal, any existing calls to callback should still work. This change also caused some changes to types in React.Flux.Internal.

  • Add a function nestedProperty to React.Flux.PropertiesAndEvents to create nested properties.

  • Support for React 0.14

    • React 0.13 and 0.14 are both supported from the same Haskell code, the differences are handled internally.
    • If you are using React 0.14, you will have to include react-dom.min.js and make sure the ReactDOM variable is protected by closure similar to how React must be protected.
    • initializeTouchEvents has been removed from React 0.14, so you can remove the call from your app.
    • The SVG image_ tag is now supported by React.Flux.DOM.
    • The new media events on images and videos don't have direct Haskell equivalents, instead the handlers can be created by the new on function in React.Flux.PropertiesAndEvents.
    • The CSS transitions in React.Flux.Addons.React were made simpler by just passing the raw properties. There were several changes to the possible properties in React 0.14 and covering them all from Haskell is not worth it when the properties can easily be created directly.

  • reactRenderToString was added to allow executing a react-flux application using node.

0.9.4

  • Fix to build with latest ghcjs-base (requires at least aaa4d59117f37d1b9c60a154a9128b3bcc6301cd) of ghcjs-base), so you may need to recompile ghcjs and ghcjs-base.
  • Add a function 'property' to create a property from any JSVal, not just Aeson values.
  • Add a function 'elementProperty' to create a property from a ReactElementM, useful for interacting with foreign React classes.

0.9.3

  • Don't require web-routes dependency if not building the routing example

0.9.2

  • Bindings to react-bootstrap and the react addons
  • Add new routing example application (thanks Vladimir Sekissov!)

0.9.1

  • Switch to use the improved-base branch of ghcjs (thanks Vladimir Sekissov!)

0.9.0

  • Initial release