Mithril

API (v0.1.22)

Core

Routing

m.route

Data

HTML

m.trust

Rendering

Testing

m.deps

History

Change Log

v0.1.22 - maintenance

News:

docs now have anchor links for easier navigation
there is more documentation for things that weren't that clear
json-p support added
m() now supports splat for children (e.g. m("div", m("a"), m("b"), m("i")) for nicer Coffeescript syntax
by popular demand, m.module now returns a controller instance

Bug Fixes:

gracefully degrade on IE exceptions when setting invalid values
fixes for Typescript definition file
fixed bug in keys algorithm when mixing keyed and unkeyed elements #246
added promise exception monitor and reverted promise exception handling semantics to v0.1.19 semantics (see docs)
fixed redraw scheduling bug in old version of IE
fixed incorrect diff when document is root, and html element is omitted
fixed querystring clobbering in links w/ config:m.route #261
fixed rare bug that made events get dropped #214
don't send Content-Type header if there's no request data #280

v0.1.21 - maintenance

News:

passing a promise to an m.prop now populates it with the resolved value upon resolution, and returns undefined otherwise
m.redraw can now be forced to called synchronously

Bug Fixes:

fixed handling of + character in m.route.param #204
fixed corner case for undefined children in diff #206
fixed context.onunload for array items #200
fixed handling on comments in HTML converter tool

v0.1.20 - maintenance

News:

redraw strategy can now be modified via m.redraw.strategy
math tags now automatically get created with the MathML namespace

Bug Fixes:

fixed IE8 null reference exception in m
fixed IE8 empty-text-node-in-input issue #195
fixed m.sync resolution when passed an empty array #191

v0.1.19 - maintenance

Bug Fixes:

fixed double redraw when events fire simultaneously #151
fixed node insertion bug when using document as root #153
prevent routes from reverting to original route in some cases
fixed nested array ordering #156
fixed key ordering in interpolation case #157

v0.1.18 - maintenance

Bug Fixes:

routing now correctly clears diff cache #148
fixed incorrect context unloading when reattaching a child to a new parent

v0.1.17 - maintenance

News:

config contexts can now have an onunload property for clean up tasks after elements are detached from the document
route changes now re-render from scratch, rather than attempting a virtual dom diff
virtual elements that are children of an array can now accept a key attribute which maintains the identity of the underlying DOM elements when the array gets shuffled #98

Bug Fixes:

fixed a subtree directive bug that happened in inputs inside loops
fixed select.value so that the correct option is displayed on first render
in m.request, non-idempotent methods now automatically send appropriate Content-Type header if serialize is JSON.stringify #139
m selectors now correctly handle empty attribute values like [href='']
pre-existing nodes in a root element now get cleared if there's no cell cache associated with the element #60

v0.1.16 - maintenance

News:

controller::onunload now receives an event parameter so that the unloading can be aborted #135

Bug Fixes:

prevent route change when only hash changes in non-hash mode #107
config now always runs after template is attached to document #109
fix null reference exception with Browserify #110
fix nested array removal edge cases #120
ignore redraw calls when controller is not ready #127
fix null reference exception in nested array edge case #129
fix a contenteditable null reference error #134
fix textarea value diffing when value is a node inside an array #136
fix diff bug with trusted strings #138

Breaking changes:

Due to the poor level of compatibility between XDomainRequest and XHR2, XDomainRequest is no longer called internally by Mithril. If you need to use CORS in IE9 or lower, you will need to return an XDomainRequest instance from m.request's config method #121

v0.1.15 - maintenance

Bug Fixes:

m.sync now correctly passes arguments to resolver in same order as input arguments #96
fixed diff deletion bug #99
updating textarea attributes updates its value correctly #100

v0.1.14 - maintenance

News:

The signature of m now accepts virtual elements as the second parameter of the function.
m.route(path, params) now accepts an argument that gets parsed as a querystring.
routes now ignore trailing slashes #88

Bug Fixes:

Resolving promises early without a value now works #85
Throwing exceptions within m.request now follow the same resolution procedure as m.deferred #86
Promises now always update their m.prop on success (and leave the m.prop alone on error)
Nested arrays no longer cause double removal of elements #87
HTTP error codes now correctly reject promises

v0.1.13 - maintenance

News:

m.module now runs clean-up code in root module controllers that implement an onunload instance method #82

Bug Fixes:

Removing CSS rules now diffs correctly #79

v0.1.12 - maintenance

News:

It's now possible to define variadic routes #70

Bug Fixes:

Fix link location in links using config: m.route after redraws #74
Fixed support for list attribute in inputs #69
Fixed URL decoding in route params #75

v0.1.11 - maintenance

News:

Added m.route() overload to allow reading of current route #61
Added background option to m.request to allow requests that don't affect rendering #62

Bug Fixes:

Links using config: m.route can now be opened in new tab correctly #64
Fixed diff within contenteditable areas #65

v0.1.10 - maintenance

News:

Added social buttons to homepage

Bug Fixes:

Bi-directional bindings no longer wipe out cursor position in Chrome #58

v0.1.9 - maintenance

News:

Added comparison with React to homepage
Added support for multi-island apps #34
m.prop is now JSON-serializable #54
Added extract option to m.request to allow access to response metadata #53

Bug Fixes:

Fixed node index displacement by null/undefined nodes #56
Fixed mock's insertBefore and appendChild when dealing w/ reattachments

Breaking changes:

changing an id in a virtual element now recreates the element, instead of recycling it #55

v0.1.8 - maintenance

News:

Mock now contains a basic insertAdjacentHTML implementation to enable better testing of m.trust / m.render interactions

Bug Fixes:

Fixed ordering bug in deep subchildren #51
Fixed ordering bug with trusted strings #51

v0.1.7 - maintenance

News:

Mithril will be on a accelerated release cycle for the rest of the v0.1.x series. This means CDNs may lag behind in versions, so it's recommended that you either use one of the supported NodeJS package managers or fork from the Github repo directly. More information can be found here

Bug Fixes:

Fixed ordering bug when virtual element is preceded by array #50

v0.1.6 - maintenance

Bug Fixes:

Fixed serious bug when mixing cached text nodes with new virtual elements #49

v0.1.5 - maintenance

News:

Launched the Mithril Blog

Bug Fixes:

Fixed serious ordering problem when mixing arrays with virtual elements #48

v0.1.4 - maintenance

News:

added regression tests for reported bugs
added support for SVG

Bug Fixes:

URLs with port numbers are now handled correctly #40
NPM package now contains unminified version for map files #39
fixed ordering issue when mixing newly created virtual elements with elements from cache #44
fixed caching bug in links w/ config option attached #43
fixed attribute update bug when an element has both oninput and onkeydown handlers #36

v0.1.3 - maintenance

News:

Mithril is now available via Component
There's now an extra low-level optimization hook called a SubtreeDirective, which allows implementing plugins that only create virtual trees if necessary.

Bug Fixes:

diff no longer touch the DOM when processing style attributes and event handlers
returning a thennable to a resolution callback in m.deferred().promise now causes the promise to adopt its state
diff now correctly clears subtree if null or undefined is passed as a node

v0.1.2 - maintenance

News:

There's now a community mailing list. There's also a web interface
Mithril is now on Travis CI. The build status can be found in the project homepage
Mithril is now available via the CommonJS and AMD API
Mithril can now be installed via npm and bower

Bug Fixes:

m.render now correctly reattaches reused DOM elements to replaced parent nodes #31
UI actions that can potentially de-synchronize the DOM from cache now force synchronization #29

v0.1.1 - maintenance

News:

Mithril is now available at cdnjs and jsdelivr

Bug Fixes:

m.route.param now resets on route change correctly #15
m.render now correctly ignores undefined values in the virtual tree#16
errors thrown in promises now cause downstreams to be rejected #1

Breaking changes:

changed default value for xhr.withCredentials from true to false for m.request, since public APIs are more common than auth-walled ones. #14

In order to configure this flag, the following configuration should be used:
```
var privateAPI = function(xhr) {xhr.withCredentials = true};

m.request({method: "GET", url: "http://foo.com/api", config: privateAPI});
```

v0.1 - Initial release