1 | # Changelog
|
2 |
|
3 | ## [1.7.0] - 2022-02-2
|
4 |
|
5 | * The new [`hx-sync`](/attributes/hx-sync) attribute allows you to synchronize multiple element requests on a single
|
6 | element using various strategies (e.g. replace)
|
7 | * You can also now abort an element making a request by sending it the `htmx:abort` event
|
8 | * [Server Sent Events](/extensions/server-sent-events) and [Web Sockets](/extensions/web-sockets) are now available as
|
9 | extensions, in addition to the normal core support. In htmx 2.0, the current `hx-sse` and `hx-ws` attributes will be
|
10 | moved entirely out to these new extensions. By moving these features to extensions we will be able to add functionality
|
11 | to both of them without compromising the core file size of htmx. You are encouraged to move over to the new
|
12 | extensions, but `hx-sse` and `hx-ws` will continue to work indefinitely in htmx 1.x.
|
13 | * You can now mask out [attribute inheritance](/docs#inheritance) via the [`hx-disinherit`](/attributes/hx-disinherit) attribute.
|
14 | * The `HX-Push` header can now have the `false` value, which will prevent a history snapshot from occuring.
|
15 | * Many new extensions, with a big thanks to all the contributors!
|
16 | * A new [`alpine-morph`](/extensions/alpine-morph) allows you to use Alpine's swapping engine, which preserves Alpine
|
17 | * A [restored](/extensions/restored) extension was added that will trigger a `restore` event on all elements in the DOM
|
18 | on history restoration.
|
19 | * A [loading-states](/extensions/loading-states) extension was added that allows you to easily manage loading states
|
20 | while a request is in flight, including disabling elements, and adding and removing CSS classes.
|
21 | * The `this` symbol now resolves properly for the [`hx-include`](/attributes/hx-include) and [`hx-indicator`](/attributes/hx-indicator)
|
22 | attributes
|
23 | * When an object is included via the [`hx-vals`](/attributes/hx-vals) attribute, it will be converted to JSON (rather
|
24 | than rendering as the string `[Object object]"`)
|
25 | * You can now pass a swap style in to the `htmx.ajax()` function call.
|
26 | * Poll events now contain a `target` attribute, allowing you to filter a poll on the element that is polling.
|
27 | * Two new Out Of Band-related events were added: `htmx:oobBeforeSwap` & `htmx:oobAfterSwap`
|
28 |
|
29 | ## [1.6.1] - 2021-11-22
|
30 |
|
31 | * A new `HX-Retarget` header allows you to change the default target of returned content
|
32 | * The `htmx:beforeSwap` event now includes another configurable property: `detail.isError` which can
|
33 | be used to indicate if a given response should be treated as an error or not
|
34 | * The `htmx:afterRequest` event has two new detail properties: `success` and `failed`, allowing you to write
|
35 | trigger filters in htmx or hyperscript:
|
36 | ```applescript
|
37 | on htmx:afterRequest[failed]
|
38 | set #myCheckbox's checked to true
|
39 | ```
|
40 | * Fixed the `from:` option in [`hx-trigger`](/attributes/hx-trigger) to support `closest <CSS selector>`
|
41 | and `find <CSS selector>` forms
|
42 | * Don't boost anchor tags with an explicit `target` set
|
43 | * Don't cancel all events on boosted elements, only the events that naturally trigger them (click for anchors, submit
|
44 | for forms)
|
45 | * Persist revealed state in the DOM so that on history navigation, revealed elements are not re-requested
|
46 | * Process all [`hx-ext`](/attributes/hx-ext) attributes, even if no other htmx attribute is on the element
|
47 | * Snapshot the current URL on load so that history support works properly after a page refresh occurs
|
48 | * Many, many documentation updates (thank you to all the contributors!)
|
49 |
|
50 |
|
51 | ## [1.6.0] - 2021-10-01
|
52 |
|
53 | * Completely reworked `<script>` tag support that now supports the `<script src="...'/>` form
|
54 | * You can now use the value `unset` to clear a property that would normally be inherited (e.g. hx-confirm)
|
55 | * The `htmx-added` class is added to new content before a swap and removed after the settle phase, which allows you
|
56 | more flexibility in writing CSS transitions for added content (rather than relying on the target, as with `htmx-settling`)
|
57 | * The `htmx:beforeSwap` event has been updated to allow you to [configure swapping](https://htmx.org/docs/#modifying_swapping_behavior_with_events)
|
58 | behavior
|
59 | * Improved `<title>` extraction support
|
60 | * You can listen to events on the `window` object using the `from:` modifier in `hx-trigger`
|
61 | * The `root` option of the `intersect` event was fixed
|
62 | * Boosted forms respect the `enctype` declaration
|
63 | * The `HX-Boosted` header will be sent on requests from boosted elements
|
64 | * Promises are not returned from the main ajax function unless it is an api call (i.e. `htmx.ajax`)
|
65 |
|
66 | ## [1.5.0] - 2021-7-12
|
67 |
|
68 | * Support tracking of button clicked during a form submission
|
69 | * Conditional polling via the [hx-trigger](https://htmx.org/attributes/hx-trigger) attribute
|
70 | * `document` is now a valid pseudo-selector on the [hx-trigger](https://htmx.org/attributes/hx-trigger) `from:` argument, allowing you
|
71 | to listen for events on the document.
|
72 | * Added the [hx-request](https://htmx.org/attributes/hx-request) attribute, allowing you to configure the following aspects of the request
|
73 | * `timeout` - the timeout of the request
|
74 | * `credentials` - if the request will send credentials
|
75 | * `noHeaders` - strips all headers from the request
|
76 | * Along with the above attribute, you can configure the default values for each of these via the corresponding `htmx.config`
|
77 | properties (e.g. `htmx.config.timeout`)
|
78 | * Both the `scroll` and `show` options on [hx-swap](https://htmx.org/attributes/hx-swap) now support extended syntax for selecting the
|
79 | element to scroll or to show, including the pseudo-selectors `window:top` and `window:bottom`.
|
80 |
|
81 | ## [1.4.1] - 2021-6-1
|
82 |
|
83 | * typo fix
|
84 |
|
85 | ## [1.4.0] - 2021-5-25
|
86 |
|
87 | * Added the `queue` option to the [hx-trigger](https://htmx.org/attributes/hx-trigger) attribute, allowing you to specify how events
|
88 | should be queued when they are received with a request in flight
|
89 | * The `htmx.config.useTemplateFragments` option was added, allowing you to use HTML template tags for parsing content
|
90 | from the server. This allows you to use Out of Band content when returning things like table rows, but it is not
|
91 | IE11 compatible.
|
92 | * The `defaultSettleDelay` was dropped to 20ms from 100ms
|
93 | * Introduced a new synthetic event, [intersect](https://htmx.org/docs#pecial-events) that allows you to trigger when an item is scrolled into view
|
94 | as specified by the `IntersectionObserver` API
|
95 | * Fixed timing issue that caused exceptions in the `reveal` logic when scrolling at incredible speeds - <https://github.com/bigskysoftware/htmx/issues/463>
|
96 | * Fixed bug causing SVG titles to be incorrectly used as page title - <https://github.com/bigskysoftware/htmx/issues/459>
|
97 | * Boosted forms that issue a GET will now push the URL by default - <https://github.com/bigskysoftware/htmx/issues/485>
|
98 | * Better dispatch of request events when an element is removed from the DOM
|
99 | * Fixed a bug causing `hx-prompt` to fail
|
100 | * The `htmx.config.withCredentials` option was added, to send credentials with ajax requests (default is `false`)
|
101 | * The `throttle` option on `hx-trigger` does not delay the initial request any longer
|
102 | * The `meta` key is ignored on boosted links
|
103 | * `<script>` tags are now evaluated in the global scope
|
104 | * `hx-swap` now supports the `none` option
|
105 | * Safari text selection bug - <https://github.com/bigskysoftware/htmx/issues/438>
|
106 |
|
107 | ## [1.3.3] - 2021-4-5
|
108 |
|
109 | * Added the [`hx-disabled`](https://htmx.org/docs#security) attribute to allow htmx to be turned off for parts of the DOM
|
110 | * SSE now uses a full-jitter exponential backoff algorithm on reconnection, using the `htmx.config.wsReconnectDelay`
|
111 | setting
|
112 |
|
113 | ## [1.3.2] - 2021-3-9
|
114 |
|
115 | * Bug fixes
|
116 |
|
117 | ## [1.3.1] - 2021-3-9
|
118 |
|
119 | * IE11 fixes
|
120 |
|
121 | ## [1.3.0] - 2021-3-6
|
122 |
|
123 | * Support a `target` modifier on `hx-trigger` to filter based on the element targeted by an event. This allows
|
124 | lazy binding to that target selector.
|
125 | * Events are no longer consumed by the first element that might handle them, unless the `consume` keyword is
|
126 | added to the `hx-trigger` specification
|
127 | * Added the `htmx:beforeSend` event, fired just before an ajax request begins
|
128 | * SSE swaps are properly settled
|
129 | * Fixed bug that was improperly cancelling all clicks on anchors
|
130 | * `htmx.ajax()` now returns a promise
|
131 |
|
132 | ## [1.2.1] - 2021-2-19
|
133 |
|
134 | * Fixed an issue with the history cache, where the cache was getting blown out after the first navigation backwards
|
135 | * Added the `htmx.config.refreshOnHistoryMiss` option, allowing users to trigger a full page refresh on history cache miss
|
136 | rather than issuing an AJAX request
|
137 |
|
138 | ## [1.2.0] - 2021-2-13
|
139 |
|
140 | ### New Features
|
141 |
|
142 | * `hx-vars` has been deprecated in favor of `hx-vals`
|
143 | * `hx-vals` now supports a `javascript:` prefix to achieve the behavior that `hx-vars` provided
|
144 | * The new `hx-headers` attribute allows you to add headers to a request via an attribute. Like `hx-vals` it supports
|
145 | JSON or javascript via the `javascript:` prefix
|
146 | * `hx-include` will now include all inputs under an element, even if that element is not a form tag
|
147 | * The [preload extension](https://htmx.org/extensions/preload/) now offers a `preload-images="true"` attribute that will aggressively load images in preloaded content
|
148 | * On requests driven by a history cache miss, the new `HX-History-Restore-Request` header is included so that the server
|
149 | can differentiate between history requests and normal requests
|
150 |
|
151 | ### Improvements & Bug fixes
|
152 |
|
153 | * Improved handling of precedence of input values to favor the enclosing form (see [here](https://github.com/bigskysoftware/htmx/commit/a10e43d619dc340aa324d37772c06a69a2f47ec9))
|
154 | * Moved event filtering logic *after* `preventDefault` so filtering still allows events to be properly handled
|
155 | * No longer trigger after swap events on elements that have been removed via an `outerHTML` swap
|
156 | * Properly remove event handlers added to other elements when an element is removed from the DOM
|
157 | * Handle the `scroll:` modifier in `hx-swap` properly when an `outerHTML` swap occurs
|
158 | * Lots of docs fixes
|
159 |
|
160 | ## [1.1.0] - 2021-1-6
|
161 |
|
162 | * Newly added [preload extension](https://htmx.org/extensions/preload/) allows you to preload resources for lower
|
163 | latency requests!
|
164 | * Support the `ignore:` modifier for extensions
|
165 | * Updated form variable order inclusion to include the enclosing form *last* so that, in the presence of multiple
|
166 | values, the most relevant value is the most likely to be selected by the server
|
167 | * Support for the [`htmx.ajax()`](https://dev.htmx.org/api/#ajax) javascript function, to issue an htmx-style ajax
|
168 | request from javascript
|
169 | * Removed the following htmx request headers for better cache behavior: `HX-Event-Target`, `HX-Active-Element`,
|
170 | `HX-Active-Element-Name`, `HX-Active-Element-Value`
|
171 | * Added the [`hx-preserve`](https://dev.htmx.org/attributes/hx-preserve) attribute, which allows
|
172 | you to preserve elements across requests (for example, to keep a video element playing properly)
|
173 | * The [path-deps](https://dev.htmx.org/extensions/path-deps/#refresh) now surfaces a small api
|
174 | for refreshing path dependencies manually in javascript
|
175 | * Now support the `from:` clause on [`hx-trigger`](https://dev.htmx.org/attributes/hx-trigger) to
|
176 | allow an element to respond to events on other elements.
|
177 | * Added the `htmx:beforeProcessNode` event, renamed the (previously undocumented) `htmx:processedNode` to `htmx:afterProcessNode`
|
178 | * Added `closest` syntax support for the [`hx-indicator`](https://dev.htmx.org/attributes/hx-indicator) attribute
|
179 | * Added `on load` support for the newest version of [hyperscript](https://hyperscript.org)
|
180 | * Added the `htmx.config.allowEval` configuration value, for CSP compatibility
|
181 | * Bug fixes & improvements
|
182 |
|
183 | ## [1.0.2] - 2020-12-12
|
184 |
|
185 | * Extend all API methods to take a string selector as well as an element
|
186 | * Out of band swap elements need not be top level now
|
187 | * [`hx-swap-oob`](https://htmx.org/attributes/hx-swap-oob) now can accept a CSS selector to retarget with
|
188 |
|
189 | ## [1.0.1] - 2020-12-04
|
190 |
|
191 | * AJAX file upload now correctly fires events, allowing for [a proper progress bar](https://htmx.org/examples/file-upload)
|
192 | * htmx api functions that expect an element now can accept a string selector instead:
|
193 | ```js
|
194 | htmx.on('#form', 'htmx:xhr:progress', function(evt) {
|
195 | htmx.find('#progress').setAttribute('value', evt.detail.loaded/evt.detail.total * 100)
|
196 | });
|
197 | ```
|
198 | * htmx now properly handles the `multiple` attribute on `<select>` elements
|
199 |
|
200 | ## [1.0.0] - 2020-11-24
|
201 |
|
202 | * Bumped the release version :)
|
203 |
|
204 | ## [0.4.1] - 2020-11-23
|
205 |
|
206 | * Fixed bug with title tag support when title tag contained HTML entities
|
207 | * Pass properties for the `loadstart`, `loadend`, `progress`, `abort` events through properly to the htmx equivalents
|
208 |
|
209 | ## [0.4.0] - 2020-11-16
|
210 |
|
211 | * Now support the `HX-Redirect` and `HX-Refresh` response headers for redirecting client side and triggering a page refresh, respectively
|
212 | * `hx-vars` now overrides input values
|
213 | * `<title>` tags in responses will be used to update page titles
|
214 | * All uses of `eval()` have been removed in favor of `Function`
|
215 | * [`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.
|
216 |
|
217 | ## [0.3.0] - 2020-10-27
|
218 |
|
219 | * `hx-trigger` parsing has been rewritten and now supports [trigger filters](https://htmx.org/docs/#trigger-filters) to filter
|
220 | events based on arbitrary javascript expressions
|
221 | * htmx now supports two additional response headers `HX-Trigger-After-Swap` and `HX-Trigger-After-Settle` allowing
|
222 | an event to be triggered after a given life cycle event (instead of before the swap)
|
223 | * The `requestConfig` is now passed out to events surrounding the AJAX life cycle
|
224 | * htmx now evaluates `<script>` tags as javascript when no language is defined on them
|
225 | * A new [`event-header`](https://htmx.org/extensions/event-header) extension, which will include a serialized JSON representation of the triggering event in requests
|
226 |
|
227 | ## [0.2.0] - 2020-9-30
|
228 |
|
229 | * AJAX file upload [support](https://htmx.org/docs#files)
|
230 | * The HTML validation API is [respected](https://htmx.org/docs#validation)
|
231 |
|
232 | ## [0.1.0] - 2020-9-18
|
233 |
|
234 | * *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'`
|
235 | * 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,
|
236 | with the new `swap:<event name>` syntax.
|
237 | * [`hx-target`](https://htmx.org/attributes/hx-target) now supports a `find` syntax to find elements below the element by a CSS selector
|
238 | * htmx plays better with deferred loading and many package managers
|
239 | * 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
|
240 | `htmx:after-on-load`)
|
241 | * [hypeerscript](https://hyperscript.org) is now initialized independently of htmx
|
242 |
|
243 | ## [0.0.8] - 2020-7-8
|
244 |
|
245 | * The `view` modifier on `hx-swap` has been renamed to `show`: `hx-swap='innerHTML show:top'`
|
246 |
|
247 | ## [0.0.7] - 2020-6-30
|
248 |
|
249 | * The [`hx-swap`](https://htmx.org/attributes/hx-swap) attribute now supports two new modifiers:
|
250 | * `scroll` - allows you to scroll the target to the `top` or `bottom`
|
251 | * `view` - allows you to scroll the `top` or `bottom` of the target into view
|
252 | * 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`
|
253 | * 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
|
254 |
|
255 | ## [0.0.6] - 2020-6-20
|
256 |
|
257 | * Custom request/response headers no longer start with the `X-` prefix, which is no longer recommended
|
258 | * empty verb attributes are now allowed and follow the anchor tag semantics (e.g. `<div hx-get></div>`)
|
259 | * nunjuks inline rendering is now supported in the `client-side-templates` extension
|
260 | * the new `ajax-header` extension includes the `X-Requested-With` header
|
261 | * bad JSON is now handled more gracefully
|
262 | * `hx-swap="none"` will cause no swap to take place <https://github.com/bigskysoftware/htmx/issues/89>
|
263 | * `hx-trigger` now supports a `throttle` modifier <https://github.com/bigskysoftware/htmx/issues/88>
|
264 | * the focused element is preserved if possible after a replacement
|
265 | * perf improvements for large DOM trees with sparse `hx-` annotations
|
266 |
|
267 | ## [0.0.4] - 2020-5-24
|
268 |
|
269 | * Extension mechanism added
|
270 | * SSE support added
|
271 | * WebSocket support added
|
272 |
|
273 | ## [0.0.3] - 2020-5-17
|
274 |
|
275 | * Renamed to htmx
|
276 | * A bug fix for the `hx-prompt` attribute
|
277 | * A bug fix for multiple `hx-swap-oob` attributes
|
278 | * Moved the default CSS indicator injection into its own sheet to avoid breaking
|
279 | * Added the `htmx.config.includeIndicatorStyles` configuration option so people can opt out of injecting the indicator CSS
|
280 |
|
281 |
|
282 | ## [0.0.1] - 2020-5-15
|
283 |
|
284 | * Initial release (originally named kutty)
|
285 |
|
\ | No newline at end of file |