lisn.js
Version:
Simply handle user gestures and actions. Includes widgets.
184 lines (181 loc) • 7.79 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.SetAttribute = void 0;
var MC = _interopRequireWildcard(require("../globals/minification-constants.cjs"));
var MH = _interopRequireWildcard(require("../globals/minification-helpers.cjs"));
var _domOptimize = require("../utils/dom-optimize.cjs");
var _text = require("../utils/text.cjs");
var _validation = require("../utils/validation.cjs");
var _action = require("./action.cjs");
function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
* @module Actions
*
* @categoryDescription Setting/deleting attributes
* {@link SetAttribute} sets or deletes an attribute on the given element.
*/
/**
* Either sets or deletes an attribute, or toggles between two values of an
* attribute, on the given element.
*
* **IMPORTANT:** When constructed, it sets all given attributes on the
* element to their _OFF_ (undone) state as a form of initialization.
*
* -------
*
* To use with auto-widgets (HTML API) as part of a trigger specification:
* - Action name: "set-attribute".
* - Arguments (required): name of attribute
* - Options (at least one required):
* - `on`: A string value for the attribute. Can be blank. Omit this option
* in order to have the attribute deleted when the action is done.
* - `off`: A string value for the attribute. Can be blank. Omit this option
* in order to have the attribute deleted when the action is undone.
*
* Note that with the HTML API you can only specify one attribute per action.
* But of course you can add the same action multiple times per trigger. See
* examples below.
*
* @example
* This is an overview of the various combinations that you can use to set an
* attribute to a non-empty value, a blank value or delete the attribute when
* the action is either done or undone:
*
* | Specification | Value when done | Value when undone |
* | ------------------------------------- | --------------- | ----------------- |
* | @set-attr: attr, on=onVal, off=offVal | "onVal" | "offVal" |
* | @set-attr: attr, on=value | "value" | _deleted_ |
* | @set-attr: attr, off=value | _deleted_ | "value" |
* | @set-attr: attr, on= | "" | _deleted_ |
* | @set-attr: attr, off= | _deleted_ | "" |
* | @set-attr: attr, on=value, off= | "value" | "" |
* | @set-attr: attr, on= , off=value | "" | "value" |
*
* @example
* This will set attribute `attrA` to `valueA-ON` and `attrB` to `valueB-ON`
* when the element enters the viewport and set `attrA` to `valueA-OFF` and
* `attrB` to `valueB-OFF` when it leaves the viewport.
*
* ```html
* <div data-lisn-on-view="@set-attribute: attrA, on=valueA-ON, off=valueA-OFF
* @set-attribute: attrB, on=valueB-ON, off=valueB-OFF"
* ></div>
* ```
*
* @example
* This will set attribute `attr` to `value` when the element enters the
* viewport and _delete_ the attribute when it leaves the viewport.
*
* ```html
* <div data-lisn-on-view="@set-attribute: attr, on=value"></div>
* ```
*
* @example
* This will _delete_ attribute `attr` when the element enters the viewport and
* set it to `value` when it leaves the viewport.
*
* ```html
* <div data-lisn-on-view="@set-attribute: attr, off=value"></div>
* ```
*
* @example
* This will set attribute `attr` to a blank value when the element enters the
* viewport and _delete_ the attribute when it leaves the viewport.
*
* ```html
* <div data-lisn-on-view="@set-attribute: attr, on="></div>
* ```
*
* @example
* This will _delete_ attribute `attr` when the element enters the viewport and
* set it to a blank value when it leaves the viewport.
*
* ```html
* <div data-lisn-on-view="@set-attribute: attr, off="></div>
* ```
*
* @example
* This will set attribute `attr` to `value` when the element enters the
* viewport and set it to a blank value when it leaves the viewport.
*
* ```html
* <div data-lisn-on-view="@set-attribute: attr, on=value, off="></div>
* ```
*
* @example
* This will set attribute `attr` to a blank value when the element enters the
* viewport and set it to `value` when it leaves the viewport.
*
* ```html
* <div data-lisn-on-view="@set-attribute: attr, on=, off=value"></div>
* ```
*
* @category Setting/deleting attributes
*/
class SetAttribute {
static register() {
(0, _action.registerAction)("set-attribute", (element, args, config) => {
return new SetAttribute(element, {
[args[0]]: config !== null && config !== void 0 ? config : {}
});
}, configValidator);
}
constructor(element, attributes) {
/**
* Sets the attribute to its "ON" value, or deletes it if that value is null.
*/
_defineProperty(this, "do", void 0);
/**
* Sets the attribute to its "OFF" value, or deletes it if that value is null.
*/
_defineProperty(this, "undo", void 0);
/**
* Toggles the attribute from its "ON" to "OFF" value or vice versa.
*/
_defineProperty(this, "toggle", void 0);
if (!attributes) {
throw MH.usageError("Attributes are required");
}
let isOn = false;
const setAttrs = async on => {
isOn = on;
await (0, _domOptimize.waitForMutateTime)();
for (const attr in attributes) {
const value = attributes[attr][on ? "on" : "off"];
const attrName = (0, _text.camelToKebabCase)(attr);
if (MH.isNullish(value)) {
MH.delAttr(element, attrName);
} else {
MH.setAttr(element, attrName, value);
}
}
};
this.do = () => setAttrs(true);
this.undo = () => setAttrs(false);
this[MC.S_TOGGLE] = () => setAttrs(!isOn);
this.undo(); // initial state
}
}
/**
* Each key in the object is an attribute name. The `on` value is set when the
* action is done and the `off` value is set when the action is undone. To set
* the attribute to an empty value, use an empty string. To _delete_ the
* attribute, use `null` as the value or simply omit the relevant `on` or `off`
* key.
*
* **IMPORTANT:** Attribute names in camelCase are converted to kebab-case.
* E.g. `dataFooBar` will translate to `data-foo-bar`.
*
* @category Setting/deleting attributes
*/
exports.SetAttribute = SetAttribute;
// --------------------
const configValidator = {
on: _validation.validateString,
off: _validation.validateString
};
//# sourceMappingURL=set-attribute.cjs.map