12.4 kBMarkdownView Raw
1# Changelog
4## [1.6.0] - 2021-?-??
6## [1.5.0] - 2021-7-12
8* Support tracking of button clicked during a form submission
9* Conditional polling via the [hx-trigger](/attributes/hx-trigger) attribute
10* `document` is now a valid pseudo-selector on the [hx-trigger](/attributes/hx-trigger) `from:` argument, allowing you
11 to listen for events on the document.
12* Added the [hx-request](/attributes/hx-request) attribute, allowing you to configure the following aspects of the request
13 * `timeout` - the timeout of the request
14 * `credentials` - if the request will send credentials
15 * `noHeaders` - strips all headers from the request
16* Along with the above attribute, you can configure the default values for each of these via the corresponding `htmx.config`
17 properties (e.g. `htmx.config.timeout`)
18* Both the `scroll` and `show` options on [hx-swap](/attributes/hx-swap) now support extended syntax for selecting the
19 element to scroll or to show, including the pseudo-selectors `window:top` and `window:bottom`.
21## [1.4.1] - 2021-6-1
23* typo fix
25## [1.4.0] - 2021-5-25
27* Added the `queue` option to the [hx-trigger](/attributes/hx-trigger) attribute, allowing you to specify how events
28 should be queued when they are received with a request in flight
29* The `htmx.config.useTemplateFragments` option was added, allowing you to use HTML template tags for parsing content
30 from the server. This allows you to use Out of Band content when returning things like table rows, but it is not
31 IE11 compatible.
32* The `defaultSettleDelay` was dropped to 20ms from 100ms
33* Introduced a new synthetic event, [intersect](/docs#pecial-events) that allows you to trigger when an item is scrolled into view
34 as specified by the `IntersectionObserver` API
35* Fixed timing issue that caused exceptions in the `reveal` logic when scrolling at incredible speeds - <https://github.com/bigskysoftware/htmx/issues/463>
36* Fixed bug causing SVG titles to be incorrectly used as page title - <https://github.com/bigskysoftware/htmx/issues/459>
37* Boosted forms that issue a GET will now push the URL by default - <https://github.com/bigskysoftware/htmx/issues/485>
38* Better dispatch of request events when an element is removed from the DOM
39* Fixed a bug causing `hx-prompt` to fail
40* The `htmx.config.withCredentials` option was added, to send credentials with ajax requests (default is `false`)
41* The `throttle` option on `hx-trigger` does not delay the initial request any longer
42* The `meta` key is ignored on boosted links
43* `<script>` tags are now evaluated in the global scope
44* `hx-swap` now supports the `none` option
45* Safari text selection bug - <https://github.com/bigskysoftware/htmx/issues/438>
47## [1.3.3] - 2021-4-5
49* Added the [`hx-disabled`](/docs#security) attribute to allow htmx to be turned off for parts of the DOM
50* SSE now uses a full-jitter exponential backoff algorithm on reconnection, using the `htmx.config.wsReconnectDelay`
51 setting
53## [1.3.2] - 2021-3-9
55* Bug fixes
57## [1.3.1] - 2021-3-9
59* IE11 fixes
61## [1.3.0] - 2021-3-6
63* Support a `target` modifier on `hx-trigger` to filter based on the element targeted by an event. This allows
64 lazy binding to that target selector.
65* Events are no longer consumed by the first element that might handle them, unless the `consume` keyword is
66 added to the `hx-trigger` specification
67* Added the `htmx:beforeSend` event, fired just before an ajax request begins
68* SSE swaps are properly settled
69* Fixed bug that was improperly cancelling all clicks on anchors
70* `htmx.ajax()` now returns a promise
72## [1.2.1] - 2021-2-19
74* Fixed an issue with the history cache, where the cache was getting blown out after the first navigation backwards
75* Added the `htmx.config.refreshOnHistoryMiss` option, allowing users to trigger a full page refresh on history cache miss
76 rather than issuing an AJAX request
78## [1.2.0] - 2021-2-13
80### New Features
82* `hx-vars` has been deprecated in favor of `hx-vals`
83* `hx-vals` now supports a `javascript:` prefix to achieve the behavior that `hx-vars` provided
84* The new `hx-headers` attribute allows you to add headers to a request via an attribute. Like `hx-vals` it supports
85 JSON or javascript via the `javascript:` prefix
86* `hx-include` will now include all inputs under an element, even if that element is not a form tag
87* The [preload extension](https://htmx.org/extensions/preload/) now offers a `preload-images="true"` attribute that will aggressively load images in preloaded content
88* On requests driven by a history cache miss, the new `HX-History-Restore-Request` header is included so that the server
89 can differentiate between history requests and normal requests
91### Improvements & Bug fixes
93* Improved handling of precedence of input values to favor the enclosing form (see [here](https://github.com/bigskysoftware/htmx/commit/a10e43d619dc340aa324d37772c06a69a2f47ec9))
94* Moved event filtering logic *after* `preventDefault` so filtering still allows events to be properly handled
95* No longer trigger after swap events on elements that have been removed via an `outerHTML` swap
96* Properly remove event handlers added to other elements when an element is removed from the DOM
97* Handle the `scroll:` modifier in `hx-swap` properly when an `outerHTML` swap occurs
98* Lots of docs fixes
100## [1.1.0] - 2021-1-6
102* Newly added [preload extension](https://htmx.org/extensions/preload/) allows you to preload resources for lower
103 latency requests!
104* Support the `ignore:` modifier for extensions
105* Updated form variable order inclusion to include the enclosing form *last* so that, in the presence of multiple
106 values, the most relevant value is the most likely to be selected by the server
107* Support for the [`htmx.ajax()`](https://dev.htmx.org/api/#ajax) javascript function, to issue an htmx-style ajax
108 request from javascript
109* Removed the following htmx request headers for better cache behavior: `HX-Event-Target`, `HX-Active-Element`,
110 `HX-Active-Element-Name`, `HX-Active-Element-Value`
111* Added the [`hx-preserve`](https://dev.htmx.org/attributes/hx-preserve) attribute, which allows
112 you to preserve elements across requests (for example, to keep a video element playing properly)
113* The [path-deps](https://dev.htmx.org/extensions/path-deps/#refresh) now surfaces a small api
114 for refreshing path dependencies manually in javascript
115* Now support the `from:` clause on [`hx-trigger`](https://dev.htmx.org/attributes/hx-trigger) to
116 allow an element to respond to events on other elements.
117* Added the `htmx:beforeProcessNode` event, renamed the (previously undocumented) `htmx:processedNode` to `htmx:afterProcessNode`
118* Added `closest` syntax support for the [`hx-indicator`](https://dev.htmx.org/attributes/hx-indicator) attribute
119* Added `on load` support for the newest version of [hyperscript](https://hyperscript.org)
120* Added the `htmx.config.allowEval` configuration value, for CSP compatibility
121* Bug fixes & improvements
123## [1.0.2] - 2020-12-12
125* Extend all API methods to take a string selector as well as an element
126* Out of band swap elements need not be top level now
127* [`hx-swap-oob`](https://htmx.org/attributes/hx-swap-oob) now can accept a CSS selector to retarget with
129## [1.0.1] - 2020-12-04
131* AJAX file upload now correctly fires events, allowing for [a proper progress bar](https://htmx.org/examples/file-upload)
132* htmx api functions that expect an element now can accept a string selector instead:
133 ```js
134 htmx.on('#form', 'htmx:xhr:progress', function(evt) {
135 htmx.find('#progress').setAttribute('value', evt.detail.loaded/evt.detail.total * 100)
136 });
137 ```
138* htmx now properly handles the `multiple` attribute on `<select>` elements
140## [1.0.0] - 2020-11-24
142* Bumped the release version :)
144## [0.4.1] - 2020-11-23
146* Fixed bug with title tag support when title tag contained HTML entities
147* Pass properties for the `loadstart`, `loadend`, `progress`, `abort` events through properly to the htmx equivalents
149## [0.4.0] - 2020-11-16
151* Now support the `HX-Redirect` and `HX-Refresh` response headers for redirecting client side and triggering a page refresh, respectively
152* `hx-vars` now overrides input values
153* `<title>` tags in responses will be used to update page titles
154* All uses of `eval()` have been removed in favor of `Function`
155* [`hx-vals`](https://htmx.org/attributes/hx-vals) is available as a safe alternative to `hx-vars`. It uses `JSON.parse()` rather than evaluation, if you wish to safely pass user-provided values through to htmx.
157## [0.3.0] - 2020-10-27
159* `hx-trigger` parsing has been rewritten and now supports [trigger filters](https://htmx.org/docs/#trigger-filters) to filter
160 events based on arbitrary javascript expressions
161* htmx now supports two additional response headers `HX-Trigger-After-Swap` and `HX-Trigger-After-Settle` allowing
162 an event to be triggered after a given life cycle event (instead of before the swap)
163* The `requestConfig` is now passed out to events surrounding the AJAX life cycle
164* htmx now evaluates `<script>` tags as javascript when no language is defined on them
165* A new [`event-header`](https://htmx.org/extensions/event-header) extension, which will include a serialized JSON representation of the triggering event in requests
167## [0.2.0] - 2020-9-30
169* AJAX file upload [support](https://htmx.org/docs#files)
170* The HTML validation API is [respected](https://htmx.org/docs#validation)
172## [0.1.0] - 2020-9-18
174* *BREAKING CHANGE*: The SSE attribute [`hx-sse`](https://htmx.org/attributes/hx-sse/) and the Web Sockets attribute [`hx-ws`](https://htmx.org/attributes/hx-ws) have changed syntax to now use colon separators: `hx-sse='connect:/chat swap:message'`
175* The SSE attribute [`hx-sse`](https://htmx.org/attributes/hx-sse/) allows for swapping content directly on an event, in addition to triggering an htmx element,
176with the new `swap:<event name>` syntax.
177* [`hx-target`](https://htmx.org/attributes/hx-target) now supports a `find` syntax to find elements below the element by a CSS selector
178* htmx plays better with deferred loading and many package managers
179* All htmx events are dispatched in both camelCase as well as kebab-case, for better compatibility with AlpineJS and other frameworks. (e.g. `htmx:afterOnLoad` will also be triggered as
181* [hypeerscript](https://hyperscript.org) is now initialized independently of htmx
183## [0.0.8] - 2020-7-8
185* The `view` modifier on `hx-swap` has been renamed to `show`: `hx-swap='innerHTML show:top'`
187## [0.0.7] - 2020-6-30
189* The [`hx-swap`](https://htmx.org/attributes/hx-swap) attribute now supports two new modifiers:
190 * `scroll` - allows you to scroll the target to the `top` or `bottom`
191 * `view` - allows you to scroll the `top` or `bottom` of the target into view
192* The [`hx-push-url`](https://htmx.org/attributes/hx-push-url) attribute now can optionally take a URL to push, in addition to `true` and `false`
193* Added the [`hx-vars`](https://htmx.org/attributes/hx-vars) attribute that allows you to dynamically add to the parameters that will be submitted with a request
195## [0.0.6] - 2020-6-20
197* Custom request/response headers no longer start with the `X-` prefix, which is no longer recommended
198* empty verb attributes are now allowed and follow the anchor tag semantics (e.g. `<div hx-get></div>`)
199* nunjuks inline rendering is now supported in the `client-side-templates` extension
200* the new `ajax-header` extension includes the `X-Requested-With` header
201* bad JSON is now handled more gracefully
202* `hx-swap="none"` will cause no swap to take place <https://github.com/bigskysoftware/htmx/issues/89>
203* `hx-trigger` now supports a `throttle` modifier <https://github.com/bigskysoftware/htmx/issues/88>
204* the focused element is preserved if possible after a replacement
205* perf improvements for large DOM trees with sparse `hx-` annotations
207## [0.0.4] - 2020-5-24
209* Extension mechanism added
210* SSE support added
211* WebSocket support added
213## [0.0.3] - 2020-5-17
215* Renamed to htmx
216* A bug fix for the `hx-prompt` attribute
217* A bug fix for multiple `hx-swap-oob` attributes
218* Moved the default CSS indicator injection into its own sheet to avoid breaking
219* Added the `htmx.config.includeIndicatorStyles` configuration option so people can opt out of injecting the indicator CSS
222## [0.0.1] - 2020-5-15
224* Initial release (originally named kutty)
\No newline at end of file