@webqit/oohtml 3.1.16 → 3.1.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -6
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -202,7 +202,7 @@ If you'll be going ahead to build a real app with OOHTML, you may want to consid
|
|
|
202
202
|
|
|
203
203
|
Amidst a multitude of approaches, vanilla HTML remains an attractive option for the UI author! But the current authoring experience still leaves much to be desired in how the language lacks modularity, reusability, and certain modern paradigms like data binding! Authors still have to rely on tools - and, for the most part, have to do half of the work in HTML and half in JS - to express even basic concepts!
|
|
204
204
|
|
|
205
|
-
"As an author, I want to be able to do 'x' *declaratively* instead of *imperatively* in JavaScript or by means of a special Custom Element!" "As a Web Component author, I want to be able to leverage *conventions* that keep my component logic *concise*!" All such "user stories" represent important developer intuitions that has yet to be met in HTML; much of which belong under a broad subject: an object-oriented markup language! This subject is what we explore with OOHTML!
|
|
205
|
+
"As an author, I want to be able to do 'x' *declaratively* in HTML instead of *imperatively* in JavaScript or by means of a special Custom Element!" "As a Web Component author, I want to be able to leverage *conventions* that keep my component logic *concise*!" All such "user stories" represent important developer intuitions that has yet to be met in HTML; much of which belong under a broad subject: an object-oriented markup language! This subject is what we explore with OOHTML!
|
|
206
206
|
|
|
207
207
|
OOHTML comes, not as a specific technology, but as a conceptual "framework" of features that solves for HTML as an object-oriented language - whether that means re-aligning existing features or introducing new ones! While features may be discussed or explored individually, the one agenda "Object-Oriented HTML" helps us stay aligned with the original problem! Each of these features has been introduced below with a small explainer.
|
|
208
208
|
|
|
@@ -219,7 +219,7 @@ OOHTML is effectively different from Web Components (and from the related Declar
|
|
|
219
219
|
|
|
220
220
|
## Modular HTML
|
|
221
221
|
|
|
222
|
-
Modular HTML is
|
|
222
|
+
Modular HTML is markup written as self-contained objects - wherein an element *encapsulates* their own structure, styling and logic!
|
|
223
223
|
|
|
224
224
|
OOHTML makes this possible by introducing "namespacing" and style and script scoping!
|
|
225
225
|
|
|
@@ -240,7 +240,7 @@ Here, we get a modular naming convention using the `namespace` attribute. This a
|
|
|
240
240
|
|
|
241
241
|
<label for="~city">City</label>
|
|
242
242
|
<input id="city">
|
|
243
|
-
|
|
243
|
+
<fieldset>
|
|
244
244
|
|
|
245
245
|
<fieldset namespace>
|
|
246
246
|
<legend>Delivery Address</legend>
|
|
@@ -250,14 +250,14 @@ Here, we get a modular naming convention using the `namespace` attribute. This a
|
|
|
250
250
|
|
|
251
251
|
<label for="~city">City</label>
|
|
252
252
|
<input id="city">
|
|
253
|
-
|
|
253
|
+
<fieldset>
|
|
254
254
|
|
|
255
255
|
</form>
|
|
256
256
|
```
|
|
257
257
|
|
|
258
|
-
This lets us have repeating structures with identical but non-conflicting identifiers. These identifiers are then referenced locally using "local
|
|
258
|
+
This lets us have repeating structures with identical but non-conflicting identifiers. These identifiers are then referenced locally using "local `IDREFS`" - denoted by the `~` prefix.
|
|
259
259
|
|
|
260
|
-
|
|
260
|
+
Local `IDREFS` are resolved within the namespace where they're used (not globally; not deeply):
|
|
261
261
|
|
|
262
262
|
```js
|
|
263
263
|
// Matches "#city" within the fieldset's namespace; not super namespace, not sub namespace
|
package/package.json
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
"wicg-proposal"
|
|
15
15
|
],
|
|
16
16
|
"homepage": "https://webqit.io/tooling/oohtml",
|
|
17
|
-
"version": "3.1.
|
|
17
|
+
"version": "3.1.17",
|
|
18
18
|
"license": "MIT",
|
|
19
19
|
"repository": {
|
|
20
20
|
"type": "git",
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
"test": "mocha --extension .test.js --exit",
|
|
31
31
|
"test:coverage": "c8 --reporter=text-lcov npm run test | coveralls",
|
|
32
32
|
"build": "esbuild main=src/api.global.js main.lite=src/api.global.lite.js context-api=src/context-api/targets.browser.js bindings-api=src/bindings-api/targets.browser.js namespaced-html=src/namespaced-html/targets.browser.js html-imports=src/html-imports/targets.browser.js data-binding=src/data-binding/targets.browser.js scoped-css=src/scoped-css/targets.browser.js scoped-js=src/scoped-js/targets.browser.js --bundle --minify --sourcemap --outdir=dist",
|
|
33
|
-
"preversion": "npm run
|
|
33
|
+
"preversion": "npm run build && git add -A dist",
|
|
34
34
|
"postversion": "npm publish",
|
|
35
35
|
"postpublish": "git push && git push --tags"
|
|
36
36
|
},
|