Ything-RepoMirrors/htmx
1
0
Fork 0
mirror of https://github.com/bigskysoftware/htmx.git synced 2026-01-25 05:06:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

regen release

Browse Source
This commit is contained in:
Carson Gross
2025-12-06 16:44:27 -07:00
parent c878a939d6
commit 30371270f7
23 changed files with 35 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
dist/htmx.esm.js vendored
View File

@@ -96,7 +96,6 @@ var htmx = (() => {
prefix: "",
transitions: false,
history: true,
historyReload: false,
mode: 'same-origin',
defaultSwap: "innerHTML",
indicatorClass: "htmx-indicator",
@@ -1588,7 +1587,7 @@ var htmx = (() => {
#restoreHistory(path) {
path = path || location.pathname + location.search;
if (this.#trigger(document, "htmx:before:restore:history", {path, cacheMiss: true})) {
if (this.config.historyReload) {
if (this.config.history === "reload") {
location.reload();
} else {
this.ajax('GET', path, {

BIN
dist/htmx.esm.js.br vendored
View File

Binary file not shown.

2
dist/htmx.esm.min.js vendored
View File

File diff suppressed because one or more lines are too long

BIN
dist/htmx.esm.min.js.br vendored
View File

Binary file not shown.

2
dist/htmx.esm.min.js.map vendored
View File

File diff suppressed because one or more lines are too long

3
dist/htmx.js vendored
View File

@@ -96,7 +96,6 @@ var htmx = (() => {
prefix: "",
transitions: false,
history: true,
historyReload: false,
mode: 'same-origin',
defaultSwap: "innerHTML",
indicatorClass: "htmx-indicator",
@@ -1588,7 +1587,7 @@ var htmx = (() => {
#restoreHistory(path) {
path = path || location.pathname + location.search;
if (this.#trigger(document, "htmx:before:restore:history", {path, cacheMiss: true})) {
if (this.config.historyReload) {
if (this.config.history === "reload") {
location.reload();
} else {
this.ajax('GET', path, {

BIN
dist/htmx.js.br vendored
View File

Binary file not shown.

2
dist/htmx.min.js vendored
View File

File diff suppressed because one or more lines are too long

BIN
dist/htmx.min.js.br vendored
View File

Binary file not shown.

2
dist/htmx.min.js.map vendored
View File

File diff suppressed because one or more lines are too long

3
www/content/api.md
View File

@@ -344,8 +344,7 @@ Note that using a [meta tag](@/docs.md#configuring-htmx) is the preferred mechan
* `logAll` - boolean: if true, htmx will log all events for debugging (default: `false`)
* `prefix` - string: custom prefix for htmx attributes (default: `""`)
* `transitions` - boolean: whether to use view transitions when swapping (default: `false`)
* `history` - boolean: whether to enable history support (default: `true`)
* `historyReload` - boolean: if true, do full reload on history navigation (default: `false`)
* `history` - object: whether to enable history support, supports the values `true`, `false` or `"reload"` (default: `true`)
* `mode` - string: the fetch mode for AJAX requests (default: `'same-origin'`)
* `defaultSwap` - string: default swap style (default: `'innerHTML'`)
* `indicatorClass` - string: class for indicators (default: `'htmx-indicator'`)

43
www/content/docs.md
View File

@@ -99,13 +99,13 @@ The fastest way to get going with htmx is to load it via a CDN.
Just add this to your head tag and you can get going:
```html
<script src="https://cdn.jsdelivr.net/npm/htmx.org@4.0.0-alpha5/dist/htmx.min.js" integrity="sha384-Oz+ZEYwbhkPgXZO/YIucbRMLMGjEiMhx2/HwbojVMR+be9lHNUu90au811ocnG98/oZIRlt2KvIJ6i1OHNnAJ5vCYA1Gl6SLNtsv" crossorigin="anonymous"></script>
<script src="https://cdn.jsdelivr.net/npm/htmx.org@4.0.0-alpha5/dist/htmx.min.js" integrity="sha384-Ygvy/K5smZ2205k8c+XtILRfDt2QrKB4D7ryAz1slfsAe1pFmaF4fTkC0BLPVtjG" crossorigin="anonymous"></script>
```
An unminified version is also available as well:
```html
<script src="https://cdn.jsdelivr.net/npm/htmx.org@4.0.0-alpha5/dist/htmx.js" integrity="sha384-BNfLYK/j5Hrxv/xeud6/swVdPNT7G0R4VPwFDbLHMs1BMvWly1sVtBsb2VTRp/Od" crossorigin="anonymous"></script>
<script src="https://cdn.jsdelivr.net/npm/htmx.org@4.0.0-alpha5/dist/htmx.js" integrity="sha384-zLfyrUaOp5k46obvC9PURUvNGSteuuCM5RIwoT9FLfPoDbCWaMqDtXHOqSpMBgJL" crossorigin="anonymous"></script>
```
While this CDN-based approach is quick and easy, you may want to consider [not using CDNs in production](https://blog.wesleyac.com/posts/why-not-javascript-cdn).
@@ -1713,27 +1713,26 @@ They are listed below:
<div class="info-table">
| Config Variable | Info |
|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `htmx.config.logAll` | defaults to `false`, if set to `true` htmx will log all events to the console for debugging |
| `htmx.config.prefix` | defaults to `""` (empty string), allows you to use a custom prefix for htmx attributes (e.g., `"data-hx-"` to use `data-hx-get` instead of `hx-get`) |
| `htmx.config.transitions` | defaults to `true`, whether to use view transitions when swapping content (if browser supports it) |
| `htmx.config.history` | defaults to `true`, whether to enable history support (push/replace URL) |
| `htmx.config.historyReload` | defaults to `false`, if set to `true` htmx will do a full page reload on history navigation instead of an AJAX request |
| `htmx.config.mode` | defaults to `'same-origin'`, the fetch mode for AJAX requests. Can be `'cors'`, `'no-cors'`, or `'same-origin'` |
| `htmx.config.defaultSwap` | defaults to `innerHTML` |
| `htmx.config.indicatorClass` | defaults to `htmx-indicator` |
| `htmx.config.requestClass` | defaults to `htmx-request` |
| `htmx.config.includeIndicatorCSS` | defaults to `true` (determines if the indicator styles are loaded) |
| `htmx.config.defaultTimeout` | defaults to `60000` (60 seconds), the number of milliseconds a request can take before automatically being terminated |
| `htmx.config.inlineScriptNonce` | defaults to `''`, meaning that no nonce will be added to inline scripts |
| `htmx.config.inlineStyleNonce` | defaults to `''`, meaning that no nonce will be added to inline styles |
| `htmx.config.extensions` | defaults to `''`, a comma-separated list of extension names to load (e.g., `'preload,optimistic'`) |
| Config Variable | Info |
|-----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `htmx.config.logAll` | defaults to `false`, if set to `true` htmx will log all events to the console for debugging |
| `htmx.config.prefix` | defaults to `""` (empty string), allows you to use a custom prefix for htmx attributes (e.g., `"data-hx-"` to use `data-hx-get` instead of `hx-get`) |
| `htmx.config.transitions` | defaults to `true`, whether to use view transitions when swapping content (if browser supports it) |
| `htmx.config.history` | defaults to `true`, whether to enable history support (push/replace URL). Set to `"reload"` to do a hard browser reload on history navigations. |
| `htmx.config.mode` | defaults to `'same-origin'`, the fetch mode for AJAX requests. Can be `'cors'`, `'no-cors'`, or `'same-origin'` |
| `htmx.config.defaultSwap` | defaults to `innerHTML` |
| `htmx.config.indicatorClass` | defaults to `htmx-indicator` |
| `htmx.config.requestClass` | defaults to `htmx-request` |
| `htmx.config.includeIndicatorCSS` | defaults to `true` (determines if the indicator styles are loaded) |
| `htmx.config.defaultTimeout` | defaults to `60000` (60 seconds), the number of milliseconds a request can take before automatically being terminated |
| `htmx.config.inlineScriptNonce` | defaults to `''`, meaning that no nonce will be added to inline scripts |
| `htmx.config.inlineStyleNonce` | defaults to `''`, meaning that no nonce will be added to inline styles |
| `htmx.config.extensions` | defaults to `''`, a comma-separated list of extension names to load (e.g., `'preload,optimistic'`) |
| `htmx.config.sse` | configuration for Server-Sent Events (SSE) streams. An object with the following properties: `reconnect` (default: `false`), `reconnectMaxAttempts` (default: `10`), `reconnectDelay` (default: `500`ms), `reconnectMaxDelay` (default: `60000`ms), `reconnectJitter` (default: `0.3`), `pauseInBackground` (default: `false`) |
| `htmx.config.morphIgnore` | defaults to `["data-htmx-powered"]`, array of attribute names to ignore when morphing elements |
| `htmx.config.noSwap` | defaults to `[204, 304]`, array of HTTP status codes that should not trigger a swap |
| `htmx.config.implicitInheritance` | defaults to `false`, if set to `true` attributes will be inherited from parent elements automatically without requiring the `:inherited` modifier |
| `htmx.config.metaCharacter` | defaults to `undefined`, allows you to use a custom character instead of `:` for attribute modifiers (e.g., `-` to use `hx-get-inherited` instead of `hx-get:inherited`) |
| `htmx.config.morphIgnore` | defaults to `["data-htmx-powered"]`, array of attribute names to ignore when morphing elements |
| `htmx.config.noSwap` | defaults to `[204, 304]`, array of HTTP status codes that should not trigger a swap |
| `htmx.config.implicitInheritance` | defaults to `false`, if set to `true` attributes will be inherited from parent elements automatically without requiring the `:inherited` modifier |
| `htmx.config.metaCharacter` | defaults to `undefined`, allows you to use a custom character instead of `:` for attribute modifiers (e.g., `-` to use `hx-get-inherited` instead of `hx-get:inherited`) |
</div>
You can set them directly in JavaScript, or you can use a `meta` tag:

3
www/content/reference.md
View File

@@ -182,8 +182,7 @@ listed below:
| `htmx.config.logAll` | defaults to `false`, if set to `true` htmx will log all events to the console for debugging |
| `htmx.config.prefix` | defaults to `""` (empty string), allows you to use a custom prefix for htmx attributes (e.g., `"data-hx-"` to use `data-hx-get` instead of `hx-get`) |
| `htmx.config.transitions` | defaults to `false`, whether to use view transitions when swapping content (if browser supports it) |
| `htmx.config.history` | defaults to `true`, whether to enable history support (push/replace URL) |
| `htmx.config.historyReload` | defaults to `false`, if set to `true` htmx will do a full page reload on history navigation instead of an AJAX request |
| `htmx.config.history` | defaults to `true`, whether to enable history support (push/replace URL). Set to `"reload"` to do a hard browser reload on history navigations. |
| `htmx.config.mode` | defaults to `'same-origin'`, the fetch mode for AJAX requests. Can be `'cors'`, `'no-cors'`, or `'same-origin'` |
| `htmx.config.defaultSwap` | defaults to `innerHTML` |
| `htmx.config.indicatorClass` | defaults to `htmx-indicator` |

3
www/static/js/htmx.esm.js
View File

@@ -96,7 +96,6 @@ var htmx = (() => {
prefix: "",
transitions: false,
history: true,
historyReload: false,
mode: 'same-origin',
defaultSwap: "innerHTML",
indicatorClass: "htmx-indicator",
@@ -1588,7 +1587,7 @@ var htmx = (() => {
#restoreHistory(path) {
path = path || location.pathname + location.search;
if (this.#trigger(document, "htmx:before:restore:history", {path, cacheMiss: true})) {
if (this.config.historyReload) {
if (this.config.history === "reload") {
location.reload();
} else {
this.ajax('GET', path, {

BIN
www/static/js/htmx.esm.js.br
View File

Binary file not shown.

2
www/static/js/htmx.esm.min.js vendored
View File

File diff suppressed because one or more lines are too long

BIN
www/static/js/htmx.esm.min.js.br
View File

Binary file not shown.

2
www/static/js/htmx.esm.min.js.map
View File

File diff suppressed because one or more lines are too long

3
www/static/js/htmx.js
View File

@@ -96,7 +96,6 @@ var htmx = (() => {
prefix: "",
transitions: false,
history: true,
historyReload: false,
mode: 'same-origin',
defaultSwap: "innerHTML",
indicatorClass: "htmx-indicator",
@@ -1588,7 +1587,7 @@ var htmx = (() => {
#restoreHistory(path) {
path = path || location.pathname + location.search;
if (this.#trigger(document, "htmx:before:restore:history", {path, cacheMiss: true})) {
if (this.config.historyReload) {
if (this.config.history === "reload") {
location.reload();
} else {
this.ajax('GET', path, {

BIN
www/static/js/htmx.js.br
View File

Binary file not shown.

2
www/static/js/htmx.min.js vendored
View File

File diff suppressed because one or more lines are too long

BIN
www/static/js/htmx.min.js.br
View File

Binary file not shown.

2
www/static/js/htmx.min.js.map
View File

File diff suppressed because one or more lines are too long