mirror of
https://github.com/Cacti/cacti.git
synced 2026-10-23 11:36:53 +09:00
* Port #8166 SNMP credential cache + procedural SNMPv3 to develop Ports the shared SNMPv3 credential cache and procedural SNMPv3 routing from the 1.2.x feature (merged as #8166) onto develop, adapted to develop's refactored SNMP layer. Parts of the 1.2.x change that do not apply to develop are omitted: the cacti_exec() idle-timeout rewrite (develop has no cacti_exec()), the PHP floor bump and composer/doc changes (develop is already 8.3+), and the cmd.php max_oids batching (develop's cmd.php already collects SNMP in-process through persistent sessions, so the per-item spawn the batching removed does not occur). - lib/cache.php: new cross-process \Cacti\Cache\SharedCache (file + POSIX shared-memory + process-local tiers, optional AES-256-GCM sealing). Loaded via lib/snmp.php (the Cacti\Cache\ namespace is not PSR-4 autoloaded). The crypto helpers it seals with already live in develop's lib/auth.php, loaded by global.php, so no duplicate was added. - lib/snmp.php: snmp_get_method() now routes SNMPv3 get/getnext to the procedural snmp3_*() calls when the running PHP supports the configured auth/privacy tokens and no context/engine id is set (SHA-224/384 and AES-192/256[C] stay on the binary before PHP 8.6); the three single-get functions gain the procedural v3 path with \Throwable handling; adds the credential-cache subsystem, protocol-option/MD5-DES helpers, snmp_native_protocol(), snmp_format_agent() and cacti_snmp_get_multi(); the binary v3 auth builder consults the cache when enabled. - poller.php / script_server.php: prime / load the shared cache. - poller_maintenance.php: daily out-of-band cache rebuild on every collector (per-poller lastrun marker). - lib/api_device.php / lib/utility.php: bump snmp_cred_version only on v3 credential add/change (and propagate the token to the affected remote poller). - include/global.php: resolve and create the private cache/ directory. - include/global_settings.php: add 'Enable Credential Cache' and 'Enable MD5 and DES for SNMPv3' settings (both off by default); default new-device v3 auth/privacy to SHA/AES instead of legacy MD5/DES. - host.php / automation_snmp.php: drop MD5/DES from the pickers when disabled and default new records to SHA/AES on upgraded installs. - include/config.php.dist: document $config['cache_dir']. - tests/Unit/Core/Cache/SharedCacheTest.php: SharedCache behaviour coverage. - tests/security/baselines: baseline the two new lib/cache.php sinks. * Incorporate #8171: binary fallback for unsupported SNMPv3 protocols Layers PR #8171 onto the develop port so an SNMPv3 device whose auth/privacy protocols the running PHP's ext-snmp cannot service natively (e.g. AES-256 before PHP 8.6) no longer fatals the poller or device-edit screen. - lib/snmp.php: add CactiSnmpBinarySession, a session stand-in exposing the get/getnext/walk/close interface the cacti_snmp_session_*() helpers use and delegating each call to cacti_snmp_*() -> the Net-SNMP binary. cacti_snmp_session() returns it when php-snmp is absent or the v3 protocol is not natively serviceable, so cmd.php/host.php collect these devices via the binary on pre-8.6 and switch to the in-process path on 8.6 with no caller change. v1/v2 snmpget/snmp2_get now go through snmp_format_agent(). The ERRNO_TIMEOUT check tolerates php-snmp being absent. Drop the vendored classSNMP.php compatibility shim and its include (and the Yandex attribution). - cmd.php: open_snmp_session() returns the down sentinel when a host is already marked down this run, instead of returning an unset (null) [] that cacti_snmp_session_get() then dereferenced (TypeError). - lib/ping.php: ping_snmp() runs the availability check through the procedural cacti_snmp_get()/getnext() path so an unsupported protocol falls back to the binary instead of raising a ValueError in SNMP::setSecurity(). * Incorporate #8172: retire include/vendor/phpsnmp, relocate into lib Follow-up to #8171 on the develop port. After classSNMP.php was removed, the include/vendor/phpsnmp/ directory held only Cacti-owned files; this retires it. - lib/snmp.php: the ext-snmp subclass that carried Cacti's bulk_walk_size / value_output_format (previously vendor/phpsnmp/extension.php) is now declared directly as CactiSnmpNativeSession, guarded by CACTI_PHP_SNMP; the include and the 'use phpsnmp\SNMP' alias are gone, and new SNMP(...) / SNMP::VERSION_* now reference the native \SNMP and the new subclass. - lib/mib_parser.php: moved from include/vendor/phpsnmp/mib_parser.php; lib/mib_cache.php includes it via __DIR__. - Remove include/vendor/phpsnmp/extension.php and index.php (directory retired). - tests: SnmpCoverageTest uses \SNMP::ERRNO_TIMEOUT now that phpsnmp\SNMP is gone; drop the stale include/vendor/phpsnmp/ entry from the vendor-policy allowlist. develop's sink baseline tracks constant-based includes differently than 1.2.x, so no baseline refresh was needed here. * Address PR #8174 review: snmp_get_method params, v3 walk, getnext agent, cache bump, CHANGELOG - lib/snmp.php: restore $php_snmp as the 6th snmp_get_method() parameter and move the new $auth_proto/$priv_proto after it (callers pass them by name), so the positional $php_snmp used by SnmpCoverageTest and others keeps working. - lib/snmp.php: keep every SNMPv3 operation except get/getnext on the Net-SNMP binary - the native walk branch implements only v1/v2, so a v3 walk reaching the procedural gate would have silently returned empty when path_snmpbulkwalk is missing. - lib/snmp.php: cacti_snmp_getnext() v1/v2 branches now use snmp_format_agent() like get/get_raw, so an IPv6 literal / non-default port is bracketed. - lib/api_device.php: bump snmp_cred_version only when the host's v3 membership or one of the cached credential fields actually changed, instead of on every save of a v3 device. - CHANGELOG: move the #8171 entry into the issue block and the #8166 entries into the feature block, matching the established section ordering. * Fix CI: unbracket IPv4/DNS SNMP targets, inline auth-cache SQL columns, apply phpcsfixer standard * Refresh sink inventory baseline after short-array normalization * Restore lib/snmp.php 100% coverage after aligning v3 routing to 1.2.x - update the three SnmpCoverageTest assertions that still encoded develop's pre-port behavior: v3 snmp_get_method now returns PHP, an unsupported- protocol v3 session returns the binary-delegating session object, and the v3 cacti_snmp_get path runs natively - add a v3 noAuthNoPriv user to the snmp-coverage snmpd fixture so native snmp3_get is exercised deterministically - add tests covering the ported subsystems to 100%: shared auth cache, binary-delegating session, protocol pickers, v3 credential args, cacti_snmp_get_multi, and the cacti_get_snmpv3_auth cache path - snmp_auth_cache_load uses a resettable process guard so its enabled and disabled branches are both coverable in a single process * Resolve phpstan errors in the relocated SNMP MIB parser and ported snmp.php - lib/mib_parser.php: type the MibParser properties, add parameter/return types, guard file_get_contents()/preg_split() against false, correct the parse_bracket_token delimiter params (string, not integer), and drop the unreachable return after trigger_error(E_USER_ERROR) - now phpstan clean - lib/mib_cache.php: drop the redundant isset($mp->oids) guard (the typed property is always initialized; $mp->mib is the real check) - lib/snmp.php: type the CactiSnmpBinarySession and CactiSnmpNativeSession properties/methods and pass bool to snmp_set_quick_print() - .phpstan.neon: ignore greaterOrEqual.alwaysFalse alongside the existing greater.alwaysFalse (the PHP_VERSION_ID >= 80600 forward-compat gate) - regenerate phpstan-baseline.neon for the irreducible ext-snmp stub strictness (snmp3_get literal-union protocols, int<-1,max> timeouts) in the ported procedural v3 path, the new lib/cache.php shmop stubs, and the $config array-shape offsets in include/global.php * Make the v3 getter catch coverage net-snmp-build-independent The DES-rejection trick that drove the procedural snmp3_get()/snmp3_getnext() try/catch blocks only works on net-snmp builds compiled without DES; CI's Debian net-snmp accepts DES, so those catches went uncovered (98.3%). - extend the existing native_get injection seam (already on cacti_snmp_get) to cacti_snmp_get_raw, cacti_snmp_getnext, and cacti_snmp_get_multi, and drive the catch blocks with a throwing native getter in the test - mark the seam-less cacti_snmp_session() setSecurity catch with @codeCoverageIgnore (it only throws for a protocol the running net-snmp rejects, which is not portably reproducible in the fixture) * Exclude ext-snmp/PHP-8.6-gated defensive branches from snmp coverage Two branches in lib/snmp.php are unreachable on the PHP 8.3 + ext-snmp coverage runner and were only "covered" locally via opcache dead-code elimination: - snmp_get_method()'s !function_exists('snmp3_get') fallback (ext-snmp always provides snmp3_get) - snmp_php_v3_protocols_supported()'s PHP_VERSION_ID >= 80600 block (SHA-224/384 and AES-192/256 tokens are only accepted on PHP 8.6+) Mark both with @codeCoverageIgnore so the 100% gate is deterministic across runners regardless of opcache settings. * Account for the #8166 SNMPv3 credential-cache gate query in the batching test poller_update_poller_cache_from_buffer() now runs one SELECT per flush to decide whether the flush touched SNMPv3 poller items before bumping the shared credential-cache version (matching 1.2.x). UpdateDataQueryCacheBatchingIntegrationTest counted 4 statements per flush; update it to 5 (and 3 per-row flushes to 15, 1 batched flush to 5). The guard's intent - batching issues fewer statements than per-row flushes - still holds. * Port #8175: group SNMP options under an SNMP Behavior section Mirror the 1.2.x settings reorganization (#8175) on develop. develop already keeps the SNMP options in a dedicated SNMP tab, so add an "SNMP Behavior" spacer there, order the behavior options as md5/des, credential cache, max get size, bulkwalk fetch size, and move "Disable increasing OID Check" out of the Poller tab to sit last in that group. Display-only; no settings added or removed and no behavior change. Adds the "SNMP Behavior" heading to cacti.pot. * fix: complete dependabot htmx 2.0.10 to 2.0.11 bump Dependabot bumped package.json and package-lock.json to htmx.org 2.0.11 (PR 8179) but left the vendored include/js/htmx.js, its version marker, and the pinned SRI constant at 2.0.10. The htmx-filters CI workflow runs npm ci, which regenerates include/js/htmx.js from the 2.0.11 package, so HtmxTest's runtime sha384 no longer matches the HTMX_2_0_10_SRI constant and the integrity assertion fails. Complete the bump: regenerate the vendored include/js/htmx.js to the 2.0.11 build, bump include/js/htmx.js.version to 2.0.11, rename HTMX_2_0_10_SRI to HTMX_2_0_11_SRI with the recomputed sha384 hash, and update the version/integrity assertions in tests/Unit/Ui/Html/HtmxTest.php and tests/HandOff/HtmxLoaderHandOffTest.php. package.json and package-lock.json match the values dependabot already landed on develop. * settings: move SNMP Agent Support under the SNMP Behavior spacer Relocate the enable_snmp_agent setting (SNMP Agent Support Enabled) so it is the first item under the SNMP Behavior spacer instead of sitting in the Poller General group, grouping it with the other SNMP behavior options. * Address PR #8174 review: keep SHA-224/384 on the binary, honor port on transport targets Resolves the two still-valid Copilot review findings on lib/snmp.php that were left unresolved (only marked outdated after later commits shifted their lines). - snmp_php_v3_protocols_supported(): drop SHA224/SHA384 from the native auth allowlist. ext-snmp's SNMP::setSecurity()/snmp3_*() only map MD5/SHA/SHA256/ SHA512 - there is no SHA-224/SHA-384 mapping on any build, including PHP 8.6 (verified against php-src ext/snmp/snmp.c), so routing those tokens to the procedural path raised a ValueError instead of using the binary. They now always fall back to the Net-SNMP binary. The AES-192/256 privacy tokens that ext-snmp does add on 8.6 stay gated behind PHP_VERSION_ID >= 80600. - snmp_format_agent(): a udp/tcp transport-qualified target that omits a port now has the configured non-default port appended (udp6:[2001:db8::1] + 1161 -> udp6:[2001:db8::1]:1161), matching the Net-SNMP binary path. Targets that already carry a port, and unix: sockets (no port), are left untouched. - SnmpCoverageTest: cover the new transport-target branches; lib/snmp.php stays at 100%.
5394 lines
167 KiB
JavaScript
5394 lines
167 KiB
JavaScript
var htmx = (function() {
|
|
'use strict'
|
|
|
|
// Public API
|
|
const htmx = {
|
|
// Tsc madness here, assigning the functions directly results in an invalid TypeScript output, but reassigning is fine
|
|
/* Event processing */
|
|
/** @type {typeof onLoadHelper} */
|
|
onLoad: null,
|
|
/** @type {typeof processNode} */
|
|
process: null,
|
|
/** @type {typeof addEventListenerImpl} */
|
|
on: null,
|
|
/** @type {typeof removeEventListenerImpl} */
|
|
off: null,
|
|
/** @type {typeof triggerEvent} */
|
|
trigger: null,
|
|
/** @type {typeof ajaxHelper} */
|
|
ajax: null,
|
|
/* DOM querying helpers */
|
|
/** @type {typeof find} */
|
|
find: null,
|
|
/** @type {typeof findAll} */
|
|
findAll: null,
|
|
/** @type {typeof closest} */
|
|
closest: null,
|
|
/**
|
|
* Returns the input values that would resolve for a given element via the htmx value resolution mechanism
|
|
*
|
|
* @see https://htmx.org/api/#values
|
|
*
|
|
* @param {Element} elt the element to resolve values on
|
|
* @param {HttpVerb} type the request type (e.g. **get** or **post**) non-GET's will include the enclosing form of the element. Defaults to **post**
|
|
* @returns {Object}
|
|
*/
|
|
values: function(elt, type) {
|
|
const inputValues = getInputValues(elt, type || 'post')
|
|
return inputValues.values
|
|
},
|
|
/* DOM manipulation helpers */
|
|
/** @type {typeof removeElement} */
|
|
remove: null,
|
|
/** @type {typeof addClassToElement} */
|
|
addClass: null,
|
|
/** @type {typeof removeClassFromElement} */
|
|
removeClass: null,
|
|
/** @type {typeof toggleClassOnElement} */
|
|
toggleClass: null,
|
|
/** @type {typeof takeClassForElement} */
|
|
takeClass: null,
|
|
/** @type {typeof swap} */
|
|
swap: null,
|
|
/* Extension entrypoints */
|
|
/** @type {typeof defineExtension} */
|
|
defineExtension: null,
|
|
/** @type {typeof removeExtension} */
|
|
removeExtension: null,
|
|
/* Debugging */
|
|
/** @type {typeof logAll} */
|
|
logAll: null,
|
|
/** @type {typeof logNone} */
|
|
logNone: null,
|
|
/* Debugging */
|
|
/**
|
|
* The logger htmx uses to log with
|
|
*
|
|
* @see https://htmx.org/api/#logger
|
|
*/
|
|
logger: null,
|
|
/**
|
|
* A property holding the configuration htmx uses at runtime.
|
|
*
|
|
* Note that using a [meta tag](https://htmx.org/docs/#config) is the preferred mechanism for setting these properties.
|
|
*
|
|
* @see https://htmx.org/api/#config
|
|
*/
|
|
config: {
|
|
/**
|
|
* Whether to use history.
|
|
* @type boolean
|
|
* @default true
|
|
*/
|
|
historyEnabled: true,
|
|
/**
|
|
* The number of pages to keep in **sessionStorage** for history support.
|
|
* @type number
|
|
* @default 10
|
|
*/
|
|
historyCacheSize: 10,
|
|
/**
|
|
* @type boolean
|
|
* @default false
|
|
*/
|
|
refreshOnHistoryMiss: false,
|
|
/**
|
|
* The default swap style to use if **[hx-swap](https://htmx.org/attributes/hx-swap)** is omitted.
|
|
* @type HtmxSwapStyle
|
|
* @default 'innerHTML'
|
|
*/
|
|
defaultSwapStyle: 'innerHTML',
|
|
/**
|
|
* The default delay between receiving a response from the server and doing the swap.
|
|
* @type number
|
|
* @default 0
|
|
*/
|
|
defaultSwapDelay: 0,
|
|
/**
|
|
* The default delay between completing the content swap and settling attributes.
|
|
* @type number
|
|
* @default 20
|
|
*/
|
|
defaultSettleDelay: 20,
|
|
/**
|
|
* If true, htmx will inject a small amount of CSS into the page to make indicators invisible unless the **htmx-indicator** class is present.
|
|
* @type boolean
|
|
* @default true
|
|
*/
|
|
includeIndicatorStyles: true,
|
|
/**
|
|
* The class to place on indicators when a request is in flight.
|
|
* @type string
|
|
* @default 'htmx-indicator'
|
|
*/
|
|
indicatorClass: 'htmx-indicator',
|
|
/**
|
|
* The class to place on triggering elements when a request is in flight.
|
|
* @type string
|
|
* @default 'htmx-request'
|
|
*/
|
|
requestClass: 'htmx-request',
|
|
/**
|
|
* The class to temporarily place on elements that htmx has added to the DOM.
|
|
* @type string
|
|
* @default 'htmx-added'
|
|
*/
|
|
addedClass: 'htmx-added',
|
|
/**
|
|
* The class to place on target elements when htmx is in the settling phase.
|
|
* @type string
|
|
* @default 'htmx-settling'
|
|
*/
|
|
settlingClass: 'htmx-settling',
|
|
/**
|
|
* The class to place on target elements when htmx is in the swapping phase.
|
|
* @type string
|
|
* @default 'htmx-swapping'
|
|
*/
|
|
swappingClass: 'htmx-swapping',
|
|
/**
|
|
* Allows the use of eval-like functionality in htmx, to enable **hx-vars**, trigger conditions & script tag evaluation. Can be set to **false** for CSP compatibility.
|
|
* @type boolean
|
|
* @default true
|
|
*/
|
|
allowEval: true,
|
|
/**
|
|
* If set to false, disables the interpretation of script tags.
|
|
* @type boolean
|
|
* @default true
|
|
*/
|
|
allowScriptTags: true,
|
|
/**
|
|
* If set, the nonce will be added to inline scripts.
|
|
* @type string
|
|
* @default ''
|
|
*/
|
|
inlineScriptNonce: '',
|
|
/**
|
|
* If set, the nonce will be added to inline styles.
|
|
* @type string
|
|
* @default ''
|
|
*/
|
|
inlineStyleNonce: '',
|
|
/**
|
|
* The attributes to settle during the settling phase.
|
|
* @type string[]
|
|
* @default ['class', 'style', 'width', 'height']
|
|
*/
|
|
attributesToSettle: ['class', 'style', 'width', 'height'],
|
|
/**
|
|
* Allow cross-site Access-Control requests using credentials such as cookies, authorization headers or TLS client certificates.
|
|
* @type boolean
|
|
* @default false
|
|
*/
|
|
withCredentials: false,
|
|
/**
|
|
* @type number
|
|
* @default 0
|
|
*/
|
|
timeout: 0,
|
|
/**
|
|
* The default implementation of **getWebSocketReconnectDelay** for reconnecting after unexpected connection loss by the event code **Abnormal Closure**, **Service Restart** or **Try Again Later**.
|
|
* @type {'full-jitter' | ((retryCount:number) => number)}
|
|
* @default "full-jitter"
|
|
*/
|
|
wsReconnectDelay: 'full-jitter',
|
|
/**
|
|
* The type of binary data being received over the WebSocket connection
|
|
* @type BinaryType
|
|
* @default 'blob'
|
|
*/
|
|
wsBinaryType: 'blob',
|
|
/**
|
|
* @type string
|
|
* @default '[hx-disable], [data-hx-disable]'
|
|
*/
|
|
disableSelector: '[hx-disable], [data-hx-disable]',
|
|
/**
|
|
* @type {'auto' | 'instant' | 'smooth'}
|
|
* @default 'instant'
|
|
*/
|
|
scrollBehavior: 'instant',
|
|
/**
|
|
* If the focused element should be scrolled into view.
|
|
* @type boolean
|
|
* @default false
|
|
*/
|
|
defaultFocusScroll: false,
|
|
/**
|
|
* If set to true htmx will include a cache-busting parameter in GET requests to avoid caching partial responses by the browser
|
|
* @type boolean
|
|
* @default false
|
|
*/
|
|
getCacheBusterParam: false,
|
|
/**
|
|
* If set to true, htmx will use the View Transition API when swapping in new content.
|
|
* @type boolean
|
|
* @default false
|
|
*/
|
|
globalViewTransitions: false,
|
|
/**
|
|
* htmx will format requests with these methods by encoding their parameters in the URL, not the request body
|
|
* @type {(HttpVerb)[]}
|
|
* @default ['get', 'delete']
|
|
*/
|
|
methodsThatUseUrlParams: ['get', 'delete'],
|
|
/**
|
|
* If set to true, disables htmx-based requests to non-origin hosts.
|
|
* @type boolean
|
|
* @default true
|
|
*/
|
|
selfRequestsOnly: true,
|
|
/**
|
|
* If set to true htmx will not update the title of the document when a title tag is found in new content
|
|
* @type boolean
|
|
* @default false
|
|
*/
|
|
ignoreTitle: false,
|
|
/**
|
|
* Whether the target of a boosted element is scrolled into the viewport.
|
|
* @type boolean
|
|
* @default true
|
|
*/
|
|
scrollIntoViewOnBoost: true,
|
|
/**
|
|
* The cache to store evaluated trigger specifications into.
|
|
* You may define a simple object to use a never-clearing cache, or implement your own system using a [proxy object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Proxy)
|
|
* @type {Object|null}
|
|
* @default null
|
|
*/
|
|
triggerSpecsCache: null,
|
|
/** @type boolean */
|
|
disableInheritance: false,
|
|
/** @type HtmxResponseHandlingConfig[] */
|
|
responseHandling: [
|
|
{ code: '204', swap: false },
|
|
{ code: '[23]..', swap: true },
|
|
{ code: '[45]..', swap: false, error: true }
|
|
],
|
|
/**
|
|
* Whether to process OOB swaps on elements that are nested within the main response element.
|
|
* @type boolean
|
|
* @default true
|
|
*/
|
|
allowNestedOobSwaps: true,
|
|
/**
|
|
* Whether to treat history cache miss full page reload requests as a "HX-Request" by returning this response header
|
|
* This should always be disabled when using HX-Request header to optionally return partial responses
|
|
* @type boolean
|
|
* @default true
|
|
*/
|
|
historyRestoreAsHxRequest: true,
|
|
/**
|
|
* Whether to report input validation errors to the end user and update focus to the first input that fails validation.
|
|
* This should always be enabled as this matches default browser form submit behaviour
|
|
* @type boolean
|
|
* @default false
|
|
*/
|
|
reportValidityOfForms: false
|
|
},
|
|
/** @type {typeof parseInterval} */
|
|
parseInterval: null,
|
|
/**
|
|
* proxy of window.location used for page reload functions
|
|
* @type location
|
|
*/
|
|
location,
|
|
/** @type {typeof internalEval} */
|
|
_: null,
|
|
version: '2.0.11'
|
|
}
|
|
// Tsc madness part 2
|
|
htmx.onLoad = onLoadHelper
|
|
htmx.process = processNode
|
|
htmx.on = addEventListenerImpl
|
|
htmx.off = removeEventListenerImpl
|
|
htmx.trigger = triggerEvent
|
|
htmx.ajax = ajaxHelper
|
|
htmx.find = find
|
|
htmx.findAll = findAll
|
|
htmx.closest = closest
|
|
htmx.remove = removeElement
|
|
htmx.addClass = addClassToElement
|
|
htmx.removeClass = removeClassFromElement
|
|
htmx.toggleClass = toggleClassOnElement
|
|
htmx.takeClass = takeClassForElement
|
|
htmx.swap = swap
|
|
htmx.defineExtension = defineExtension
|
|
htmx.removeExtension = removeExtension
|
|
htmx.logAll = logAll
|
|
htmx.logNone = logNone
|
|
htmx.parseInterval = parseInterval
|
|
htmx._ = internalEval
|
|
|
|
const internalAPI = {
|
|
addTriggerHandler,
|
|
bodyContains,
|
|
canAccessLocalStorage,
|
|
findThisElement,
|
|
filterValues,
|
|
swap,
|
|
hasAttribute,
|
|
getAttributeValue,
|
|
getClosestAttributeValue,
|
|
getClosestMatch,
|
|
getExpressionVars,
|
|
getHeaders,
|
|
getInputValues,
|
|
getInternalData,
|
|
getSwapSpecification,
|
|
getTriggerSpecs,
|
|
getTarget,
|
|
makeFragment,
|
|
mergeObjects,
|
|
makeSettleInfo,
|
|
oobSwap,
|
|
querySelectorExt,
|
|
settleImmediately,
|
|
shouldCancel,
|
|
triggerEvent,
|
|
triggerErrorEvent,
|
|
withExtensions
|
|
}
|
|
|
|
const VERBS = ['get', 'post', 'put', 'delete', 'patch']
|
|
const VERB_SELECTOR = VERBS.map(function(verb) {
|
|
return '[hx-' + verb + '], [data-hx-' + verb + ']'
|
|
}).join(', ')
|
|
|
|
//= ===================================================================
|
|
// Utilities
|
|
//= ===================================================================
|
|
|
|
/**
|
|
* Parses an interval string consistent with the way htmx does. Useful for plugins that have timing-related attributes.
|
|
*
|
|
* Caution: Accepts an int followed by either **s** or **ms**. All other values use **parseFloat**
|
|
*
|
|
* @see https://htmx.org/api/#parseInterval
|
|
*
|
|
* @param {string} str timing string
|
|
* @returns {number|undefined}
|
|
*/
|
|
function parseInterval(str) {
|
|
if (str == undefined) {
|
|
return undefined
|
|
}
|
|
|
|
let interval = NaN
|
|
if (str.slice(-2) == 'ms') {
|
|
interval = parseFloat(str.slice(0, -2))
|
|
} else if (str.slice(-1) == 's') {
|
|
interval = parseFloat(str.slice(0, -1)) * 1000
|
|
} else if (str.slice(-1) == 'm') {
|
|
interval = parseFloat(str.slice(0, -1)) * 1000 * 60
|
|
} else {
|
|
interval = parseFloat(str)
|
|
}
|
|
return isNaN(interval) ? undefined : interval
|
|
}
|
|
|
|
/**
|
|
* @param {Node} elt
|
|
* @param {string} name
|
|
* @returns {(string | null)}
|
|
*/
|
|
function getRawAttribute(elt, name) {
|
|
return elt instanceof Element && elt.getAttribute(name)
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {string} qualifiedName
|
|
* @returns {boolean}
|
|
*/
|
|
// resolve with both hx and data-hx prefixes
|
|
function hasAttribute(elt, qualifiedName) {
|
|
return !!elt.hasAttribute && (elt.hasAttribute(qualifiedName) ||
|
|
elt.hasAttribute('data-' + qualifiedName))
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @param {Node} elt
|
|
* @param {string} qualifiedName
|
|
* @returns {(string | null)}
|
|
*/
|
|
function getAttributeValue(elt, qualifiedName) {
|
|
return getRawAttribute(elt, qualifiedName) || getRawAttribute(elt, 'data-' + qualifiedName)
|
|
}
|
|
|
|
/**
|
|
* @param {Node} elt
|
|
* @returns {Node | null}
|
|
*/
|
|
function parentElt(elt) {
|
|
const parent = elt.parentElement
|
|
if (!parent && elt.parentNode instanceof ShadowRoot) return elt.parentNode
|
|
return parent
|
|
}
|
|
|
|
/**
|
|
* @returns {Document}
|
|
*/
|
|
function getDocument() {
|
|
return document
|
|
}
|
|
|
|
/**
|
|
* @param {Node} elt
|
|
* @param {boolean} global
|
|
* @returns {Node|Document}
|
|
*/
|
|
function getRootNode(elt, global) {
|
|
return elt.getRootNode ? elt.getRootNode({ composed: global }) : getDocument()
|
|
}
|
|
|
|
/**
|
|
* @param {Node} elt
|
|
* @param {(e:Node) => boolean} condition
|
|
* @returns {Node | null}
|
|
*/
|
|
function getClosestMatch(elt, condition) {
|
|
while (elt && !condition(elt)) {
|
|
elt = parentElt(elt)
|
|
}
|
|
|
|
return elt || null
|
|
}
|
|
|
|
/**
|
|
* @param {Element} initialElement
|
|
* @param {Element} ancestor
|
|
* @param {string} attributeName
|
|
* @returns {string|null}
|
|
*/
|
|
function getAttributeValueWithDisinheritance(initialElement, ancestor, attributeName) {
|
|
const attributeValue = getAttributeValue(ancestor, attributeName)
|
|
const disinherit = getAttributeValue(ancestor, 'hx-disinherit')
|
|
var inherit = getAttributeValue(ancestor, 'hx-inherit')
|
|
if (initialElement !== ancestor) {
|
|
if (htmx.config.disableInheritance) {
|
|
if (inherit && (inherit === '*' || inherit.split(' ').indexOf(attributeName) >= 0)) {
|
|
return attributeValue
|
|
} else {
|
|
return null
|
|
}
|
|
}
|
|
if (disinherit && (disinherit === '*' || disinherit.split(' ').indexOf(attributeName) >= 0)) {
|
|
return 'unset'
|
|
}
|
|
}
|
|
return attributeValue
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {string} attributeName
|
|
* @returns {string | null}
|
|
*/
|
|
function getClosestAttributeValue(elt, attributeName) {
|
|
let closestAttr = null
|
|
getClosestMatch(elt, function(e) {
|
|
return !!(closestAttr = getAttributeValueWithDisinheritance(elt, asElement(e), attributeName))
|
|
})
|
|
if (closestAttr !== 'unset') {
|
|
return closestAttr
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Node} elt
|
|
* @param {string} selector
|
|
* @returns {boolean}
|
|
*/
|
|
function matches(elt, selector) {
|
|
return elt instanceof Element && elt.matches(selector)
|
|
}
|
|
|
|
/**
|
|
* @param {string} str
|
|
* @returns {string}
|
|
*/
|
|
function getStartTag(str) {
|
|
const tagMatcher = /<([a-z][^\/\0>\x20\t\r\n\f]*)/i
|
|
const match = tagMatcher.exec(str)
|
|
if (match) {
|
|
return match[1].toLowerCase()
|
|
} else {
|
|
return ''
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {string} resp
|
|
* @returns {Document}
|
|
*/
|
|
function parseHTML(resp) {
|
|
if ('parseHTMLUnsafe' in Document) {
|
|
return Document.parseHTMLUnsafe(resp)
|
|
}
|
|
const parser = new DOMParser()
|
|
return parser.parseFromString(resp, 'text/html')
|
|
}
|
|
|
|
/**
|
|
* @param {DocumentFragment} fragment
|
|
* @param {Node} elt
|
|
*/
|
|
function takeChildrenFor(fragment, elt) {
|
|
while (elt.childNodes.length > 0) {
|
|
fragment.append(elt.childNodes[0])
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {HTMLScriptElement} script
|
|
* @returns {HTMLScriptElement}
|
|
*/
|
|
function duplicateScript(script) {
|
|
const newScript = getDocument().createElement('script')
|
|
forEach(script.attributes, function(attr) {
|
|
newScript.setAttribute(attr.name, attr.value)
|
|
})
|
|
newScript.textContent = script.textContent
|
|
newScript.async = false
|
|
if (htmx.config.inlineScriptNonce) {
|
|
newScript.nonce = htmx.config.inlineScriptNonce
|
|
}
|
|
return newScript
|
|
}
|
|
|
|
/**
|
|
* @param {HTMLScriptElement} script
|
|
* @returns {boolean}
|
|
*/
|
|
function isJavaScriptScriptNode(script) {
|
|
return script.matches('script') && (script.type === 'text/javascript' || script.type === 'module' || script.type === '')
|
|
}
|
|
|
|
/**
|
|
* we have to make new copies of script tags that we are going to insert because
|
|
* SOME browsers (not saying who, but it involves an element and an animal) don't
|
|
* execute scripts created in <template> tags when they are inserted into the DOM
|
|
* and all the others do lmao
|
|
* @param {DocumentFragment} fragment
|
|
*/
|
|
function normalizeScriptTags(fragment) {
|
|
if (!htmx.config.allowScriptTags) {
|
|
// remove all script tags if scripts are disabled
|
|
fragment.querySelectorAll('script').forEach((script) => script.remove())
|
|
return
|
|
}
|
|
Array.from(fragment.querySelectorAll('script')).forEach(/** @param {HTMLScriptElement} script */ (script) => {
|
|
if (isJavaScriptScriptNode(script)) {
|
|
const newScript = duplicateScript(script)
|
|
const parent = script.parentNode
|
|
try {
|
|
parent.insertBefore(newScript, script)
|
|
} catch (e) {
|
|
logError(e)
|
|
} finally {
|
|
script.remove()
|
|
}
|
|
}
|
|
})
|
|
}
|
|
|
|
/**
|
|
* @typedef {DocumentFragment & {title?: string}} DocumentFragmentWithTitle
|
|
* @description a document fragment representing the response HTML, including
|
|
* a `title` property for any title information found
|
|
*/
|
|
|
|
/**
|
|
* @param {string} response HTML
|
|
* @returns {DocumentFragmentWithTitle}
|
|
*/
|
|
function makeFragment(response) {
|
|
// convert <hx-*> custom tags to <template hx type="*"> so they survive HTML parsing
|
|
response = response.replace(/<hx-([a-z]+)((?:\s[^>]*)?)>/gi, '<template hx type="$1"$2>').replace(/<\/hx-[a-z]+>/gi, '</template>')
|
|
// strip head tag to determine shape of response we are dealing with
|
|
const responseWithNoHead = response.replace(/<head(\s[^>]*)?>[\s\S]*?<\/head>/i, '')
|
|
const startTag = getStartTag(responseWithNoHead)
|
|
/** @type DocumentFragmentWithTitle */
|
|
let fragment
|
|
if (startTag === 'html') {
|
|
// if it is a full document, parse it and return the body
|
|
fragment = /** @type DocumentFragmentWithTitle */ (new DocumentFragment())
|
|
const doc = parseHTML(response)
|
|
takeChildrenFor(fragment, doc.body)
|
|
fragment.title = doc.title
|
|
} else if (startTag === 'body') {
|
|
// parse body w/o wrapping in template
|
|
fragment = /** @type DocumentFragmentWithTitle */ (new DocumentFragment())
|
|
const doc = parseHTML(responseWithNoHead)
|
|
takeChildrenFor(fragment, doc.body)
|
|
fragment.title = doc.title
|
|
} else {
|
|
// otherwise we have non-body partial HTML content, so wrap it in a template to maximize parsing flexibility
|
|
const doc = parseHTML('<body><template class="internal-htmx-wrapper">' + responseWithNoHead + '</template></body>')
|
|
fragment = /** @type DocumentFragmentWithTitle */ (doc.querySelector('template').content)
|
|
// extract title into fragment for later processing
|
|
fragment.title = doc.title
|
|
|
|
// for legacy reasons we support a title tag at the root level of non-body responses, so we need to handle it
|
|
var titleElement = fragment.querySelector('title')
|
|
if (titleElement && titleElement.parentNode === fragment) {
|
|
titleElement.remove()
|
|
fragment.title = titleElement.innerText
|
|
}
|
|
}
|
|
if (fragment) {
|
|
normalizeScriptTags(fragment)
|
|
}
|
|
return fragment
|
|
}
|
|
|
|
/**
|
|
* @param {Function} func
|
|
*/
|
|
function maybeCall(func) {
|
|
if (func) {
|
|
func()
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {any} o
|
|
* @param {string} type
|
|
* @returns
|
|
*/
|
|
function isType(o, type) {
|
|
return Object.prototype.toString.call(o) === '[object ' + type + ']'
|
|
}
|
|
|
|
/**
|
|
* @param {*} o
|
|
* @returns {o is Function}
|
|
*/
|
|
function isFunction(o) {
|
|
return typeof o === 'function'
|
|
}
|
|
|
|
/**
|
|
* @param {*} o
|
|
* @returns {o is Object}
|
|
*/
|
|
function isRawObject(o) {
|
|
return isType(o, 'Object')
|
|
}
|
|
|
|
/**
|
|
* @typedef {Object} OnHandler
|
|
* @property {(keyof HTMLElementEventMap)|string} event
|
|
* @property {EventListener} listener
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} ListenerInfo
|
|
* @property {string} trigger
|
|
* @property {EventListener} listener
|
|
* @property {EventTarget} on
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} HtmxNodeInternalData
|
|
* Element data
|
|
* @property {number} [initHash]
|
|
* @property {boolean} [boosted]
|
|
* @property {OnHandler[]} [onHandlers]
|
|
* @property {number} [timeout]
|
|
* @property {ListenerInfo[]} [listenerInfos]
|
|
* @property {boolean} [cancelled]
|
|
* @property {boolean} [triggeredOnce]
|
|
* @property {number} [delayed]
|
|
* @property {number|null} [throttle]
|
|
* @property {WeakMap<HtmxTriggerSpecification,WeakMap<EventTarget,string>>} [lastValue]
|
|
* @property {boolean} [loaded]
|
|
* @property {string} [path]
|
|
* @property {string} [verb]
|
|
* @property {boolean} [polling]
|
|
* @property {HTMLButtonElement|HTMLInputElement|null} [lastButtonClicked]
|
|
* @property {number} [requestCount]
|
|
* @property {XMLHttpRequest} [xhr]
|
|
* @property {(() => void)[]} [queuedRequests]
|
|
* @property {boolean} [abortable]
|
|
* @property {boolean} [firstInitCompleted]
|
|
*
|
|
* Event data
|
|
* @property {HtmxTriggerSpecification} [triggerSpec]
|
|
* @property {EventTarget[]} [handledFor]
|
|
*/
|
|
|
|
/**
|
|
* getInternalData retrieves "private" data stored by htmx within an element
|
|
* @param {EventTarget|Event} elt
|
|
* @returns {HtmxNodeInternalData}
|
|
*/
|
|
function getInternalData(elt) {
|
|
const dataProp = 'htmx-internal-data'
|
|
let data = elt[dataProp]
|
|
if (!data) {
|
|
data = elt[dataProp] = {}
|
|
}
|
|
return data
|
|
}
|
|
|
|
/**
|
|
* toArray converts an ArrayLike object into a real array.
|
|
* @template T
|
|
* @param {ArrayLike<T>} arr
|
|
* @returns {T[]}
|
|
*/
|
|
function toArray(arr) {
|
|
const returnArr = []
|
|
if (arr) {
|
|
for (let i = 0; i < arr.length; i++) {
|
|
returnArr.push(arr[i])
|
|
}
|
|
}
|
|
return returnArr
|
|
}
|
|
|
|
/**
|
|
* @template T
|
|
* @param {T[]|NamedNodeMap|HTMLCollection|HTMLFormControlsCollection|ArrayLike<T>} arr
|
|
* @param {(T) => void} func
|
|
*/
|
|
function forEach(arr, func) {
|
|
if (arr) {
|
|
for (let i = 0; i < arr.length; i++) {
|
|
func(arr[i])
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} el
|
|
* @returns {boolean}
|
|
*/
|
|
function isScrolledIntoView(el) {
|
|
const rect = el.getBoundingClientRect()
|
|
const elemTop = rect.top
|
|
const elemBottom = rect.bottom
|
|
return elemTop < window.innerHeight && elemBottom >= 0
|
|
}
|
|
|
|
/**
|
|
* Checks whether the element is in the document (includes shadow roots).
|
|
* This function this is a slight misnomer; it will return true even for elements in the head.
|
|
*
|
|
* @param {Node} elt
|
|
* @returns {boolean}
|
|
*/
|
|
function bodyContains(elt) {
|
|
return elt.getRootNode({ composed: true }) === document
|
|
}
|
|
|
|
/**
|
|
* @param {string} trigger
|
|
* @returns {string[]}
|
|
*/
|
|
function splitOnWhitespace(trigger) {
|
|
return trigger.trim().split(/\s+/)
|
|
}
|
|
|
|
/**
|
|
* mergeObjects takes all the keys from
|
|
* obj2 and duplicates them into obj1
|
|
* @template T1
|
|
* @template T2
|
|
* @param {T1} obj1
|
|
* @param {T2} obj2
|
|
* @returns {T1 & T2}
|
|
*/
|
|
function mergeObjects(obj1, obj2) {
|
|
return Object.assign({}, obj1, obj2)
|
|
}
|
|
|
|
/**
|
|
* @param {string} jString
|
|
* @returns {any|null}
|
|
*/
|
|
function parseJSON(jString) {
|
|
try {
|
|
return JSON.parse(jString)
|
|
} catch (error) {
|
|
logError(error)
|
|
return null
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @returns {boolean}
|
|
*/
|
|
function canAccessLocalStorage() {
|
|
const test = 'htmx:sessionStorageTest'
|
|
try {
|
|
sessionStorage.setItem(test, test)
|
|
sessionStorage.removeItem(test)
|
|
return true
|
|
} catch (e) {
|
|
return false
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {string} path
|
|
* @returns {string}
|
|
*/
|
|
function normalizePath(path) {
|
|
try {
|
|
const url = new URL(path, window.location.href)
|
|
path = url.pathname + url.search
|
|
} catch (e) {
|
|
// fallback for malformed URLs
|
|
}
|
|
// remove trailing slash, unless index page
|
|
if (path != '/') {
|
|
path = path.replace(/\/+$/, '')
|
|
}
|
|
return path
|
|
}
|
|
|
|
//= =========================================================================================
|
|
// public API
|
|
//= =========================================================================================
|
|
|
|
/**
|
|
* @param {string} str
|
|
* @returns {any}
|
|
*/
|
|
function internalEval(str) {
|
|
return maybeEval(getDocument().body, function() {
|
|
return eval(str)
|
|
})
|
|
}
|
|
|
|
/**
|
|
* Adds a callback for the **htmx:load** event. This can be used to process new content, for example initializing the content with a javascript library
|
|
*
|
|
* @see https://htmx.org/api/#onLoad
|
|
*
|
|
* @param {(elt: Node) => void} callback the callback to call on newly loaded content
|
|
* @returns {EventListener}
|
|
*/
|
|
function onLoadHelper(callback) {
|
|
const value = htmx.on('htmx:load', /** @param {CustomEvent} evt */ function(evt) {
|
|
callback(evt.detail.elt)
|
|
})
|
|
return value
|
|
}
|
|
|
|
/**
|
|
* Log all htmx events, useful for debugging.
|
|
*
|
|
* @see https://htmx.org/api/#logAll
|
|
*/
|
|
function logAll() {
|
|
htmx.logger = function(elt, event, data) {
|
|
if (console) {
|
|
console.log(event, elt, data)
|
|
}
|
|
}
|
|
}
|
|
|
|
function logNone() {
|
|
htmx.logger = null
|
|
}
|
|
|
|
/**
|
|
* Finds an element matching the selector
|
|
*
|
|
* @see https://htmx.org/api/#find
|
|
*
|
|
* @param {ParentNode|string} eltOrSelector the root element to search inside of, not including the root itself | the selector to match
|
|
* @param {string} [selector] the selector to match
|
|
* @returns {Element|null}
|
|
*/
|
|
function find(eltOrSelector, selector) {
|
|
if (typeof eltOrSelector !== 'string') {
|
|
return eltOrSelector.querySelector(selector)
|
|
} else {
|
|
return find(getDocument(), eltOrSelector)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Finds all elements matching the selector
|
|
*
|
|
* @see https://htmx.org/api/#findAll
|
|
*
|
|
* @param {ParentNode|string} eltOrSelector the root element to search inside of, not including the root itself | the selector to match
|
|
* @param {string} [selector] the selector to match
|
|
* @returns {NodeListOf<Element>}
|
|
*/
|
|
function findAll(eltOrSelector, selector) {
|
|
if (typeof eltOrSelector !== 'string') {
|
|
return eltOrSelector.querySelectorAll(selector)
|
|
} else {
|
|
return findAll(getDocument(), eltOrSelector)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @returns Window
|
|
*/
|
|
function getWindow() {
|
|
return window
|
|
}
|
|
|
|
/**
|
|
* Removes an element from the DOM
|
|
*
|
|
* @see https://htmx.org/api/#remove
|
|
*
|
|
* @param {Node} elt
|
|
* @param {number} [delay]
|
|
*/
|
|
function removeElement(elt, delay) {
|
|
elt = resolveTarget(elt)
|
|
if (delay) {
|
|
getWindow().setTimeout(function() {
|
|
removeElement(elt)
|
|
elt = null
|
|
}, delay)
|
|
} else {
|
|
parentElt(elt).removeChild(elt)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {any} elt
|
|
* @return {Element|null}
|
|
*/
|
|
function asElement(elt) {
|
|
return elt instanceof Element ? elt : null
|
|
}
|
|
|
|
/**
|
|
* @param {any} elt
|
|
* @return {HTMLElement|null}
|
|
*/
|
|
function asHtmlElement(elt) {
|
|
return elt instanceof HTMLElement ? elt : null
|
|
}
|
|
|
|
/**
|
|
* @param {any} value
|
|
* @return {string|null}
|
|
*/
|
|
function asString(value) {
|
|
return typeof value === 'string' ? value : null
|
|
}
|
|
|
|
/**
|
|
* @param {EventTarget} elt
|
|
* @return {ParentNode|null}
|
|
*/
|
|
function asParentNode(elt) {
|
|
return elt instanceof Element || elt instanceof Document || elt instanceof DocumentFragment ? elt : null
|
|
}
|
|
|
|
/**
|
|
* This method adds a class to the given element.
|
|
*
|
|
* @see https://htmx.org/api/#addClass
|
|
*
|
|
* @param {Element|string} elt the element to add the class to
|
|
* @param {string} clazz the class to add
|
|
* @param {number} [delay] the delay (in milliseconds) before class is added
|
|
*/
|
|
function addClassToElement(elt, clazz, delay) {
|
|
elt = asElement(resolveTarget(elt))
|
|
if (!elt) {
|
|
return
|
|
}
|
|
if (delay) {
|
|
getWindow().setTimeout(function() {
|
|
addClassToElement(elt, clazz)
|
|
elt = null
|
|
}, delay)
|
|
} else {
|
|
elt.classList && elt.classList.add(clazz)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Removes a class from the given element
|
|
*
|
|
* @see https://htmx.org/api/#removeClass
|
|
*
|
|
* @param {Node|string} node element to remove the class from
|
|
* @param {string} clazz the class to remove
|
|
* @param {number} [delay] the delay (in milliseconds before class is removed)
|
|
*/
|
|
function removeClassFromElement(node, clazz, delay) {
|
|
let elt = asElement(resolveTarget(node))
|
|
if (!elt) {
|
|
return
|
|
}
|
|
if (delay) {
|
|
getWindow().setTimeout(function() {
|
|
removeClassFromElement(elt, clazz)
|
|
elt = null
|
|
}, delay)
|
|
} else {
|
|
if (elt.classList) {
|
|
elt.classList.remove(clazz)
|
|
// if there are no classes left, remove the class attribute
|
|
if (elt.classList.length === 0) {
|
|
elt.removeAttribute('class')
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Toggles the given class on an element
|
|
*
|
|
* @see https://htmx.org/api/#toggleClass
|
|
*
|
|
* @param {Element|string} elt the element to toggle the class on
|
|
* @param {string} clazz the class to toggle
|
|
*/
|
|
function toggleClassOnElement(elt, clazz) {
|
|
elt = resolveTarget(elt)
|
|
elt.classList.toggle(clazz)
|
|
}
|
|
|
|
/**
|
|
* Takes the given class from its siblings, so that among its siblings, only the given element will have the class.
|
|
*
|
|
* @see https://htmx.org/api/#takeClass
|
|
*
|
|
* @param {Node|string} elt the element that will take the class
|
|
* @param {string} clazz the class to take
|
|
*/
|
|
function takeClassForElement(elt, clazz) {
|
|
elt = resolveTarget(elt)
|
|
forEach(elt.parentElement.children, function(child) {
|
|
removeClassFromElement(child, clazz)
|
|
})
|
|
addClassToElement(asElement(elt), clazz)
|
|
}
|
|
|
|
/**
|
|
* Finds the closest matching element in the given elements parentage, inclusive of the element
|
|
*
|
|
* @see https://htmx.org/api/#closest
|
|
*
|
|
* @param {Element|string} elt the element to find the selector from
|
|
* @param {string} selector the selector to find
|
|
* @returns {Element|null}
|
|
*/
|
|
function closest(elt, selector) {
|
|
elt = asElement(resolveTarget(elt))
|
|
if (elt) {
|
|
return elt.closest(selector)
|
|
}
|
|
return null
|
|
}
|
|
|
|
/**
|
|
* @param {string} str
|
|
* @param {string} prefix
|
|
* @returns {boolean}
|
|
*/
|
|
function startsWith(str, prefix) {
|
|
return str.substring(0, prefix.length) === prefix
|
|
}
|
|
|
|
/**
|
|
* @param {string} str
|
|
* @param {string} suffix
|
|
* @returns {boolean}
|
|
*/
|
|
function endsWith(str, suffix) {
|
|
return str.substring(str.length - suffix.length) === suffix
|
|
}
|
|
|
|
/**
|
|
* @param {string} selector
|
|
* @returns {string}
|
|
*/
|
|
function normalizeSelector(selector) {
|
|
const trimmedSelector = selector.trim()
|
|
if (startsWith(trimmedSelector, '<') && endsWith(trimmedSelector, '/>')) {
|
|
return trimmedSelector.substring(1, trimmedSelector.length - 2)
|
|
} else {
|
|
return trimmedSelector
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Node|Element|Document|string} elt
|
|
* @param {string} selector
|
|
* @param {boolean=} global
|
|
* @returns {(Node|Window)[]}
|
|
*/
|
|
function querySelectorAllExt(elt, selector, global) {
|
|
if (selector.indexOf('global ') === 0) {
|
|
return querySelectorAllExt(elt, selector.slice(7), true)
|
|
}
|
|
|
|
elt = resolveTarget(elt)
|
|
|
|
const parts = []
|
|
{
|
|
let chevronsCount = 0
|
|
let offset = 0
|
|
for (let i = 0; i < selector.length; i++) {
|
|
const char = selector[i]
|
|
if (char === ',' && chevronsCount === 0) {
|
|
parts.push(selector.substring(offset, i))
|
|
offset = i + 1
|
|
continue
|
|
}
|
|
if (char === '<') {
|
|
chevronsCount++
|
|
} else if (char === '/' && i < selector.length - 1 && selector[i + 1] === '>') {
|
|
chevronsCount--
|
|
}
|
|
}
|
|
if (offset < selector.length) {
|
|
parts.push(selector.substring(offset))
|
|
}
|
|
}
|
|
|
|
const result = []
|
|
const unprocessedParts = []
|
|
while (parts.length > 0) {
|
|
const selector = normalizeSelector(parts.shift())
|
|
let item
|
|
if (selector.indexOf('closest ') === 0) {
|
|
item = closest(asElement(elt), normalizeSelector(selector.slice(8)))
|
|
} else if (selector.indexOf('find ') === 0) {
|
|
item = find(asParentNode(elt), normalizeSelector(selector.slice(5)))
|
|
} else if (selector === 'next' || selector === 'nextElementSibling') {
|
|
item = asElement(elt).nextElementSibling
|
|
} else if (selector.indexOf('next ') === 0) {
|
|
item = scanForwardQuery(elt, normalizeSelector(selector.slice(5)), !!global)
|
|
} else if (selector === 'previous' || selector === 'previousElementSibling') {
|
|
item = asElement(elt).previousElementSibling
|
|
} else if (selector.indexOf('previous ') === 0) {
|
|
item = scanBackwardsQuery(elt, normalizeSelector(selector.slice(9)), !!global)
|
|
} else if (selector === 'document') {
|
|
item = document
|
|
} else if (selector === 'window') {
|
|
item = window
|
|
} else if (selector === 'body') {
|
|
item = document.body
|
|
} else if (selector === 'root') {
|
|
item = getRootNode(elt, !!global)
|
|
} else if (selector === 'host') {
|
|
item = (/** @type ShadowRoot */(elt.getRootNode())).host
|
|
} else {
|
|
unprocessedParts.push(selector)
|
|
}
|
|
|
|
if (item) {
|
|
result.push(item)
|
|
}
|
|
}
|
|
|
|
if (unprocessedParts.length > 0) {
|
|
const standardSelector = unprocessedParts.join(',')
|
|
const rootNode = asParentNode(getRootNode(elt, !!global))
|
|
result.push(...toArray(rootNode.querySelectorAll(standardSelector)))
|
|
}
|
|
|
|
return result
|
|
}
|
|
|
|
/**
|
|
* @param {Node} start
|
|
* @param {string} match
|
|
* @param {boolean} global
|
|
* @returns {Element}
|
|
*/
|
|
var scanForwardQuery = function(start, match, global) {
|
|
const results = asParentNode(getRootNode(start, global)).querySelectorAll(match)
|
|
for (let i = 0; i < results.length; i++) {
|
|
const elt = results[i]
|
|
if (elt.compareDocumentPosition(start) === Node.DOCUMENT_POSITION_PRECEDING) {
|
|
return elt
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Node} start
|
|
* @param {string} match
|
|
* @param {boolean} global
|
|
* @returns {Element}
|
|
*/
|
|
var scanBackwardsQuery = function(start, match, global) {
|
|
const results = asParentNode(getRootNode(start, global)).querySelectorAll(match)
|
|
for (let i = results.length - 1; i >= 0; i--) {
|
|
const elt = results[i]
|
|
if (elt.compareDocumentPosition(start) === Node.DOCUMENT_POSITION_FOLLOWING) {
|
|
return elt
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Node|string} eltOrSelector
|
|
* @param {string=} selector
|
|
* @returns {Node|Window}
|
|
*/
|
|
function querySelectorExt(eltOrSelector, selector) {
|
|
if (typeof eltOrSelector !== 'string') {
|
|
return querySelectorAllExt(eltOrSelector, selector)[0]
|
|
} else {
|
|
return querySelectorAllExt(getDocument().body, eltOrSelector)[0]
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @template {EventTarget} T
|
|
* @param {T|string} eltOrSelector
|
|
* @param {T} [context]
|
|
* @returns {Element|T|null}
|
|
*/
|
|
function resolveTarget(eltOrSelector, context) {
|
|
if (typeof eltOrSelector === 'string') {
|
|
return find(asParentNode(context) || document, eltOrSelector)
|
|
} else {
|
|
return eltOrSelector
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @typedef {keyof HTMLElementEventMap|string} AnyEventName
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} EventArgs
|
|
* @property {EventTarget} target
|
|
* @property {AnyEventName} event
|
|
* @property {EventListener} listener
|
|
* @property {Object|boolean} options
|
|
*/
|
|
|
|
/**
|
|
* @param {EventTarget|AnyEventName} arg1
|
|
* @param {AnyEventName|EventListener} arg2
|
|
* @param {EventListener|Object|boolean} [arg3]
|
|
* @param {Object|boolean} [arg4]
|
|
* @returns {EventArgs}
|
|
*/
|
|
function processEventArgs(arg1, arg2, arg3, arg4) {
|
|
if (isFunction(arg2)) {
|
|
return {
|
|
target: getDocument().body,
|
|
event: asString(arg1),
|
|
listener: arg2,
|
|
options: arg3
|
|
}
|
|
} else {
|
|
return {
|
|
target: resolveTarget(arg1),
|
|
event: asString(arg2),
|
|
listener: arg3,
|
|
options: arg4
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Adds an event listener to an element
|
|
*
|
|
* @see https://htmx.org/api/#on
|
|
*
|
|
* @param {EventTarget|string} arg1 the element to add the listener to | the event name to add the listener for
|
|
* @param {string|EventListener} arg2 the event name to add the listener for | the listener to add
|
|
* @param {EventListener|Object|boolean} [arg3] the listener to add | options to add
|
|
* @param {Object|boolean} [arg4] options to add
|
|
* @returns {EventListener}
|
|
*/
|
|
function addEventListenerImpl(arg1, arg2, arg3, arg4) {
|
|
ready(function() {
|
|
const eventArgs = processEventArgs(arg1, arg2, arg3, arg4)
|
|
eventArgs.target.addEventListener(eventArgs.event, eventArgs.listener, eventArgs.options)
|
|
})
|
|
const b = isFunction(arg2)
|
|
return b ? arg2 : arg3
|
|
}
|
|
|
|
/**
|
|
* Removes an event listener from an element
|
|
*
|
|
* @see https://htmx.org/api/#off
|
|
*
|
|
* @param {EventTarget|string} arg1 the element to remove the listener from | the event name to remove the listener from
|
|
* @param {string|EventListener} arg2 the event name to remove the listener from | the listener to remove
|
|
* @param {EventListener} [arg3] the listener to remove
|
|
* @returns {EventListener}
|
|
*/
|
|
function removeEventListenerImpl(arg1, arg2, arg3) {
|
|
ready(function() {
|
|
const eventArgs = processEventArgs(arg1, arg2, arg3)
|
|
eventArgs.target.removeEventListener(eventArgs.event, eventArgs.listener)
|
|
})
|
|
return isFunction(arg2) ? arg2 : arg3
|
|
}
|
|
|
|
//= ===================================================================
|
|
// Node processing
|
|
//= ===================================================================
|
|
|
|
const DUMMY_ELT = getDocument().createElement('output') // dummy element for bad selectors
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {string} attrName
|
|
* @returns {(Node|Window)[]}
|
|
*/
|
|
function findAttributeTargets(elt, attrName) {
|
|
const attrTarget = getClosestAttributeValue(elt, attrName)
|
|
if (attrTarget) {
|
|
if (attrTarget === 'this') {
|
|
return [findThisElement(elt, attrName)]
|
|
} else {
|
|
const result = querySelectorAllExt(elt, attrTarget)
|
|
// find `inherit` whole word in value, make sure it's surrounded by commas or is at the start/end of string
|
|
const shouldInherit = /(^|,)(\s*)inherit(\s*)($|,)/.test(attrTarget)
|
|
if (shouldInherit) {
|
|
const eltToInheritFrom = asElement(getClosestMatch(elt, function(parent) {
|
|
return parent !== elt && hasAttribute(asElement(parent), attrName)
|
|
}))
|
|
if (eltToInheritFrom) {
|
|
result.push(...findAttributeTargets(eltToInheritFrom, attrName))
|
|
}
|
|
}
|
|
if (result.length === 0) {
|
|
logError('The selector "' + attrTarget + '" on ' + attrName + ' returned no matches!')
|
|
return [DUMMY_ELT]
|
|
} else {
|
|
return result
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {string} attribute
|
|
* @returns {Element|null}
|
|
*/
|
|
function findThisElement(elt, attribute) {
|
|
return asElement(getClosestMatch(elt, function(elt) {
|
|
return getAttributeValue(asElement(elt), attribute) != null
|
|
}))
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @returns {Node|Window|null}
|
|
*/
|
|
function getTarget(elt) {
|
|
const targetStr = getClosestAttributeValue(elt, 'hx-target')
|
|
if (targetStr) {
|
|
if (targetStr === 'this') {
|
|
return findThisElement(elt, 'hx-target')
|
|
} else {
|
|
return querySelectorExt(elt, targetStr)
|
|
}
|
|
} else {
|
|
const data = getInternalData(elt)
|
|
if (data.boosted) {
|
|
return getDocument().body
|
|
} else {
|
|
return elt
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {string} name
|
|
* @returns {boolean}
|
|
*/
|
|
function shouldSettleAttribute(name) {
|
|
return htmx.config.attributesToSettle.includes(name)
|
|
}
|
|
|
|
/**
|
|
* @param {Element} mergeTo
|
|
* @param {Element} mergeFrom
|
|
*/
|
|
function cloneAttributes(mergeTo, mergeFrom) {
|
|
forEach(Array.from(mergeTo.attributes), function(attr) {
|
|
if (!mergeFrom.hasAttribute(attr.name) && shouldSettleAttribute(attr.name)) {
|
|
mergeTo.removeAttribute(attr.name)
|
|
}
|
|
})
|
|
forEach(mergeFrom.attributes, function(attr) {
|
|
if (shouldSettleAttribute(attr.name)) {
|
|
mergeTo.setAttribute(attr.name, attr.value)
|
|
}
|
|
})
|
|
}
|
|
|
|
/**
|
|
* @param {HtmxSwapStyle} swapStyle
|
|
* @param {Element} target
|
|
* @returns {boolean}
|
|
*/
|
|
function isInlineSwap(swapStyle, target) {
|
|
const extensions = getExtensions(target)
|
|
for (let i = 0; i < extensions.length; i++) {
|
|
const extension = extensions[i]
|
|
try {
|
|
if (extension.isInlineSwap(swapStyle)) {
|
|
return true
|
|
}
|
|
} catch (e) {
|
|
logError(e)
|
|
}
|
|
}
|
|
return swapStyle === 'outerHTML'
|
|
}
|
|
|
|
/**
|
|
* @param {string} oobValue
|
|
* @param {Element} oobElement
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
* @param {Node|Document} [rootNode]
|
|
* @returns
|
|
*/
|
|
function oobSwap(oobValue, oobElement, settleInfo, rootNode) {
|
|
rootNode = rootNode || getDocument()
|
|
let selector = '#' + CSS.escape(getRawAttribute(oobElement, 'id'))
|
|
/** @type HtmxSwapStyle */
|
|
let swapStyle = 'outerHTML'
|
|
if (oobValue === 'true') {
|
|
// do nothing
|
|
} else if (oobValue.indexOf(':') > 0) {
|
|
swapStyle = oobValue.substring(0, oobValue.indexOf(':'))
|
|
selector = oobValue.substring(oobValue.indexOf(':') + 1)
|
|
} else {
|
|
swapStyle = oobValue
|
|
}
|
|
oobElement.removeAttribute('hx-swap-oob')
|
|
oobElement.removeAttribute('data-hx-swap-oob')
|
|
|
|
const targets = querySelectorAllExt(rootNode, selector, false)
|
|
if (targets.length) {
|
|
forEach(
|
|
targets,
|
|
function(target) {
|
|
let fragment
|
|
const oobElementClone = oobElement.cloneNode(true)
|
|
fragment = getDocument().createDocumentFragment()
|
|
fragment.appendChild(oobElementClone)
|
|
if (!isInlineSwap(swapStyle, target)) {
|
|
fragment = asParentNode(oobElementClone) // if this is not an inline swap, we use the content of the node, not the node itself
|
|
}
|
|
|
|
const beforeSwapDetails = { shouldSwap: true, target, fragment }
|
|
if (!triggerEvent(target, 'htmx:oobBeforeSwap', beforeSwapDetails)) return
|
|
|
|
target = beforeSwapDetails.target // allow re-targeting
|
|
if (beforeSwapDetails.shouldSwap) {
|
|
handlePreservedElements(fragment)
|
|
swapWithStyle(swapStyle, target, target, fragment, settleInfo)
|
|
restorePreservedElements()
|
|
}
|
|
forEach(settleInfo.elts, function(elt) {
|
|
triggerEvent(elt, 'htmx:oobAfterSwap', beforeSwapDetails)
|
|
})
|
|
}
|
|
)
|
|
oobElement.parentNode.removeChild(oobElement)
|
|
} else {
|
|
oobElement.parentNode.removeChild(oobElement)
|
|
triggerErrorEvent(getDocument().body, 'htmx:oobErrorNoTarget', { content: oobElement, target: selector })
|
|
}
|
|
return oobValue
|
|
}
|
|
|
|
function restorePreservedElements() {
|
|
const pantry = find('#--htmx-preserve-pantry--')
|
|
if (pantry) {
|
|
for (const preservedElt of [...pantry.children]) {
|
|
const existingElement = find('#' + preservedElt.id)
|
|
// @ts-ignore - use proposed moveBefore feature
|
|
existingElement.parentNode.moveBefore(preservedElt, existingElement)
|
|
existingElement.remove()
|
|
}
|
|
pantry.remove()
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {DocumentFragment|ParentNode} fragment
|
|
*/
|
|
function handlePreservedElements(fragment) {
|
|
forEach(findAll(fragment, '[hx-preserve], [data-hx-preserve]'), function(preservedElt) {
|
|
const id = getAttributeValue(preservedElt, 'id')
|
|
const existingElement = getDocument().getElementById(id)
|
|
if (existingElement != null) {
|
|
if (preservedElt.moveBefore) { // if the moveBefore API exists, use it
|
|
// get or create a storage spot for stuff
|
|
let pantry = find('#--htmx-preserve-pantry--')
|
|
if (pantry == null) {
|
|
getDocument().body.insertAdjacentHTML('afterend', "<div id='--htmx-preserve-pantry--'></div>")
|
|
pantry = find('#--htmx-preserve-pantry--')
|
|
}
|
|
// @ts-ignore - use proposed moveBefore feature
|
|
pantry.moveBefore(existingElement, null)
|
|
} else {
|
|
preservedElt.parentNode.replaceChild(existingElement, preservedElt)
|
|
}
|
|
}
|
|
})
|
|
}
|
|
|
|
/**
|
|
* @param {Node} parentNode
|
|
* @param {ParentNode} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
*/
|
|
function handleAttributes(parentNode, fragment, settleInfo) {
|
|
forEach(fragment.querySelectorAll('[id]'), function(newNode) {
|
|
const id = getRawAttribute(newNode, 'id')
|
|
if (id && id.length > 0) {
|
|
const parentElt = asParentNode(parentNode)
|
|
const oldNode = parentElt && parentElt.querySelector(CSS.escape(newNode.tagName) + '#' + CSS.escape(id))
|
|
if (oldNode && oldNode !== parentElt) {
|
|
const newAttributes = newNode.cloneNode()
|
|
cloneAttributes(newNode, oldNode)
|
|
settleInfo.tasks.push(function() {
|
|
cloneAttributes(newNode, newAttributes)
|
|
})
|
|
}
|
|
}
|
|
})
|
|
}
|
|
|
|
/**
|
|
* @param {Node} child
|
|
* @returns {HtmxSettleTask}
|
|
*/
|
|
function makeAjaxLoadTask(child) {
|
|
return function() {
|
|
removeClassFromElement(child, htmx.config.addedClass)
|
|
processNode(asElement(child))
|
|
processFocus(asParentNode(child))
|
|
triggerEvent(child, 'htmx:load')
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {ParentNode} child
|
|
*/
|
|
function processFocus(child) {
|
|
const autofocus = '[autofocus]'
|
|
const autoFocusedElt = asHtmlElement(matches(child, autofocus) ? child : child.querySelector(autofocus))
|
|
if (autoFocusedElt != null) {
|
|
autoFocusedElt.focus()
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Node} parentNode
|
|
* @param {Node} insertBefore
|
|
* @param {ParentNode} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
*/
|
|
function insertNodesBefore(parentNode, insertBefore, fragment, settleInfo) {
|
|
handleAttributes(parentNode, fragment, settleInfo)
|
|
while (fragment.childNodes.length > 0) {
|
|
const child = fragment.firstChild
|
|
addClassToElement(asElement(child), htmx.config.addedClass)
|
|
parentNode.insertBefore(child, insertBefore)
|
|
if (child.nodeType !== Node.TEXT_NODE && child.nodeType !== Node.COMMENT_NODE) {
|
|
settleInfo.tasks.push(makeAjaxLoadTask(child))
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* based on https://gist.github.com/hyamamoto/fd435505d29ebfa3d9716fd2be8d42f0,
|
|
* derived from Java's string hashcode implementation
|
|
* @param {string} string
|
|
* @param {number} hash
|
|
* @returns {number}
|
|
*/
|
|
function stringHash(string, hash) {
|
|
let char = 0
|
|
while (char < string.length) {
|
|
hash = (hash << 5) - hash + string.charCodeAt(char++) | 0 // bitwise or ensures we have a 32-bit int
|
|
}
|
|
return hash
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @returns {number}
|
|
*/
|
|
function attributeHash(elt) {
|
|
let hash = 0
|
|
for (let i = 0; i < elt.attributes.length; i++) {
|
|
const attribute = elt.attributes[i]
|
|
if (attribute.value) { // only include attributes w/ actual values (empty is same as non-existent)
|
|
hash = stringHash(attribute.name, hash)
|
|
hash = stringHash(attribute.value, hash)
|
|
}
|
|
}
|
|
return hash
|
|
}
|
|
|
|
/**
|
|
* @param {EventTarget} elt
|
|
*/
|
|
function deInitOnHandlers(elt) {
|
|
const internalData = getInternalData(elt)
|
|
if (internalData.onHandlers) {
|
|
for (let i = 0; i < internalData.onHandlers.length; i++) {
|
|
const handlerInfo = internalData.onHandlers[i]
|
|
removeEventListenerImpl(elt, handlerInfo.event, handlerInfo.listener)
|
|
}
|
|
delete internalData.onHandlers
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Node} element
|
|
*/
|
|
function deInitNode(element) {
|
|
const internalData = getInternalData(element)
|
|
if (internalData.timeout) {
|
|
clearTimeout(internalData.timeout)
|
|
}
|
|
if (internalData.listenerInfos) {
|
|
forEach(internalData.listenerInfos, function(info) {
|
|
if (info.on) {
|
|
removeEventListenerImpl(info.on, info.trigger, info.listener)
|
|
}
|
|
})
|
|
}
|
|
deInitOnHandlers(element)
|
|
forEach(Object.keys(internalData), function(key) { if (key !== 'firstInitCompleted') delete internalData[key] })
|
|
}
|
|
|
|
/**
|
|
* @param {Node} element
|
|
*/
|
|
function cleanUpElement(element) {
|
|
triggerEvent(element, 'htmx:beforeCleanupElement')
|
|
deInitNode(element)
|
|
// @ts-ignore
|
|
forEach(element.children, function(child) { cleanUpElement(child) })
|
|
}
|
|
|
|
/**
|
|
* @param {Element} target
|
|
* @param {ParentNode} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
*/
|
|
function swapOuterHTML(target, fragment, settleInfo) {
|
|
if (target.tagName === 'BODY') { // special case the body to innerHTML because DocumentFragments can't contain a body elt unfortunately
|
|
return swapInnerHTML(target, fragment, settleInfo)
|
|
}
|
|
/** @type {Node} */
|
|
let newElt
|
|
const eltBeforeNewContent = target.previousSibling
|
|
const parentNode = parentElt(target)
|
|
if (!parentNode) { // when parent node disappears, we can't do anything
|
|
return
|
|
}
|
|
insertNodesBefore(parentNode, target, fragment, settleInfo)
|
|
if (eltBeforeNewContent == null) {
|
|
newElt = parentNode.firstChild
|
|
} else {
|
|
newElt = eltBeforeNewContent.nextSibling
|
|
}
|
|
settleInfo.elts = settleInfo.elts.filter(function(e) { return e !== target })
|
|
// scan through all newly added content and add all elements to the settle info so we trigger
|
|
// events properly on them
|
|
while (newElt && newElt !== target) {
|
|
if (newElt instanceof Element) {
|
|
settleInfo.elts.push(newElt)
|
|
}
|
|
newElt = newElt.nextSibling
|
|
}
|
|
cleanUpElement(target)
|
|
target.remove()
|
|
}
|
|
|
|
/**
|
|
* @param {Element} target
|
|
* @param {ParentNode} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
*/
|
|
function swapAfterBegin(target, fragment, settleInfo) {
|
|
return insertNodesBefore(target, target.firstChild, fragment, settleInfo)
|
|
}
|
|
|
|
/**
|
|
* @param {Element} target
|
|
* @param {ParentNode} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
*/
|
|
function swapBeforeBegin(target, fragment, settleInfo) {
|
|
return insertNodesBefore(parentElt(target), target, fragment, settleInfo)
|
|
}
|
|
|
|
/**
|
|
* @param {Element} target
|
|
* @param {ParentNode} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
*/
|
|
function swapBeforeEnd(target, fragment, settleInfo) {
|
|
return insertNodesBefore(target, null, fragment, settleInfo)
|
|
}
|
|
|
|
/**
|
|
* @param {Element} target
|
|
* @param {ParentNode} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
*/
|
|
function swapAfterEnd(target, fragment, settleInfo) {
|
|
return insertNodesBefore(parentElt(target), target.nextSibling, fragment, settleInfo)
|
|
}
|
|
|
|
/**
|
|
* @param {Element} target
|
|
*/
|
|
function swapDelete(target) {
|
|
cleanUpElement(target)
|
|
const parent = parentElt(target)
|
|
if (parent) {
|
|
return parent.removeChild(target)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} target
|
|
* @param {ParentNode} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
*/
|
|
function swapInnerHTML(target, fragment, settleInfo) {
|
|
const firstChild = target.firstChild
|
|
insertNodesBefore(target, firstChild, fragment, settleInfo)
|
|
if (firstChild) {
|
|
while (firstChild.nextSibling) {
|
|
cleanUpElement(firstChild.nextSibling)
|
|
target.removeChild(firstChild.nextSibling)
|
|
}
|
|
cleanUpElement(firstChild)
|
|
target.removeChild(firstChild)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {HtmxSwapStyle} swapStyle
|
|
* @param {Element} elt
|
|
* @param {Element} target
|
|
* @param {ParentNode} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
*/
|
|
function swapWithStyle(swapStyle, elt, target, fragment, settleInfo) {
|
|
switch (swapStyle) {
|
|
case 'none':
|
|
return
|
|
case 'outerHTML':
|
|
swapOuterHTML(target, fragment, settleInfo)
|
|
return
|
|
case 'afterbegin':
|
|
swapAfterBegin(target, fragment, settleInfo)
|
|
return
|
|
case 'beforebegin':
|
|
swapBeforeBegin(target, fragment, settleInfo)
|
|
return
|
|
case 'beforeend':
|
|
swapBeforeEnd(target, fragment, settleInfo)
|
|
return
|
|
case 'afterend':
|
|
swapAfterEnd(target, fragment, settleInfo)
|
|
return
|
|
case 'delete':
|
|
swapDelete(target)
|
|
return
|
|
default:
|
|
var extensions = getExtensions(elt)
|
|
for (let i = 0; i < extensions.length; i++) {
|
|
const ext = extensions[i]
|
|
try {
|
|
const newElements = ext.handleSwap(swapStyle, target, fragment, settleInfo)
|
|
if (newElements) {
|
|
if (Array.isArray(newElements)) {
|
|
// if handleSwap returns an array (like) of elements, we handle them
|
|
for (let j = 0; j < newElements.length; j++) {
|
|
const child = newElements[j]
|
|
if (child.nodeType !== Node.TEXT_NODE && child.nodeType !== Node.COMMENT_NODE) {
|
|
settleInfo.tasks.push(makeAjaxLoadTask(child))
|
|
}
|
|
}
|
|
}
|
|
return
|
|
}
|
|
} catch (e) {
|
|
logError(e)
|
|
}
|
|
}
|
|
if (swapStyle === 'innerHTML') {
|
|
swapInnerHTML(target, fragment, settleInfo)
|
|
} else {
|
|
swapWithStyle(htmx.config.defaultSwapStyle, elt, target, fragment, settleInfo)
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {DocumentFragment|ParentNode} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
* @param {Element} sourceElement
|
|
* @returns {boolean}
|
|
*/
|
|
function findAndSwapPartials(fragment, settleInfo, sourceElement) {
|
|
var hxTemplates = findAll(fragment, 'template[hx]')
|
|
forEach(hxTemplates, function(template) {
|
|
var type = getRawAttribute(template, 'type')
|
|
if (type === 'partial') {
|
|
var targetSelector = getAttributeValue(template, 'hx-target') ||
|
|
(template.id ? '#' + CSS.escape(template.id) : null)
|
|
if (targetSelector) {
|
|
var swapOverride = getAttributeValue(template, 'hx-swap')
|
|
var swapSpec = getSwapSpecification(template, swapOverride)
|
|
var targets = querySelectorAllExt(sourceElement || getDocument().body, targetSelector, false)
|
|
if (targets.length === 0) {
|
|
triggerErrorEvent(getDocument().body, 'htmx:partialErrorNoTarget', { template, targetSelector, sourceElement })
|
|
}
|
|
forEach(targets, function(target) {
|
|
target = asElement(target)
|
|
if (target) {
|
|
var fragment = template.content.cloneNode(true)
|
|
normalizeScriptTags(fragment)
|
|
var beforeSwapDetails = { shouldSwap: true, target, fragment }
|
|
if (!triggerEvent(target, 'htmx:partialBeforeSwap', beforeSwapDetails)) return
|
|
target = beforeSwapDetails.target
|
|
if (beforeSwapDetails.shouldSwap) {
|
|
swap(target, beforeSwapDetails.fragment, swapSpec, {
|
|
contextElement: target,
|
|
afterSwapCallback: function() {
|
|
forEach(settleInfo.elts, function(elt) {
|
|
triggerEvent(elt, 'htmx:partialAfterSwap', beforeSwapDetails)
|
|
})
|
|
}
|
|
})
|
|
}
|
|
}
|
|
})
|
|
}
|
|
} else {
|
|
triggerEvent(getDocument().body, 'htmx:processTemplate', { type, template, settleInfo, sourceElement })
|
|
}
|
|
template.parentNode.removeChild(template)
|
|
})
|
|
return hxTemplates.length > 0
|
|
}
|
|
|
|
/**
|
|
* @param {DocumentFragment} fragment
|
|
* @param {HtmxSettleInfo} settleInfo
|
|
* @param {Node|Document} [rootNode]
|
|
*/
|
|
function findAndSwapOobElements(fragment, settleInfo, rootNode) {
|
|
var oobElts = findAll(fragment, '[hx-swap-oob], [data-hx-swap-oob]')
|
|
forEach(oobElts, function(oobElement) {
|
|
if (htmx.config.allowNestedOobSwaps || oobElement.parentElement === null) {
|
|
const oobValue = getAttributeValue(oobElement, 'hx-swap-oob')
|
|
if (oobValue != null) {
|
|
oobSwap(oobValue, oobElement, settleInfo, rootNode)
|
|
}
|
|
} else {
|
|
oobElement.removeAttribute('hx-swap-oob')
|
|
oobElement.removeAttribute('data-hx-swap-oob')
|
|
}
|
|
})
|
|
return oobElts.length > 0
|
|
}
|
|
|
|
/**
|
|
* Implements complete swapping pipeline, including: delay, view transitions, focus and selection preservation,
|
|
* title updates, scroll, OOB swapping, normal swapping and settling
|
|
* @param {string|Element} target
|
|
* @param {string} content
|
|
* @param {HtmxSwapSpecification} swapSpec
|
|
* @param {SwapOptions} [swapOptions]
|
|
*/
|
|
function swap(target, content, swapSpec, swapOptions) {
|
|
if (!swapOptions) {
|
|
swapOptions = {}
|
|
}
|
|
// optional transition API promise callbacks
|
|
let settleResolve = null
|
|
let settleReject = null
|
|
|
|
let doSwap = function() {
|
|
maybeCall(swapOptions.beforeSwapCallback)
|
|
|
|
target = resolveTarget(target)
|
|
// A detached contextElement's own getRootNode() is its orphaned subtree, not
|
|
// the document, so OOB targets that are still live in the document would be
|
|
// unreachable through it - fall back to the document in that case.
|
|
const rootNode = (swapOptions.contextElement && swapOptions.contextElement.isConnected)
|
|
? getRootNode(swapOptions.contextElement, false)
|
|
: getDocument()
|
|
|
|
// preserve focus and selection
|
|
const activeElt = document.activeElement
|
|
let selectionInfo = {}
|
|
selectionInfo = {
|
|
elt: activeElt,
|
|
// @ts-ignore
|
|
start: activeElt ? activeElt.selectionStart : null,
|
|
// @ts-ignore
|
|
end: activeElt ? activeElt.selectionEnd : null
|
|
}
|
|
const settleInfo = makeSettleInfo(target)
|
|
|
|
// For text content swaps, don't parse the response as HTML, just insert it
|
|
if (swapSpec.swapStyle === 'textContent') {
|
|
target.textContent = content
|
|
// Otherwise, make the fragment and process it
|
|
} else {
|
|
let fragment = typeof content === 'string' ? makeFragment(content) : content
|
|
|
|
settleInfo.title = swapOptions.title || fragment.title
|
|
if (swapOptions.historyRequest) {
|
|
// @ts-ignore fragment can be a parentNode Element
|
|
fragment = fragment.querySelector('[hx-history-elt],[data-hx-history-elt]') || fragment
|
|
}
|
|
|
|
// select-oob swaps
|
|
if (swapOptions.selectOOB) {
|
|
const oobSelectValues = swapOptions.selectOOB.split(',')
|
|
for (let i = 0; i < oobSelectValues.length; i++) {
|
|
const oobSelectValue = oobSelectValues[i].split(':', 2)
|
|
let id = oobSelectValue[0].trim()
|
|
if (id.indexOf('#') === 0) {
|
|
id = id.substring(1)
|
|
}
|
|
const oobValue = oobSelectValue[1] || 'true'
|
|
const oobElement = fragment.querySelector('#' + id)
|
|
if (oobElement) {
|
|
oobSwap(oobValue, oobElement, settleInfo, rootNode)
|
|
}
|
|
}
|
|
}
|
|
// oob swaps
|
|
findAndSwapOobElements(fragment, settleInfo, rootNode)
|
|
forEach(findAll(fragment, 'template'), /** @param {HTMLTemplateElement} template */function(template) {
|
|
if (template.content && findAndSwapOobElements(template.content, settleInfo, rootNode)) {
|
|
// Avoid polluting the DOM with empty templates that were only used to encapsulate oob swap
|
|
template.remove()
|
|
}
|
|
})
|
|
// partial swaps — after oob, before main swap
|
|
var hasPartials = findAndSwapPartials(fragment, settleInfo, swapOptions.contextElement || asElement(target))
|
|
|
|
// normal swap
|
|
if (swapOptions.select) {
|
|
const newFragment = getDocument().createDocumentFragment()
|
|
forEach(fragment.querySelectorAll(swapOptions.select), function(node) {
|
|
newFragment.appendChild(node)
|
|
})
|
|
fragment = newFragment
|
|
}
|
|
handlePreservedElements(fragment)
|
|
// if the response contained only <hx-partial> tags and nothing else, skip the main swap
|
|
if (hasPartials && !fragment.childElementCount && !fragment.textContent.trim()) {
|
|
settleInfo.elts = [asElement(target)]
|
|
} else {
|
|
swapWithStyle(swapSpec.swapStyle, swapOptions.contextElement, target, fragment, settleInfo)
|
|
}
|
|
restorePreservedElements()
|
|
}
|
|
|
|
// apply saved focus and selection information to swapped content
|
|
if (selectionInfo.elt &&
|
|
!bodyContains(selectionInfo.elt) &&
|
|
getRawAttribute(selectionInfo.elt, 'id')) {
|
|
const newActiveElt = document.getElementById(getRawAttribute(selectionInfo.elt, 'id'))
|
|
const focusOptions = { preventScroll: swapSpec.focusScroll !== undefined ? !swapSpec.focusScroll : !htmx.config.defaultFocusScroll }
|
|
if (newActiveElt) {
|
|
// @ts-ignore
|
|
if (selectionInfo.start && newActiveElt.setSelectionRange) {
|
|
try {
|
|
// @ts-ignore
|
|
newActiveElt.setSelectionRange(selectionInfo.start, selectionInfo.end)
|
|
} catch (e) {
|
|
// the setSelectionRange method is present on fields that don't support it, so just let this fail
|
|
}
|
|
}
|
|
newActiveElt.focus(focusOptions)
|
|
}
|
|
}
|
|
|
|
removeClassFromElement(target, htmx.config.swappingClass)
|
|
forEach(settleInfo.elts, function(elt) {
|
|
if (elt.classList) {
|
|
addClassToElement(elt, htmx.config.settlingClass)
|
|
}
|
|
triggerEvent(elt, 'htmx:afterSwap', swapOptions.eventInfo)
|
|
})
|
|
maybeCall(swapOptions.afterSwapCallback)
|
|
|
|
// merge in new title after swap but before settle
|
|
if (!swapSpec.ignoreTitle) {
|
|
handleTitle(settleInfo.title)
|
|
}
|
|
|
|
// settle
|
|
const doSettle = function() {
|
|
forEach(settleInfo.tasks, function(task) {
|
|
task.call()
|
|
})
|
|
forEach(settleInfo.elts, function(elt) {
|
|
if (elt.classList) {
|
|
removeClassFromElement(elt, htmx.config.settlingClass)
|
|
}
|
|
triggerEvent(elt, 'htmx:afterSettle', swapOptions.eventInfo)
|
|
})
|
|
|
|
if (swapOptions.anchor) {
|
|
const anchorTarget = asElement(resolveTarget('#' + swapOptions.anchor))
|
|
if (anchorTarget) {
|
|
anchorTarget.scrollIntoView({ block: 'start', behavior: 'auto' })
|
|
}
|
|
}
|
|
|
|
updateScrollState(settleInfo.elts, swapSpec)
|
|
maybeCall(swapOptions.afterSettleCallback)
|
|
maybeCall(settleResolve)
|
|
}
|
|
|
|
if (swapSpec.settleDelay > 0) {
|
|
getWindow().setTimeout(doSettle, swapSpec.settleDelay)
|
|
} else {
|
|
doSettle()
|
|
}
|
|
}
|
|
let shouldTransition = htmx.config.globalViewTransitions
|
|
if (swapSpec.hasOwnProperty('transition')) {
|
|
shouldTransition = swapSpec.transition
|
|
}
|
|
|
|
const elt = swapOptions.contextElement || getDocument()
|
|
|
|
if (shouldTransition &&
|
|
triggerEvent(elt, 'htmx:beforeTransition', swapOptions.eventInfo) &&
|
|
typeof Promise !== 'undefined' &&
|
|
// @ts-ignore experimental feature atm
|
|
document.startViewTransition) {
|
|
const settlePromise = new Promise(function(_resolve, _reject) {
|
|
settleResolve = _resolve
|
|
settleReject = _reject
|
|
})
|
|
// wrap the original doSwap() in a call to startViewTransition()
|
|
const innerDoSwap = doSwap
|
|
doSwap = function() {
|
|
// @ts-ignore experimental feature atm
|
|
document.startViewTransition(function() {
|
|
innerDoSwap()
|
|
return settlePromise
|
|
})
|
|
}
|
|
}
|
|
|
|
try {
|
|
if (swapSpec?.swapDelay && swapSpec.swapDelay > 0) {
|
|
getWindow().setTimeout(doSwap, swapSpec.swapDelay)
|
|
} else {
|
|
doSwap()
|
|
}
|
|
} catch (e) {
|
|
triggerErrorEvent(elt, 'htmx:swapError', swapOptions.eventInfo)
|
|
maybeCall(settleReject)
|
|
throw e
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {XMLHttpRequest} xhr
|
|
* @param {string} header
|
|
* @param {EventTarget} elt
|
|
*/
|
|
function handleTriggerHeader(xhr, header, elt) {
|
|
const triggerBody = xhr.getResponseHeader(header)
|
|
if (triggerBody.indexOf('{') === 0) {
|
|
const triggers = parseJSON(triggerBody) || {}
|
|
for (const eventName of Object.keys(triggers)) {
|
|
let detail = triggers[eventName]
|
|
if (isRawObject(detail)) {
|
|
// @ts-ignore
|
|
elt = detail.target !== undefined ? detail.target : elt
|
|
} else {
|
|
detail = { value: detail }
|
|
}
|
|
triggerEvent(elt, eventName, detail)
|
|
}
|
|
} else {
|
|
const eventNames = triggerBody.split(',')
|
|
for (let i = 0; i < eventNames.length; i++) {
|
|
triggerEvent(elt, eventNames[i].trim(), [])
|
|
}
|
|
}
|
|
}
|
|
|
|
const WHITESPACE = /\s/
|
|
const WHITESPACE_OR_COMMA = /[\s,]/
|
|
const SYMBOL_START = /[_$a-zA-Z]/
|
|
const SYMBOL_CONT = /[_$a-zA-Z0-9]/
|
|
const STRINGISH_START = ['"', "'", '/']
|
|
const NOT_WHITESPACE = /[^\s]/
|
|
const COMBINED_SELECTOR_START = /[{(]/
|
|
const COMBINED_SELECTOR_END = /[})]/
|
|
|
|
/**
|
|
* @param {string} str
|
|
* @returns {string[]}
|
|
*/
|
|
function tokenizeString(str) {
|
|
/** @type string[] */
|
|
const tokens = []
|
|
let position = 0
|
|
while (position < str.length) {
|
|
if (SYMBOL_START.exec(str.charAt(position))) {
|
|
var startPosition = position
|
|
while (SYMBOL_CONT.exec(str.charAt(position + 1))) {
|
|
position++
|
|
}
|
|
tokens.push(str.substring(startPosition, position + 1))
|
|
} else if (STRINGISH_START.indexOf(str.charAt(position)) !== -1) {
|
|
const startChar = str.charAt(position)
|
|
var startPosition = position
|
|
position++
|
|
while (position < str.length && str.charAt(position) !== startChar) {
|
|
if (str.charAt(position) === '\\') {
|
|
position++
|
|
}
|
|
position++
|
|
}
|
|
tokens.push(str.substring(startPosition, position + 1))
|
|
} else {
|
|
const symbol = str.charAt(position)
|
|
tokens.push(symbol)
|
|
}
|
|
position++
|
|
}
|
|
return tokens
|
|
}
|
|
|
|
/**
|
|
* @param {string} token
|
|
* @param {string|null} last
|
|
* @param {string} paramName
|
|
* @returns {boolean}
|
|
*/
|
|
function isPossibleRelativeReference(token, last, paramName) {
|
|
return SYMBOL_START.exec(token.charAt(0)) &&
|
|
token !== 'true' &&
|
|
token !== 'false' &&
|
|
token !== 'this' &&
|
|
token !== paramName &&
|
|
last !== '.'
|
|
}
|
|
|
|
/**
|
|
* @param {EventTarget|string} elt
|
|
* @param {string[]} tokens
|
|
* @param {string} paramName
|
|
* @returns {ConditionalFunction|null}
|
|
*/
|
|
function maybeGenerateConditional(elt, tokens, paramName) {
|
|
if (tokens[0] === '[') {
|
|
tokens.shift()
|
|
let bracketCount = 1
|
|
let conditionalSource = ' return (function(' + paramName + '){ return ('
|
|
let last = null
|
|
while (tokens.length > 0) {
|
|
const token = tokens[0]
|
|
// @ts-ignore For some reason tsc doesn't understand the shift call, and thinks we're comparing the same value here, i.e. '[' vs ']'
|
|
if (token === ']') {
|
|
bracketCount--
|
|
if (bracketCount === 0) {
|
|
if (last === null) {
|
|
conditionalSource = conditionalSource + 'true'
|
|
}
|
|
tokens.shift()
|
|
conditionalSource += ')})'
|
|
try {
|
|
const conditionFunction = maybeEval(elt, function() {
|
|
return Function(conditionalSource)()
|
|
},
|
|
function() { return true })
|
|
conditionFunction.source = conditionalSource
|
|
return conditionFunction
|
|
} catch (e) {
|
|
triggerErrorEvent(getDocument().body, 'htmx:syntax:error', { error: e, source: conditionalSource })
|
|
return null
|
|
}
|
|
}
|
|
} else if (token === '[') {
|
|
bracketCount++
|
|
}
|
|
if (isPossibleRelativeReference(token, last, paramName)) {
|
|
conditionalSource += '((' + paramName + '.' + token + ') ? (' + paramName + '.' + token + ') : (window.' + token + '))'
|
|
} else {
|
|
conditionalSource = conditionalSource + token
|
|
}
|
|
last = tokens.shift()
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {string[]} tokens
|
|
* @param {RegExp} match
|
|
* @returns {string}
|
|
*/
|
|
function consumeUntil(tokens, match) {
|
|
let result = ''
|
|
while (tokens.length > 0 && !match.test(tokens[0])) {
|
|
result += tokens.shift()
|
|
}
|
|
return result
|
|
}
|
|
|
|
/**
|
|
* @param {string[]} tokens
|
|
* @returns {string}
|
|
*/
|
|
function consumeCSSSelector(tokens) {
|
|
let result
|
|
if (tokens.length > 0 && COMBINED_SELECTOR_START.test(tokens[0])) {
|
|
tokens.shift()
|
|
result = consumeUntil(tokens, COMBINED_SELECTOR_END).trim()
|
|
tokens.shift()
|
|
} else {
|
|
result = consumeUntil(tokens, WHITESPACE_OR_COMMA)
|
|
}
|
|
return result
|
|
}
|
|
|
|
const INPUT_SELECTOR = 'input, textarea, select'
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {string} explicitTrigger
|
|
* @param {Object} cache for trigger specs
|
|
* @returns {HtmxTriggerSpecification[]}
|
|
*/
|
|
function parseAndCacheTrigger(elt, explicitTrigger, cache) {
|
|
/** @type HtmxTriggerSpecification[] */
|
|
const triggerSpecs = []
|
|
const tokens = tokenizeString(explicitTrigger)
|
|
do {
|
|
consumeUntil(tokens, NOT_WHITESPACE)
|
|
const initialLength = tokens.length
|
|
const trigger = consumeUntil(tokens, /[,\[\s]/)
|
|
if (trigger !== '') {
|
|
if (trigger === 'every') {
|
|
/** @type HtmxTriggerSpecification */
|
|
const every = { trigger: 'every' }
|
|
consumeUntil(tokens, NOT_WHITESPACE)
|
|
every.pollInterval = parseInterval(consumeUntil(tokens, /[,\[\s]/))
|
|
consumeUntil(tokens, NOT_WHITESPACE)
|
|
var eventFilter = maybeGenerateConditional(elt, tokens, 'event')
|
|
if (eventFilter) {
|
|
every.eventFilter = eventFilter
|
|
}
|
|
triggerSpecs.push(every)
|
|
} else {
|
|
/** @type HtmxTriggerSpecification */
|
|
const triggerSpec = { trigger }
|
|
var eventFilter = maybeGenerateConditional(elt, tokens, 'event')
|
|
if (eventFilter) {
|
|
triggerSpec.eventFilter = eventFilter
|
|
}
|
|
consumeUntil(tokens, NOT_WHITESPACE)
|
|
while (tokens.length > 0 && tokens[0] !== ',') {
|
|
const token = tokens.shift()
|
|
if (token === 'changed') {
|
|
triggerSpec.changed = true
|
|
} else if (token === 'once') {
|
|
triggerSpec.once = true
|
|
} else if (token === 'consume') {
|
|
triggerSpec.consume = true
|
|
} else if (token === 'delay' && tokens[0] === ':') {
|
|
tokens.shift()
|
|
triggerSpec.delay = parseInterval(consumeUntil(tokens, WHITESPACE_OR_COMMA))
|
|
} else if (token === 'from' && tokens[0] === ':') {
|
|
tokens.shift()
|
|
if (COMBINED_SELECTOR_START.test(tokens[0])) {
|
|
var from_arg = consumeCSSSelector(tokens)
|
|
} else {
|
|
var from_arg = consumeUntil(tokens, WHITESPACE_OR_COMMA)
|
|
if (from_arg === 'closest' || from_arg === 'find' || from_arg === 'next' || from_arg === 'previous') {
|
|
tokens.shift()
|
|
const selector = consumeCSSSelector(tokens)
|
|
// `next` and `previous` allow a selector-less syntax
|
|
if (selector.length > 0) {
|
|
from_arg += ' ' + selector
|
|
}
|
|
}
|
|
}
|
|
triggerSpec.from = from_arg
|
|
} else if (token === 'target' && tokens[0] === ':') {
|
|
tokens.shift()
|
|
triggerSpec.target = consumeCSSSelector(tokens)
|
|
} else if (token === 'throttle' && tokens[0] === ':') {
|
|
tokens.shift()
|
|
triggerSpec.throttle = parseInterval(consumeUntil(tokens, WHITESPACE_OR_COMMA))
|
|
} else if (token === 'queue' && tokens[0] === ':') {
|
|
tokens.shift()
|
|
triggerSpec.queue = consumeUntil(tokens, WHITESPACE_OR_COMMA)
|
|
} else if (token === 'root' && tokens[0] === ':') {
|
|
tokens.shift()
|
|
triggerSpec[token] = consumeCSSSelector(tokens)
|
|
} else if (token === 'threshold' && tokens[0] === ':') {
|
|
tokens.shift()
|
|
triggerSpec[token] = consumeUntil(tokens, WHITESPACE_OR_COMMA)
|
|
} else {
|
|
triggerErrorEvent(elt, 'htmx:syntax:error', { token: tokens.shift() })
|
|
}
|
|
consumeUntil(tokens, NOT_WHITESPACE)
|
|
}
|
|
triggerSpecs.push(triggerSpec)
|
|
}
|
|
}
|
|
if (tokens.length === initialLength) {
|
|
triggerErrorEvent(elt, 'htmx:syntax:error', { token: tokens.shift() })
|
|
}
|
|
consumeUntil(tokens, NOT_WHITESPACE)
|
|
} while (tokens[0] === ',' && tokens.shift())
|
|
if (cache) {
|
|
cache[explicitTrigger] = triggerSpecs
|
|
}
|
|
return triggerSpecs
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @returns {HtmxTriggerSpecification[]}
|
|
*/
|
|
function getTriggerSpecs(elt) {
|
|
const explicitTrigger = getAttributeValue(elt, 'hx-trigger')
|
|
let triggerSpecs = []
|
|
if (explicitTrigger) {
|
|
const cache = htmx.config.triggerSpecsCache
|
|
triggerSpecs = (cache && cache[explicitTrigger]) || parseAndCacheTrigger(elt, explicitTrigger, cache)
|
|
}
|
|
|
|
if (triggerSpecs.length > 0) {
|
|
return triggerSpecs
|
|
} else if (matches(elt, 'form')) {
|
|
return [{ trigger: 'submit' }]
|
|
} else if (matches(elt, 'input[type="button"], input[type="submit"]')) {
|
|
return [{ trigger: 'click' }]
|
|
} else if (matches(elt, INPUT_SELECTOR)) {
|
|
return [{ trigger: 'change' }]
|
|
} else {
|
|
return [{ trigger: 'click' }]
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
*/
|
|
function cancelPolling(elt) {
|
|
getInternalData(elt).cancelled = true
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {TriggerHandler} handler
|
|
* @param {HtmxTriggerSpecification} spec
|
|
*/
|
|
function processPolling(elt, handler, spec) {
|
|
const nodeData = getInternalData(elt)
|
|
nodeData.timeout = getWindow().setTimeout(function() {
|
|
if (bodyContains(elt) && nodeData.cancelled !== true) {
|
|
if (!maybeFilterEvent(spec, elt, makeEvent('hx:poll:trigger', {
|
|
triggerSpec: spec,
|
|
target: elt
|
|
}))) {
|
|
handler(elt)
|
|
}
|
|
processPolling(elt, handler, spec)
|
|
}
|
|
}, spec.pollInterval)
|
|
}
|
|
|
|
/**
|
|
* @param {HTMLAnchorElement} elt
|
|
* @returns {boolean}
|
|
*/
|
|
function isLocalLink(elt) {
|
|
return location.hostname === elt.hostname &&
|
|
getRawAttribute(elt, 'href') &&
|
|
getRawAttribute(elt, 'href').indexOf('#') !== 0
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
*/
|
|
function eltIsDisabled(elt) {
|
|
return closest(elt, htmx.config.disableSelector)
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {HtmxNodeInternalData} nodeData
|
|
* @param {HtmxTriggerSpecification[]} triggerSpecs
|
|
*/
|
|
function boostElement(elt, nodeData, triggerSpecs) {
|
|
if ((elt instanceof HTMLAnchorElement && isLocalLink(elt) && (elt.target === '' || elt.target === '_self')) || (elt.tagName === 'FORM' && String(getRawAttribute(elt, 'method')).toLowerCase() !== 'dialog')) {
|
|
nodeData.boosted = true
|
|
let verb, path
|
|
if (elt.tagName === 'A') {
|
|
verb = (/** @type HttpVerb */('get'))
|
|
path = getRawAttribute(elt, 'href')
|
|
} else {
|
|
const rawAttribute = getRawAttribute(elt, 'method')
|
|
verb = (/** @type HttpVerb */(rawAttribute ? rawAttribute.toLowerCase() : 'get'))
|
|
path = getRawAttribute(elt, 'action')
|
|
if (path == null || path === '') {
|
|
// if there is no action attribute on the form set path to current href before the
|
|
// following logic to properly clear parameters on a GET (not on a POST!)
|
|
path = location.href
|
|
}
|
|
if (verb === 'get' && path.includes('?')) {
|
|
path = path.replace(/\?[^#]+/, '')
|
|
}
|
|
}
|
|
triggerSpecs.forEach(function(triggerSpec) {
|
|
addEventListener(elt, function(node, evt) {
|
|
const elt = asElement(node)
|
|
if (eltIsDisabled(elt)) {
|
|
cleanUpElement(elt)
|
|
return
|
|
}
|
|
issueAjaxRequest(verb, path, elt, evt)
|
|
}, nodeData, triggerSpec, true)
|
|
})
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Event} evt
|
|
* @param {Element} elt
|
|
* @returns {boolean}
|
|
*/
|
|
function shouldCancel(evt, elt) {
|
|
if (evt.type === 'submit' && elt.tagName === 'FORM') {
|
|
return true
|
|
} else if (evt.type === 'click') {
|
|
// find button wrapping the trigger element
|
|
const btn = /** @type {HTMLButtonElement|HTMLInputElement|null} */ (elt.closest('input[type="submit"], button'))
|
|
// Do not cancel on buttons that 1) don't have a related form or 2) have a type attribute of 'reset'/'button'.
|
|
if (btn && btn.form && btn.type === 'submit') {
|
|
return true
|
|
}
|
|
|
|
// find link wrapping the trigger element
|
|
const link = elt.closest('a')
|
|
// Allow links with href="#fragment" (anchors with content after #) to perform normal fragment navigation.
|
|
// Cancel default action for links with href="#" (bare hash) to prevent scrolling to top and unwanted URL changes.
|
|
const samePageAnchor = /^#.+/
|
|
if (link && link.href && !samePageAnchor.test(link.getAttribute('href'))) {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
/**
|
|
* @param {Node} elt
|
|
* @param {Event|MouseEvent|KeyboardEvent|TouchEvent} evt
|
|
* @returns {boolean}
|
|
*/
|
|
function ignoreBoostedAnchorCtrlClick(elt, evt) {
|
|
return getInternalData(elt).boosted && elt instanceof HTMLAnchorElement && evt.type === 'click' &&
|
|
// @ts-ignore this will resolve to undefined for events that don't define those properties, which is fine
|
|
(evt.ctrlKey || evt.metaKey)
|
|
}
|
|
|
|
/**
|
|
* @param {HtmxTriggerSpecification} triggerSpec
|
|
* @param {Node} elt
|
|
* @param {Event} evt
|
|
* @returns {boolean}
|
|
*/
|
|
function maybeFilterEvent(triggerSpec, elt, evt) {
|
|
const eventFilter = triggerSpec.eventFilter
|
|
if (eventFilter) {
|
|
try {
|
|
return eventFilter.call(elt, evt) !== true
|
|
} catch (e) {
|
|
const source = eventFilter.source
|
|
triggerErrorEvent(getDocument().body, 'htmx:eventFilter:error', { error: e, source })
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {TriggerHandler} handler
|
|
* @param {HtmxNodeInternalData} nodeData
|
|
* @param {HtmxTriggerSpecification} triggerSpec
|
|
* @param {boolean} [explicitCancel]
|
|
*/
|
|
function addEventListener(elt, handler, nodeData, triggerSpec, explicitCancel) {
|
|
const elementData = getInternalData(elt)
|
|
/** @type {(Node|Window)[]} */
|
|
let eltsToListenOn
|
|
if (triggerSpec.from) {
|
|
eltsToListenOn = querySelectorAllExt(elt, triggerSpec.from)
|
|
} else {
|
|
eltsToListenOn = [elt]
|
|
}
|
|
// store the initial values of the elements, so we can tell if they change
|
|
if (triggerSpec.changed) {
|
|
if (!('lastValue' in elementData)) {
|
|
elementData.lastValue = new WeakMap()
|
|
}
|
|
eltsToListenOn.forEach(function(eltToListenOn) {
|
|
if (!elementData.lastValue.has(triggerSpec)) {
|
|
elementData.lastValue.set(triggerSpec, new WeakMap())
|
|
}
|
|
// @ts-ignore value will be undefined for non-input elements, which is fine
|
|
elementData.lastValue.get(triggerSpec).set(eltToListenOn, eltToListenOn.value)
|
|
})
|
|
}
|
|
forEach(eltsToListenOn, function(eltToListenOn) {
|
|
/** @type EventListener */
|
|
const eventListener = function(evt) {
|
|
if (!bodyContains(elt)) {
|
|
eltToListenOn.removeEventListener(triggerSpec.trigger, eventListener)
|
|
return
|
|
}
|
|
if (ignoreBoostedAnchorCtrlClick(elt, evt)) {
|
|
return
|
|
}
|
|
if (explicitCancel || shouldCancel(evt, eltToListenOn)) {
|
|
evt.preventDefault()
|
|
}
|
|
if (maybeFilterEvent(triggerSpec, elt, evt)) {
|
|
return
|
|
}
|
|
const eventData = getInternalData(evt)
|
|
eventData.triggerSpec = triggerSpec
|
|
if (eventData.handledFor == null) {
|
|
eventData.handledFor = []
|
|
}
|
|
if (eventData.handledFor.indexOf(elt) < 0) {
|
|
eventData.handledFor.push(elt)
|
|
if (triggerSpec.consume) {
|
|
evt.stopPropagation()
|
|
}
|
|
if (triggerSpec.target && evt.target) {
|
|
if (!matches(asElement(evt.target), triggerSpec.target)) {
|
|
return
|
|
}
|
|
}
|
|
if (triggerSpec.once) {
|
|
if (elementData.triggeredOnce) {
|
|
return
|
|
} else {
|
|
elementData.triggeredOnce = true
|
|
}
|
|
}
|
|
if (triggerSpec.changed) {
|
|
const node = evt.target
|
|
// @ts-ignore value will be undefined for non-input elements, which is fine
|
|
const value = node.value
|
|
const lastValue = elementData.lastValue.get(triggerSpec)
|
|
if (lastValue.has(node) && lastValue.get(node) === value) {
|
|
return
|
|
}
|
|
lastValue.set(node, value)
|
|
}
|
|
if (elementData.delayed) {
|
|
clearTimeout(elementData.delayed)
|
|
}
|
|
if (elementData.throttle) {
|
|
return
|
|
}
|
|
|
|
if (triggerSpec.throttle > 0) {
|
|
if (!elementData.throttle) {
|
|
triggerEvent(elt, 'htmx:trigger')
|
|
handler(elt, evt)
|
|
elementData.throttle = getWindow().setTimeout(function() {
|
|
elementData.throttle = null
|
|
}, triggerSpec.throttle)
|
|
}
|
|
} else if (triggerSpec.delay > 0) {
|
|
elementData.delayed = getWindow().setTimeout(function() {
|
|
triggerEvent(elt, 'htmx:trigger')
|
|
handler(elt, evt)
|
|
}, triggerSpec.delay)
|
|
} else {
|
|
triggerEvent(elt, 'htmx:trigger')
|
|
handler(elt, evt)
|
|
}
|
|
}
|
|
}
|
|
if (nodeData.listenerInfos == null) {
|
|
nodeData.listenerInfos = []
|
|
}
|
|
nodeData.listenerInfos.push({
|
|
trigger: triggerSpec.trigger,
|
|
listener: eventListener,
|
|
on: eltToListenOn
|
|
})
|
|
eltToListenOn.addEventListener(triggerSpec.trigger, eventListener)
|
|
})
|
|
}
|
|
|
|
let windowIsScrolling = false // used by initScrollHandler
|
|
let scrollHandler = null
|
|
function initScrollHandler() {
|
|
if (!scrollHandler) {
|
|
scrollHandler = function() {
|
|
windowIsScrolling = true
|
|
}
|
|
window.addEventListener('scroll', scrollHandler)
|
|
window.addEventListener('resize', scrollHandler)
|
|
setInterval(function() {
|
|
if (windowIsScrolling) {
|
|
windowIsScrolling = false
|
|
forEach(getDocument().querySelectorAll("[hx-trigger*='revealed'],[data-hx-trigger*='revealed']"), function(elt) {
|
|
maybeReveal(elt)
|
|
})
|
|
}
|
|
}, 200)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
*/
|
|
function maybeReveal(elt) {
|
|
if (!hasAttribute(elt, 'data-hx-revealed') && isScrolledIntoView(elt)) {
|
|
elt.setAttribute('data-hx-revealed', 'true')
|
|
const nodeData = getInternalData(elt)
|
|
if (nodeData.initHash) {
|
|
triggerEvent(elt, 'revealed')
|
|
} else {
|
|
// if the node isn't initialized, wait for it before triggering the request
|
|
elt.addEventListener('htmx:afterProcessNode', function() { triggerEvent(elt, 'revealed') }, { once: true })
|
|
}
|
|
}
|
|
}
|
|
|
|
//= ===================================================================
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {TriggerHandler} handler
|
|
* @param {HtmxNodeInternalData} nodeData
|
|
* @param {number} delay
|
|
*/
|
|
function loadImmediately(elt, handler, nodeData, delay) {
|
|
const load = function() {
|
|
if (!nodeData.loaded) {
|
|
nodeData.loaded = true
|
|
triggerEvent(elt, 'htmx:trigger')
|
|
handler(elt)
|
|
}
|
|
}
|
|
if (delay > 0) {
|
|
getWindow().setTimeout(load, delay)
|
|
} else {
|
|
load()
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {HtmxNodeInternalData} nodeData
|
|
* @param {HtmxTriggerSpecification[]} triggerSpecs
|
|
* @returns {boolean}
|
|
*/
|
|
function processVerbs(elt, nodeData, triggerSpecs) {
|
|
let explicitAction = false
|
|
forEach(VERBS, function(verb) {
|
|
if (hasAttribute(elt, 'hx-' + verb)) {
|
|
const path = getAttributeValue(elt, 'hx-' + verb)
|
|
explicitAction = true
|
|
nodeData.path = path
|
|
nodeData.verb = verb
|
|
triggerSpecs.forEach(function(triggerSpec) {
|
|
addTriggerHandler(elt, triggerSpec, nodeData, function(node, evt) {
|
|
const elt = asElement(node)
|
|
if (eltIsDisabled(elt)) {
|
|
cleanUpElement(elt)
|
|
return
|
|
}
|
|
issueAjaxRequest(verb, path, elt, evt)
|
|
})
|
|
})
|
|
}
|
|
})
|
|
return explicitAction
|
|
}
|
|
|
|
/**
|
|
* @callback TriggerHandler
|
|
* @param {Element} elt
|
|
* @param {Event} [evt]
|
|
*/
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {HtmxTriggerSpecification} triggerSpec
|
|
* @param {HtmxNodeInternalData} nodeData
|
|
* @param {TriggerHandler} handler
|
|
*/
|
|
function addTriggerHandler(elt, triggerSpec, nodeData, handler) {
|
|
if (triggerSpec.trigger === 'revealed') {
|
|
initScrollHandler()
|
|
addEventListener(elt, handler, nodeData, triggerSpec)
|
|
maybeReveal(asElement(elt))
|
|
} else if (triggerSpec.trigger === 'intersect') {
|
|
const observerOptions = {}
|
|
if (triggerSpec.root) {
|
|
observerOptions.root = querySelectorExt(elt, triggerSpec.root)
|
|
}
|
|
if (triggerSpec.threshold) {
|
|
observerOptions.threshold = parseFloat(triggerSpec.threshold)
|
|
}
|
|
const observer = new IntersectionObserver(function(entries) {
|
|
for (let i = 0; i < entries.length; i++) {
|
|
const entry = entries[i]
|
|
if (entry.isIntersecting) {
|
|
triggerEvent(elt, 'intersect')
|
|
break
|
|
}
|
|
}
|
|
}, observerOptions)
|
|
observer.observe(asElement(elt))
|
|
addEventListener(asElement(elt), handler, nodeData, triggerSpec)
|
|
} else if (!nodeData.firstInitCompleted && triggerSpec.trigger === 'load') {
|
|
if (!maybeFilterEvent(triggerSpec, elt, makeEvent('load', { elt }))) {
|
|
loadImmediately(asElement(elt), handler, nodeData, triggerSpec.delay)
|
|
}
|
|
} else if (triggerSpec.pollInterval > 0) {
|
|
nodeData.polling = true
|
|
processPolling(asElement(elt), handler, triggerSpec)
|
|
} else {
|
|
addEventListener(elt, handler, nodeData, triggerSpec)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Node} node
|
|
* @returns {boolean}
|
|
*/
|
|
function shouldProcessHxOn(node) {
|
|
const elt = asElement(node)
|
|
if (!elt) {
|
|
return false
|
|
}
|
|
const attributes = elt.attributes
|
|
for (let j = 0; j < attributes.length; j++) {
|
|
const attrName = attributes[j].name
|
|
if (startsWith(attrName, 'hx-on:') || startsWith(attrName, 'data-hx-on:') ||
|
|
startsWith(attrName, 'hx-on-') || startsWith(attrName, 'data-hx-on-')) {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
/**
|
|
* @param {Node} elt
|
|
* @returns {Element[]}
|
|
*/
|
|
const HX_ON_QUERY = new XPathEvaluator()
|
|
.createExpression('.//*[@*[ starts-with(name(), "hx-on:") or starts-with(name(), "data-hx-on:") or' +
|
|
' starts-with(name(), "hx-on-") or starts-with(name(), "data-hx-on-") ]]')
|
|
|
|
function processHXOnRoot(elt, elements) {
|
|
if (shouldProcessHxOn(elt)) {
|
|
elements.push(asElement(elt))
|
|
}
|
|
const iter = HX_ON_QUERY.evaluate(elt)
|
|
let node = null
|
|
while (node = iter.iterateNext()) elements.push(asElement(node))
|
|
}
|
|
|
|
function findHxOnWildcardElements(elt) {
|
|
/** @type {Element[]} */
|
|
const elements = []
|
|
if (elt instanceof DocumentFragment) {
|
|
for (const child of elt.childNodes) {
|
|
processHXOnRoot(child, elements)
|
|
}
|
|
} else {
|
|
processHXOnRoot(elt, elements)
|
|
}
|
|
return elements
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @returns {NodeListOf<Element>|[]}
|
|
*/
|
|
function findElementsToProcess(elt) {
|
|
if (elt.querySelectorAll) {
|
|
const boostedSelector = ', [hx-boost] a, [data-hx-boost] a, a[hx-boost], a[data-hx-boost]'
|
|
|
|
const extensionSelectors = []
|
|
for (const e of Object.keys(extensions)) {
|
|
const extension = extensions[e]
|
|
if (extension.getSelectors) {
|
|
var selectors = extension.getSelectors()
|
|
if (selectors) {
|
|
extensionSelectors.push(selectors)
|
|
}
|
|
}
|
|
}
|
|
|
|
const results = elt.querySelectorAll(VERB_SELECTOR + boostedSelector + ", form, [type='submit']," +
|
|
' [hx-ext], [data-hx-ext], [hx-trigger], [data-hx-trigger]' + extensionSelectors.flat().map(s => ', ' + s).join(''))
|
|
|
|
return results
|
|
} else {
|
|
return []
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handle submit buttons/inputs that have the form attribute set
|
|
* see https://developer.mozilla.org/docs/Web/HTML/Element/button
|
|
* @param {Event} evt
|
|
*/
|
|
function maybeSetLastButtonClicked(evt) {
|
|
const elt = getTargetButton(evt.target)
|
|
const internalData = getRelatedFormData(evt)
|
|
if (internalData) {
|
|
internalData.lastButtonClicked = elt
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Event} evt
|
|
*/
|
|
function maybeUnsetLastButtonClicked(evt) {
|
|
const internalData = getRelatedFormData(evt)
|
|
if (internalData) {
|
|
internalData.lastButtonClicked = null
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {EventTarget} target
|
|
* @returns {HTMLButtonElement|HTMLInputElement|null}
|
|
*/
|
|
function getTargetButton(target) {
|
|
return /** @type {HTMLButtonElement|HTMLInputElement|null} */ (closest(asElement(target), "button, input[type='submit']"))
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @returns {HTMLFormElement|null}
|
|
*/
|
|
function getRelatedForm(elt) {
|
|
// @ts-ignore Get the related form if available, else find the closest parent form
|
|
return elt.form || closest(elt, 'form')
|
|
}
|
|
|
|
/**
|
|
* @param {Event} evt
|
|
* @returns {HtmxNodeInternalData|undefined}
|
|
*/
|
|
function getRelatedFormData(evt) {
|
|
const elt = getTargetButton(evt.target)
|
|
if (!elt) {
|
|
return
|
|
}
|
|
const form = getRelatedForm(elt)
|
|
if (!form) {
|
|
return
|
|
}
|
|
return getInternalData(form)
|
|
}
|
|
|
|
/**
|
|
* @param {EventTarget} elt
|
|
*/
|
|
function initButtonTracking(elt) {
|
|
// need to handle both click and focus in:
|
|
// focusin - in case someone tabs in to a button and hits the space bar
|
|
// click - on OSX buttons do not focus on click see https://bugs.webkit.org/show_bug.cgi?id=13724
|
|
elt.addEventListener('click', maybeSetLastButtonClicked)
|
|
elt.addEventListener('focusin', maybeSetLastButtonClicked)
|
|
elt.addEventListener('focusout', maybeUnsetLastButtonClicked)
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {string} eventName
|
|
* @param {string} code
|
|
*/
|
|
function addHxOnEventHandler(elt, eventName, code) {
|
|
const nodeData = getInternalData(elt)
|
|
if (!Array.isArray(nodeData.onHandlers)) {
|
|
nodeData.onHandlers = []
|
|
}
|
|
let func
|
|
/** @type EventListener */
|
|
const listener = function(e) {
|
|
maybeEval(elt, function() {
|
|
if (eltIsDisabled(elt)) {
|
|
return
|
|
}
|
|
if (!func) {
|
|
func = new Function('event', code)
|
|
}
|
|
func.call(elt, e)
|
|
})
|
|
}
|
|
elt.addEventListener(eventName, listener)
|
|
nodeData.onHandlers.push({ event: eventName, listener })
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
*/
|
|
function processHxOnWildcard(elt) {
|
|
// wipe any previous on handlers so that this function takes precedence
|
|
deInitOnHandlers(elt)
|
|
|
|
for (let i = 0; i < elt.attributes.length; i++) {
|
|
const name = elt.attributes[i].name
|
|
const value = elt.attributes[i].value
|
|
if (startsWith(name, 'hx-on') || startsWith(name, 'data-hx-on')) {
|
|
const afterOnPosition = name.indexOf('-on') + 3
|
|
const nextChar = name.slice(afterOnPosition, afterOnPosition + 1)
|
|
if (nextChar === '-' || nextChar === ':') {
|
|
let eventName = name.slice(afterOnPosition + 1)
|
|
// if the eventName starts with a colon or dash, prepend "htmx" for shorthand support
|
|
if (startsWith(eventName, ':')) {
|
|
eventName = 'htmx' + eventName
|
|
} else if (startsWith(eventName, '-')) {
|
|
eventName = 'htmx:' + eventName.slice(1)
|
|
} else if (startsWith(eventName, 'htmx-')) {
|
|
eventName = 'htmx:' + eventName.slice(5)
|
|
}
|
|
|
|
addHxOnEventHandler(elt, eventName, value)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element|HTMLInputElement} elt
|
|
*/
|
|
function initNode(elt) {
|
|
triggerEvent(elt, 'htmx:beforeProcessNode')
|
|
|
|
const nodeData = getInternalData(elt)
|
|
const triggerSpecs = getTriggerSpecs(elt)
|
|
const hasExplicitHttpAction = processVerbs(elt, nodeData, triggerSpecs)
|
|
|
|
if (!hasExplicitHttpAction) {
|
|
if (getClosestAttributeValue(elt, 'hx-boost') === 'true') {
|
|
boostElement(elt, nodeData, triggerSpecs)
|
|
} else if (hasAttribute(elt, 'hx-trigger')) {
|
|
triggerSpecs.forEach(function(triggerSpec) {
|
|
// For "naked" triggers, don't do anything at all
|
|
addTriggerHandler(elt, triggerSpec, nodeData, function() {
|
|
})
|
|
})
|
|
}
|
|
}
|
|
|
|
// Handle submit buttons/inputs that have the form attribute set
|
|
// see https://developer.mozilla.org/docs/Web/HTML/Element/button
|
|
if (elt.tagName === 'FORM' || (getRawAttribute(elt, 'type') === 'submit' && hasAttribute(elt, 'form'))) {
|
|
initButtonTracking(elt)
|
|
}
|
|
|
|
nodeData.firstInitCompleted = true
|
|
triggerEvent(elt, 'htmx:afterProcessNode')
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @returns {boolean}
|
|
*/
|
|
function maybeDeInitAndHash(elt) {
|
|
// Ensure only valid Elements and not shadow DOM roots are inited
|
|
if (!(elt instanceof Element)) {
|
|
return false
|
|
}
|
|
|
|
const nodeData = getInternalData(elt)
|
|
const hash = attributeHash(elt)
|
|
if (nodeData.initHash !== hash) {
|
|
deInitNode(elt)
|
|
nodeData.initHash = hash
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
/**
|
|
* Processes new content, enabling htmx behavior. This can be useful if you have content that is added to the DOM outside of the normal htmx request cycle but still want htmx attributes to work.
|
|
*
|
|
* @see https://htmx.org/api/#process
|
|
*
|
|
* @param {Element|string} elt element to process
|
|
*/
|
|
function processNode(elt) {
|
|
elt = resolveTarget(elt)
|
|
if (eltIsDisabled(elt)) {
|
|
cleanUpElement(elt)
|
|
return
|
|
}
|
|
|
|
const elementsToInit = []
|
|
if (maybeDeInitAndHash(elt)) {
|
|
elementsToInit.push(elt)
|
|
}
|
|
forEach(findElementsToProcess(elt), function(child) {
|
|
if (eltIsDisabled(child)) {
|
|
cleanUpElement(child)
|
|
return
|
|
}
|
|
if (maybeDeInitAndHash(child)) {
|
|
elementsToInit.push(child)
|
|
}
|
|
})
|
|
|
|
forEach(findHxOnWildcardElements(elt), processHxOnWildcard)
|
|
forEach(elementsToInit, initNode)
|
|
}
|
|
|
|
//= ===================================================================
|
|
// Event/Log Support
|
|
//= ===================================================================
|
|
|
|
/**
|
|
* @param {string} str
|
|
* @returns {string}
|
|
*/
|
|
function kebabEventName(str) {
|
|
return str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase()
|
|
}
|
|
|
|
/**
|
|
* @param {string} eventName
|
|
* @param {any} detail
|
|
* @returns {CustomEvent}
|
|
*/
|
|
function makeEvent(eventName, detail) {
|
|
// TODO: `composed: true` here is a hack to make global event handlers work with events in shadow DOM
|
|
// This breaks expected encapsulation but needs to be here until decided otherwise by core devs
|
|
return new CustomEvent(eventName, { bubbles: true, cancelable: true, composed: true, detail })
|
|
}
|
|
|
|
/**
|
|
* @param {EventTarget|string} elt
|
|
* @param {string} eventName
|
|
* @param {any=} detail
|
|
*/
|
|
function triggerErrorEvent(elt, eventName, detail) {
|
|
triggerEvent(elt, eventName, mergeObjects({ error: eventName }, detail))
|
|
}
|
|
|
|
/**
|
|
* @param {string} eventName
|
|
* @returns {boolean}
|
|
*/
|
|
function ignoreEventForLogging(eventName) {
|
|
return eventName === 'htmx:afterProcessNode'
|
|
}
|
|
|
|
/**
|
|
* `withExtensions` locates all active extensions for a provided element, then
|
|
* executes the provided function using each of the active extensions. You can filter
|
|
* the element's extensions by giving it a list of extensions to ignore. It should
|
|
* be called internally at every extendable execution point in htmx.
|
|
*
|
|
* @param {Element} elt
|
|
* @param {(extension:HtmxExtension) => void} toDo
|
|
* @param {string[]=} extensionsToIgnore
|
|
* @returns void
|
|
*/
|
|
function withExtensions(elt, toDo, extensionsToIgnore) {
|
|
forEach(getExtensions(elt, [], extensionsToIgnore), function(extension) {
|
|
try {
|
|
toDo(extension)
|
|
} catch (e) {
|
|
logError(e)
|
|
}
|
|
})
|
|
}
|
|
|
|
function logError(msg) {
|
|
console.error(msg)
|
|
}
|
|
|
|
/**
|
|
* Triggers a given event on an element
|
|
*
|
|
* @see https://htmx.org/api/#trigger
|
|
*
|
|
* @param {EventTarget|string} elt the element to trigger the event on
|
|
* @param {string} eventName the name of the event to trigger
|
|
* @param {any=} detail details for the event
|
|
* @returns {boolean}
|
|
*/
|
|
function triggerEvent(elt, eventName, detail) {
|
|
elt = resolveTarget(elt)
|
|
if (detail == null) {
|
|
detail = {}
|
|
}
|
|
detail.elt = elt
|
|
const event = makeEvent(eventName, detail)
|
|
if (htmx.logger && !ignoreEventForLogging(eventName)) {
|
|
htmx.logger(elt, eventName, detail)
|
|
}
|
|
if (detail.error) {
|
|
logError(detail.error + (detail.target ? ', ' + detail.target : ''))
|
|
triggerEvent(elt, 'htmx:error', { errorInfo: detail })
|
|
}
|
|
let eventResult = elt.dispatchEvent(event)
|
|
const kebabName = kebabEventName(eventName)
|
|
if (eventResult && kebabName !== eventName) {
|
|
const kebabedEvent = makeEvent(kebabName, event.detail)
|
|
eventResult = eventResult && elt.dispatchEvent(kebabedEvent)
|
|
}
|
|
withExtensions(asElement(elt), function(extension) {
|
|
eventResult = eventResult && (extension.onEvent(eventName, event) !== false && !event.defaultPrevented)
|
|
})
|
|
return eventResult
|
|
}
|
|
|
|
//= ===================================================================
|
|
// History Support
|
|
//= ===================================================================
|
|
let currentPathForHistory
|
|
|
|
/**
|
|
* @param {string} path
|
|
*/
|
|
function setCurrentPathForHistory(path) {
|
|
currentPathForHistory = path
|
|
if (canAccessLocalStorage()) {
|
|
sessionStorage.setItem('htmx-current-path-for-history', path)
|
|
}
|
|
}
|
|
|
|
setCurrentPathForHistory(location.pathname + location.search)
|
|
|
|
/**
|
|
* @returns {Element}
|
|
*/
|
|
function getHistoryElement() {
|
|
const historyElt = getDocument().querySelector('[hx-history-elt],[data-hx-history-elt]')
|
|
return historyElt || getDocument().body
|
|
}
|
|
|
|
/**
|
|
* @param {string} url
|
|
* @param {Element} rootElt
|
|
*/
|
|
function saveToHistoryCache(url, rootElt) {
|
|
if (!canAccessLocalStorage()) {
|
|
return
|
|
}
|
|
|
|
// get state to save
|
|
const innerHTML = cleanInnerHtmlForHistory(rootElt)
|
|
const title = getDocument().title
|
|
const scroll = window.scrollY
|
|
|
|
if (htmx.config.historyCacheSize <= 0) {
|
|
// make sure that an eventually already existing cache is purged
|
|
sessionStorage.removeItem('htmx-history-cache')
|
|
return
|
|
}
|
|
|
|
url = normalizePath(url)
|
|
|
|
const historyCache = parseJSON(sessionStorage.getItem('htmx-history-cache')) || []
|
|
for (let i = 0; i < historyCache.length; i++) {
|
|
if (historyCache[i].url === url) {
|
|
historyCache.splice(i, 1)
|
|
break
|
|
}
|
|
}
|
|
|
|
/** @type HtmxHistoryItem */
|
|
const newHistoryItem = { url, content: innerHTML, title, scroll }
|
|
|
|
triggerEvent(getDocument().body, 'htmx:historyItemCreated', { item: newHistoryItem, cache: historyCache })
|
|
|
|
historyCache.push(newHistoryItem)
|
|
while (historyCache.length > htmx.config.historyCacheSize) {
|
|
historyCache.shift()
|
|
}
|
|
|
|
// keep trying to save the cache until it succeeds or is empty
|
|
while (historyCache.length > 0) {
|
|
try {
|
|
sessionStorage.setItem('htmx-history-cache', JSON.stringify(historyCache))
|
|
break
|
|
} catch (e) {
|
|
triggerErrorEvent(getDocument().body, 'htmx:historyCacheError', { cause: e, cache: historyCache })
|
|
historyCache.shift() // shrink the cache and retry
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @typedef {Object} HtmxHistoryItem
|
|
* @property {string} url
|
|
* @property {string} content
|
|
* @property {string} title
|
|
* @property {number} scroll
|
|
*/
|
|
|
|
/**
|
|
* @param {string} url
|
|
* @returns {HtmxHistoryItem|null}
|
|
*/
|
|
function getCachedHistory(url) {
|
|
if (!canAccessLocalStorage()) {
|
|
return null
|
|
}
|
|
|
|
url = normalizePath(url)
|
|
|
|
const historyCache = parseJSON(sessionStorage.getItem('htmx-history-cache')) || []
|
|
for (let i = 0; i < historyCache.length; i++) {
|
|
if (historyCache[i].url === url) {
|
|
return historyCache[i]
|
|
}
|
|
}
|
|
return null
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @returns {string}
|
|
*/
|
|
function cleanInnerHtmlForHistory(elt) {
|
|
const className = htmx.config.requestClass
|
|
const clone = /** @type Element */ (elt.cloneNode(true))
|
|
forEach(findAll(clone, '.' + className), function(child) {
|
|
removeClassFromElement(child, className)
|
|
})
|
|
// remove the disabled attribute for any element disabled due to an htmx request
|
|
forEach(findAll(clone, '[data-disabled-by-htmx]'), function(child) {
|
|
child.removeAttribute('disabled')
|
|
})
|
|
return clone.innerHTML
|
|
}
|
|
|
|
function saveCurrentPageToHistory() {
|
|
const elt = getHistoryElement()
|
|
let path = currentPathForHistory
|
|
if (canAccessLocalStorage()) {
|
|
path = sessionStorage.getItem('htmx-current-path-for-history')
|
|
}
|
|
path = path || location.pathname + location.search
|
|
|
|
// Allow history snapshot feature to be disabled where hx-history="false"
|
|
// is present *anywhere* in the current document we're about to save,
|
|
// so we can prevent privileged data entering the cache.
|
|
// The page will still be reachable as a history entry, but htmx will fetch it
|
|
// live from the server onpopstate rather than look in the sessionStorage cache
|
|
const disableHistoryCache = getDocument().querySelector('[hx-history="false" i],[data-hx-history="false" i]')
|
|
if (!disableHistoryCache) {
|
|
triggerEvent(getDocument().body, 'htmx:beforeHistorySave', { path, historyElt: elt })
|
|
saveToHistoryCache(path, elt)
|
|
}
|
|
|
|
if (htmx.config.historyEnabled) history.replaceState({ htmx: true }, getDocument().title, location.href)
|
|
}
|
|
|
|
/**
|
|
* @param {string} path
|
|
*/
|
|
function pushUrlIntoHistory(path) {
|
|
// remove the cache buster parameter, if any
|
|
if (htmx.config.getCacheBusterParam) {
|
|
path = path.replace(/org\.htmx\.cache-buster=[^&]*&?/, '')
|
|
if (endsWith(path, '&') || endsWith(path, '?')) {
|
|
path = path.slice(0, -1)
|
|
}
|
|
}
|
|
if (htmx.config.historyEnabled) {
|
|
history.pushState({ htmx: true }, '', path)
|
|
}
|
|
setCurrentPathForHistory(path)
|
|
}
|
|
|
|
/**
|
|
* @param {string} path
|
|
*/
|
|
function replaceUrlInHistory(path) {
|
|
if (htmx.config.historyEnabled) history.replaceState({ htmx: true }, '', path)
|
|
setCurrentPathForHistory(path)
|
|
}
|
|
|
|
/**
|
|
* @param {HtmxSettleTask[]} tasks
|
|
*/
|
|
function settleImmediately(tasks) {
|
|
forEach(tasks, function(task) {
|
|
task.call(undefined)
|
|
})
|
|
}
|
|
|
|
/**
|
|
* @param {string} path
|
|
*/
|
|
function loadHistoryFromServer(path) {
|
|
const request = new XMLHttpRequest()
|
|
const swapSpec = { swapStyle: 'innerHTML', swapDelay: 0, settleDelay: 0 }
|
|
const details = { path, xhr: request, historyElt: getHistoryElement(), swapSpec }
|
|
request.open('GET', path, true)
|
|
if (htmx.config.historyRestoreAsHxRequest) {
|
|
request.setRequestHeader('HX-Request', 'true')
|
|
}
|
|
request.setRequestHeader('HX-History-Restore-Request', 'true')
|
|
request.setRequestHeader('HX-Current-URL', location.href)
|
|
request.onload = function() {
|
|
if (this.status >= 200 && this.status < 400) {
|
|
details.response = this.response
|
|
triggerEvent(getDocument().body, 'htmx:historyCacheMissLoad', details)
|
|
swap(details.historyElt, details.response, swapSpec, {
|
|
contextElement: details.historyElt,
|
|
historyRequest: true
|
|
})
|
|
setCurrentPathForHistory(details.path)
|
|
triggerEvent(getDocument().body, 'htmx:historyRestore', { path, cacheMiss: true, serverResponse: details.response })
|
|
} else {
|
|
triggerErrorEvent(getDocument().body, 'htmx:historyCacheMissLoadError', details)
|
|
}
|
|
}
|
|
if (triggerEvent(getDocument().body, 'htmx:historyCacheMiss', details)) {
|
|
request.send() // only send request if event not prevented
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {string} [path]
|
|
*/
|
|
function restoreHistory(path) {
|
|
saveCurrentPageToHistory()
|
|
path = path || location.pathname + location.search
|
|
const cached = getCachedHistory(path)
|
|
if (cached) {
|
|
const swapSpec = { swapStyle: 'innerHTML', swapDelay: 0, settleDelay: 0, scroll: cached.scroll }
|
|
const details = { path, item: cached, historyElt: getHistoryElement(), swapSpec }
|
|
if (triggerEvent(getDocument().body, 'htmx:historyCacheHit', details)) {
|
|
swap(details.historyElt, cached.content, swapSpec, {
|
|
contextElement: details.historyElt,
|
|
title: cached.title
|
|
})
|
|
setCurrentPathForHistory(details.path)
|
|
triggerEvent(getDocument().body, 'htmx:historyRestore', details)
|
|
}
|
|
} else {
|
|
if (htmx.config.refreshOnHistoryMiss) {
|
|
// @ts-ignore: optional parameter in reload() function throws error
|
|
// noinspection JSUnresolvedReference
|
|
htmx.location.reload(true)
|
|
} else {
|
|
loadHistoryFromServer(path)
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @returns {Element[]}
|
|
*/
|
|
function addRequestIndicatorClasses(elt) {
|
|
let indicators = /** @type Element[] */ (findAttributeTargets(elt, 'hx-indicator'))
|
|
if (indicators == null) {
|
|
indicators = [elt]
|
|
}
|
|
forEach(indicators, function(ic) {
|
|
const internalData = getInternalData(ic)
|
|
internalData.requestCount = (internalData.requestCount || 0) + 1
|
|
addClassToElement(ic, htmx.config.requestClass)
|
|
})
|
|
return indicators
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @returns {Element[]}
|
|
*/
|
|
function disableElements(elt) {
|
|
let disabledElts = /** @type Element[] */ (findAttributeTargets(elt, 'hx-disabled-elt'))
|
|
if (disabledElts == null) {
|
|
disabledElts = []
|
|
}
|
|
forEach(disabledElts, function(disabledElement) {
|
|
const internalData = getInternalData(disabledElement)
|
|
internalData.requestCount = (internalData.requestCount || 0) + 1
|
|
if (!disabledElement.hasAttribute('disabled')) {
|
|
disabledElement.setAttribute('disabled', '')
|
|
disabledElement.setAttribute('data-disabled-by-htmx', '')
|
|
}
|
|
})
|
|
return disabledElts
|
|
}
|
|
|
|
/**
|
|
* @param {Element[]} indicators
|
|
* @param {Element[]} disabled
|
|
*/
|
|
function removeRequestIndicators(indicators, disabled) {
|
|
forEach(indicators.concat(disabled), function(ele) {
|
|
const internalData = getInternalData(ele)
|
|
internalData.requestCount = (internalData.requestCount || 1) - 1
|
|
})
|
|
forEach(indicators, function(ic) {
|
|
const internalData = getInternalData(ic)
|
|
if (internalData.requestCount === 0) {
|
|
removeClassFromElement(ic, htmx.config.requestClass)
|
|
}
|
|
})
|
|
forEach(disabled, function(disabledElement) {
|
|
const internalData = getInternalData(disabledElement)
|
|
if (internalData.requestCount === 0 && disabledElement.hasAttribute('data-disabled-by-htmx')) {
|
|
disabledElement.removeAttribute('disabled')
|
|
disabledElement.removeAttribute('data-disabled-by-htmx')
|
|
}
|
|
})
|
|
}
|
|
|
|
//= ===================================================================
|
|
// Input Value Processing
|
|
//= ===================================================================
|
|
|
|
/**
|
|
* @param {Element[]} processed
|
|
* @param {Element} elt
|
|
* @returns {boolean}
|
|
*/
|
|
function haveSeenNode(processed, elt) {
|
|
for (let i = 0; i < processed.length; i++) {
|
|
const node = processed[i]
|
|
if (node.isSameNode(elt)) {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
/**
|
|
* @param {Element} element
|
|
* @return {boolean}
|
|
*/
|
|
function shouldInclude(element) {
|
|
// Cast to trick tsc, undefined values will work fine here
|
|
const elt = /** @type {HTMLInputElement} */ (element)
|
|
if (elt.name === '' || elt.name == null || elt.disabled || closest(elt, 'fieldset[disabled]')) {
|
|
return false
|
|
}
|
|
// ignore "submitter" types (see jQuery src/serialize.js)
|
|
if (elt.type === 'button' || elt.type === 'submit' || elt.tagName === 'image' || elt.tagName === 'reset' || elt.tagName === 'file') {
|
|
return false
|
|
}
|
|
if (elt.type === 'checkbox' || elt.type === 'radio') {
|
|
return elt.checked
|
|
}
|
|
return true
|
|
}
|
|
|
|
/**
|
|
* @param {string} name
|
|
* @param {string|Array|FormDataEntryValue} value
|
|
* @param {FormData} formData */
|
|
function addValueToFormData(name, value, formData) {
|
|
if (name != null && value != null) {
|
|
if (Array.isArray(value)) {
|
|
value.forEach(function(v) { formData.append(name, v) })
|
|
} else {
|
|
formData.append(name, value)
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {string} name
|
|
* @param {string|Array} value
|
|
* @param {FormData} formData */
|
|
function removeValueFromFormData(name, value, formData) {
|
|
if (name != null && value != null) {
|
|
let values = formData.getAll(name)
|
|
if (Array.isArray(value)) {
|
|
values = values.filter(v => value.indexOf(v) < 0)
|
|
} else {
|
|
values = values.filter(v => v !== value)
|
|
}
|
|
formData.delete(name)
|
|
forEach(values, v => formData.append(name, v))
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @returns {string|Array}
|
|
*/
|
|
function getValueFromInput(elt) {
|
|
if (elt instanceof HTMLSelectElement && elt.multiple) {
|
|
return toArray(elt.querySelectorAll('option:checked')).map(function(e) { return (/** @type HTMLOptionElement */(e)).value })
|
|
}
|
|
// include file inputs
|
|
if (elt instanceof HTMLInputElement && elt.files) {
|
|
return toArray(elt.files)
|
|
}
|
|
// @ts-ignore value will be undefined for non-input elements, which is fine
|
|
return elt.value
|
|
}
|
|
|
|
/**
|
|
* @param {Element[]} processed
|
|
* @param {FormData} formData
|
|
* @param {HtmxElementValidationError[]} errors
|
|
* @param {Element|HTMLInputElement|HTMLSelectElement|HTMLFormElement} elt
|
|
* @param {boolean} validate
|
|
*/
|
|
function processInputValue(processed, formData, errors, elt, validate) {
|
|
if (elt == null || haveSeenNode(processed, elt)) {
|
|
return
|
|
} else {
|
|
processed.push(elt)
|
|
}
|
|
if (shouldInclude(elt)) {
|
|
const name = getRawAttribute(elt, 'name')
|
|
addValueToFormData(name, getValueFromInput(elt), formData)
|
|
if (validate) {
|
|
validateElement(elt, errors)
|
|
}
|
|
}
|
|
if (elt instanceof HTMLFormElement) {
|
|
forEach(elt.elements, function(input) {
|
|
if (processed.indexOf(input) >= 0) {
|
|
// The input has already been processed and added to the values, but the FormData that will be
|
|
// constructed right after on the form, will include it once again. So remove that input's value
|
|
// now to avoid duplicates
|
|
removeValueFromFormData(input.name, getValueFromInput(input), formData)
|
|
} else {
|
|
processed.push(input)
|
|
}
|
|
if (validate) {
|
|
validateElement(input, errors)
|
|
}
|
|
})
|
|
new FormData(elt).forEach(function(value, name) {
|
|
if (value instanceof File && value.name === '') {
|
|
return // ignore no-name files
|
|
}
|
|
addValueToFormData(name, value, formData)
|
|
})
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {HtmxElementValidationError[]} errors
|
|
*/
|
|
function validateElement(elt, errors) {
|
|
const element = /** @type {HTMLElement & ElementInternals} */ (elt)
|
|
if (element.willValidate) {
|
|
triggerEvent(element, 'htmx:validation:validate')
|
|
if (!element.checkValidity()) {
|
|
if (
|
|
triggerEvent(element, 'htmx:validation:failed', {
|
|
message: element.validationMessage,
|
|
validity: element.validity
|
|
}) &&
|
|
!errors.length &&
|
|
htmx.config.reportValidityOfForms
|
|
) {
|
|
element.reportValidity()
|
|
}
|
|
errors.push({ elt: element, message: element.validationMessage, validity: element.validity })
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Override values in the one FormData with those from another.
|
|
* @param {FormData} receiver the formdata that will be mutated
|
|
* @param {FormData} donor the formdata that will provide the overriding values
|
|
* @returns {FormData} the {@linkcode receiver}
|
|
*/
|
|
function overrideFormData(receiver, donor) {
|
|
for (const key of donor.keys()) {
|
|
receiver.delete(key)
|
|
}
|
|
donor.forEach(function(value, key) {
|
|
receiver.append(key, value)
|
|
})
|
|
return receiver
|
|
}
|
|
|
|
/**
|
|
* @param {Element|HTMLFormElement} elt
|
|
* @param {HttpVerb} verb
|
|
* @returns {{errors: HtmxElementValidationError[], formData: FormData, values: Object}}
|
|
*/
|
|
function getInputValues(elt, verb) {
|
|
/** @type Element[] */
|
|
const processed = []
|
|
const formData = new FormData()
|
|
const priorityFormData = new FormData()
|
|
/** @type HtmxElementValidationError[] */
|
|
const errors = []
|
|
const internalData = getInternalData(elt)
|
|
if (internalData.lastButtonClicked && !bodyContains(internalData.lastButtonClicked)) {
|
|
internalData.lastButtonClicked = null
|
|
}
|
|
|
|
// only validate when form is directly submitted and novalidate or formnovalidate are not set
|
|
// or if the element has an explicit hx-validate="true" on it
|
|
let validate = (elt instanceof HTMLFormElement && elt.noValidate !== true) || getAttributeValue(elt, 'hx-validate') === 'true'
|
|
if (internalData.lastButtonClicked) {
|
|
validate = validate && internalData.lastButtonClicked.formNoValidate !== true
|
|
}
|
|
|
|
// for a non-GET include the related form, which may or may not be a parent element of elt
|
|
if (verb !== 'get') {
|
|
processInputValue(processed, priorityFormData, errors, getRelatedForm(elt), validate)
|
|
}
|
|
|
|
// include the element itself
|
|
processInputValue(processed, formData, errors, elt, validate)
|
|
|
|
// if a button or submit was clicked last, include its value
|
|
if (internalData.lastButtonClicked || elt.tagName === 'BUTTON' ||
|
|
(elt.tagName === 'INPUT' && getRawAttribute(elt, 'type') === 'submit')) {
|
|
const button = internalData.lastButtonClicked || (/** @type HTMLInputElement|HTMLButtonElement */(elt))
|
|
const name = getRawAttribute(button, 'name')
|
|
addValueToFormData(name, button.value, priorityFormData)
|
|
}
|
|
|
|
// include any explicit includes
|
|
const includes = findAttributeTargets(elt, 'hx-include')
|
|
forEach(includes, function(node) {
|
|
processInputValue(processed, formData, errors, asElement(node), validate)
|
|
// if a non-form is included, include any input values within it
|
|
if (!matches(node, 'form')) {
|
|
forEach(asParentNode(node).querySelectorAll(INPUT_SELECTOR), function(descendant) {
|
|
processInputValue(processed, formData, errors, descendant, validate)
|
|
})
|
|
}
|
|
})
|
|
|
|
// values from a <form> take precedence, overriding the regular values
|
|
overrideFormData(formData, priorityFormData)
|
|
|
|
return { errors, formData, values: formDataProxy(formData) }
|
|
}
|
|
|
|
/**
|
|
* @param {string} returnStr
|
|
* @param {string} name
|
|
* @param {any} realValue
|
|
* @returns {string}
|
|
*/
|
|
function appendParam(returnStr, name, realValue) {
|
|
if (returnStr !== '') {
|
|
returnStr += '&'
|
|
}
|
|
if (String(realValue) === '[object Object]') {
|
|
realValue = JSON.stringify(realValue)
|
|
}
|
|
const s = encodeURIComponent(realValue)
|
|
returnStr += encodeURIComponent(name) + '=' + s
|
|
return returnStr
|
|
}
|
|
|
|
/**
|
|
* @param {FormData|Object} values
|
|
* @returns string
|
|
*/
|
|
function urlEncode(values) {
|
|
values = formDataFromObject(values)
|
|
let returnStr = ''
|
|
values.forEach(function(value, key) {
|
|
returnStr = appendParam(returnStr, key, value)
|
|
})
|
|
return returnStr
|
|
}
|
|
|
|
//= ===================================================================
|
|
// Ajax
|
|
//= ===================================================================
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {Element} target
|
|
* @param {string} prompt
|
|
* @returns {HtmxHeaderSpecification}
|
|
*/
|
|
function getHeaders(elt, target, prompt) {
|
|
/** @type HtmxHeaderSpecification */
|
|
const headers = {
|
|
'HX-Request': 'true',
|
|
'HX-Trigger': getRawAttribute(elt, 'id'),
|
|
'HX-Trigger-Name': getRawAttribute(elt, 'name'),
|
|
'HX-Target': getAttributeValue(target, 'id'),
|
|
'HX-Current-URL': location.href
|
|
}
|
|
getValuesForElement(elt, 'hx-headers', false, headers)
|
|
if (prompt !== undefined) {
|
|
headers['HX-Prompt'] = prompt
|
|
}
|
|
if (getInternalData(elt).boosted) {
|
|
headers['HX-Boosted'] = 'true'
|
|
}
|
|
return headers
|
|
}
|
|
|
|
/**
|
|
* filterValues takes an object containing form input values
|
|
* and returns a new object that only contains keys that are
|
|
* specified by the closest "hx-params" attribute
|
|
* @param {FormData} inputValues
|
|
* @param {Element} elt
|
|
* @returns {FormData}
|
|
*/
|
|
function filterValues(inputValues, elt) {
|
|
const paramsValue = getClosestAttributeValue(elt, 'hx-params')
|
|
if (paramsValue) {
|
|
if (paramsValue === 'none') {
|
|
return new FormData()
|
|
} else if (paramsValue === '*') {
|
|
return inputValues
|
|
} else if (paramsValue.indexOf('not ') === 0) {
|
|
forEach(paramsValue.slice(4).split(','), function(name) {
|
|
name = name.trim()
|
|
inputValues.delete(name)
|
|
})
|
|
return inputValues
|
|
} else {
|
|
const newValues = new FormData()
|
|
forEach(paramsValue.split(','), function(name) {
|
|
name = name.trim()
|
|
if (inputValues.has(name)) {
|
|
inputValues.getAll(name).forEach(function(value) { newValues.append(name, value) })
|
|
}
|
|
})
|
|
return newValues
|
|
}
|
|
} else {
|
|
return inputValues
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @return {boolean}
|
|
*/
|
|
function isAnchorLink(elt) {
|
|
return !!getRawAttribute(elt, 'href') && getRawAttribute(elt, 'href').indexOf('#') >= 0
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {HtmxSwapStyle} [swapInfoOverride]
|
|
* @returns {HtmxSwapSpecification}
|
|
*/
|
|
function getSwapSpecification(elt, swapInfoOverride) {
|
|
const swapInfo = swapInfoOverride || getClosestAttributeValue(elt, 'hx-swap')
|
|
/** @type HtmxSwapSpecification */
|
|
const swapSpec = {
|
|
swapStyle: getInternalData(elt).boosted ? 'innerHTML' : htmx.config.defaultSwapStyle,
|
|
swapDelay: htmx.config.defaultSwapDelay,
|
|
settleDelay: htmx.config.defaultSettleDelay
|
|
}
|
|
if (htmx.config.scrollIntoViewOnBoost && getInternalData(elt).boosted && !isAnchorLink(elt)) {
|
|
swapSpec.show = 'top'
|
|
}
|
|
if (swapInfo) {
|
|
const split = splitOnWhitespace(swapInfo)
|
|
if (split.length > 0) {
|
|
for (let i = 0; i < split.length; i++) {
|
|
const value = split[i]
|
|
if (value.indexOf('swap:') === 0) {
|
|
swapSpec.swapDelay = parseInterval(value.slice(5))
|
|
} else if (value.indexOf('settle:') === 0) {
|
|
swapSpec.settleDelay = parseInterval(value.slice(7))
|
|
} else if (value.indexOf('transition:') === 0) {
|
|
swapSpec.transition = value.slice(11) === 'true'
|
|
} else if (value.indexOf('ignoreTitle:') === 0) {
|
|
swapSpec.ignoreTitle = value.slice(12) === 'true'
|
|
} else if (value.indexOf('scroll:') === 0) {
|
|
const scrollSpec = value.slice(7)
|
|
var splitSpec = scrollSpec.split(':')
|
|
const scrollVal = splitSpec.pop()
|
|
var selectorVal = splitSpec.length > 0 ? splitSpec.join(':') : null
|
|
// @ts-ignore
|
|
swapSpec.scroll = scrollVal
|
|
swapSpec.scrollTarget = selectorVal
|
|
} else if (value.indexOf('show:') === 0) {
|
|
const showSpec = value.slice(5)
|
|
var splitSpec = showSpec.split(':')
|
|
const showVal = splitSpec.pop()
|
|
var selectorVal = splitSpec.length > 0 ? splitSpec.join(':') : null
|
|
swapSpec.show = showVal
|
|
swapSpec.showTarget = selectorVal
|
|
} else if (value.indexOf('focus-scroll:') === 0) {
|
|
const focusScrollVal = value.slice('focus-scroll:'.length)
|
|
swapSpec.focusScroll = focusScrollVal == 'true'
|
|
} else if (i == 0) {
|
|
swapSpec.swapStyle = value
|
|
} else {
|
|
logError('Unknown modifier in hx-swap: ' + value)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return swapSpec
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @return {boolean}
|
|
*/
|
|
function usesFormData(elt) {
|
|
return getClosestAttributeValue(elt, 'hx-encoding') === 'multipart/form-data' ||
|
|
(matches(elt, 'form') && getRawAttribute(elt, 'enctype') === 'multipart/form-data')
|
|
}
|
|
|
|
/**
|
|
* @param {XMLHttpRequest} xhr
|
|
* @param {Element} elt
|
|
* @param {FormData} filteredParameters
|
|
* @returns {*|string|null}
|
|
*/
|
|
function encodeParamsForBody(xhr, elt, filteredParameters) {
|
|
let encodedParameters = null
|
|
withExtensions(elt, function(extension) {
|
|
if (encodedParameters == null) {
|
|
encodedParameters = extension.encodeParameters(xhr, filteredParameters, elt)
|
|
}
|
|
})
|
|
if (encodedParameters != null) {
|
|
return encodedParameters
|
|
} else {
|
|
if (usesFormData(elt)) {
|
|
// Force conversion to an actual FormData object in case filteredParameters is a formDataProxy
|
|
// See https://github.com/bigskysoftware/htmx/issues/2317
|
|
return overrideFormData(new FormData(), formDataFromObject(filteredParameters))
|
|
} else {
|
|
return urlEncode(filteredParameters)
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @param {Element} target
|
|
* @returns {HtmxSettleInfo}
|
|
*/
|
|
function makeSettleInfo(target) {
|
|
return { tasks: [], elts: [target] }
|
|
}
|
|
|
|
/**
|
|
* @param {Element[]} content
|
|
* @param {HtmxSwapSpecification} swapSpec
|
|
*/
|
|
function updateScrollState(content, swapSpec) {
|
|
const first = content[0]
|
|
const last = content[content.length - 1]
|
|
if (swapSpec.scroll) {
|
|
var target = null
|
|
if (swapSpec.scrollTarget) {
|
|
target = asElement(querySelectorExt(first, swapSpec.scrollTarget))
|
|
}
|
|
if (swapSpec.scroll === 'top' && (first || target)) {
|
|
target = target || first
|
|
target.scrollTop = 0
|
|
}
|
|
if (swapSpec.scroll === 'bottom' && (last || target)) {
|
|
target = target || last
|
|
target.scrollTop = target.scrollHeight
|
|
}
|
|
if (typeof swapSpec.scroll === 'number') {
|
|
getWindow().setTimeout(function() {
|
|
window.scrollTo(0, /** @type number */ (swapSpec.scroll))
|
|
}, 0) // next 'tick', so browser has time to render layout
|
|
}
|
|
}
|
|
if (swapSpec.show) {
|
|
var target = null
|
|
if (swapSpec.showTarget) {
|
|
let targetStr = swapSpec.showTarget
|
|
if (swapSpec.showTarget === 'window') {
|
|
targetStr = 'body'
|
|
}
|
|
target = asElement(querySelectorExt(first, targetStr))
|
|
}
|
|
if (swapSpec.show === 'top' && (first || target)) {
|
|
target = target || first
|
|
// @ts-ignore For some reason tsc doesn't recognize "instant" as a valid option for now
|
|
target.scrollIntoView({ block: 'start', behavior: htmx.config.scrollBehavior })
|
|
}
|
|
if (swapSpec.show === 'bottom' && (last || target)) {
|
|
target = target || last
|
|
// @ts-ignore For some reason tsc doesn't recognize "instant" as a valid option for now
|
|
target.scrollIntoView({ block: 'end', behavior: htmx.config.scrollBehavior })
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {string} attr
|
|
* @param {boolean=} evalAsDefault
|
|
* @param {Object=} values
|
|
* @param {Event=} event
|
|
* @returns {Object}
|
|
*/
|
|
function getValuesForElement(elt, attr, evalAsDefault, values, event) {
|
|
if (values == null) {
|
|
values = {}
|
|
}
|
|
if (elt == null) {
|
|
return values
|
|
}
|
|
const attributeValue = getAttributeValue(elt, attr)
|
|
if (attributeValue) {
|
|
let str = attributeValue.trim()
|
|
let evaluateValue = evalAsDefault
|
|
if (str === 'unset') {
|
|
return null
|
|
}
|
|
if (str.indexOf('javascript:') === 0) {
|
|
str = str.slice(11)
|
|
evaluateValue = true
|
|
} else if (str.indexOf('js:') === 0) {
|
|
str = str.slice(3)
|
|
evaluateValue = true
|
|
}
|
|
if (str.indexOf('{') !== 0) {
|
|
str = '{' + str + '}'
|
|
}
|
|
let varsValues
|
|
if (evaluateValue) {
|
|
varsValues = maybeEval(elt, function() {
|
|
if (event) {
|
|
return Function('event', 'return (' + str + ')').call(elt, event)
|
|
} else { // allow window.event to be accessible
|
|
return Function('return (' + str + ')').call(elt)
|
|
}
|
|
}, {})
|
|
} else {
|
|
varsValues = parseJSON(str)
|
|
}
|
|
for (const key of Object.keys(varsValues)) {
|
|
if (values[key] == null) {
|
|
values[key] = varsValues[key]
|
|
}
|
|
}
|
|
}
|
|
return getValuesForElement(asElement(parentElt(elt)), attr, evalAsDefault, values, event)
|
|
}
|
|
|
|
/**
|
|
* @param {EventTarget|string} elt
|
|
* @param {() => any} toEval
|
|
* @param {any=} defaultVal
|
|
* @returns {any}
|
|
*/
|
|
function maybeEval(elt, toEval, defaultVal) {
|
|
if (htmx.config.allowEval) {
|
|
return toEval()
|
|
} else {
|
|
triggerErrorEvent(elt, 'htmx:evalDisallowedError')
|
|
return defaultVal
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {Event=} event
|
|
* @param {*?=} expressionVars
|
|
* @returns
|
|
*/
|
|
function getHXVarsForElement(elt, event, expressionVars) {
|
|
return getValuesForElement(elt, 'hx-vars', true, expressionVars, event)
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {Event=} event
|
|
* @param {*?=} expressionVars
|
|
* @returns
|
|
*/
|
|
function getHXValsForElement(elt, event, expressionVars) {
|
|
return getValuesForElement(elt, 'hx-vals', false, expressionVars, event)
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {Event=} event
|
|
* @returns {FormData}
|
|
*/
|
|
function getExpressionVars(elt, event) {
|
|
return mergeObjects(getHXVarsForElement(elt, event), getHXValsForElement(elt, event))
|
|
}
|
|
|
|
/**
|
|
* @param {XMLHttpRequest} xhr
|
|
* @param {string} header
|
|
* @param {string|null} headerValue
|
|
*/
|
|
function safelySetHeaderValue(xhr, header, headerValue) {
|
|
if (headerValue !== null) {
|
|
try {
|
|
xhr.setRequestHeader(header, headerValue)
|
|
} catch (e) {
|
|
// On an exception, try to set the header URI encoded instead
|
|
xhr.setRequestHeader(header, encodeURIComponent(headerValue))
|
|
xhr.setRequestHeader(header + '-URI-AutoEncoded', 'true')
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {XMLHttpRequest} xhr
|
|
* @return {string}
|
|
*/
|
|
function getPathFromResponse(xhr) {
|
|
if (xhr.responseURL) {
|
|
try {
|
|
const url = new URL(xhr.responseURL)
|
|
return url.pathname + url.search
|
|
} catch (e) {
|
|
triggerErrorEvent(getDocument().body, 'htmx:badResponseUrl', { url: xhr.responseURL })
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {XMLHttpRequest} xhr
|
|
* @param {string} name
|
|
* @return {boolean}
|
|
*/
|
|
function hasHeader(xhr, name) {
|
|
return xhr.getResponseHeader(name) !== null
|
|
}
|
|
|
|
/**
|
|
* Issues an htmx-style AJAX request
|
|
*
|
|
* @see https://htmx.org/api/#ajax
|
|
*
|
|
* @param {HttpVerb} verb
|
|
* @param {string} path the URL path to make the AJAX
|
|
* @param {Element|string|HtmxAjaxHelperContext} context the element to target (defaults to the **body**) | a selector for the target | a context object that contains any of the following
|
|
* @return {Promise<void>} Promise that resolves immediately if no request is sent, or when the request is complete
|
|
*/
|
|
function ajaxHelper(verb, path, context) {
|
|
verb = (/** @type HttpVerb */(verb.toLowerCase()))
|
|
if (context) {
|
|
if (context instanceof Element || typeof context === 'string') {
|
|
return issueAjaxRequest(verb, path, null, null, {
|
|
targetOverride: resolveTarget(context) || DUMMY_ELT,
|
|
returnPromise: true
|
|
})
|
|
} else {
|
|
let resolvedTarget = resolveTarget(context.target)
|
|
// If target is supplied but can't resolve OR source is supplied but both target and source can't be resolved
|
|
// then use DUMMY_ELT to abort the request with htmx:targetError to avoid it replacing body by mistake
|
|
if ((context.target && !resolvedTarget) || (context.source && !resolvedTarget && !resolveTarget(context.source))) {
|
|
resolvedTarget = DUMMY_ELT
|
|
}
|
|
return issueAjaxRequest(verb, path, resolveTarget(context.source), context.event,
|
|
{
|
|
handler: context.handler,
|
|
headers: context.headers,
|
|
values: context.values,
|
|
targetOverride: resolvedTarget,
|
|
swapOverride: context.swap,
|
|
select: context.select,
|
|
returnPromise: true,
|
|
push: context.push,
|
|
replace: context.replace,
|
|
selectOOB: context.selectOOB
|
|
})
|
|
}
|
|
} else {
|
|
return issueAjaxRequest(verb, path, null, null, {
|
|
returnPromise: true
|
|
})
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @return {Element[]}
|
|
*/
|
|
function hierarchyForElt(elt) {
|
|
const arr = []
|
|
while (elt) {
|
|
arr.push(elt)
|
|
elt = elt.parentElement
|
|
}
|
|
return arr
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {string} path
|
|
* @param {HtmxRequestConfig} requestConfig
|
|
* @return {boolean}
|
|
*/
|
|
function verifyPath(elt, path, requestConfig) {
|
|
const url = new URL(path, location.protocol !== 'about:' ? location.href : window.origin)
|
|
const origin = location.protocol !== 'about:' ? location.origin : window.origin
|
|
const sameHost = origin === url.origin
|
|
|
|
if (htmx.config.selfRequestsOnly) {
|
|
if (!sameHost) {
|
|
return false
|
|
}
|
|
}
|
|
return triggerEvent(elt, 'htmx:validateUrl', mergeObjects({ url, sameHost }, requestConfig))
|
|
}
|
|
|
|
/**
|
|
* @param {Object|FormData} obj
|
|
* @return {FormData}
|
|
*/
|
|
function formDataFromObject(obj) {
|
|
if (obj instanceof FormData) return obj
|
|
const formData = new FormData()
|
|
for (const key of Object.keys(obj)) {
|
|
if (obj[key] && typeof obj[key].forEach === 'function') {
|
|
obj[key].forEach(function(v) { formData.append(key, v) })
|
|
} else if (typeof obj[key] === 'object' && !(obj[key] instanceof Blob)) {
|
|
formData.append(key, JSON.stringify(obj[key]))
|
|
} else {
|
|
formData.append(key, obj[key])
|
|
}
|
|
}
|
|
return formData
|
|
}
|
|
|
|
/**
|
|
* @param {FormData} formData
|
|
* @param {string} name
|
|
* @param {Array} array
|
|
* @returns {Array}
|
|
*/
|
|
function formDataArrayProxy(formData, name, array) {
|
|
// mutating the array should mutate the underlying form data
|
|
return new Proxy(array, {
|
|
get: function(target, key) {
|
|
if (typeof key === 'number') return target[key]
|
|
if (key === 'length') return target.length
|
|
if (key === 'push') {
|
|
return function(value) {
|
|
target.push(value)
|
|
formData.append(name, value)
|
|
}
|
|
}
|
|
if (typeof target[key] === 'function') {
|
|
return function() {
|
|
target[key].apply(target, arguments)
|
|
formData.delete(name)
|
|
target.forEach(function(v) { formData.append(name, v) })
|
|
}
|
|
}
|
|
|
|
if (target[key] && target[key].length === 1) {
|
|
return target[key][0]
|
|
} else {
|
|
return target[key]
|
|
}
|
|
},
|
|
set: function(target, index, value) {
|
|
target[index] = value
|
|
formData.delete(name)
|
|
target.forEach(function(v) { formData.append(name, v) })
|
|
return true
|
|
}
|
|
})
|
|
}
|
|
|
|
/**
|
|
* @param {FormData} formData
|
|
* @returns {Object}
|
|
*/
|
|
function formDataProxy(formData) {
|
|
return new Proxy(formData, {
|
|
get: function(target, name) {
|
|
if (typeof name === 'symbol') {
|
|
// Forward symbol calls to the FormData itself directly
|
|
const result = Reflect.get(target, name)
|
|
// Wrap in function with apply to correctly bind the FormData context, as a direct call would result in an illegal invocation error
|
|
if (typeof result === 'function') {
|
|
return function() {
|
|
return result.apply(formData, arguments)
|
|
}
|
|
} else {
|
|
return result
|
|
}
|
|
}
|
|
if (name === 'toJSON') {
|
|
// Support JSON.stringify call on proxy
|
|
return () => Object.fromEntries(formData)
|
|
}
|
|
if (name in target) {
|
|
// Wrap in function with apply to correctly bind the FormData context, as a direct call would result in an illegal invocation error
|
|
if (typeof target[name] === 'function') {
|
|
return function() {
|
|
return formData[name].apply(formData, arguments)
|
|
}
|
|
}
|
|
}
|
|
const array = formData.getAll(name)
|
|
// Those 2 undefined & single value returns are for retro-compatibility as we weren't using FormData before
|
|
if (array.length === 0) {
|
|
return undefined
|
|
} else if (array.length === 1) {
|
|
return array[0]
|
|
} else {
|
|
return formDataArrayProxy(target, name, array)
|
|
}
|
|
},
|
|
set: function(target, name, value) {
|
|
if (typeof name !== 'string') {
|
|
return false
|
|
}
|
|
target.delete(name)
|
|
if (value && typeof value.forEach === 'function') {
|
|
value.forEach(function(v) { target.append(name, v) })
|
|
} else if (typeof value === 'object' && !(value instanceof Blob)) {
|
|
target.append(name, JSON.stringify(value))
|
|
} else {
|
|
target.append(name, value)
|
|
}
|
|
return true
|
|
},
|
|
deleteProperty: function(target, name) {
|
|
if (typeof name === 'string') {
|
|
target.delete(name)
|
|
}
|
|
return true
|
|
},
|
|
// Support Object.assign call from proxy
|
|
ownKeys: function(target) {
|
|
return Reflect.ownKeys(Object.fromEntries(target))
|
|
},
|
|
getOwnPropertyDescriptor: function(target, prop) {
|
|
return Reflect.getOwnPropertyDescriptor(Object.fromEntries(target), prop)
|
|
}
|
|
})
|
|
}
|
|
|
|
/**
|
|
* @param {HttpVerb} verb
|
|
* @param {string} path
|
|
* @param {Element} elt
|
|
* @param {Event} event
|
|
* @param {HtmxAjaxEtc} [etc]
|
|
* @param {boolean} [confirmed]
|
|
* @return {Promise<void>}
|
|
*/
|
|
function issueAjaxRequest(verb, path, elt, event, etc, confirmed) {
|
|
let resolve = null
|
|
let reject = null
|
|
etc = etc != null ? etc : {}
|
|
if (etc.returnPromise && typeof Promise !== 'undefined') {
|
|
var promise = new Promise(function(_resolve, _reject) {
|
|
resolve = _resolve
|
|
reject = _reject
|
|
})
|
|
}
|
|
if (elt == null) {
|
|
elt = getDocument().body
|
|
}
|
|
const responseHandler = etc.handler || handleAjaxResponse
|
|
const select = etc.select || null
|
|
|
|
if (!bodyContains(elt)) {
|
|
// do not issue requests for elements removed from the DOM
|
|
maybeCall(resolve)
|
|
return promise
|
|
}
|
|
const target = etc.targetOverride || asElement(getTarget(elt))
|
|
if (target == null || target == DUMMY_ELT) {
|
|
triggerErrorEvent(elt, 'htmx:targetError', { target: getClosestAttributeValue(elt, 'hx-target') })
|
|
maybeCall(reject)
|
|
return promise
|
|
}
|
|
|
|
let eltData = getInternalData(elt)
|
|
const submitter = eltData.lastButtonClicked
|
|
|
|
if (submitter) {
|
|
const buttonPath = getRawAttribute(submitter, 'formaction')
|
|
if (buttonPath != null) {
|
|
path = buttonPath
|
|
}
|
|
|
|
const buttonVerb = getRawAttribute(submitter, 'formmethod')
|
|
if (buttonVerb != null) {
|
|
if (VERBS.includes(buttonVerb.toLowerCase())) {
|
|
verb = (/** @type HttpVerb */(buttonVerb))
|
|
} else {
|
|
maybeCall(resolve)
|
|
return promise
|
|
}
|
|
}
|
|
}
|
|
|
|
const confirmQuestion = getClosestAttributeValue(elt, 'hx-confirm')
|
|
// allow event-based confirmation w/ a callback
|
|
if (confirmed === undefined) {
|
|
const issueRequest = function(skipConfirmation) {
|
|
return issueAjaxRequest(verb, path, elt, event, etc, !!skipConfirmation)
|
|
}
|
|
const confirmDetails = { target, elt, path, verb, triggeringEvent: event, etc, issueRequest, question: confirmQuestion }
|
|
if (triggerEvent(elt, 'htmx:confirm', confirmDetails) === false) {
|
|
maybeCall(resolve)
|
|
return promise
|
|
}
|
|
}
|
|
|
|
let syncElt = elt
|
|
let syncStrategy = getClosestAttributeValue(elt, 'hx-sync')
|
|
let queueStrategy = null
|
|
let abortable = false
|
|
if (syncStrategy) {
|
|
const syncStrings = syncStrategy.split(':')
|
|
const selector = syncStrings[0].trim()
|
|
if (selector === 'this') {
|
|
syncElt = findThisElement(elt, 'hx-sync')
|
|
} else {
|
|
syncElt = asElement(querySelectorExt(elt, selector))
|
|
}
|
|
// default to the drop strategy
|
|
syncStrategy = (syncStrings[1] || 'drop').trim()
|
|
eltData = getInternalData(syncElt)
|
|
if (syncStrategy === 'drop' && eltData.xhr && eltData.abortable !== true) {
|
|
maybeCall(resolve)
|
|
return promise
|
|
} else if (syncStrategy === 'abort') {
|
|
if (eltData.xhr) {
|
|
maybeCall(resolve)
|
|
return promise
|
|
} else {
|
|
abortable = true
|
|
}
|
|
} else if (syncStrategy === 'replace') {
|
|
triggerEvent(syncElt, 'htmx:abort') // abort the current request and continue
|
|
} else if (syncStrategy.indexOf('queue') === 0) {
|
|
const queueStrArray = syncStrategy.split(' ')
|
|
queueStrategy = (queueStrArray[1] || 'last').trim()
|
|
}
|
|
}
|
|
|
|
if (eltData.xhr) {
|
|
if (eltData.abortable) {
|
|
triggerEvent(syncElt, 'htmx:abort') // abort the current request and continue
|
|
} else {
|
|
if (queueStrategy == null) {
|
|
if (event) {
|
|
const eventData = getInternalData(event)
|
|
if (eventData && eventData.triggerSpec && eventData.triggerSpec.queue) {
|
|
queueStrategy = eventData.triggerSpec.queue
|
|
}
|
|
}
|
|
if (queueStrategy == null) {
|
|
queueStrategy = 'last'
|
|
}
|
|
}
|
|
if (eltData.queuedRequests == null) {
|
|
eltData.queuedRequests = []
|
|
}
|
|
if (queueStrategy === 'first' && eltData.queuedRequests.length === 0) {
|
|
eltData.queuedRequests.push(function() {
|
|
issueAjaxRequest(verb, path, elt, event, etc)
|
|
})
|
|
} else if (queueStrategy === 'all') {
|
|
eltData.queuedRequests.push(function() {
|
|
issueAjaxRequest(verb, path, elt, event, etc)
|
|
})
|
|
} else if (queueStrategy === 'last') {
|
|
eltData.queuedRequests = [] // dump existing queue
|
|
eltData.queuedRequests.push(function() {
|
|
issueAjaxRequest(verb, path, elt, event, etc)
|
|
})
|
|
}
|
|
maybeCall(resolve)
|
|
return promise
|
|
}
|
|
}
|
|
|
|
const xhr = new XMLHttpRequest()
|
|
eltData.xhr = xhr
|
|
eltData.abortable = abortable
|
|
const endRequestLock = function() {
|
|
eltData.xhr = null
|
|
eltData.abortable = false
|
|
if (eltData.queuedRequests != null &&
|
|
eltData.queuedRequests.length > 0) {
|
|
const queuedRequest = eltData.queuedRequests.shift()
|
|
queuedRequest()
|
|
}
|
|
}
|
|
const promptQuestion = getClosestAttributeValue(elt, 'hx-prompt')
|
|
if (promptQuestion) {
|
|
var promptResponse = prompt(promptQuestion)
|
|
// prompt returns null if cancelled and empty string if accepted with no entry
|
|
if (promptResponse === null ||
|
|
!triggerEvent(elt, 'htmx:prompt', { prompt: promptResponse, target })) {
|
|
maybeCall(resolve)
|
|
endRequestLock()
|
|
return promise
|
|
}
|
|
}
|
|
|
|
if (confirmQuestion && !confirmed) {
|
|
if (!confirm(confirmQuestion)) {
|
|
maybeCall(resolve)
|
|
endRequestLock()
|
|
return promise
|
|
}
|
|
}
|
|
|
|
let headers = getHeaders(elt, target, promptResponse)
|
|
|
|
if (verb !== 'get' && !usesFormData(elt)) {
|
|
headers['Content-Type'] = 'application/x-www-form-urlencoded'
|
|
}
|
|
|
|
if (etc.headers) {
|
|
headers = mergeObjects(headers, etc.headers)
|
|
}
|
|
const results = getInputValues(elt, verb)
|
|
let errors = results.errors
|
|
const rawFormData = results.formData
|
|
if (etc.values) {
|
|
overrideFormData(rawFormData, formDataFromObject(etc.values))
|
|
}
|
|
const expressionVars = formDataFromObject(getExpressionVars(elt, event))
|
|
const allFormData = overrideFormData(rawFormData, expressionVars)
|
|
let filteredFormData = filterValues(allFormData, elt)
|
|
|
|
if (htmx.config.getCacheBusterParam && verb === 'get') {
|
|
filteredFormData.set('org.htmx.cache-buster', getRawAttribute(target, 'id') || 'true')
|
|
}
|
|
|
|
// behavior of anchors w/ empty href is to use the current URL
|
|
if (path == null || path === '') {
|
|
path = location.href
|
|
}
|
|
|
|
/**
|
|
* @type {Object}
|
|
* @property {boolean} [credentials]
|
|
* @property {number} [timeout]
|
|
* @property {boolean} [noHeaders]
|
|
*/
|
|
const requestAttrValues = getValuesForElement(elt, 'hx-request')
|
|
|
|
const eltIsBoosted = getInternalData(elt).boosted
|
|
|
|
let useUrlParams = htmx.config.methodsThatUseUrlParams.indexOf(verb) >= 0
|
|
|
|
/** @type HtmxRequestConfig */
|
|
const requestConfig = {
|
|
boosted: eltIsBoosted,
|
|
useUrlParams,
|
|
formData: filteredFormData,
|
|
parameters: formDataProxy(filteredFormData),
|
|
unfilteredFormData: allFormData,
|
|
unfilteredParameters: formDataProxy(allFormData),
|
|
headers,
|
|
elt,
|
|
target,
|
|
verb,
|
|
errors,
|
|
withCredentials: etc.credentials || requestAttrValues.credentials || htmx.config.withCredentials,
|
|
timeout: etc.timeout || requestAttrValues.timeout || htmx.config.timeout,
|
|
path,
|
|
triggeringEvent: event
|
|
}
|
|
|
|
if (!triggerEvent(elt, 'htmx:configRequest', requestConfig)) {
|
|
maybeCall(resolve)
|
|
endRequestLock()
|
|
return promise
|
|
}
|
|
|
|
// copy out in case the object was overwritten
|
|
path = requestConfig.path
|
|
verb = requestConfig.verb
|
|
headers = requestConfig.headers
|
|
filteredFormData = formDataFromObject(requestConfig.parameters)
|
|
errors = requestConfig.errors
|
|
useUrlParams = requestConfig.useUrlParams
|
|
|
|
if (errors && errors.length > 0) {
|
|
triggerEvent(elt, 'htmx:validation:halted', requestConfig)
|
|
maybeCall(resolve)
|
|
endRequestLock()
|
|
return promise
|
|
}
|
|
|
|
const splitPath = path.split('#')
|
|
const pathNoAnchor = splitPath[0]
|
|
const anchor = splitPath[1]
|
|
|
|
let finalPath = path
|
|
if (useUrlParams) {
|
|
finalPath = pathNoAnchor
|
|
const hasValues = !filteredFormData.keys().next().done
|
|
if (hasValues) {
|
|
if (finalPath.indexOf('?') < 0) {
|
|
finalPath += '?'
|
|
} else {
|
|
finalPath += '&'
|
|
}
|
|
finalPath += urlEncode(filteredFormData)
|
|
if (anchor) {
|
|
finalPath += '#' + anchor
|
|
}
|
|
}
|
|
}
|
|
|
|
if (!verifyPath(elt, finalPath, requestConfig)) {
|
|
triggerErrorEvent(elt, 'htmx:invalidPath', requestConfig)
|
|
maybeCall(reject)
|
|
endRequestLock()
|
|
return promise
|
|
}
|
|
|
|
xhr.open(verb.toUpperCase(), finalPath, true)
|
|
xhr.overrideMimeType('text/html')
|
|
xhr.withCredentials = requestConfig.withCredentials
|
|
xhr.timeout = requestConfig.timeout
|
|
|
|
// request headers
|
|
if (requestAttrValues.noHeaders) {
|
|
// ignore all headers
|
|
} else {
|
|
for (const header of Object.keys(headers)) {
|
|
safelySetHeaderValue(xhr, header, headers[header])
|
|
}
|
|
}
|
|
|
|
/** @type {HtmxResponseInfo} */
|
|
const responseInfo = {
|
|
xhr,
|
|
target,
|
|
requestConfig,
|
|
etc,
|
|
boosted: eltIsBoosted,
|
|
select,
|
|
pathInfo: {
|
|
requestPath: path,
|
|
finalRequestPath: finalPath,
|
|
responsePath: null,
|
|
anchor
|
|
}
|
|
}
|
|
|
|
xhr.onload = function() {
|
|
try {
|
|
const hierarchy = hierarchyForElt(elt)
|
|
responseInfo.pathInfo.responsePath = getPathFromResponse(xhr)
|
|
responseHandler(elt, responseInfo)
|
|
if (responseInfo.keepIndicators !== true) {
|
|
removeRequestIndicators(indicators, disableElts)
|
|
}
|
|
triggerEvent(elt, 'htmx:afterRequest', responseInfo)
|
|
triggerEvent(elt, 'htmx:afterOnLoad', responseInfo)
|
|
// if the body no longer contains the element, trigger the event on the closest parent
|
|
// remaining in the DOM
|
|
if (!bodyContains(elt)) {
|
|
let secondaryTriggerElt = null
|
|
while (hierarchy.length > 0 && secondaryTriggerElt == null) {
|
|
const parentEltInHierarchy = hierarchy.shift()
|
|
if (bodyContains(parentEltInHierarchy)) {
|
|
secondaryTriggerElt = parentEltInHierarchy
|
|
}
|
|
}
|
|
if (secondaryTriggerElt) {
|
|
triggerEvent(secondaryTriggerElt, 'htmx:afterRequest', responseInfo)
|
|
triggerEvent(secondaryTriggerElt, 'htmx:afterOnLoad', responseInfo)
|
|
}
|
|
}
|
|
maybeCall(resolve)
|
|
} catch (e) {
|
|
triggerErrorEvent(elt, 'htmx:onLoadError', mergeObjects({ error: e }, responseInfo))
|
|
throw e
|
|
} finally {
|
|
endRequestLock()
|
|
}
|
|
}
|
|
xhr.onerror = function() {
|
|
removeRequestIndicators(indicators, disableElts)
|
|
triggerErrorEvent(elt, 'htmx:afterRequest', responseInfo)
|
|
triggerErrorEvent(elt, 'htmx:sendError', responseInfo)
|
|
maybeCall(reject)
|
|
endRequestLock()
|
|
}
|
|
xhr.onabort = function() {
|
|
removeRequestIndicators(indicators, disableElts)
|
|
triggerErrorEvent(elt, 'htmx:afterRequest', responseInfo)
|
|
triggerErrorEvent(elt, 'htmx:sendAbort', responseInfo)
|
|
maybeCall(reject)
|
|
endRequestLock()
|
|
}
|
|
xhr.ontimeout = function() {
|
|
removeRequestIndicators(indicators, disableElts)
|
|
triggerErrorEvent(elt, 'htmx:afterRequest', responseInfo)
|
|
triggerErrorEvent(elt, 'htmx:timeout', responseInfo)
|
|
maybeCall(reject)
|
|
endRequestLock()
|
|
}
|
|
if (!triggerEvent(elt, 'htmx:beforeRequest', responseInfo)) {
|
|
maybeCall(resolve)
|
|
endRequestLock()
|
|
return promise
|
|
}
|
|
var indicators = addRequestIndicatorClasses(elt)
|
|
var disableElts = disableElements(elt)
|
|
|
|
forEach(['loadstart', 'loadend', 'progress', 'abort'], function(eventName) {
|
|
forEach([xhr, xhr.upload], function(target) {
|
|
target.addEventListener(eventName, function(event) {
|
|
triggerEvent(elt, 'htmx:xhr:' + eventName, {
|
|
lengthComputable: event.lengthComputable,
|
|
loaded: event.loaded,
|
|
total: event.total
|
|
})
|
|
})
|
|
})
|
|
})
|
|
triggerEvent(elt, 'htmx:beforeSend', responseInfo)
|
|
const params = useUrlParams ? null : encodeParamsForBody(xhr, elt, filteredFormData)
|
|
xhr.send(params)
|
|
return promise
|
|
}
|
|
|
|
/**
|
|
* @typedef {Object} HtmxHistoryUpdate
|
|
* @property {string|null} [type]
|
|
* @property {string|null} [path]
|
|
*/
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {HtmxResponseInfo} responseInfo
|
|
* @return {HtmxHistoryUpdate}
|
|
*/
|
|
function determineHistoryUpdates(elt, responseInfo) {
|
|
const xhr = responseInfo.xhr
|
|
|
|
//= ==========================================
|
|
// First consult response headers
|
|
//= ==========================================
|
|
let pathFromHeaders = null
|
|
let typeFromHeaders = null
|
|
if (hasHeader(xhr, 'HX-Push')) {
|
|
pathFromHeaders = xhr.getResponseHeader('HX-Push')
|
|
typeFromHeaders = 'push'
|
|
} else if (hasHeader(xhr, 'HX-Push-Url')) {
|
|
pathFromHeaders = xhr.getResponseHeader('HX-Push-Url')
|
|
typeFromHeaders = 'push'
|
|
} else if (hasHeader(xhr, 'HX-Replace-Url')) {
|
|
pathFromHeaders = xhr.getResponseHeader('HX-Replace-Url')
|
|
typeFromHeaders = 'replace'
|
|
}
|
|
|
|
// if there was a response header, that has priority
|
|
if (pathFromHeaders) {
|
|
if (pathFromHeaders === 'false') {
|
|
return {}
|
|
} else {
|
|
return {
|
|
type: typeFromHeaders,
|
|
path: pathFromHeaders
|
|
}
|
|
}
|
|
}
|
|
|
|
//= ==========================================
|
|
// Next resolve via DOM values
|
|
//= ==========================================
|
|
const requestPath = responseInfo.pathInfo.finalRequestPath
|
|
const responsePath = responseInfo.pathInfo.responsePath
|
|
|
|
const pushUrl = responseInfo.etc.push || getClosestAttributeValue(elt, 'hx-push-url')
|
|
let replaceUrl = responseInfo.etc.replace || getClosestAttributeValue(elt, 'hx-replace-url')
|
|
if (replaceUrl === 'false') replaceUrl = null
|
|
const elementIsBoosted = getInternalData(elt).boosted
|
|
|
|
let saveType = null
|
|
let path = null
|
|
|
|
if (pushUrl) {
|
|
saveType = 'push'
|
|
path = pushUrl
|
|
} else if (replaceUrl) {
|
|
saveType = 'replace'
|
|
path = replaceUrl
|
|
} else if (elementIsBoosted) {
|
|
saveType = 'push'
|
|
path = responsePath || requestPath // if there is no response path, go with the original request path
|
|
}
|
|
|
|
if (path) {
|
|
// false indicates no push, return empty object
|
|
if (path === 'false') {
|
|
return {}
|
|
}
|
|
|
|
// true indicates we want to follow wherever the server ended up sending us
|
|
if (path === 'true') {
|
|
path = responsePath || requestPath // if there is no response path, go with the original request path
|
|
}
|
|
|
|
// restore any anchor associated with the request
|
|
if (responseInfo.pathInfo.anchor && path.indexOf('#') === -1) {
|
|
path = path + '#' + responseInfo.pathInfo.anchor
|
|
}
|
|
|
|
return {
|
|
type: saveType,
|
|
path
|
|
}
|
|
} else {
|
|
return {}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {HtmxResponseHandlingConfig} responseHandlingConfig
|
|
* @param {number} status
|
|
* @return {boolean}
|
|
*/
|
|
function codeMatches(responseHandlingConfig, status) {
|
|
var regExp = new RegExp(responseHandlingConfig.code)
|
|
return regExp.test(status.toString(10))
|
|
}
|
|
|
|
/**
|
|
* @param {XMLHttpRequest} xhr
|
|
* @return {HtmxResponseHandlingConfig}
|
|
*/
|
|
function resolveResponseHandling(xhr) {
|
|
for (var i = 0; i < htmx.config.responseHandling.length; i++) {
|
|
/** @type HtmxResponseHandlingConfig */
|
|
var responseHandlingElement = htmx.config.responseHandling[i]
|
|
if (codeMatches(responseHandlingElement, xhr.status)) {
|
|
return responseHandlingElement
|
|
}
|
|
}
|
|
// no matches, return no swap
|
|
return {
|
|
swap: false
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {string} title
|
|
*/
|
|
function handleTitle(title) {
|
|
if (title) {
|
|
const titleElt = find('title')
|
|
if (titleElt) {
|
|
titleElt.textContent = title
|
|
} else {
|
|
window.document.title = title
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Resove the Retarget selector and throw if not found
|
|
* @param {Element} elt
|
|
* @param {String} target
|
|
* @returns {Element}
|
|
*/
|
|
function resolveRetarget(elt, target) {
|
|
if (target === 'this') {
|
|
return elt
|
|
}
|
|
const resolvedTarget = asElement(querySelectorExt(elt, target))
|
|
if (resolvedTarget == null) {
|
|
triggerErrorEvent(elt, 'htmx:targetError', { target })
|
|
throw new Error(`Invalid re-target ${target}`)
|
|
}
|
|
return resolvedTarget
|
|
}
|
|
|
|
/**
|
|
* @param {Element} elt
|
|
* @param {HtmxResponseInfo} responseInfo
|
|
*/
|
|
function handleAjaxResponse(elt, responseInfo) {
|
|
const xhr = responseInfo.xhr
|
|
let target = responseInfo.target
|
|
const etc = responseInfo.etc
|
|
const responseInfoSelect = responseInfo.select
|
|
|
|
if (!triggerEvent(elt, 'htmx:beforeOnLoad', responseInfo)) return
|
|
|
|
if (hasHeader(xhr, 'HX-Trigger')) {
|
|
handleTriggerHeader(xhr, 'HX-Trigger', elt)
|
|
}
|
|
|
|
if (hasHeader(xhr, 'HX-Location')) {
|
|
let redirectPath = xhr.getResponseHeader('HX-Location')
|
|
/** @type {HtmxAjaxHelperContext&{path?:string}} */
|
|
var redirectSwapSpec = {}
|
|
if (redirectPath.indexOf('{') === 0) {
|
|
redirectSwapSpec = parseJSON(redirectPath)
|
|
// what's the best way to throw an error if the user didn't include this
|
|
redirectPath = redirectSwapSpec.path
|
|
delete redirectSwapSpec.path
|
|
}
|
|
redirectSwapSpec.push = redirectSwapSpec.push ?? 'true'
|
|
ajaxHelper('get', redirectPath, redirectSwapSpec)
|
|
return
|
|
}
|
|
|
|
const shouldRefresh = hasHeader(xhr, 'HX-Refresh') && xhr.getResponseHeader('HX-Refresh') === 'true'
|
|
|
|
if (hasHeader(xhr, 'HX-Redirect')) {
|
|
responseInfo.keepIndicators = true
|
|
htmx.location.href = xhr.getResponseHeader('HX-Redirect')
|
|
shouldRefresh && htmx.location.reload()
|
|
return
|
|
}
|
|
|
|
if (shouldRefresh) {
|
|
responseInfo.keepIndicators = true
|
|
htmx.location.reload()
|
|
return
|
|
}
|
|
|
|
const historyUpdate = determineHistoryUpdates(elt, responseInfo)
|
|
|
|
const responseHandling = resolveResponseHandling(xhr)
|
|
const shouldSwap = responseHandling.swap
|
|
let isError = !!responseHandling.error
|
|
let ignoreTitle = htmx.config.ignoreTitle || responseHandling.ignoreTitle
|
|
let selectOverride = responseHandling.select
|
|
if (responseHandling.target) {
|
|
responseInfo.target = resolveRetarget(elt, responseHandling.target)
|
|
}
|
|
var swapOverride = etc.swapOverride
|
|
if (swapOverride == null && responseHandling.swapOverride) {
|
|
swapOverride = responseHandling.swapOverride
|
|
}
|
|
|
|
// response headers override response handling config
|
|
if (hasHeader(xhr, 'HX-Retarget')) {
|
|
responseInfo.target = resolveRetarget(elt, xhr.getResponseHeader('HX-Retarget'))
|
|
}
|
|
|
|
if (hasHeader(xhr, 'HX-Reswap')) {
|
|
swapOverride = xhr.getResponseHeader('HX-Reswap')
|
|
}
|
|
|
|
var serverResponse = xhr.response
|
|
/** @type HtmxBeforeSwapDetails */
|
|
var beforeSwapDetails = mergeObjects({
|
|
shouldSwap,
|
|
serverResponse,
|
|
isError,
|
|
ignoreTitle,
|
|
selectOverride,
|
|
swapOverride
|
|
}, responseInfo)
|
|
|
|
if (responseHandling.event && !triggerEvent(target, responseHandling.event, beforeSwapDetails)) return
|
|
|
|
if (!triggerEvent(target, 'htmx:beforeSwap', beforeSwapDetails)) return
|
|
|
|
target = beforeSwapDetails.target // allow re-targeting
|
|
serverResponse = beforeSwapDetails.serverResponse // allow updating content
|
|
isError = beforeSwapDetails.isError // allow updating error
|
|
ignoreTitle = beforeSwapDetails.ignoreTitle // allow updating ignoring title
|
|
selectOverride = beforeSwapDetails.selectOverride // allow updating select override
|
|
swapOverride = beforeSwapDetails.swapOverride // allow updating swap override
|
|
|
|
responseInfo.target = target // Make updated target available to response events
|
|
responseInfo.failed = isError // Make failed property available to response events
|
|
responseInfo.successful = !isError // Make successful property available to response events
|
|
|
|
if (beforeSwapDetails.shouldSwap) {
|
|
if (xhr.status === 286) {
|
|
cancelPolling(elt)
|
|
}
|
|
|
|
withExtensions(elt, function(extension) {
|
|
serverResponse = extension.transformResponse(serverResponse, xhr, elt)
|
|
})
|
|
|
|
// Save current page if there will be a history update
|
|
if (historyUpdate.type) {
|
|
saveCurrentPageToHistory()
|
|
}
|
|
|
|
var swapSpec = getSwapSpecification(elt, swapOverride)
|
|
|
|
if (!swapSpec.hasOwnProperty('ignoreTitle')) {
|
|
swapSpec.ignoreTitle = ignoreTitle
|
|
}
|
|
|
|
addClassToElement(target, htmx.config.swappingClass)
|
|
|
|
if (responseInfoSelect) {
|
|
selectOverride = responseInfoSelect
|
|
}
|
|
|
|
if (hasHeader(xhr, 'HX-Reselect')) {
|
|
selectOverride = xhr.getResponseHeader('HX-Reselect')
|
|
}
|
|
|
|
const selectOOB = etc.selectOOB || getClosestAttributeValue(elt, 'hx-select-oob')
|
|
const select = getClosestAttributeValue(elt, 'hx-select')
|
|
|
|
swap(target, serverResponse, swapSpec, {
|
|
select: selectOverride === 'unset' ? null : selectOverride || select,
|
|
selectOOB,
|
|
eventInfo: responseInfo,
|
|
anchor: responseInfo.pathInfo.anchor,
|
|
contextElement: elt,
|
|
afterSwapCallback: function() {
|
|
if (hasHeader(xhr, 'HX-Trigger-After-Swap')) {
|
|
let finalElt = elt
|
|
if (!bodyContains(elt)) {
|
|
finalElt = getDocument().body
|
|
}
|
|
handleTriggerHeader(xhr, 'HX-Trigger-After-Swap', finalElt)
|
|
}
|
|
},
|
|
afterSettleCallback: function() {
|
|
if (hasHeader(xhr, 'HX-Trigger-After-Settle')) {
|
|
let finalElt = elt
|
|
if (!bodyContains(elt)) {
|
|
finalElt = getDocument().body
|
|
}
|
|
handleTriggerHeader(xhr, 'HX-Trigger-After-Settle', finalElt)
|
|
}
|
|
},
|
|
beforeSwapCallback: function() {
|
|
// if we need to save history, do so, before swapping so that relative resources have the correct base URL
|
|
if (historyUpdate.type) {
|
|
triggerEvent(getDocument().body, 'htmx:beforeHistoryUpdate', mergeObjects({ history: historyUpdate }, responseInfo))
|
|
if (historyUpdate.type === 'push') {
|
|
pushUrlIntoHistory(historyUpdate.path)
|
|
triggerEvent(getDocument().body, 'htmx:pushedIntoHistory', { path: historyUpdate.path })
|
|
} else {
|
|
replaceUrlInHistory(historyUpdate.path)
|
|
triggerEvent(getDocument().body, 'htmx:replacedInHistory', { path: historyUpdate.path })
|
|
}
|
|
}
|
|
}
|
|
})
|
|
}
|
|
if (isError) {
|
|
triggerErrorEvent(elt, 'htmx:responseError', mergeObjects({ error: 'Response Status Error Code ' + xhr.status + ' from ' + responseInfo.pathInfo.requestPath }, responseInfo))
|
|
}
|
|
}
|
|
|
|
//= ===================================================================
|
|
// Extensions API
|
|
//= ===================================================================
|
|
|
|
/** @type {Object<string, HtmxExtension>} */
|
|
const extensions = {}
|
|
|
|
/**
|
|
* extensionBase defines the default functions for all extensions.
|
|
* @returns {HtmxExtension}
|
|
*/
|
|
function extensionBase() {
|
|
return {
|
|
init: function(api) { return null },
|
|
getSelectors: function() { return null },
|
|
onEvent: function(name, evt) { return true },
|
|
transformResponse: function(text, xhr, elt) { return text },
|
|
isInlineSwap: function(swapStyle) { return false },
|
|
handleSwap: function(swapStyle, target, fragment, settleInfo) { return false },
|
|
encodeParameters: function(xhr, parameters, elt) { return null }
|
|
}
|
|
}
|
|
|
|
/**
|
|
* defineExtension initializes the extension and adds it to the htmx registry
|
|
*
|
|
* @see https://htmx.org/api/#defineExtension
|
|
*
|
|
* @param {string} name the extension name
|
|
* @param {Partial<HtmxExtension>} extension the extension definition
|
|
*/
|
|
function defineExtension(name, extension) {
|
|
if (extension.init) {
|
|
extension.init(internalAPI)
|
|
}
|
|
extensions[name] = mergeObjects(extensionBase(), extension)
|
|
}
|
|
|
|
/**
|
|
* removeExtension removes an extension from the htmx registry
|
|
*
|
|
* @see https://htmx.org/api/#removeExtension
|
|
*
|
|
* @param {string} name
|
|
*/
|
|
function removeExtension(name) {
|
|
delete extensions[name]
|
|
}
|
|
|
|
/**
|
|
* getExtensions searches up the DOM tree to return all extensions that can be applied to a given element
|
|
*
|
|
* @param {Element} elt
|
|
* @param {HtmxExtension[]=} extensionsToReturn
|
|
* @param {string[]=} extensionsToIgnore
|
|
* @returns {HtmxExtension[]}
|
|
*/
|
|
function getExtensions(elt, extensionsToReturn, extensionsToIgnore) {
|
|
if (extensionsToReturn == undefined) {
|
|
extensionsToReturn = []
|
|
}
|
|
if (elt == undefined) {
|
|
return extensionsToReturn
|
|
}
|
|
if (extensionsToIgnore == undefined) {
|
|
extensionsToIgnore = []
|
|
}
|
|
const extensionsForElement = getAttributeValue(elt, 'hx-ext')
|
|
if (extensionsForElement) {
|
|
forEach(extensionsForElement.split(','), function(extensionName) {
|
|
extensionName = extensionName.replace(/ /g, '')
|
|
if (extensionName.slice(0, 7) == 'ignore:') {
|
|
extensionsToIgnore.push(extensionName.slice(7))
|
|
return
|
|
}
|
|
if (extensionsToIgnore.indexOf(extensionName) < 0) {
|
|
const extension = extensions[extensionName]
|
|
if (extension && extensionsToReturn.indexOf(extension) < 0) {
|
|
extensionsToReturn.push(extension)
|
|
}
|
|
}
|
|
})
|
|
}
|
|
return getExtensions(asElement(parentElt(elt)), extensionsToReturn, extensionsToIgnore)
|
|
}
|
|
|
|
//= ===================================================================
|
|
// Initialization
|
|
//= ===================================================================
|
|
var isReady = false
|
|
getDocument().addEventListener('DOMContentLoaded', function() {
|
|
isReady = true
|
|
})
|
|
|
|
/**
|
|
* Execute a function now if DOMContentLoaded has fired, otherwise listen for it.
|
|
*
|
|
* This function uses isReady because there is no reliable way to ask the browser whether
|
|
* the DOMContentLoaded event has already been fired; there's a gap between DOMContentLoaded
|
|
* firing and readystate=complete.
|
|
*/
|
|
function ready(fn) {
|
|
// Checking readyState here is a failsafe in case the htmx script tag entered the DOM by
|
|
// some means other than the initial page load.
|
|
if (isReady || getDocument().readyState === 'complete') {
|
|
fn()
|
|
} else {
|
|
getDocument().addEventListener('DOMContentLoaded', fn)
|
|
}
|
|
}
|
|
|
|
function insertIndicatorStyles() {
|
|
if (htmx.config.includeIndicatorStyles !== false) {
|
|
const nonceAttribute = htmx.config.inlineStyleNonce ? ` nonce="${htmx.config.inlineStyleNonce}"` : ''
|
|
const indicator = htmx.config.indicatorClass
|
|
const request = htmx.config.requestClass
|
|
getDocument().head.insertAdjacentHTML('beforeend',
|
|
`<style${nonceAttribute}>` +
|
|
`.${indicator}{opacity:0;visibility: hidden} ` +
|
|
`.${request} .${indicator}, .${request}.${indicator}{opacity:1;visibility: visible;transition: opacity 200ms ease-in}` +
|
|
'</style>'
|
|
)
|
|
}
|
|
}
|
|
|
|
function getMetaConfig() {
|
|
/** @type HTMLMetaElement */
|
|
const element = getDocument().querySelector('meta[name="htmx-config"]')
|
|
if (element) {
|
|
return parseJSON(element.content)
|
|
} else {
|
|
return null
|
|
}
|
|
}
|
|
|
|
function mergeMetaConfig() {
|
|
const metaConfig = getMetaConfig()
|
|
if (metaConfig) {
|
|
htmx.config = mergeObjects(htmx.config, metaConfig)
|
|
}
|
|
}
|
|
|
|
// initialize the document
|
|
ready(function() {
|
|
mergeMetaConfig()
|
|
insertIndicatorStyles()
|
|
let body = getDocument().body
|
|
processNode(body)
|
|
const restoredElts = getDocument().querySelectorAll(
|
|
"[hx-trigger='restored'],[data-hx-trigger='restored']"
|
|
)
|
|
body.addEventListener('htmx:abort', function(evt) {
|
|
const target = (/** @type {CustomEvent} */(evt)).detail.elt || evt.target
|
|
const internalData = getInternalData(target)
|
|
if (internalData && internalData.xhr) {
|
|
internalData.xhr.abort()
|
|
}
|
|
})
|
|
/** @type {(ev: PopStateEvent) => any} */
|
|
const originalPopstate = window.onpopstate ? window.onpopstate.bind(window) : null
|
|
/** @type {(ev: PopStateEvent) => any} */
|
|
window.onpopstate = function(event) {
|
|
if (event.state && event.state.htmx) {
|
|
restoreHistory()
|
|
forEach(restoredElts, function(elt) {
|
|
triggerEvent(elt, 'htmx:restored', {
|
|
document: getDocument(),
|
|
triggerEvent
|
|
})
|
|
})
|
|
} else {
|
|
if (originalPopstate) {
|
|
originalPopstate(event)
|
|
}
|
|
}
|
|
}
|
|
getWindow().setTimeout(function() {
|
|
triggerEvent(body, 'htmx:load', {}) // give ready handlers a chance to load up before firing this event
|
|
body = null // kill reference for gc
|
|
}, 0)
|
|
})
|
|
|
|
return htmx
|
|
})()
|
|
|
|
/** @typedef {'get'|'head'|'post'|'put'|'delete'|'connect'|'options'|'trace'|'patch'} HttpVerb */
|
|
|
|
/**
|
|
* @typedef {Object} SwapOptions
|
|
* @property {string} [select]
|
|
* @property {string} [selectOOB]
|
|
* @property {*} [eventInfo]
|
|
* @property {string} [anchor]
|
|
* @property {Element} [contextElement]
|
|
* @property {swapCallback} [afterSwapCallback]
|
|
* @property {swapCallback} [afterSettleCallback]
|
|
* @property {swapCallback} [beforeSwapCallback]
|
|
* @property {string} [title]
|
|
* @property {boolean} [historyRequest]
|
|
*/
|
|
|
|
/**
|
|
* @callback swapCallback
|
|
*/
|
|
|
|
/**
|
|
* @typedef {'innerHTML' | 'outerHTML' | 'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend' | 'delete' | 'none' | string} HtmxSwapStyle
|
|
*/
|
|
|
|
/**
|
|
* @typedef HtmxSwapSpecification
|
|
* @property {HtmxSwapStyle} swapStyle
|
|
* @property {number} swapDelay
|
|
* @property {number} settleDelay
|
|
* @property {boolean} [transition]
|
|
* @property {boolean} [ignoreTitle]
|
|
* @property {string} [head]
|
|
* @property {'top' | 'bottom' | number } [scroll]
|
|
* @property {string} [scrollTarget]
|
|
* @property {string} [show]
|
|
* @property {string} [showTarget]
|
|
* @property {boolean} [focusScroll]
|
|
*/
|
|
|
|
/**
|
|
* @typedef {((this:Node, evt:Event) => boolean) & {source: string}} ConditionalFunction
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} HtmxTriggerSpecification
|
|
* @property {string} trigger
|
|
* @property {number} [pollInterval]
|
|
* @property {ConditionalFunction} [eventFilter]
|
|
* @property {boolean} [changed]
|
|
* @property {boolean} [once]
|
|
* @property {boolean} [consume]
|
|
* @property {number} [delay]
|
|
* @property {string} [from]
|
|
* @property {string} [target]
|
|
* @property {number} [throttle]
|
|
* @property {string} [queue]
|
|
* @property {string} [root]
|
|
* @property {string} [threshold]
|
|
*/
|
|
|
|
/**
|
|
* @typedef {{elt: Element, message: string, validity: ValidityState}} HtmxElementValidationError
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Record<string, string>} HtmxHeaderSpecification
|
|
* @property {'true'} HX-Request
|
|
* @property {string|null} HX-Trigger
|
|
* @property {string|null} HX-Trigger-Name
|
|
* @property {string|null} HX-Target
|
|
* @property {string} HX-Current-URL
|
|
* @property {string} [HX-Prompt]
|
|
* @property {'true'} [HX-Boosted]
|
|
* @property {string} [Content-Type]
|
|
* @property {'true'} [HX-History-Restore-Request]
|
|
*/
|
|
|
|
/**
|
|
* @typedef HtmxAjaxHelperContext
|
|
* @property {Element|string} [source]
|
|
* @property {Event} [event]
|
|
* @property {HtmxAjaxHandler} [handler]
|
|
* @property {Element|string} [target]
|
|
* @property {HtmxSwapStyle} [swap]
|
|
* @property {Object|FormData} [values]
|
|
* @property {Record<string,string>} [headers]
|
|
* @property {string} [select]
|
|
* @property {string} [push]
|
|
* @property {string} [replace]
|
|
* @property {string} [selectOOB]
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} HtmxRequestConfig
|
|
* @property {boolean} boosted
|
|
* @property {boolean} useUrlParams
|
|
* @property {FormData} formData
|
|
* @property {Object} parameters formData proxy
|
|
* @property {FormData} unfilteredFormData
|
|
* @property {Object} unfilteredParameters unfilteredFormData proxy
|
|
* @property {HtmxHeaderSpecification} headers
|
|
* @property {Element} elt
|
|
* @property {Element} target
|
|
* @property {HttpVerb} verb
|
|
* @property {HtmxElementValidationError[]} errors
|
|
* @property {boolean} withCredentials
|
|
* @property {number} timeout
|
|
* @property {string} path
|
|
* @property {Event} triggeringEvent
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} HtmxResponseInfo
|
|
* @property {XMLHttpRequest} xhr
|
|
* @property {Element} target
|
|
* @property {HtmxRequestConfig} requestConfig
|
|
* @property {HtmxAjaxEtc} etc
|
|
* @property {boolean} boosted
|
|
* @property {string} select
|
|
* @property {{requestPath: string, finalRequestPath: string, responsePath: string|null, anchor: string}} pathInfo
|
|
* @property {boolean} [failed]
|
|
* @property {boolean} [successful]
|
|
* @property {boolean} [keepIndicators]
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} HtmxAjaxEtc
|
|
* @property {boolean} [returnPromise]
|
|
* @property {HtmxAjaxHandler} [handler]
|
|
* @property {string} [select]
|
|
* @property {Element} [targetOverride]
|
|
* @property {HtmxSwapStyle} [swapOverride]
|
|
* @property {Record<string,string>} [headers]
|
|
* @property {Object|FormData} [values]
|
|
* @property {boolean} [credentials]
|
|
* @property {number} [timeout]
|
|
* @property {string} [push]
|
|
* @property {string} [replace]
|
|
* @property {string} [selectOOB]
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} HtmxResponseHandlingConfig
|
|
* @property {string} [code]
|
|
* @property {boolean} swap
|
|
* @property {boolean} [error]
|
|
* @property {boolean} [ignoreTitle]
|
|
* @property {string} [select]
|
|
* @property {string} [target]
|
|
* @property {string} [swapOverride]
|
|
* @property {string} [event]
|
|
*/
|
|
|
|
/**
|
|
* @typedef {HtmxResponseInfo & {shouldSwap: boolean, serverResponse: any, isError: boolean, ignoreTitle: boolean, selectOverride:string, swapOverride:string}} HtmxBeforeSwapDetails
|
|
*/
|
|
|
|
/**
|
|
* @callback HtmxAjaxHandler
|
|
* @param {Element} elt
|
|
* @param {HtmxResponseInfo} responseInfo
|
|
*/
|
|
|
|
/**
|
|
* @typedef {(() => void)} HtmxSettleTask
|
|
*/
|
|
|
|
/**
|
|
* @typedef {Object} HtmxSettleInfo
|
|
* @property {HtmxSettleTask[]} tasks
|
|
* @property {Element[]} elts
|
|
* @property {string} [title]
|
|
*/
|
|
|
|
/**
|
|
* @see https://github.com/bigskysoftware/htmx-extensions/blob/main/README.md
|
|
* @typedef {Object} HtmxExtension
|
|
* @property {(api: any) => void} init
|
|
* @property {(name: string, event: CustomEvent) => boolean} onEvent
|
|
* @property {(text: string, xhr: XMLHttpRequest, elt: Element) => string} transformResponse
|
|
* @property {(swapStyle: HtmxSwapStyle) => boolean} isInlineSwap
|
|
* @property {(swapStyle: HtmxSwapStyle, target: Node, fragment: Node, settleInfo: HtmxSettleInfo) => boolean|Node[]} handleSwap
|
|
* @property {(xhr: XMLHttpRequest, parameters: FormData, elt: Node) => *|string|null} encodeParameters
|
|
* @property {() => string[]|null} getSelectors
|
|
*/
|