mirror of
https://github.com/odoo/owl.git
synced 2025-10-06 19:59:41 +07:00
Compare commits
5 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 38380b0b12 | |||
| 8986f06448 | |||
| 1a33d3d8e8 | |||
| 82ab18ad83 | |||
| c86bb6111a |
@@ -5,7 +5,7 @@ name: Node.js CI
|
|||||||
|
|
||||||
on:
|
on:
|
||||||
pull_request:
|
pull_request:
|
||||||
branches: [ master, owl-next ]
|
branches: [ master ]
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
build:
|
build:
|
||||||
@@ -24,4 +24,4 @@ jobs:
|
|||||||
node-version: ${{ matrix.node-version }}
|
node-version: ${{ matrix.node-version }}
|
||||||
- run: npm install
|
- run: npm install
|
||||||
- run: npm run test
|
- run: npm run test
|
||||||
- run: npm run check-formatting
|
- run: npm run prettier
|
||||||
|
|||||||
-612
@@ -1,612 +0,0 @@
|
|||||||
# Changelog
|
|
||||||
|
|
||||||
This document contains an overview of all changes between Owl 1.x and
|
|
||||||
Owl 2.x, with some pointers on how to update the code.
|
|
||||||
|
|
||||||
Note that some of these changes can be magically implemented (for example, by
|
|
||||||
patching the `setup` method of `Component` to auto register all the lifecycle
|
|
||||||
methods as hooks). This will be done for the transition period, but will be
|
|
||||||
removed after.
|
|
||||||
|
|
||||||
## Changes
|
|
||||||
|
|
||||||
**Components**
|
|
||||||
|
|
||||||
- components can now have empty content or multiple root nodes (htmlelement or text) ([details](#31-components-can-now-have-arbitrary-content))
|
|
||||||
- new `useEffect` hook
|
|
||||||
- new `onDestroyed`, `onWillRender` and `onRendered` hooks
|
|
||||||
- breaking: lifecycle methods are removed ([details](#1-component-lifecycle-methods-are-removed))
|
|
||||||
- breaking: can no longer be mounted on detached DOM ([details](#2-components-can-no-longer-be-mounted-in-a-detached-dom-element))
|
|
||||||
- breaking: standalone `mount` method API is simpler ([details](#4-mount-method-api-is-simpler))
|
|
||||||
- breaking: components can no longer be instantiated and mounted by hand ([details](#5-components-can-no-longer-be-instantiated-and-mounted-by-hand))
|
|
||||||
- breaking: components can no longer be unmounted/remounted ([details](#6-components-can-no-longer-be-unmountedremounted))
|
|
||||||
- breaking: template name is no longer inferred from the class name ([details](#7-template-name-is-no-longer-inferred-from-the-class-name))
|
|
||||||
- breaking: components no longer have a `shouldUpdate` method ([details](#8-components-no-longer-have-a-shouldupdate-method))
|
|
||||||
- breaking: component.el may be a text node, and is no longer `null` ([details](#9-componentel-may-be-a-text-node-and-is-no-longer-null))
|
|
||||||
- breaking: style/class on components are now regular props ([details](#10-styleclass-on-components-are-now-regular-props))
|
|
||||||
- breaking: components can no longer be mounted with position=self ([details](#11-components-can-no-longer-be-mounted-with-positionself))
|
|
||||||
- breaking: `t-on` does not work on components any more ([details](#12-t-on-does-not-work-on-components-any-more))
|
|
||||||
- breaking: `t-component` no longer accepts strings ([details](#17-t-component-no-longer-accepts-strings))
|
|
||||||
|
|
||||||
**Portal**
|
|
||||||
|
|
||||||
- portals can now have arbitrary content (no longer restricted to one single child)
|
|
||||||
- breaking: does no longer transfer dom events ([details](#13-portal-does-no-longer-transfer-dom-events))
|
|
||||||
- breaking: does render as an empty text node instead of `<portal/>` ([details](#14-portal-does-render-as-an-empty-text-node-instead-of-portal))
|
|
||||||
|
|
||||||
**Slots**
|
|
||||||
|
|
||||||
- breaking: `t-set` does not define a slot any more ([details](#3-t-set-will-no-longer-work-to-define-a-slot))
|
|
||||||
|
|
||||||
**Miscellaneous**
|
|
||||||
|
|
||||||
- improved performance
|
|
||||||
- much simpler code
|
|
||||||
- finer grained reactivity: owl 2 tracks change per key/component
|
|
||||||
- finer grained reactivity: sub components can reobserve state
|
|
||||||
- new App class to encapsulate a root Owl component (with the config for that application)
|
|
||||||
- new `Memo` component
|
|
||||||
- breaking: `Context` is removed ([details](#15-context-is-removed))
|
|
||||||
- breaking: `env` is now totally empty ([details](#16-env-is-now-totally-empty))
|
|
||||||
- breaking: most exports are exported at top level ([details](#18-most-exports-are-exported-at-top-level))
|
|
||||||
- breaking: properties are no longer set as attributes ([details](#19-properties-are-no-longer-set-as-attributes))
|
|
||||||
- breaking: `t-foreach` should always have a corresponding `t-key` ([details](#20-t-foreach-should-always-have-a-corresponding-t-key))
|
|
||||||
- breaking: `EventBus` api changed: it is now an `EventTarget` ([details](#21-eventbus-api-changed-it-is-now-an-eventtarget))
|
|
||||||
- breaking: `Store` is removed ([details](#22-store-is-removed))
|
|
||||||
- breaking: `Router` is removed ([details](#23-router-is-removed))
|
|
||||||
- breaking: transition system is removed ([details](#24-transition-system-is-removed))
|
|
||||||
- breaking: no more global components or templates ([details](#25-no-more-global-components-or-templates))
|
|
||||||
- breaking: `AsyncRoot` utility component is removed ([details](#26-asyncroot-utility-component-is-removed))
|
|
||||||
- breaking: `useSubEnv` only applies to child components ([details](#27-usesubenv-only-applies-to-child-components))
|
|
||||||
- breaking: `env` is now frozen ([details](#28-env-is-now-frozen))
|
|
||||||
- breaking: `t-ref` does not work on components ([details](#29-t-ref-does-not-work-on-component))
|
|
||||||
- breaking: `t-on` does not accept expressions, only functions ([details](#30-t-on-does-not-accept-expressions-only-functions))
|
|
||||||
- breaking: `renderToString` function on qweb has been removed ([details](#32-rendertostring-on-qweb-has-been-removed))
|
|
||||||
|
|
||||||
|
|
||||||
## Details/Rationale/Migration
|
|
||||||
|
|
||||||
All changes are listed in no particular order.
|
|
||||||
|
|
||||||
### 1. component lifecycle methods are removed
|
|
||||||
|
|
||||||
There was two ways to define hooks: the component methods (`willStart`, `mounted`, ...) and the hooks (`onWillStart`, `onMounted`, ...). In Owl 2, the component methods have been removed.
|
|
||||||
|
|
||||||
Rationale: it makes the implementation simpler and slightly faster. Hooks are more composable
|
|
||||||
than component methods. It enforces a single entry point to check all the useful lifecycle
|
|
||||||
calls (instead of it being scattered in the component definition). It feels more "modern".
|
|
||||||
|
|
||||||
Migration: lifecycle methods should be defined in the `setup`:
|
|
||||||
|
|
||||||
```js
|
|
||||||
class MyComponent extends Component {
|
|
||||||
mounted() {
|
|
||||||
// do something
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
should become:
|
|
||||||
```js
|
|
||||||
class MyComponent extends Component {
|
|
||||||
setup() {
|
|
||||||
onMounted(() => {
|
|
||||||
// do something
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2. components can no longer be mounted in a detached dom element
|
|
||||||
|
|
||||||
Nor document fragment.
|
|
||||||
|
|
||||||
Rationale: it is actually very difficult to do it: this implies that a component
|
|
||||||
can be mounted more than once, that we need to check every time different status,
|
|
||||||
that some elements is in the dom, and was a cause for bugs. Also, we don't use it
|
|
||||||
in practice. Removing this means that we have a much simpler mental model of what
|
|
||||||
happens.
|
|
||||||
|
|
||||||
Migration: well, not really easy. The code needs to be refactored in a different way.
|
|
||||||
|
|
||||||
|
|
||||||
### 3. **`t-set` will no longer work to define a slot**
|
|
||||||
|
|
||||||
The `t-set` directive cannot define a slot anymore. Only the `t-set-slot` directive
|
|
||||||
can do it.
|
|
||||||
|
|
||||||
Rationale: it was left for compatibility reason, but was deprecated anyway.
|
|
||||||
|
|
||||||
Migration: `t-set` should be changed to `t-set-slot` (when defining a slot)
|
|
||||||
|
|
||||||
Example:
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<SideBar><t t-set="content">content</t></SideBar>
|
|
||||||
```
|
|
||||||
should become:
|
|
||||||
```xml
|
|
||||||
<SideBar><t t-set-slot="content">content</t></SideBar>
|
|
||||||
```
|
|
||||||
|
|
||||||
### 4. `mount` method API is simpler
|
|
||||||
|
|
||||||
Before, the `mount` method was used like this:
|
|
||||||
|
|
||||||
```js
|
|
||||||
await mount(Root, { target: document.body });
|
|
||||||
```
|
|
||||||
|
|
||||||
It is now simpler and takes the root component and a target argument:
|
|
||||||
|
|
||||||
```js
|
|
||||||
await mount(Root, document.body);
|
|
||||||
```
|
|
||||||
|
|
||||||
Rationale: the `mount` method is only useful anyway for small toy examples,
|
|
||||||
because real applications will need to configure the templates, the translations,
|
|
||||||
and other stuff. All complex usecases need to go through the new `App` class,
|
|
||||||
that encapsulates the root of an owl application.
|
|
||||||
|
|
||||||
### 5. components can no longer be instantiated and mounted by hand
|
|
||||||
|
|
||||||
In Owl 1, it was possible to instantiate a component by hand:
|
|
||||||
|
|
||||||
```js
|
|
||||||
const root = new Root();
|
|
||||||
await root.mount(document.body);
|
|
||||||
```
|
|
||||||
|
|
||||||
Now, it is no longer possible. All component instantiations should be done by
|
|
||||||
the owl framework itself.
|
|
||||||
|
|
||||||
Rationale: the `mount` method does not make sense for all non root components.
|
|
||||||
Also, the fact that it was possible for a component to be sometimes root,
|
|
||||||
sometimes a child made for a weird constructor signature. This changes makes it
|
|
||||||
simpler.
|
|
||||||
|
|
||||||
Migration: all code doing that should use either the `mount` method (if the use
|
|
||||||
case is simple enough, or the `App` class):
|
|
||||||
|
|
||||||
```js
|
|
||||||
const app = new App(Root);
|
|
||||||
app.configure({ templates: ..., ...});
|
|
||||||
await app.mount(document.body);
|
|
||||||
```
|
|
||||||
|
|
||||||
### 6. components can no longer be unmounted/remounted
|
|
||||||
|
|
||||||
Rationale: this is a very difficult feature to implement (it adds a lot of possible
|
|
||||||
state transitions), compared to its benefit.
|
|
||||||
|
|
||||||
Migration: all code using it should find a way to export and reimport the state
|
|
||||||
|
|
||||||
### 7. template name is no longer inferred from the class name
|
|
||||||
|
|
||||||
Before, it was possible to define a component without specifying its template:
|
|
||||||
|
|
||||||
```js
|
|
||||||
class Blabla extends Component {
|
|
||||||
// no static template here!
|
|
||||||
}
|
|
||||||
```
|
|
||||||
with the `Blabla` template. It also worked with subclasses. But then, this means
|
|
||||||
that the code had to look up all the super classes names to find the correct
|
|
||||||
template.
|
|
||||||
|
|
||||||
Rationale: in practice, it is not really useful, since all templates are usually
|
|
||||||
namespaced: `web.SomeComponent` anyway. All the trouble to do that was just not
|
|
||||||
worth it.
|
|
||||||
|
|
||||||
Migration: simply explicitely defines the template key everytime:
|
|
||||||
|
|
||||||
```js
|
|
||||||
class Blabla extends Component {}
|
|
||||||
Blabla.template = "Blabla";
|
|
||||||
```
|
|
||||||
|
|
||||||
### 8. components no longer have a `shouldUpdate` method
|
|
||||||
|
|
||||||
Rationale: `shouldUpdate` is a dangerous method to use, that may cause a lot of
|
|
||||||
issues. Vue does not have such a mechanism (see https://github.com/vuejs/vue/issues/4255),
|
|
||||||
because the reactivity system in Vue is smart enough to only rerender the minimal
|
|
||||||
subset of components that is subscribed to a piece of state. Now, Owl 2 features
|
|
||||||
a much more powerful reactivity system.
|
|
||||||
|
|
||||||
Migration code: remove the `shouldUpdate` methods. Then, maybe the following
|
|
||||||
ideas may help:
|
|
||||||
|
|
||||||
- try to organize the state/architecture to minimize the number of state updates
|
|
||||||
- take advantage of the finer reactivity system. For example, if we have a list
|
|
||||||
of items, with a component for each item, we can write this:
|
|
||||||
|
|
||||||
```js
|
|
||||||
class Item extends Component {
|
|
||||||
setup() {
|
|
||||||
this.item = useState(this.props.item); // and only use this, not props.item
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
Doing so will make it that each `Item` component will register itself as an
|
|
||||||
observer of its own item, and will be the only component being rerendered when
|
|
||||||
its item object is updated.
|
|
||||||
- use the `Memo` component to wrap some piece of template. `Memo` memoize its
|
|
||||||
content, and only update itself if its props are different (shallow comparison):
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<Memo a="state.a" b="state.b">
|
|
||||||
<t t-esc="state.a"/>
|
|
||||||
<t t-esc="state.b"/>
|
|
||||||
<t t-esc="state.c"/>
|
|
||||||
</Memo>
|
|
||||||
```
|
|
||||||
|
|
||||||
### 9. component.el may be a text node, and is no longer `null`
|
|
||||||
|
|
||||||
This comes from the fact that Owl 2 supports fragments (arbitrary content). When
|
|
||||||
it is not defined, it was `null` in Owl 1 and is `undefined` in owl 2.
|
|
||||||
|
|
||||||
### 10. style/class on components are now regular props
|
|
||||||
|
|
||||||
Before, it was possible to do this in a template:
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<Child style="..." class="..."/>
|
|
||||||
```
|
|
||||||
(or with `t-att-style` and `t-att-class`). This does no longer work, as they are
|
|
||||||
now considered normal props.
|
|
||||||
|
|
||||||
Rationale: with the move to fragments, the semantics of where the style/class
|
|
||||||
attribute should be set is unclear. Also, it is actually very hard to implement
|
|
||||||
properly, in particular with higher order components. And another issue is that
|
|
||||||
it (slightly) breaks the encapsulation of behaviour from the `Child` component
|
|
||||||
perspective.
|
|
||||||
|
|
||||||
Migration: each component that wishes to be customized should explicitely add
|
|
||||||
the `class` and `style` attributes in its template. Also, the parent component
|
|
||||||
should be aware that since we are talking about props, it should be a javascript expression:
|
|
||||||
|
|
||||||
In parent:
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<Child class="'o_my_god'"/>
|
|
||||||
```
|
|
||||||
and in child:
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<div t-att-class="props.class">
|
|
||||||
...
|
|
||||||
</div>
|
|
||||||
```
|
|
||||||
|
|
||||||
### 11. components can no longer be mounted with position=self
|
|
||||||
|
|
||||||
Rationale: this is due to the implementation of owl 2 virtual dom. The hack
|
|
||||||
necessary to support position=self does not work. This position also is not
|
|
||||||
compatible with the fact that a component can have a root `<div>` then later,
|
|
||||||
change it to something else, or even a text node.
|
|
||||||
|
|
||||||
Migration: no real way to do the same. Owl application needs to be appended or
|
|
||||||
prepended in something, maybe a `div`.
|
|
||||||
|
|
||||||
### 12. `t-on` does not work on components any more
|
|
||||||
|
|
||||||
In owl 1, it was possible to bind an event listener on a component tag in a
|
|
||||||
template:
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<SomeComponent t-on-some-event="doSomething"/>
|
|
||||||
```
|
|
||||||
|
|
||||||
This does not work any more.
|
|
||||||
|
|
||||||
Rationale: with the support of fragments, there is no longer a canonical html
|
|
||||||
element that we can refer. So, this makes it difficult to implement correctly
|
|
||||||
and efficiently. Also, we noticed in practice that the event system was an issue
|
|
||||||
in some cases, when components need to communicate before they are mounted. In
|
|
||||||
those cases, the better solution is to directly use a callback. Also, another
|
|
||||||
conceptual issue with this is that it kind of breaks the component encapsulation.
|
|
||||||
The child component kind of leak its own implementation to the outside world.
|
|
||||||
|
|
||||||
Migration: a quick fix that may work in some cases is to simply bind the event
|
|
||||||
handler on a parent htmlelement. A better way to do it, if possible, is to change
|
|
||||||
the component API to accept explicitely a callback as props.
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<SomeComponent onSomeEvent="doSomething"/>
|
|
||||||
```
|
|
||||||
|
|
||||||
### 13. Portal does no longer transfer DOM events
|
|
||||||
|
|
||||||
In Owl 1, a Portal component would listen to events emitted on its portalled
|
|
||||||
child, and redispatch them on itself. It no longer works.
|
|
||||||
|
|
||||||
Rationale: Portal now supports an arbitrary content (so, more than one child,
|
|
||||||
and potentially no html element), so it is already unclear what it should listen
|
|
||||||
to. Also, redispatching events was an hack. And this changes allows the portal
|
|
||||||
to render itself as a text node, which is nice. This is also in line with the
|
|
||||||
fact that modern Owl moves toward using callback instead of `t-on` for communication.
|
|
||||||
|
|
||||||
Migration: use callback if possible to communicate. Otherwise, use a sub env.
|
|
||||||
|
|
||||||
### 14. Portal does render as an empty text node instead of `<portal/>`
|
|
||||||
|
|
||||||
That is pretty nice. No real migration needed.
|
|
||||||
|
|
||||||
### 15. Context is removed
|
|
||||||
|
|
||||||
Context was an abstraction in Owl that was used to define some reactive state
|
|
||||||
and to let some components subscribe to it, then only them would be rerendered
|
|
||||||
if the context was updated. This has been removed.
|
|
||||||
|
|
||||||
Rationale: first, the Context api and code was kind of awkward, which is a sign
|
|
||||||
that the abstraction is not well thought. But the good news is that it is actually
|
|
||||||
completely replaced by the new reactivity system, which is even more powerful,
|
|
||||||
since it can tracks changes key by key.
|
|
||||||
|
|
||||||
Migration: replace all uses of Context with the new reactivity system.
|
|
||||||
|
|
||||||
```js
|
|
||||||
// somewhere, maybe in a service, or in the global env
|
|
||||||
const context = observe({some: "state"})
|
|
||||||
|
|
||||||
// in a component that would previously get a reference to the context:
|
|
||||||
|
|
||||||
setup() {
|
|
||||||
this.context = useState(context);
|
|
||||||
// now the component is subscribed to the context and will react to any
|
|
||||||
// change for any key read by the component, and only those changes
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 16. `env` is now totally empty
|
|
||||||
|
|
||||||
In Owl 1, the `env` object had to contain a QWeb instance. This was the way
|
|
||||||
components would get a reference to their template function. It no longer works
|
|
||||||
that way: the `env` object is now totally empty (from the perspective of Owl).
|
|
||||||
It is now a user space concept, useful for the application.
|
|
||||||
|
|
||||||
Rationale: first, there is no longer a QWeb class. Also, this changes simplifies
|
|
||||||
the way components works internally.
|
|
||||||
|
|
||||||
Migration: there is no proper way to get an equivalent. The closest is to get
|
|
||||||
a reference to the root App using `this.__owl__.app`. If you need to do this,
|
|
||||||
let us know. If this is a legitimate usecase, we may add a `useApp` hook.
|
|
||||||
|
|
||||||
### 17. `t-component` no longer accepts strings
|
|
||||||
|
|
||||||
In owl 1, we could write this:
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<t t-component="Coucou"/>
|
|
||||||
```
|
|
||||||
|
|
||||||
This meant that Owl would look for the component class like this: `components["Coucou"]`,
|
|
||||||
so, essentially equivalent to `<Coucou/>`. In Owl 2, the `t-component` directive
|
|
||||||
is assumed to be an expression evaluating to a component class:
|
|
||||||
|
|
||||||
```js
|
|
||||||
class Parent extends Component {
|
|
||||||
static template = xml`<t t-component="Child"/>`;
|
|
||||||
Child = Child;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Rationale: it simply seems more consistent with the way directive works. Also,
|
|
||||||
the implementation is slightly simpler.
|
|
||||||
|
|
||||||
Migration: simply using `constructor.components.Coucou` instead of `Coucou` will
|
|
||||||
do the trick.
|
|
||||||
|
|
||||||
### 18. most exports are exported at top level
|
|
||||||
|
|
||||||
Most exports are flattened: for ex, `onMounted` is in owl, not in `owl.hooks`.
|
|
||||||
|
|
||||||
Rationale: this makes it easier to work with, instead of importing stuff from
|
|
||||||
`owl`, then `owl.hooks` and `owl.tags` for example.
|
|
||||||
|
|
||||||
Migration: all import code simply need to be slightly adapted.
|
|
||||||
|
|
||||||
### 19. Properties are no longer set as attributes
|
|
||||||
|
|
||||||
Formerly, html properties `<input type="checkbox" t-att-checked="blah"/>` were
|
|
||||||
set as property and as attribute, so, they would be visible in the DOM:
|
|
||||||
`<input type="checkbox" checked="blah"/>`. Now, they are treated as property only:
|
|
||||||
`<input type="checkbox"/>`.
|
|
||||||
|
|
||||||
Rationale: this is actually simple to do, is faster, and makes more sense to me.
|
|
||||||
|
|
||||||
### 20. `t-foreach` should always have a corresponding `t-key`
|
|
||||||
|
|
||||||
It was possible in Owl 1 to write a `t-foreach` without a `t-key`. In that case,
|
|
||||||
the index was used as key. Since it was clearly a possible bug, Owl 1 had a
|
|
||||||
warning in some cases, when it could detect that there was definitely not a `t-key`.
|
|
||||||
However, this was imperfect, and in some cases no warning was displayed. In Owl 2,
|
|
||||||
the tag with a `t-foreach` has to have a corresponding `t-key`.
|
|
||||||
|
|
||||||
Rationale: this makes it easier to avoid bugs.
|
|
||||||
|
|
||||||
Migration: simply move the `t-key` to the tag with the `t-foreach`. If this is
|
|
||||||
a situation where there is really not a need for a `t-key`, you can still add
|
|
||||||
it with the `_index` suffix:
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<div t-foreach="items" t-as="item" t-key="item_index">
|
|
||||||
...
|
|
||||||
</div>
|
|
||||||
```
|
|
||||||
|
|
||||||
### 21. `EventBus` api changed: it is now an `EventTarget`
|
|
||||||
|
|
||||||
In Owl 1, the `EventBus` class was done manually, with a custom API. In Owl 2,
|
|
||||||
it simply extends `EventTarget` (the native Dom class), so its implementation
|
|
||||||
is basically only 5 lines long. This means that it has now the usual DOM interface:
|
|
||||||
|
|
||||||
```js
|
|
||||||
bus.addEventListener('event-name', callback);
|
|
||||||
```
|
|
||||||
|
|
||||||
Rationale: it makes it easier to have just one interface to remember, it makes
|
|
||||||
the code simpler
|
|
||||||
|
|
||||||
Migration: most bus methods need to be adapted. So, `bus.on("event-type", owner, (info) => {...})` has to be
|
|
||||||
rewritten like this: `bus.addEventListener("event-type", (({detail: info}) => {...}).bind(owner))`.
|
|
||||||
|
|
||||||
Do not forget to similarly replace `bus.off(...)` by `bus.removeEventListener(...)`
|
|
||||||
|
|
||||||
### 22. `Store` is removed
|
|
||||||
|
|
||||||
The Store system had been abandoned in owl 2.
|
|
||||||
|
|
||||||
Rationale: first, it was complicated to maintain. Second, it was not really
|
|
||||||
used in Odoo. Finally, the new reactivity system seems to be a pretty good basis
|
|
||||||
to write a store, and it should not take much work. Also, this can be done in
|
|
||||||
user space (so, not necessarily at the framework level). Another point is that
|
|
||||||
the store API was invented before the hooks, then was still a little awkward.
|
|
||||||
|
|
||||||
Migration:
|
|
||||||
- rewrite the code not to use a store
|
|
||||||
- probably use the reactivity system instead and build a store class and a few
|
|
||||||
hooks on top of it.
|
|
||||||
|
|
||||||
### 23. `Router` is removed
|
|
||||||
|
|
||||||
Rationale: Router was not used that much, and it felt like it did not fit in Owl 2.
|
|
||||||
Its API needs to be reworked, and we are not confident that it is a good
|
|
||||||
experience to use it. Also, it can be done in userspace (it does not need specific
|
|
||||||
integration at the framework level)
|
|
||||||
|
|
||||||
Migration: reimport all missing piece from the code in Owl 1.
|
|
||||||
|
|
||||||
### 24. transition system is removed
|
|
||||||
|
|
||||||
Rationale: this was a high ratio cost/value, with a lot of potential for bugs.
|
|
||||||
We feel like there should be a way to reimplement in userspace the simple cases.
|
|
||||||
|
|
||||||
Maybe something like: add a `t-ref` in the template, and define a hook `useFadeOut`
|
|
||||||
that takes the ref, and add a fadeout class at initial render, then in mounted,
|
|
||||||
wait for a micro tick and remove it.
|
|
||||||
|
|
||||||
Migration: try to reimplement it manually.
|
|
||||||
|
|
||||||
### 25. no more global components or templates
|
|
||||||
|
|
||||||
It was possible in Owl 1 to register globally a component or a template. This is
|
|
||||||
no longer the case in Owl 2.
|
|
||||||
|
|
||||||
Rationale: first, this was a tradeoff: ease of use was gained, but at the cost
|
|
||||||
of a higher complexity. Users had to know that there was a magic mechanism. Also,
|
|
||||||
it was not used much in practice, and the cost of having to import manually components
|
|
||||||
is low. Finally, this can be mostly done in user space (for example, by subclassing
|
|
||||||
`Component`).
|
|
||||||
|
|
||||||
Migration: import manually all required global components, or find a way to organize
|
|
||||||
the code to do it.
|
|
||||||
|
|
||||||
### 26. `AsyncRoot` utility component is removed
|
|
||||||
|
|
||||||
Rationale: it was difficult to understand, never used, and not really useful.
|
|
||||||
It seems better to control the asynchrony of an application by simply controlling
|
|
||||||
how/when the state is updated, and how each component is loading/updating itself.
|
|
||||||
|
|
||||||
Migration: remove the `AsyncRoot` component, then possibly, reorganize the code
|
|
||||||
to fetch data in a higher order component, and using a `t-if/t-else` to display
|
|
||||||
either a fallback when the data is not ready, or the actual component with data
|
|
||||||
as props. If there is no escape, and `AsyncRoot` is needed, please reach out to
|
|
||||||
us so we can study this usecase.
|
|
||||||
|
|
||||||
### 27. `useSubEnv` only applies to child components
|
|
||||||
|
|
||||||
In Owl 1, a call to `useSubEnv` would define a new environment for the children
|
|
||||||
AND the component. It now only defines an environment for the children.
|
|
||||||
|
|
||||||
Rationale: This was a subtle cause for bugs: some code had to be rrun
|
|
||||||
before the call to `useSubEnv`, otherwise it could interfere with the sub environment.
|
|
||||||
|
|
||||||
|
|
||||||
### 28. `env` is now frozen
|
|
||||||
|
|
||||||
In Owl 2, the `env` object is frozen. It can no longer be modified (structurally)
|
|
||||||
arbitrarily.
|
|
||||||
|
|
||||||
Rationale: it seems like the `env` object purpose is to have a global channel of
|
|
||||||
communication between components. It is however scary if anyone can add something
|
|
||||||
to it. The usual use case is to add something to the environment for some child
|
|
||||||
components. This use case still works with `useSubEnv`.
|
|
||||||
|
|
||||||
Migration: use `useSubEnv` instead of writing directly to the env. Also, note
|
|
||||||
that the environment given to the App can initially contain anything.
|
|
||||||
|
|
||||||
### 29. `t-ref` does not work on component
|
|
||||||
|
|
||||||
Before, `t-ref` could be used to get a reference to a child component. It no
|
|
||||||
longer works.
|
|
||||||
|
|
||||||
Rationale: the possibility of having a ref to a child component breaks the
|
|
||||||
encapsulation provided by Owl components: a child component now has a private
|
|
||||||
and a public interface. Another issue is that it may be unclear when the ref
|
|
||||||
should be set: is the component active on setup, or on mounted? Also, it is
|
|
||||||
kind of awkward to implement.
|
|
||||||
|
|
||||||
Migration: the `env` and `props` should provide a communication channel wide enough:
|
|
||||||
the sub component can expose its public API by calling a callback at the proper
|
|
||||||
timing, or by triggering an event.
|
|
||||||
|
|
||||||
### 30. `t-on` does not accept expressions, only functions
|
|
||||||
|
|
||||||
In Owl 1, it was possible to define simple expressions inline, in a template:
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<button t-on-click="state.value = state.value + 1">blabla</button>
|
|
||||||
<button t-on-click="someFunction(someVar)">blabla</button>
|
|
||||||
```
|
|
||||||
|
|
||||||
This does not work anymore. Now, the `t-on` directive assumes that what it get is
|
|
||||||
a function.
|
|
||||||
|
|
||||||
Rationale: the fact that owl 1 had to support expressions meant that it was not
|
|
||||||
possible to properly inject the event in general. With this restriction, Owl 2
|
|
||||||
can support more general use cases. Also, the examples above can simply be
|
|
||||||
wrapped in a lambda function.
|
|
||||||
|
|
||||||
Migration: use lambda functions. For example, the two examples above can be
|
|
||||||
adapted like this:
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<button t-on-click="() => state.value = state.value + 1">blabla</button>
|
|
||||||
<button t-on-click="() => this.someFunction(someVar)">blabla</button>
|
|
||||||
```
|
|
||||||
|
|
||||||
### 31. components can now have arbitrary content
|
|
||||||
|
|
||||||
Before Owl 2, components had to limit themselves to one single htmlelement as
|
|
||||||
root. Now, the content is arbitrary: it can be empty, or multiple html elements.
|
|
||||||
So, the following template works for components:
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<div>1</div>
|
|
||||||
<div>2</div>
|
|
||||||
hello
|
|
||||||
```
|
|
||||||
|
|
||||||
### 32. `renderToString` on QWeb has been removed
|
|
||||||
|
|
||||||
Rationale: the `renderToString` function was a qweb method, which made sense because
|
|
||||||
the qweb instance knew all templates. But now, the closest analogy is the `App`
|
|
||||||
class, but it is not as convenient, since the `app` instance is no longer visible
|
|
||||||
to components (while before, `qweb` was in the environment).
|
|
||||||
|
|
||||||
Also, this can easily be done in userspace, by mounting a component in a div. For example:
|
|
||||||
|
|
||||||
```js
|
|
||||||
export async function renderToString(template, context) {
|
|
||||||
class C extends Component {
|
|
||||||
static template = template;
|
|
||||||
}
|
|
||||||
const div = document.createElement('div');
|
|
||||||
document.body.appendChild(div);
|
|
||||||
const component = await mount(C, div);
|
|
||||||
const result = div.innerHTML;
|
|
||||||
app.destroy();
|
|
||||||
div.remove();
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
<h1 align="center">🦉 <a href="https://odoo.github.io/owl/">Owl Framework</a> 🦉</h1>
|
<h1 align="center">🦉 <a href="https://odoo.github.io/owl/">OWL Framework</a> 🦉</h1>
|
||||||
|
|
||||||
[](https://www.gnu.org/licenses/lgpl-3.0)
|
[](https://www.gnu.org/licenses/lgpl-3.0)
|
||||||
[](https://badge.fury.io/js/@odoo%2Fowl)
|
[](https://badge.fury.io/js/@odoo%2Fowl)
|
||||||
@@ -6,39 +6,51 @@
|
|||||||
|
|
||||||
_Class based components with hooks, reactive state and concurrent mode_
|
_Class based components with hooks, reactive state and concurrent mode_
|
||||||
|
|
||||||
**Try it online!** you can experiment with the Owl framework in an online [playground](https://odoo.github.io/owl/playground).
|
|
||||||
|
|
||||||
## Project Overview
|
## Project Overview
|
||||||
|
|
||||||
The Odoo Web Library (Owl) is a smallish (~<20kb gzipped) UI framework built by
|
The Odoo Web Library (OWL) is a smallish (~<20kb gzipped) UI framework intended to
|
||||||
[Odoo](https://www.odoo.com/) for its products. Owl is a modern
|
be the basis for the [Odoo](https://www.odoo.com/) Web Client. Owl is a modern
|
||||||
framework, written in Typescript, taking the best ideas from React and Vue in a
|
framework, written in Typescript, taking the best ideas from React and Vue in a
|
||||||
simple and consistent way. Owl's main features are:
|
simple and consistent way. Owl's main features are:
|
||||||
|
|
||||||
- a declarative component system,
|
- a declarative component system,
|
||||||
- a reactivity system based on hooks,
|
- a reactivity system based on hooks,
|
||||||
- concurrent mode by default,
|
- concurrent mode by default,
|
||||||
|
- a store and a frontend router
|
||||||
|
|
||||||
Owl components are defined with ES6 classes and xml templates, uses an
|
Owl components are defined with ES6 classes, they use QWeb templates, an
|
||||||
underlying virtual DOM, integrates beautifully with hooks, and the rendering is
|
underlying virtual DOM, integrates beautifully with hooks, and the rendering is
|
||||||
asynchronous.
|
asynchronous.
|
||||||
|
|
||||||
Quick links:
|
**Try it online!** An online playground is available at
|
||||||
|
[https://odoo.github.io/owl/playground](https://odoo.github.io/owl/playground)
|
||||||
|
to let you experiment with the Owl framework. There are some code examples to
|
||||||
|
showcase some interesting features.
|
||||||
|
|
||||||
- [documentation](#documentation),
|
Owl is currently stable. Possible future changes are explained in the
|
||||||
- [changelog](CHANGELOG.md) (from Owl 1.x to 2.x),
|
[roadmap](roadmap.md).
|
||||||
- [playground](https://odoo.github.io/owl/playground)
|
|
||||||
|
## Why Owl?
|
||||||
|
|
||||||
|
Why did Odoo decide to make Yet Another Framework? This is really a question
|
||||||
|
that deserves [a long answer](doc/miscellaneous/why_owl.md). But in short, we believe that
|
||||||
|
while the current state of the art frameworks are excellent, they are not
|
||||||
|
optimized for our use case, and there is still room for something else.
|
||||||
|
|
||||||
|
If you are interested in a comparison with React or Vue, you will
|
||||||
|
find some more additional information [here](doc/miscellaneous/comparison.md).
|
||||||
|
|
||||||
## Example
|
## Example
|
||||||
|
|
||||||
Here is a short example to illustrate interactive components:
|
Here is a short example to illustrate interactive components:
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
const { Component, useState, mount, xml } = owl;
|
const { Component, useState, mount } = owl;
|
||||||
|
const { xml } = owl.tags;
|
||||||
|
|
||||||
class Counter extends Component {
|
class Counter extends Component {
|
||||||
static template = xml`
|
static template = xml`
|
||||||
<button t-on-click="() => state.value++">
|
<button t-on-click="state.value++">
|
||||||
Click Me! [<t t-esc="state.value"/>]
|
Click Me! [<t t-esc="state.value"/>]
|
||||||
</button>`;
|
</button>`;
|
||||||
|
|
||||||
@@ -55,7 +67,7 @@ class App extends Component {
|
|||||||
static components = { Counter };
|
static components = { Counter };
|
||||||
}
|
}
|
||||||
|
|
||||||
mount(App, document.body);
|
mount(App, { target: document.body });
|
||||||
```
|
```
|
||||||
|
|
||||||
Note that the counter component is made reactive with the [`useState` hook](doc/reference/hooks.md#usestate).
|
Note that the counter component is made reactive with the [`useState` hook](doc/reference/hooks.md#usestate).
|
||||||
@@ -65,55 +77,41 @@ But this is not mandatory, many applications will load templates separately.
|
|||||||
More interesting examples can be found on the
|
More interesting examples can be found on the
|
||||||
[playground](https://odoo.github.io/owl/playground) application.
|
[playground](https://odoo.github.io/owl/playground) application.
|
||||||
|
|
||||||
|
## Design Principles
|
||||||
|
|
||||||
|
OWL is designed to be used in highly dynamic applications where changing
|
||||||
|
requirements are common and code needs to be maintained by large teams.
|
||||||
|
|
||||||
|
- **XML based**: templates are based on the XML format, which allows interesting
|
||||||
|
applications. For example, they could be stored in a database and modified
|
||||||
|
dynamically with `xpaths`.
|
||||||
|
- **templates compilation in the browser**: this may not be a good fit for all
|
||||||
|
applications, but if you need to generate dynamically user interfaces in the
|
||||||
|
browser, this is very powerful. For example, a generic form view component
|
||||||
|
could generate a specific form user interface for each various models, from a XML view.
|
||||||
|
- **no toolchain required**: this is extremely useful for some applications, if,
|
||||||
|
for various reasons (security/deployment/dynamic modules/specific assets tools),
|
||||||
|
it is not ok to use standard web tools based on `npm`.
|
||||||
|
|
||||||
|
Owl is not designed to be fast nor small (even though it is quite good on those
|
||||||
|
two topics). It is a no nonsense framework to build applications. There is only
|
||||||
|
one way to define components (with classes). There is no black magic. It just
|
||||||
|
works.
|
||||||
|
|
||||||
|
|
||||||
## Documentation
|
## Documentation
|
||||||
|
|
||||||
### Learning Owl
|
A complete documentation for Owl can be found here:
|
||||||
|
|
||||||
Are you new to Owl? This is the place to start!
|
- [Main documentation page](doc/readme.md).
|
||||||
|
|
||||||
- [Tutorial: create a TodoList application](doc/learning/tutorial_todoapp.md)
|
Some of the most important pages are:
|
||||||
|
|
||||||
|
- [Tutorial: TodoList application](doc/learning/tutorial_todoapp.md)
|
||||||
- [How to start an Owl project](doc/learning/quick_start.md)
|
- [How to start an Owl project](doc/learning/quick_start.md)
|
||||||
- [How to test Components](doc/learning/how_to_test.md)
|
- [QWeb templating language](doc/reference/qweb_templating_language.md)
|
||||||
- [How to write Single File Components](doc/learning/how_to_write_sfc.md)
|
|
||||||
|
|
||||||
### Reference
|
|
||||||
|
|
||||||
You will find here a complete reference of every feature, class or object
|
|
||||||
provided by Owl.
|
|
||||||
|
|
||||||
- [Animations](doc/reference/animations.md)
|
|
||||||
- [Browser](doc/reference/browser.md)
|
|
||||||
- [Component](doc/reference/component.md)
|
- [Component](doc/reference/component.md)
|
||||||
- [Content](doc/reference/content.md)
|
|
||||||
- [Concurrency Model](doc/reference/concurrency_model.md)
|
|
||||||
- [Configuration](doc/reference/config.md)
|
|
||||||
- [Context](doc/reference/context.md)
|
|
||||||
- [Environment](doc/reference/environment.md)
|
|
||||||
- [Event Bus](doc/reference/event_bus.md)
|
|
||||||
- [Event Handling](doc/reference/event_handling.md)
|
|
||||||
- [Error Handling](doc/reference/error_handling.md)
|
|
||||||
- [Hooks](doc/reference/hooks.md)
|
- [Hooks](doc/reference/hooks.md)
|
||||||
- [Mounting a component](doc/reference/mounting.md)
|
|
||||||
- [Miscellaneous Components](doc/reference/misc.md)
|
|
||||||
- [Observer](doc/reference/observer.md)
|
|
||||||
- [Props](doc/reference/props.md)
|
|
||||||
- [Props Validation](doc/reference/props_validation.md)
|
|
||||||
- [QWeb Templating Language](doc/reference/qweb_templating_language.md)
|
|
||||||
- [QWeb Engine](doc/reference/qweb_engine.md)
|
|
||||||
- [Slots](doc/reference/slots.md)
|
|
||||||
- [Tags](doc/reference/tags.md)
|
|
||||||
- [Utils](doc/reference/utils.md)
|
|
||||||
|
|
||||||
### Other Topics
|
|
||||||
|
|
||||||
This section provides miscellaneous document that explains some topics
|
|
||||||
which cannot be considered either a tutorial, or reference documentation.
|
|
||||||
|
|
||||||
- [Owl architecture: the Virtual DOM](doc/miscellaneous/vdom.md)
|
|
||||||
- [Owl architecture: the rendering pipeline](doc/miscellaneous/rendering.md)
|
|
||||||
- [Comparison with React/Vue](doc/miscellaneous/comparison.md)
|
|
||||||
- [Why did Odoo built Owl?](doc/miscellaneous/why_owl.md)
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Installing Owl
|
## Installing Owl
|
||||||
@@ -126,5 +124,8 @@ npm install @odoo/owl
|
|||||||
|
|
||||||
If you want to use a simple `<script>` tag, the last release can be downloaded here:
|
If you want to use a simple `<script>` tag, the last release can be downloaded here:
|
||||||
|
|
||||||
- [owl-1.4.7](https://github.com/odoo/owl/releases/tag/v1.4.7)
|
- [owl-1.4.6](https://github.com/odoo/owl/releases/tag/v1.4.6)
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
OWL is [LGPL licensed](./LICENSE).
|
||||||
|
|||||||
@@ -0,0 +1,43 @@
|
|||||||
|
# 🦉 How to debug Owl applications 🦉
|
||||||
|
|
||||||
|
Non trivial applications become quickly more difficult to understand. It is then
|
||||||
|
useful to have a solid understanding of what is going on. To help with that,
|
||||||
|
logging useful information is extremely valuable. There is a [javascript file](../../tools/debug.js) which can be evaluated in an application.
|
||||||
|
|
||||||
|
Once it is executed, it will log a lot of information on each component main hooks. The following code is a minified version to make it easier to copy/paste:
|
||||||
|
|
||||||
|
```
|
||||||
|
function debugOwl(t,e){let n,o="[OWL_DEBUG]";function r(t){let e;try{e=JSON.stringify(t||{})}catch(t){e="<JSON error>"}return e.length>200&&(e=e.slice(0,200)+"..."),e}if(Object.defineProperty(t.Component,"current",{get:()=>n,set(s){n=s;const i=s.constructor.name;if(e.componentBlackList&&e.componentBlackList.test(i))return;if(e.componentWhiteList&&!e.componentWhiteList.test(i))return;let l;Object.defineProperty(n,"__owl__",{get:()=>l,set(n){!function(n,s,i){let l=`${s}<id=${i}>`,c=t=>console.log(`${o} ${l} ${t}`),u=t=>(!e.methodBlackList||!e.methodBlackList.includes(t))&&!(e.methodWhiteList&&!e.methodWhiteList.includes(t));u("constructor")&&c(`constructor, props=${r(n.props)}`);u("willStart")&&t.hooks.onWillStart(()=>{c("willStart")});u("mounted")&&t.hooks.onMounted(()=>{c("mounted")});u("willUpdateProps")&&t.hooks.onWillUpdateProps(t=>{c(`willUpdateProps, nextprops=${r(t)}`)});u("willPatch")&&t.hooks.onWillPatch(()=>{c("willPatch")});u("patched")&&t.hooks.onPatched(()=>{c("patched")});u("willUnmount")&&t.hooks.onWillUnmount(()=>{c("willUnmount")});const d=n.__render.bind(n);n.__render=function(...t){c("rendering template"),d(...t)};const h=n.render.bind(n);n.render=function(...t){const e=n.__owl__;let o="render";return e.isMounted||e.currentFiber||(o+=" (warning: component is not mounted, this render has no effect)"),c(o),h(...t)};const p=n.mount.bind(n);n.mount=function(...t){return c("mount"),p(...t)}}(s,i,(l=n).id)}})}}),e.logScheduler){let e=t.Component.scheduler.start,n=t.Component.scheduler.stop;t.Component.scheduler.start=function(){this.isRunning||console.log(`${o} scheduler: start running tasks queue`),e.call(this)},t.Component.scheduler.stop=function(){this.isRunning&&console.log(`${o} scheduler: stop running tasks queue`),n.call(this)}}if(e.logStore){let e=t.Store.prototype.dispatch;t.Store.prototype.dispatch=function(t,...n){return console.log(`${o} store: action '${t}' dispatched. Payload: '${r(n)}'`),e.call(this,t,...n)}}}
|
||||||
|
debugOwl(owl, {
|
||||||
|
// componentBlackList: /App/, // regexp
|
||||||
|
// componentWhiteList: /SomeComponent/, // regexp
|
||||||
|
// methodBlackList: ["mounted"], // list of method names
|
||||||
|
// methodWhiteList: ["willStart"], // list of method names
|
||||||
|
logScheduler: false, // display/mute scheduler logs
|
||||||
|
logStore: true, // display/mute store logs
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
The above code, once pasted somewhere in the main javascript file of an owl
|
||||||
|
application, will log information looking like this:
|
||||||
|
|
||||||
|
```
|
||||||
|
[OWL_DEBUG] TodoApp<id=1> constructor, props={}
|
||||||
|
[OWL_DEBUG] TodoApp<id=1> mount
|
||||||
|
[OWL_DEBUG] TodoApp<id=1> willStart
|
||||||
|
[OWL_DEBUG] TodoApp<id=1> rendering template
|
||||||
|
[OWL_DEBUG] TodoItem<id=2> constructor, props={"id":2,"completed":false,"title":"hey"}
|
||||||
|
[OWL_DEBUG] TodoItem<id=2> willStart
|
||||||
|
[OWL_DEBUG] TodoItem<id=3> constructor, props={"id":4,"completed":false,"title":"aaa"}
|
||||||
|
[OWL_DEBUG] TodoItem<id=3> willStart
|
||||||
|
[OWL_DEBUG] TodoItem<id=2> rendering template
|
||||||
|
[OWL_DEBUG] TodoItem<id=3> rendering template
|
||||||
|
[OWL_DEBUG] TodoItem<id=3> mounted
|
||||||
|
[OWL_DEBUG] TodoItem<id=2> mounted
|
||||||
|
[OWL_DEBUG] TodoApp<id=1> mounted
|
||||||
|
```
|
||||||
|
|
||||||
|
Each component has an internal `id`, which is very useful when debugging.
|
||||||
|
|
||||||
|
Note that it is certainly useful to run this code at some point in an application,
|
||||||
|
just to get a feel of what each user action implies, for the framework.
|
||||||
+46
-11
@@ -30,21 +30,27 @@ To help with this, it is useful to have a `helper.js` file that contains some
|
|||||||
common utility functions:
|
common utility functions:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
let lastFixture = null;
|
|
||||||
|
|
||||||
export function makeTestFixture() {
|
export function makeTestFixture() {
|
||||||
let fixture = document.createElement("div");
|
let fixture = document.createElement("div");
|
||||||
document.body.appendChild(fixture);
|
document.body.appendChild(fixture);
|
||||||
if (lastFixture) {
|
|
||||||
lastFixture.remove();
|
|
||||||
}
|
|
||||||
lastFixture = fixture;
|
|
||||||
return fixture;
|
return fixture;
|
||||||
}
|
}
|
||||||
|
|
||||||
export async function nextTick() {
|
export function nextTick() {
|
||||||
await new Promise((resolve) => setTimeout(resolve));
|
let requestAnimationFrame = owl.Component.scheduler.requestAnimationFrame;
|
||||||
await new Promise((resolve) => requestAnimationFrame(resolve));
|
return new Promise(function(resolve) {
|
||||||
|
setTimeout(() => requestAnimationFrame(() => resolve()));
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function makeTestEnv() {
|
||||||
|
// application specific. It needs a way to load actual templates
|
||||||
|
const templates = ...;
|
||||||
|
|
||||||
|
return {
|
||||||
|
qweb: new QWeb(templates),
|
||||||
|
..., // each service can be mocked here
|
||||||
|
};
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -53,7 +59,7 @@ With such a file, a typical test suite for Jest will look like this:
|
|||||||
```js
|
```js
|
||||||
// in SomeComponent.test.js
|
// in SomeComponent.test.js
|
||||||
import { SomeComponent } from "../../src/ui/SomeComponent";
|
import { SomeComponent } from "../../src/ui/SomeComponent";
|
||||||
import { nextTick, makeTestFixture } from '../helpers';
|
import { nextTick, makeTestFixture, makeTestEnv} from '../helpers';
|
||||||
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
//------------------------------------------------------------------------------
|
||||||
@@ -64,6 +70,9 @@ let env: Env;
|
|||||||
|
|
||||||
beforeEach(() => {
|
beforeEach(() => {
|
||||||
fixture = makeTestFixture();
|
fixture = makeTestFixture();
|
||||||
|
env = makeTestEnv();
|
||||||
|
// we set here the default environment for each component created in the test
|
||||||
|
Component.env = env;
|
||||||
});
|
});
|
||||||
|
|
||||||
afterEach(() => {
|
afterEach(() => {
|
||||||
@@ -76,7 +85,7 @@ afterEach(() => {
|
|||||||
describe("SomeComponent", () => {
|
describe("SomeComponent", () => {
|
||||||
test("component behaves as expected", async () => {
|
test("component behaves as expected", async () => {
|
||||||
const props = {...}; // depends on the component
|
const props = {...}; // depends on the component
|
||||||
const comp = await mount(SomeComponent, fixture, { props });
|
const comp = await mount(SomeComponent, { target: fixture, props });
|
||||||
|
|
||||||
// do some assertions
|
// do some assertions
|
||||||
expect(...).toBe(...);
|
expect(...).toBe(...);
|
||||||
@@ -93,3 +102,29 @@ describe("SomeComponent", () => {
|
|||||||
Note that Owl does wait for the next animation frame to actually update the DOM.
|
Note that Owl does wait for the next animation frame to actually update the DOM.
|
||||||
This is why it is necessary to wait with the `nextTick` (or other methods) to
|
This is why it is necessary to wait with the `nextTick` (or other methods) to
|
||||||
make sure that the DOM is up-to-date.
|
make sure that the DOM is up-to-date.
|
||||||
|
|
||||||
|
It is sometimes useful to wait until Owl is completely done updating components
|
||||||
|
(in particular, if we have a highly concurrent user interface). This next
|
||||||
|
helper simply polls every 20ms the internal Owl task queue and returns a promise
|
||||||
|
which resolves when it is empty:
|
||||||
|
|
||||||
|
```js
|
||||||
|
function afterUpdates() {
|
||||||
|
return new Promise((resolve, reject) => {
|
||||||
|
let timer = setTimeout(poll, 20);
|
||||||
|
let counter = 0;
|
||||||
|
function poll() {
|
||||||
|
counter++;
|
||||||
|
if (owl.Component.scheduler.tasks.length) {
|
||||||
|
if (counter > 10) {
|
||||||
|
reject(new Error("timeout"));
|
||||||
|
} else {
|
||||||
|
timer = setTimeout(poll);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
resolve();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|||||||
@@ -0,0 +1,133 @@
|
|||||||
|
# 🦉 Quick Overview 🦉
|
||||||
|
|
||||||
|
Owl components in an application are used to define a (dynamic) tree of components.
|
||||||
|
|
||||||
|
```
|
||||||
|
Root
|
||||||
|
/ \
|
||||||
|
A B
|
||||||
|
/ \
|
||||||
|
C D
|
||||||
|
```
|
||||||
|
|
||||||
|
**State:** each component can manage its own local state. It is a simple ES6
|
||||||
|
class, there are no special rules:
|
||||||
|
|
||||||
|
```js
|
||||||
|
class Counter extends Component {
|
||||||
|
static template = xml`
|
||||||
|
<button t-on-click="increment">
|
||||||
|
Click Me! [<t t-esc="state.value"/>]
|
||||||
|
</button>`;
|
||||||
|
|
||||||
|
state = { value: 0 };
|
||||||
|
|
||||||
|
increment() {
|
||||||
|
this.state.value++;
|
||||||
|
this.render();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
The example above shows a component with a local state. Note that since there
|
||||||
|
is nothing magical to the `state` object, we need to manually call the `render`
|
||||||
|
function whenever we update it. This can quickly become annoying (and not
|
||||||
|
efficient if we do it too much). There is a better way: using the `useState`
|
||||||
|
hook, which transforms an object into a reactive version of itself:
|
||||||
|
|
||||||
|
```js
|
||||||
|
const { useState } = owl.hooks;
|
||||||
|
|
||||||
|
class Counter extends Component {
|
||||||
|
static template = xml`
|
||||||
|
<button t-on-click="increment">
|
||||||
|
Click Me! [<t t-esc="state.value"/>]
|
||||||
|
</button>`;
|
||||||
|
|
||||||
|
state = useState({ value: 0 });
|
||||||
|
|
||||||
|
increment() {
|
||||||
|
this.state.value++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Note that the `t-on-click` handler can even be replaced by an inline statement:
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<button t-on-click="state.value++">
|
||||||
|
```
|
||||||
|
|
||||||
|
**Props:** sub components often needs some information from their parents. This
|
||||||
|
is done by adding the required information to the template. This will then be
|
||||||
|
accessible by the sub component in the `props` object. Note that there is an
|
||||||
|
important rule here: the information contained in the `props` object is not
|
||||||
|
owned by the sub component, and should never be modified.
|
||||||
|
|
||||||
|
```js
|
||||||
|
class Child extends Component {
|
||||||
|
static template = xml`<div>Hello <t t-esc="props.name"/></div>`;
|
||||||
|
}
|
||||||
|
|
||||||
|
class Parent extends Component {
|
||||||
|
static template = xml`
|
||||||
|
<div>
|
||||||
|
<Child name="'Owl'" />
|
||||||
|
<Child name="'Framework'" />
|
||||||
|
</div>`;
|
||||||
|
static components = { Child };
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Communication:** there are multiple ways to communicate information between
|
||||||
|
components. However, the two most important ways are the following:
|
||||||
|
|
||||||
|
- from parent to children: by using `props`,
|
||||||
|
- from a children to one of its parent: by triggering events.
|
||||||
|
|
||||||
|
The following example illustrate both mechanisms:
|
||||||
|
|
||||||
|
```js
|
||||||
|
class OrderLine extends Component {
|
||||||
|
static template = xml`
|
||||||
|
<div t-on-click="add">
|
||||||
|
<div><t t-esc="props.line.name"/></div>
|
||||||
|
<div>Quantity: <t t-esc="props.line.quantity"/></div>
|
||||||
|
</div>`;
|
||||||
|
|
||||||
|
add() {
|
||||||
|
this.trigger("add-to-order", { line: this.props.line });
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
class Parent extends Component {
|
||||||
|
static template = xml`
|
||||||
|
<div t-on-add-to-order="addToOrder">
|
||||||
|
<OrderLine
|
||||||
|
t-foreach="orders"
|
||||||
|
t-as="line"
|
||||||
|
line="line" />
|
||||||
|
</div>`;
|
||||||
|
static components = { OrderLine };
|
||||||
|
orders = useState([
|
||||||
|
{ id: 1, name: "Coffee", quantity: 0 },
|
||||||
|
{ id: 2, name: "Tea", quantity: 0 },
|
||||||
|
]);
|
||||||
|
|
||||||
|
addToOrder(event) {
|
||||||
|
const line = event.detail.line;
|
||||||
|
line.quantity++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
In this example, the `OrderLine` component trigger a `add-to-order` event. This
|
||||||
|
will generate a DOM event which will bubble along the DOM tree. It will then be
|
||||||
|
intercepted by the parent component, which will then get the line (from the
|
||||||
|
`detail` key) and then increment its quantity. See the page on [event handling](../reference/event_handling.md)
|
||||||
|
for more details on how events work.
|
||||||
|
|
||||||
|
Note that this example would have also worked if the `OrderLine` component
|
||||||
|
directly modifies the `line` object. However, this is not a good practice: this
|
||||||
|
only works because the `props` object received by the child component is reactive,
|
||||||
|
so the child component is then coupled to the parents implementation.
|
||||||
+47
-38
@@ -36,8 +36,6 @@ hello_owl/
|
|||||||
The file `owl.js` can be downloaded from the last release published at
|
The file `owl.js` can be downloaded from the last release published at
|
||||||
[https://github.com/odoo/owl/releases](https://github.com/odoo/owl/releases). It
|
[https://github.com/odoo/owl/releases](https://github.com/odoo/owl/releases). It
|
||||||
is a single javascript file which export all Owl into the global `owl` object.
|
is a single javascript file which export all Owl into the global `owl` object.
|
||||||
Note that there are multiple files, and in this case, we need one of the two
|
|
||||||
files suffixed with `.iife`: they are built to be directly used in a browser.
|
|
||||||
|
|
||||||
Now, `index.html` should contain the following:
|
Now, `index.html` should contain the following:
|
||||||
|
|
||||||
@@ -47,24 +45,30 @@ Now, `index.html` should contain the following:
|
|||||||
<head>
|
<head>
|
||||||
<title>Hello Owl</title>
|
<title>Hello Owl</title>
|
||||||
<script src="owl.js"></script>
|
<script src="owl.js"></script>
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<script src="app.js"></script>
|
<script src="app.js"></script>
|
||||||
</body>
|
</head>
|
||||||
|
<body></body>
|
||||||
</html>
|
</html>
|
||||||
```
|
```
|
||||||
|
|
||||||
And `app.js` should look like this:
|
And `app.js` should look like this:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
const { Component, mount, xml } = owl;
|
const { Component, mount } = owl;
|
||||||
|
const { xml } = owl.tags;
|
||||||
|
const { whenReady } = owl.utils;
|
||||||
|
|
||||||
// Owl Components
|
// Owl Components
|
||||||
class Root extends Component {
|
class App extends Component {
|
||||||
static template = xml`<div>Hello Owl</div>`;
|
static template = xml`<div>Hello Owl</div>`;
|
||||||
}
|
}
|
||||||
|
|
||||||
mount(Root, document.body);
|
// Setup code
|
||||||
|
function setup() {
|
||||||
|
mount(App, target: { document.body })
|
||||||
|
}
|
||||||
|
|
||||||
|
whenReady(setup);
|
||||||
```
|
```
|
||||||
|
|
||||||
Now, simply loading this html file in a browser should display a welcome message.
|
Now, simply loading this html file in a browser should display a welcome message.
|
||||||
@@ -89,16 +93,14 @@ Let us start a new project with the following file structure:
|
|||||||
```
|
```
|
||||||
hello_owl/
|
hello_owl/
|
||||||
src/
|
src/
|
||||||
|
app.js
|
||||||
index.html
|
index.html
|
||||||
main.js
|
main.js
|
||||||
owl.js
|
owl.js
|
||||||
root.js
|
|
||||||
```
|
```
|
||||||
|
|
||||||
As previously, the file `owl.js` can be downloaded from the last release published at
|
As previously, the file `owl.js` can be downloaded from the last release published at
|
||||||
[https://github.com/odoo/owl/releases](https://github.com/odoo/owl/releases).
|
[https://github.com/odoo/owl/releases](https://github.com/odoo/owl/releases).
|
||||||
Note that there are multiple files, and in this case, we need one of the two
|
|
||||||
files suffixed with `.iife`: they are built to be directly used in a browser.
|
|
||||||
|
|
||||||
Now, `index.html` should contain the following:
|
Now, `index.html` should contain the following:
|
||||||
|
|
||||||
@@ -108,33 +110,37 @@ Now, `index.html` should contain the following:
|
|||||||
<head>
|
<head>
|
||||||
<title>Hello Owl</title>
|
<title>Hello Owl</title>
|
||||||
<script src="owl.js"></script>
|
<script src="owl.js"></script>
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<script src="main.js" type="module"></script>
|
<script src="main.js" type="module"></script>
|
||||||
</body>
|
</head>
|
||||||
|
<body></body>
|
||||||
</html>
|
</html>
|
||||||
```
|
```
|
||||||
|
|
||||||
Not that the `main.js` script tag has the `type="module"` attribute. This means
|
Not that the `main.js` script tag has the `type="module"` attribute. This means
|
||||||
that the browser will parse the script as a module, and load all its dependencies.
|
that the browser will parse the script as a module, and load all its dependencies.
|
||||||
|
|
||||||
Here is the content of `root.js` and `main.js`:
|
Here is the content of `app.js` and `main.js`:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
// root.js ----------------------------------------------------------------------
|
// app.js ----------------------------------------------------------------------
|
||||||
const { Component, mount, xml } = owl;
|
const { Component, mount } = owl;
|
||||||
|
const { xml } = owl.tags;
|
||||||
|
|
||||||
export class Root extends Component {
|
export class App extends Component {
|
||||||
static template = xml`<div>Hello Owl</div>`;
|
static template = xml`<div>Hello Owl</div>`;
|
||||||
}
|
}
|
||||||
|
|
||||||
// main.js ---------------------------------------------------------------------
|
// main.js ---------------------------------------------------------------------
|
||||||
import { Root } from "./root.js";
|
import { App } from "./app.js";
|
||||||
|
|
||||||
mount(Root, document.body);
|
function setup() {
|
||||||
|
mount(App, { target: document.body });
|
||||||
|
}
|
||||||
|
|
||||||
|
owl.utils.whenReady(setup);
|
||||||
```
|
```
|
||||||
|
|
||||||
The `main.js` file imports the `root.js` file. Note that the import statement has
|
The `main.js` file import the `app.js` file. Note that the import statement has
|
||||||
a `.js` suffix, which is important. Most text editor can understand this syntax
|
a `.js` suffix, which is important. Most text editor can understand this syntax
|
||||||
and will provide autocompletion.
|
and will provide autocompletion.
|
||||||
|
|
||||||
@@ -187,11 +193,11 @@ hello_owl/
|
|||||||
index.html
|
index.html
|
||||||
src/
|
src/
|
||||||
components/
|
components/
|
||||||
Root.js
|
App.js
|
||||||
main.js
|
main.js
|
||||||
tests/
|
tests/
|
||||||
components/
|
components/
|
||||||
Root.test.js
|
App.test.js
|
||||||
helpers.js
|
helpers.js
|
||||||
.gitignore
|
.gitignore
|
||||||
package.json
|
package.json
|
||||||
@@ -218,15 +224,13 @@ Note that there are no `<script>` tag here. They will be injected by webpack.
|
|||||||
Now, let's have a look at the javascript files:
|
Now, let's have a look at the javascript files:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
// src/components/Root.js -------------------------------------------------------
|
// src/components/App.js -------------------------------------------------------
|
||||||
import { Component, xml, useState } from "@odoo/owl";
|
import { Component, tags, useState } from "@odoo/owl";
|
||||||
|
|
||||||
export class Root extends Component {
|
const { xml } = tags;
|
||||||
static template = xml`
|
|
||||||
<div t-on-click="update">
|
|
||||||
Hello <t t-esc="state.text"/>
|
|
||||||
</div>`;
|
|
||||||
|
|
||||||
|
export class App extends Component {
|
||||||
|
static template = xml`<div t-on-click="update">Hello <t t-esc="state.text"/></div>`;
|
||||||
state = useState({ text: "Owl" });
|
state = useState({ text: "Owl" });
|
||||||
update() {
|
update() {
|
||||||
this.state.text = this.state.text === "Owl" ? "World" : "Owl";
|
this.state.text = this.state.text === "Owl" ? "World" : "Owl";
|
||||||
@@ -235,12 +239,16 @@ export class Root extends Component {
|
|||||||
|
|
||||||
// src/main.js -----------------------------------------------------------------
|
// src/main.js -----------------------------------------------------------------
|
||||||
import { utils, mount } from "@odoo/owl";
|
import { utils, mount } from "@odoo/owl";
|
||||||
import { Root } from "./components/Root";
|
import { App } from "./components/App";
|
||||||
|
|
||||||
mount(Root, document.body);
|
function setup() {
|
||||||
|
mount(App, { target: document.body });
|
||||||
|
}
|
||||||
|
|
||||||
// tests/components/Root.test.js ------------------------------------------------
|
utils.whenReady(setup);
|
||||||
import { Root } from "../../src/components/Root";
|
|
||||||
|
// tests/components/App.test.js ------------------------------------------------
|
||||||
|
import { App } from "../../src/components/App";
|
||||||
import { makeTestFixture, nextTick, click } from "../helpers";
|
import { makeTestFixture, nextTick, click } from "../helpers";
|
||||||
import { mount } from "@odoo/owl";
|
import { mount } from "@odoo/owl";
|
||||||
|
|
||||||
@@ -254,9 +262,9 @@ afterEach(() => {
|
|||||||
fixture.remove();
|
fixture.remove();
|
||||||
});
|
});
|
||||||
|
|
||||||
describe("Root", () => {
|
describe("App", () => {
|
||||||
test("Works as expected...", async () => {
|
test("Works as expected...", async () => {
|
||||||
await mount(Root, fixture);
|
await mount(App, { target: fixture });
|
||||||
expect(fixture.innerHTML).toBe("<div>Hello Owl</div>");
|
expect(fixture.innerHTML).toBe("<div>Hello Owl</div>");
|
||||||
|
|
||||||
click(fixture, "div");
|
click(fixture, "div");
|
||||||
@@ -270,8 +278,9 @@ import { Component } from "@odoo/owl";
|
|||||||
import "regenerator-runtime/runtime";
|
import "regenerator-runtime/runtime";
|
||||||
|
|
||||||
export async function nextTick() {
|
export async function nextTick() {
|
||||||
await new Promise((resolve) => setTimeout(resolve));
|
return new Promise(function (resolve) {
|
||||||
await new Promise((resolve) => requestAnimationFrame(resolve));
|
setTimeout(() => Component.scheduler.requestAnimationFrame(() => resolve()));
|
||||||
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
export function makeTestFixture() {
|
export function makeTestFixture() {
|
||||||
|
|||||||
+279
-251
@@ -50,11 +50,10 @@ the following content:
|
|||||||
<meta charset="UTF-8" />
|
<meta charset="UTF-8" />
|
||||||
<title>OWL Todo App</title>
|
<title>OWL Todo App</title>
|
||||||
<link rel="stylesheet" href="app.css" />
|
<link rel="stylesheet" href="app.css" />
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
<script src="owl.js"></script>
|
<script src="owl.js"></script>
|
||||||
<script src="app.js"></script>
|
<script src="app.js"></script>
|
||||||
</body>
|
</head>
|
||||||
|
<body></body>
|
||||||
</html>
|
</html>
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -72,34 +71,44 @@ Note that we put everything inside an immediately executed function to avoid lea
|
|||||||
anything to the global scope.
|
anything to the global scope.
|
||||||
|
|
||||||
Finally, `owl.js` should be the last version downloaded from the Owl repository (you can use `owl.min.js` if you prefer). Be aware that you should download the `owl.iife.js` or `owl.iife.min.js`, because these files
|
Finally, `owl.js` should be the last version downloaded from the Owl repository (you can use `owl.min.js` if you prefer). Be aware that you should download the `owl.iife.js` or `owl.iife.min.js`, because these files
|
||||||
are built to run directly on the browser, and rename it `owl.js` (other files such as `owl.cjs.js` are
|
are built to run directly on the browser (other files such as `owl.cjs.js` are
|
||||||
built to be bundled by other tools).
|
built to be bundled by other tools).
|
||||||
|
|
||||||
Now, the project should be ready. Loading the `index.html` file into a browser
|
Now, the project should be ready. Loading the `index.html` file into a browser
|
||||||
should show an empty page, with the title `Owl Todo App`, and it should log a
|
should show an empty page, with the title `Owl Todo App`, and it should log a
|
||||||
message such as `hello owl 2.x.y` in the console.
|
message such as `hello owl 1.0.0` in the console.
|
||||||
|
|
||||||
## 2. Adding a first component
|
## 2. Adding a first component
|
||||||
|
|
||||||
An Owl application is made out of [components](../reference/component.md), with
|
An Owl application is made out of [components](../reference/component.md), with
|
||||||
a single root component. Let us start by defining a `Root` component. Replace the
|
a single root component. Let us start by defining an `App` component. Replace the
|
||||||
content of the function in `app.js` by the following code:
|
content of the function in `app.js` by the following code:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
const { Component, mount, xml } = owl;
|
const { Component, mount } = owl;
|
||||||
|
const { xml } = owl.tags;
|
||||||
|
const { whenReady } = owl.utils;
|
||||||
|
|
||||||
// Owl Components
|
// Owl Components
|
||||||
class Root extends Component {
|
class App extends Component {
|
||||||
static template = xml`<div>todo app</div>`;
|
static template = xml`<div>todo app</div>`;
|
||||||
}
|
}
|
||||||
|
|
||||||
mount(Root, document.body);
|
// Setup code
|
||||||
|
function setup() {
|
||||||
|
mount(App, { target: document.body });
|
||||||
|
}
|
||||||
|
|
||||||
|
whenReady(setup);
|
||||||
```
|
```
|
||||||
|
|
||||||
Now, reloading the page in a browser should display a message.
|
Now, reloading the page in a browser should display a message.
|
||||||
|
|
||||||
The code is pretty simple: we define a component with an inline template, then
|
The code is pretty simple, but let us explain the last line in more detail. The
|
||||||
mount it in the document body.
|
browser tries to execute the javascript code in `app.js` as quickly as possible,
|
||||||
|
and it could happen that the DOM is not ready yet when we try to mount the `App`
|
||||||
|
component. To avoid this situation, we use the [`whenReady`](../reference/utils.md#whenready)
|
||||||
|
helper to delay the execution of the `setup` function until the DOM is ready.
|
||||||
|
|
||||||
Note 1: in a larger project, we would split the code in multiple files, with
|
Note 1: in a larger project, we would split the code in multiple files, with
|
||||||
components in a sub folder, and a main file that would initialize the application.
|
components in a sub folder, and a main file that would initialize the application.
|
||||||
@@ -140,20 +149,20 @@ with the following keys:
|
|||||||
tasks. Since the title is something created/edited by the user, it offers
|
tasks. Since the title is something created/edited by the user, it offers
|
||||||
no guarantee that it is unique. So, we will generate a unique `id` number for
|
no guarantee that it is unique. So, we will generate a unique `id` number for
|
||||||
each task.
|
each task.
|
||||||
- `text`: a string, to explain what the task is about.
|
- `title`: a string, to explain what the task is about.
|
||||||
- `isCompleted`: a boolean, to keep track of the status of the task
|
- `isCompleted`: a boolean, to keep track of the status of the task
|
||||||
|
|
||||||
Now that we decided on the internal format of the state, let us add some demo
|
Now that we decided on the internal format of the state, let us add some demo
|
||||||
data and a template to the `App` component:
|
data and a template to the `App` component:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
class Root extends Component {
|
class App extends Component {
|
||||||
static template = xml/* xml */ `
|
static template = xml/* xml */ `
|
||||||
<div class="task-list">
|
<div class="task-list">
|
||||||
<t t-foreach="tasks" t-as="task" t-key="task.id">
|
<t t-foreach="tasks" t-as="task" t-key="task.id">
|
||||||
<div class="task">
|
<div class="task">
|
||||||
<input type="checkbox" t-att-checked="task.isCompleted"/>
|
<input type="checkbox" t-att-checked="task.isCompleted"/>
|
||||||
<span><t t-esc="task.text"/></span>
|
<span><t t-esc="task.title"/></span>
|
||||||
</div>
|
</div>
|
||||||
</t>
|
</t>
|
||||||
</div>`;
|
</div>`;
|
||||||
@@ -161,12 +170,12 @@ class Root extends Component {
|
|||||||
tasks = [
|
tasks = [
|
||||||
{
|
{
|
||||||
id: 1,
|
id: 1,
|
||||||
text: "buy milk",
|
title: "buy milk",
|
||||||
isCompleted: true,
|
isCompleted: true,
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
id: 2,
|
id: 2,
|
||||||
text: "clean house",
|
title: "clean house",
|
||||||
isCompleted: false,
|
isCompleted: false,
|
||||||
},
|
},
|
||||||
];
|
];
|
||||||
@@ -236,25 +245,29 @@ a little bit:
|
|||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Task Component
|
// Task Component
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
class Task extends Component {
|
const TASK_TEMPLATE = xml /* xml */`
|
||||||
static template = xml /* xml */`
|
|
||||||
<div class="task" t-att-class="props.task.isCompleted ? 'done' : ''">
|
<div class="task" t-att-class="props.task.isCompleted ? 'done' : ''">
|
||||||
<input type="checkbox" t-att-checked="props.task.isCompleted"/>
|
<input type="checkbox" t-att-checked="props.task.isCompleted"/>
|
||||||
<span><t t-esc="props.task.title"/></span>
|
<span><t t-esc="props.task.title"/></span>
|
||||||
</div>`;
|
</div>`;
|
||||||
|
|
||||||
|
class Task extends Component {
|
||||||
|
static template = TASK_TEMPLATE;
|
||||||
static props = ["task"];
|
static props = ["task"];
|
||||||
}
|
}
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Root Component
|
// App Component
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
class Root extends Component {
|
const APP_TEMPLATE = xml /* xml */`
|
||||||
static template = xml /* xml */`
|
|
||||||
<div class="task-list">
|
<div class="task-list">
|
||||||
<t t-foreach="tasks" t-as="task" t-key="task.id">
|
<t t-foreach="tasks" t-as="task" t-key="task.id">
|
||||||
<Task task="task"/>
|
<Task task="task"/>
|
||||||
</t>
|
</t>
|
||||||
</div>`;
|
</div>`;
|
||||||
|
|
||||||
|
class App extends Component {
|
||||||
|
static template = APP_TEMPLATE;
|
||||||
static components = { Task };
|
static components = { Task };
|
||||||
|
|
||||||
tasks = [
|
tasks = [
|
||||||
@@ -263,9 +276,14 @@ class Root extends Component {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Setup
|
// Setup code
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
mount(Root, document.body, {dev: true});
|
function setup() {
|
||||||
|
owl.config.mode = "dev";
|
||||||
|
mount(App, { target: document.body });
|
||||||
|
}
|
||||||
|
|
||||||
|
whenReady(setup);
|
||||||
```
|
```
|
||||||
|
|
||||||
A lot of stuff happened here:
|
A lot of stuff happened here:
|
||||||
@@ -274,22 +292,24 @@ A lot of stuff happened here:
|
|||||||
- whenever we define a sub component, it needs to be added to the static
|
- whenever we define a sub component, it needs to be added to the static
|
||||||
[`components`](../reference/component.md#static-properties)
|
[`components`](../reference/component.md#static-properties)
|
||||||
key of its parent, so Owl can get a reference to it,
|
key of its parent, so Owl can get a reference to it,
|
||||||
|
- the templates have been extracted out of the components, to make it easier to
|
||||||
|
differentiate the "view/template" code from the "script/behavior" code,
|
||||||
- the `Task` component has a `props` key: this is only useful for validation
|
- the `Task` component has a `props` key: this is only useful for validation
|
||||||
purpose. It says that each `Task` should be given exactly one prop, named
|
purpose. It says that each `Task` should be given exactly one prop, named
|
||||||
`task`. If this is not the case, Owl will throw an
|
`task`. If this is not the case, Owl will throw an
|
||||||
[error](../reference/props_validation.md). This is extremely
|
[error](../reference/props_validation.md). This is extremely
|
||||||
useful when refactoring components
|
useful when refactoring components
|
||||||
- finally, to activate the props validation, we need to set Owl's
|
- finally, to activate the props validation, we need to set Owl's
|
||||||
[mode](../reference/config.md#mode) to `dev`. This is done in the last argument
|
[mode](../reference/config.md#mode) to `dev`. This is done in the `setup`
|
||||||
of the `mount` function. Note that this should be removed when an app is used in a real
|
function. Note that this should be removed when an app is used in a real
|
||||||
production environment, since `dev` mode is slightly slower, due to extra
|
production environment, since `dev` mode is slightly slower, due to extra
|
||||||
checks and validations.
|
checks and validations.
|
||||||
|
|
||||||
## 6. Adding tasks (part 1)
|
## 6. Adding tasks (part 1)
|
||||||
|
|
||||||
We still use a list of hardcoded tasks. It's really time to give the user a way
|
We still use a list of hardcoded tasks. It's really time to give the user a way
|
||||||
to add tasks himself. The first step is to add an input to the `Root` component.
|
to add tasks himself. The first step is to add an input to the `App` component.
|
||||||
But this input will be outside of the task list, so we need to adapt `Root`
|
But this input will be outside of the task list, so we need to adapt `App`
|
||||||
template, js, and css:
|
template, js, and css:
|
||||||
|
|
||||||
```xml
|
```xml
|
||||||
@@ -307,9 +327,9 @@ template, js, and css:
|
|||||||
addTask(ev) {
|
addTask(ev) {
|
||||||
// 13 is keycode for ENTER
|
// 13 is keycode for ENTER
|
||||||
if (ev.keyCode === 13) {
|
if (ev.keyCode === 13) {
|
||||||
const text = ev.target.value.trim();
|
const title = ev.target.value.trim();
|
||||||
ev.target.value = "";
|
ev.target.value = "";
|
||||||
console.log('adding task', text);
|
console.log('adding task', title);
|
||||||
// todo
|
// todo
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -338,9 +358,10 @@ task. Notice that when you load the page, the input is not focused. But adding
|
|||||||
tasks is a core feature of a task list, so let us make it as fast as possible by
|
tasks is a core feature of a task list, so let us make it as fast as possible by
|
||||||
focusing the input.
|
focusing the input.
|
||||||
|
|
||||||
We need to execute code when the `Root` component is ready (mounted). Let's do
|
Since `App` is a component, it has a
|
||||||
that using the `onMounted` hook. We will also need to get a reference to the
|
[`mounted` lifecycle method](../reference/component.md#lifecycle) that we can
|
||||||
input, by using the `t-ref` directive with the [`useRef`](../reference/hooks.md#useref) hook:
|
implement. We will also need to get a reference to the input, by using the
|
||||||
|
`t-ref` directive with the [`useRef`](../reference/hooks.md#useref) hook:
|
||||||
|
|
||||||
```xml
|
```xml
|
||||||
<input placeholder="Enter a new task" t-on-keyup="addTask" t-ref="add-input"/>
|
<input placeholder="Enter a new task" t-on-keyup="addTask" t-ref="add-input"/>
|
||||||
@@ -348,21 +369,22 @@ input, by using the `t-ref` directive with the [`useRef`](../reference/hooks.md#
|
|||||||
|
|
||||||
```js
|
```js
|
||||||
// on top of file:
|
// on top of file:
|
||||||
const { Component, mount, xml, useRef, onMounted } = owl;
|
const { useRef } = owl.hooks;
|
||||||
```
|
```
|
||||||
|
|
||||||
```js
|
```js
|
||||||
// in App
|
// in App
|
||||||
setup() {
|
inputRef = useRef("add-input");
|
||||||
const inputRef = useRef("add-input");
|
|
||||||
onMounted(() => inputRef.el.focus());
|
mounted() {
|
||||||
|
this.inputRef.el.focus();
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
This is a very common situation: whenever we need to perform some actions depending
|
The `inputRef` is defined as a class field, so it is equivalent to defining it
|
||||||
on the lifecycle of a component, we need to do it in the `setup` method, by using
|
in the constructor. It simply instructs Owl to keep a reference to anything with
|
||||||
one of the lifecycle hook. Here, we first get a reference to the `inputRef`,
|
the corresponding `t-ref` keyword. We then implement the `mounted` lifecycle
|
||||||
then in the `onMounted` hook, we simply focus the html element.
|
method, where we now have an active reference that we can use to focus the input.
|
||||||
|
|
||||||
## 7. Adding tasks (part 2)
|
## 7. Adding tasks (part 2)
|
||||||
|
|
||||||
@@ -383,12 +405,12 @@ Now, the `addTask` method can be implemented:
|
|||||||
addTask(ev) {
|
addTask(ev) {
|
||||||
// 13 is keycode for ENTER
|
// 13 is keycode for ENTER
|
||||||
if (ev.keyCode === 13) {
|
if (ev.keyCode === 13) {
|
||||||
const text = ev.target.value.trim();
|
const title = ev.target.value.trim();
|
||||||
ev.target.value = "";
|
ev.target.value = "";
|
||||||
if (text) {
|
if (title) {
|
||||||
const newTask = {
|
const newTask = {
|
||||||
id: this.nextId++,
|
id: this.nextId++,
|
||||||
text: text,
|
title: title,
|
||||||
isCompleted: false,
|
isCompleted: false,
|
||||||
};
|
};
|
||||||
this.tasks.push(newTask);
|
this.tasks.push(newTask);
|
||||||
@@ -406,7 +428,7 @@ the user interface. We can fix the issue by making `tasks` reactive, with the
|
|||||||
|
|
||||||
```js
|
```js
|
||||||
// on top of the file
|
// on top of the file
|
||||||
const { Component, mount, xml, useRef, onMounted, useState } = owl;
|
const { useRef, useState } = owl.hooks;
|
||||||
|
|
||||||
// replace the task definition in App with the following:
|
// replace the task definition in App with the following:
|
||||||
tasks = useState([]);
|
tasks = useState([]);
|
||||||
@@ -421,8 +443,12 @@ did not change in opacity. This is because there is no code to modify the
|
|||||||
`isCompleted` flag.
|
`isCompleted` flag.
|
||||||
|
|
||||||
Now, this is an interesting situation: the task is displayed by the `Task`
|
Now, this is an interesting situation: the task is displayed by the `Task`
|
||||||
component, but it is not the owner of its state, so ideally, it should not modify it.
|
component, but it is not the owner of its state, so it cannot modify it. Instead,
|
||||||
However, for now, that's what we will do (this will be improved in a later step).
|
we want to communicate the request to toggle a task to the `App` component.
|
||||||
|
Since `App` is a parent of `Task`, we can
|
||||||
|
[trigger](../reference/event_handling.md) an event in `Task` and listen
|
||||||
|
for it in `App`.
|
||||||
|
|
||||||
In `Task`, change the `input` to:
|
In `Task`, change the `input` to:
|
||||||
|
|
||||||
```xml
|
```xml
|
||||||
@@ -433,23 +459,36 @@ and add the `toggleTask` method:
|
|||||||
|
|
||||||
```js
|
```js
|
||||||
toggleTask() {
|
toggleTask() {
|
||||||
this.props.task.isCompleted = !this.props.task.isCompleted;
|
this.trigger('toggle-task', {id: this.props.task.id});
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
We now need to listen for that event in the `App` template:
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<div class="task-list" t-on-toggle-task="toggleTask">
|
||||||
|
```
|
||||||
|
|
||||||
|
and implement the `toggleTask` code:
|
||||||
|
|
||||||
|
```js
|
||||||
|
toggleTask(ev) {
|
||||||
|
const task = this.tasks.find(t => t.id === ev.detail.id);
|
||||||
|
task.isCompleted = !task.isCompleted;
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
## 9. Deleting tasks
|
## 9. Deleting tasks
|
||||||
|
|
||||||
Let us now add the possibility do delete tasks. This is different from the previous
|
Let us now add the possibility do delete tasks. To do that, we first need to add
|
||||||
feature: deleting task has to be done on the task itself, but the actual operation
|
a trash icon on each task, then we will proceed just like in the previous section.
|
||||||
need to be done on the task list. So, we need to communicate the request to the
|
|
||||||
`Root` component. This is usually done by providing a callback in a prop.
|
|
||||||
|
|
||||||
First, let us update the `Task` template, css and js:
|
First, let us update the `Task` template, css and js:
|
||||||
|
|
||||||
```xml
|
```xml
|
||||||
<div class="task" t-att-class="props.task.isCompleted ? 'done' : ''">
|
<div class="task" t-att-class="props.task.isCompleted ? 'done' : ''">
|
||||||
<input type="checkbox" t-att-checked="props.task.isCompleted" t-on-click="toggleTask"/>
|
<input type="checkbox" t-att-checked="props.task.isCompleted" t-on-click="toggleTask"/>
|
||||||
<span><t t-esc="props.task.text"/></span>
|
<span><t t-esc="props.task.title"/></span>
|
||||||
<span class="delete" t-on-click="deleteTask">🗑</span>
|
<span class="delete" t-on-click="deleteTask">🗑</span>
|
||||||
</div>
|
</div>
|
||||||
```
|
```
|
||||||
@@ -478,183 +517,194 @@ First, let us update the `Task` template, css and js:
|
|||||||
```
|
```
|
||||||
|
|
||||||
```js
|
```js
|
||||||
static props = ["task", "onDelete"];
|
|
||||||
|
|
||||||
deleteTask() {
|
deleteTask() {
|
||||||
this.props.onDelete(this.props.task);
|
this.trigger('delete-task', {id: this.props.task.id});
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
And now, we need to provide the `onDelete` callback to each tasks in the `Root`
|
And now, we need to listen to the `delete-task` event in `App`:
|
||||||
component:
|
|
||||||
|
|
||||||
```xml
|
```xml
|
||||||
<Task task="task" onDelete.bind="deleteTask"/>
|
<div class="task-list" t-on-toggle-task="toggleTask" t-on-delete-task="deleteTask">
|
||||||
```
|
```
|
||||||
|
|
||||||
```js
|
```js
|
||||||
deleteTask(task) {
|
deleteTask(ev) {
|
||||||
const index = this.tasks.findIndex(t => t.id === task.id);
|
const index = this.tasks.findIndex(t => t.id === ev.detail.id);
|
||||||
this.tasks.splice(index, 1);
|
this.tasks.splice(index, 1);
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Notice that the `onDelete` prop is defined with a `.bind` suffix: this is a special
|
|
||||||
suffix that makes sure the function callback is bound to the component.
|
|
||||||
|
|
||||||
## 10. Using a store
|
## 10. Using a store
|
||||||
|
|
||||||
Looking at the code, it is apparent that all the code handling tasks is scattered
|
Looking at the code, it is apparent that we now have code to handle tasks
|
||||||
all around the application. Also, it mixes UI code and business logic
|
scattered in more than one place. Also, it mixes UI code and business logic
|
||||||
code. Owl does not provide any high level abstraction to manage business logic,
|
code. Owl has a way to manage state separately from the user interface: a
|
||||||
but it is easy to do it with the basic reactivity primitives (`useState` and `reactive`).
|
[`Store`](../reference/store.md).
|
||||||
|
|
||||||
Let us use it in our application to implement a central store. This is a pretty
|
Let us use it in our application. This is a pretty large refactoring (for our
|
||||||
large refactoring (for our application), since it involves extracting all task
|
application), since it involves extracting all task related code out of the
|
||||||
related code out of the components. Here is the new content of the `app.js` file:
|
components. Here is the new content of the `app.js` file:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
const { Component, mount, xml, useRef, onMounted, useState, reactive, useEnv } = owl;
|
const { Component, Store, mount } = owl;
|
||||||
|
const { xml } = owl.tags;
|
||||||
|
const { whenReady } = owl.utils;
|
||||||
|
const { useRef, useDispatch, useStore } = owl.hooks;
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Store
|
// Store
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
function useStore() {
|
const actions = {
|
||||||
const env = useEnv();
|
addTask({ state }, title) {
|
||||||
return useState(env.store);
|
title = title.trim();
|
||||||
}
|
if (title) {
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
|
||||||
// TaskList
|
|
||||||
// -------------------------------------------------------------------------
|
|
||||||
class TaskList {
|
|
||||||
nextId = 1;
|
|
||||||
tasks = [];
|
|
||||||
|
|
||||||
addTask(text) {
|
|
||||||
text = text.trim();
|
|
||||||
if (text) {
|
|
||||||
const task = {
|
const task = {
|
||||||
id: this.nextId++,
|
id: state.nextId++,
|
||||||
text: text,
|
title: title,
|
||||||
isCompleted: false,
|
isCompleted: false,
|
||||||
};
|
};
|
||||||
this.tasks.push(task);
|
state.tasks.push(task);
|
||||||
}
|
}
|
||||||
}
|
},
|
||||||
|
toggleTask({ state }, id) {
|
||||||
toggleTask(task) {
|
const task = state.tasks.find((t) => t.id === id);
|
||||||
task.isCompleted = !task.isCompleted;
|
task.isCompleted = !task.isCompleted;
|
||||||
}
|
},
|
||||||
|
deleteTask({ state }, id) {
|
||||||
deleteTask(task) {
|
const index = state.tasks.findIndex((t) => t.id === id);
|
||||||
const index = this.tasks.findIndex((t) => t.id === task.id);
|
state.tasks.splice(index, 1);
|
||||||
this.tasks.splice(index, 1);
|
},
|
||||||
}
|
};
|
||||||
}
|
const initialState = {
|
||||||
|
nextId: 1,
|
||||||
function createTaskStore() {
|
tasks: [],
|
||||||
return reactive(new TaskList());
|
};
|
||||||
}
|
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Task Component
|
// Task Component
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
class Task extends Component {
|
const TASK_TEMPLATE = xml/* xml */ `
|
||||||
static template = xml/* xml */ `
|
|
||||||
<div class="task" t-att-class="props.task.isCompleted ? 'done' : ''">
|
<div class="task" t-att-class="props.task.isCompleted ? 'done' : ''">
|
||||||
<input type="checkbox" t-att-checked="props.task.isCompleted" t-on-click="() => store.toggleTask(props.task)"/>
|
<input type="checkbox" t-att-checked="props.task.isCompleted"
|
||||||
<span><t t-esc="props.task.text"/></span>
|
t-on-click="dispatch('toggleTask', props.task.id)"/>
|
||||||
<span class="delete" t-on-click="() => store.deleteTask(props.task)">🗑</span>
|
<span><t t-esc="props.task.title"/></span>
|
||||||
|
<span class="delete" t-on-click="dispatch('deleteTask', props.task.id)">🗑</span>
|
||||||
</div>`;
|
</div>`;
|
||||||
|
|
||||||
|
class Task extends Component {
|
||||||
|
static template = TASK_TEMPLATE;
|
||||||
static props = ["task"];
|
static props = ["task"];
|
||||||
|
dispatch = useDispatch();
|
||||||
setup() {
|
|
||||||
this.store = useStore();
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Root Component
|
// App Component
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
class Root extends Component {
|
const APP_TEMPLATE = xml/* xml */ `
|
||||||
static template = xml/* xml */ `
|
|
||||||
<div class="todo-app">
|
<div class="todo-app">
|
||||||
<input placeholder="Enter a new task" t-on-keyup="addTask" t-ref="add-input"/>
|
<input placeholder="Enter a new task" t-on-keyup="addTask" t-ref="add-input"/>
|
||||||
<div class="task-list">
|
<div class="task-list">
|
||||||
<t t-foreach="store.tasks" t-as="task" t-key="task.id">
|
<t t-foreach="tasks" t-as="task" t-key="task.id">
|
||||||
<Task task="task"/>
|
<Task task="task"/>
|
||||||
</t>
|
</t>
|
||||||
</div>
|
</div>
|
||||||
</div>`;
|
</div>`;
|
||||||
|
|
||||||
|
class App extends Component {
|
||||||
|
static template = APP_TEMPLATE;
|
||||||
static components = { Task };
|
static components = { Task };
|
||||||
|
|
||||||
setup() {
|
inputRef = useRef("add-input");
|
||||||
const inputRef = useRef("add-input");
|
tasks = useStore((state) => state.tasks);
|
||||||
onMounted(() => inputRef.el.focus());
|
dispatch = useDispatch();
|
||||||
this.store = useStore();
|
|
||||||
|
mounted() {
|
||||||
|
this.inputRef.el.focus();
|
||||||
}
|
}
|
||||||
|
|
||||||
addTask(ev) {
|
addTask(ev) {
|
||||||
// 13 is keycode for ENTER
|
// 13 is keycode for ENTER
|
||||||
if (ev.keyCode === 13) {
|
if (ev.keyCode === 13) {
|
||||||
this.store.addTask(ev.target.value);
|
this.dispatch("addTask", ev.target.value);
|
||||||
ev.target.value = "";
|
ev.target.value = "";
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Setup
|
// Setup code
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
const env = {
|
function setup() {
|
||||||
store: createTaskStore(),
|
owl.config.mode = "dev";
|
||||||
};
|
const store = new Store({ actions, state: initialState });
|
||||||
mount(Root, document.body, { dev: true, env });
|
App.env.store = store;
|
||||||
|
mount(App, { target: document.body });
|
||||||
|
}
|
||||||
|
|
||||||
|
whenReady(setup);
|
||||||
```
|
```
|
||||||
|
|
||||||
## 11. Saving tasks in local storage
|
## 11-Saving tasks in local storage
|
||||||
|
|
||||||
Now, our TodoApp works great, except if the user closes or refresh the browser!
|
Now, our TodoApp works great, except if the user closes or refresh the browser!
|
||||||
It is really inconvenient to only keep the state of the application in memory.
|
It is really inconvenient to only keep the state of the application in memory.
|
||||||
To fix this, we will save the tasks in the local storage. With our current
|
To fix this, we will save the tasks in the local storage. With our current
|
||||||
codebase, it is a simple change: we need to save tasks to local storage and
|
codebase, it is a simple change: only the setup code needs to be updated.
|
||||||
listen to any change.
|
|
||||||
|
|
||||||
```js
|
```js
|
||||||
class TaskList {
|
function makeStore() {
|
||||||
constructor(tasks) {
|
const localState = window.localStorage.getItem("todoapp");
|
||||||
this.tasks = tasks || [];
|
const state = localState ? JSON.parse(localState) : initialState;
|
||||||
const taskIds = this.tasks.map((t) => t.id);
|
const store = new Store({ state, actions });
|
||||||
this.nextId = taskIds.length ? Math.max(...taskIds) + 1 : 1;
|
store.on("update", null, () => {
|
||||||
}
|
localStorage.setItem("todoapp", JSON.stringify(store.state));
|
||||||
// ...
|
});
|
||||||
|
return store;
|
||||||
}
|
}
|
||||||
|
|
||||||
function createTaskStore() {
|
function setup() {
|
||||||
const saveTasks = () => localStorage.setItem("todoapp", JSON.stringify(taskStore.tasks));
|
owl.config.mode = "dev";
|
||||||
const initialTasks = JSON.parse(localStorage.getItem("todoapp") || "[]");
|
const env = { store: makeStore() };
|
||||||
const taskStore = reactive(new TaskList(initialTasks), saveTasks);
|
mount(App, { target: document.body, env });
|
||||||
saveTasks();
|
|
||||||
return taskStore;
|
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
The key point is that the `reactive` function takes a callback that will be called
|
The key point is to use the fact that the store is an
|
||||||
every time an observed value is changed. Note that we need to call the `saveTasks`
|
[`EventBus`](../reference/event_bus.md) which triggers an `update` event
|
||||||
method initially to make sure we observe all current values.
|
whenever it is updated.
|
||||||
|
|
||||||
## 12. Filtering tasks
|
## 12. Filtering tasks
|
||||||
|
|
||||||
We are almost done, we can add/update/delete tasks. The only missing feature is
|
We are almost done, we can add/update/delete tasks. The only missing feature is
|
||||||
the possibility to display the task according to their completed status. We will
|
the possibility to display the task according to their completed status. We will
|
||||||
need to keep track of the state of the filter in `Root`, then filter the visible
|
need to keep track of the state of the filter in `App`, then filter the visible
|
||||||
tasks according to its value.
|
tasks according to its value.
|
||||||
|
|
||||||
```js
|
```js
|
||||||
class Root extends Component {
|
// on top of file, readd useState:
|
||||||
static template = xml /* xml */`
|
const { useRef, useDispatch, useState, useStore } = owl.hooks;
|
||||||
|
|
||||||
|
// in App:
|
||||||
|
filter = useState({value: "all"})
|
||||||
|
|
||||||
|
get displayedTasks() {
|
||||||
|
switch (this.filter.value) {
|
||||||
|
case "active": return this.tasks.filter(t => !t.isCompleted);
|
||||||
|
case "completed": return this.tasks.filter(t => t.isCompleted);
|
||||||
|
case "all": return this.tasks;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
setFilter(filter) {
|
||||||
|
this.filter.value = filter;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Finally, we need to display the visible filters. We can do that, and at the
|
||||||
|
same time, display the number of tasks in a small panel below the main list:
|
||||||
|
|
||||||
|
```xml
|
||||||
<div class="todo-app">
|
<div class="todo-app">
|
||||||
<input placeholder="Enter a new task" t-on-keyup="addTask" t-ref="add-input"/>
|
<input placeholder="Enter a new task" t-on-keyup="addTask" t-ref="add-input"/>
|
||||||
<div class="task-list">
|
<div class="task-list">
|
||||||
@@ -662,11 +712,11 @@ class Root extends Component {
|
|||||||
<Task task="task"/>
|
<Task task="task"/>
|
||||||
</t>
|
</t>
|
||||||
</div>
|
</div>
|
||||||
<div class="task-panel" t-if="store.tasks.length">
|
<div class="task-panel" t-if="tasks.length">
|
||||||
<div class="task-counter">
|
<div class="task-counter">
|
||||||
<t t-esc="displayedTasks.length"/>
|
<t t-esc="displayedTasks.length"/>
|
||||||
<t t-if="displayedTasks.length lt store.tasks.length">
|
<t t-if="displayedTasks.length lt tasks.length">
|
||||||
/ <t t-esc="store.tasks.length"/>
|
/ <t t-esc="tasks.length"/>
|
||||||
</t>
|
</t>
|
||||||
task(s)
|
task(s)
|
||||||
</div>
|
</div>
|
||||||
@@ -674,30 +724,11 @@ class Root extends Component {
|
|||||||
<span t-foreach="['all', 'active', 'completed']"
|
<span t-foreach="['all', 'active', 'completed']"
|
||||||
t-as="f" t-key="f"
|
t-as="f" t-key="f"
|
||||||
t-att-class="{active: filter.value===f}"
|
t-att-class="{active: filter.value===f}"
|
||||||
t-on-click="() => this.setFilter(f)"
|
t-on-click="setFilter(f)"
|
||||||
t-esc="f"/>
|
t-esc="f"/>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>`;
|
</div>
|
||||||
|
|
||||||
setup() {
|
|
||||||
...
|
|
||||||
this.filter = useState({ value: "all" });
|
|
||||||
}
|
|
||||||
|
|
||||||
get displayedTasks() {
|
|
||||||
const tasks = this.store.tasks;
|
|
||||||
switch (this.filter.value) {
|
|
||||||
case "active": return tasks.filter(t => !t.isCompleted);
|
|
||||||
case "completed": return tasks.filter(t => t.isCompleted);
|
|
||||||
case "all": return tasks;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
setFilter(filter) {
|
|
||||||
this.filter.value = filter;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
```
|
||||||
|
|
||||||
```css
|
```css
|
||||||
@@ -722,8 +753,8 @@ class Root extends Component {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Notice here that we set dynamically the css class of the filter with the object
|
Notice here that we set dynamically the class of the filter with the object
|
||||||
syntax.
|
syntax: each key is a class that we want to set if its value is truthy.
|
||||||
|
|
||||||
## 13. The Final Touch
|
## 13. The Final Touch
|
||||||
|
|
||||||
@@ -738,16 +769,16 @@ the user experience.
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
2. Make the text of a task clickable, to toggle its checkbox:
|
2. Make the title of a task clickable, to toggle its checkbox:
|
||||||
|
|
||||||
```xml
|
```xml
|
||||||
<input type="checkbox" t-att-checked="props.task.isCompleted"
|
<input type="checkbox" t-att-checked="props.task.isCompleted"
|
||||||
t-att-id="props.task.id"
|
t-att-id="props.task.id"
|
||||||
t-on-click="dispatch('toggleTask', props.task.id)"/>
|
t-on-click="dispatch('toggleTask', props.task.id)"/>
|
||||||
<label t-att-for="props.task.id"><t t-esc="props.task.text"/></label>
|
<label t-att-for="props.task.id"><t t-esc="props.task.title"/></label>
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Strike the text of completed task:
|
3. Strike the title of completed task:
|
||||||
|
|
||||||
```css
|
```css
|
||||||
.task.done label {
|
.task.done label {
|
||||||
@@ -779,94 +810,73 @@ For reference, here is the final code:
|
|||||||
|
|
||||||
```js
|
```js
|
||||||
(function () {
|
(function () {
|
||||||
const { Component, mount, xml, useRef, onMounted, useState, reactive, useEnv } = owl;
|
const { Component, Store, mount } = owl;
|
||||||
|
const { xml } = owl.tags;
|
||||||
|
const { whenReady } = owl.utils;
|
||||||
|
const { useRef, useDispatch, useState, useStore } = owl.hooks;
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Store
|
// Store
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
function useStore() {
|
const actions = {
|
||||||
const env = useEnv();
|
addTask({ state }, title) {
|
||||||
return useState(env.store);
|
title = title.trim();
|
||||||
}
|
if (title) {
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
|
||||||
// TaskList
|
|
||||||
// -------------------------------------------------------------------------
|
|
||||||
class TaskList {
|
|
||||||
constructor(tasks) {
|
|
||||||
this.tasks = tasks || [];
|
|
||||||
const taskIds = this.tasks.map((t) => t.id);
|
|
||||||
this.nextId = taskIds.length ? Math.max(...taskIds) + 1 : 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
addTask(text) {
|
|
||||||
text = text.trim();
|
|
||||||
if (text) {
|
|
||||||
const task = {
|
const task = {
|
||||||
id: this.nextId++,
|
id: state.nextId++,
|
||||||
text: text,
|
title: title,
|
||||||
isCompleted: false,
|
isCompleted: false,
|
||||||
};
|
};
|
||||||
this.tasks.push(task);
|
state.tasks.push(task);
|
||||||
}
|
}
|
||||||
}
|
},
|
||||||
|
toggleTask({ state }, id) {
|
||||||
toggleTask(task) {
|
const task = state.tasks.find((t) => t.id === id);
|
||||||
task.isCompleted = !task.isCompleted;
|
task.isCompleted = !task.isCompleted;
|
||||||
}
|
},
|
||||||
|
deleteTask({ state }, id) {
|
||||||
|
const index = state.tasks.findIndex((t) => t.id === id);
|
||||||
|
state.tasks.splice(index, 1);
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
deleteTask(task) {
|
const initialState = {
|
||||||
const index = this.tasks.findIndex((t) => t.id === task.id);
|
nextId: 1,
|
||||||
this.tasks.splice(index, 1);
|
tasks: [],
|
||||||
}
|
};
|
||||||
}
|
|
||||||
|
|
||||||
function createTaskStore() {
|
|
||||||
const saveTasks = () => localStorage.setItem("todoapp", JSON.stringify(taskStore.tasks));
|
|
||||||
const initialTasks = JSON.parse(localStorage.getItem("todoapp") || "[]");
|
|
||||||
const taskStore = reactive(new TaskList(initialTasks), saveTasks);
|
|
||||||
saveTasks();
|
|
||||||
return taskStore;
|
|
||||||
}
|
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Task Component
|
// Task Component
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
class Task extends Component {
|
const TASK_TEMPLATE = xml/* xml */ `
|
||||||
static template = xml/* xml */ `
|
|
||||||
<div class="task" t-att-class="props.task.isCompleted ? 'done' : ''">
|
<div class="task" t-att-class="props.task.isCompleted ? 'done' : ''">
|
||||||
<input type="checkbox"
|
<input type="checkbox" t-att-checked="props.task.isCompleted"
|
||||||
t-att-id="props.task.id"
|
t-att-id="props.task.id"
|
||||||
t-att-checked="props.task.isCompleted"
|
t-on-click="dispatch('toggleTask', props.task.id)"/>
|
||||||
t-on-click="() => store.toggleTask(props.task)"/>
|
<label t-att-for="props.task.id"><t t-esc="props.task.title"/></label>
|
||||||
<label t-att-for="props.task.id"><t t-esc="props.task.text"/></label>
|
<span class="delete" t-on-click="dispatch('deleteTask', props.task.id)">🗑</span>
|
||||||
<span class="delete" t-on-click="() => store.deleteTask(props.task)">🗑</span>
|
|
||||||
</div>`;
|
</div>`;
|
||||||
|
|
||||||
|
class Task extends Component {
|
||||||
|
static template = TASK_TEMPLATE;
|
||||||
static props = ["task"];
|
static props = ["task"];
|
||||||
|
dispatch = useDispatch();
|
||||||
setup() {
|
|
||||||
this.store = useStore();
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Root Component
|
// App Component
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
class Root extends Component {
|
const APP_TEMPLATE = xml/* xml */ `
|
||||||
static template = xml/* xml */ `
|
|
||||||
<div class="todo-app">
|
<div class="todo-app">
|
||||||
<input placeholder="Enter a new task" t-on-keyup="addTask" t-ref="add-input"/>
|
<input placeholder="Enter a new task" t-on-keyup="addTask" t-ref="add-input"/>
|
||||||
<div class="task-list">
|
<div class="task-list">
|
||||||
<t t-foreach="displayedTasks" t-as="task" t-key="task.id">
|
<Task t-foreach="displayedTasks" t-as="task" t-key="task.id" task="task"/>
|
||||||
<Task task="task"/>
|
|
||||||
</t>
|
|
||||||
</div>
|
</div>
|
||||||
<div class="task-panel" t-if="store.tasks.length">
|
<div class="task-panel" t-if="tasks.length">
|
||||||
<div class="task-counter">
|
<div class="task-counter">
|
||||||
<t t-esc="displayedTasks.length"/>
|
<t t-esc="displayedTasks.length"/>
|
||||||
<t t-if="displayedTasks.length lt store.tasks.length">
|
<t t-if="displayedTasks.length lt tasks.length">
|
||||||
/ <t t-esc="store.tasks.length"/>
|
/ <t t-esc="tasks.length"/>
|
||||||
</t>
|
</t>
|
||||||
task(s)
|
task(s)
|
||||||
</div>
|
</div>
|
||||||
@@ -874,50 +884,68 @@ For reference, here is the final code:
|
|||||||
<span t-foreach="['all', 'active', 'completed']"
|
<span t-foreach="['all', 'active', 'completed']"
|
||||||
t-as="f" t-key="f"
|
t-as="f" t-key="f"
|
||||||
t-att-class="{active: filter.value===f}"
|
t-att-class="{active: filter.value===f}"
|
||||||
t-on-click="() => this.setFilter(f)"
|
t-on-click="setFilter(f)"
|
||||||
t-esc="f"/>
|
t-esc="f"/>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>`;
|
</div>`;
|
||||||
|
|
||||||
|
class App extends Component {
|
||||||
|
static template = APP_TEMPLATE;
|
||||||
static components = { Task };
|
static components = { Task };
|
||||||
|
|
||||||
setup() {
|
inputRef = useRef("add-input");
|
||||||
const inputRef = useRef("add-input");
|
tasks = useStore((state) => state.tasks);
|
||||||
onMounted(() => inputRef.el.focus());
|
filter = useState({ value: "all" });
|
||||||
this.store = useStore();
|
dispatch = useDispatch();
|
||||||
this.filter = useState({ value: "all" });
|
|
||||||
|
mounted() {
|
||||||
|
this.inputRef.el.focus();
|
||||||
}
|
}
|
||||||
|
|
||||||
addTask(ev) {
|
addTask(ev) {
|
||||||
// 13 is keycode for ENTER
|
// 13 is keycode for ENTER
|
||||||
if (ev.keyCode === 13) {
|
if (ev.keyCode === 13) {
|
||||||
this.store.addTask(ev.target.value);
|
this.dispatch("addTask", ev.target.value);
|
||||||
ev.target.value = "";
|
ev.target.value = "";
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
get displayedTasks() {
|
get displayedTasks() {
|
||||||
const tasks = this.store.tasks;
|
|
||||||
switch (this.filter.value) {
|
switch (this.filter.value) {
|
||||||
case "active":
|
case "active":
|
||||||
return tasks.filter((t) => !t.isCompleted);
|
return this.tasks.filter((t) => !t.isCompleted);
|
||||||
case "completed":
|
case "completed":
|
||||||
return tasks.filter((t) => t.isCompleted);
|
return this.tasks.filter((t) => t.isCompleted);
|
||||||
case "all":
|
case "all":
|
||||||
return tasks;
|
return this.tasks;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
setFilter(filter) {
|
setFilter(filter) {
|
||||||
this.filter.value = filter;
|
this.filter.value = filter;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
// Setup
|
// Setup code
|
||||||
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
||||||
const env = { store: createTaskStore() };
|
function makeStore() {
|
||||||
mount(Root, document.body, { dev: true, env });
|
const localState = window.localStorage.getItem("todoapp");
|
||||||
|
const state = localState ? JSON.parse(localState) : initialState;
|
||||||
|
const store = new Store({ state, actions });
|
||||||
|
store.on("update", null, () => {
|
||||||
|
localStorage.setItem("todoapp", JSON.stringify(store.state));
|
||||||
|
});
|
||||||
|
return store;
|
||||||
|
}
|
||||||
|
|
||||||
|
function setup() {
|
||||||
|
owl.config.mode = "dev";
|
||||||
|
const env = { store: makeStore() };
|
||||||
|
mount(App, { target: document.body, env });
|
||||||
|
}
|
||||||
|
|
||||||
|
whenReady(setup);
|
||||||
})();
|
})();
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
@@ -14,7 +14,8 @@ discussed, feel free to open an issue/submit a PR to correct this text.
|
|||||||
- [Tooling/Build Step](#toolingbuild-step)
|
- [Tooling/Build Step](#toolingbuild-step)
|
||||||
- [Templating](#templating)
|
- [Templating](#templating)
|
||||||
- [Asynchronous rendering](#asynchronous-rendering)
|
- [Asynchronous rendering](#asynchronous-rendering)
|
||||||
- [Reactivity](#reactivity)
|
- [Reactiveness](#reactiveness)
|
||||||
|
- [State Management](#state-management)
|
||||||
- [Hooks](#hooks)
|
- [Hooks](#hooks)
|
||||||
|
|
||||||
## Size
|
## Size
|
||||||
@@ -172,7 +173,7 @@ more convoluted. For example, in Vue, you need to use a dynamic import keyword
|
|||||||
that needs to be transpiled at build time in order for the component to be loaded
|
that needs to be transpiled at build time in order for the component to be loaded
|
||||||
asynchronously (see [the documentation](https://vuejs.org/v2/guide/components-dynamic-async.html#Async-Components)).
|
asynchronously (see [the documentation](https://vuejs.org/v2/guide/components-dynamic-async.html#Async-Components)).
|
||||||
|
|
||||||
## Reactivity
|
## Reactiveness
|
||||||
|
|
||||||
React has a simple model: whenever the state changes, it is
|
React has a simple model: whenever the state changes, it is
|
||||||
replaced with a new state (via the `setState` method). Then, the DOM is patched.
|
replaced with a new state (via the `setState` method). Then, the DOM is patched.
|
||||||
@@ -188,6 +189,95 @@ with a `Proxy`, which means that it is totally transparent to the developers.
|
|||||||
Adding new keys is supported. Once any part of the state has been changed, a
|
Adding new keys is supported. Once any part of the state has been changed, a
|
||||||
rendering is scheduled in the next microtask tick (promise queue).
|
rendering is scheduled in the next microtask tick (promise queue).
|
||||||
|
|
||||||
|
## State Management
|
||||||
|
|
||||||
|
Managing the state of an application is a tricky issue. Many solutions have
|
||||||
|
been proposed these last few years. It also depends on the kind of application we
|
||||||
|
are talking about. A small application may not need much more than a simple
|
||||||
|
object to contain its state.
|
||||||
|
|
||||||
|
However, there are some common solutions for React and Vue: redux and vuex.
|
||||||
|
Both of them are a centralized store that own the state, and they dictate how
|
||||||
|
the state can be mutated.
|
||||||
|
|
||||||
|
**Redux**
|
||||||
|
|
||||||
|
In Redux, the state is mutated by reducers. Reducers are functions
|
||||||
|
that modify the state by returning a different object:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
...
|
||||||
|
switch (action.type) {
|
||||||
|
case ADD_TODO: {
|
||||||
|
const { id, content } = action.payload;
|
||||||
|
return {
|
||||||
|
...state,
|
||||||
|
allIds: [...state.allIds, id],
|
||||||
|
byIds: {
|
||||||
|
...state.byIds,
|
||||||
|
[id]: {
|
||||||
|
content,
|
||||||
|
completed: false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
This is a little bit awkward to write, but this allows the component system to
|
||||||
|
check if a part of the state was changed. This is exactly what is done by the
|
||||||
|
`connect` function: it create a _connected_ component, which is subscribed to
|
||||||
|
the state and triggers a rerender if some part of the state was modified.
|
||||||
|
|
||||||
|
**VueX**
|
||||||
|
|
||||||
|
VueX is based on a different principle: the state is mutated through
|
||||||
|
some special functions (the mutations), which modify the state in place:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
function ({state}, payload) {
|
||||||
|
const { id, content } = payload;
|
||||||
|
const message = {id, content, completed: false};
|
||||||
|
state.messages.push(message)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
This is simpler, but there is a little bit more happening behind the scene:
|
||||||
|
each key from the state is silently replaced by getters and setters, and VueX
|
||||||
|
keeps track of who get data, and retrigger a render when it was changed.
|
||||||
|
|
||||||
|
**Owl**
|
||||||
|
|
||||||
|
Owl store is a little bit like a mix of redux and vuex: it has actions (but not
|
||||||
|
mutations), and like VueX, it keeps track of the state changes. However, it does
|
||||||
|
not notify a component when the state changes. Instead, components need to connect
|
||||||
|
to the store like in redux, with the `useStore` hook (see the [store documentation](../reference/store.md#connecting-a-component)).
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
const actions = {
|
||||||
|
increment({ state }, val) {
|
||||||
|
state.counter.value += val;
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
const state = {
|
||||||
|
counter: { value: 0 },
|
||||||
|
};
|
||||||
|
const store = new owl.Store({ state, actions });
|
||||||
|
|
||||||
|
class Counter extends Component {
|
||||||
|
static template = xml`
|
||||||
|
<button t-name="Counter" t-on-click="dispatch('increment')">
|
||||||
|
Click Me! [<t t-esc="counter.value"/>]
|
||||||
|
</button>`;
|
||||||
|
counter = useStore((state) => state.counter);
|
||||||
|
dispatch = useDispatch();
|
||||||
|
}
|
||||||
|
|
||||||
|
Counter.env.store = store;
|
||||||
|
const counter = new Counter();
|
||||||
|
```
|
||||||
|
|
||||||
## Hooks
|
## Hooks
|
||||||
|
|
||||||
[Hooks](https://reactjs.org/docs/hooks-intro.html#motivation) recently took over
|
[Hooks](https://reactjs.org/docs/hooks-intro.html#motivation) recently took over
|
||||||
@@ -252,4 +342,4 @@ class Example extends Component {
|
|||||||
|
|
||||||
Since the Owl framework had hooks from early in its life, its main APIs
|
Since the Owl framework had hooks from early in its life, its main APIs
|
||||||
are designed to be interacted with hooks from the start. For example, the
|
are designed to be interacted with hooks from the start. For example, the
|
||||||
`Context` abstraction.
|
`Context` and `Store` abstractions.
|
||||||
|
|||||||
@@ -0,0 +1,57 @@
|
|||||||
|
# 🦉 OWL Documentation 🦉
|
||||||
|
|
||||||
|
## Learning Owl
|
||||||
|
|
||||||
|
Are you new to Owl? This is the place to start!
|
||||||
|
|
||||||
|
- [Tutorial: create a TodoList application](learning/tutorial_todoapp.md)
|
||||||
|
- [Quick Overview](learning/overview.md)
|
||||||
|
- [How to start an Owl project](learning/quick_start.md)
|
||||||
|
- [How to test Components](learning/how_to_test.md)
|
||||||
|
- [How to write Single File Components](learning/how_to_write_sfc.md)
|
||||||
|
- [How to write debug Owl applications](learning/how_to_debug.md)
|
||||||
|
|
||||||
|
## Reference
|
||||||
|
|
||||||
|
You will find here a complete reference of every feature, class or object
|
||||||
|
provided by Owl.
|
||||||
|
|
||||||
|
- [Animations](reference/animations.md)
|
||||||
|
- [Browser](reference/browser.md)
|
||||||
|
- [Component](reference/component.md)
|
||||||
|
- [Content](reference/content.md)
|
||||||
|
- [Concurrency Model](reference/concurrency_model.md)
|
||||||
|
- [Configuration](reference/config.md)
|
||||||
|
- [Context](reference/context.md)
|
||||||
|
- [Environment](reference/environment.md)
|
||||||
|
- [Event Bus](reference/event_bus.md)
|
||||||
|
- [Event Handling](reference/event_handling.md)
|
||||||
|
- [Error Handling](reference/error_handling.md)
|
||||||
|
- [Hooks](reference/hooks.md)
|
||||||
|
- [Mounting a component](reference/mounting.md)
|
||||||
|
- [Miscellaneous Components](reference/misc.md)
|
||||||
|
- [Observer](reference/observer.md)
|
||||||
|
- [Props](reference/props.md)
|
||||||
|
- [Props Validation](reference/props_validation.md)
|
||||||
|
- [QWeb Templating Language](reference/qweb_templating_language.md)
|
||||||
|
- [QWeb Engine](reference/qweb_engine.md)
|
||||||
|
- [Router](reference/router.md)
|
||||||
|
- [Store](reference/store.md)
|
||||||
|
- [Slots](reference/slots.md)
|
||||||
|
- [Tags](reference/tags.md)
|
||||||
|
- [Utils](reference/utils.md)
|
||||||
|
|
||||||
|
## Other Topics
|
||||||
|
|
||||||
|
This section provides miscellaneous document that explains some topics
|
||||||
|
which cannot be considered either a tutorial, or reference documentation.
|
||||||
|
|
||||||
|
- [Owl architecture: the Virtual DOM](miscellaneous/vdom.md)
|
||||||
|
- [Owl architecture: the rendering pipeline](miscellaneous/rendering.md)
|
||||||
|
- [Comparison with React/Vue](miscellaneous/comparison.md)
|
||||||
|
- [Why did Odoo built Owl?](miscellaneous/why_owl.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Found an issue in the documentation? A broken link? Some outdated information?
|
||||||
|
Please open an issue or submit a PR!
|
||||||
@@ -263,7 +263,7 @@ We explain here all the public methods of the `Component` class.
|
|||||||
|
|
||||||
Note that if a component is mounted, unmounted and remounted, it will be
|
Note that if a component is mounted, unmounted and remounted, it will be
|
||||||
automatically re-rendered to ensure that changes in its state (or something
|
automatically re-rendered to ensure that changes in its state (or something
|
||||||
in the environment) will be taken into account.
|
in the environment, or in the store, or ...) will be taken into account.
|
||||||
|
|
||||||
If a component is mounted inside an element or a fragment which is not in the
|
If a component is mounted inside an element or a fragment which is not in the
|
||||||
DOM, then it will be rendered fully, but not active: the `mounted` hooks will
|
DOM, then it will be rendered fully, but not active: the `mounted` hooks will
|
||||||
|
|||||||
@@ -158,10 +158,12 @@ There are two different common problems with Owl asynchronous rendering model:
|
|||||||
Here are a few tips on how to work with asynchronous components:
|
Here are a few tips on how to work with asynchronous components:
|
||||||
|
|
||||||
1. Minimize the use of asynchronous components!
|
1. Minimize the use of asynchronous components!
|
||||||
2. Lazy loading external libraries is a good use case for async rendering. This
|
2. Maybe move the asynchronous logic in a store, which then triggers (mostly)
|
||||||
|
synchronous renderings
|
||||||
|
3. Lazy loading external libraries is a good use case for async rendering. This
|
||||||
is mostly fine, because we can assume that it will only takes a fraction of a
|
is mostly fine, because we can assume that it will only takes a fraction of a
|
||||||
second, and only once (see [`owl.utils.loadJS`](utils.md#loadjs))
|
second, and only once (see [`owl.utils.loadJS`](utils.md#loadjs))
|
||||||
3. For all the other cases, the [`AsyncRoot`](misc.md#asyncroot) component is there to help you. When
|
4. For all the other cases, the [`AsyncRoot`](misc.md#asyncroot) component is there to help you. When
|
||||||
this component is met, a new rendering
|
this component is met, a new rendering
|
||||||
sub tree is created, such that the rendering of that component (and its
|
sub tree is created, such that the rendering of that component (and its
|
||||||
children) is not tied to the rendering of the rest of the interface. It can
|
children) is not tied to the rendering of the rest of the interface. It can
|
||||||
|
|||||||
+18
-14
@@ -11,26 +11,30 @@ browser
|
|||||||
Component misc
|
Component misc
|
||||||
Context AsyncRoot
|
Context AsyncRoot
|
||||||
QWeb Portal
|
QWeb Portal
|
||||||
mount
|
mount router
|
||||||
useState tags
|
Store Link
|
||||||
config css
|
useState RouteComponent
|
||||||
mode xml
|
config Router
|
||||||
core utils
|
mode
|
||||||
EventBus debounce
|
core tags
|
||||||
Observer escape
|
EventBus css
|
||||||
hooks loadJS
|
Observer xml
|
||||||
onWillStart loadFile
|
hooks utils
|
||||||
onMounted shallowEqual
|
onWillStart debounce
|
||||||
onWillUpdateProps whenReady
|
onMounted escape
|
||||||
onWillPatch
|
onWillUpdateProps loadJS
|
||||||
onPatched
|
onWillPatch loadFile
|
||||||
onWillUnmount
|
onPatched shallowEqual
|
||||||
|
onWillUnmount whenReady
|
||||||
useContext
|
useContext
|
||||||
useState
|
useState
|
||||||
useRef
|
useRef
|
||||||
useComponent
|
useComponent
|
||||||
useEnv
|
useEnv
|
||||||
useSubEnv
|
useSubEnv
|
||||||
|
useStore
|
||||||
|
useDispatch
|
||||||
|
useGetters
|
||||||
```
|
```
|
||||||
|
|
||||||
Note that for convenience, the `useState` hook is also exported at the root of the `owl` object.
|
Note that for convenience, the `useState` hook is also exported at the root of the `owl` object.
|
||||||
|
|||||||
@@ -23,3 +23,5 @@ Its API is:
|
|||||||
| `off(eventType, owner)` | remove all listeners for an owner |
|
| `off(eventType, owner)` | remove all listeners for an owner |
|
||||||
| `trigger(eventType, ...args)` | trigger an event |
|
| `trigger(eventType, ...args)` | trigger an event |
|
||||||
| `clear` | remove all subscriptions |
|
| `clear` | remove all subscriptions |
|
||||||
|
|
||||||
|
Note that the [`Store`](store.md) is an example of an `EventBus`.
|
||||||
|
|||||||
@@ -18,6 +18,9 @@
|
|||||||
- [`useRef`](#useref)
|
- [`useRef`](#useref)
|
||||||
- [`useSubEnv`](#usesubenv)
|
- [`useSubEnv`](#usesubenv)
|
||||||
- [`useExternalListener`](#useexternallistener)
|
- [`useExternalListener`](#useexternallistener)
|
||||||
|
- [`useStore`](#usestore)
|
||||||
|
- [`useDispatch`](#usedispatch)
|
||||||
|
- [`useGetters`](#usegetters)
|
||||||
- [`useComponent`](#usecomponent)
|
- [`useComponent`](#usecomponent)
|
||||||
- [`useEnv`](#useenv)
|
- [`useEnv`](#useenv)
|
||||||
- [Making customized hooks](#making-customized-hooks)
|
- [Making customized hooks](#making-customized-hooks)
|
||||||
@@ -372,6 +375,21 @@ to be closed:
|
|||||||
useExternalListener(window, "click", this.closeMenu);
|
useExternalListener(window, "click", this.closeMenu);
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### `useStore`
|
||||||
|
|
||||||
|
The `useStore` hook is the entry point for a component to connect to the store.
|
||||||
|
See the [store documentation](store.md) for more information.
|
||||||
|
|
||||||
|
### `useDispatch`
|
||||||
|
|
||||||
|
The `useDispatch` hook is the way for components to get a reference to the store
|
||||||
|
`dispatch` function. See the [store documentation](store.md) for more information.
|
||||||
|
|
||||||
|
### `useGetters`
|
||||||
|
|
||||||
|
The `useGetters` hook is the way for components to get a reference to the store
|
||||||
|
getters. See the [store documentation](store.md) for more information.
|
||||||
|
|
||||||
### `useComponent`
|
### `useComponent`
|
||||||
|
|
||||||
The `useComponent` hook is useful as a building block for some customized hooks,
|
The `useComponent` hook is useful as a building block for some customized hooks,
|
||||||
|
|||||||
@@ -105,8 +105,6 @@ between Owl classes. This is the reason why `QWeb` actually extends [EventBus](e
|
|||||||
|
|
||||||
### Translations
|
### Translations
|
||||||
|
|
||||||
take care of this and "cherry-pick" 8464a1b04e7469434f9dcb3d68a543f58cb61b8e
|
|
||||||
|
|
||||||
If properly setup, Owl QWeb engine can translate all rendered templates. To do
|
If properly setup, Owl QWeb engine can translate all rendered templates. To do
|
||||||
so, it needs a translate function, which takes a string and returns a string.
|
so, it needs a translate function, which takes a string and returns a string.
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,181 @@
|
|||||||
|
# 🦉 Router 🦉
|
||||||
|
|
||||||
|
## Content
|
||||||
|
|
||||||
|
- [Overview](#overview)
|
||||||
|
- [Example](#example)
|
||||||
|
- [Reference](#reference)
|
||||||
|
- [Route Definition](#route-definition)
|
||||||
|
- [Router](#router)
|
||||||
|
- [Navigation Guards](#navigation-guards)
|
||||||
|
- [RouteComponent](#routecomponent)
|
||||||
|
- [Link](#link)
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
It is often useful to organize an application around urls. If the application is
|
||||||
|
a single page application, then we need a way to manage those urls in the browser.
|
||||||
|
This is why there are many different routers for different frameworks. A generic
|
||||||
|
router can do the job just fine, but a specialized router for Owl can give a
|
||||||
|
better developer experience.
|
||||||
|
|
||||||
|
The Owl router support the following features:
|
||||||
|
|
||||||
|
- `history` or `hash` mode
|
||||||
|
- declarative routes
|
||||||
|
- route redirection
|
||||||
|
- navigation guards
|
||||||
|
- parameterized routes
|
||||||
|
- a `<Link/>` component
|
||||||
|
- a `<RouteComponent/>` component
|
||||||
|
|
||||||
|
Note that it is still in early stage of developments, and there are probably
|
||||||
|
still some issues.
|
||||||
|
|
||||||
|
## Example
|
||||||
|
|
||||||
|
To use the Owl router, there are some steps that needs to be done:
|
||||||
|
|
||||||
|
- declare some routes
|
||||||
|
- create a router
|
||||||
|
- add it to the environment
|
||||||
|
|
||||||
|
```js
|
||||||
|
async function protectRoute({ env, to }) {
|
||||||
|
if (!env.session.authUser) {
|
||||||
|
env.session.setNextRoute(to.name);
|
||||||
|
return { to: "SIGN_IN" };
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const ROUTES = [
|
||||||
|
{ name: "LANDING", path: "/", component: Landing },
|
||||||
|
{ name: "TASK", path: "/tasks/{{id}}", component: Task },
|
||||||
|
{ name: "SIGN_UP", path: "/signup", component: SignUp },
|
||||||
|
{ name: "SIGN_IN", path: "/signin", component: SignIn },
|
||||||
|
{ name: "ADMIN", path: "/admin", component: Admin, beforeRouteEnter: protectRoute },
|
||||||
|
{ name: "ACCOUNT", path: "/account", component: Account, beforeRouteEnter: protectRoute },
|
||||||
|
{ name: "UNKNOWN", path: "*", redirect: { to: "LANDING" } }
|
||||||
|
];
|
||||||
|
|
||||||
|
function makeEnvironment() {
|
||||||
|
...
|
||||||
|
const env = { qweb };
|
||||||
|
env.session = new Session(env);
|
||||||
|
env.router = new owl.router.Router(env, ROUTES);
|
||||||
|
await env.router.start();
|
||||||
|
return env;
|
||||||
|
}
|
||||||
|
|
||||||
|
App.env = makeEnvironment();
|
||||||
|
// create root component here
|
||||||
|
```
|
||||||
|
|
||||||
|
Notice that the router needs to be started. This is an asynchronous operation
|
||||||
|
because it needs to apply the potential navigation guards on the current route
|
||||||
|
(which may or may not mean that the application is redirected to another route).
|
||||||
|
|
||||||
|
## Reference
|
||||||
|
|
||||||
|
### Route definition
|
||||||
|
|
||||||
|
A route need to be defined as an object with the following keys:
|
||||||
|
|
||||||
|
- `name` (optional): a (unique) string useful to identify the current route. If not
|
||||||
|
given, it will be assigned an automatic name,
|
||||||
|
- `path`: a string describing the url. It can be static: `/admin` or dynamic: `/users/{{id}}`.
|
||||||
|
It also can be `*`, to catch all remaining routes.
|
||||||
|
- `component` (optional): an Owl component that will be used by the `t-routecomponent`
|
||||||
|
directive if the route is active
|
||||||
|
- `redirect` (optional): should be destination object (with optional keys `path`, `to` and `params`) if given, the application will be redirected to the destination whenever we match this route
|
||||||
|
- `beforeRouteEnter`: defines a [navigation guard](#navigation-guards).
|
||||||
|
|
||||||
|
### `Router`
|
||||||
|
|
||||||
|
The `Router` constructor takes three arguments:
|
||||||
|
|
||||||
|
- `env`: a valid environment,
|
||||||
|
- a list of routes,
|
||||||
|
- an optional object (with the only key `mode` which can be `history` (default
|
||||||
|
value) or `hash`).
|
||||||
|
|
||||||
|
`history` will use the browser [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) as the mechanism to manage URL.\
|
||||||
|
Example: `https://yourdomain.tld/my_custom_route`.\
|
||||||
|
For this mechanism to work, you need a way to configure your web server accordingly.
|
||||||
|
|
||||||
|
`hash` will manipulate the hash of the URL.\
|
||||||
|
Example: `https://yourdomain.tld/index.html#/my_custom_route`.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const ROUTES = [...];
|
||||||
|
const router = new owl.router.Router(env, ROUTES, {mode: 'history'});
|
||||||
|
```
|
||||||
|
|
||||||
|
Note that the route are defined in a list, and the order matters: the router
|
||||||
|
tries to find a match by going down the list.
|
||||||
|
|
||||||
|
The router needs to be added to the environment in the `router` sub key.
|
||||||
|
|
||||||
|
Once a router is created, it needs to be started. This is necessary to initialize
|
||||||
|
its current state to the current URL (and also, to potentially apply any
|
||||||
|
navigation guards and/or redirecting).
|
||||||
|
|
||||||
|
```js
|
||||||
|
await router.start();
|
||||||
|
```
|
||||||
|
|
||||||
|
Once started, the router will keep track of the current url and reflect its
|
||||||
|
value in two keys:
|
||||||
|
|
||||||
|
- `router.currentRoute`
|
||||||
|
- `router.currentParams`
|
||||||
|
|
||||||
|
The router also has a `navigate` method, useful to programmatically change the
|
||||||
|
application to another state (and the url):
|
||||||
|
|
||||||
|
```js
|
||||||
|
router.navigate({ to: "USER", params: { id: 51 } });
|
||||||
|
```
|
||||||
|
|
||||||
|
### Navigation Guards
|
||||||
|
|
||||||
|
Navigation guards are very useful to be able to execute some business logic/
|
||||||
|
perform some actions or redirect to other routes whenever the application is
|
||||||
|
entering a new route. For example, the following guard checks if there is an
|
||||||
|
authenticated user, and if it is not the case, redirect to the sign in route.
|
||||||
|
|
||||||
|
```js
|
||||||
|
async function protectRoute({ env, to }) {
|
||||||
|
if (!env.session.authUser) {
|
||||||
|
env.session.setNextRoute(to.name);
|
||||||
|
return { to: "SIGN_IN" };
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
A navigation guard is a function that returns a promise, which either resolves
|
||||||
|
to `true` (the navigation is accepted), or to another destination object.
|
||||||
|
|
||||||
|
### `RouteComponent`
|
||||||
|
|
||||||
|
The `RouteComponent` component directs Owl to render the component associated
|
||||||
|
to the currently active route (if any):
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<div t-name="App">
|
||||||
|
<NavBar />
|
||||||
|
<RouteComponent />
|
||||||
|
</div>
|
||||||
|
```
|
||||||
|
|
||||||
|
### `Link`
|
||||||
|
|
||||||
|
The `Link` component is a Owl component which render as a `<a>` tag with any
|
||||||
|
content. It will compute the proper href from its props, and allow Owl to
|
||||||
|
properly navigate to a given url if clicked on it.
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<Link to="'HOME'">Home</Link>
|
||||||
|
```
|
||||||
@@ -0,0 +1,349 @@
|
|||||||
|
# 🦉 Store 🦉
|
||||||
|
|
||||||
|
## Content
|
||||||
|
|
||||||
|
- [Overview](#overview)
|
||||||
|
- [Example](#example)
|
||||||
|
- [Reference](#reference)
|
||||||
|
- [Store](#store)
|
||||||
|
- [Actions](#actions)
|
||||||
|
- [Getters](#getters)
|
||||||
|
- [Connecting a Component](#connecting-a-component)
|
||||||
|
- [`useStore`](#usestore)
|
||||||
|
- [`useDispatch`](#usedispatch)
|
||||||
|
- [`useGetters`](#usegetters)
|
||||||
|
- [Semantics](#semantics)
|
||||||
|
- [Good Practices](#good-practices)
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
Managing the state in an application is not an easy task. In some cases, the
|
||||||
|
state of an application can be part of the component tree, in a natural way.
|
||||||
|
However, there are situations where some parts of the state need to be displayed
|
||||||
|
in various parts of the user interface, and then, it is not obvious which
|
||||||
|
component should own which part of the state.
|
||||||
|
|
||||||
|
Owl's solution to this issue is a centralized store. It is a class that owns
|
||||||
|
some (or all) state, and lets the developer update it in a structured way, with
|
||||||
|
`actions`. Owl components can then connect to the store to read their relevant
|
||||||
|
state, and they will be rerendered if the state is updated.
|
||||||
|
|
||||||
|
Note: Owl store is inspired by React Redux and VueX.
|
||||||
|
|
||||||
|
## Example
|
||||||
|
|
||||||
|
Here is what a simple store looks like:
|
||||||
|
|
||||||
|
```js
|
||||||
|
const actions = {
|
||||||
|
addTodo({ state }, message) {
|
||||||
|
state.todos.push({
|
||||||
|
id: state.nextId++,
|
||||||
|
message,
|
||||||
|
isCompleted: false,
|
||||||
|
});
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
const state = {
|
||||||
|
todos: [],
|
||||||
|
nextId: 1,
|
||||||
|
};
|
||||||
|
|
||||||
|
const store = new owl.Store({ state, actions });
|
||||||
|
store.on("update", null, () => console.log(store.state));
|
||||||
|
|
||||||
|
// updating the state
|
||||||
|
store.dispatch("addTodo", "fix all bugs");
|
||||||
|
```
|
||||||
|
|
||||||
|
This example shows how a store can be defined and used. Note that in most cases,
|
||||||
|
actions will be dispatched by connected components.
|
||||||
|
|
||||||
|
## Reference
|
||||||
|
|
||||||
|
### `Store`
|
||||||
|
|
||||||
|
The store is a simple [`owl.EventBus`](event_bus.md) that triggers `update` events
|
||||||
|
whenever its state is changed. Note that these events are triggered only after a
|
||||||
|
microtask tick, so only one event will be triggered for any number of state changes in a
|
||||||
|
call stack.
|
||||||
|
|
||||||
|
Also, it is important to mention that the state is observed (with an `owl.Observer`),
|
||||||
|
which is the reason why it is able to know if it was changed. See the
|
||||||
|
[Observer](observer.md)'s documentation for more details.
|
||||||
|
|
||||||
|
The `Store` class is quite small. It has two public methods:
|
||||||
|
|
||||||
|
- its constructor
|
||||||
|
- `dispatch`
|
||||||
|
|
||||||
|
The constructor takes a configuration object with four (optional) keys:
|
||||||
|
|
||||||
|
- the initial state
|
||||||
|
- the actions
|
||||||
|
- the getters
|
||||||
|
- the environment
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
const config = {
|
||||||
|
state,
|
||||||
|
actions,
|
||||||
|
getters,
|
||||||
|
env,
|
||||||
|
};
|
||||||
|
const store = new Store(config);
|
||||||
|
```
|
||||||
|
|
||||||
|
### Actions
|
||||||
|
|
||||||
|
Actions are used to coordinate state changes. It can be used for both synchronous
|
||||||
|
and asynchronous logic.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const actions = {
|
||||||
|
async login({ state }, info) {
|
||||||
|
state.loginState = "pending";
|
||||||
|
try {
|
||||||
|
const loginInfo = await doSomeRPC("/login/", info);
|
||||||
|
state.loginState = loginInfo;
|
||||||
|
} catch (e) {
|
||||||
|
state.loginState = "error";
|
||||||
|
}
|
||||||
|
},
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
The first argument to an action method is an object with four keys:
|
||||||
|
|
||||||
|
- `state`: the current state of the store content,
|
||||||
|
- `dispatch`: a function that can be used to dispatch other actions,
|
||||||
|
- `getters`: an object containing all getters defined in the store,
|
||||||
|
- `env`: the current environment. This is useful sometimes, in particular if
|
||||||
|
an action needs to apply some side effects (such as performing an rpc), and
|
||||||
|
the `rpc` method is located in the environment.
|
||||||
|
|
||||||
|
Actions are called with the `dispatch` method on the store, and can receive an
|
||||||
|
arbitrary number of arguments.
|
||||||
|
|
||||||
|
```js
|
||||||
|
store.dispatch("login", someInfo);
|
||||||
|
```
|
||||||
|
|
||||||
|
Note that anything returned by an action will also be returned by the `dispatch`
|
||||||
|
call.
|
||||||
|
|
||||||
|
Also, it is important to be aware that we need to be careful with asynchronous
|
||||||
|
logic. Each state change will potentially trigger a rerendering, so we need to
|
||||||
|
make sure that we do not have a partially corrupted state. Here is an example that
|
||||||
|
is likely not a good idea:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
const actions = {
|
||||||
|
async fetchSomeData({ state }, recordId) {
|
||||||
|
state.recordId = recordId;
|
||||||
|
const data = await doSomeRPC("/read/", recordId);
|
||||||
|
state.recordData = data;
|
||||||
|
},
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
In the previous example, there is a period of time in which the state has a
|
||||||
|
`recordId` which does not correspond to the `recordData`. It is more likely that
|
||||||
|
we want an atomic update: updating the `recordId` at the same time as the `recordData`
|
||||||
|
values:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
const actions = {
|
||||||
|
async fetchSomeData({ state }, recordId) {
|
||||||
|
const data = await doSomeRPC("/read/", recordId);
|
||||||
|
state.recordId = recordId;
|
||||||
|
state.recordData = data;
|
||||||
|
},
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
### Getters
|
||||||
|
|
||||||
|
Usually, data contained in the store will be stored in a normalized way. For
|
||||||
|
example,
|
||||||
|
|
||||||
|
```js
|
||||||
|
{
|
||||||
|
posts: [{id: 11, authorId: 4, content: 'Greetings'}],
|
||||||
|
authors: [{id: 4, name: 'John'}]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
However, the user interface will probably need some denormalized data like
|
||||||
|
|
||||||
|
```js
|
||||||
|
{id: 11, author: {id: 4, name: 'John'}, content: 'Greetings'}
|
||||||
|
```
|
||||||
|
|
||||||
|
This is what `getters` are for: they give a centralized way to process and
|
||||||
|
transform the data contained in the store.
|
||||||
|
|
||||||
|
```js
|
||||||
|
const getters = {
|
||||||
|
getPost({ state }, id) {
|
||||||
|
const post = state.posts.find((p) => p.id === id);
|
||||||
|
const author = state.authors.find((a) => a.id === post.id);
|
||||||
|
return {
|
||||||
|
id,
|
||||||
|
author,
|
||||||
|
content: post.content,
|
||||||
|
};
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
// somewhere else
|
||||||
|
const post = store.getters.getPost(id);
|
||||||
|
```
|
||||||
|
|
||||||
|
Getters take _at most_ one argument.
|
||||||
|
|
||||||
|
Note that getters are not cached.
|
||||||
|
|
||||||
|
### Connecting a Component
|
||||||
|
|
||||||
|
At some point, we need a way to interact with the store from a component. This
|
||||||
|
means that the component needs a reference to the store. By default, it looks
|
||||||
|
for it in the `env.store` key. However, this can be configured with the `useStore`
|
||||||
|
hook.
|
||||||
|
|
||||||
|
Every component-store interactions are done with the help of the three store hooks:
|
||||||
|
|
||||||
|
- [`useStore`](#usestore) to subscribe a component to some part of the store state,
|
||||||
|
- [`useDispatch`](#usedispatch) to get a reference to a dispatch function,
|
||||||
|
- [`useGetters`](#usegetters) to get a reference to the getters defined in the store.
|
||||||
|
|
||||||
|
Assume we have this store:
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
const actions = {
|
||||||
|
increment({ state }, val) {
|
||||||
|
state.counter.value += val;
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
const state = {
|
||||||
|
counter: { value: 0 },
|
||||||
|
};
|
||||||
|
const store = new owl.Store({ state, actions });
|
||||||
|
```
|
||||||
|
|
||||||
|
To make it accessible to the complete application, we will put it in the
|
||||||
|
environment:
|
||||||
|
|
||||||
|
```js
|
||||||
|
// in this example, the root component is App
|
||||||
|
App.env.store = store;
|
||||||
|
```
|
||||||
|
|
||||||
|
A counter component can then select this value and dispatch an action like this:
|
||||||
|
|
||||||
|
```js
|
||||||
|
class Counter extends Component {
|
||||||
|
counter = useStore((state) => state.counter);
|
||||||
|
dispatch = useDispatch();
|
||||||
|
}
|
||||||
|
|
||||||
|
const counter = new Counter({ store, qweb });
|
||||||
|
```
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<button t-name="Counter" t-on-click="dispatch('increment')">
|
||||||
|
Click Me! [<t t-esc="counter.value"/>]
|
||||||
|
</button>
|
||||||
|
```
|
||||||
|
|
||||||
|
### `useStore`
|
||||||
|
|
||||||
|
The `useStore` hook is used to select some part of the store state. It accepts
|
||||||
|
two arguments:
|
||||||
|
|
||||||
|
- a selector function, which takes the store state as first argument (and the
|
||||||
|
component props as second argument) and which must return the part of the
|
||||||
|
store state that will be made available and observed for changes,
|
||||||
|
- optionally, an object which can have the following optional keys:
|
||||||
|
- a `store` key containing a store object if we want to use another store than
|
||||||
|
the default store,
|
||||||
|
- an `isEqual` key containing an equality function if we want to specialize
|
||||||
|
the comparison (the function must accept two arguments: the previous result
|
||||||
|
and the new result, and must return whether they are equal),
|
||||||
|
- and an `onUpdate` key containing an update function if we want to execute an
|
||||||
|
arbitrary code every time the selected state changes (the function will
|
||||||
|
receive one argument, the new result, and can execute arbitrary code).
|
||||||
|
|
||||||
|
If the `useStore` selector returns a sub part of the store state, the component
|
||||||
|
will only be rerendered whenever this part of the state changes. Otherwise, it
|
||||||
|
will perform a strict equality check (unless the `isEqual` option is defined,
|
||||||
|
then it will call it) and will update the component every time this check fails.
|
||||||
|
|
||||||
|
Note that if the selector function returns a primitive type, the result of
|
||||||
|
`useStore` will be immutable and it will not react to changes. In this case, it
|
||||||
|
is important to define the `onUpdate` option to properly update the value
|
||||||
|
manually when it changes.
|
||||||
|
|
||||||
|
Also, the return value from `useStore` is not supposed to be modified. The store
|
||||||
|
state should only be updated with actions.
|
||||||
|
|
||||||
|
### `useDispatch`
|
||||||
|
|
||||||
|
The `useDispatch` hook is useful when a component needs to be able to dispatch
|
||||||
|
actions. It takes an optional argument, which is a store. If not given, it will
|
||||||
|
use the store in the environment.
|
||||||
|
|
||||||
|
Note that a component does not need to be connected in any other way to the store.
|
||||||
|
For example:
|
||||||
|
|
||||||
|
```js
|
||||||
|
class DoSomethingButton extends Component {
|
||||||
|
static template = xml`<button t-on-click="dispatch('something')">Click</button>`;
|
||||||
|
dispatch = useDispatch();
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### `useGetters`
|
||||||
|
|
||||||
|
The `useGetters` hook is useful when a component needs to be able to use the
|
||||||
|
getters defined in a store. It takes an optional argument, which is a store. If
|
||||||
|
not given, it will use the store in the environment.
|
||||||
|
|
||||||
|
Note that a component does not need to be connected in any other way to the store.
|
||||||
|
For example:
|
||||||
|
|
||||||
|
```js
|
||||||
|
class InfoButton extends Component {
|
||||||
|
static template = xml`<span><t t-esc="getters.somevalue()"></span>`;
|
||||||
|
getters = useGetters();
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Semantics
|
||||||
|
|
||||||
|
The `Store` class and the `useStore` hook try to be smart and to optimize as much
|
||||||
|
as possible the rendering and update process. What is important to know is:
|
||||||
|
|
||||||
|
- components are always updated in the order of their creation (so, parent
|
||||||
|
before children),
|
||||||
|
- they are updated only if they are in the DOM,
|
||||||
|
- if a parent is asynchronous, the system will wait for it to complete its
|
||||||
|
update before updating other components,
|
||||||
|
- in general, updates are not coordinated. This is not a problem for synchronous
|
||||||
|
components, but if there are many asynchronous components, this could lead to
|
||||||
|
a situation where some part of the UI is updated and some other part of the UI is
|
||||||
|
not updated.
|
||||||
|
|
||||||
|
### Good Practices
|
||||||
|
|
||||||
|
- avoid asynchronous components as much as possible. Asynchronous components
|
||||||
|
lead to situations where parts of the UI is not updated immediately,
|
||||||
|
- do not be afraid to connect many components, parent or children if needed. For
|
||||||
|
example, a `MessageList` component could get a list of ids in its `useStore`
|
||||||
|
call and a `Message` component could get the data of its own
|
||||||
|
message,
|
||||||
|
- since the `useStore` function is called for each connected component,
|
||||||
|
for each state update, it is important to make sure that these functions are
|
||||||
|
as fast as possible.
|
||||||
+8
-13
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "@odoo/owl",
|
"name": "@odoo/owl",
|
||||||
"version": "2.0.0-alpha1",
|
"version": "1.4.6",
|
||||||
"description": "Odoo Web Library (OWL)",
|
"description": "Odoo Web Library (OWL)",
|
||||||
"main": "dist/owl.cjs.js",
|
"main": "dist/owl.cjs.js",
|
||||||
"browser": "dist/owl.iife.js",
|
"browser": "dist/owl.iife.js",
|
||||||
@@ -16,12 +16,11 @@
|
|||||||
"build:bundle": "rollup -c",
|
"build:bundle": "rollup -c",
|
||||||
"build": "npm run build:bundle",
|
"build": "npm run build:bundle",
|
||||||
"test": "jest",
|
"test": "jest",
|
||||||
"test:debug": "node --inspect-brk node_modules/.bin/jest --runInBand --watch",
|
|
||||||
"test:watch": "jest --watch",
|
"test:watch": "jest --watch",
|
||||||
"playground:serve": "python3 tools/server.py || python tools/server.py",
|
"tools:serve": "python3 tools/server.py || python tools/server.py",
|
||||||
"playground": "npm run build && npm run playground:serve",
|
"tools": "npm run build && npm run tools:serve",
|
||||||
"preplayground:watch": "npm run build",
|
"pretools:watch": "npm run build",
|
||||||
"playground:watch": "npm-run-all --parallel playground:serve \"build:* -- --watch\"",
|
"tools:watch": "npm-run-all --parallel tools:serve \"build:* -- --watch\"",
|
||||||
"prettier": "prettier {src/*.ts,src/**/*.ts,tests/*.ts,tests/**/*.ts,doc/*.md,doc/**/*.md} --write",
|
"prettier": "prettier {src/*.ts,src/**/*.ts,tests/*.ts,tests/**/*.ts,doc/*.md,doc/**/*.md} --write",
|
||||||
"check-formatting": "prettier {src/*.ts,src/**/*.ts,tests/*.ts,tests/**/*.ts,doc/*.md,doc/**/*.md} --check",
|
"check-formatting": "prettier {src/*.ts,src/**/*.ts,tests/*.ts,tests/**/*.ts,doc/*.md,doc/**/*.md} --check",
|
||||||
"publish": "npm run build && npm publish",
|
"publish": "npm run build && npm publish",
|
||||||
@@ -46,18 +45,17 @@
|
|||||||
"git-rev-sync": "^1.12.0",
|
"git-rev-sync": "^1.12.0",
|
||||||
"github-api": "^3.3.0",
|
"github-api": "^3.3.0",
|
||||||
"jest": "^27.1.0",
|
"jest": "^27.1.0",
|
||||||
"jest-diff": "^27.3.1",
|
|
||||||
"jest-environment-jsdom": "^27.1.0",
|
"jest-environment-jsdom": "^27.1.0",
|
||||||
"live-server": "^1.2.1",
|
"live-server": "^1.2.1",
|
||||||
"npm-run-all": "^4.1.5",
|
"npm-run-all": "^4.1.5",
|
||||||
"prettier": "2.4.1",
|
"prettier": "^2.0.4",
|
||||||
"rollup": "^2.56.3",
|
"rollup": "^2.56.3",
|
||||||
"rollup-plugin-terser": "^7.0.2",
|
"rollup-plugin-terser": "^7.0.2",
|
||||||
"rollup-plugin-typescript2": "^0.31.1",
|
"rollup-plugin-typescript2": "^0.30.0",
|
||||||
"sass": "^1.16.1",
|
"sass": "^1.16.1",
|
||||||
"source-map-support": "^0.5.10",
|
"source-map-support": "^0.5.10",
|
||||||
"ts-jest": "^27.0.5",
|
"ts-jest": "^27.0.5",
|
||||||
"typescript": "4.5.2",
|
"typescript": "^3.7.2",
|
||||||
"uglify-es": "^3.3.9"
|
"uglify-es": "^3.3.9"
|
||||||
},
|
},
|
||||||
"jest": {
|
"jest": {
|
||||||
@@ -66,9 +64,6 @@
|
|||||||
"<rootDir>/src",
|
"<rootDir>/src",
|
||||||
"<rootDir>/tests"
|
"<rootDir>/tests"
|
||||||
],
|
],
|
||||||
"setupFiles": [
|
|
||||||
"./tests/mocks/mockEventTarget.js"
|
|
||||||
],
|
|
||||||
"transform": {
|
"transform": {
|
||||||
"^.+\\.ts?$": "ts-jest"
|
"^.+\\.ts?$": "ts-jest"
|
||||||
},
|
},
|
||||||
|
|||||||
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
# 🦉 OWL Roadmap 🦉
|
# 🦉 OWL Roadmap 🦉
|
||||||
|
|
||||||
- Current version: 1.4.7
|
- Current version: 1.4.6
|
||||||
- Status: stable
|
- Status: stable
|
||||||
|
|
||||||
This roadmap is only an attempt at predicting Owl's future. Everything may
|
This roadmap is only an attempt at predicting Owl's future. Everything may
|
||||||
|
|||||||
@@ -40,7 +40,6 @@ function getConfigForFormat(format, generatedFileName, minified = false) {
|
|||||||
name: name,
|
name: name,
|
||||||
extend: extend,
|
extend: extend,
|
||||||
outro: outro,
|
outro: outro,
|
||||||
freeze: false,
|
|
||||||
plugins: minified ? [terser()] : [],
|
plugins: minified ? [terser()] : [],
|
||||||
indent: ' ', // indent with 4 spaces
|
indent: ' ', // indent with 4 spaces
|
||||||
};
|
};
|
||||||
|
|||||||
-105
@@ -1,105 +0,0 @@
|
|||||||
import { Component } from "../component/component";
|
|
||||||
import { ComponentNode } from "../component/component_node";
|
|
||||||
import { MountOptions } from "../component/fibers";
|
|
||||||
import { Scheduler } from "../component/scheduler";
|
|
||||||
import { TemplateSet, TemplateSetConfig } from "./template_set";
|
|
||||||
import { nodeErrorHandlers } from "../component/error_handling";
|
|
||||||
|
|
||||||
// reimplement dev mode stuff see last change in 0f7a8289a6fb8387c3c1af41c6664b2a8448758f
|
|
||||||
|
|
||||||
export interface Env {
|
|
||||||
[key: string]: any;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface AppConfig extends TemplateSetConfig {
|
|
||||||
env?: Env;
|
|
||||||
props?: any;
|
|
||||||
}
|
|
||||||
|
|
||||||
export const DEV_MSG = `Owl is running in 'dev' mode.
|
|
||||||
|
|
||||||
This is not suitable for production use.
|
|
||||||
See https://github.com/odoo/owl/blob/master/doc/reference/config.md#mode for more information.`;
|
|
||||||
|
|
||||||
export class App<T extends typeof Component = any> extends TemplateSet {
|
|
||||||
Root: T;
|
|
||||||
props: any;
|
|
||||||
env: Env;
|
|
||||||
scheduler = new Scheduler(window.requestAnimationFrame.bind(window));
|
|
||||||
root: ComponentNode | null = null;
|
|
||||||
|
|
||||||
constructor(Root: T, config: AppConfig = {}) {
|
|
||||||
super(config);
|
|
||||||
this.Root = Root;
|
|
||||||
if (config.dev) {
|
|
||||||
console.info(DEV_MSG);
|
|
||||||
}
|
|
||||||
const descrs = Object.getOwnPropertyDescriptors(config.env || {});
|
|
||||||
this.env = Object.freeze(Object.defineProperties({}, descrs));
|
|
||||||
this.props = config.props || {};
|
|
||||||
}
|
|
||||||
|
|
||||||
mount(target: HTMLElement, options?: MountOptions): Promise<InstanceType<T>> {
|
|
||||||
this.checkTarget(target);
|
|
||||||
const node = this.makeNode(this.Root, this.props);
|
|
||||||
const prom = this.mountNode(node, target, options);
|
|
||||||
this.root = node;
|
|
||||||
return prom;
|
|
||||||
}
|
|
||||||
|
|
||||||
checkTarget(target: HTMLElement) {
|
|
||||||
if (!(target instanceof HTMLElement)) {
|
|
||||||
throw new Error("Cannot mount component: the target is not a valid DOM element");
|
|
||||||
}
|
|
||||||
if (!document.body.contains(target)) {
|
|
||||||
throw new Error("Cannot mount a component on a detached dom node");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
makeNode(Component: T, props: any): ComponentNode {
|
|
||||||
return new ComponentNode(Component, props, this);
|
|
||||||
}
|
|
||||||
|
|
||||||
mountNode(node: ComponentNode, target: HTMLElement, options?: MountOptions) {
|
|
||||||
const promise: any = new Promise((resolve, reject) => {
|
|
||||||
let isResolved = false;
|
|
||||||
// manually set a onMounted callback.
|
|
||||||
// that way, we are independant from the current node.
|
|
||||||
node.mounted.push(() => {
|
|
||||||
resolve(node.component);
|
|
||||||
isResolved = true;
|
|
||||||
});
|
|
||||||
|
|
||||||
// Manually add the last resort error handler on the node
|
|
||||||
let handlers = nodeErrorHandlers.get(node);
|
|
||||||
if (!handlers) {
|
|
||||||
handlers = [];
|
|
||||||
nodeErrorHandlers.set(node, handlers);
|
|
||||||
}
|
|
||||||
handlers.unshift((e) => {
|
|
||||||
if (isResolved) {
|
|
||||||
console.error(e);
|
|
||||||
} else {
|
|
||||||
reject(e);
|
|
||||||
}
|
|
||||||
throw e;
|
|
||||||
});
|
|
||||||
});
|
|
||||||
node.mountComponent(target, options);
|
|
||||||
return promise;
|
|
||||||
}
|
|
||||||
|
|
||||||
destroy() {
|
|
||||||
if (this.root) {
|
|
||||||
this.root.destroy();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export async function mount<T extends typeof Component>(
|
|
||||||
C: T,
|
|
||||||
target: HTMLElement,
|
|
||||||
config: AppConfig & MountOptions = {}
|
|
||||||
): Promise<InstanceType<T>> {
|
|
||||||
return new App(C, config).mount(target, config);
|
|
||||||
}
|
|
||||||
@@ -1,200 +0,0 @@
|
|||||||
import { BDom, multi, text, toggler } from "../blockdom";
|
|
||||||
import { validateProps } from "../component/props_validation";
|
|
||||||
import { Markup } from "../utils";
|
|
||||||
import { html } from "../blockdom/index";
|
|
||||||
|
|
||||||
/**
|
|
||||||
* This file contains utility functions that will be injected in each template,
|
|
||||||
* to perform various useful tasks in the compiled code.
|
|
||||||
*/
|
|
||||||
|
|
||||||
function withDefault(value: any, defaultValue: any): any {
|
|
||||||
return value === undefined || value === null || value === false ? defaultValue : value;
|
|
||||||
}
|
|
||||||
|
|
||||||
function callSlot(
|
|
||||||
ctx: any,
|
|
||||||
parent: any,
|
|
||||||
key: string,
|
|
||||||
name: string,
|
|
||||||
dynamic: boolean,
|
|
||||||
extra: any,
|
|
||||||
defaultContent?: (ctx: any, node: any, key: string) => BDom
|
|
||||||
): BDom {
|
|
||||||
const slots = (ctx.props && ctx.props.slots) || {};
|
|
||||||
const { __render, __ctx, __scope } = slots[name] || {};
|
|
||||||
const slotScope = Object.create(__ctx || {});
|
|
||||||
if (__scope) {
|
|
||||||
slotScope[__scope] = extra || {};
|
|
||||||
}
|
|
||||||
const slotBDom = __render ? __render.call(__ctx.__owl__.component, slotScope, parent, key) : null;
|
|
||||||
if (defaultContent) {
|
|
||||||
let child1: BDom | undefined = undefined;
|
|
||||||
let child2: BDom | undefined = undefined;
|
|
||||||
if (slotBDom) {
|
|
||||||
child1 = dynamic ? toggler(name, slotBDom) : slotBDom;
|
|
||||||
} else {
|
|
||||||
child2 = defaultContent.call(ctx.__owl__.component, ctx, parent, key);
|
|
||||||
}
|
|
||||||
return multi([child1, child2]);
|
|
||||||
}
|
|
||||||
return slotBDom || text("");
|
|
||||||
}
|
|
||||||
|
|
||||||
function capture(ctx: any): any {
|
|
||||||
const component = ctx.__owl__.component;
|
|
||||||
const result = Object.create(component);
|
|
||||||
for (let k in ctx) {
|
|
||||||
result[k] = ctx[k];
|
|
||||||
}
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
|
|
||||||
function withKey(elem: any, k: string) {
|
|
||||||
elem.key = k;
|
|
||||||
return elem;
|
|
||||||
}
|
|
||||||
|
|
||||||
function prepareList(collection: any): [any[], any[], number, any[]] {
|
|
||||||
let keys: any[];
|
|
||||||
let values: any[];
|
|
||||||
|
|
||||||
if (Array.isArray(collection)) {
|
|
||||||
keys = collection;
|
|
||||||
values = collection;
|
|
||||||
} else if (collection) {
|
|
||||||
values = Object.keys(collection);
|
|
||||||
keys = Object.values(collection);
|
|
||||||
} else {
|
|
||||||
throw new Error("Invalid loop expression");
|
|
||||||
}
|
|
||||||
const n = values.length;
|
|
||||||
return [keys, values, n, new Array(n)];
|
|
||||||
}
|
|
||||||
|
|
||||||
const isBoundary = Symbol("isBoundary");
|
|
||||||
|
|
||||||
function setContextValue(ctx: { [key: string]: any }, key: string, value: any): void {
|
|
||||||
const ctx0 = ctx;
|
|
||||||
while (!ctx.hasOwnProperty(key) && !ctx.hasOwnProperty(isBoundary)) {
|
|
||||||
const newCtx = ctx.__proto__;
|
|
||||||
if (!newCtx) {
|
|
||||||
ctx = ctx0;
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
ctx = newCtx;
|
|
||||||
}
|
|
||||||
ctx[key] = value;
|
|
||||||
}
|
|
||||||
|
|
||||||
function toNumber(val: string): number | string {
|
|
||||||
const n = parseFloat(val);
|
|
||||||
return isNaN(n) ? val : n;
|
|
||||||
}
|
|
||||||
|
|
||||||
function shallowEqual(l1: any[], l2: any[]): boolean {
|
|
||||||
for (let i = 0, l = l1.length; i < l; i++) {
|
|
||||||
if (l1[i] !== l2[i]) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
class LazyValue {
|
|
||||||
fn: any;
|
|
||||||
ctx: any;
|
|
||||||
node: any;
|
|
||||||
constructor(fn: any, ctx: any, node: any) {
|
|
||||||
this.fn = fn;
|
|
||||||
this.ctx = capture(ctx);
|
|
||||||
this.node = node;
|
|
||||||
}
|
|
||||||
|
|
||||||
evaluate(): any {
|
|
||||||
return this.fn(this.ctx, this.node);
|
|
||||||
}
|
|
||||||
|
|
||||||
toString() {
|
|
||||||
return this.evaluate().toString();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Safely outputs `value` as a block depending on the nature of `value`
|
|
||||||
*/
|
|
||||||
export function safeOutput(value: any): ReturnType<typeof toggler> {
|
|
||||||
if (!value) {
|
|
||||||
return value;
|
|
||||||
}
|
|
||||||
let safeKey;
|
|
||||||
let block;
|
|
||||||
if (value instanceof Markup) {
|
|
||||||
safeKey = `string_safe`;
|
|
||||||
block = html(value as string);
|
|
||||||
} else if (value instanceof LazyValue) {
|
|
||||||
safeKey = `lazy_value`;
|
|
||||||
block = value.evaluate();
|
|
||||||
} else if (typeof value === "string") {
|
|
||||||
safeKey = "string_unsafe";
|
|
||||||
block = text(value);
|
|
||||||
} else {
|
|
||||||
// Assuming it is a block
|
|
||||||
safeKey = "block_safe";
|
|
||||||
block = value;
|
|
||||||
}
|
|
||||||
return toggler(safeKey, block);
|
|
||||||
}
|
|
||||||
|
|
||||||
let boundFunctions = new WeakMap();
|
|
||||||
|
|
||||||
function bind(ctx: any, fn: Function): Function {
|
|
||||||
let component = ctx.__owl__.component;
|
|
||||||
let boundFnMap = boundFunctions.get(component);
|
|
||||||
if (!boundFnMap) {
|
|
||||||
boundFnMap = new WeakMap();
|
|
||||||
boundFunctions.set(component, boundFnMap);
|
|
||||||
}
|
|
||||||
let boundFn = boundFnMap.get(fn);
|
|
||||||
if (!boundFn) {
|
|
||||||
boundFn = fn.bind(component);
|
|
||||||
boundFnMap.set(fn, boundFn);
|
|
||||||
}
|
|
||||||
return boundFn;
|
|
||||||
}
|
|
||||||
|
|
||||||
type RefMap = { [key: string]: HTMLElement | null };
|
|
||||||
type RefSetter = (el: HTMLElement | null) => void;
|
|
||||||
|
|
||||||
function multiRefSetter(refs: RefMap, name: string): RefSetter {
|
|
||||||
let count = 0;
|
|
||||||
return (el) => {
|
|
||||||
if (el) {
|
|
||||||
count++;
|
|
||||||
if (count > 1) {
|
|
||||||
throw new Error("Cannot have 2 elements with same ref name at the same time");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (count === 0 || el) {
|
|
||||||
refs[name] = el;
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
export const UTILS = {
|
|
||||||
withDefault,
|
|
||||||
zero: Symbol("zero"),
|
|
||||||
isBoundary,
|
|
||||||
callSlot,
|
|
||||||
capture,
|
|
||||||
withKey,
|
|
||||||
prepareList,
|
|
||||||
setContextValue,
|
|
||||||
multiRefSetter,
|
|
||||||
shallowEqual,
|
|
||||||
toNumber,
|
|
||||||
validateProps,
|
|
||||||
LazyValue,
|
|
||||||
safeOutput,
|
|
||||||
bind,
|
|
||||||
};
|
|
||||||
@@ -1,126 +0,0 @@
|
|||||||
import { createBlock, html, list, multi, text, toggler, comment } from "../blockdom";
|
|
||||||
import { compile, Template } from "../compiler";
|
|
||||||
import { component } from "../component/component_node";
|
|
||||||
import { UTILS } from "./template_helpers";
|
|
||||||
|
|
||||||
const bdom = { text, createBlock, list, multi, html, toggler, component, comment };
|
|
||||||
|
|
||||||
export const globalTemplates: { [key: string]: string | Node } = {};
|
|
||||||
|
|
||||||
function parseXML(xml: string): Document {
|
|
||||||
const parser = new DOMParser();
|
|
||||||
|
|
||||||
const doc = parser.parseFromString(xml, "text/xml");
|
|
||||||
if (doc.getElementsByTagName("parsererror").length) {
|
|
||||||
let msg = "Invalid XML in template.";
|
|
||||||
const parsererrorText = doc.getElementsByTagName("parsererror")[0].textContent;
|
|
||||||
if (parsererrorText) {
|
|
||||||
msg += "\nThe parser has produced the following error message:\n" + parsererrorText;
|
|
||||||
const re = /\d+/g;
|
|
||||||
const firstMatch = re.exec(parsererrorText);
|
|
||||||
if (firstMatch) {
|
|
||||||
const lineNumber = Number(firstMatch[0]);
|
|
||||||
const line = xml.split("\n")[lineNumber - 1];
|
|
||||||
const secondMatch = re.exec(parsererrorText);
|
|
||||||
if (line && secondMatch) {
|
|
||||||
const columnIndex = Number(secondMatch[0]) - 1;
|
|
||||||
if (line[columnIndex]) {
|
|
||||||
msg +=
|
|
||||||
`\nThe error might be located at xml line ${lineNumber} column ${columnIndex}\n` +
|
|
||||||
`${line}\n${"-".repeat(columnIndex - 1)}^`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
throw new Error(msg);
|
|
||||||
}
|
|
||||||
return doc;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface TemplateSetConfig {
|
|
||||||
dev?: boolean;
|
|
||||||
translatableAttributes?: string[];
|
|
||||||
translateFn?: (s: string) => string;
|
|
||||||
templates?: string | Document;
|
|
||||||
}
|
|
||||||
|
|
||||||
export class TemplateSet {
|
|
||||||
dev: boolean;
|
|
||||||
rawTemplates: typeof globalTemplates = Object.create(globalTemplates);
|
|
||||||
templates: { [name: string]: Template } = {};
|
|
||||||
translateFn?: (s: string) => string;
|
|
||||||
translatableAttributes?: string[];
|
|
||||||
utils: typeof UTILS = Object.assign({}, UTILS, {
|
|
||||||
call: (owner: any, subTemplate: string, ctx: any, parent: any, key: any) => {
|
|
||||||
const template = this.getTemplate(subTemplate);
|
|
||||||
return toggler(subTemplate, template.call(owner, ctx, parent, key));
|
|
||||||
},
|
|
||||||
getTemplate: (name: string) => this.getTemplate(name),
|
|
||||||
});
|
|
||||||
|
|
||||||
constructor(config: TemplateSetConfig = {}) {
|
|
||||||
this.dev = config.dev || false;
|
|
||||||
this.translateFn = config.translateFn;
|
|
||||||
this.translatableAttributes = config.translatableAttributes;
|
|
||||||
if (config.templates) {
|
|
||||||
this.addTemplates(config.templates);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
addTemplate(name: string, template: string | Node, options: { allowDuplicate?: boolean } = {}) {
|
|
||||||
if (name in this.rawTemplates && !options.allowDuplicate) {
|
|
||||||
throw new Error(`Template ${name} already defined`);
|
|
||||||
}
|
|
||||||
this.rawTemplates[name] = template;
|
|
||||||
}
|
|
||||||
|
|
||||||
addTemplates(xml: string | Document, options: { allowDuplicate?: boolean } = {}) {
|
|
||||||
if (!xml) {
|
|
||||||
// empty string
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
xml = xml instanceof Document ? xml : parseXML(xml);
|
|
||||||
for (const template of xml.querySelectorAll("[t-name]")) {
|
|
||||||
const name = template.getAttribute("t-name")!;
|
|
||||||
template.removeAttribute("t-name");
|
|
||||||
this.addTemplate(name, template, options);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
getTemplate(name: string): Template {
|
|
||||||
if (!(name in this.templates)) {
|
|
||||||
const rawTemplate = this.rawTemplates[name];
|
|
||||||
if (rawTemplate === undefined) {
|
|
||||||
throw new Error(`Missing template: "${name}"`);
|
|
||||||
}
|
|
||||||
const templateFn = this._compileTemplate(name, rawTemplate);
|
|
||||||
// first add a function to lazily get the template, in case there is a
|
|
||||||
// recursive call to the template name
|
|
||||||
this.templates[name] = (context, parent) => this.templates[name](context, parent);
|
|
||||||
const template = templateFn(bdom, this.utils);
|
|
||||||
this.templates[name] = template;
|
|
||||||
}
|
|
||||||
return this.templates[name];
|
|
||||||
}
|
|
||||||
|
|
||||||
_compileTemplate(name: string, template: string | Node) {
|
|
||||||
return compile(template, {
|
|
||||||
name,
|
|
||||||
dev: this.dev,
|
|
||||||
translateFn: this.translateFn,
|
|
||||||
translatableAttributes: this.translatableAttributes,
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// xml tag helper
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
export function xml(...args: Parameters<typeof String.raw>) {
|
|
||||||
const name = `__template__${xml.nextId++}`;
|
|
||||||
const value = String.raw(...args);
|
|
||||||
globalTemplates[name] = value;
|
|
||||||
return name;
|
|
||||||
}
|
|
||||||
|
|
||||||
xml.nextId = 1;
|
|
||||||
@@ -1,167 +0,0 @@
|
|||||||
import type { Setter } from "./block_compiler";
|
|
||||||
|
|
||||||
const { setAttribute: elemSetAttribute, removeAttribute } = Element.prototype;
|
|
||||||
const tokenList = DOMTokenList.prototype;
|
|
||||||
const tokenListAdd = tokenList.add;
|
|
||||||
const tokenListRemove = tokenList.remove;
|
|
||||||
const isArray = Array.isArray;
|
|
||||||
const { split, trim } = String.prototype;
|
|
||||||
const wordRegexp = /\s+/;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* We regroup here all code related to updating attributes in a very loose sense:
|
|
||||||
* attributes, properties and classs are all managed by the functions in this
|
|
||||||
* file.
|
|
||||||
*/
|
|
||||||
|
|
||||||
function setAttribute(this: HTMLElement, key: string, value: any) {
|
|
||||||
switch (value) {
|
|
||||||
case false:
|
|
||||||
case undefined:
|
|
||||||
removeAttribute.call(this, key);
|
|
||||||
break;
|
|
||||||
case true:
|
|
||||||
elemSetAttribute.call(this, key, "");
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
elemSetAttribute.call(this, key, value);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function createAttrUpdater(attr: string): Setter<HTMLElement> {
|
|
||||||
return function (this: HTMLElement, value: any) {
|
|
||||||
setAttribute.call(this, attr, value);
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
export function attrsSetter(this: HTMLElement, attrs: any) {
|
|
||||||
if (isArray(attrs)) {
|
|
||||||
setAttribute.call(this, attrs[0], attrs[1]);
|
|
||||||
} else {
|
|
||||||
for (let k in attrs) {
|
|
||||||
setAttribute.call(this, k, attrs[k]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function attrsUpdater(this: HTMLElement, attrs: any, oldAttrs: any) {
|
|
||||||
if (isArray(attrs)) {
|
|
||||||
const name = attrs[0];
|
|
||||||
const val = attrs[1];
|
|
||||||
if (name === oldAttrs[0]) {
|
|
||||||
if (val === oldAttrs[1]) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
setAttribute.call(this, name, val);
|
|
||||||
} else {
|
|
||||||
removeAttribute.call(this, oldAttrs[0]);
|
|
||||||
setAttribute.call(this, name, val);
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
for (let k in oldAttrs) {
|
|
||||||
if (!(k in attrs)) {
|
|
||||||
removeAttribute.call(this, k);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for (let k in attrs) {
|
|
||||||
const val = attrs[k];
|
|
||||||
if (val !== oldAttrs[k]) {
|
|
||||||
setAttribute.call(this, k, val);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
function toClassObj(expr: string | number | { [c: string]: any }) {
|
|
||||||
const result: { [c: string]: any } = {};
|
|
||||||
switch (typeof expr) {
|
|
||||||
case "string":
|
|
||||||
// we transform here a list of classes into an object:
|
|
||||||
// 'hey you' becomes {hey: true, you: true}
|
|
||||||
const str = trim.call(expr);
|
|
||||||
if (!str) {
|
|
||||||
return {};
|
|
||||||
}
|
|
||||||
let words = split.call(str, wordRegexp);
|
|
||||||
for (let i = 0, l = words.length; i < l; i++) {
|
|
||||||
result[words[i]] = true;
|
|
||||||
}
|
|
||||||
return result;
|
|
||||||
case "object":
|
|
||||||
// this is already an object but we may need to split keys:
|
|
||||||
// {'a': true, 'b c': true} should become {a: true, b: true, c: true}
|
|
||||||
for (let key in expr as any) {
|
|
||||||
const value = (expr as any)[key];
|
|
||||||
if (value) {
|
|
||||||
const words = split.call(key, wordRegexp);
|
|
||||||
for (let word of words) {
|
|
||||||
result[word] = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return result;
|
|
||||||
|
|
||||||
case "undefined":
|
|
||||||
return {};
|
|
||||||
case "number":
|
|
||||||
return { [expr as number]: true };
|
|
||||||
default:
|
|
||||||
return { [expr as any]: true };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function setClass(this: HTMLElement, val: any) {
|
|
||||||
val = val === "" ? {} : toClassObj(val);
|
|
||||||
// add classes
|
|
||||||
const cl = this.classList;
|
|
||||||
for (let c in val) {
|
|
||||||
tokenListAdd.call(cl, c);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function updateClass(this: HTMLElement, val: any, oldVal: any) {
|
|
||||||
oldVal = oldVal === "" ? {} : toClassObj(oldVal);
|
|
||||||
val = val === "" ? {} : toClassObj(val);
|
|
||||||
const cl = this.classList;
|
|
||||||
// remove classes
|
|
||||||
for (let c in oldVal) {
|
|
||||||
if (!(c in val)) {
|
|
||||||
tokenListRemove.call(cl, c);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// add classes
|
|
||||||
for (let c in val) {
|
|
||||||
if (!(c in oldVal)) {
|
|
||||||
tokenListAdd.call(cl, c);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function makePropSetter(name: string): Setter<HTMLElement> {
|
|
||||||
return function setProp(this: HTMLElement, value: any) {
|
|
||||||
(this as any)[name] = value;
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
export function isProp(tag: string, key: string): boolean {
|
|
||||||
switch (tag) {
|
|
||||||
case "input":
|
|
||||||
return (
|
|
||||||
key === "checked" ||
|
|
||||||
key === "indeterminate" ||
|
|
||||||
key === "value" ||
|
|
||||||
key === "readonly" ||
|
|
||||||
key === "disabled"
|
|
||||||
);
|
|
||||||
case "option":
|
|
||||||
return key === "selected" || key === "disabled";
|
|
||||||
case "textarea":
|
|
||||||
return key === "value" || key === "readonly" || key === "disabled";
|
|
||||||
case "select":
|
|
||||||
return key === "value" || key === "disabled";
|
|
||||||
case "button":
|
|
||||||
case "optgroup":
|
|
||||||
return key === "disabled";
|
|
||||||
}
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
@@ -1,604 +0,0 @@
|
|||||||
import {
|
|
||||||
attrsSetter,
|
|
||||||
attrsUpdater,
|
|
||||||
createAttrUpdater,
|
|
||||||
isProp,
|
|
||||||
makePropSetter,
|
|
||||||
setClass,
|
|
||||||
updateClass,
|
|
||||||
} from "./attributes";
|
|
||||||
import { config } from "./config";
|
|
||||||
import { createEventHandler } from "./events";
|
|
||||||
import type { VNode } from "./index";
|
|
||||||
import { VMulti } from "./multi";
|
|
||||||
import { toText } from "./text";
|
|
||||||
|
|
||||||
const getDescriptor = (o: any, p: any) => Object.getOwnPropertyDescriptor(o, p)!;
|
|
||||||
const nodeProto = Node.prototype;
|
|
||||||
const elementProto = Element.prototype;
|
|
||||||
const characterDataProto = CharacterData.prototype;
|
|
||||||
|
|
||||||
const characterDataSetData = getDescriptor(characterDataProto, "data").set!;
|
|
||||||
const nodeGetFirstChild = getDescriptor(nodeProto, "firstChild").get!;
|
|
||||||
const nodeGetNextSibling = getDescriptor(nodeProto, "nextSibling").get!;
|
|
||||||
|
|
||||||
const NO_OP = () => {};
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Main compiler code
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
type BlockType = (data?: any[], children?: VNode[]) => VNode;
|
|
||||||
|
|
||||||
const cache: { [key: string]: BlockType } = {};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Compiling blocks is a multi-step process:
|
|
||||||
*
|
|
||||||
* 1. build an IntermediateTree from the HTML element. This intermediate tree
|
|
||||||
* is a binary tree structure that encode dynamic info sub nodes, and the
|
|
||||||
* path required to reach them
|
|
||||||
* 2. process the tree to build a block context, which is an object that aggregate
|
|
||||||
* all dynamic info in a list, and also, all ref indexes.
|
|
||||||
* 3. process the context to build appropriate builder/setter functions
|
|
||||||
* 4. make a dynamic block class, which will efficiently collect references and
|
|
||||||
* create/update dynamic locations/children
|
|
||||||
*
|
|
||||||
* @param str
|
|
||||||
* @returns a new block type, that can build concrete blocks
|
|
||||||
*/
|
|
||||||
export function createBlock(str: string): BlockType {
|
|
||||||
if (str in cache) {
|
|
||||||
return cache[str];
|
|
||||||
}
|
|
||||||
|
|
||||||
// step 0: prepare html base element
|
|
||||||
const doc = new DOMParser().parseFromString(`<t>${str}</t>`, "text/xml");
|
|
||||||
const node = doc.firstChild!.firstChild!;
|
|
||||||
if (config.shouldNormalizeDom) {
|
|
||||||
normalizeNode(node as any);
|
|
||||||
}
|
|
||||||
|
|
||||||
// step 1: prepare intermediate tree
|
|
||||||
const tree = buildTree(node);
|
|
||||||
|
|
||||||
// step 2: prepare block context
|
|
||||||
const context = buildContext(tree);
|
|
||||||
|
|
||||||
// step 3: build the final block class
|
|
||||||
const template = tree.el as HTMLElement;
|
|
||||||
const Block = buildBlock(template, context);
|
|
||||||
cache[str] = Block;
|
|
||||||
return Block;
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Helper
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function normalizeNode(node: HTMLElement | Text) {
|
|
||||||
if (node.nodeType === Node.TEXT_NODE) {
|
|
||||||
if (!/\S/.test((node as Text).textContent!)) {
|
|
||||||
(node as Text).remove();
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (node.nodeType === Node.ELEMENT_NODE) {
|
|
||||||
if ((node as HTMLElement).tagName === "pre") {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for (let i = node.childNodes.length - 1; i >= 0; --i) {
|
|
||||||
normalizeNode(node.childNodes.item(i) as any);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// building a intermediate tree
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
interface DynamicInfo {
|
|
||||||
idx: number;
|
|
||||||
refIdx?: number;
|
|
||||||
type: "text" | "child" | "handler" | "attribute" | "attributes" | "ref";
|
|
||||||
isOnlyChild?: boolean;
|
|
||||||
name?: string;
|
|
||||||
tag?: string;
|
|
||||||
event?: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
interface IntermediateTree {
|
|
||||||
parent: IntermediateTree | null;
|
|
||||||
firstChild: IntermediateTree | null;
|
|
||||||
nextSibling: IntermediateTree | null;
|
|
||||||
el: Node;
|
|
||||||
info: DynamicInfo[];
|
|
||||||
isRef?: boolean;
|
|
||||||
refIdx?: number;
|
|
||||||
refN: number;
|
|
||||||
currentNS: string | null;
|
|
||||||
}
|
|
||||||
|
|
||||||
function buildTree(
|
|
||||||
node: Node,
|
|
||||||
parent: IntermediateTree | null = null,
|
|
||||||
domParentTree: IntermediateTree | null = null
|
|
||||||
): IntermediateTree {
|
|
||||||
switch (node.nodeType) {
|
|
||||||
case Node.ELEMENT_NODE: {
|
|
||||||
// HTMLElement
|
|
||||||
let currentNS = domParentTree && domParentTree.currentNS;
|
|
||||||
const tagName = (node as Element).tagName;
|
|
||||||
let el: Node | undefined = undefined;
|
|
||||||
const info: DynamicInfo[] = [];
|
|
||||||
if (tagName.startsWith("block-text-")) {
|
|
||||||
const index = parseInt(tagName.slice(11), 10);
|
|
||||||
info.push({ type: "text", idx: index });
|
|
||||||
el = document.createTextNode("");
|
|
||||||
}
|
|
||||||
if (tagName.startsWith("block-child-")) {
|
|
||||||
if (!domParentTree!.isRef) {
|
|
||||||
addRef(domParentTree!);
|
|
||||||
}
|
|
||||||
const index = parseInt(tagName.slice(12), 10);
|
|
||||||
info.push({ type: "child", idx: index });
|
|
||||||
el = document.createTextNode("");
|
|
||||||
}
|
|
||||||
const attrs = (node as Element).attributes;
|
|
||||||
const ns = attrs.getNamedItem("block-ns");
|
|
||||||
if (ns) {
|
|
||||||
attrs.removeNamedItem("block-ns");
|
|
||||||
currentNS = ns.value;
|
|
||||||
}
|
|
||||||
if (!el) {
|
|
||||||
el = currentNS
|
|
||||||
? document.createElementNS(currentNS, tagName)
|
|
||||||
: document.createElement(tagName);
|
|
||||||
}
|
|
||||||
if (el instanceof Element) {
|
|
||||||
for (let i = 0; i < attrs.length; i++) {
|
|
||||||
const attrName = attrs[i].name;
|
|
||||||
const attrValue = attrs[i].value;
|
|
||||||
if (attrName.startsWith("block-handler-")) {
|
|
||||||
const idx = parseInt(attrName.slice(14), 10);
|
|
||||||
info.push({
|
|
||||||
type: "handler",
|
|
||||||
idx,
|
|
||||||
event: attrValue,
|
|
||||||
});
|
|
||||||
} else if (attrName.startsWith("block-attribute-")) {
|
|
||||||
const idx = parseInt(attrName.slice(16), 10);
|
|
||||||
info.push({
|
|
||||||
type: "attribute",
|
|
||||||
idx,
|
|
||||||
name: attrValue,
|
|
||||||
tag: tagName,
|
|
||||||
});
|
|
||||||
} else if (attrName === "block-attributes") {
|
|
||||||
info.push({
|
|
||||||
type: "attributes",
|
|
||||||
idx: parseInt(attrValue, 10),
|
|
||||||
});
|
|
||||||
} else if (attrName === "block-ref") {
|
|
||||||
info.push({
|
|
||||||
type: "ref",
|
|
||||||
idx: parseInt(attrValue, 10),
|
|
||||||
});
|
|
||||||
} else {
|
|
||||||
el.setAttribute(attrs[i].name, attrValue);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
const tree: IntermediateTree = {
|
|
||||||
parent,
|
|
||||||
firstChild: null,
|
|
||||||
nextSibling: null,
|
|
||||||
el,
|
|
||||||
info,
|
|
||||||
refN: 0,
|
|
||||||
currentNS,
|
|
||||||
};
|
|
||||||
|
|
||||||
if (node.firstChild) {
|
|
||||||
const childNode = node.childNodes[0];
|
|
||||||
if (
|
|
||||||
node.childNodes.length === 1 &&
|
|
||||||
childNode.nodeType === Node.ELEMENT_NODE &&
|
|
||||||
(childNode as Element).tagName.startsWith("block-child-")
|
|
||||||
) {
|
|
||||||
const tagName = (childNode as Element).tagName;
|
|
||||||
const index = parseInt(tagName.slice(12), 10);
|
|
||||||
info.push({ idx: index, type: "child", isOnlyChild: true });
|
|
||||||
} else {
|
|
||||||
tree.firstChild = buildTree(node.firstChild, tree, tree);
|
|
||||||
el.appendChild(tree.firstChild.el);
|
|
||||||
let curNode: Node | null = node.firstChild;
|
|
||||||
let curTree: IntermediateTree | null = tree.firstChild;
|
|
||||||
while ((curNode = curNode.nextSibling)) {
|
|
||||||
curTree.nextSibling = buildTree(curNode, curTree, tree);
|
|
||||||
el.appendChild(curTree.nextSibling.el);
|
|
||||||
curTree = curTree.nextSibling;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (tree.info.length) {
|
|
||||||
addRef(tree);
|
|
||||||
}
|
|
||||||
return tree;
|
|
||||||
}
|
|
||||||
case Node.TEXT_NODE:
|
|
||||||
case Node.COMMENT_NODE: {
|
|
||||||
// text node or comment node
|
|
||||||
const el =
|
|
||||||
node.nodeType === Node.TEXT_NODE
|
|
||||||
? document.createTextNode(node.textContent!)
|
|
||||||
: document.createComment(node.textContent!);
|
|
||||||
return {
|
|
||||||
parent: parent,
|
|
||||||
firstChild: null,
|
|
||||||
nextSibling: null,
|
|
||||||
el,
|
|
||||||
info: [],
|
|
||||||
refN: 0,
|
|
||||||
currentNS: null,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
throw new Error("boom");
|
|
||||||
}
|
|
||||||
|
|
||||||
function addRef(tree: IntermediateTree) {
|
|
||||||
tree.isRef = true;
|
|
||||||
do {
|
|
||||||
tree.refN++;
|
|
||||||
} while ((tree = tree.parent as any));
|
|
||||||
}
|
|
||||||
|
|
||||||
function parentTree(tree: IntermediateTree): IntermediateTree | null {
|
|
||||||
let parent = tree.parent;
|
|
||||||
while (parent && parent.nextSibling === tree) {
|
|
||||||
tree = parent;
|
|
||||||
parent = parent.parent;
|
|
||||||
}
|
|
||||||
return parent;
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Building a block context
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
interface RefCollector {
|
|
||||||
idx: number;
|
|
||||||
prevIdx: number;
|
|
||||||
getVal: Function;
|
|
||||||
}
|
|
||||||
|
|
||||||
export type Setter<T = any> = (this: T, value: any) => void;
|
|
||||||
export type Updater<T = any> = (this: T, value: any, oldVal: any) => void;
|
|
||||||
|
|
||||||
interface Location {
|
|
||||||
refIdx: number;
|
|
||||||
setData: Setter;
|
|
||||||
updateData: Updater;
|
|
||||||
}
|
|
||||||
|
|
||||||
interface IndexedLocation extends Location {
|
|
||||||
idx: number;
|
|
||||||
}
|
|
||||||
|
|
||||||
interface Child {
|
|
||||||
parentRefIdx: number;
|
|
||||||
afterRefIdx?: number;
|
|
||||||
isOnlyChild?: boolean;
|
|
||||||
}
|
|
||||||
|
|
||||||
interface BlockCtx {
|
|
||||||
refN: number;
|
|
||||||
collectors: RefCollector[];
|
|
||||||
locations: IndexedLocation[];
|
|
||||||
children: Child[];
|
|
||||||
cbRefs: number[];
|
|
||||||
}
|
|
||||||
|
|
||||||
function buildContext(tree: IntermediateTree, ctx?: BlockCtx, fromIdx?: number): BlockCtx {
|
|
||||||
if (!ctx) {
|
|
||||||
const children = new Array(tree.info.filter((v) => v.type === "child").length);
|
|
||||||
ctx = { collectors: [], locations: [], children, cbRefs: [], refN: tree.refN };
|
|
||||||
fromIdx = 0;
|
|
||||||
}
|
|
||||||
if (tree.refN) {
|
|
||||||
const initialIdx = fromIdx!;
|
|
||||||
const isRef = tree.isRef;
|
|
||||||
const firstChild = tree.firstChild ? tree.firstChild.refN : 0;
|
|
||||||
const nextSibling = tree.nextSibling ? tree.nextSibling.refN : 0;
|
|
||||||
|
|
||||||
//node
|
|
||||||
if (isRef) {
|
|
||||||
for (let info of tree.info) {
|
|
||||||
info.refIdx = initialIdx!;
|
|
||||||
}
|
|
||||||
tree.refIdx = initialIdx!;
|
|
||||||
updateCtx(ctx, tree);
|
|
||||||
fromIdx!++;
|
|
||||||
}
|
|
||||||
|
|
||||||
// right
|
|
||||||
if (nextSibling) {
|
|
||||||
const idx = fromIdx! + firstChild;
|
|
||||||
ctx.collectors.push({ idx, prevIdx: initialIdx, getVal: nodeGetNextSibling });
|
|
||||||
buildContext(tree.nextSibling!, ctx, idx);
|
|
||||||
}
|
|
||||||
|
|
||||||
// left
|
|
||||||
if (firstChild) {
|
|
||||||
ctx.collectors.push({ idx: fromIdx!, prevIdx: initialIdx, getVal: nodeGetFirstChild });
|
|
||||||
buildContext(tree.firstChild!, ctx, fromIdx!);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return ctx;
|
|
||||||
}
|
|
||||||
|
|
||||||
function updateCtx(ctx: BlockCtx, tree: IntermediateTree) {
|
|
||||||
for (let info of tree.info) {
|
|
||||||
switch (info.type) {
|
|
||||||
case "text":
|
|
||||||
ctx.locations.push({
|
|
||||||
idx: info.idx,
|
|
||||||
refIdx: info.refIdx!,
|
|
||||||
setData: setText,
|
|
||||||
updateData: setText,
|
|
||||||
});
|
|
||||||
break;
|
|
||||||
case "child":
|
|
||||||
if (info.isOnlyChild) {
|
|
||||||
// tree is the parentnode here
|
|
||||||
ctx.children[info.idx] = {
|
|
||||||
parentRefIdx: info.refIdx!,
|
|
||||||
isOnlyChild: true,
|
|
||||||
};
|
|
||||||
} else {
|
|
||||||
// tree is the anchor text node
|
|
||||||
ctx.children[info.idx] = {
|
|
||||||
parentRefIdx: parentTree(tree)!.refIdx!,
|
|
||||||
afterRefIdx: info.refIdx!,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
case "attribute": {
|
|
||||||
const refIdx = info.refIdx!;
|
|
||||||
let updater: any;
|
|
||||||
let setter: any;
|
|
||||||
if (isProp(info.tag!, info.name!)) {
|
|
||||||
const setProp = makePropSetter(info.name!);
|
|
||||||
setter = setProp;
|
|
||||||
updater = setProp;
|
|
||||||
} else if (info.name === "class") {
|
|
||||||
setter = setClass;
|
|
||||||
updater = updateClass;
|
|
||||||
} else {
|
|
||||||
setter = createAttrUpdater(info.name!);
|
|
||||||
updater = setter;
|
|
||||||
}
|
|
||||||
ctx.locations.push({
|
|
||||||
idx: info.idx,
|
|
||||||
refIdx,
|
|
||||||
setData: setter,
|
|
||||||
updateData: updater,
|
|
||||||
});
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
case "attributes":
|
|
||||||
ctx.locations.push({
|
|
||||||
idx: info.idx,
|
|
||||||
refIdx: info.refIdx!,
|
|
||||||
setData: attrsSetter,
|
|
||||||
updateData: attrsUpdater,
|
|
||||||
});
|
|
||||||
break;
|
|
||||||
case "handler": {
|
|
||||||
const { setup, update } = createEventHandler(info.event!);
|
|
||||||
ctx.locations.push({
|
|
||||||
idx: info.idx,
|
|
||||||
refIdx: info.refIdx!,
|
|
||||||
setData: setup,
|
|
||||||
updateData: update,
|
|
||||||
});
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
case "ref":
|
|
||||||
ctx.cbRefs.push(info.idx);
|
|
||||||
ctx.locations.push({
|
|
||||||
idx: info.idx,
|
|
||||||
refIdx: info.refIdx!,
|
|
||||||
setData: setRef,
|
|
||||||
updateData: NO_OP,
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// building the concrete block class
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function buildBlock(template: HTMLElement, ctx: BlockCtx): BlockType {
|
|
||||||
let B = createBlockClass(template, ctx);
|
|
||||||
|
|
||||||
if (ctx.cbRefs.length) {
|
|
||||||
const refs = ctx.cbRefs;
|
|
||||||
B = class extends B {
|
|
||||||
remove() {
|
|
||||||
super.remove();
|
|
||||||
for (let ref of refs) {
|
|
||||||
let fn = (this as any).data[ref];
|
|
||||||
fn(null);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
if (ctx.children.length) {
|
|
||||||
B = class extends B {
|
|
||||||
children: (VNode | undefined)[] | undefined;
|
|
||||||
constructor(data?: any[], children?: VNode[]) {
|
|
||||||
super(data);
|
|
||||||
this.children = children;
|
|
||||||
}
|
|
||||||
};
|
|
||||||
B.prototype.beforeRemove = VMulti.prototype.beforeRemove;
|
|
||||||
return (data?: any[], children: (VNode | undefined)[] = []) => new B(data, children);
|
|
||||||
}
|
|
||||||
|
|
||||||
return (data?: any[]) => new B(data);
|
|
||||||
}
|
|
||||||
|
|
||||||
type Constructor<T> = new (...args: any[]) => T;
|
|
||||||
type BlockClass = Constructor<VNode<any>>;
|
|
||||||
|
|
||||||
function createBlockClass(template: HTMLElement, ctx: BlockCtx): BlockClass {
|
|
||||||
const { refN, collectors, children } = ctx;
|
|
||||||
const colN = collectors.length;
|
|
||||||
ctx.locations.sort((a, b) => a.idx - b.idx);
|
|
||||||
const locations: Location[] = ctx.locations.map((loc) => ({
|
|
||||||
refIdx: loc.refIdx,
|
|
||||||
setData: loc.setData,
|
|
||||||
updateData: loc.updateData,
|
|
||||||
}));
|
|
||||||
const locN = locations.length;
|
|
||||||
const childN = children.length;
|
|
||||||
const childrenLocs = children;
|
|
||||||
const isDynamic = refN > 0;
|
|
||||||
|
|
||||||
// these values are defined here to make them faster to lookup in the class
|
|
||||||
// block scope
|
|
||||||
const nodeCloneNode = nodeProto.cloneNode;
|
|
||||||
const nodeInsertBefore = nodeProto.insertBefore;
|
|
||||||
const elementRemove = elementProto.remove;
|
|
||||||
|
|
||||||
return class Block {
|
|
||||||
el: HTMLElement | undefined;
|
|
||||||
refs: Node[] | undefined;
|
|
||||||
data: any[] | undefined;
|
|
||||||
parentEl?: HTMLElement | undefined;
|
|
||||||
children?: (VNode | undefined)[];
|
|
||||||
|
|
||||||
constructor(data?: any[]) {
|
|
||||||
this.data = data;
|
|
||||||
}
|
|
||||||
|
|
||||||
beforeRemove() {}
|
|
||||||
|
|
||||||
remove() {
|
|
||||||
elementRemove.call(this.el);
|
|
||||||
}
|
|
||||||
|
|
||||||
firstNode(): Node {
|
|
||||||
return this.el!;
|
|
||||||
}
|
|
||||||
|
|
||||||
moveBefore(other: Block | null, afterNode: Node | null) {
|
|
||||||
const target = other ? other.el! : afterNode;
|
|
||||||
nodeInsertBefore.call(this.parentEl, this.el!, target);
|
|
||||||
}
|
|
||||||
|
|
||||||
mount(parent: HTMLElement, afterNode: Node | null) {
|
|
||||||
const el = nodeCloneNode.call(template, true);
|
|
||||||
nodeInsertBefore.call(parent, el, afterNode);
|
|
||||||
if (isDynamic) {
|
|
||||||
// collecting references
|
|
||||||
const refs: Node[] = new Array(refN);
|
|
||||||
this.refs = refs;
|
|
||||||
refs[0] = el;
|
|
||||||
for (let i = 0; i < colN; i++) {
|
|
||||||
const w = collectors[i];
|
|
||||||
refs[w.idx] = w.getVal.call(refs[w.prevIdx]);
|
|
||||||
}
|
|
||||||
|
|
||||||
// applying data to all update points
|
|
||||||
if (locN) {
|
|
||||||
const data = this.data!;
|
|
||||||
for (let i = 0; i < locN; i++) {
|
|
||||||
const loc = locations[i];
|
|
||||||
loc.setData.call(refs[loc.refIdx], data[i]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// preparing all children
|
|
||||||
if (childN) {
|
|
||||||
const children = this.children;
|
|
||||||
for (let i = 0; i < childN; i++) {
|
|
||||||
const child = children![i];
|
|
||||||
if (child) {
|
|
||||||
const loc = childrenLocs[i];
|
|
||||||
const afterNode = loc.afterRefIdx ? refs[loc.afterRefIdx] : null;
|
|
||||||
child.isOnlyChild = loc.isOnlyChild;
|
|
||||||
child.mount(refs[loc.parentRefIdx] as any, afterNode);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
this.el = el as HTMLElement;
|
|
||||||
this.parentEl = parent;
|
|
||||||
}
|
|
||||||
patch(other: Block, withBeforeRemove: boolean) {
|
|
||||||
if (this === other) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
const refs = this.refs!;
|
|
||||||
// update texts/attributes/
|
|
||||||
if (locN) {
|
|
||||||
const data1 = this.data!;
|
|
||||||
const data2 = other.data!;
|
|
||||||
for (let i = 0; i < locN; i++) {
|
|
||||||
const val1 = data1[i];
|
|
||||||
const val2 = data2[i];
|
|
||||||
if (val1 !== val2) {
|
|
||||||
const loc = locations[i];
|
|
||||||
loc.updateData.call(refs[loc.refIdx], val2, val1);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
this.data = data2;
|
|
||||||
}
|
|
||||||
|
|
||||||
// update children
|
|
||||||
if (childN) {
|
|
||||||
let children1 = this.children;
|
|
||||||
const children2 = other.children;
|
|
||||||
for (let i = 0; i < childN; i++) {
|
|
||||||
const child1 = children1![i];
|
|
||||||
const child2 = children2![i];
|
|
||||||
if (child1) {
|
|
||||||
if (child2) {
|
|
||||||
child1.patch(child2, withBeforeRemove);
|
|
||||||
} else {
|
|
||||||
if (withBeforeRemove) {
|
|
||||||
child1.beforeRemove();
|
|
||||||
}
|
|
||||||
child1.remove();
|
|
||||||
children1![i] = undefined;
|
|
||||||
}
|
|
||||||
} else if (child2) {
|
|
||||||
const loc = childrenLocs[i];
|
|
||||||
const afterNode = loc.afterRefIdx ? refs[loc.afterRefIdx] : null;
|
|
||||||
child2.mount(refs[loc.parentRefIdx] as any, afterNode);
|
|
||||||
children1![i] = child2;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
toString() {
|
|
||||||
const div = document.createElement("div");
|
|
||||||
this.mount(div, null);
|
|
||||||
return div.innerHTML;
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
function setText(this: Text, value: any) {
|
|
||||||
characterDataSetData.call(this, toText(value));
|
|
||||||
}
|
|
||||||
|
|
||||||
function setRef(this: HTMLElement, fn: any) {
|
|
||||||
fn(this);
|
|
||||||
}
|
|
||||||
@@ -1,28 +0,0 @@
|
|||||||
export function filterOutModifiersFromData(dataList: any[]): { modifiers: string[]; data: any[] } {
|
|
||||||
dataList = dataList.slice();
|
|
||||||
const modifiers = [];
|
|
||||||
let elm;
|
|
||||||
while ((elm = dataList[0]) && typeof elm === "string") {
|
|
||||||
modifiers.push(dataList.shift());
|
|
||||||
}
|
|
||||||
return { modifiers, data: dataList };
|
|
||||||
}
|
|
||||||
|
|
||||||
export const config = {
|
|
||||||
// whether or not blockdom should normalize DOM whenever a block is created.
|
|
||||||
// Normalizing dom mean removing empty text nodes (or containing only spaces)
|
|
||||||
shouldNormalizeDom: true,
|
|
||||||
|
|
||||||
// this is the main event handler. Every event handler registered with blockdom
|
|
||||||
// will go through this function, giving it the data registered in the block
|
|
||||||
// and the event
|
|
||||||
mainEventHandler: (data: any, ev: Event, currentTarget?: EventTarget | null): boolean => {
|
|
||||||
if (typeof data === "function") {
|
|
||||||
data(ev);
|
|
||||||
} else if (Array.isArray(data)) {
|
|
||||||
data = filterOutModifiersFromData(data).data;
|
|
||||||
data[0](data[1], ev);
|
|
||||||
}
|
|
||||||
return false;
|
|
||||||
},
|
|
||||||
};
|
|
||||||
@@ -1,90 +0,0 @@
|
|||||||
import { config } from "./config";
|
|
||||||
|
|
||||||
type EventHandlerSetter = (this: HTMLElement, data: any) => void;
|
|
||||||
|
|
||||||
interface EventHandlerCreator {
|
|
||||||
setup: EventHandlerSetter;
|
|
||||||
update: EventHandlerSetter;
|
|
||||||
}
|
|
||||||
|
|
||||||
export function createEventHandler(rawEvent: string): EventHandlerCreator {
|
|
||||||
const eventName = rawEvent.split(".")[0];
|
|
||||||
const capture = rawEvent.includes(".capture");
|
|
||||||
if (rawEvent.includes(".synthetic")) {
|
|
||||||
return createSyntheticHandler(eventName, capture);
|
|
||||||
} else {
|
|
||||||
return createElementHandler(eventName, capture);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Native listener
|
|
||||||
let nextNativeEventId = 1;
|
|
||||||
function createElementHandler(evName: string, capture: boolean = false): EventHandlerCreator {
|
|
||||||
let eventKey = `__event__${evName}_${nextNativeEventId++}`;
|
|
||||||
if (capture) {
|
|
||||||
eventKey = `${eventKey}_capture`;
|
|
||||||
}
|
|
||||||
|
|
||||||
function listener(ev: Event) {
|
|
||||||
const currentTarget = ev.currentTarget;
|
|
||||||
if (!currentTarget || !document.contains(currentTarget as HTMLElement)) return;
|
|
||||||
const data = (currentTarget as any)[eventKey];
|
|
||||||
if (!data) return;
|
|
||||||
config.mainEventHandler(data, ev, currentTarget);
|
|
||||||
}
|
|
||||||
|
|
||||||
function setup(this: HTMLElement, data: any) {
|
|
||||||
(this as any)[eventKey] = data;
|
|
||||||
this.addEventListener(evName, listener, { capture });
|
|
||||||
}
|
|
||||||
|
|
||||||
function update(this: HTMLElement, data: any) {
|
|
||||||
(this as any)[eventKey] = data;
|
|
||||||
}
|
|
||||||
|
|
||||||
return { setup, update };
|
|
||||||
}
|
|
||||||
|
|
||||||
// Synthetic handler: a form of event delegation that allows placing only one
|
|
||||||
// listener per event type.
|
|
||||||
let nextSyntheticEventId = 1;
|
|
||||||
function createSyntheticHandler(evName: string, capture: boolean = false): EventHandlerCreator {
|
|
||||||
let eventKey = `__event__synthetic_${evName}`;
|
|
||||||
if (capture) {
|
|
||||||
eventKey = `${eventKey}_capture`;
|
|
||||||
}
|
|
||||||
setupSyntheticEvent(evName, eventKey, capture);
|
|
||||||
const currentId = nextSyntheticEventId++;
|
|
||||||
function setup(this: HTMLElement, data: any) {
|
|
||||||
const _data = (this as any)[eventKey] || {};
|
|
||||||
_data[currentId] = data;
|
|
||||||
(this as any)[eventKey] = _data;
|
|
||||||
}
|
|
||||||
return { setup, update: setup };
|
|
||||||
}
|
|
||||||
|
|
||||||
function nativeToSyntheticEvent(eventKey: string, event: Event) {
|
|
||||||
let dom = event.target;
|
|
||||||
while (dom !== null) {
|
|
||||||
const _data = (dom as any)[eventKey];
|
|
||||||
if (_data) {
|
|
||||||
for (const data of Object.values(_data)) {
|
|
||||||
const stopped = config.mainEventHandler(data, event, dom);
|
|
||||||
if (stopped) return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
dom = (dom as any).parentNode;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
const CONFIGURED_SYNTHETIC_EVENTS: { [event: string]: boolean } = {};
|
|
||||||
|
|
||||||
function setupSyntheticEvent(evName: string, eventKey: string, capture: boolean = false) {
|
|
||||||
if (CONFIGURED_SYNTHETIC_EVENTS[eventKey]) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
document.addEventListener(evName, (event) => nativeToSyntheticEvent(eventKey, event), {
|
|
||||||
capture,
|
|
||||||
});
|
|
||||||
CONFIGURED_SYNTHETIC_EVENTS[eventKey] = true;
|
|
||||||
}
|
|
||||||
@@ -1,87 +0,0 @@
|
|||||||
import type { VNode } from "./index";
|
|
||||||
|
|
||||||
const nodeProto = Node.prototype;
|
|
||||||
|
|
||||||
const nodeInsertBefore = nodeProto.insertBefore;
|
|
||||||
const nodeRemoveChild = nodeProto.removeChild;
|
|
||||||
|
|
||||||
class VHtml {
|
|
||||||
html: string;
|
|
||||||
parentEl?: HTMLElement | undefined;
|
|
||||||
content: ChildNode[] = [];
|
|
||||||
|
|
||||||
constructor(html: string) {
|
|
||||||
this.html = html;
|
|
||||||
}
|
|
||||||
|
|
||||||
mount(parent: HTMLElement, afterNode: Node | null) {
|
|
||||||
this.parentEl = parent;
|
|
||||||
const template = document.createElement("template");
|
|
||||||
template.innerHTML = this.html;
|
|
||||||
this.content = [...(template.content.childNodes as any)];
|
|
||||||
for (let elem of this.content) {
|
|
||||||
nodeInsertBefore.call(parent, elem, afterNode);
|
|
||||||
}
|
|
||||||
if (!this.content.length) {
|
|
||||||
const textNode = document.createTextNode("");
|
|
||||||
this.content.push(textNode);
|
|
||||||
nodeInsertBefore.call(parent, textNode, afterNode);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
moveBefore(other: VHtml | null, afterNode: Node | null) {
|
|
||||||
const target = other ? other.content[0] : afterNode;
|
|
||||||
const parent = this.parentEl;
|
|
||||||
for (let elem of this.content) {
|
|
||||||
nodeInsertBefore.call(parent, elem, target);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
patch(other: VHtml) {
|
|
||||||
if (this === other) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
const html2 = other.html;
|
|
||||||
if (this.html !== html2) {
|
|
||||||
const parent = this.parentEl;
|
|
||||||
// insert new html in front of current
|
|
||||||
const afterNode = this.content[0];
|
|
||||||
const template = document.createElement("template");
|
|
||||||
template.innerHTML = html2;
|
|
||||||
const content = [...(template.content.childNodes as any)];
|
|
||||||
for (let elem of content) {
|
|
||||||
nodeInsertBefore.call(parent, elem, afterNode);
|
|
||||||
}
|
|
||||||
if (!content.length) {
|
|
||||||
const textNode = document.createTextNode("");
|
|
||||||
content.push(textNode);
|
|
||||||
nodeInsertBefore.call(parent, textNode, afterNode);
|
|
||||||
}
|
|
||||||
|
|
||||||
// remove current content
|
|
||||||
this.remove();
|
|
||||||
this.content = content;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
beforeRemove() {}
|
|
||||||
|
|
||||||
remove() {
|
|
||||||
const parent = this.parentEl;
|
|
||||||
for (let elem of this.content) {
|
|
||||||
nodeRemoveChild.call(parent, elem);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
firstNode(): Node {
|
|
||||||
return this.content[0]!;
|
|
||||||
}
|
|
||||||
|
|
||||||
toString() {
|
|
||||||
return this.html;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function html(str: string): VNode<VHtml> {
|
|
||||||
return new VHtml(str);
|
|
||||||
}
|
|
||||||
@@ -1,44 +0,0 @@
|
|||||||
export { config } from "./config";
|
|
||||||
|
|
||||||
export { toggler } from "./toggler";
|
|
||||||
export { createBlock } from "./block_compiler";
|
|
||||||
export { list } from "./list";
|
|
||||||
export { multi } from "./multi";
|
|
||||||
export { text, comment } from "./text";
|
|
||||||
export { html } from "./html";
|
|
||||||
|
|
||||||
export interface VNode<T = any> {
|
|
||||||
mount(parent: HTMLElement, afterNode: Node | null): void;
|
|
||||||
moveBefore(other: T | null, afterNode: Node | null): void;
|
|
||||||
patch(other: T, withBeforeRemove: boolean): void;
|
|
||||||
beforeRemove(): void;
|
|
||||||
remove(): void;
|
|
||||||
firstNode(): Node | undefined;
|
|
||||||
|
|
||||||
el?: undefined | HTMLElement | Text;
|
|
||||||
parentEl?: undefined | HTMLElement;
|
|
||||||
isOnlyChild?: boolean | undefined;
|
|
||||||
key?: any;
|
|
||||||
}
|
|
||||||
|
|
||||||
export type BDom = VNode<any>;
|
|
||||||
|
|
||||||
export function mount(vnode: VNode, fixture: HTMLElement, afterNode: Node | null = null) {
|
|
||||||
vnode.mount(fixture, afterNode);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function patch(vnode1: VNode, vnode2: VNode, withBeforeRemove: boolean = false) {
|
|
||||||
vnode1.patch(vnode2, withBeforeRemove);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function remove(vnode: VNode, withBeforeRemove: boolean = false) {
|
|
||||||
if (withBeforeRemove) {
|
|
||||||
vnode.beforeRemove();
|
|
||||||
}
|
|
||||||
vnode.remove();
|
|
||||||
}
|
|
||||||
|
|
||||||
export function withKey(vnode: VNode, key: any) {
|
|
||||||
vnode.key = key;
|
|
||||||
return vnode;
|
|
||||||
}
|
|
||||||
@@ -1,240 +0,0 @@
|
|||||||
import type { VNode } from "./index";
|
|
||||||
|
|
||||||
const getDescriptor = (o: any, p: any) => Object.getOwnPropertyDescriptor(o, p)!;
|
|
||||||
const nodeProto = Node.prototype;
|
|
||||||
|
|
||||||
const nodeInsertBefore = nodeProto.insertBefore;
|
|
||||||
const nodeAppendChild = nodeProto.appendChild;
|
|
||||||
const nodeRemoveChild = nodeProto.removeChild;
|
|
||||||
const nodeSetTextContent = getDescriptor(nodeProto, "textContent").set!;
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// List Node
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
class VList {
|
|
||||||
children: VNode[];
|
|
||||||
anchor: Node | undefined;
|
|
||||||
parentEl?: HTMLElement | undefined;
|
|
||||||
isOnlyChild?: boolean | undefined;
|
|
||||||
|
|
||||||
constructor(children: VNode[]) {
|
|
||||||
this.children = children;
|
|
||||||
}
|
|
||||||
|
|
||||||
mount(parent: HTMLElement, afterNode: Node | null) {
|
|
||||||
const children = this.children;
|
|
||||||
const _anchor = document.createTextNode("");
|
|
||||||
this.anchor = _anchor;
|
|
||||||
nodeInsertBefore.call(parent, _anchor, afterNode);
|
|
||||||
const l = children.length;
|
|
||||||
if (l) {
|
|
||||||
const mount = children[0].mount;
|
|
||||||
for (let i = 0; i < l; i++) {
|
|
||||||
mount.call(children[i], parent, _anchor);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
this.parentEl = parent;
|
|
||||||
}
|
|
||||||
|
|
||||||
moveBefore(other: VList | null, afterNode: Node | null) {
|
|
||||||
if (other) {
|
|
||||||
const next = other!.children[0];
|
|
||||||
afterNode = (next ? next.firstNode() : other!.anchor) || null;
|
|
||||||
}
|
|
||||||
const children = this.children;
|
|
||||||
for (let i = 0, l = children.length; i < l; i++) {
|
|
||||||
children[i].moveBefore(null, afterNode);
|
|
||||||
}
|
|
||||||
this.parentEl!.insertBefore(this.anchor!, afterNode);
|
|
||||||
}
|
|
||||||
|
|
||||||
patch(other: VList, withBeforeRemove: boolean) {
|
|
||||||
if (this === other) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
const ch1 = this.children;
|
|
||||||
const ch2: VNode[] = other.children;
|
|
||||||
if (ch2.length === 0 && ch1.length === 0) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
this.children = ch2;
|
|
||||||
const proto = ch2[0] || ch1[0];
|
|
||||||
const {
|
|
||||||
mount: cMount,
|
|
||||||
patch: cPatch,
|
|
||||||
remove: cRemove,
|
|
||||||
beforeRemove,
|
|
||||||
moveBefore: cMoveBefore,
|
|
||||||
firstNode: cFirstNode,
|
|
||||||
} = proto;
|
|
||||||
|
|
||||||
const _anchor = this.anchor!;
|
|
||||||
const isOnlyChild = this.isOnlyChild;
|
|
||||||
const parent = this.parentEl!;
|
|
||||||
|
|
||||||
// fast path: no new child => only remove
|
|
||||||
if (ch2.length === 0 && isOnlyChild) {
|
|
||||||
if (withBeforeRemove) {
|
|
||||||
for (let i = 0, l = ch1.length; i < l; i++) {
|
|
||||||
beforeRemove.call(ch1[i]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
nodeSetTextContent.call(parent, "");
|
|
||||||
nodeAppendChild.call(parent, _anchor);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
let startIdx1 = 0;
|
|
||||||
let startIdx2 = 0;
|
|
||||||
let startVn1 = ch1[0];
|
|
||||||
let startVn2 = ch2[0];
|
|
||||||
|
|
||||||
let endIdx1 = ch1.length - 1;
|
|
||||||
let endIdx2 = ch2.length - 1;
|
|
||||||
let endVn1 = ch1[endIdx1];
|
|
||||||
let endVn2 = ch2[endIdx2];
|
|
||||||
|
|
||||||
let mapping: any = undefined;
|
|
||||||
// let noFullRemove = this.hasNoComponent;
|
|
||||||
|
|
||||||
while (startIdx1 <= endIdx1 && startIdx2 <= endIdx2) {
|
|
||||||
// -------------------------------------------------------------------
|
|
||||||
if (startVn1 === null) {
|
|
||||||
startVn1 = ch1[++startIdx1];
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
// -------------------------------------------------------------------
|
|
||||||
if (endVn1 === null) {
|
|
||||||
endVn1 = ch1[--endIdx1];
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
// -------------------------------------------------------------------
|
|
||||||
let startKey1 = startVn1.key;
|
|
||||||
let startKey2 = startVn2.key;
|
|
||||||
if (startKey1 === startKey2) {
|
|
||||||
cPatch.call(startVn1, startVn2, withBeforeRemove);
|
|
||||||
ch2[startIdx2] = startVn1;
|
|
||||||
startVn1 = ch1[++startIdx1];
|
|
||||||
startVn2 = ch2[++startIdx2];
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
// -------------------------------------------------------------------
|
|
||||||
let endKey1 = endVn1.key;
|
|
||||||
let endKey2 = endVn2.key;
|
|
||||||
if (endKey1 === endKey2) {
|
|
||||||
cPatch.call(endVn1, endVn2, withBeforeRemove);
|
|
||||||
ch2[endIdx2] = endVn1;
|
|
||||||
endVn1 = ch1[--endIdx1];
|
|
||||||
endVn2 = ch2[--endIdx2];
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
// -------------------------------------------------------------------
|
|
||||||
if (startKey1 === endKey2) {
|
|
||||||
// bnode moved right
|
|
||||||
cPatch.call(startVn1, endVn2, withBeforeRemove);
|
|
||||||
ch2[endIdx2] = startVn1;
|
|
||||||
const nextChild = ch2[endIdx2 + 1];
|
|
||||||
cMoveBefore.call(startVn1, nextChild, _anchor);
|
|
||||||
startVn1 = ch1[++startIdx1];
|
|
||||||
endVn2 = ch2[--endIdx2];
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
// -------------------------------------------------------------------
|
|
||||||
if (endKey1 === startKey2) {
|
|
||||||
// bnode moved left
|
|
||||||
cPatch.call(endVn1, startVn2, withBeforeRemove);
|
|
||||||
ch2[startIdx2] = endVn1;
|
|
||||||
const nextChild = ch1[startIdx1];
|
|
||||||
cMoveBefore.call(endVn1, nextChild, _anchor);
|
|
||||||
endVn1 = ch1[--endIdx1];
|
|
||||||
startVn2 = ch2[++startIdx2];
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
// -------------------------------------------------------------------
|
|
||||||
mapping = mapping || createMapping(ch1, startIdx1, endIdx1);
|
|
||||||
let idxInOld = mapping[startKey2];
|
|
||||||
if (idxInOld === undefined) {
|
|
||||||
cMount.call(startVn2, parent, cFirstNode.call(startVn1) || null);
|
|
||||||
} else {
|
|
||||||
const elmToMove = ch1[idxInOld];
|
|
||||||
cMoveBefore.call(elmToMove, startVn1, null);
|
|
||||||
cPatch.call(elmToMove, startVn2, withBeforeRemove);
|
|
||||||
ch2[startIdx2] = elmToMove;
|
|
||||||
ch1[idxInOld] = null as any;
|
|
||||||
}
|
|
||||||
startVn2 = ch2[++startIdx2];
|
|
||||||
}
|
|
||||||
// ---------------------------------------------------------------------
|
|
||||||
if (startIdx1 <= endIdx1 || startIdx2 <= endIdx2) {
|
|
||||||
if (startIdx1 > endIdx1) {
|
|
||||||
const nextChild = ch2[endIdx2 + 1];
|
|
||||||
const anchor = nextChild ? cFirstNode.call(nextChild) || null : _anchor;
|
|
||||||
for (let i = startIdx2; i <= endIdx2; i++) {
|
|
||||||
cMount.call(ch2[i], parent, anchor);
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
for (let i = startIdx1; i <= endIdx1; i++) {
|
|
||||||
let ch = ch1[i];
|
|
||||||
if (ch) {
|
|
||||||
if (withBeforeRemove) {
|
|
||||||
beforeRemove.call(ch);
|
|
||||||
}
|
|
||||||
cRemove.call(ch);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
beforeRemove() {
|
|
||||||
const children = this.children;
|
|
||||||
const l = children.length;
|
|
||||||
if (l) {
|
|
||||||
const beforeRemove = children[0].beforeRemove;
|
|
||||||
for (let i = 0; i < l; i++) {
|
|
||||||
beforeRemove.call(children[i]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
remove() {
|
|
||||||
const { parentEl, anchor } = this;
|
|
||||||
if (this.isOnlyChild) {
|
|
||||||
nodeSetTextContent.call(parentEl, "");
|
|
||||||
} else {
|
|
||||||
const children = this.children;
|
|
||||||
const l = children.length;
|
|
||||||
if (l) {
|
|
||||||
const remove = children[0].remove;
|
|
||||||
for (let i = 0; i < l; i++) {
|
|
||||||
remove.call(children[i]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
nodeRemoveChild.call(parentEl, anchor!);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
firstNode(): Node | undefined {
|
|
||||||
const child = this.children[0];
|
|
||||||
return child ? child.firstNode() : undefined;
|
|
||||||
}
|
|
||||||
|
|
||||||
toString(): string {
|
|
||||||
return this.children.map((c) => c!.toString()).join("");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function list(children: VNode[]): VNode<VList> {
|
|
||||||
return new VList(children);
|
|
||||||
}
|
|
||||||
|
|
||||||
function createMapping(ch1: any[], startIdx1: number, endIdx2: number): { [key: string]: any } {
|
|
||||||
let mapping: any = {};
|
|
||||||
for (let i = startIdx1; i <= endIdx2; i++) {
|
|
||||||
mapping[ch1[i].key] = i;
|
|
||||||
}
|
|
||||||
return mapping;
|
|
||||||
}
|
|
||||||
@@ -1,134 +0,0 @@
|
|||||||
import type { VNode } from "./index";
|
|
||||||
|
|
||||||
const getDescriptor = (o: any, p: any) => Object.getOwnPropertyDescriptor(o, p)!;
|
|
||||||
const nodeProto = Node.prototype;
|
|
||||||
const nodeInsertBefore = nodeProto.insertBefore;
|
|
||||||
const nodeSetTextContent = getDescriptor(nodeProto, "textContent").set!;
|
|
||||||
const nodeRemoveChild = nodeProto.removeChild;
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Multi NODE
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
export class VMulti {
|
|
||||||
children: (VNode | undefined)[];
|
|
||||||
anchors?: Node[] | undefined;
|
|
||||||
parentEl?: HTMLElement | undefined;
|
|
||||||
isOnlyChild?: boolean | undefined;
|
|
||||||
|
|
||||||
constructor(children: (VNode | undefined)[]) {
|
|
||||||
this.children = children;
|
|
||||||
}
|
|
||||||
|
|
||||||
mount(parent: HTMLElement, afterNode: Node | null) {
|
|
||||||
const children = this.children;
|
|
||||||
const l = children.length;
|
|
||||||
const anchors = new Array(l);
|
|
||||||
for (let i = 0; i < l; i++) {
|
|
||||||
let child = children[i];
|
|
||||||
if (child) {
|
|
||||||
child.mount(parent, afterNode);
|
|
||||||
} else {
|
|
||||||
const childAnchor = document.createTextNode("");
|
|
||||||
anchors[i] = childAnchor;
|
|
||||||
nodeInsertBefore.call(parent, childAnchor, afterNode);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
this.anchors = anchors;
|
|
||||||
this.parentEl = parent;
|
|
||||||
}
|
|
||||||
|
|
||||||
moveBefore(other: VMulti | null, afterNode: Node | null) {
|
|
||||||
if (other) {
|
|
||||||
const next = other!.children[0];
|
|
||||||
afterNode = (next ? next.firstNode() : other!.anchors![0]) || null;
|
|
||||||
}
|
|
||||||
const children = this.children;
|
|
||||||
const parent = this.parentEl;
|
|
||||||
const anchors = this.anchors;
|
|
||||||
for (let i = 0, l = children.length; i < l; i++) {
|
|
||||||
let child = children[i];
|
|
||||||
if (child) {
|
|
||||||
child.moveBefore(null, afterNode);
|
|
||||||
} else {
|
|
||||||
const anchor = anchors![i];
|
|
||||||
nodeInsertBefore.call(parent, anchor, afterNode);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
patch(other: VMulti, withBeforeRemove: boolean) {
|
|
||||||
if (this === other) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
const children1 = this.children;
|
|
||||||
const children2 = other.children;
|
|
||||||
const anchors = this.anchors!;
|
|
||||||
const parentEl = this.parentEl!;
|
|
||||||
for (let i = 0, l = children1.length; i < l; i++) {
|
|
||||||
const vn1 = children1[i];
|
|
||||||
const vn2 = children2[i];
|
|
||||||
if (vn1) {
|
|
||||||
if (vn2) {
|
|
||||||
vn1.patch(vn2, withBeforeRemove);
|
|
||||||
} else {
|
|
||||||
const afterNode = vn1.firstNode()!;
|
|
||||||
const anchor = document.createTextNode("");
|
|
||||||
anchors[i] = anchor;
|
|
||||||
nodeInsertBefore.call(parentEl, anchor, afterNode);
|
|
||||||
if (withBeforeRemove) {
|
|
||||||
vn1.beforeRemove();
|
|
||||||
}
|
|
||||||
vn1.remove();
|
|
||||||
children1[i] = undefined;
|
|
||||||
}
|
|
||||||
} else if (vn2) {
|
|
||||||
children1[i] = vn2;
|
|
||||||
const anchor = anchors[i];
|
|
||||||
vn2.mount(parentEl, anchor);
|
|
||||||
nodeRemoveChild.call(parentEl, anchor);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
beforeRemove() {
|
|
||||||
const children = this.children;
|
|
||||||
for (let i = 0, l = children.length; i < l; i++) {
|
|
||||||
const child = children[i];
|
|
||||||
if (child) {
|
|
||||||
child.beforeRemove();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
remove() {
|
|
||||||
const parentEl = this.parentEl;
|
|
||||||
if (this.isOnlyChild) {
|
|
||||||
nodeSetTextContent.call(parentEl, "");
|
|
||||||
} else {
|
|
||||||
const children = this.children;
|
|
||||||
const anchors = this.anchors;
|
|
||||||
for (let i = 0, l = children.length; i < l; i++) {
|
|
||||||
const child = children[i];
|
|
||||||
if (child) {
|
|
||||||
child.remove();
|
|
||||||
} else {
|
|
||||||
nodeRemoveChild.call(parentEl, anchors![i]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
firstNode(): Node | undefined {
|
|
||||||
const child = this.children[0];
|
|
||||||
return child ? child.firstNode() : this.anchors![0];
|
|
||||||
}
|
|
||||||
|
|
||||||
toString(): string {
|
|
||||||
return this.children.map((c) => c!.toString()).join("");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function multi(children: (VNode | undefined)[]): VNode<VMulti> {
|
|
||||||
return new VMulti(children);
|
|
||||||
}
|
|
||||||
@@ -1,87 +0,0 @@
|
|||||||
import type { VNode } from "./index";
|
|
||||||
|
|
||||||
const getDescriptor = (o: any, p: any) => Object.getOwnPropertyDescriptor(o, p)!;
|
|
||||||
const nodeProto = Node.prototype;
|
|
||||||
const characterDataProto = CharacterData.prototype;
|
|
||||||
|
|
||||||
const nodeInsertBefore = nodeProto.insertBefore;
|
|
||||||
const characterDataSetData = getDescriptor(characterDataProto, "data").set!;
|
|
||||||
const nodeRemoveChild = nodeProto.removeChild;
|
|
||||||
|
|
||||||
abstract class VSimpleNode {
|
|
||||||
text: string;
|
|
||||||
parentEl?: HTMLElement | undefined;
|
|
||||||
el?: any;
|
|
||||||
|
|
||||||
constructor(text: string) {
|
|
||||||
this.text = text;
|
|
||||||
}
|
|
||||||
|
|
||||||
mountNode(node: Node, parent: HTMLElement, afterNode: Node | null) {
|
|
||||||
this.parentEl = parent;
|
|
||||||
nodeInsertBefore.call(parent, node, afterNode);
|
|
||||||
this.el = node;
|
|
||||||
}
|
|
||||||
|
|
||||||
moveBefore(other: VText | null, afterNode: Node | null) {
|
|
||||||
const target = other ? other.el! : afterNode;
|
|
||||||
nodeInsertBefore.call(this.parentEl, this.el!, target);
|
|
||||||
}
|
|
||||||
|
|
||||||
beforeRemove() {}
|
|
||||||
|
|
||||||
remove() {
|
|
||||||
nodeRemoveChild.call(this.parentEl, this.el!);
|
|
||||||
}
|
|
||||||
|
|
||||||
firstNode(): Node {
|
|
||||||
return this.el!;
|
|
||||||
}
|
|
||||||
|
|
||||||
toString() {
|
|
||||||
return this.text;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
class VText extends VSimpleNode {
|
|
||||||
mount(parent: HTMLElement, afterNode: Node | null) {
|
|
||||||
this.mountNode(document.createTextNode(toText(this.text)), parent, afterNode);
|
|
||||||
}
|
|
||||||
|
|
||||||
patch(other: VText) {
|
|
||||||
const text2 = other.text;
|
|
||||||
if (this.text !== text2) {
|
|
||||||
characterDataSetData.call(this.el!, toText(text2));
|
|
||||||
this.text = text2;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
class VComment extends VSimpleNode {
|
|
||||||
mount(parent: HTMLElement, afterNode: Node | null) {
|
|
||||||
this.mountNode(document.createComment(toText(this.text)), parent, afterNode);
|
|
||||||
}
|
|
||||||
|
|
||||||
patch() {}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function text(str: string): VNode<VText> {
|
|
||||||
return new VText(str);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function comment(str: string): VNode<VComment> {
|
|
||||||
return new VComment(str);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function toText(value: any): string {
|
|
||||||
switch (typeof value) {
|
|
||||||
case "string":
|
|
||||||
return value;
|
|
||||||
case "number":
|
|
||||||
return String(value);
|
|
||||||
case "boolean":
|
|
||||||
return value ? "true" : "false";
|
|
||||||
default:
|
|
||||||
return value || "";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,65 +0,0 @@
|
|||||||
import type { VNode } from "./index";
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Toggler node
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
class VToggler {
|
|
||||||
key: string;
|
|
||||||
child: VNode;
|
|
||||||
|
|
||||||
parentEl?: HTMLElement | undefined;
|
|
||||||
|
|
||||||
constructor(key: string, child: VNode) {
|
|
||||||
this.key = key;
|
|
||||||
this.child = child;
|
|
||||||
}
|
|
||||||
|
|
||||||
mount(parent: HTMLElement, afterNode: Node | null) {
|
|
||||||
this.parentEl = parent;
|
|
||||||
this.child.mount(parent, afterNode);
|
|
||||||
}
|
|
||||||
|
|
||||||
moveBefore(other: VToggler | null, afterNode: Node | null) {
|
|
||||||
this.child.moveBefore(other ? other.child : null, afterNode);
|
|
||||||
}
|
|
||||||
|
|
||||||
patch(other: VToggler, withBeforeRemove: boolean) {
|
|
||||||
if (this === other) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
let child1 = this.child;
|
|
||||||
let child2 = other.child;
|
|
||||||
if (this.key === other.key) {
|
|
||||||
child1.patch(child2, withBeforeRemove);
|
|
||||||
} else {
|
|
||||||
child2.mount(this.parentEl!, child1.firstNode()!);
|
|
||||||
if (withBeforeRemove) {
|
|
||||||
child1.beforeRemove();
|
|
||||||
}
|
|
||||||
child1.remove();
|
|
||||||
this.child = child2;
|
|
||||||
this.key = other.key;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
beforeRemove() {
|
|
||||||
this.child.beforeRemove();
|
|
||||||
}
|
|
||||||
|
|
||||||
remove() {
|
|
||||||
this.child.remove();
|
|
||||||
}
|
|
||||||
|
|
||||||
firstNode(): Node | undefined {
|
|
||||||
return this.child.firstNode();
|
|
||||||
}
|
|
||||||
|
|
||||||
toString(): string {
|
|
||||||
return this.child.toString();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function toggler(key: string, child: VNode): VNode<VToggler> {
|
|
||||||
return new VToggler(key, child);
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,30 @@
|
|||||||
|
export interface Browser {
|
||||||
|
setTimeout: Window["setTimeout"];
|
||||||
|
clearTimeout: Window["clearTimeout"];
|
||||||
|
setInterval: Window["setInterval"];
|
||||||
|
clearInterval: Window["clearInterval"];
|
||||||
|
requestAnimationFrame: Window["requestAnimationFrame"];
|
||||||
|
random: Math["random"];
|
||||||
|
Date: typeof Date;
|
||||||
|
fetch: Window["fetch"];
|
||||||
|
localStorage: Window["localStorage"];
|
||||||
|
}
|
||||||
|
|
||||||
|
let localStorage: Window["localStorage"] | null = null;
|
||||||
|
|
||||||
|
export const browser: Browser = {
|
||||||
|
setTimeout: window.setTimeout.bind(window),
|
||||||
|
clearTimeout: window.clearTimeout.bind(window),
|
||||||
|
setInterval: window.setInterval.bind(window),
|
||||||
|
clearInterval: window.clearInterval.bind(window),
|
||||||
|
requestAnimationFrame: window.requestAnimationFrame.bind(window),
|
||||||
|
random: Math.random,
|
||||||
|
Date: window.Date,
|
||||||
|
fetch: (window.fetch || (() => {})).bind(window),
|
||||||
|
get localStorage() {
|
||||||
|
return localStorage || window.localStorage;
|
||||||
|
},
|
||||||
|
set localStorage(newLocalStorage: Window["localStorage"]) {
|
||||||
|
localStorage = newLocalStorage;
|
||||||
|
},
|
||||||
|
};
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -1,27 +0,0 @@
|
|||||||
import type { BDom } from "../blockdom";
|
|
||||||
import { CodeGenerator, Config } from "./code_generator";
|
|
||||||
import { parse } from "./parser";
|
|
||||||
|
|
||||||
export type Template = (context: any, vnode: any, key?: string) => BDom;
|
|
||||||
|
|
||||||
export type TemplateFunction = (blocks: any, utils: any) => Template;
|
|
||||||
|
|
||||||
interface CompileOptions extends Config {
|
|
||||||
name?: string;
|
|
||||||
}
|
|
||||||
export function compile(template: string | Node, options: CompileOptions = {}): TemplateFunction {
|
|
||||||
// parsing
|
|
||||||
const ast = parse(template);
|
|
||||||
|
|
||||||
// some work
|
|
||||||
const hasSafeContext =
|
|
||||||
template instanceof Node
|
|
||||||
? !(template instanceof Element) || template.querySelector("[t-set], [t-call]") === null
|
|
||||||
: !template.includes("t-set") && !template.includes("t-call");
|
|
||||||
|
|
||||||
// code generation
|
|
||||||
const codeGenerator = new CodeGenerator(ast, { ...options, hasSafeContext });
|
|
||||||
const code = codeGenerator.generateCode();
|
|
||||||
// template function
|
|
||||||
return new Function("bdom, helpers", code) as TemplateFunction;
|
|
||||||
}
|
|
||||||
@@ -1,963 +0,0 @@
|
|||||||
// -----------------------------------------------------------------------------
|
|
||||||
// AST Type definition
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
export const enum ASTType {
|
|
||||||
Text,
|
|
||||||
Comment,
|
|
||||||
DomNode,
|
|
||||||
Multi,
|
|
||||||
TEsc,
|
|
||||||
TIf,
|
|
||||||
TSet,
|
|
||||||
TCall,
|
|
||||||
TOut,
|
|
||||||
TForEach,
|
|
||||||
TKey,
|
|
||||||
TComponent,
|
|
||||||
TDebug,
|
|
||||||
TLog,
|
|
||||||
TSlot,
|
|
||||||
TCallBlock,
|
|
||||||
TTranslation,
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTText {
|
|
||||||
type: ASTType.Text;
|
|
||||||
value: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTComment {
|
|
||||||
type: ASTType.Comment;
|
|
||||||
value: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTDomNode {
|
|
||||||
type: ASTType.DomNode;
|
|
||||||
tag: string;
|
|
||||||
dynamicTag: string | null;
|
|
||||||
attrs: { [key: string]: string };
|
|
||||||
content: AST[];
|
|
||||||
ref: string | null;
|
|
||||||
on: { [key: string]: string };
|
|
||||||
model: {
|
|
||||||
baseExpr: string;
|
|
||||||
expr: string;
|
|
||||||
targetAttr: string;
|
|
||||||
specialInitTargetAttr: string | null;
|
|
||||||
eventType: "change" | "click" | "input";
|
|
||||||
shouldTrim: boolean;
|
|
||||||
shouldNumberize: boolean;
|
|
||||||
} | null;
|
|
||||||
ns: string | null;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTMulti {
|
|
||||||
type: ASTType.Multi;
|
|
||||||
content: AST[];
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTTEsc {
|
|
||||||
type: ASTType.TEsc;
|
|
||||||
expr: string;
|
|
||||||
defaultValue: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTTOut {
|
|
||||||
type: ASTType.TOut;
|
|
||||||
expr: string;
|
|
||||||
body: AST[] | null;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTTif {
|
|
||||||
type: ASTType.TIf;
|
|
||||||
condition: string;
|
|
||||||
content: AST;
|
|
||||||
tElif: { condition: string; content: AST }[] | null;
|
|
||||||
tElse: AST | null;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTTSet {
|
|
||||||
type: ASTType.TSet;
|
|
||||||
name: string;
|
|
||||||
value: string | null; // value defined in attribute
|
|
||||||
defaultValue: string | null; // value defined in body, if text
|
|
||||||
body: AST[] | null; // content of body if not text
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTTForEach {
|
|
||||||
type: ASTType.TForEach;
|
|
||||||
collection: string;
|
|
||||||
elem: string;
|
|
||||||
key: string | null;
|
|
||||||
body: AST;
|
|
||||||
memo: string;
|
|
||||||
isOnlyChild: boolean;
|
|
||||||
hasNoComponent: boolean;
|
|
||||||
hasNoFirst: boolean;
|
|
||||||
hasNoLast: boolean;
|
|
||||||
hasNoIndex: boolean;
|
|
||||||
hasNoValue: boolean;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTTKey {
|
|
||||||
type: ASTType.TKey;
|
|
||||||
expr: string;
|
|
||||||
content: AST;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTTCall {
|
|
||||||
type: ASTType.TCall;
|
|
||||||
name: string;
|
|
||||||
body: AST[] | null;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTComponent {
|
|
||||||
type: ASTType.TComponent;
|
|
||||||
name: string;
|
|
||||||
isDynamic: boolean;
|
|
||||||
dynamicProps: string | null;
|
|
||||||
props: { [name: string]: string };
|
|
||||||
slots: { [name: string]: { content: AST; attrs?: { [key: string]: string }; scope?: string } };
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTSlot {
|
|
||||||
type: ASTType.TSlot;
|
|
||||||
name: string;
|
|
||||||
attrs: { [key: string]: string };
|
|
||||||
defaultContent: AST | null;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTTCallBlock {
|
|
||||||
type: ASTType.TCallBlock;
|
|
||||||
name: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTDebug {
|
|
||||||
type: ASTType.TDebug;
|
|
||||||
content: AST | null;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTLog {
|
|
||||||
type: ASTType.TLog;
|
|
||||||
expr: string;
|
|
||||||
content: AST | null;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ASTTranslation {
|
|
||||||
type: ASTType.TTranslation;
|
|
||||||
content: AST | null;
|
|
||||||
}
|
|
||||||
|
|
||||||
export type AST =
|
|
||||||
| ASTText
|
|
||||||
| ASTComment
|
|
||||||
| ASTDomNode
|
|
||||||
| ASTMulti
|
|
||||||
| ASTTEsc
|
|
||||||
| ASTTif
|
|
||||||
| ASTTSet
|
|
||||||
| ASTTCall
|
|
||||||
| ASTTOut
|
|
||||||
| ASTTForEach
|
|
||||||
| ASTTKey
|
|
||||||
| ASTComponent
|
|
||||||
| ASTSlot
|
|
||||||
| ASTTCallBlock
|
|
||||||
| ASTLog
|
|
||||||
| ASTDebug
|
|
||||||
| ASTTranslation;
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Parser
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
interface ParsingContext {
|
|
||||||
inPreTag: boolean;
|
|
||||||
inSVG: boolean;
|
|
||||||
}
|
|
||||||
|
|
||||||
export function parse(xml: string | Node): AST {
|
|
||||||
const node = xml instanceof Element ? xml : (parseXML(`<t>${xml}</t>`).firstChild! as Element);
|
|
||||||
normalizeXML(node);
|
|
||||||
const ctx = { inPreTag: false, inSVG: false };
|
|
||||||
const ast = parseNode(node, ctx);
|
|
||||||
if (!ast) {
|
|
||||||
return { type: ASTType.Text, value: "" };
|
|
||||||
}
|
|
||||||
return ast;
|
|
||||||
}
|
|
||||||
|
|
||||||
function parseNode(node: ChildNode, ctx: ParsingContext): AST | null {
|
|
||||||
if (!(node instanceof Element)) {
|
|
||||||
return parseTextCommentNode(node, ctx);
|
|
||||||
}
|
|
||||||
return (
|
|
||||||
parseTDebugLog(node, ctx) ||
|
|
||||||
parseTForEach(node, ctx) ||
|
|
||||||
parseTIf(node, ctx) ||
|
|
||||||
parseTCall(node, ctx) ||
|
|
||||||
parseTCallBlock(node, ctx) ||
|
|
||||||
parseTEscNode(node, ctx) ||
|
|
||||||
parseTKey(node, ctx) ||
|
|
||||||
parseTTranslation(node, ctx) ||
|
|
||||||
parseTSlot(node, ctx) ||
|
|
||||||
parseTOutNode(node, ctx) ||
|
|
||||||
parseComponent(node, ctx) ||
|
|
||||||
parseDOMNode(node, ctx) ||
|
|
||||||
parseTSetNode(node, ctx) ||
|
|
||||||
parseTNode(node, ctx)
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// <t /> tag
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function parseTNode(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (node.tagName !== "t") {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
return parseChildNodes(node, ctx);
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Text and Comment Nodes
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
const lineBreakRE = /[\r\n]/;
|
|
||||||
const whitespaceRE = /\s+/g;
|
|
||||||
|
|
||||||
function parseTextCommentNode(node: ChildNode, ctx: ParsingContext): AST | null {
|
|
||||||
if (node.nodeType === Node.TEXT_NODE) {
|
|
||||||
let value = node.textContent || "";
|
|
||||||
if (!ctx.inPreTag) {
|
|
||||||
if (lineBreakRE.test(value) && !value.trim()) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
value = value.replace(whitespaceRE, " ");
|
|
||||||
}
|
|
||||||
|
|
||||||
return { type: ASTType.Text, value };
|
|
||||||
} else if (node.nodeType === Node.COMMENT_NODE) {
|
|
||||||
return { type: ASTType.Comment, value: node.textContent || "" };
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// debugging
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function parseTDebugLog(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (node.hasAttribute("t-debug")) {
|
|
||||||
node.removeAttribute("t-debug");
|
|
||||||
return {
|
|
||||||
type: ASTType.TDebug,
|
|
||||||
content: parseNode(node, ctx),
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
if (node.hasAttribute("t-log")) {
|
|
||||||
const expr = node.getAttribute("t-log")!;
|
|
||||||
node.removeAttribute("t-log");
|
|
||||||
return {
|
|
||||||
type: ASTType.TLog,
|
|
||||||
expr,
|
|
||||||
content: parseNode(node, ctx),
|
|
||||||
};
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Regular dom node
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
const hasDotAtTheEnd = /\.[\w_]+\s*$/;
|
|
||||||
const hasBracketsAtTheEnd = /\[[^\[]+\]\s*$/;
|
|
||||||
|
|
||||||
function parseDOMNode(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
const { tagName } = node;
|
|
||||||
const dynamicTag = node.getAttribute("t-tag");
|
|
||||||
node.removeAttribute("t-tag");
|
|
||||||
if (tagName === "t" && !dynamicTag) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
ctx = Object.assign({}, ctx);
|
|
||||||
if (tagName === "pre") {
|
|
||||||
ctx.inPreTag = true;
|
|
||||||
}
|
|
||||||
const shouldAddSVGNS = tagName === "svg" || (tagName === "g" && !ctx.inSVG);
|
|
||||||
ctx.inSVG = ctx.inSVG || shouldAddSVGNS;
|
|
||||||
const ns = shouldAddSVGNS ? "http://www.w3.org/2000/svg" : null;
|
|
||||||
const ref = node.getAttribute("t-ref");
|
|
||||||
node.removeAttribute("t-ref");
|
|
||||||
|
|
||||||
const children = parseChildren(node, ctx);
|
|
||||||
|
|
||||||
const nodeAttrsNames = node.getAttributeNames();
|
|
||||||
const attrs: ASTDomNode["attrs"] = {};
|
|
||||||
const on: ASTDomNode["on"] = {};
|
|
||||||
let model: ASTDomNode["model"] = null;
|
|
||||||
|
|
||||||
for (let attr of nodeAttrsNames) {
|
|
||||||
const value = node.getAttribute(attr)!;
|
|
||||||
if (attr.startsWith("t-on")) {
|
|
||||||
if (attr === "t-on") {
|
|
||||||
throw new Error("Missing event name with t-on directive");
|
|
||||||
}
|
|
||||||
on[attr.slice(5)] = value;
|
|
||||||
} else if (attr.startsWith("t-model")) {
|
|
||||||
if (!["input", "select", "textarea"].includes(tagName)) {
|
|
||||||
throw new Error("The t-model directive only works with <input>, <textarea> and <select>");
|
|
||||||
}
|
|
||||||
|
|
||||||
let baseExpr, expr;
|
|
||||||
if (hasDotAtTheEnd.test(value)) {
|
|
||||||
const index = value.lastIndexOf(".");
|
|
||||||
baseExpr = value.slice(0, index);
|
|
||||||
expr = `'${value.slice(index + 1)}'`;
|
|
||||||
} else if (hasBracketsAtTheEnd.test(value)) {
|
|
||||||
const index = value.lastIndexOf("[");
|
|
||||||
baseExpr = value.slice(0, index);
|
|
||||||
expr = value.slice(index + 1, -1);
|
|
||||||
} else {
|
|
||||||
throw new Error(`Invalid t-model expression: "${value}" (it should be assignable)`);
|
|
||||||
}
|
|
||||||
|
|
||||||
const typeAttr = node.getAttribute("type");
|
|
||||||
const isInput = tagName === "input";
|
|
||||||
const isSelect = tagName === "select";
|
|
||||||
const isTextarea = tagName === "textarea";
|
|
||||||
const isCheckboxInput = isInput && typeAttr === "checkbox";
|
|
||||||
const isRadioInput = isInput && typeAttr === "radio";
|
|
||||||
const isOtherInput = isInput && !isCheckboxInput && !isRadioInput;
|
|
||||||
const hasLazyMod = attr.includes(".lazy");
|
|
||||||
const hasNumberMod = attr.includes(".number");
|
|
||||||
const hasTrimMod = attr.includes(".trim");
|
|
||||||
const eventType = isRadioInput ? "click" : isSelect || hasLazyMod ? "change" : "input";
|
|
||||||
|
|
||||||
model = {
|
|
||||||
baseExpr,
|
|
||||||
expr,
|
|
||||||
targetAttr: isCheckboxInput ? "checked" : "value",
|
|
||||||
specialInitTargetAttr: isRadioInput ? "checked" : null,
|
|
||||||
eventType,
|
|
||||||
shouldTrim: hasTrimMod && (isOtherInput || isTextarea),
|
|
||||||
shouldNumberize: hasNumberMod && (isOtherInput || isTextarea),
|
|
||||||
};
|
|
||||||
} else {
|
|
||||||
if (attr.startsWith("t-") && !attr.startsWith("t-att")) {
|
|
||||||
throw new Error(`Unknown QWeb directive: '${attr}'`);
|
|
||||||
}
|
|
||||||
attrs[attr] = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (children.length === 1 && children[0].type === ASTType.TForEach) {
|
|
||||||
children[0].isOnlyChild = true;
|
|
||||||
}
|
|
||||||
return {
|
|
||||||
type: ASTType.DomNode,
|
|
||||||
tag: tagName,
|
|
||||||
dynamicTag,
|
|
||||||
attrs,
|
|
||||||
on,
|
|
||||||
ref,
|
|
||||||
content: children,
|
|
||||||
model,
|
|
||||||
ns,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// t-esc
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function parseTEscNode(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (!node.hasAttribute("t-esc")) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
const escValue = node.getAttribute("t-esc")!;
|
|
||||||
node.removeAttribute("t-esc");
|
|
||||||
const tesc: AST = {
|
|
||||||
type: ASTType.TEsc,
|
|
||||||
expr: escValue,
|
|
||||||
defaultValue: node.textContent || "",
|
|
||||||
};
|
|
||||||
let ref = node.getAttribute("t-ref");
|
|
||||||
node.removeAttribute("t-ref");
|
|
||||||
const ast = parseNode(node, ctx);
|
|
||||||
if (!ast) {
|
|
||||||
return tesc;
|
|
||||||
}
|
|
||||||
if (ast.type === ASTType.DomNode) {
|
|
||||||
return {
|
|
||||||
...ast,
|
|
||||||
ref,
|
|
||||||
content: [tesc],
|
|
||||||
};
|
|
||||||
}
|
|
||||||
if (ast.type === ASTType.TComponent) {
|
|
||||||
throw new Error("t-esc is not supported on Component nodes");
|
|
||||||
}
|
|
||||||
return tesc;
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// t-out
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function parseTOutNode(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (!node.hasAttribute("t-out") && !node.hasAttribute("t-raw")) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
if (node.hasAttribute("t-raw")) {
|
|
||||||
console.warn(
|
|
||||||
`t-raw has been deprecated in favor of t-out. If the value to render is not wrapped by the "markup" function, it will be escaped`
|
|
||||||
);
|
|
||||||
}
|
|
||||||
const expr = (node.getAttribute("t-out") || node.getAttribute("t-raw"))!;
|
|
||||||
node.removeAttribute("t-out");
|
|
||||||
node.removeAttribute("t-raw");
|
|
||||||
|
|
||||||
const tOut: AST = { type: ASTType.TOut, expr, body: null };
|
|
||||||
const ref = node.getAttribute("t-ref");
|
|
||||||
node.removeAttribute("t-ref");
|
|
||||||
const ast = parseNode(node, ctx);
|
|
||||||
if (!ast) {
|
|
||||||
return tOut;
|
|
||||||
}
|
|
||||||
if (ast.type === ASTType.DomNode) {
|
|
||||||
tOut.body = ast.content.length ? ast.content : null;
|
|
||||||
return {
|
|
||||||
...ast,
|
|
||||||
ref,
|
|
||||||
content: [tOut],
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
return tOut;
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// t-foreach and t-key
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function parseTForEach(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (!node.hasAttribute("t-foreach")) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
const html = node.outerHTML;
|
|
||||||
const collection = node.getAttribute("t-foreach")!;
|
|
||||||
node.removeAttribute("t-foreach");
|
|
||||||
const elem = node.getAttribute("t-as") || "";
|
|
||||||
node.removeAttribute("t-as");
|
|
||||||
const key = node.getAttribute("t-key");
|
|
||||||
if (!key) {
|
|
||||||
throw new Error(
|
|
||||||
`"Directive t-foreach should always be used with a t-key!" (expression: t-foreach="${collection}" t-as="${elem}")`
|
|
||||||
);
|
|
||||||
}
|
|
||||||
node.removeAttribute("t-key");
|
|
||||||
const memo = node.getAttribute("t-memo") || "";
|
|
||||||
node.removeAttribute("t-memo");
|
|
||||||
const body = parseNode(node, ctx);
|
|
||||||
|
|
||||||
if (!body) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
const hasNoTCall = !html.includes("t-call");
|
|
||||||
const hasNoFirst = hasNoTCall && !html.includes(`${elem}_first`);
|
|
||||||
const hasNoLast = hasNoTCall && !html.includes(`${elem}_last`);
|
|
||||||
const hasNoIndex = hasNoTCall && !html.includes(`${elem}_index`);
|
|
||||||
const hasNoValue = hasNoTCall && !html.includes(`${elem}_value`);
|
|
||||||
|
|
||||||
return {
|
|
||||||
type: ASTType.TForEach,
|
|
||||||
collection,
|
|
||||||
elem,
|
|
||||||
body,
|
|
||||||
memo,
|
|
||||||
key,
|
|
||||||
isOnlyChild: false,
|
|
||||||
hasNoComponent: hasNoComponent(body),
|
|
||||||
hasNoFirst,
|
|
||||||
hasNoLast,
|
|
||||||
hasNoIndex,
|
|
||||||
hasNoValue,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @returns true if we are sure the ast does not contain any component
|
|
||||||
*/
|
|
||||||
function hasNoComponent(ast: AST): boolean {
|
|
||||||
switch (ast.type) {
|
|
||||||
case ASTType.TComponent:
|
|
||||||
case ASTType.TOut:
|
|
||||||
case ASTType.TCall:
|
|
||||||
case ASTType.TCallBlock:
|
|
||||||
case ASTType.TSlot:
|
|
||||||
return false;
|
|
||||||
case ASTType.TSet:
|
|
||||||
case ASTType.Text:
|
|
||||||
case ASTType.Comment:
|
|
||||||
case ASTType.TEsc:
|
|
||||||
return true;
|
|
||||||
case ASTType.TKey:
|
|
||||||
return hasNoComponent(ast.content);
|
|
||||||
case ASTType.TDebug:
|
|
||||||
case ASTType.TLog:
|
|
||||||
case ASTType.TTranslation:
|
|
||||||
return ast.content ? hasNoComponent(ast.content) : true;
|
|
||||||
case ASTType.TForEach:
|
|
||||||
return ast.hasNoComponent;
|
|
||||||
case ASTType.Multi:
|
|
||||||
case ASTType.DomNode: {
|
|
||||||
for (let elem of ast.content) {
|
|
||||||
if (!hasNoComponent(elem)) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
case ASTType.TIf: {
|
|
||||||
if (!hasNoComponent(ast.content)) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
if (ast.tElif) {
|
|
||||||
for (let elem of ast.tElif) {
|
|
||||||
if (!hasNoComponent(elem.content)) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (ast.tElse && !hasNoComponent(ast.tElse)) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
function parseTKey(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (!node.hasAttribute("t-key")) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
const key = node.getAttribute("t-key")!;
|
|
||||||
node.removeAttribute("t-key");
|
|
||||||
const body = parseNode(node, ctx);
|
|
||||||
if (!body) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
return { type: ASTType.TKey, expr: key, content: body };
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// t-call
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function parseTCall(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (!node.hasAttribute("t-call")) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
const subTemplate = node.getAttribute("t-call")!;
|
|
||||||
|
|
||||||
node.removeAttribute("t-call");
|
|
||||||
if (node.tagName !== "t") {
|
|
||||||
const ast = parseNode(node, ctx);
|
|
||||||
const tcall: AST = { type: ASTType.TCall, name: subTemplate, body: null };
|
|
||||||
if (ast && ast.type === ASTType.DomNode) {
|
|
||||||
ast.content = [tcall];
|
|
||||||
return ast;
|
|
||||||
}
|
|
||||||
if (ast && ast.type === ASTType.TComponent) {
|
|
||||||
return {
|
|
||||||
...ast,
|
|
||||||
slots: { default: { content: tcall } },
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const body = parseChildren(node, ctx);
|
|
||||||
|
|
||||||
return {
|
|
||||||
type: ASTType.TCall,
|
|
||||||
name: subTemplate,
|
|
||||||
body: body.length ? body : null,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// t-call-block
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function parseTCallBlock(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (!node.hasAttribute("t-call-block")) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
const name = node.getAttribute("t-call-block")!;
|
|
||||||
return {
|
|
||||||
type: ASTType.TCallBlock,
|
|
||||||
name,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// t-if
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function parseTIf(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (!node.hasAttribute("t-if")) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
const condition = node.getAttribute("t-if")!;
|
|
||||||
node.removeAttribute("t-if");
|
|
||||||
const content = parseNode(node, ctx) || { type: ASTType.Text, value: "" };
|
|
||||||
|
|
||||||
let nextElement = node.nextElementSibling;
|
|
||||||
// t-elifs
|
|
||||||
const tElifs: any[] = [];
|
|
||||||
while (nextElement && nextElement.hasAttribute("t-elif")) {
|
|
||||||
const condition = nextElement.getAttribute("t-elif");
|
|
||||||
nextElement.removeAttribute("t-elif");
|
|
||||||
const tElif = parseNode(nextElement, ctx);
|
|
||||||
const next = nextElement.nextElementSibling;
|
|
||||||
nextElement.remove();
|
|
||||||
nextElement = next;
|
|
||||||
if (tElif) {
|
|
||||||
tElifs.push({ condition, content: tElif });
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// t-else
|
|
||||||
let tElse: AST | null = null;
|
|
||||||
if (nextElement && nextElement.hasAttribute("t-else")) {
|
|
||||||
nextElement.removeAttribute("t-else");
|
|
||||||
tElse = parseNode(nextElement, ctx);
|
|
||||||
nextElement.remove();
|
|
||||||
}
|
|
||||||
|
|
||||||
return {
|
|
||||||
type: ASTType.TIf,
|
|
||||||
condition,
|
|
||||||
content,
|
|
||||||
tElif: tElifs.length ? tElifs : null,
|
|
||||||
tElse,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// t-set directive
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function parseTSetNode(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (!node.hasAttribute("t-set")) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
const name = node.getAttribute("t-set")!;
|
|
||||||
const value = node.getAttribute("t-value") || null;
|
|
||||||
const defaultValue = node.innerHTML === node.textContent ? node.textContent || null : null;
|
|
||||||
let body: AST[] | null = null;
|
|
||||||
if (node.textContent !== node.innerHTML) {
|
|
||||||
body = parseChildren(node, ctx);
|
|
||||||
}
|
|
||||||
return { type: ASTType.TSet, name, value, defaultValue, body };
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Components
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
// Error messages when trying to use an unsupported directive on a component
|
|
||||||
const directiveErrorMap = new Map([
|
|
||||||
["t-on", "t-on is no longer supported on components. Consider passing a callback in props."],
|
|
||||||
[
|
|
||||||
"t-ref",
|
|
||||||
"t-ref is no longer supported on components. Consider exposing only the public part of the component's API through a callback prop.",
|
|
||||||
],
|
|
||||||
["t-att", "t-att makes no sense on component: props are already treated as expressions"],
|
|
||||||
[
|
|
||||||
"t-attf",
|
|
||||||
"t-attf is not supported on components: use template strings for string interpolation in props",
|
|
||||||
],
|
|
||||||
]);
|
|
||||||
|
|
||||||
function parseComponent(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
let name = node.tagName;
|
|
||||||
const firstLetter = name[0];
|
|
||||||
let isDynamic = node.hasAttribute("t-component");
|
|
||||||
|
|
||||||
if (isDynamic && name !== "t") {
|
|
||||||
throw new Error(`Directive 't-component' can only be used on <t> nodes (used on a <${name}>)`);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (!(firstLetter === firstLetter.toUpperCase() || isDynamic)) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
if (isDynamic) {
|
|
||||||
name = node.getAttribute("t-component")!;
|
|
||||||
node.removeAttribute("t-component");
|
|
||||||
}
|
|
||||||
|
|
||||||
const dynamicProps = node.getAttribute("t-props");
|
|
||||||
node.removeAttribute("t-props");
|
|
||||||
|
|
||||||
const props: ASTComponent["props"] = {};
|
|
||||||
for (let name of node.getAttributeNames()) {
|
|
||||||
const value = node.getAttribute(name)!;
|
|
||||||
if (name.startsWith("t-")) {
|
|
||||||
const message = directiveErrorMap.get(name.split("-").slice(0, 2).join("-"));
|
|
||||||
throw new Error(message || `unsupported directive on Component: ${name}`);
|
|
||||||
} else {
|
|
||||||
props[name] = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
const slots: ASTComponent["slots"] = {};
|
|
||||||
if (node.hasChildNodes()) {
|
|
||||||
const clone = <Element>node.cloneNode(true);
|
|
||||||
|
|
||||||
// named slots
|
|
||||||
const slotNodes = Array.from(clone.querySelectorAll("[t-set-slot]"));
|
|
||||||
for (let slotNode of slotNodes) {
|
|
||||||
if (slotNode.tagName !== "t") {
|
|
||||||
throw new Error(
|
|
||||||
`Directive 't-set-slot' can only be used on <t> nodes (used on a <${slotNode.tagName}>)`
|
|
||||||
);
|
|
||||||
}
|
|
||||||
const name = slotNode.getAttribute("t-set-slot")!;
|
|
||||||
|
|
||||||
// check if this is defined in a sub component (in which case it should
|
|
||||||
// be ignored)
|
|
||||||
let el = slotNode.parentElement!;
|
|
||||||
let isInSubComponent = false;
|
|
||||||
while (el !== clone) {
|
|
||||||
if (el!.hasAttribute("t-component") || el!.tagName[0] === el!.tagName[0].toUpperCase()) {
|
|
||||||
isInSubComponent = true;
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
el = el.parentElement!;
|
|
||||||
}
|
|
||||||
if (isInSubComponent) {
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
|
|
||||||
slotNode.removeAttribute("t-set-slot");
|
|
||||||
slotNode.remove();
|
|
||||||
const slotAst = parseNode(slotNode, ctx);
|
|
||||||
if (slotAst) {
|
|
||||||
const slotInfo: any = { content: slotAst };
|
|
||||||
const attrs: { [key: string]: string } = {};
|
|
||||||
for (let attributeName of slotNode.getAttributeNames()) {
|
|
||||||
const value = slotNode.getAttribute(attributeName)!;
|
|
||||||
if (attributeName === "t-slot-scope") {
|
|
||||||
slotInfo.scope = value;
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
attrs[attributeName] = value;
|
|
||||||
}
|
|
||||||
if (Object.keys(attrs).length) {
|
|
||||||
slotInfo.attrs = attrs;
|
|
||||||
}
|
|
||||||
slots[name] = slotInfo;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// default slot
|
|
||||||
const defaultContent = parseChildNodes(clone, ctx);
|
|
||||||
if (defaultContent) {
|
|
||||||
slots.default = { content: defaultContent };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return { type: ASTType.TComponent, name, isDynamic, dynamicProps, props, slots };
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Slots
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
function parseTSlot(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (!node.hasAttribute("t-slot")) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
const name = node.getAttribute("t-slot")!;
|
|
||||||
node.removeAttribute("t-slot");
|
|
||||||
const attrs: { [key: string]: string } = {};
|
|
||||||
for (let attributeName of node.getAttributeNames()) {
|
|
||||||
const value = node.getAttribute(attributeName)!;
|
|
||||||
attrs[attributeName] = value;
|
|
||||||
}
|
|
||||||
return {
|
|
||||||
type: ASTType.TSlot,
|
|
||||||
name,
|
|
||||||
attrs,
|
|
||||||
defaultContent: parseChildNodes(node, ctx),
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
function parseTTranslation(node: Element, ctx: ParsingContext): AST | null {
|
|
||||||
if (node.getAttribute("t-translation") !== "off") {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
node.removeAttribute("t-translation");
|
|
||||||
return {
|
|
||||||
type: ASTType.TTranslation,
|
|
||||||
content: parseNode(node, ctx),
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// helpers
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parse all the child nodes of a given node and return a list of ast elements
|
|
||||||
*/
|
|
||||||
function parseChildren(node: Node, ctx: ParsingContext): AST[] {
|
|
||||||
const children: AST[] = [];
|
|
||||||
for (let child of node.childNodes) {
|
|
||||||
const childAst = parseNode(child, ctx);
|
|
||||||
if (childAst) {
|
|
||||||
if (childAst.type === ASTType.Multi) {
|
|
||||||
children.push(...childAst.content);
|
|
||||||
} else {
|
|
||||||
children.push(childAst);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return children;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parse all the child nodes of a given node and return an ast if possible.
|
|
||||||
* In the case there are multiple children, they are wrapped in a astmulti.
|
|
||||||
*/
|
|
||||||
function parseChildNodes(node: Node, ctx: ParsingContext): AST | null {
|
|
||||||
const children = parseChildren(node, ctx);
|
|
||||||
switch (children.length) {
|
|
||||||
case 0:
|
|
||||||
return null;
|
|
||||||
case 1:
|
|
||||||
return children[0];
|
|
||||||
default:
|
|
||||||
return { type: ASTType.Multi, content: children };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Normalizes the content of an Element so that t-if/t-elif/t-else directives
|
|
||||||
* immediately follow one another (by removing empty text nodes or comments).
|
|
||||||
* Throws an error when a conditional branching statement is malformed. This
|
|
||||||
* function modifies the Element in place.
|
|
||||||
*
|
|
||||||
* @param el the element containing the tree that should be normalized
|
|
||||||
*/
|
|
||||||
function normalizeTIf(el: Element) {
|
|
||||||
let tbranch = el.querySelectorAll("[t-elif], [t-else]");
|
|
||||||
for (let i = 0, ilen = tbranch.length; i < ilen; i++) {
|
|
||||||
let node = tbranch[i];
|
|
||||||
let prevElem = node.previousElementSibling!;
|
|
||||||
let pattr = (name: string) => prevElem.getAttribute(name);
|
|
||||||
let nattr = (name: string) => +!!node.getAttribute(name);
|
|
||||||
if (prevElem && (pattr("t-if") || pattr("t-elif"))) {
|
|
||||||
if (pattr("t-foreach")) {
|
|
||||||
throw new Error(
|
|
||||||
"t-if cannot stay at the same level as t-foreach when using t-elif or t-else"
|
|
||||||
);
|
|
||||||
}
|
|
||||||
if (
|
|
||||||
["t-if", "t-elif", "t-else"].map(nattr).reduce(function (a, b) {
|
|
||||||
return a + b;
|
|
||||||
}) > 1
|
|
||||||
) {
|
|
||||||
throw new Error("Only one conditional branching directive is allowed per node");
|
|
||||||
}
|
|
||||||
// All text (with only spaces) and comment nodes (nodeType 8) between
|
|
||||||
// branch nodes are removed
|
|
||||||
let textNode;
|
|
||||||
while ((textNode = node.previousSibling) !== prevElem) {
|
|
||||||
if (textNode!.nodeValue!.trim().length && textNode!.nodeType !== 8) {
|
|
||||||
throw new Error("text is not allowed between branching directives");
|
|
||||||
}
|
|
||||||
textNode!.remove();
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
throw new Error(
|
|
||||||
"t-elif and t-else directives must be preceded by a t-if or t-elif directive"
|
|
||||||
);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Normalizes the content of an Element so that t-esc directives on components
|
|
||||||
* are removed and instead places a <t t-esc=""> as the default slot of the
|
|
||||||
* component. Also throws if the component already has content. This function
|
|
||||||
* modifies the Element in place.
|
|
||||||
*
|
|
||||||
* @param el the element containing the tree that should be normalized
|
|
||||||
*/
|
|
||||||
function normalizeTEsc(el: Element) {
|
|
||||||
const elements = [...el.querySelectorAll("[t-esc]")].filter(
|
|
||||||
(el) => el.tagName[0] === el.tagName[0].toUpperCase() || el.hasAttribute("t-component")
|
|
||||||
);
|
|
||||||
for (const el of elements) {
|
|
||||||
if (el.childNodes.length) {
|
|
||||||
throw new Error("Cannot have t-esc on a component that already has content");
|
|
||||||
}
|
|
||||||
const value = el.getAttribute("t-esc");
|
|
||||||
el.removeAttribute("t-esc");
|
|
||||||
const t = el.ownerDocument.createElement("t");
|
|
||||||
if (value != null) {
|
|
||||||
t.setAttribute("t-esc", value);
|
|
||||||
}
|
|
||||||
el.appendChild(t);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Normalizes the tree inside a given element and do some preliminary validation
|
|
||||||
* on it. This function modifies the Element in place.
|
|
||||||
*
|
|
||||||
* @param el the element containing the tree that should be normalized
|
|
||||||
*/
|
|
||||||
function normalizeXML(el: Element) {
|
|
||||||
normalizeTIf(el);
|
|
||||||
normalizeTEsc(el);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parses an XML string into an XML document, throwing errors on parser errors
|
|
||||||
* instead of returning an XML document containing the parseerror.
|
|
||||||
*
|
|
||||||
* @param xml the string to parse
|
|
||||||
* @returns an XML document corresponding to the content of the string
|
|
||||||
*/
|
|
||||||
function parseXML(xml: string): XMLDocument {
|
|
||||||
const parser = new DOMParser();
|
|
||||||
const doc = parser.parseFromString(xml, "text/xml");
|
|
||||||
if (doc.getElementsByTagName("parsererror").length) {
|
|
||||||
let msg = "Invalid XML in template.";
|
|
||||||
const parsererrorText = doc.getElementsByTagName("parsererror")[0].textContent;
|
|
||||||
if (parsererrorText) {
|
|
||||||
msg += "\nThe parser has produced the following error message:\n" + parsererrorText;
|
|
||||||
const re = /\d+/g;
|
|
||||||
const firstMatch = re.exec(parsererrorText);
|
|
||||||
if (firstMatch) {
|
|
||||||
const lineNumber = Number(firstMatch[0]);
|
|
||||||
const line = xml.split("\n")[lineNumber - 1];
|
|
||||||
const secondMatch = re.exec(parsererrorText);
|
|
||||||
if (line && secondMatch) {
|
|
||||||
const columnIndex = Number(secondMatch[0]) - 1;
|
|
||||||
if (line[columnIndex]) {
|
|
||||||
msg +=
|
|
||||||
`\nThe error might be located at xml line ${lineNumber} column ${columnIndex}\n` +
|
|
||||||
`${line}\n${"-".repeat(columnIndex - 1)}^`;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
throw new Error(msg);
|
|
||||||
}
|
|
||||||
|
|
||||||
return doc;
|
|
||||||
}
|
|
||||||
+772
-18
@@ -1,27 +1,781 @@
|
|||||||
import type { Env } from "../app/app";
|
import { Observer } from "../core/observer";
|
||||||
import type { ComponentNode } from "./component_node";
|
import { OwlEvent } from "../core/owl_event";
|
||||||
|
import { CompiledTemplate, QWeb } from "../qweb/index";
|
||||||
|
import { patch, VNode } from "../vdom/index";
|
||||||
|
import "./directive";
|
||||||
|
import { Fiber } from "./fiber";
|
||||||
|
import "./props_validation";
|
||||||
|
import { Scheduler, scheduler } from "./scheduler";
|
||||||
|
import { activateSheet } from "./styles";
|
||||||
|
import { Browser, browser } from "../browser";
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
/**
|
||||||
// Component Class
|
* Owl Component System
|
||||||
// -----------------------------------------------------------------------------
|
*
|
||||||
|
* This file introduces a declarative and composable component system. It
|
||||||
|
* contains:
|
||||||
|
*
|
||||||
|
* - the Env interface (generic type for the environment)
|
||||||
|
* - the Internal interface (the owl specific metadata attached to a component)
|
||||||
|
* - the Component class
|
||||||
|
*/
|
||||||
|
|
||||||
export class Component {
|
//------------------------------------------------------------------------------
|
||||||
static template: string = "";
|
// Types/helpers
|
||||||
static props?: any;
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
props: any;
|
/**
|
||||||
env: Env;
|
* An Env (environment) is an object that will be (mostly) shared between all
|
||||||
__owl__: ComponentNode;
|
* components of an Owl application. It is the location which should contain
|
||||||
|
* the qweb instance necessary to render all components.
|
||||||
constructor(props: any, env: Env, node: ComponentNode) {
|
*
|
||||||
this.props = props;
|
* Note that it is totally fine to extend the environment with application
|
||||||
this.env = env;
|
* specific keys/objects/whatever. For example, a key `isMobile` (to declare
|
||||||
this.__owl__ = node;
|
* if we are in "mobile" mode), or a shared bus could be useful.
|
||||||
|
*/
|
||||||
|
export interface Env {
|
||||||
|
qweb: QWeb;
|
||||||
|
browser: Browser;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export type MountPosition = "first-child" | "last-child" | "self";
|
||||||
|
|
||||||
|
interface MountOptions {
|
||||||
|
position?: MountPosition;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const enum STATUS {
|
||||||
|
CREATED,
|
||||||
|
WILLSTARTED, // willstart has been called
|
||||||
|
RENDERED, // first render is completed (so, vnode is now defined)
|
||||||
|
MOUNTED, // is ready, and in DOM. It has a valid el
|
||||||
|
UNMOUNTED, // has a valid el, but is not in DOM
|
||||||
|
DESTROYED,
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This is mostly an internal detail of implementation. The Meta interface is
|
||||||
|
* useful to typecheck and describe the internal keys used by Owl to manage the
|
||||||
|
* component tree.
|
||||||
|
*/
|
||||||
|
interface Internal<T extends Env> {
|
||||||
|
// each component has a unique id, useful mostly to handle parent/child
|
||||||
|
// relationships
|
||||||
|
readonly id: number;
|
||||||
|
depth: number;
|
||||||
|
vnode: VNode | null;
|
||||||
|
pvnode: VNode | null;
|
||||||
|
status: STATUS;
|
||||||
|
|
||||||
|
// parent and children keys are obviously useful to setup the parent-children
|
||||||
|
// relationship.
|
||||||
|
parent: Component<any, T> | null;
|
||||||
|
children: { [key: number]: Component<any, T> };
|
||||||
|
// children mapping: from templateID to componentID. templateID identifies a
|
||||||
|
// place in a template. The t-component directive needs it to be able to get
|
||||||
|
// the component instance back whenever the template is rerendered.
|
||||||
|
cmap: { [key: number]: number };
|
||||||
|
|
||||||
|
currentFiber: Fiber | null;
|
||||||
|
// parentLastFiberId is there to help the parent component to detect, among
|
||||||
|
// its children, those that are not used anymore and thus can be destroyed
|
||||||
|
parentLastFiberId: number;
|
||||||
|
|
||||||
|
// when a rendering is initiated by a parent, it may set variables in 'scope'
|
||||||
|
// (typically when the component is rendered in a slot). We need to
|
||||||
|
// store that information in case the component would be re-rendered later on.
|
||||||
|
scope: any;
|
||||||
|
|
||||||
|
boundHandlers: { [key: number]: any };
|
||||||
|
observer: Observer | null;
|
||||||
|
renderFn: CompiledTemplate;
|
||||||
|
mountedCB: Function | null;
|
||||||
|
willUnmountCB: Function | null;
|
||||||
|
willPatchCB: Function | null;
|
||||||
|
patchedCB: Function | null;
|
||||||
|
willStartCB: Function | null;
|
||||||
|
willUpdatePropsCB: Function | null;
|
||||||
|
classObj: { [key: string]: boolean } | null;
|
||||||
|
refs: { [key: string]: Component<any, T> | HTMLElement | undefined } | null;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const portalSymbol = Symbol("portal"); // FIXME
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Component
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
let nextId = 1;
|
||||||
|
|
||||||
|
export class Component<Props extends {} = any, T extends Env = Env> {
|
||||||
|
readonly __owl__: Internal<T>;
|
||||||
|
static template?: string | null = null;
|
||||||
|
static _template?: string | null = null;
|
||||||
|
static current: Component | null = null;
|
||||||
|
static components = {};
|
||||||
|
static props?: any;
|
||||||
|
static defaultProps?: any;
|
||||||
|
static env: any = {};
|
||||||
|
// expose scheduler s.t. it can be mocked for testing purposes
|
||||||
|
static scheduler: Scheduler = scheduler;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The `el` is the root element of the component. Note that it could be null:
|
||||||
|
* this is the case if the component is not mounted yet, or is destroyed.
|
||||||
|
*/
|
||||||
|
get el(): HTMLElement | null {
|
||||||
|
return this.__owl__.vnode ? (<any>this).__owl__.vnode.elm : null;
|
||||||
|
}
|
||||||
|
|
||||||
|
env: T;
|
||||||
|
props: Props;
|
||||||
|
|
||||||
|
//--------------------------------------------------------------------------
|
||||||
|
// Lifecycle
|
||||||
|
//--------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates an instance of Component.
|
||||||
|
*
|
||||||
|
* Note that most of the time, only the root component needs to be created by
|
||||||
|
* hand. Other components should be created automatically by the framework (with
|
||||||
|
* the t-component directive in a template)
|
||||||
|
*/
|
||||||
|
constructor(parent?: Component<any, T> | null, props?: Props) {
|
||||||
|
Component.current = this;
|
||||||
|
|
||||||
|
let constr = this.constructor as any;
|
||||||
|
const defaultProps = constr.defaultProps;
|
||||||
|
if (defaultProps) {
|
||||||
|
props = props || ({} as Props);
|
||||||
|
this.__applyDefaultProps(props, defaultProps);
|
||||||
|
}
|
||||||
|
this.props = <Props>props;
|
||||||
|
if (QWeb.dev) {
|
||||||
|
QWeb.utils.validateProps(constr, this.props);
|
||||||
|
}
|
||||||
|
|
||||||
|
const id: number = nextId++;
|
||||||
|
let depth;
|
||||||
|
if (parent) {
|
||||||
|
this.env = parent.env;
|
||||||
|
const __powl__ = parent.__owl__;
|
||||||
|
__powl__.children[id] = this;
|
||||||
|
depth = __powl__.depth + 1;
|
||||||
|
} else {
|
||||||
|
// we are the root component
|
||||||
|
this.env = (this.constructor as any).env;
|
||||||
|
if (!this.env.qweb) {
|
||||||
|
this.env.qweb = new QWeb();
|
||||||
|
}
|
||||||
|
// TODO: remove this in owl 2.0
|
||||||
|
if (!this.env.browser) {
|
||||||
|
this.env.browser = browser;
|
||||||
|
}
|
||||||
|
this.env.qweb.on("update", this, () => {
|
||||||
|
switch (this.__owl__.status) {
|
||||||
|
case STATUS.MOUNTED:
|
||||||
|
this.render(true);
|
||||||
|
break;
|
||||||
|
case STATUS.DESTROYED:
|
||||||
|
// this is unlikely to happen, but if a root widget is destroyed,
|
||||||
|
// we want to remove our subscription. The usual way to do that
|
||||||
|
// would be to perform some check in the destroy method, but since
|
||||||
|
// it is very performance sensitive, and since this is a rare event,
|
||||||
|
// we simply do it lazily
|
||||||
|
this.env.qweb.off("update", this);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
depth = 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
const qweb = this.env.qweb;
|
||||||
|
const template = constr.template || this.__getTemplate(qweb);
|
||||||
|
this.__owl__ = {
|
||||||
|
id: id,
|
||||||
|
depth: depth,
|
||||||
|
vnode: null,
|
||||||
|
pvnode: null,
|
||||||
|
status: STATUS.CREATED,
|
||||||
|
parent: parent || null,
|
||||||
|
children: {},
|
||||||
|
cmap: {},
|
||||||
|
currentFiber: null,
|
||||||
|
parentLastFiberId: 0,
|
||||||
|
boundHandlers: {},
|
||||||
|
mountedCB: null,
|
||||||
|
willUnmountCB: null,
|
||||||
|
willPatchCB: null,
|
||||||
|
patchedCB: null,
|
||||||
|
willStartCB: null,
|
||||||
|
willUpdatePropsCB: null,
|
||||||
|
observer: null,
|
||||||
|
renderFn: qweb.render.bind(qweb, template),
|
||||||
|
classObj: null,
|
||||||
|
refs: null,
|
||||||
|
scope: null,
|
||||||
|
};
|
||||||
|
if (constr.style) {
|
||||||
|
this.__applyStyles(constr);
|
||||||
|
}
|
||||||
|
this.setup();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* setup is run just after the component is constructed. This is the standard
|
||||||
|
* location where the component can setup its hooks. It has some advantages
|
||||||
|
* over the constructor:
|
||||||
|
* - it can be patched (useful in odoo ecosystem)
|
||||||
|
* - it does not need to propagate the arguments to the super call
|
||||||
|
*
|
||||||
|
* Note: this method should not be called manually.
|
||||||
|
*/
|
||||||
setup() {}
|
setup() {}
|
||||||
|
|
||||||
render() {
|
/**
|
||||||
this.__owl__.render();
|
* willStart is an asynchronous hook that can be implemented to perform some
|
||||||
|
* action before the initial rendering of a component.
|
||||||
|
*
|
||||||
|
* It will be called exactly once before the initial rendering. It is useful
|
||||||
|
* in some cases, for example, to load external assets (such as a JS library)
|
||||||
|
* before the component is rendered.
|
||||||
|
*
|
||||||
|
* Note that a slow willStart method will slow down the rendering of the user
|
||||||
|
* interface. Therefore, some effort should be made to make this method as
|
||||||
|
* fast as possible.
|
||||||
|
*
|
||||||
|
* Note: this method should not be called manually.
|
||||||
|
*/
|
||||||
|
async willStart() {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* mounted is a hook that is called each time a component is attached to the
|
||||||
|
* DOM. This is a good place to add some listeners, or to interact with the
|
||||||
|
* DOM, if the component needs to perform some measure for example.
|
||||||
|
*
|
||||||
|
* Note: this method should not be called manually.
|
||||||
|
*
|
||||||
|
* @see willUnmount
|
||||||
|
*/
|
||||||
|
mounted() {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The willUpdateProps is an asynchronous hook, called just before new props
|
||||||
|
* are set. This is useful if the component needs some asynchronous task
|
||||||
|
* performed, depending on the props (for example, assuming that the props are
|
||||||
|
* some record Id, fetching the record data).
|
||||||
|
*
|
||||||
|
* This hook is not called during the first render (but willStart is called
|
||||||
|
* and performs a similar job).
|
||||||
|
*/
|
||||||
|
async willUpdateProps(nextProps: Props) {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The willPatch hook is called just before the DOM patching process starts.
|
||||||
|
* It is not called on the initial render. This is useful to get some
|
||||||
|
* information which are in the DOM. For example, the current position of the
|
||||||
|
* scrollbar
|
||||||
|
*/
|
||||||
|
willPatch(): any {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This hook is called whenever a component did actually update its props,
|
||||||
|
* state or env.
|
||||||
|
*
|
||||||
|
* This method is not called on the initial render. It is useful to interact
|
||||||
|
* with the DOM (for example, through an external library) whenever the
|
||||||
|
* component was updated.
|
||||||
|
*
|
||||||
|
* Updating the component state in this hook is possible, but not encouraged.
|
||||||
|
* One need to be careful, because updates here will cause rerender, which in
|
||||||
|
* turn will cause other calls to updated. So, we need to be particularly
|
||||||
|
* careful at avoiding endless cycles.
|
||||||
|
*/
|
||||||
|
patched() {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* willUnmount is a hook that is called each time just before a component is
|
||||||
|
* unmounted from the DOM. This is a good place to remove some listeners, for
|
||||||
|
* example.
|
||||||
|
*
|
||||||
|
* Note: this method should not be called manually.
|
||||||
|
*
|
||||||
|
* @see mounted
|
||||||
|
*/
|
||||||
|
willUnmount() {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* catchError is a method called whenever some error happens in the rendering or
|
||||||
|
* lifecycle hooks of a child.
|
||||||
|
*
|
||||||
|
* It needs to be implemented by a component that is designed to handle the
|
||||||
|
* error properly.
|
||||||
|
*/
|
||||||
|
catchError?(error?: Error): void;
|
||||||
|
|
||||||
|
//--------------------------------------------------------------------------
|
||||||
|
// Public
|
||||||
|
//--------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Mount the component to a target element.
|
||||||
|
*
|
||||||
|
* This should only be done if the component was created manually. Components
|
||||||
|
* created declaratively in templates are managed by the Owl system.
|
||||||
|
*
|
||||||
|
* Note that a component can be mounted an unmounted several times
|
||||||
|
*/
|
||||||
|
async mount(target: HTMLElement | DocumentFragment, options: MountOptions = {}): Promise<void> {
|
||||||
|
if (!(target instanceof HTMLElement || target instanceof DocumentFragment)) {
|
||||||
|
let message = `Component '${this.constructor.name}' cannot be mounted: the target is not a valid DOM node.`;
|
||||||
|
message += `\nMaybe the DOM is not ready yet? (in that case, you can use owl.utils.whenReady)`;
|
||||||
|
throw new Error(message);
|
||||||
|
}
|
||||||
|
const position = options.position || "last-child";
|
||||||
|
const __owl__ = this.__owl__;
|
||||||
|
const currentFiber = __owl__.currentFiber;
|
||||||
|
|
||||||
|
switch (__owl__.status) {
|
||||||
|
case STATUS.CREATED: {
|
||||||
|
const fiber = new Fiber(null, this, true, target, position);
|
||||||
|
fiber.shouldPatch = false;
|
||||||
|
this.__prepareAndRender(fiber, () => {});
|
||||||
|
return scheduler.addFiber(fiber);
|
||||||
|
}
|
||||||
|
case STATUS.WILLSTARTED:
|
||||||
|
case STATUS.RENDERED:
|
||||||
|
currentFiber.target = target;
|
||||||
|
currentFiber.position = position;
|
||||||
|
return scheduler.addFiber(currentFiber);
|
||||||
|
|
||||||
|
case STATUS.UNMOUNTED: {
|
||||||
|
const fiber = new Fiber(null, this, true, target, position);
|
||||||
|
fiber.shouldPatch = false;
|
||||||
|
this.__render(fiber);
|
||||||
|
return scheduler.addFiber(fiber);
|
||||||
|
}
|
||||||
|
|
||||||
|
case STATUS.MOUNTED: {
|
||||||
|
if (position !== "self" && this.el!.parentNode !== target) {
|
||||||
|
const fiber = new Fiber(null, this, true, target, position);
|
||||||
|
fiber.shouldPatch = false;
|
||||||
|
this.__render(fiber);
|
||||||
|
return scheduler.addFiber(fiber);
|
||||||
|
} else {
|
||||||
|
return Promise.resolve();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
case STATUS.DESTROYED:
|
||||||
|
throw new Error("Cannot mount a destroyed component");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The unmount method is the opposite of the mount method. It is useful
|
||||||
|
* to call willUnmount calls and remove the component from the DOM.
|
||||||
|
*/
|
||||||
|
unmount() {
|
||||||
|
if (this.__owl__.status === STATUS.MOUNTED) {
|
||||||
|
this.__callWillUnmount();
|
||||||
|
this.el!.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The render method is the main entry point to render a component (once it
|
||||||
|
* is ready. This method is not initially called when the component is
|
||||||
|
* rendered the first time).
|
||||||
|
*
|
||||||
|
* This method will cause all its sub components to potentially rerender
|
||||||
|
* themselves. Note that `render` is not called if a component is updated via
|
||||||
|
* its props.
|
||||||
|
*/
|
||||||
|
async render(force: boolean = false): Promise<void> {
|
||||||
|
const __owl__ = this.__owl__;
|
||||||
|
const currentFiber = __owl__.currentFiber;
|
||||||
|
if (!__owl__.vnode && !currentFiber) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
if (currentFiber && !currentFiber.isRendered && !currentFiber.isCompleted) {
|
||||||
|
return scheduler.addFiber(currentFiber.root);
|
||||||
|
}
|
||||||
|
|
||||||
|
// if we aren't mounted at this point, it implies that there is a
|
||||||
|
// currentFiber that is already rendered (isRendered is true), so we are
|
||||||
|
// about to be mounted
|
||||||
|
const status = __owl__.status;
|
||||||
|
const fiber = new Fiber(null, this, force, null, null);
|
||||||
|
Promise.resolve().then(() => {
|
||||||
|
if (__owl__.status === STATUS.MOUNTED || status !== STATUS.MOUNTED) {
|
||||||
|
if (fiber.isCompleted || fiber.isRendered) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
this.__render(fiber);
|
||||||
|
} else {
|
||||||
|
// we were mounted when render was called, but we aren't anymore, so we
|
||||||
|
// were actually about to be unmounted ; we can thus forget about this
|
||||||
|
// fiber
|
||||||
|
fiber.isCompleted = true;
|
||||||
|
__owl__.currentFiber = null;
|
||||||
|
}
|
||||||
|
});
|
||||||
|
return scheduler.addFiber(fiber);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Destroy the component. This operation is quite complex:
|
||||||
|
* - it recursively destroy all children
|
||||||
|
* - call the willUnmount hooks if necessary
|
||||||
|
* - remove the dom node from the dom
|
||||||
|
*
|
||||||
|
* This should only be called manually if you created the component. Most
|
||||||
|
* components will be automatically destroyed.
|
||||||
|
*/
|
||||||
|
destroy() {
|
||||||
|
const __owl__ = this.__owl__;
|
||||||
|
if (__owl__.status !== STATUS.DESTROYED) {
|
||||||
|
const el = this.el;
|
||||||
|
this.__destroy(__owl__.parent);
|
||||||
|
if (el) {
|
||||||
|
el.remove();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This method is called by the component system whenever its props are
|
||||||
|
* updated. If it returns true, then the component will be rendered.
|
||||||
|
* Otherwise, it will skip the rendering (also, its props will not be updated)
|
||||||
|
*/
|
||||||
|
shouldUpdate(nextProps: Props): boolean {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Emit a custom event of type 'eventType' with the given 'payload' on the
|
||||||
|
* component's el, if it exists. However, note that the event will only bubble
|
||||||
|
* up to the parent DOM nodes. Thus, it must be called between mounted() and
|
||||||
|
* willUnmount().
|
||||||
|
*/
|
||||||
|
trigger<T = any>(eventType: string, payload?: T) {
|
||||||
|
this.__trigger<T>(this, eventType, payload);
|
||||||
|
}
|
||||||
|
|
||||||
|
//--------------------------------------------------------------------------
|
||||||
|
// Private
|
||||||
|
//--------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Private helper to perform a full destroy, from the point of view of an Owl
|
||||||
|
* component. It does not remove the el (this is done only once on the top
|
||||||
|
* level destroyed component, for performance reasons).
|
||||||
|
*
|
||||||
|
* The job of this method is mostly to call willUnmount hooks, and to perform
|
||||||
|
* all necessary internal cleanup.
|
||||||
|
*
|
||||||
|
* Note that it does not call the __callWillUnmount method to avoid visiting
|
||||||
|
* all children many times.
|
||||||
|
*/
|
||||||
|
__destroy(parent: Component | null) {
|
||||||
|
const __owl__ = this.__owl__;
|
||||||
|
if (__owl__.status === STATUS.MOUNTED) {
|
||||||
|
if (__owl__.willUnmountCB) {
|
||||||
|
__owl__.willUnmountCB();
|
||||||
|
}
|
||||||
|
this.willUnmount();
|
||||||
|
__owl__.status = STATUS.UNMOUNTED;
|
||||||
|
}
|
||||||
|
const children = __owl__.children;
|
||||||
|
for (let key in children) {
|
||||||
|
children[key].__destroy(this);
|
||||||
|
}
|
||||||
|
if (parent) {
|
||||||
|
let id = __owl__.id;
|
||||||
|
delete parent.__owl__.children[id];
|
||||||
|
__owl__.parent = null;
|
||||||
|
}
|
||||||
|
__owl__.status = STATUS.DESTROYED;
|
||||||
|
delete __owl__.vnode;
|
||||||
|
if (__owl__.currentFiber) {
|
||||||
|
__owl__.currentFiber.isCompleted = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
__callMounted() {
|
||||||
|
const __owl__ = this.__owl__;
|
||||||
|
|
||||||
|
__owl__.status = STATUS.MOUNTED;
|
||||||
|
this.mounted();
|
||||||
|
if (__owl__.mountedCB) {
|
||||||
|
__owl__.mountedCB();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
__callWillUnmount() {
|
||||||
|
const __owl__ = this.__owl__;
|
||||||
|
if (__owl__.willUnmountCB) {
|
||||||
|
__owl__.willUnmountCB();
|
||||||
|
}
|
||||||
|
this.willUnmount();
|
||||||
|
__owl__.status = STATUS.UNMOUNTED;
|
||||||
|
if (__owl__.currentFiber) {
|
||||||
|
__owl__.currentFiber.isCompleted = true;
|
||||||
|
__owl__.currentFiber.root.counter = 0;
|
||||||
|
}
|
||||||
|
const children = __owl__.children;
|
||||||
|
for (let id in children) {
|
||||||
|
const comp = children[id];
|
||||||
|
if (comp.__owl__.status === STATUS.MOUNTED) {
|
||||||
|
comp.__callWillUnmount();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Private trigger method, allows to choose the component which triggered
|
||||||
|
* the event in the first place
|
||||||
|
*/
|
||||||
|
__trigger<T>(component: Component, eventType: string, payload?: T) {
|
||||||
|
if (this.el) {
|
||||||
|
const ev = new OwlEvent<T>(component, eventType, {
|
||||||
|
bubbles: true,
|
||||||
|
cancelable: true,
|
||||||
|
detail: payload,
|
||||||
|
});
|
||||||
|
const triggerHook = this.env[portalSymbol as any];
|
||||||
|
if (triggerHook) {
|
||||||
|
triggerHook(ev);
|
||||||
|
}
|
||||||
|
this.el.dispatchEvent(ev);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* The __updateProps method is called by the t-component directive whenever
|
||||||
|
* it updates a component (so, when the parent template is rerendered).
|
||||||
|
*/
|
||||||
|
async __updateProps(nextProps: Props, parentFiber: Fiber, scope: any): Promise<void> {
|
||||||
|
this.__owl__.scope = scope;
|
||||||
|
const shouldUpdate = parentFiber.force || this.shouldUpdate(nextProps);
|
||||||
|
if (shouldUpdate) {
|
||||||
|
const __owl__ = this.__owl__;
|
||||||
|
const fiber = new Fiber(parentFiber, this, parentFiber.force, null, null);
|
||||||
|
if (!parentFiber.child) {
|
||||||
|
parentFiber.child = fiber;
|
||||||
|
} else {
|
||||||
|
parentFiber.lastChild!.sibling = fiber;
|
||||||
|
}
|
||||||
|
parentFiber.lastChild = fiber;
|
||||||
|
|
||||||
|
const defaultProps = (<any>this.constructor).defaultProps;
|
||||||
|
if (defaultProps) {
|
||||||
|
this.__applyDefaultProps(nextProps, defaultProps);
|
||||||
|
}
|
||||||
|
if (QWeb.dev) {
|
||||||
|
QWeb.utils.validateProps(this.constructor, nextProps);
|
||||||
|
}
|
||||||
|
await Promise.all([
|
||||||
|
this.willUpdateProps(nextProps),
|
||||||
|
__owl__.willUpdatePropsCB && __owl__.willUpdatePropsCB(nextProps),
|
||||||
|
]);
|
||||||
|
if (fiber.isCompleted) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
this.props = nextProps;
|
||||||
|
|
||||||
|
this.__render(fiber);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Main patching method. We call the virtual dom patch method here to convert
|
||||||
|
* a virtual dom vnode into some actual dom.
|
||||||
|
*/
|
||||||
|
__patch(target: HTMLElement | VNode | DocumentFragment, vnode: VNode) {
|
||||||
|
this.__owl__.vnode = patch(target as any, vnode);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The __prepare method is only called by the t-component directive, when a
|
||||||
|
* subcomponent is created. It gets its scope, if any, from the
|
||||||
|
* parent template.
|
||||||
|
*/
|
||||||
|
__prepare(parentFiber: Fiber, scope: any, cb: CallableFunction): Fiber {
|
||||||
|
this.__owl__.scope = scope;
|
||||||
|
const fiber = new Fiber(parentFiber, this, parentFiber.force, null, null);
|
||||||
|
fiber.shouldPatch = false;
|
||||||
|
if (!parentFiber.child) {
|
||||||
|
parentFiber.child = fiber;
|
||||||
|
} else {
|
||||||
|
parentFiber.lastChild!.sibling = fiber;
|
||||||
|
}
|
||||||
|
parentFiber.lastChild = fiber;
|
||||||
|
this.__prepareAndRender(fiber, cb);
|
||||||
|
return fiber;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Apply the stylesheets defined by the component. Note that we need to make
|
||||||
|
* sure all inherited stylesheets are applied as well. We then delete the
|
||||||
|
* `style` key from the constructor to make sure we do not apply it again.
|
||||||
|
*/
|
||||||
|
private __applyStyles(constr) {
|
||||||
|
while (constr && constr.style) {
|
||||||
|
if (constr.hasOwnProperty("style")) {
|
||||||
|
activateSheet(constr.style, constr.name);
|
||||||
|
delete constr.style;
|
||||||
|
}
|
||||||
|
constr = constr.__proto__;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
__getTemplate(qweb: QWeb): string {
|
||||||
|
let p = (<any>this).constructor;
|
||||||
|
if (!p.hasOwnProperty("_template")) {
|
||||||
|
// here, the component and none of its superclasses defines a static `template`
|
||||||
|
// key. So we fall back on looking for a template matching its name (or
|
||||||
|
// one of its subclass).
|
||||||
|
|
||||||
|
let template: string = p.name;
|
||||||
|
while (!(template in qweb.templates) && p !== Component) {
|
||||||
|
p = p.__proto__;
|
||||||
|
template = p.name;
|
||||||
|
}
|
||||||
|
if (p === Component) {
|
||||||
|
throw new Error(`Could not find template for component "${this.constructor.name}"`);
|
||||||
|
} else {
|
||||||
|
p._template = template;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return p._template;
|
||||||
|
}
|
||||||
|
|
||||||
|
async __prepareAndRender(fiber: Fiber, cb: CallableFunction) {
|
||||||
|
try {
|
||||||
|
const proms = Promise.all([
|
||||||
|
this.willStart(),
|
||||||
|
this.__owl__.willStartCB && this.__owl__.willStartCB(),
|
||||||
|
]);
|
||||||
|
this.__owl__.status = STATUS.WILLSTARTED;
|
||||||
|
await proms;
|
||||||
|
if (this.__owl__.status === <any>STATUS.DESTROYED) {
|
||||||
|
return Promise.resolve();
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
fiber.handleError(e);
|
||||||
|
return Promise.resolve();
|
||||||
|
}
|
||||||
|
if (!fiber.isCompleted) {
|
||||||
|
this.__render(fiber);
|
||||||
|
this.__owl__.status = STATUS.RENDERED;
|
||||||
|
cb();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
__render(fiber: Fiber) {
|
||||||
|
const __owl__ = this.__owl__;
|
||||||
|
if (__owl__.observer) {
|
||||||
|
__owl__.observer.allowMutations = false;
|
||||||
|
}
|
||||||
|
let error;
|
||||||
|
try {
|
||||||
|
let vnode = __owl__.renderFn!(this, {
|
||||||
|
handlers: __owl__.boundHandlers,
|
||||||
|
fiber: fiber,
|
||||||
|
});
|
||||||
|
// we iterate over the children to detect those that no longer belong to the
|
||||||
|
// current rendering: those ones, if not mounted yet, can (and have to) be
|
||||||
|
// destroyed right now, because they are not in the DOM, and thus we won't
|
||||||
|
// be notified later on (when patching), that they are removed from the DOM
|
||||||
|
for (let childKey in __owl__.children) {
|
||||||
|
const child = __owl__.children[childKey];
|
||||||
|
const childOwl = child.__owl__;
|
||||||
|
if (childOwl.status !== STATUS.MOUNTED && childOwl.parentLastFiberId < fiber.id) {
|
||||||
|
// we only do here a "soft" destroy, meaning that we leave the child
|
||||||
|
// dom node alone, without removing it. Most of the time, it does not
|
||||||
|
// matter, because the child component is already unmounted. However,
|
||||||
|
// if some of its parent have been unmounted, the child could actually
|
||||||
|
// still be attached to its parent, and this may be important if we
|
||||||
|
// want to remount the parent, because the vdom need to match the
|
||||||
|
// actual DOM
|
||||||
|
child.__destroy(childOwl.parent);
|
||||||
|
if (childOwl.pvnode) {
|
||||||
|
// we remove the key here to make sure that the patching algorithm
|
||||||
|
// is able to make the difference between this pvnode and an eventual
|
||||||
|
// other instance of the same component
|
||||||
|
delete childOwl.pvnode.key;
|
||||||
|
// Since the component has been unmounted, we do not want to actually
|
||||||
|
// call a remove hook. This is pretty important, since the t-component
|
||||||
|
// directive actually disabled it, so the vdom algorithm will just
|
||||||
|
// not remove the child elm if we don't remove the hook.
|
||||||
|
delete childOwl.pvnode.data!.hook!.remove;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (!vnode) {
|
||||||
|
throw new Error(`Rendering '${this.constructor.name}' did not return anything`);
|
||||||
|
}
|
||||||
|
fiber.vnode = vnode;
|
||||||
|
// we apply here the class information described on the component by the
|
||||||
|
// template (so, something like <MyComponent class="..."/>) to the actual
|
||||||
|
// root vnode
|
||||||
|
if (__owl__.classObj) {
|
||||||
|
const data = vnode.data!;
|
||||||
|
data.class = Object.assign(data.class || {}, __owl__.classObj);
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
error = e;
|
||||||
|
}
|
||||||
|
if (__owl__.observer) {
|
||||||
|
__owl__.observer.allowMutations = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
fiber.root.counter--;
|
||||||
|
fiber.isRendered = true;
|
||||||
|
if (error) {
|
||||||
|
fiber.handleError(error);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Apply default props (only top level).
|
||||||
|
*
|
||||||
|
* Note that this method does modify in place the props
|
||||||
|
*/
|
||||||
|
__applyDefaultProps(props: Object, defaultProps: Object) {
|
||||||
|
for (let propName in defaultProps) {
|
||||||
|
if (props![propName] === undefined) {
|
||||||
|
props![propName] = defaultProps[propName];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
interface MountParameters {
|
||||||
|
env?: Env;
|
||||||
|
target: HTMLElement | DocumentFragment;
|
||||||
|
props?: any;
|
||||||
|
position?: MountOptions["position"];
|
||||||
|
}
|
||||||
|
|
||||||
|
interface Type<T> extends Function {
|
||||||
|
new (...args: any[]): T;
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function mount<T extends Type<Component>>(
|
||||||
|
C: T,
|
||||||
|
params: MountParameters
|
||||||
|
): Promise<InstanceType<T>> {
|
||||||
|
const { env, props, target } = params;
|
||||||
|
let origEnv = C.hasOwnProperty("env") ? (C as any).env : null;
|
||||||
|
if (env) {
|
||||||
|
((C as any) as typeof Component).env = env;
|
||||||
|
}
|
||||||
|
const component: Component = new C(null, props);
|
||||||
|
if (origEnv) {
|
||||||
|
(C as any).env = origEnv;
|
||||||
|
} else {
|
||||||
|
delete (C as any).env;
|
||||||
|
}
|
||||||
|
const position = params.position || "last-child";
|
||||||
|
await component.mount(target, { position });
|
||||||
|
return component as any;
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,310 +0,0 @@
|
|||||||
import type { App, Env } from "../app/app";
|
|
||||||
import { BDom, VNode } from "../blockdom";
|
|
||||||
import { Component } from "./component";
|
|
||||||
import {
|
|
||||||
Fiber,
|
|
||||||
makeChildFiber,
|
|
||||||
makeRootFiber,
|
|
||||||
MountFiber,
|
|
||||||
MountOptions,
|
|
||||||
RootFiber,
|
|
||||||
} from "./fibers";
|
|
||||||
import { handleError, fibersInError } from "./error_handling";
|
|
||||||
import { applyDefaultProps } from "./props_validation";
|
|
||||||
import { STATUS } from "./status";
|
|
||||||
|
|
||||||
let currentNode: ComponentNode | null = null;
|
|
||||||
|
|
||||||
export function getCurrent(): ComponentNode | null {
|
|
||||||
return currentNode;
|
|
||||||
}
|
|
||||||
|
|
||||||
export function useComponent(): Component {
|
|
||||||
return currentNode!.component;
|
|
||||||
}
|
|
||||||
|
|
||||||
export function component(
|
|
||||||
name: string | typeof Component,
|
|
||||||
props: any,
|
|
||||||
key: string,
|
|
||||||
tKey: null | string,
|
|
||||||
ctx: ComponentNode,
|
|
||||||
parent: any
|
|
||||||
): ComponentNode {
|
|
||||||
const parentChildren = ctx.children;
|
|
||||||
const destroy = ComponentNode.prototype.destroy;
|
|
||||||
|
|
||||||
if (tKey) {
|
|
||||||
const parentMap = ctx.keyToTkey;
|
|
||||||
const oldTkey = parentMap[key];
|
|
||||||
if (oldTkey && oldTkey !== tKey) {
|
|
||||||
const oldKey = key + oldTkey;
|
|
||||||
const node = parentChildren[oldKey];
|
|
||||||
if (node && node.status < STATUS.MOUNTED) {
|
|
||||||
destroy.call(node);
|
|
||||||
delete parentChildren[oldKey];
|
|
||||||
}
|
|
||||||
}
|
|
||||||
parentMap[key] = tKey;
|
|
||||||
key = key + tKey;
|
|
||||||
}
|
|
||||||
|
|
||||||
let node: any = parentChildren[key];
|
|
||||||
let isDynamic = typeof name !== "string";
|
|
||||||
|
|
||||||
if (node) {
|
|
||||||
if (node.status < STATUS.MOUNTED) {
|
|
||||||
destroy.call(node);
|
|
||||||
node = undefined;
|
|
||||||
} else if (node.status === STATUS.DESTROYED) {
|
|
||||||
node = undefined;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (isDynamic && node && node.component.constructor !== name) {
|
|
||||||
node = undefined;
|
|
||||||
}
|
|
||||||
|
|
||||||
const parentFiber = ctx.fiber!;
|
|
||||||
if (node) {
|
|
||||||
node.updateAndRender(props, parentFiber);
|
|
||||||
} else {
|
|
||||||
// new component
|
|
||||||
let C;
|
|
||||||
if (isDynamic) {
|
|
||||||
C = name;
|
|
||||||
} else {
|
|
||||||
C = parent.constructor.components[name as any];
|
|
||||||
if (!C) {
|
|
||||||
throw new Error(`Cannot find the definition of component "${name}"`);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
node = new ComponentNode(C, props, ctx.app, ctx);
|
|
||||||
parentChildren[key] = node;
|
|
||||||
|
|
||||||
const fiber = makeChildFiber(node, parentFiber);
|
|
||||||
node.initiateRender(fiber);
|
|
||||||
}
|
|
||||||
return node;
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Component VNode
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
type LifecycleHook = Function;
|
|
||||||
|
|
||||||
export class ComponentNode<T extends typeof Component = typeof Component>
|
|
||||||
implements VNode<ComponentNode>
|
|
||||||
{
|
|
||||||
el?: HTMLElement | Text | undefined;
|
|
||||||
app: App;
|
|
||||||
fiber: Fiber | null = null;
|
|
||||||
component: InstanceType<T>;
|
|
||||||
bdom: BDom | null = null;
|
|
||||||
status: STATUS = STATUS.NEW;
|
|
||||||
|
|
||||||
renderFn: Function;
|
|
||||||
parent: ComponentNode | null;
|
|
||||||
level: number;
|
|
||||||
childEnv: Env;
|
|
||||||
children: { [key: string]: ComponentNode } = Object.create(null);
|
|
||||||
refs: any = {};
|
|
||||||
keyToTkey: any = {};
|
|
||||||
|
|
||||||
willStart: LifecycleHook[] = [];
|
|
||||||
willUpdateProps: LifecycleHook[] = [];
|
|
||||||
willUnmount: LifecycleHook[] = [];
|
|
||||||
mounted: LifecycleHook[] = [];
|
|
||||||
willPatch: LifecycleHook[] = [];
|
|
||||||
patched: LifecycleHook[] = [];
|
|
||||||
willDestroy: LifecycleHook[] = [];
|
|
||||||
|
|
||||||
constructor(C: T, props: any, app: App, parent?: ComponentNode) {
|
|
||||||
currentNode = this;
|
|
||||||
this.app = app;
|
|
||||||
this.parent = parent || null;
|
|
||||||
this.level = parent ? parent.level + 1 : 0;
|
|
||||||
applyDefaultProps(props, C);
|
|
||||||
const env = (parent && parent.childEnv) || app.env;
|
|
||||||
this.childEnv = env;
|
|
||||||
this.component = new C(props, env, this) as any;
|
|
||||||
this.renderFn = app.getTemplate(C.template).bind(this.component, this.component, this);
|
|
||||||
this.component.setup();
|
|
||||||
}
|
|
||||||
|
|
||||||
mountComponent(target: any, options?: MountOptions) {
|
|
||||||
const fiber = new MountFiber(this, target, options);
|
|
||||||
this.app.scheduler.addFiber(fiber);
|
|
||||||
this.initiateRender(fiber);
|
|
||||||
}
|
|
||||||
|
|
||||||
async initiateRender(fiber: Fiber | MountFiber) {
|
|
||||||
this.fiber = fiber;
|
|
||||||
if (this.mounted.length) {
|
|
||||||
fiber.root.mounted.push(fiber);
|
|
||||||
}
|
|
||||||
const component = this.component;
|
|
||||||
try {
|
|
||||||
await Promise.all(this.willStart.map((f) => f.call(component)));
|
|
||||||
} catch (e) {
|
|
||||||
handleError({ node: this, error: e });
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
if (this.status === STATUS.NEW && this.fiber === fiber) {
|
|
||||||
this._render(fiber);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
async render() {
|
|
||||||
let current = this.fiber;
|
|
||||||
if (current && current.root.locked) {
|
|
||||||
await Promise.resolve();
|
|
||||||
// situation may have changed after the microtask tick
|
|
||||||
current = this.fiber;
|
|
||||||
}
|
|
||||||
if (current && !current.bdom && !fibersInError.has(current)) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
if (!this.bdom && !current) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
const fiber = makeRootFiber(this);
|
|
||||||
this.fiber = fiber;
|
|
||||||
this.app.scheduler.addFiber(fiber);
|
|
||||||
await Promise.resolve();
|
|
||||||
if (this.status === STATUS.DESTROYED) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
// We only want to actually render the component if the following two
|
|
||||||
// conditions are true:
|
|
||||||
// * this.fiber: it could be null, in which case the render has been cancelled
|
|
||||||
// * (current || !fiber.parent): if current is not null, this means that the
|
|
||||||
// render function was called when a render was already occurring. In this
|
|
||||||
// case, the pending rendering was cancelled, and the fiber needs to be
|
|
||||||
// rendered to complete the work. If current is null, we check that the
|
|
||||||
// fiber has no parent. If that is the case, the fiber was downgraded from
|
|
||||||
// a root fiber to a child fiber in the previous microtick, because it was
|
|
||||||
// embedded in a rendering coming from above, so the fiber will be rendered
|
|
||||||
// in the next microtick anyway, so we should not render it again.
|
|
||||||
if (this.fiber && (current || !fiber.parent)) {
|
|
||||||
this._render(fiber);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
_render(fiber: Fiber | RootFiber) {
|
|
||||||
try {
|
|
||||||
fiber.bdom = this.renderFn();
|
|
||||||
fiber.root.counter--;
|
|
||||||
} catch (e) {
|
|
||||||
handleError({ node: this, error: e });
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
destroy() {
|
|
||||||
let shouldRemove = this.status === STATUS.MOUNTED;
|
|
||||||
this._destroy();
|
|
||||||
if (shouldRemove) {
|
|
||||||
this.bdom!.remove();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
_destroy() {
|
|
||||||
const component = this.component;
|
|
||||||
if (this.status === STATUS.MOUNTED) {
|
|
||||||
for (let cb of this.willUnmount) {
|
|
||||||
cb.call(component);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for (let child of Object.values(this.children)) {
|
|
||||||
child._destroy();
|
|
||||||
}
|
|
||||||
for (let cb of this.willDestroy) {
|
|
||||||
cb.call(component);
|
|
||||||
}
|
|
||||||
this.status = STATUS.DESTROYED;
|
|
||||||
}
|
|
||||||
|
|
||||||
async updateAndRender(props: any, parentFiber: Fiber) {
|
|
||||||
// update
|
|
||||||
const fiber = makeChildFiber(this, parentFiber);
|
|
||||||
this.fiber = fiber;
|
|
||||||
const component = this.component;
|
|
||||||
applyDefaultProps(props, component.constructor as any);
|
|
||||||
const prom = Promise.all(this.willUpdateProps.map((f) => f.call(component, props)));
|
|
||||||
await prom;
|
|
||||||
if (fiber !== this.fiber) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
component.props = props;
|
|
||||||
this._render(fiber);
|
|
||||||
const parentRoot = parentFiber.root;
|
|
||||||
if (this.willPatch.length) {
|
|
||||||
parentRoot.willPatch.push(fiber);
|
|
||||||
}
|
|
||||||
if (this.patched.length) {
|
|
||||||
parentRoot.patched.push(fiber);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Finds a child that has dom that is not yet updated, and update it. This
|
|
||||||
* method is meant to be used only in the context of repatching the dom after
|
|
||||||
* a mounted hook failed and was handled.
|
|
||||||
*/
|
|
||||||
updateDom() {
|
|
||||||
if (!this.fiber) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
if (this.bdom === this.fiber!.bdom) {
|
|
||||||
// If the error was handled by some child component, we need to find it to
|
|
||||||
// apply its change
|
|
||||||
for (let k in this.children) {
|
|
||||||
const child = this.children[k];
|
|
||||||
child.updateDom();
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
// if we get here, this is the component that handled the error and rerendered
|
|
||||||
// itself, so we can simply patch the dom
|
|
||||||
this.bdom!.patch(this.fiber!.bdom, false);
|
|
||||||
this.fiber!.appliedToDom = true;
|
|
||||||
this.fiber = null;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
// Block DOM methods
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
|
|
||||||
firstNode(): Node | undefined {
|
|
||||||
const bdom = this.bdom;
|
|
||||||
return bdom ? bdom.firstNode() : undefined;
|
|
||||||
}
|
|
||||||
|
|
||||||
mount(parent: HTMLElement, anchor: ChildNode) {
|
|
||||||
const bdom = this.fiber!.bdom!;
|
|
||||||
this.bdom = bdom;
|
|
||||||
bdom.mount(parent, anchor);
|
|
||||||
this.status = STATUS.MOUNTED;
|
|
||||||
this.fiber!.appliedToDom = true;
|
|
||||||
this.fiber = null;
|
|
||||||
}
|
|
||||||
|
|
||||||
moveBefore(other: ComponentNode | null, afterNode: Node | null) {
|
|
||||||
this.bdom!.moveBefore(other ? other.bdom : null, afterNode);
|
|
||||||
}
|
|
||||||
|
|
||||||
patch() {
|
|
||||||
this.bdom!.patch(this!.fiber!.bdom!, false);
|
|
||||||
this.fiber!.appliedToDom = true;
|
|
||||||
this.fiber = null;
|
|
||||||
}
|
|
||||||
|
|
||||||
beforeRemove() {
|
|
||||||
this._destroy();
|
|
||||||
}
|
|
||||||
|
|
||||||
remove() {
|
|
||||||
this.bdom!.remove();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,512 @@
|
|||||||
|
import { QWeb } from "../qweb/index";
|
||||||
|
import { INTERP_REGEXP } from "../qweb/compilation_context";
|
||||||
|
import { makeHandlerCode, MODS_CODE } from "../qweb/extensions";
|
||||||
|
import { STATUS } from "./component";
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-component
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
const T_COMPONENT_MODS_CODE = Object.assign({}, MODS_CODE, {
|
||||||
|
self: "if (e.target !== vn.elm) {return}",
|
||||||
|
});
|
||||||
|
|
||||||
|
QWeb.utils.defineProxy = function defineProxy(target, source) {
|
||||||
|
for (let k in source) {
|
||||||
|
Object.defineProperty(target, k, {
|
||||||
|
get() {
|
||||||
|
return source[k];
|
||||||
|
},
|
||||||
|
set(val) {
|
||||||
|
source[k] = val;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
QWeb.utils.assignHooks = function assignHooks(dataObj, hooks) {
|
||||||
|
if ("hook" in dataObj) {
|
||||||
|
const hookObject = dataObj.hook;
|
||||||
|
for (let name in hooks) {
|
||||||
|
const current = hookObject[name];
|
||||||
|
const fn = hooks[name];
|
||||||
|
if (current) {
|
||||||
|
hookObject[name] = (...args) => {
|
||||||
|
current(...args);
|
||||||
|
fn(...args);
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
hookObject[name] = fn;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
dataObj.hook = hooks;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The t-component directive is certainly a complicated and hard to maintain piece
|
||||||
|
* of code. To help you, fellow developer, if you have to maintain it, I offer
|
||||||
|
* you this advice: Good luck...
|
||||||
|
*
|
||||||
|
* Since it is not 'direct' code, but rather code that generates other code, it
|
||||||
|
* is not easy to understand. To help you, here is a detailed and commented
|
||||||
|
* explanation of the code generated by the t-component directive for the following
|
||||||
|
* situation:
|
||||||
|
* ```xml
|
||||||
|
* <Child
|
||||||
|
* t-key="'somestring'"
|
||||||
|
* flag="state.flag"
|
||||||
|
* t-transition="fade"/>
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* ```js
|
||||||
|
* // we assign utils on top of the function because it will be useful for
|
||||||
|
* // each components
|
||||||
|
* let utils = this.utils;
|
||||||
|
*
|
||||||
|
* // this is the virtual node representing the parent div
|
||||||
|
* let c1 = [], p1 = { key: 1 };
|
||||||
|
* var vn1 = h("div", p1, c1);
|
||||||
|
*
|
||||||
|
* // t-component directive: we start by evaluating the expression given by t-key:
|
||||||
|
* let key5 = "somestring";
|
||||||
|
*
|
||||||
|
* // def3 is the promise that will contain later either the new component
|
||||||
|
* // creation, or the props update...
|
||||||
|
* let def3;
|
||||||
|
*
|
||||||
|
* // this is kind of tricky: we need here to find if the component was already
|
||||||
|
* // created by a previous rendering. This is done by checking the internal
|
||||||
|
* // `cmap` (children map) of the parent component: it maps keys to component ids,
|
||||||
|
* // and, then, if there is an id, we look into the children list to get the
|
||||||
|
* // instance
|
||||||
|
* let w4 =
|
||||||
|
* key5 in context.__owl__.cmap
|
||||||
|
* ? context.__owl__.children[context.__owl__.cmap[key5]]
|
||||||
|
* : false;
|
||||||
|
*
|
||||||
|
* // We keep the index of the position of the component in the closure. We push
|
||||||
|
* // null to reserve the slot, and will replace it later by the component vnode,
|
||||||
|
* // when it will be ready (do not forget that preparing/rendering a component is
|
||||||
|
* // asynchronous)
|
||||||
|
* let _2_index = c1.length;
|
||||||
|
* c1.push(null);
|
||||||
|
*
|
||||||
|
* // we evaluate here the props given to the component. It is done here to be
|
||||||
|
* // able to easily reference it later, and also, it might be an expensive
|
||||||
|
* // computation, so it is certainly better to do it only once
|
||||||
|
* let props4 = { flag: context["state"].flag };
|
||||||
|
*
|
||||||
|
* // If we have a component, currently rendering, but not ready yet, we do not want
|
||||||
|
* // to wait for it to be ready if we can avoid it
|
||||||
|
* if (w4 && w4.__owl__.renderPromise && !w4.__owl__.vnode) {
|
||||||
|
* // we check if the props are the same. In that case, we can simply reuse
|
||||||
|
* // the previous rendering and skip all useless work
|
||||||
|
* if (utils.shallowEqual(props4, w4.__owl__.renderProps)) {
|
||||||
|
* def3 = w4.__owl__.renderPromise;
|
||||||
|
* } else {
|
||||||
|
* // if the props are not the same, we destroy the component and starts anew.
|
||||||
|
* // this will be faster than waiting for its rendering, then updating it
|
||||||
|
* w4.destroy();
|
||||||
|
* w4 = false;
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* if (!w4) {
|
||||||
|
* // in this situation, we need to create a new component. First step is
|
||||||
|
* // to get a reference to the class, then create an instance with
|
||||||
|
* // current context as parent, and the props.
|
||||||
|
* let W4 = context.component && context.components[componentKey4] || QWeb.component[componentKey4];
|
||||||
|
|
||||||
|
* if (!W4) {
|
||||||
|
* throw new Error("Cannot find the definition of component 'child'");
|
||||||
|
* }
|
||||||
|
* w4 = new W4(owner, props4);
|
||||||
|
*
|
||||||
|
* // Whenever we rerender the parent component, we need to be sure that we
|
||||||
|
* // are able to find the component instance. To do that, we register it to
|
||||||
|
* // the parent cmap (children map). Note that the 'template' key is
|
||||||
|
* // used here, since this is what identify the component from the template
|
||||||
|
* // perspective.
|
||||||
|
* context.__owl__.cmap[key5] = w4.__owl__.id;
|
||||||
|
*
|
||||||
|
* // __prepare is called, to basically call willStart, then render the
|
||||||
|
* // component
|
||||||
|
* def3 = w4.__prepare();
|
||||||
|
*
|
||||||
|
* def3 = def3.then(vnode => {
|
||||||
|
* // we create here a virtual node for the parent (NOT the component). This
|
||||||
|
* // means that the vdom of the parent will be stopped here, and from
|
||||||
|
* // the parent's perspective, it simply is a vnode with no children.
|
||||||
|
* // However, it shares the same dom element with the component root
|
||||||
|
* // vnode.
|
||||||
|
* let pvnode = h(vnode.sel, { key: key5 });
|
||||||
|
*
|
||||||
|
* // we add hooks to the parent vnode so we can interact with the new
|
||||||
|
* // component at the proper time
|
||||||
|
* pvnode.data.hook = {
|
||||||
|
* insert(vn) {
|
||||||
|
* // the __mount method will patch the component vdom into the elm vn.elm,
|
||||||
|
* // then call the mounted hooks. However, suprisingly, the snabbdom
|
||||||
|
* // patch method actually replace the elm by a new elm, so we need
|
||||||
|
* // to synchronise the pvnode elm with the resulting elm
|
||||||
|
* let nvn = w4.__mount(vnode, vn.elm);
|
||||||
|
* pvnode.elm = nvn.elm;
|
||||||
|
* // what follows is only present if there are animations on the component
|
||||||
|
* utils.transitionInsert(vn, "fade");
|
||||||
|
* },
|
||||||
|
* remove() {
|
||||||
|
* // override with empty function to prevent from removing the node
|
||||||
|
* // directly. It will be removed when destroy is called anyway, which
|
||||||
|
* // delays the removal if there are animations.
|
||||||
|
* },
|
||||||
|
* destroy() {
|
||||||
|
* // if there are animations, we delay the call to destroy on the
|
||||||
|
* // component, if not, we call it directly.
|
||||||
|
* let finalize = () => {
|
||||||
|
* w4.destroy();
|
||||||
|
* };
|
||||||
|
* utils.transitionRemove(vn, "fade", finalize);
|
||||||
|
* }
|
||||||
|
* };
|
||||||
|
* // the pvnode is inserted at the correct position in the div's children
|
||||||
|
* c1[_2_index] = pvnode;
|
||||||
|
*
|
||||||
|
* // we keep here a reference to the parent vnode (representing the
|
||||||
|
* // component, so we can reuse it later whenever we update the component
|
||||||
|
* w4.__owl__.pvnode = pvnode;
|
||||||
|
* });
|
||||||
|
* } else {
|
||||||
|
* // this is the 'update' path of the directive.
|
||||||
|
* // the call to __updateProps is the actual component update
|
||||||
|
* // Note that we only update the props if we cannot reuse the previous
|
||||||
|
* // rendering work (in the case it was rendered with the same props)
|
||||||
|
* def3 = def3 || w4.__updateProps(props4, extra.forceUpdate, extra.patchQueue);
|
||||||
|
* def3 = def3.then(() => {
|
||||||
|
* // if component was destroyed in the meantime, we do nothing (so, this
|
||||||
|
* // means that the parent's element children list will have a null in
|
||||||
|
* // the component's position, which will cause the pvnode to be removed
|
||||||
|
* // when it is patched.
|
||||||
|
* if (w4.__owl__.isDestroyed) {
|
||||||
|
* return;
|
||||||
|
* }
|
||||||
|
* // like above, we register the pvnode to the children list, so it
|
||||||
|
* // will not be patched out of the dom.
|
||||||
|
* let pvnode = w4.__owl__.pvnode;
|
||||||
|
* c1[_2_index] = pvnode;
|
||||||
|
* });
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* // we register the deferred here so the parent can coordinate its patch operation
|
||||||
|
* // with all the children.
|
||||||
|
* extra.promises.push(def3);
|
||||||
|
* return vn1;
|
||||||
|
* ```
|
||||||
|
*/
|
||||||
|
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "component",
|
||||||
|
extraNames: ["props"],
|
||||||
|
priority: 100,
|
||||||
|
atNodeEncounter({ ctx, value, node, qweb }): boolean {
|
||||||
|
ctx.addLine(`// Component '${value}'`);
|
||||||
|
ctx.rootContext.shouldDefineQWeb = true;
|
||||||
|
ctx.rootContext.shouldDefineParent = true;
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
ctx.rootContext.shouldDefineScope = true;
|
||||||
|
let hasDynamicProps = node.getAttribute("t-props") ? true : false;
|
||||||
|
|
||||||
|
// t-on- events and t-transition
|
||||||
|
const events: [string, string][] = [];
|
||||||
|
let transition: string = "";
|
||||||
|
const attributes = (<Element>node).attributes;
|
||||||
|
const props: { [key: string]: string } = {};
|
||||||
|
for (let i = 0; i < attributes.length; i++) {
|
||||||
|
const name = attributes[i].name;
|
||||||
|
const value = attributes[i].textContent!;
|
||||||
|
if (name.startsWith("t-on-")) {
|
||||||
|
events.push([name, value]);
|
||||||
|
} else if (name === "t-transition") {
|
||||||
|
if (QWeb.enableTransitions) {
|
||||||
|
transition = value;
|
||||||
|
}
|
||||||
|
} else if (!name.startsWith("t-")) {
|
||||||
|
if (name !== "class" && name !== "style") {
|
||||||
|
// this is a prop!
|
||||||
|
props[name] = ctx.formatExpression(value) || "undefined";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// computing the props string representing the props object
|
||||||
|
let propStr = Object.keys(props)
|
||||||
|
.map((k) => k + ":" + props[k])
|
||||||
|
.join(",");
|
||||||
|
let componentID = ctx.generateID();
|
||||||
|
|
||||||
|
let hasDefinedKey = false;
|
||||||
|
let templateKey;
|
||||||
|
if (node.tagName === "t" && !node.hasAttribute("t-key") && value.match(INTERP_REGEXP)) {
|
||||||
|
defineComponentKey();
|
||||||
|
const id = ctx.generateID();
|
||||||
|
// the ___ is to make sure we have no possible conflict with normal
|
||||||
|
// template keys
|
||||||
|
ctx.addLine(`let k${id} = '___' + componentKey${componentID}`);
|
||||||
|
templateKey = `k${id}`;
|
||||||
|
} else {
|
||||||
|
templateKey = ctx.generateTemplateKey();
|
||||||
|
}
|
||||||
|
let ref = node.getAttribute("t-ref");
|
||||||
|
let refExpr = "";
|
||||||
|
let refKey: string = "";
|
||||||
|
if (ref) {
|
||||||
|
ctx.rootContext.shouldDefineRefs = true;
|
||||||
|
refKey = `ref${ctx.generateID()}`;
|
||||||
|
ctx.addLine(`const ${refKey} = ${ctx.interpolate(ref)};`);
|
||||||
|
refExpr = `context.__owl__.refs[${refKey}] = w${componentID};`;
|
||||||
|
}
|
||||||
|
let finalizeComponentCode = `w${componentID}.destroy();`;
|
||||||
|
if (ref) {
|
||||||
|
finalizeComponentCode += `delete context.__owl__.refs[${refKey}];`;
|
||||||
|
}
|
||||||
|
if (transition) {
|
||||||
|
finalizeComponentCode = `let finalize = () => {
|
||||||
|
${finalizeComponentCode}
|
||||||
|
};
|
||||||
|
delete w${componentID}.__owl__.transitionInserted;
|
||||||
|
utils.transitionRemove(vn, '${transition}', finalize);`;
|
||||||
|
}
|
||||||
|
|
||||||
|
let createHook = "";
|
||||||
|
let classAttr = node.getAttribute("class");
|
||||||
|
let tattClass = node.getAttribute("t-att-class");
|
||||||
|
let styleAttr = node.getAttribute("style");
|
||||||
|
let tattStyle = node.getAttribute("t-att-style");
|
||||||
|
if (tattStyle) {
|
||||||
|
const attVar = `_${ctx.generateID()}`;
|
||||||
|
ctx.addLine(`const ${attVar} = ${ctx.formatExpression(tattStyle)};`);
|
||||||
|
tattStyle = attVar;
|
||||||
|
}
|
||||||
|
let classObj = "";
|
||||||
|
if (classAttr || tattClass || styleAttr || tattStyle || events.length) {
|
||||||
|
if (classAttr) {
|
||||||
|
let classDef = classAttr
|
||||||
|
.trim()
|
||||||
|
.split(/\s+/)
|
||||||
|
.map((a) => `'${a}':true`)
|
||||||
|
.join(",");
|
||||||
|
classObj = `_${ctx.generateID()}`;
|
||||||
|
ctx.addLine(`let ${classObj} = {${classDef}};`);
|
||||||
|
}
|
||||||
|
if (tattClass) {
|
||||||
|
let tattExpr = ctx.formatExpression(tattClass);
|
||||||
|
if (tattExpr[0] !== "{" || tattExpr[tattExpr.length - 1] !== "}") {
|
||||||
|
tattExpr = `utils.toClassObj(${tattExpr})`;
|
||||||
|
}
|
||||||
|
if (classAttr) {
|
||||||
|
ctx.addLine(`Object.assign(${classObj}, ${tattExpr})`);
|
||||||
|
} else {
|
||||||
|
classObj = `_${ctx.generateID()}`;
|
||||||
|
ctx.addLine(`let ${classObj} = ${tattExpr};`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
let eventsCode = events
|
||||||
|
.map(function ([name, value]) {
|
||||||
|
const capture = name.match(/\.capture/);
|
||||||
|
name = capture ? name.replace(/\.capture/, "") : name;
|
||||||
|
const { event, handler } = makeHandlerCode(
|
||||||
|
ctx,
|
||||||
|
name,
|
||||||
|
value,
|
||||||
|
false,
|
||||||
|
T_COMPONENT_MODS_CODE
|
||||||
|
);
|
||||||
|
if (capture) {
|
||||||
|
return `vn.elm.addEventListener('${event}', ${handler}, true);`;
|
||||||
|
}
|
||||||
|
return `vn.elm.addEventListener('${event}', ${handler});`;
|
||||||
|
})
|
||||||
|
.join("");
|
||||||
|
const styleExpr = tattStyle || (styleAttr ? `'${styleAttr}'` : false);
|
||||||
|
const styleCode = styleExpr ? `vn.elm.style = ${styleExpr};` : "";
|
||||||
|
createHook = `utils.assignHooks(vnode.data, {create(_, vn){${styleCode}${eventsCode}}});`;
|
||||||
|
}
|
||||||
|
|
||||||
|
ctx.addLine(
|
||||||
|
`let w${componentID} = ${templateKey} in parent.__owl__.cmap ? parent.__owl__.children[parent.__owl__.cmap[${templateKey}]] : false;`
|
||||||
|
);
|
||||||
|
let shouldProxy = !ctx.parentNode;
|
||||||
|
if (shouldProxy) {
|
||||||
|
let id = ctx.generateID();
|
||||||
|
ctx.rootContext.rootNode = id;
|
||||||
|
shouldProxy = true;
|
||||||
|
ctx.rootContext.shouldDefineResult = true;
|
||||||
|
ctx.addLine(`let vn${id} = {};`);
|
||||||
|
ctx.addLine(`result = vn${id};`);
|
||||||
|
}
|
||||||
|
if (hasDynamicProps) {
|
||||||
|
const dynamicProp = ctx.formatExpression(node.getAttribute("t-props")!);
|
||||||
|
ctx.addLine(`let props${componentID} = Object.assign({}, ${dynamicProp}, {${propStr}});`);
|
||||||
|
} else {
|
||||||
|
ctx.addLine(`let props${componentID} = {${propStr}};`);
|
||||||
|
}
|
||||||
|
ctx.addIf(
|
||||||
|
`w${componentID} && w${componentID}.__owl__.currentFiber && !w${componentID}.__owl__.vnode`
|
||||||
|
);
|
||||||
|
ctx.addLine(`w${componentID}.destroy();`);
|
||||||
|
ctx.addLine(`w${componentID} = false;`);
|
||||||
|
ctx.closeIf();
|
||||||
|
|
||||||
|
let registerCode = "";
|
||||||
|
if (shouldProxy) {
|
||||||
|
registerCode = `utils.defineProxy(vn${ctx.rootNode}, pvnode);`;
|
||||||
|
}
|
||||||
|
|
||||||
|
// SLOTS
|
||||||
|
const hasSlots = node.childNodes.length;
|
||||||
|
|
||||||
|
let scope = hasSlots ? `utils.combine(context, scope)` : "undefined";
|
||||||
|
|
||||||
|
ctx.addIf(`w${componentID}`);
|
||||||
|
|
||||||
|
// need to update component
|
||||||
|
let styleCode = "";
|
||||||
|
if (tattStyle) {
|
||||||
|
styleCode = `.then(()=>{if (w${componentID}.__owl__.status === ${STATUS.DESTROYED}) {return};w${componentID}.el.style=${tattStyle};});`;
|
||||||
|
}
|
||||||
|
ctx.addLine(
|
||||||
|
`w${componentID}.__updateProps(props${componentID}, extra.fiber, ${scope})${styleCode};`
|
||||||
|
);
|
||||||
|
ctx.addLine(`let pvnode = w${componentID}.__owl__.pvnode;`);
|
||||||
|
if (registerCode) {
|
||||||
|
ctx.addLine(registerCode);
|
||||||
|
}
|
||||||
|
if (ctx.parentNode) {
|
||||||
|
ctx.addLine(`c${ctx.parentNode}.push(pvnode);`);
|
||||||
|
}
|
||||||
|
|
||||||
|
ctx.addElse();
|
||||||
|
|
||||||
|
// new component
|
||||||
|
function defineComponentKey() {
|
||||||
|
if (!hasDefinedKey) {
|
||||||
|
const interpValue = ctx.interpolate(value);
|
||||||
|
ctx.addLine(`let componentKey${componentID} = ${interpValue};`);
|
||||||
|
hasDefinedKey = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
defineComponentKey();
|
||||||
|
const contextualValue = value.match(INTERP_REGEXP) ? "false" : ctx.formatExpression(value);
|
||||||
|
ctx.addLine(
|
||||||
|
`let W${componentID} = ${contextualValue} || context.constructor.components[componentKey${componentID}] || QWeb.components[componentKey${componentID}];`
|
||||||
|
);
|
||||||
|
|
||||||
|
// maybe only do this in dev mode...
|
||||||
|
ctx.addLine(
|
||||||
|
`if (!W${componentID}) {throw new Error('Cannot find the definition of component "' + componentKey${componentID} + '"')}`
|
||||||
|
);
|
||||||
|
ctx.addLine(`w${componentID} = new W${componentID}(parent, props${componentID});`);
|
||||||
|
if (transition) {
|
||||||
|
ctx.addLine(`const __patch${componentID} = w${componentID}.__patch;`);
|
||||||
|
ctx.addLine(
|
||||||
|
`w${componentID}.__patch = (t, vn) => {__patch${componentID}.call(w${componentID}, t, vn); if(!w${componentID}.__owl__.transitionInserted){w${componentID}.__owl__.transitionInserted = true;utils.transitionInsert(w${componentID}.__owl__.vnode, '${transition}');}};`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
ctx.addLine(`parent.__owl__.cmap[${templateKey}] = w${componentID}.__owl__.id;`);
|
||||||
|
|
||||||
|
if (hasSlots) {
|
||||||
|
const clone = <Element>node.cloneNode(true);
|
||||||
|
|
||||||
|
// The next code is a fallback for compatibility reason. It accepts t-set
|
||||||
|
// elements that are direct children with a non empty body as nodes defining
|
||||||
|
// the content of a slot.
|
||||||
|
//
|
||||||
|
// This is wrong, but is necessary to prevent breaking all existing Owl
|
||||||
|
// code using slots. This will be removed in v2.0 someday. Meanwhile,
|
||||||
|
// please use t-set-slot everywhere you need to set the content of a
|
||||||
|
// slot.
|
||||||
|
for (let node of clone.children) {
|
||||||
|
if (node.hasAttribute("t-set") && node.hasChildNodes()) {
|
||||||
|
node.setAttribute("t-set-slot", node.getAttribute("t-set")!);
|
||||||
|
node.removeAttribute("t-set");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const slotNodes = Array.from(clone.querySelectorAll("[t-set-slot]"));
|
||||||
|
const slotNames = new Set<string>();
|
||||||
|
const slotId = QWeb.nextSlotId++;
|
||||||
|
ctx.addLine(`w${componentID}.__owl__.slotId = ${slotId};`);
|
||||||
|
if (slotNodes.length) {
|
||||||
|
for (let i = 0, length = slotNodes.length; i < length; i++) {
|
||||||
|
const slotNode = slotNodes[i];
|
||||||
|
// check if this is defined in a sub component (in which case it should
|
||||||
|
// be ignored)
|
||||||
|
let el = slotNode.parentElement;
|
||||||
|
let isInSubComponent = false;
|
||||||
|
while (el !== clone) {
|
||||||
|
if (
|
||||||
|
el!.hasAttribute("t-component") ||
|
||||||
|
el!.tagName[0] === el!.tagName[0].toUpperCase()
|
||||||
|
) {
|
||||||
|
isInSubComponent = true;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
el = el.parentElement;
|
||||||
|
}
|
||||||
|
if (isInSubComponent) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
let key = slotNode.getAttribute("t-set-slot")!;
|
||||||
|
if (slotNames.has(key)) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
slotNames.add(key);
|
||||||
|
slotNode.removeAttribute("t-set-slot");
|
||||||
|
slotNode.parentElement!.removeChild(slotNode);
|
||||||
|
|
||||||
|
const slotFn = qweb._compile(`slot_${key}_template`, { elem: slotNode, hasParent: true });
|
||||||
|
QWeb.slots[`${slotId}_${key}`] = slotFn;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (clone.childNodes.length) {
|
||||||
|
let hasContent = false;
|
||||||
|
const t = clone.ownerDocument!.createElement("t");
|
||||||
|
for (let child of Object.values(clone.childNodes)) {
|
||||||
|
hasContent =
|
||||||
|
hasContent || (child instanceof Text ? Boolean(child.textContent.trim().length) : true);
|
||||||
|
t.appendChild(child);
|
||||||
|
}
|
||||||
|
if (hasContent) {
|
||||||
|
const slotFn = qweb._compile(`slot_default_template`, { elem: t, hasParent: true });
|
||||||
|
QWeb.slots[`${slotId}_default`] = slotFn;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
ctx.addLine(
|
||||||
|
`let fiber = w${componentID}.__prepare(extra.fiber, ${scope}, () => { const vnode = fiber.vnode; pvnode.sel = vnode.sel; ${createHook}});`
|
||||||
|
);
|
||||||
|
// hack: specify empty remove hook to prevent the node from being removed from the DOM
|
||||||
|
const insertHook = refExpr ? `insert(vn) {${refExpr}},` : "";
|
||||||
|
ctx.addLine(
|
||||||
|
`let pvnode = h('dummy', {key: ${templateKey}, hook: {${insertHook}remove() {},destroy(vn) {${finalizeComponentCode}}}});`
|
||||||
|
);
|
||||||
|
if (registerCode) {
|
||||||
|
ctx.addLine(registerCode);
|
||||||
|
}
|
||||||
|
if (ctx.parentNode) {
|
||||||
|
ctx.addLine(`c${ctx.parentNode}.push(pvnode);`);
|
||||||
|
}
|
||||||
|
ctx.addLine(`w${componentID}.__owl__.pvnode = pvnode;`);
|
||||||
|
|
||||||
|
ctx.closeIf();
|
||||||
|
|
||||||
|
if (classObj) {
|
||||||
|
ctx.addLine(`w${componentID}.__owl__.classObj=${classObj};`);
|
||||||
|
}
|
||||||
|
|
||||||
|
ctx.addLine(`w${componentID}.__owl__.parentLastFiberId = extra.fiber.id;`);
|
||||||
|
|
||||||
|
return true;
|
||||||
|
},
|
||||||
|
});
|
||||||
@@ -1,66 +0,0 @@
|
|||||||
import type { ComponentNode } from "./component_node";
|
|
||||||
import type { Fiber } from "./fibers";
|
|
||||||
|
|
||||||
// Maps fibers to thrown errors
|
|
||||||
export const fibersInError: WeakMap<Fiber, any> = new WeakMap();
|
|
||||||
export const nodeErrorHandlers: WeakMap<ComponentNode, ((error: any) => void)[]> = new WeakMap();
|
|
||||||
|
|
||||||
function _handleError(node: ComponentNode | null, error: any, isFirstRound = false): boolean {
|
|
||||||
if (!node) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
const fiber = node.fiber;
|
|
||||||
if (fiber) {
|
|
||||||
fibersInError.set(fiber, error);
|
|
||||||
}
|
|
||||||
|
|
||||||
const errorHandlers = nodeErrorHandlers.get(node);
|
|
||||||
if (errorHandlers) {
|
|
||||||
let stopped = false;
|
|
||||||
// execute in the opposite order
|
|
||||||
for (let i = errorHandlers.length - 1; i >= 0; i--) {
|
|
||||||
try {
|
|
||||||
errorHandlers[i](error);
|
|
||||||
stopped = true;
|
|
||||||
break;
|
|
||||||
} catch (e) {
|
|
||||||
error = e;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if (stopped) {
|
|
||||||
if (isFirstRound && fiber) {
|
|
||||||
fiber.root.counter--;
|
|
||||||
}
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return _handleError(node.parent, error);
|
|
||||||
}
|
|
||||||
|
|
||||||
type ErrorParams = { error: any } & ({ node: ComponentNode } | { fiber: Fiber });
|
|
||||||
export function handleError(params: ErrorParams) {
|
|
||||||
const error = params.error;
|
|
||||||
const node = "node" in params ? params.node : params.fiber.node;
|
|
||||||
const fiber = "fiber" in params ? params.fiber : node.fiber!;
|
|
||||||
|
|
||||||
// resets the fibers on components if possible. This is important so that
|
|
||||||
// new renderings can be properly included in the initial one, if any.
|
|
||||||
let current: Fiber | null = fiber;
|
|
||||||
do {
|
|
||||||
current.node.fiber = current;
|
|
||||||
current = current.parent;
|
|
||||||
} while (current);
|
|
||||||
|
|
||||||
fibersInError.set(fiber.root, error);
|
|
||||||
|
|
||||||
const handled = _handleError(node, error, true);
|
|
||||||
if (!handled) {
|
|
||||||
console.warn(`[Owl] Unhandled error. Destroying the root component`);
|
|
||||||
try {
|
|
||||||
node.app.destroy();
|
|
||||||
} catch (e) {
|
|
||||||
console.error(e);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,365 @@
|
|||||||
|
import { h, VNode } from "../vdom/index";
|
||||||
|
import { Component, MountPosition, STATUS } from "./component";
|
||||||
|
import { scheduler } from "./scheduler";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Owl Fiber Class
|
||||||
|
*
|
||||||
|
* Fibers are small abstractions designed to contain all the internal state
|
||||||
|
* associated with a "rendering work unit", relative to a specific component.
|
||||||
|
*
|
||||||
|
* A rendering will cause the creation of a fiber for each impacted components.
|
||||||
|
*
|
||||||
|
* Fibers capture all that necessary information, which is critical to owl
|
||||||
|
* asynchronous rendering pipeline. Fibers can be cancelled, can be in different
|
||||||
|
* states and in general determine the state of the rendering.
|
||||||
|
*/
|
||||||
|
|
||||||
|
export class Fiber {
|
||||||
|
static nextId: number = 1;
|
||||||
|
id: number = Fiber.nextId++;
|
||||||
|
|
||||||
|
// The force attribute determines if a rendering should bypass the `shouldUpdate`
|
||||||
|
// method potentially implemented by a component. It is usually set to false.
|
||||||
|
force: boolean;
|
||||||
|
|
||||||
|
// isCompleted means that the rendering corresponding to this fiber's work is
|
||||||
|
// done, either because the component has been mounted or patched, or because
|
||||||
|
// fiber has been cancelled.
|
||||||
|
isCompleted: boolean = false;
|
||||||
|
|
||||||
|
// the fibers corresponding to component updates (updateProps) need to call
|
||||||
|
// the willPatch and patched hooks from the corresponding component. However,
|
||||||
|
// fibers corresponding to a new component do not need to do that. So, the
|
||||||
|
// shouldPatch hook is the boolean that we check whenever we need to apply
|
||||||
|
// a patch.
|
||||||
|
shouldPatch: boolean = true;
|
||||||
|
|
||||||
|
// isRendered is the last state of a fiber. If true, this means that it has
|
||||||
|
// been rendered and is inert (so, it should not be taken into account when
|
||||||
|
// counting the number of active fibers).
|
||||||
|
isRendered: boolean = false;
|
||||||
|
|
||||||
|
// the counter number is a critical information. It is only necessary for a
|
||||||
|
// root fiber. For that fiber, this number counts the number of active sub
|
||||||
|
// fibers. When that number reaches 0, the fiber can be applied by the
|
||||||
|
// scheduler.
|
||||||
|
counter: number = 0;
|
||||||
|
|
||||||
|
target: HTMLElement | DocumentFragment | null;
|
||||||
|
position: MountPosition | null;
|
||||||
|
|
||||||
|
scope: any;
|
||||||
|
|
||||||
|
component: Component;
|
||||||
|
vnode: VNode | null = null;
|
||||||
|
|
||||||
|
root: Fiber;
|
||||||
|
child: Fiber | null = null;
|
||||||
|
sibling: Fiber | null = null;
|
||||||
|
lastChild: Fiber | null = null;
|
||||||
|
parent: Fiber | null = null;
|
||||||
|
|
||||||
|
error?: Error;
|
||||||
|
|
||||||
|
constructor(
|
||||||
|
parent: Fiber | null,
|
||||||
|
component: Component,
|
||||||
|
force: boolean,
|
||||||
|
target: HTMLElement | DocumentFragment | null,
|
||||||
|
position: MountPosition | null
|
||||||
|
) {
|
||||||
|
this.component = component;
|
||||||
|
this.force = force;
|
||||||
|
this.target = target;
|
||||||
|
this.position = position;
|
||||||
|
|
||||||
|
const __owl__ = component.__owl__;
|
||||||
|
this.scope = __owl__.scope;
|
||||||
|
|
||||||
|
this.root = parent ? parent.root : this;
|
||||||
|
this.parent = parent;
|
||||||
|
|
||||||
|
let oldFiber = __owl__.currentFiber;
|
||||||
|
if (oldFiber && !oldFiber.isCompleted) {
|
||||||
|
this.force = true;
|
||||||
|
if (oldFiber.root === oldFiber && !parent) {
|
||||||
|
// both oldFiber and this fiber are root fibers
|
||||||
|
this._reuseFiber(oldFiber);
|
||||||
|
return oldFiber;
|
||||||
|
} else {
|
||||||
|
this._remapFiber(oldFiber);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
this.root.counter++;
|
||||||
|
|
||||||
|
__owl__.currentFiber = this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* When the oldFiber is not completed yet, and both oldFiber and this fiber
|
||||||
|
* are root fibers, we want to reuse the oldFiber instead of creating a new
|
||||||
|
* one. Doing so will guarantee that the initiator(s) of those renderings will
|
||||||
|
* be notified (the promise will resolve) when the last rendering will be done.
|
||||||
|
*
|
||||||
|
* This function thus assumes that oldFiber is a root fiber.
|
||||||
|
*/
|
||||||
|
_reuseFiber(oldFiber: Fiber) {
|
||||||
|
oldFiber.cancel(); // cancel children fibers
|
||||||
|
oldFiber.target = this.target || oldFiber.target;
|
||||||
|
oldFiber.position = this.position || oldFiber.position;
|
||||||
|
oldFiber.isCompleted = false; // keep the root fiber alive
|
||||||
|
oldFiber.isRendered = false; // the fiber has to be re-rendered
|
||||||
|
if (oldFiber.child) {
|
||||||
|
// remove relation to children
|
||||||
|
oldFiber.child.parent = null;
|
||||||
|
oldFiber.child = null;
|
||||||
|
oldFiber.lastChild = null;
|
||||||
|
}
|
||||||
|
oldFiber.counter = 1; // re-initialize counter
|
||||||
|
oldFiber.id = Fiber.nextId++;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* In some cases, a rendering initiated at some component can detect that it
|
||||||
|
* should be part of a larger rendering initiated somewhere up the component
|
||||||
|
* tree. In that case, it needs to cancel the previous rendering and
|
||||||
|
* remap itself as a part of the current parent rendering.
|
||||||
|
*/
|
||||||
|
_remapFiber(oldFiber: Fiber) {
|
||||||
|
oldFiber.cancel();
|
||||||
|
this.shouldPatch = oldFiber.shouldPatch;
|
||||||
|
if (oldFiber === oldFiber.root) {
|
||||||
|
oldFiber.counter++;
|
||||||
|
}
|
||||||
|
if (oldFiber.parent && !this.parent) {
|
||||||
|
// re-map links
|
||||||
|
this.parent = oldFiber.parent;
|
||||||
|
this.root = this.parent.root;
|
||||||
|
this.sibling = oldFiber.sibling;
|
||||||
|
if (this.parent.lastChild === oldFiber) {
|
||||||
|
this.parent.lastChild = this;
|
||||||
|
}
|
||||||
|
if (this.parent.child === oldFiber) {
|
||||||
|
this.parent.child = this;
|
||||||
|
} else {
|
||||||
|
let current = this.parent.child!;
|
||||||
|
while (true) {
|
||||||
|
if (current.sibling === oldFiber) {
|
||||||
|
current.sibling = this;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
current = current.sibling!;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This function has been taken from
|
||||||
|
* https://medium.com/react-in-depth/the-how-and-why-on-reacts-usage-of-linked-list-in-fiber-67f1014d0eb7
|
||||||
|
*/
|
||||||
|
_walk(doWork: (f: Fiber) => Fiber | null) {
|
||||||
|
let root = this;
|
||||||
|
let current: Fiber = this;
|
||||||
|
while (true) {
|
||||||
|
const child = doWork(current);
|
||||||
|
if (child) {
|
||||||
|
current = child;
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
if (current === root) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
while (!current.sibling) {
|
||||||
|
if (!current.parent || current.parent === root) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
current = current.parent;
|
||||||
|
}
|
||||||
|
current = current.sibling;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Successfully complete the work of the fiber: call the mount or patch hooks
|
||||||
|
* and patch the DOM. This function is called once the fiber and its children
|
||||||
|
* are ready, and the scheduler decides to process it.
|
||||||
|
*/
|
||||||
|
complete() {
|
||||||
|
let component = this.component;
|
||||||
|
this.isCompleted = true;
|
||||||
|
const status = component.__owl__.status;
|
||||||
|
if (status === STATUS.DESTROYED) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// build patchQueue
|
||||||
|
const patchQueue: Fiber[] = [];
|
||||||
|
const doWork: (Fiber) => Fiber | null = function (f) {
|
||||||
|
f.component.__owl__.currentFiber = null;
|
||||||
|
patchQueue.push(f);
|
||||||
|
return f.child;
|
||||||
|
};
|
||||||
|
this._walk(doWork);
|
||||||
|
const patchLen = patchQueue.length;
|
||||||
|
|
||||||
|
// call willPatch hook on each fiber of patchQueue
|
||||||
|
if (status === STATUS.MOUNTED) {
|
||||||
|
for (let i = 0; i < patchLen; i++) {
|
||||||
|
const fiber = patchQueue[i];
|
||||||
|
if (fiber.shouldPatch) {
|
||||||
|
component = fiber.component;
|
||||||
|
if (component.__owl__.willPatchCB) {
|
||||||
|
component.__owl__.willPatchCB();
|
||||||
|
}
|
||||||
|
component.willPatch();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// call __patch on each fiber of (reversed) patchQueue
|
||||||
|
for (let i = patchLen - 1; i >= 0; i--) {
|
||||||
|
const fiber = patchQueue[i];
|
||||||
|
component = fiber.component;
|
||||||
|
if (fiber.target && i === 0) {
|
||||||
|
let target;
|
||||||
|
if (fiber.position === "self") {
|
||||||
|
target = fiber.target;
|
||||||
|
if ((target as HTMLElement).tagName.toLowerCase() !== fiber.vnode!.sel) {
|
||||||
|
throw new Error(
|
||||||
|
`Cannot attach '${component.constructor.name}' to target node (not same tag name)`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
// In self mode, we *know* we are to take possession of the target
|
||||||
|
// Hence we manually create the corresponding VNode and copy the "key" in data
|
||||||
|
const selfVnodeData = fiber.vnode!.data ? { key: fiber.vnode!.data.key } : {};
|
||||||
|
const selfVnode = h(fiber.vnode!.sel, selfVnodeData);
|
||||||
|
selfVnode.elm = target;
|
||||||
|
target = selfVnode;
|
||||||
|
} else {
|
||||||
|
target = component.__owl__.vnode || document.createElement(fiber.vnode!.sel!);
|
||||||
|
}
|
||||||
|
component.__patch(target!, fiber.vnode!);
|
||||||
|
} else {
|
||||||
|
if (fiber.shouldPatch) {
|
||||||
|
component.__patch(component.__owl__.vnode!, fiber.vnode!);
|
||||||
|
// When updating a Component's props (in directive),
|
||||||
|
// the component has a pvnode AND should be patched.
|
||||||
|
// However, its pvnode.elm may have changed if it is a High Order Component
|
||||||
|
if (component.__owl__.pvnode) {
|
||||||
|
component.__owl__.pvnode.elm = component.__owl__.vnode!.elm;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
component.__patch(document.createElement(fiber.vnode!.sel!), fiber.vnode!);
|
||||||
|
component.__owl__.pvnode!.elm = component.__owl__.vnode!.elm;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// insert into the DOM (mount case)
|
||||||
|
let inDOM = false;
|
||||||
|
if (this.target) {
|
||||||
|
switch (this.position) {
|
||||||
|
case "first-child":
|
||||||
|
this.target.prepend(this.component.el!);
|
||||||
|
break;
|
||||||
|
case "last-child":
|
||||||
|
this.target.appendChild(this.component.el!);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
inDOM = document.body.contains(this.component.el);
|
||||||
|
this.component.env.qweb.trigger("dom-appended");
|
||||||
|
}
|
||||||
|
|
||||||
|
// call patched/mounted hook on each fiber of (reversed) patchQueue
|
||||||
|
if (status === STATUS.MOUNTED || inDOM) {
|
||||||
|
for (let i = patchLen - 1; i >= 0; i--) {
|
||||||
|
const fiber = patchQueue[i];
|
||||||
|
component = fiber.component;
|
||||||
|
if (fiber.shouldPatch && !this.target) {
|
||||||
|
component.patched();
|
||||||
|
if (component.__owl__.patchedCB) {
|
||||||
|
component.__owl__.patchedCB();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
component.__callMounted();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
for (let i = patchLen - 1; i >= 0; i--) {
|
||||||
|
const fiber = patchQueue[i];
|
||||||
|
component = fiber.component;
|
||||||
|
component.__owl__.status = STATUS.UNMOUNTED;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Cancel a fiber and all its children.
|
||||||
|
*/
|
||||||
|
cancel() {
|
||||||
|
this._walk((f) => {
|
||||||
|
if (!f.isRendered) {
|
||||||
|
f.root.counter--;
|
||||||
|
}
|
||||||
|
f.isCompleted = true;
|
||||||
|
return f.child;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This is the global error handler for errors occurring in Owl main lifecycle
|
||||||
|
* methods. Caught errors are triggered on the QWeb instance, and are
|
||||||
|
* potentially given to some parent component which implements `catchError`.
|
||||||
|
*
|
||||||
|
* If there are no such component, we destroy everything. This is better than
|
||||||
|
* being in a corrupted state.
|
||||||
|
*/
|
||||||
|
handleError(error: Error) {
|
||||||
|
let component = this.component;
|
||||||
|
this.vnode = component.__owl__.vnode || h("div");
|
||||||
|
|
||||||
|
const qweb = component.env.qweb;
|
||||||
|
let root = component;
|
||||||
|
|
||||||
|
function handle(error) {
|
||||||
|
let canCatch = false;
|
||||||
|
qweb.trigger("error", error);
|
||||||
|
while (component && !(canCatch = !!component.catchError)) {
|
||||||
|
root = component;
|
||||||
|
component = component.__owl__.parent!;
|
||||||
|
}
|
||||||
|
if (canCatch) {
|
||||||
|
try {
|
||||||
|
component.catchError!(error);
|
||||||
|
} catch (e) {
|
||||||
|
root = component;
|
||||||
|
component = component.__owl__.parent!;
|
||||||
|
return handle(e);
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
let isHandled = handle(error);
|
||||||
|
|
||||||
|
if (!isHandled) {
|
||||||
|
// the 3 next lines aim to mark the root fiber as being in error, and
|
||||||
|
// to force it to end, without waiting for its children
|
||||||
|
this.root.counter = 0;
|
||||||
|
this.root.error = error;
|
||||||
|
scheduler.flush();
|
||||||
|
// at this point, the state of the application is corrupted and we could
|
||||||
|
// have a lot of issues or crashes. So we destroy the application in a try
|
||||||
|
// catch and swallow these errors because the fiber is already in error,
|
||||||
|
// and this is the actual issue that needs to be solved, not those followup
|
||||||
|
// errors.
|
||||||
|
try {
|
||||||
|
root.destroy();
|
||||||
|
} catch (e) {}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,235 +0,0 @@
|
|||||||
import { BDom, mount } from "../blockdom";
|
|
||||||
import type { ComponentNode } from "./component_node";
|
|
||||||
import { fibersInError, handleError } from "./error_handling";
|
|
||||||
import { STATUS } from "./status";
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Cleans on the root fiber the patch and willPatch fiber lists
|
|
||||||
* It is typically needed when the same root fiber needs to recycle on
|
|
||||||
* of its children or grandchildren's fiber.
|
|
||||||
*/
|
|
||||||
function cleanPatchableFiber(child: Fiber, root: RootFiber) {
|
|
||||||
const { willPatch, patched } = root;
|
|
||||||
let i = willPatch.indexOf(child);
|
|
||||||
if (i > -1) {
|
|
||||||
willPatch.splice(i, 1);
|
|
||||||
}
|
|
||||||
i = patched.indexOf(child);
|
|
||||||
if (i > -1) {
|
|
||||||
patched.splice(i, 1);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export function makeChildFiber(node: ComponentNode, parent: Fiber): Fiber {
|
|
||||||
let current = node.fiber;
|
|
||||||
if (current) {
|
|
||||||
// current is necessarily a rootfiber here
|
|
||||||
let root = parent.root;
|
|
||||||
const isSameRoot = current.root === root;
|
|
||||||
cancelFibers(root, current.children);
|
|
||||||
current.children = [];
|
|
||||||
current.parent = parent;
|
|
||||||
// only increment our rendering if we were not
|
|
||||||
// already accounted for, or that we have been rendered
|
|
||||||
// already (in which case our fiber was removed from the root rendering)
|
|
||||||
if (!isSameRoot || current.bdom) {
|
|
||||||
root.counter++;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (isSameRoot) {
|
|
||||||
cleanPatchableFiber(current, root);
|
|
||||||
}
|
|
||||||
|
|
||||||
current.bdom = null;
|
|
||||||
current.root = root;
|
|
||||||
return current;
|
|
||||||
}
|
|
||||||
return new Fiber(node, parent);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function makeRootFiber(node: ComponentNode): Fiber {
|
|
||||||
let current = node.fiber;
|
|
||||||
if (current) {
|
|
||||||
let root = current.root;
|
|
||||||
root.counter -= cancelFibers(root, current.children);
|
|
||||||
current.children = [];
|
|
||||||
root.counter++;
|
|
||||||
current.bdom = null;
|
|
||||||
if (fibersInError.has(current)) {
|
|
||||||
fibersInError.delete(current);
|
|
||||||
fibersInError.delete(root);
|
|
||||||
current.appliedToDom = false;
|
|
||||||
}
|
|
||||||
return current;
|
|
||||||
}
|
|
||||||
const fiber = new RootFiber(node, null);
|
|
||||||
if (node.willPatch.length) {
|
|
||||||
fiber.willPatch.push(fiber);
|
|
||||||
}
|
|
||||||
if (node.patched.length) {
|
|
||||||
fiber.patched.push(fiber);
|
|
||||||
}
|
|
||||||
|
|
||||||
return fiber;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @returns number of not-yet rendered fibers cancelled
|
|
||||||
*/
|
|
||||||
function cancelFibers(root: any, fibers: Fiber[]): number {
|
|
||||||
let result = 0;
|
|
||||||
for (let fiber of fibers) {
|
|
||||||
fiber.node.fiber = null;
|
|
||||||
fiber.root = root;
|
|
||||||
if (!fiber.bdom) {
|
|
||||||
result++;
|
|
||||||
}
|
|
||||||
result += cancelFibers(root, fiber.children);
|
|
||||||
}
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
|
|
||||||
export class Fiber {
|
|
||||||
node: ComponentNode;
|
|
||||||
bdom: BDom | null = null;
|
|
||||||
root: RootFiber;
|
|
||||||
parent: Fiber | null;
|
|
||||||
children: Fiber[] = [];
|
|
||||||
appliedToDom = false;
|
|
||||||
|
|
||||||
constructor(node: ComponentNode, parent: Fiber | null) {
|
|
||||||
this.node = node;
|
|
||||||
this.parent = parent;
|
|
||||||
if (parent) {
|
|
||||||
const root = parent.root;
|
|
||||||
root.counter++;
|
|
||||||
this.root = root;
|
|
||||||
parent.children.push(this);
|
|
||||||
} else {
|
|
||||||
this.root = this as any;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export class RootFiber extends Fiber {
|
|
||||||
counter: number = 1;
|
|
||||||
|
|
||||||
// only add stuff in this if they have registered some hooks
|
|
||||||
willPatch: Fiber[] = [];
|
|
||||||
patched: Fiber[] = [];
|
|
||||||
mounted: Fiber[] = [];
|
|
||||||
// A fiber is typically locked when it is completing and the patch has not, or is being applied.
|
|
||||||
// i.e.: render triggered in onWillUnmount or in willPatch will be delayed
|
|
||||||
locked: boolean = false;
|
|
||||||
|
|
||||||
complete() {
|
|
||||||
const node = this.node;
|
|
||||||
this.locked = true;
|
|
||||||
let current: Fiber | undefined = undefined;
|
|
||||||
try {
|
|
||||||
// Step 1: calling all willPatch lifecycle hooks
|
|
||||||
for (current of this.willPatch) {
|
|
||||||
// because of the asynchronous nature of the rendering, some parts of the
|
|
||||||
// UI may have been rendered, then deleted in a followup rendering, and we
|
|
||||||
// do not want to call onWillPatch in that case.
|
|
||||||
let node = current.node;
|
|
||||||
if (node.fiber === current) {
|
|
||||||
const component = node.component;
|
|
||||||
for (let cb of node.willPatch) {
|
|
||||||
cb.call(component);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
current = undefined;
|
|
||||||
|
|
||||||
// Step 2: patching the dom
|
|
||||||
node.bdom!.patch(this.bdom!, Object.keys(node.children).length > 0);
|
|
||||||
this.appliedToDom = true;
|
|
||||||
|
|
||||||
this.locked = false;
|
|
||||||
// unregistering the fiber before mounted since it can do another render
|
|
||||||
// and that the current rendering is obviously completed
|
|
||||||
node.fiber = null;
|
|
||||||
|
|
||||||
// Step 4: calling all mounted lifecycle hooks
|
|
||||||
let mountedFibers = this.mounted;
|
|
||||||
while ((current = mountedFibers.pop())) {
|
|
||||||
current = current;
|
|
||||||
if (current.appliedToDom) {
|
|
||||||
for (let cb of current.node.mounted) {
|
|
||||||
cb();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Step 5: calling all patched hooks
|
|
||||||
let patchedFibers = this.patched;
|
|
||||||
while ((current = patchedFibers.pop())) {
|
|
||||||
current = current;
|
|
||||||
if (current.appliedToDom) {
|
|
||||||
for (let cb of current.node.patched) {
|
|
||||||
cb();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} catch (e) {
|
|
||||||
this.locked = false;
|
|
||||||
handleError({ fiber: current || this, error: e });
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
type Position = "first-child" | "last-child";
|
|
||||||
|
|
||||||
export interface MountOptions {
|
|
||||||
position?: Position;
|
|
||||||
}
|
|
||||||
|
|
||||||
export class MountFiber extends RootFiber {
|
|
||||||
target: HTMLElement;
|
|
||||||
position: Position;
|
|
||||||
|
|
||||||
constructor(node: ComponentNode, target: HTMLElement, options: MountOptions = {}) {
|
|
||||||
super(node, null);
|
|
||||||
this.target = target;
|
|
||||||
this.position = options.position || "last-child";
|
|
||||||
}
|
|
||||||
complete() {
|
|
||||||
let current: Fiber | undefined = this;
|
|
||||||
try {
|
|
||||||
const node = this.node;
|
|
||||||
if (node.bdom) {
|
|
||||||
// this is a complicated situation: if we mount a fiber with an existing
|
|
||||||
// bdom, this means that this same fiber was already completed, mounted,
|
|
||||||
// but a crash occurred in some mounted hook. Then, it was handled and
|
|
||||||
// the new rendering is being applied.
|
|
||||||
node.updateDom();
|
|
||||||
} else {
|
|
||||||
node.bdom = this.bdom;
|
|
||||||
if (this.position === "last-child" || this.target.childNodes.length === 0) {
|
|
||||||
mount(node.bdom!, this.target);
|
|
||||||
} else {
|
|
||||||
const firstChild = this.target.childNodes[0];
|
|
||||||
mount(node.bdom!, this.target, firstChild);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// unregistering the fiber before mounted since it can do another render
|
|
||||||
// and that the current rendering is obviously completed
|
|
||||||
node.fiber = null;
|
|
||||||
|
|
||||||
node.status = STATUS.MOUNTED;
|
|
||||||
this.appliedToDom = true;
|
|
||||||
let mountedFibers = this.mounted;
|
|
||||||
while ((current = mountedFibers.pop())) {
|
|
||||||
if (current.appliedToDom) {
|
|
||||||
for (let cb of current.node.mounted) {
|
|
||||||
cb();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} catch (e) {
|
|
||||||
handleError({ fiber: current as Fiber, error: e });
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,36 +0,0 @@
|
|||||||
import { filterOutModifiersFromData } from "../blockdom/config";
|
|
||||||
|
|
||||||
export const mainEventHandler = (data: any, ev: Event, currentTarget?: EventTarget | null) => {
|
|
||||||
const { data: _data, modifiers } = filterOutModifiersFromData(data);
|
|
||||||
data = _data;
|
|
||||||
let stopped = false;
|
|
||||||
if (modifiers.length) {
|
|
||||||
let selfMode = false;
|
|
||||||
const isSelf = ev.target === currentTarget;
|
|
||||||
for (const mod of modifiers) {
|
|
||||||
switch (mod) {
|
|
||||||
case "self":
|
|
||||||
selfMode = true;
|
|
||||||
if (isSelf) {
|
|
||||||
continue;
|
|
||||||
} else {
|
|
||||||
return stopped;
|
|
||||||
}
|
|
||||||
case "prevent":
|
|
||||||
if ((selfMode && isSelf) || !selfMode) ev.preventDefault();
|
|
||||||
continue;
|
|
||||||
case "stop":
|
|
||||||
if ((selfMode && isSelf) || !selfMode) ev.stopPropagation();
|
|
||||||
stopped = true;
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// If handler is empty, the array slot 0 will also be empty, and data will not have the property 0
|
|
||||||
// We check this rather than data[0] being truthy (or typeof function) so that it crashes
|
|
||||||
// as expected when there is a handler expression that evaluates to a falsy value
|
|
||||||
if (Object.hasOwnProperty.call(data, 0)) {
|
|
||||||
data[0].call(data[1] ? data[1].__owl__.component : null, ev);
|
|
||||||
}
|
|
||||||
return stopped;
|
|
||||||
};
|
|
||||||
@@ -1,71 +0,0 @@
|
|||||||
import { getCurrent } from "./component_node";
|
|
||||||
import { nodeErrorHandlers } from "./error_handling";
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// hooks
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
export function onWillStart(fn: () => Promise<void> | void | any) {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
node.willStart.push(fn);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function onWillUpdateProps(fn: (nextProps: any) => Promise<void> | void | any) {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
node.willUpdateProps.push(fn);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function onMounted(fn: () => void | any) {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
node.mounted.push(fn);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function onWillPatch(fn: () => Promise<void> | any | void) {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
node.willPatch.unshift(fn);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function onPatched(fn: () => void | any) {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
node.patched.push(fn);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function onWillUnmount(fn: () => Promise<void> | void | any) {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
node.willUnmount.unshift(fn);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function onWillDestroy(fn: () => Promise<void> | void | any) {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
node.willDestroy.push(fn);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function onWillRender(fn: () => void | any) {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
const renderFn = node.renderFn;
|
|
||||||
node.renderFn = () => {
|
|
||||||
fn();
|
|
||||||
return renderFn();
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
export function onRendered(fn: () => void | any) {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
const renderFn = node.renderFn;
|
|
||||||
node.renderFn = () => {
|
|
||||||
const result = renderFn();
|
|
||||||
fn();
|
|
||||||
return result;
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
type OnErrorCallback = (error: any) => void | any;
|
|
||||||
export function onError(callback: OnErrorCallback) {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
let handlers = nodeErrorHandlers.get(node);
|
|
||||||
if (!handlers) {
|
|
||||||
handlers = [];
|
|
||||||
nodeErrorHandlers.set(node, handlers);
|
|
||||||
}
|
|
||||||
handlers.push(callback);
|
|
||||||
}
|
|
||||||
@@ -1,32 +1,8 @@
|
|||||||
import { Component } from "./component";
|
import { QWeb } from "../qweb/index";
|
||||||
|
|
||||||
/**
|
|
||||||
* Apply default props (only top level).
|
|
||||||
*
|
|
||||||
* Note that this method does modify in place the props
|
|
||||||
*/
|
|
||||||
export function applyDefaultProps(props: { [key: string]: any }, ComponentClass: typeof Component) {
|
|
||||||
const defaultProps = (ComponentClass as any).defaultProps;
|
|
||||||
if (defaultProps) {
|
|
||||||
for (let propName in defaultProps) {
|
|
||||||
if (props![propName] === undefined) {
|
|
||||||
props![propName] = defaultProps[propName];
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
//------------------------------------------------------------------------------
|
||||||
// Prop validation helper
|
// Prop validation helper
|
||||||
//------------------------------------------------------------------------------
|
//------------------------------------------------------------------------------
|
||||||
function getPropDescription(staticProps: any) {
|
|
||||||
if (staticProps instanceof Array) {
|
|
||||||
return Object.fromEntries(
|
|
||||||
staticProps.map((p) => (p.endsWith("?") ? [p.slice(0, -1), false] : [p, true]))
|
|
||||||
);
|
|
||||||
}
|
|
||||||
return staticProps || { "*": true };
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Validate the component props (or next props) against the (static) props
|
* Validate the component props (or next props) against the (static) props
|
||||||
@@ -34,23 +10,32 @@ function getPropDescription(staticProps: any) {
|
|||||||
* visit recursively the props and all the children to check if they are valid.
|
* visit recursively the props and all the children to check if they are valid.
|
||||||
* This is why it is only done in 'dev' mode.
|
* This is why it is only done in 'dev' mode.
|
||||||
*/
|
*/
|
||||||
export const validateProps = function (name: string | typeof Component, props: any, parent?: any) {
|
|
||||||
const ComponentClass = (
|
|
||||||
typeof name !== "string" ? name : parent.constructor.components[name]
|
|
||||||
) as typeof Component;
|
|
||||||
|
|
||||||
applyDefaultProps(props, ComponentClass);
|
QWeb.utils.validateProps = function (Widget, props: Object) {
|
||||||
|
const propsDef = (<any>Widget).props;
|
||||||
let propsDef = getPropDescription(ComponentClass.props);
|
if (propsDef instanceof Array) {
|
||||||
const allowAdditionalProps = "*" in propsDef;
|
// list of strings (prop names)
|
||||||
|
for (let i = 0, l = propsDef.length; i < l; i++) {
|
||||||
for (let propName in propsDef) {
|
const propName = propsDef[i];
|
||||||
if (propName === "*") {
|
if (propName[propName.length - 1] === "?") {
|
||||||
continue;
|
// optional prop
|
||||||
|
break;
|
||||||
}
|
}
|
||||||
|
if (!(propName in props)) {
|
||||||
|
throw new Error(`Missing props '${propsDef[i]}' (component '${Widget.name}')`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (let key in props) {
|
||||||
|
if (!propsDef.includes(key) && !propsDef.includes(key + "?")) {
|
||||||
|
throw new Error(`Unknown prop '${key}' given to component '${Widget.name}'`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else if (propsDef) {
|
||||||
|
// propsDef is an object now
|
||||||
|
for (let propName in propsDef) {
|
||||||
if (props[propName] === undefined) {
|
if (props[propName] === undefined) {
|
||||||
if (propsDef[propName] && !propsDef[propName].optional) {
|
if (propsDef[propName] && !propsDef[propName].optional) {
|
||||||
throw new Error(`Missing props '${propName}' (component '${ComponentClass.name}')`);
|
throw new Error(`Missing props '${propName}' (component '${Widget.name}')`);
|
||||||
} else {
|
} else {
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
@@ -59,19 +44,16 @@ export const validateProps = function (name: string | typeof Component, props: a
|
|||||||
try {
|
try {
|
||||||
isValid = isValidProp(props[propName], propsDef[propName]);
|
isValid = isValidProp(props[propName], propsDef[propName]);
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
(e as Error).message = `Invalid prop '${propName}' in component ${ComponentClass.name} (${
|
e.message = `Invalid prop '${propName}' in component ${Widget.name} (${e.message})`;
|
||||||
(e as Error).message
|
|
||||||
})`;
|
|
||||||
throw e;
|
throw e;
|
||||||
}
|
}
|
||||||
if (!isValid) {
|
if (!isValid) {
|
||||||
throw new Error(`Invalid Prop '${propName}' in component '${ComponentClass.name}'`);
|
throw new Error(`Invalid Prop '${propName}' in component '${Widget.name}'`);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (!allowAdditionalProps) {
|
|
||||||
for (let propName in props) {
|
for (let propName in props) {
|
||||||
if (!(propName in propsDef)) {
|
if (!(propName in propsDef)) {
|
||||||
throw new Error(`Unknown prop '${propName}' given to component '${ComponentClass.name}'`);
|
throw new Error(`Unknown prop '${propName}' given to component '${Widget.name}'`);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -80,7 +62,7 @@ export const validateProps = function (name: string | typeof Component, props: a
|
|||||||
/**
|
/**
|
||||||
* Check if an invidual prop value matches its (static) prop definition
|
* Check if an invidual prop value matches its (static) prop definition
|
||||||
*/
|
*/
|
||||||
function isValidProp(prop: any, propDef: any): boolean {
|
function isValidProp(prop, propDef): boolean {
|
||||||
if (propDef === true) {
|
if (propDef === true) {
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|||||||
+66
-27
@@ -1,13 +1,24 @@
|
|||||||
import { fibersInError } from "./error_handling";
|
import { Fiber } from "./fiber";
|
||||||
import { Fiber, RootFiber } from "./fibers";
|
import { browser } from "../browser";
|
||||||
import { STATUS } from "./status";
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
/**
|
||||||
// Scheduler
|
* Owl Scheduler Class
|
||||||
// -----------------------------------------------------------------------------
|
*
|
||||||
|
* The scheduler is the part of Owl that will effectively apply a rendering
|
||||||
|
* whenever a fiber is ready.
|
||||||
|
*
|
||||||
|
* Briefly, it can be used to register root fibers. Whenever there is an
|
||||||
|
* active root fiber, it will poll continuously each animation frame (so, about
|
||||||
|
* once every 16ms) and whenever a root fiber is ready, it will apply it.
|
||||||
|
*/
|
||||||
|
|
||||||
|
interface Task {
|
||||||
|
fiber: Fiber;
|
||||||
|
callback: (err?: Error) => void;
|
||||||
|
}
|
||||||
|
|
||||||
export class Scheduler {
|
export class Scheduler {
|
||||||
tasks: Set<RootFiber> = new Set();
|
tasks: Task[] = [];
|
||||||
isRunning: boolean = false;
|
isRunning: boolean = false;
|
||||||
requestAnimationFrame: Window["requestAnimationFrame"];
|
requestAnimationFrame: Window["requestAnimationFrame"];
|
||||||
|
|
||||||
@@ -24,11 +35,38 @@ export class Scheduler {
|
|||||||
this.isRunning = false;
|
this.isRunning = false;
|
||||||
}
|
}
|
||||||
|
|
||||||
addFiber(fiber: Fiber) {
|
addFiber(fiber: Fiber): Promise<void> {
|
||||||
this.tasks.add(fiber.root);
|
// if the fiber was remapped into a larger rendering fiber, it may not be a
|
||||||
|
// root fiber. But we only want to register root fibers
|
||||||
|
fiber = fiber.root;
|
||||||
|
return new Promise((resolve, reject) => {
|
||||||
|
if (fiber.error) {
|
||||||
|
return reject(fiber.error);
|
||||||
|
}
|
||||||
|
this.tasks.push({
|
||||||
|
fiber,
|
||||||
|
callback: () => {
|
||||||
|
if (fiber.error) {
|
||||||
|
return reject(fiber.error);
|
||||||
|
}
|
||||||
|
resolve();
|
||||||
|
},
|
||||||
|
});
|
||||||
if (!this.isRunning) {
|
if (!this.isRunning) {
|
||||||
this.start();
|
this.start();
|
||||||
}
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
rejectFiber(fiber: Fiber, reason: string) {
|
||||||
|
fiber = fiber.root;
|
||||||
|
const index = this.tasks.findIndex((t) => t.fiber === fiber);
|
||||||
|
if (index >= 0) {
|
||||||
|
const [task] = this.tasks.splice(index, 1);
|
||||||
|
fiber.cancel();
|
||||||
|
fiber.error = new Error(reason);
|
||||||
|
task.callback();
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -36,29 +74,28 @@ export class Scheduler {
|
|||||||
* Other tasks are left unchanged.
|
* Other tasks are left unchanged.
|
||||||
*/
|
*/
|
||||||
flush() {
|
flush() {
|
||||||
this.tasks.forEach((fiber) => {
|
let tasks = this.tasks;
|
||||||
if (fiber.root !== fiber) {
|
this.tasks = [];
|
||||||
this.tasks.delete(fiber);
|
tasks = tasks.filter((task) => {
|
||||||
return;
|
if (task.fiber.isCompleted) {
|
||||||
|
task.callback();
|
||||||
|
return false;
|
||||||
}
|
}
|
||||||
const hasError = fibersInError.has(fiber);
|
if (task.fiber.counter === 0) {
|
||||||
if (hasError && fiber.counter !== 0) {
|
if (!task.fiber.error) {
|
||||||
this.tasks.delete(fiber);
|
try {
|
||||||
return;
|
task.fiber.complete();
|
||||||
|
} catch (e) {
|
||||||
|
task.fiber.handleError(e);
|
||||||
}
|
}
|
||||||
if (fiber.node.status === STATUS.DESTROYED) {
|
|
||||||
this.tasks.delete(fiber);
|
|
||||||
return;
|
|
||||||
}
|
}
|
||||||
|
task.callback();
|
||||||
if (fiber.counter === 0) {
|
return false;
|
||||||
if (!hasError) {
|
|
||||||
fiber.complete();
|
|
||||||
}
|
|
||||||
this.tasks.delete(fiber);
|
|
||||||
}
|
}
|
||||||
|
return true;
|
||||||
});
|
});
|
||||||
if (this.tasks.size === 0) {
|
this.tasks = tasks.concat(this.tasks);
|
||||||
|
if (this.tasks.length === 0) {
|
||||||
this.stop();
|
this.stop();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -72,3 +109,5 @@ export class Scheduler {
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export const scheduler = new Scheduler(browser.requestAnimationFrame);
|
||||||
|
|||||||
@@ -1,24 +0,0 @@
|
|||||||
import type { Component } from "./component";
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// Status
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
export const enum STATUS {
|
|
||||||
NEW,
|
|
||||||
MOUNTED, // is ready, and in DOM. It has a valid el
|
|
||||||
DESTROYED,
|
|
||||||
}
|
|
||||||
|
|
||||||
type STATUS_DESCR = "new" | "mounted" | "destroyed";
|
|
||||||
|
|
||||||
export function status(component: Component): STATUS_DESCR {
|
|
||||||
switch (component.__owl__.status) {
|
|
||||||
case STATUS.NEW:
|
|
||||||
return "new";
|
|
||||||
case STATUS.MOUNTED:
|
|
||||||
return "mounted";
|
|
||||||
case STATUS.DESTROYED:
|
|
||||||
return "destroyed";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,70 @@
|
|||||||
|
/**
|
||||||
|
* Owl Style System
|
||||||
|
*
|
||||||
|
* This files contains the Owl code related to processing (extended) css strings
|
||||||
|
* and creating/adding <style> tags to the document head.
|
||||||
|
*/
|
||||||
|
|
||||||
|
export const STYLESHEETS: { [id: string]: HTMLStyleElement } = {};
|
||||||
|
|
||||||
|
export function processSheet(str: string): string {
|
||||||
|
const tokens = str.split(/(\{|\}|;)/).map((s) => s.trim());
|
||||||
|
const selectorStack: string[][] = [];
|
||||||
|
const parts: string[] = [];
|
||||||
|
let rules: string[] = [];
|
||||||
|
function generateSelector(stackIndex: number, parentSelector?: string) {
|
||||||
|
const parts: string[] = [];
|
||||||
|
for (const selector of selectorStack[stackIndex]) {
|
||||||
|
let part = (parentSelector && parentSelector + " " + selector) || selector;
|
||||||
|
if (part.includes("&")) {
|
||||||
|
part = selector.replace(/&/g, parentSelector || "");
|
||||||
|
}
|
||||||
|
if (stackIndex < selectorStack.length - 1) {
|
||||||
|
part = generateSelector(stackIndex + 1, part);
|
||||||
|
}
|
||||||
|
parts.push(part);
|
||||||
|
}
|
||||||
|
return parts.join(", ");
|
||||||
|
}
|
||||||
|
function generateRules() {
|
||||||
|
if (rules.length) {
|
||||||
|
parts.push(generateSelector(0) + " {");
|
||||||
|
parts.push(...rules);
|
||||||
|
parts.push("}");
|
||||||
|
rules = [];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
while (tokens.length) {
|
||||||
|
let token = tokens.shift()!;
|
||||||
|
if (token === "}") {
|
||||||
|
generateRules();
|
||||||
|
selectorStack.pop();
|
||||||
|
} else {
|
||||||
|
if (tokens[0] === "{") {
|
||||||
|
generateRules();
|
||||||
|
selectorStack.push(token.split(/\s*,\s*/));
|
||||||
|
tokens.shift();
|
||||||
|
}
|
||||||
|
if (tokens[0] === ";") {
|
||||||
|
rules.push(" " + token + ";");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return parts.join("\n");
|
||||||
|
}
|
||||||
|
export function registerSheet(id: string, css: string) {
|
||||||
|
const sheet = document.createElement("style");
|
||||||
|
sheet.innerHTML = processSheet(css);
|
||||||
|
STYLESHEETS[id] = sheet;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function activateSheet(id, name) {
|
||||||
|
const sheet = STYLESHEETS[id];
|
||||||
|
if (!sheet) {
|
||||||
|
throw new Error(
|
||||||
|
`Invalid css stylesheet for component '${name}'. Did you forget to use the 'css' tag helper?`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
sheet.setAttribute("component", name);
|
||||||
|
document.head.appendChild(sheet);
|
||||||
|
}
|
||||||
@@ -0,0 +1,42 @@
|
|||||||
|
import { QWeb } from "./qweb/index";
|
||||||
|
import { TRANSLATABLE_ATTRS } from "./qweb/qweb";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This file creates and exports the OWL 'config' object, with keys:
|
||||||
|
* - 'mode': 'prod' or 'dev',
|
||||||
|
* - 'env': the environment to use in root components.
|
||||||
|
*/
|
||||||
|
|
||||||
|
interface Config {
|
||||||
|
mode: string;
|
||||||
|
enableTransitions: boolean;
|
||||||
|
translatableAttributes: string[];
|
||||||
|
}
|
||||||
|
|
||||||
|
export const config = {
|
||||||
|
translatableAttributes: TRANSLATABLE_ATTRS,
|
||||||
|
} as Config;
|
||||||
|
|
||||||
|
Object.defineProperty(config, "mode", {
|
||||||
|
get() {
|
||||||
|
return QWeb.dev ? "dev" : "prod";
|
||||||
|
},
|
||||||
|
set(mode: string) {
|
||||||
|
QWeb.dev = mode === "dev";
|
||||||
|
if (QWeb.dev) {
|
||||||
|
console.info(`Owl is running in 'dev' mode.
|
||||||
|
|
||||||
|
This is not suitable for production use.
|
||||||
|
See https://github.com/odoo/owl/blob/master/doc/reference/config.md#mode for more information.`);
|
||||||
|
}
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
Object.defineProperty(config, "enableTransitions", {
|
||||||
|
get() {
|
||||||
|
return QWeb.enableTransitions;
|
||||||
|
},
|
||||||
|
set(value: boolean) {
|
||||||
|
QWeb.enableTransitions = value;
|
||||||
|
},
|
||||||
|
});
|
||||||
+138
@@ -0,0 +1,138 @@
|
|||||||
|
import { Component } from "./component/component";
|
||||||
|
import { scheduler } from "./component/scheduler";
|
||||||
|
import { EventBus } from "./core/event_bus";
|
||||||
|
import { Observer } from "./core/observer";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The `Context` object provides a way to share data between an arbitrary number
|
||||||
|
* of component. Usually, data is passed from a parent to its children component,
|
||||||
|
* but when we have to deal with some mostly global information, this can be
|
||||||
|
* annoying, since each component will need to pass the information to each
|
||||||
|
* children, even though some or most of them will not use the information.
|
||||||
|
*
|
||||||
|
* With a `Context` object, each component can subscribe (with the `useContext`
|
||||||
|
* hook) to its state, and will be updated whenever the context state is updated.
|
||||||
|
*/
|
||||||
|
|
||||||
|
function partitionBy<T>(arr: T[], fn: (t: T) => boolean) {
|
||||||
|
let lastGroup: T[] | false = false;
|
||||||
|
let lastValue;
|
||||||
|
return arr.reduce((acc: T[][], cur) => {
|
||||||
|
let curVal = fn(cur);
|
||||||
|
if (lastGroup) {
|
||||||
|
if (curVal === lastValue) {
|
||||||
|
lastGroup.push(cur);
|
||||||
|
} else {
|
||||||
|
lastGroup = false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (!lastGroup) {
|
||||||
|
lastGroup = [cur];
|
||||||
|
acc.push(lastGroup);
|
||||||
|
}
|
||||||
|
lastValue = curVal;
|
||||||
|
return acc;
|
||||||
|
}, []);
|
||||||
|
}
|
||||||
|
|
||||||
|
export class Context extends EventBus {
|
||||||
|
state: any;
|
||||||
|
observer: Observer;
|
||||||
|
rev: number = 1;
|
||||||
|
// mapping from component id to last observed context id
|
||||||
|
mapping: { [componentId: number]: number } = {};
|
||||||
|
|
||||||
|
constructor(state: Object = {}) {
|
||||||
|
super();
|
||||||
|
this.observer = new Observer();
|
||||||
|
this.observer.notifyCB = () => {
|
||||||
|
// notify components in the next microtask tick to ensure that subscribers
|
||||||
|
// are notified only once for all changes that occur in the same micro tick
|
||||||
|
let rev = this.rev;
|
||||||
|
return Promise.resolve().then(() => {
|
||||||
|
if (rev === this.rev) {
|
||||||
|
this.__notifyComponents();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
};
|
||||||
|
this.state = this.observer.observe(state);
|
||||||
|
this.subscriptions.update = [];
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Instead of using trigger to emit an update event, we actually implement
|
||||||
|
* our own function to do that. The reason is that we need to be smarter than
|
||||||
|
* a simple trigger function: we need to wait for parent components to be
|
||||||
|
* done before doing children components. More precisely, if an update
|
||||||
|
* as an effect of destroying a children, we do not want to call any code
|
||||||
|
* from the child, and certainly not render it.
|
||||||
|
*
|
||||||
|
* This method implements a simple grouping algorithm by depth. If we have
|
||||||
|
* connected components of depths [2, 4,4,4,4, 3,8,8], the Context will notify
|
||||||
|
* them in the following groups: [2], [4,4,4,4], [3], [8,8]. Each group will
|
||||||
|
* be updated sequentially, but each components in a given group will be done in
|
||||||
|
* parallel.
|
||||||
|
*
|
||||||
|
* This is a very simple algorithm, but it avoids checking if a given
|
||||||
|
* component is a child of another.
|
||||||
|
*/
|
||||||
|
async __notifyComponents() {
|
||||||
|
const rev = ++this.rev;
|
||||||
|
const subscriptions = this.subscriptions.update;
|
||||||
|
const groups = partitionBy(subscriptions, (s) => (s.owner ? s.owner.__owl__.depth : -1));
|
||||||
|
for (let group of groups) {
|
||||||
|
const proms = group.map((sub) => sub.callback.call(sub.owner, rev));
|
||||||
|
// at this point, each component in the current group has registered a
|
||||||
|
// top level fiber in the scheduler. It could happen that rendering these
|
||||||
|
// components is done (if they have no children). This is why we manually
|
||||||
|
// flush the scheduler. This will force the scheduler to check
|
||||||
|
// immediately if they are done, which will cause their rendering
|
||||||
|
// promise to resolve earlier, which means that there is a chance of
|
||||||
|
// processing the next group in the same frame.
|
||||||
|
scheduler.flush();
|
||||||
|
await Promise.all(proms);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The`useContext` hook is the normal way for a component to register themselve
|
||||||
|
* to context state changes. The `useContext` method returns the context state
|
||||||
|
*/
|
||||||
|
export function useContext(ctx: Context): any {
|
||||||
|
const component: Component = Component.current!;
|
||||||
|
return useContextWithCB(ctx, component, component.render.bind(component));
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useContextWithCB(ctx: Context, component: Component, method): any {
|
||||||
|
const __owl__ = component.__owl__;
|
||||||
|
const id = __owl__.id;
|
||||||
|
const mapping = ctx.mapping;
|
||||||
|
if (id in mapping) {
|
||||||
|
return ctx.state;
|
||||||
|
}
|
||||||
|
if (!__owl__.observer) {
|
||||||
|
__owl__.observer = new Observer();
|
||||||
|
__owl__.observer.notifyCB = component.render.bind(component);
|
||||||
|
}
|
||||||
|
|
||||||
|
mapping[id] = 0;
|
||||||
|
const renderFn = __owl__.renderFn;
|
||||||
|
__owl__.renderFn = function (comp, params) {
|
||||||
|
mapping[id] = ctx.rev;
|
||||||
|
return renderFn(comp, params);
|
||||||
|
};
|
||||||
|
ctx.on("update", component, async (contextRev) => {
|
||||||
|
if (mapping[id] < contextRev) {
|
||||||
|
mapping[id] = contextRev;
|
||||||
|
await method();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
const __destroy = component.__destroy;
|
||||||
|
component.__destroy = (parent) => {
|
||||||
|
ctx.off("update", component);
|
||||||
|
delete mapping[id];
|
||||||
|
__destroy.call(component, parent);
|
||||||
|
};
|
||||||
|
return ctx.state;
|
||||||
|
}
|
||||||
@@ -0,0 +1,79 @@
|
|||||||
|
/**
|
||||||
|
* We define here a simple event bus: it can
|
||||||
|
* - emit events
|
||||||
|
* - add/remove listeners.
|
||||||
|
*
|
||||||
|
* This is a useful pattern of communication in many cases. For OWL, each
|
||||||
|
* components and stores are event buses.
|
||||||
|
*/
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Types
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export type Callback = (...args: any[]) => void;
|
||||||
|
|
||||||
|
export interface Subscription {
|
||||||
|
owner: any;
|
||||||
|
callback: Callback;
|
||||||
|
}
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// EventBus
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export class EventBus {
|
||||||
|
subscriptions: { [eventType: string]: Subscription[] } = {};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add a listener for the 'eventType' events.
|
||||||
|
*
|
||||||
|
* Note that the 'owner' of this event can be anything, but will more likely
|
||||||
|
* be a component or a class. The idea is that the callback will be called with
|
||||||
|
* the proper owner bound.
|
||||||
|
*
|
||||||
|
* Also, the owner should be kind of unique. This will be used to remove the
|
||||||
|
* listener.
|
||||||
|
*/
|
||||||
|
on(eventType: string, owner: any, callback: Callback) {
|
||||||
|
if (!callback) {
|
||||||
|
throw new Error("Missing callback");
|
||||||
|
}
|
||||||
|
if (!this.subscriptions[eventType]) {
|
||||||
|
this.subscriptions[eventType] = [];
|
||||||
|
}
|
||||||
|
this.subscriptions[eventType].push({
|
||||||
|
owner,
|
||||||
|
callback,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Remove a listener
|
||||||
|
*/
|
||||||
|
off(eventType: string, owner: any) {
|
||||||
|
const subs = this.subscriptions[eventType];
|
||||||
|
if (subs) {
|
||||||
|
this.subscriptions[eventType] = subs.filter((s) => s.owner !== owner);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Emit an event of type 'eventType'. Any extra arguments will be passed to
|
||||||
|
* the listeners callback.
|
||||||
|
*/
|
||||||
|
trigger(eventType: string, ...args: any[]) {
|
||||||
|
const subs = this.subscriptions[eventType] || [];
|
||||||
|
for (let i = 0, iLen = subs.length; i < iLen; i++) {
|
||||||
|
const sub = subs[i];
|
||||||
|
sub.callback.call(sub.owner, ...args);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Remove all subscriptions.
|
||||||
|
*/
|
||||||
|
clear() {
|
||||||
|
this.subscriptions = {};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,99 @@
|
|||||||
|
/**
|
||||||
|
* Owl Observer
|
||||||
|
*
|
||||||
|
* This code contains the logic that allows Owl to observe and react to state
|
||||||
|
* changes.
|
||||||
|
*
|
||||||
|
* This is a Observer class that can observe any JS values. The way it works
|
||||||
|
* can be summarized thusly:
|
||||||
|
* - primitive values are not observed at all
|
||||||
|
* - Objects and arrays are observed by replacing them with a Proxy
|
||||||
|
* - each object/array metadata are tracked in a weakmap, and keep a revision
|
||||||
|
* number
|
||||||
|
*
|
||||||
|
* Note that this code is loosely inspired by Vue.
|
||||||
|
*/
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Observer
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
export class Observer {
|
||||||
|
rev: number = 1;
|
||||||
|
allowMutations: boolean = true;
|
||||||
|
weakMap: WeakMap<any, any> = new WeakMap();
|
||||||
|
|
||||||
|
notifyCB() {}
|
||||||
|
|
||||||
|
observe<T>(value: T, parent?: any): T {
|
||||||
|
if (
|
||||||
|
value === null ||
|
||||||
|
typeof value !== "object" ||
|
||||||
|
value instanceof Date ||
|
||||||
|
value instanceof Promise
|
||||||
|
) {
|
||||||
|
// fun fact: typeof null === 'object'
|
||||||
|
return value;
|
||||||
|
}
|
||||||
|
let metadata = this.weakMap.get(value) || this._observe(value, parent);
|
||||||
|
return metadata.proxy;
|
||||||
|
}
|
||||||
|
|
||||||
|
revNumber(value): number {
|
||||||
|
const metadata = this.weakMap.get(value);
|
||||||
|
return metadata ? metadata.rev : 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
_observe(value, parent) {
|
||||||
|
var self = this;
|
||||||
|
|
||||||
|
const proxy = new Proxy(value, {
|
||||||
|
get(target, k) {
|
||||||
|
const targetValue = target[k];
|
||||||
|
return self.observe(targetValue, value);
|
||||||
|
},
|
||||||
|
set(target, key: string, newVal): boolean {
|
||||||
|
const value = target[key];
|
||||||
|
if (newVal !== value) {
|
||||||
|
if (!self.allowMutations) {
|
||||||
|
throw new Error(
|
||||||
|
`Observed state cannot be changed here! (key: "${key}", val: "${newVal}")`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
self._updateRevNumber(target);
|
||||||
|
target[key] = newVal;
|
||||||
|
self.notifyCB();
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
},
|
||||||
|
deleteProperty(target, key) {
|
||||||
|
if (key in target) {
|
||||||
|
delete target[key];
|
||||||
|
self._updateRevNumber(target);
|
||||||
|
self.notifyCB();
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
const metadata = {
|
||||||
|
value,
|
||||||
|
proxy,
|
||||||
|
rev: this.rev,
|
||||||
|
parent,
|
||||||
|
};
|
||||||
|
|
||||||
|
this.weakMap.set(value, metadata);
|
||||||
|
this.weakMap.set(metadata.proxy, metadata);
|
||||||
|
return metadata;
|
||||||
|
}
|
||||||
|
|
||||||
|
_updateRevNumber(target: any) {
|
||||||
|
this.rev++;
|
||||||
|
let metadata = this.weakMap.get(target);
|
||||||
|
let parent = target;
|
||||||
|
do {
|
||||||
|
metadata = this.weakMap.get(parent);
|
||||||
|
metadata.rev++;
|
||||||
|
} while ((parent = metadata.parent) && parent !== target);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
import { Component } from "../component/component";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* We define here OwlEvent, a subclass of CustomEvent, with an additional
|
||||||
|
* attribute:
|
||||||
|
* - originalComponent: the component that triggered the event
|
||||||
|
*/
|
||||||
|
|
||||||
|
export class OwlEvent<T> extends CustomEvent<T> {
|
||||||
|
originalComponent: Component;
|
||||||
|
constructor(component, eventType, options) {
|
||||||
|
super(eventType, options);
|
||||||
|
this.originalComponent = component;
|
||||||
|
}
|
||||||
|
}
|
||||||
+127
-64
@@ -1,6 +1,90 @@
|
|||||||
import type { Env } from "./app/app";
|
import { Component, Env } from "./component/component";
|
||||||
import { getCurrent } from "./component/component_node";
|
import { Observer } from "./core/observer";
|
||||||
import { onMounted, onPatched, onWillUnmount } from "./component/lifecycle_hooks";
|
|
||||||
|
/**
|
||||||
|
* Owl Hook System
|
||||||
|
*
|
||||||
|
* This file introduces the concept of hooks, similar to React or Vue hooks.
|
||||||
|
* We have currently an implementation of:
|
||||||
|
* - useState (reactive state)
|
||||||
|
* - onMounted
|
||||||
|
* - onWillUnmount
|
||||||
|
* - useRef
|
||||||
|
*/
|
||||||
|
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
// useState
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This is the main way a component can be made reactive. The useState hook
|
||||||
|
* will return an observed object (or array). Changes to that value will then
|
||||||
|
* trigger a rerendering of the current component.
|
||||||
|
*/
|
||||||
|
export function useState<T>(state: T): T {
|
||||||
|
const component: Component = Component.current!;
|
||||||
|
const __owl__ = component.__owl__;
|
||||||
|
if (!__owl__.observer) {
|
||||||
|
__owl__.observer = new Observer();
|
||||||
|
__owl__.observer.notifyCB = component.render.bind(component);
|
||||||
|
}
|
||||||
|
return __owl__.observer.observe(state);
|
||||||
|
}
|
||||||
|
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
// Life cycle hooks
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
function makeLifecycleHook(method: string, reverse: boolean = false) {
|
||||||
|
if (reverse) {
|
||||||
|
return function (cb) {
|
||||||
|
const component: Component = Component.current!;
|
||||||
|
if (component.__owl__[method]) {
|
||||||
|
const current = component.__owl__[method];
|
||||||
|
component.__owl__[method] = function () {
|
||||||
|
current.call(component);
|
||||||
|
cb.call(component);
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
component.__owl__[method] = cb;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
return function (cb) {
|
||||||
|
const component: Component = Component.current!;
|
||||||
|
if (component.__owl__[method]) {
|
||||||
|
const current = component.__owl__[method];
|
||||||
|
component.__owl__[method] = function () {
|
||||||
|
cb.call(component);
|
||||||
|
current.call(component);
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
component.__owl__[method] = cb;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function makeAsyncHook(method: string) {
|
||||||
|
return function (cb) {
|
||||||
|
const component: Component = Component.current!;
|
||||||
|
if (component.__owl__[method]) {
|
||||||
|
const current = component.__owl__[method];
|
||||||
|
component.__owl__[method] = function (...args) {
|
||||||
|
return Promise.all([current.call(component, ...args), cb.call(component, ...args)]);
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
component.__owl__[method] = cb;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export const onMounted = makeLifecycleHook("mountedCB", true);
|
||||||
|
export const onWillUnmount = makeLifecycleHook("willUnmountCB");
|
||||||
|
export const onWillPatch = makeLifecycleHook("willPatchCB");
|
||||||
|
export const onPatched = makeLifecycleHook("patchedCB", true);
|
||||||
|
|
||||||
|
export const onWillStart = makeAsyncHook("willStartCB");
|
||||||
|
export const onWillUpdateProps = makeAsyncHook("willUpdatePropsCB");
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
// -----------------------------------------------------------------------------
|
||||||
// useRef
|
// useRef
|
||||||
@@ -10,83 +94,62 @@ import { onMounted, onPatched, onWillUnmount } from "./component/lifecycle_hooks
|
|||||||
* The purpose of this hook is to allow components to get a reference to a sub
|
* The purpose of this hook is to allow components to get a reference to a sub
|
||||||
* html node or component.
|
* html node or component.
|
||||||
*/
|
*/
|
||||||
export function useRef<T extends HTMLElement = HTMLElement>(name: string): { el: T | null } {
|
interface Ref<C extends Component = Component> {
|
||||||
const node = getCurrent()!;
|
el: HTMLElement | null;
|
||||||
const refs = node.refs;
|
comp: C | null;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useRef<C extends Component = Component>(name: string): Ref<C> {
|
||||||
|
const __owl__ = Component.current!.__owl__;
|
||||||
return {
|
return {
|
||||||
get el(): T | null {
|
get el(): HTMLElement | null {
|
||||||
return refs[name] || null;
|
const val = __owl__.refs && __owl__.refs[name];
|
||||||
|
if (val instanceof HTMLElement) {
|
||||||
|
return val;
|
||||||
|
} else if (val instanceof Component) {
|
||||||
|
return val.el;
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
},
|
||||||
|
get comp(): C | null {
|
||||||
|
const val = __owl__.refs && __owl__.refs[name];
|
||||||
|
return val instanceof Component ? (val as C) : null;
|
||||||
},
|
},
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
// -----------------------------------------------------------------------------
|
||||||
// useEnv and useSubEnv
|
// "Builder" hooks
|
||||||
// -----------------------------------------------------------------------------
|
// -----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This hook is useful as a building block for some customized hooks, that may
|
||||||
|
* need a reference to the component calling them.
|
||||||
|
*/
|
||||||
|
export function useComponent<P, E extends Env>(): Component<P, E> {
|
||||||
|
return Component.current as any;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* This hook is useful as a building block for some customized hooks, that may
|
* This hook is useful as a building block for some customized hooks, that may
|
||||||
* need a reference to the env of the component calling them.
|
* need a reference to the env of the component calling them.
|
||||||
*/
|
*/
|
||||||
export function useEnv<E extends Env>(): E {
|
export function useEnv<E extends Env>(): E {
|
||||||
return getCurrent()!.component.env as any;
|
return Component.current.env as any;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
// useSubEnv
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* This hook is a simple way to let components use a sub environment. Note that
|
* This hook is a simple way to let components use a sub environment. Note that
|
||||||
* like for all hooks, it is important that this is only called in the
|
* like for all hooks, it is important that this is only called in the
|
||||||
* constructor method.
|
* constructor method.
|
||||||
*/
|
*/
|
||||||
export function useSubEnv(envExtension: Env) {
|
export function useSubEnv(nextEnv) {
|
||||||
const node = getCurrent()!;
|
const component = Component.current!;
|
||||||
const env = Object.create(node.childEnv);
|
component.env = Object.assign(Object.create(component.env), nextEnv);
|
||||||
const descrs = Object.getOwnPropertyDescriptors(envExtension);
|
|
||||||
node.childEnv = Object.freeze(Object.defineProperties(env, descrs));
|
|
||||||
}
|
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
// useEffect
|
|
||||||
// -----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
const NO_OP = () => {};
|
|
||||||
/**
|
|
||||||
* @param {...any} dependencies the dependencies computed by computeDependencies
|
|
||||||
* @returns {void|(()=>void)} a cleanup function that reverses the side
|
|
||||||
* effects of the effect callback.
|
|
||||||
*/
|
|
||||||
type Effect = (...dependencies: any[]) => void | (() => void);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* This hook will run a callback when a component is mounted and patched, and
|
|
||||||
* will run a cleanup function before patching and before unmounting the
|
|
||||||
* the component.
|
|
||||||
*
|
|
||||||
* @param {Effect} effect the effect to run on component mount and/or patch
|
|
||||||
* @param {()=>any[]} [computeDependencies=()=>[NaN]] a callback to compute
|
|
||||||
* dependencies that will decide if the effect needs to be cleaned up and
|
|
||||||
* run again. If the dependencies did not change, the effect will not run
|
|
||||||
* again. The default value returns an array containing only NaN because
|
|
||||||
* NaN !== NaN, which will cause the effect to rerun on every patch.
|
|
||||||
*/
|
|
||||||
export function useEffect(effect: Effect, computeDependencies: () => any[] = () => [NaN]) {
|
|
||||||
let cleanup: () => void;
|
|
||||||
let dependencies: any[];
|
|
||||||
onMounted(() => {
|
|
||||||
dependencies = computeDependencies();
|
|
||||||
cleanup = effect(...dependencies) || NO_OP;
|
|
||||||
});
|
|
||||||
|
|
||||||
onPatched(() => {
|
|
||||||
const newDeps = computeDependencies();
|
|
||||||
const shouldReapply = newDeps.some((val, i) => val !== dependencies[i]);
|
|
||||||
if (shouldReapply) {
|
|
||||||
dependencies = newDeps;
|
|
||||||
cleanup();
|
|
||||||
cleanup = effect(...dependencies) || NO_OP;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
onWillUnmount(() => cleanup());
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// -----------------------------------------------------------------------------
|
// -----------------------------------------------------------------------------
|
||||||
@@ -109,11 +172,11 @@ export function useEffect(effect: Effect, computeDependencies: () => any[] = ()
|
|||||||
export function useExternalListener(
|
export function useExternalListener(
|
||||||
target: HTMLElement | typeof window,
|
target: HTMLElement | typeof window,
|
||||||
eventName: string,
|
eventName: string,
|
||||||
handler: EventListener,
|
handler,
|
||||||
eventParams?: AddEventListenerOptions
|
eventParams?
|
||||||
) {
|
) {
|
||||||
const node = getCurrent()!;
|
const boundHandler = handler.bind(Component.current);
|
||||||
const boundHandler = handler.bind(node.component);
|
|
||||||
onMounted(() => target.addEventListener(eventName, boundHandler, eventParams));
|
onMounted(() => target.addEventListener(eventName, boundHandler, eventParams));
|
||||||
onWillUnmount(() => target.removeEventListener(eventName, boundHandler, eventParams));
|
onWillUnmount(() => target.removeEventListener(eventName, boundHandler, eventParams));
|
||||||
}
|
}
|
||||||
|
|||||||
+38
-54
@@ -1,58 +1,42 @@
|
|||||||
import {
|
/**
|
||||||
config,
|
* This file is the main file packaged by rollup (see rollup.config.js). From
|
||||||
createBlock,
|
* this file, we export all public owl elements.
|
||||||
html,
|
*
|
||||||
list,
|
* Note that dynamic values, such as a date or a commit hash are added by rollup
|
||||||
mount as blockMount,
|
*/
|
||||||
multi,
|
import { EventBus } from "./core/event_bus";
|
||||||
patch,
|
import { Observer } from "./core/observer";
|
||||||
remove,
|
import { QWeb } from "./qweb/index";
|
||||||
text,
|
import { config } from "./config";
|
||||||
toggler,
|
import * as _store from "./store";
|
||||||
comment,
|
import * as _utils from "./utils";
|
||||||
} from "./blockdom";
|
import * as _tags from "./tags";
|
||||||
import { mainEventHandler } from "./component/handler";
|
import { AsyncRoot } from "./misc/async_root";
|
||||||
|
import { Portal } from "./misc/portal";
|
||||||
|
import * as _hooks from "./hooks";
|
||||||
|
import * as _context from "./context";
|
||||||
|
import { Link } from "./router/link";
|
||||||
|
import { RouteComponent } from "./router/route_component";
|
||||||
|
import { Router } from "./router/router";
|
||||||
|
|
||||||
config.shouldNormalizeDom = false;
|
export { Component, mount } from "./component/component";
|
||||||
config.mainEventHandler = mainEventHandler;
|
export { QWeb };
|
||||||
|
export { config };
|
||||||
|
export { browser } from "./browser";
|
||||||
|
|
||||||
export const blockDom = {
|
export const Context = _context.Context;
|
||||||
config,
|
export const useState = _hooks.useState;
|
||||||
// bdom entry points
|
export const core = { EventBus, Observer };
|
||||||
mount: blockMount,
|
export const router = { Router, RouteComponent, Link };
|
||||||
patch,
|
export const Store = _store.Store;
|
||||||
remove,
|
export const utils = _utils;
|
||||||
// bdom block types
|
export const tags = _tags;
|
||||||
list,
|
export const misc = { AsyncRoot, Portal };
|
||||||
multi,
|
export const hooks = Object.assign({}, _hooks, {
|
||||||
text,
|
useContext: _context.useContext,
|
||||||
toggler,
|
useDispatch: _store.useDispatch,
|
||||||
createBlock,
|
useGetters: _store.useGetters,
|
||||||
html,
|
useStore: _store.useStore,
|
||||||
comment,
|
});
|
||||||
};
|
|
||||||
|
|
||||||
export { App, mount } from "./app/app";
|
|
||||||
export { Component } from "./component/component";
|
|
||||||
export { useComponent } from "./component/component_node";
|
|
||||||
export { status } from "./component/status";
|
|
||||||
export { Portal } from "./portal";
|
|
||||||
export { Memo } from "./memo";
|
|
||||||
export { xml } from "./app/template_set";
|
|
||||||
export { useState, reactive } from "./reactivity";
|
|
||||||
export { useEffect, useEnv, useExternalListener, useRef, useSubEnv } from "./hooks";
|
|
||||||
export { EventBus, whenReady, loadFile, markup } from "./utils";
|
|
||||||
export {
|
|
||||||
onWillStart,
|
|
||||||
onMounted,
|
|
||||||
onWillUnmount,
|
|
||||||
onWillUpdateProps,
|
|
||||||
onWillPatch,
|
|
||||||
onPatched,
|
|
||||||
onWillRender,
|
|
||||||
onRendered,
|
|
||||||
onWillDestroy,
|
|
||||||
onError,
|
|
||||||
} from "./component/lifecycle_hooks";
|
|
||||||
|
|
||||||
export const __info__ = {};
|
export const __info__ = {};
|
||||||
|
|||||||
-47
@@ -1,47 +0,0 @@
|
|||||||
import { Component } from "./component/component";
|
|
||||||
import type { ComponentNode } from "./component/component_node";
|
|
||||||
import { xml } from "./app/template_set";
|
|
||||||
import { Fiber } from "./component/fibers";
|
|
||||||
|
|
||||||
export class Memo extends Component {
|
|
||||||
static template = xml`<t t-slot="default"/>`;
|
|
||||||
|
|
||||||
constructor(props: any, env: any, node: ComponentNode) {
|
|
||||||
super(props, env, node);
|
|
||||||
|
|
||||||
// prevent patching process conditionally
|
|
||||||
let applyPatch = false;
|
|
||||||
const patchFn = node.patch;
|
|
||||||
node.patch = () => {
|
|
||||||
if (applyPatch) {
|
|
||||||
patchFn.call(node);
|
|
||||||
applyPatch = false;
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
// check props change, and render/apply patch if it changed
|
|
||||||
let prevProps = props;
|
|
||||||
const updateAndRender = node.updateAndRender;
|
|
||||||
node.updateAndRender = function (props: any, parentFiber: Fiber) {
|
|
||||||
const shouldUpdate = !shallowEqual(prevProps, props);
|
|
||||||
if (shouldUpdate) {
|
|
||||||
prevProps = props;
|
|
||||||
updateAndRender.call(node, props, parentFiber);
|
|
||||||
applyPatch = true;
|
|
||||||
}
|
|
||||||
return Promise.resolve();
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* we assume that each object have the same set of keys
|
|
||||||
*/
|
|
||||||
function shallowEqual(p1: any, p2: any): boolean {
|
|
||||||
for (let k in p1) {
|
|
||||||
if (k !== "slots" && p1[k] !== p2[k]) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
import { Component } from "../component/component";
|
||||||
|
import { xml } from "../tags";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* AsyncRoot
|
||||||
|
*
|
||||||
|
* Owl is by default asynchronous, and the user interface will wait for all its
|
||||||
|
* subcomponents to be rendered before updating the DOM. This is most of the
|
||||||
|
* time what we want, but in some cases, it makes sense to "detach" a component
|
||||||
|
* from this coordination. This is the goal of the AsyncRoot component.
|
||||||
|
*/
|
||||||
|
|
||||||
|
export class AsyncRoot extends Component {
|
||||||
|
static template = xml`<t t-slot="default"/>`;
|
||||||
|
|
||||||
|
async __updateProps(nextProps, parentFiber) {
|
||||||
|
this.render(parentFiber.force);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,171 @@
|
|||||||
|
import { Component, portalSymbol } from "../component/component";
|
||||||
|
import { VNode, patch } from "../vdom/index";
|
||||||
|
import { xml } from "../tags";
|
||||||
|
import { OwlEvent } from "../core/owl_event";
|
||||||
|
import { useSubEnv } from "../hooks";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Portal
|
||||||
|
*
|
||||||
|
* The Portal component allows to render a part of a component outside it's DOM.
|
||||||
|
* It is for example useful for dialogs: for css reasons, dialogs are in general
|
||||||
|
* placed in a specific spot of the DOM (e.g. directly in the body). With the
|
||||||
|
* Portal, a component can conditionally specify in its tempate that it contains
|
||||||
|
* a dialog, and where this dialog should be inserted in the DOM.
|
||||||
|
*
|
||||||
|
* The Portal component ensures that the communication between the content of
|
||||||
|
* the Portal and its parent properly works: business events reaching the Portal
|
||||||
|
* are re-triggered on an empty <portal> node located in the parent's DOM.
|
||||||
|
*/
|
||||||
|
|
||||||
|
interface Props {
|
||||||
|
target: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class Portal extends Component<Props> {
|
||||||
|
static template = xml`<portal><t t-slot="default"/></portal>`;
|
||||||
|
static props = {
|
||||||
|
target: {
|
||||||
|
type: String,
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
// boolean to indicate whether or not we must listen to 'dom-appended' event
|
||||||
|
// to hook on the moment when the target is inserted into the DOM (because it
|
||||||
|
// is not when the portal is rendered)
|
||||||
|
doTargetLookUp: boolean = true;
|
||||||
|
// set of encountered events that need to be redirected
|
||||||
|
_handledEvents: Set<string> = new Set();
|
||||||
|
// function that will be the event's tunnel (needs to be an arrow function to
|
||||||
|
// avoid having to rebind `this`)
|
||||||
|
_handlerTunnel: (f: OwlEvent<any>) => void = (ev: OwlEvent<any>) => {
|
||||||
|
ev.stopPropagation();
|
||||||
|
this.__trigger(ev.originalComponent, ev.type, ev.detail);
|
||||||
|
};
|
||||||
|
// Storing the parent's env
|
||||||
|
parentEnv: any = null;
|
||||||
|
// represents the element that is moved somewhere else
|
||||||
|
portal: VNode | null = null;
|
||||||
|
// the target where we will move `portal`
|
||||||
|
target: Element | null = null;
|
||||||
|
|
||||||
|
constructor(parent, props) {
|
||||||
|
super(parent, props);
|
||||||
|
this.parentEnv = parent ? parent.env : {};
|
||||||
|
// put a callback in the env that is propagated to children s.t. portal can
|
||||||
|
// register an handler to those events just before children will trigger them
|
||||||
|
useSubEnv({
|
||||||
|
[portalSymbol]: (ev) => {
|
||||||
|
if (!this._handledEvents.has(ev.type)) {
|
||||||
|
this.portal!.elm!.addEventListener(ev.type, this._handlerTunnel);
|
||||||
|
this._handledEvents.add(ev.type);
|
||||||
|
}
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Override to revert back to a classic Component's structure
|
||||||
|
*
|
||||||
|
* @override
|
||||||
|
*/
|
||||||
|
__callWillUnmount() {
|
||||||
|
super.__callWillUnmount();
|
||||||
|
this.el!.appendChild(this.portal!.elm!);
|
||||||
|
this.doTargetLookUp = true;
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* At each DOM change, we must ensure that the portal contains exactly one
|
||||||
|
* child
|
||||||
|
*/
|
||||||
|
__checkVNodeStructure(vnode: VNode) {
|
||||||
|
const children = vnode.children!;
|
||||||
|
let countRealNodes = 0;
|
||||||
|
for (let child of children) {
|
||||||
|
if ((child as VNode).sel) {
|
||||||
|
countRealNodes++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (countRealNodes !== 1) {
|
||||||
|
throw new Error(`Portal must have exactly one non-text child (has ${countRealNodes})`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Ensure the target is still there at whichever time we render
|
||||||
|
*/
|
||||||
|
__checkTargetPresence() {
|
||||||
|
if (!this.target || !document.contains(this.target)) {
|
||||||
|
throw new Error(`Could not find any match for "${this.props.target}"`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Move the portal's element to the target
|
||||||
|
*/
|
||||||
|
__deployPortal() {
|
||||||
|
this.__checkTargetPresence();
|
||||||
|
this.target!.appendChild(this.portal!.elm!);
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Override to remove from the DOM the element we have teleported
|
||||||
|
*
|
||||||
|
* @override
|
||||||
|
*/
|
||||||
|
__destroy(parent) {
|
||||||
|
if (this.portal && this.portal.elm) {
|
||||||
|
const displacedElm = this.portal.elm!;
|
||||||
|
const parent = displacedElm.parentNode;
|
||||||
|
if (parent) {
|
||||||
|
parent.removeChild(displacedElm);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
super.__destroy(parent);
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Override to patch the element that has been teleported
|
||||||
|
*
|
||||||
|
* @override
|
||||||
|
*/
|
||||||
|
__patch(target, vnode) {
|
||||||
|
if (this.doTargetLookUp) {
|
||||||
|
const target = document.querySelector(this.props.target);
|
||||||
|
if (!target) {
|
||||||
|
this.env.qweb.on("dom-appended", this, () => {
|
||||||
|
this.doTargetLookUp = false;
|
||||||
|
this.env.qweb.off("dom-appended", this);
|
||||||
|
this.target = document.querySelector(this.props.target);
|
||||||
|
this.__deployPortal();
|
||||||
|
});
|
||||||
|
} else {
|
||||||
|
this.doTargetLookUp = false;
|
||||||
|
this.target = target;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
this.__checkVNodeStructure(vnode);
|
||||||
|
const shouldDeploy =
|
||||||
|
(!this.portal || this.el!.contains(this.portal.elm!)) && !this.doTargetLookUp;
|
||||||
|
|
||||||
|
if (!this.doTargetLookUp && !shouldDeploy) {
|
||||||
|
// Only on pure patching, provided the
|
||||||
|
// this.target's parent has not been unmounted
|
||||||
|
this.__checkTargetPresence();
|
||||||
|
}
|
||||||
|
|
||||||
|
const portalPatch = this.portal ? this.portal : document.createElement(vnode.children[0].sel);
|
||||||
|
this.portal = patch(portalPatch, vnode.children![0] as VNode);
|
||||||
|
vnode.children = [];
|
||||||
|
|
||||||
|
super.__patch(target, vnode);
|
||||||
|
|
||||||
|
if (shouldDeploy) {
|
||||||
|
this.__deployPortal();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Override to set the env
|
||||||
|
*/
|
||||||
|
__trigger(component: Component, eventType: string, payload?: any) {
|
||||||
|
const env = this.env;
|
||||||
|
this.env = this.parentEnv;
|
||||||
|
super.__trigger(component, eventType, payload);
|
||||||
|
this.env = env;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,71 +0,0 @@
|
|||||||
import type { ComponentNode } from "./component/component_node";
|
|
||||||
import { Component } from "./component/component";
|
|
||||||
import { xml } from "./app/template_set";
|
|
||||||
import { BDom, text, VNode } from "./blockdom";
|
|
||||||
|
|
||||||
const VText: any = text("").constructor;
|
|
||||||
|
|
||||||
class VPortal extends VText implements Partial<VNode<VPortal>> {
|
|
||||||
// selector: string;
|
|
||||||
realBDom: BDom | null;
|
|
||||||
target: HTMLElement | null = null;
|
|
||||||
|
|
||||||
constructor(selector: string, realBDom: BDom) {
|
|
||||||
super("");
|
|
||||||
this.selector = selector;
|
|
||||||
this.realBDom = realBDom;
|
|
||||||
}
|
|
||||||
mount(parent: HTMLElement, anchor: ChildNode) {
|
|
||||||
super.mount(parent, anchor);
|
|
||||||
this.target = document.querySelector(this.selector) as any;
|
|
||||||
if (!this.target) {
|
|
||||||
let el: any = this.el;
|
|
||||||
while (el && el.parentElement instanceof HTMLElement) {
|
|
||||||
el = el.parentElement;
|
|
||||||
}
|
|
||||||
this.target = el && el.querySelector(this.selector);
|
|
||||||
if (!this.target) {
|
|
||||||
throw new Error("invalid portal target");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
this.realBDom!.mount(this.target!, null);
|
|
||||||
}
|
|
||||||
|
|
||||||
beforeRemove() {
|
|
||||||
this.realBDom!.beforeRemove();
|
|
||||||
}
|
|
||||||
remove() {
|
|
||||||
super.remove();
|
|
||||||
this.realBDom!.remove();
|
|
||||||
this.realBDom = null;
|
|
||||||
}
|
|
||||||
|
|
||||||
patch(other: VPortal) {
|
|
||||||
super.patch(other);
|
|
||||||
if (this.realBDom) {
|
|
||||||
this.realBDom.patch(other.realBDom!, true);
|
|
||||||
} else {
|
|
||||||
this.realBDom = other.realBDom;
|
|
||||||
this.realBDom!.mount(this.target!, null);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export class Portal extends Component {
|
|
||||||
static template = xml`<t t-slot="default"/>`;
|
|
||||||
static props = {
|
|
||||||
target: {
|
|
||||||
type: String,
|
|
||||||
},
|
|
||||||
slots: true,
|
|
||||||
};
|
|
||||||
|
|
||||||
constructor(props: any, env: any, node: ComponentNode) {
|
|
||||||
super(props, env, node);
|
|
||||||
node._render = function (fiber: any) {
|
|
||||||
const bdom = new VPortal(props.target, this.renderFn());
|
|
||||||
fiber.bdom = bdom;
|
|
||||||
fiber.root.counter--;
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,442 @@
|
|||||||
|
import { CompilationContext, INTERP_REGEXP } from "./compilation_context";
|
||||||
|
import { QWeb } from "./qweb";
|
||||||
|
import { htmlToVDOM } from "../vdom/html_to_vdom";
|
||||||
|
import { QWebVar } from "./expression_parser";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Owl QWeb Directives
|
||||||
|
*
|
||||||
|
* This file contains the implementation of most standard QWeb directives:
|
||||||
|
* - t-esc
|
||||||
|
* - t-raw
|
||||||
|
* - t-set/t-value
|
||||||
|
* - t-if/t-elif/t-else
|
||||||
|
* - t-call
|
||||||
|
* - t-foreach/t-as
|
||||||
|
* - t-debug
|
||||||
|
* - t-log
|
||||||
|
*/
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-esc and t-raw
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.utils.htmlToVDOM = htmlToVDOM;
|
||||||
|
|
||||||
|
function compileValueNode(value: any, node: Element, qweb: QWeb, ctx: CompilationContext) {
|
||||||
|
ctx.rootContext.shouldDefineScope = true;
|
||||||
|
if (value === "0") {
|
||||||
|
if (ctx.parentNode) {
|
||||||
|
// the 'zero' magical symbol is where we can find the result of the rendering
|
||||||
|
// of the body of the t-call.
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
const zeroArgs = ctx.escaping
|
||||||
|
? `{text: utils.vDomToString(scope[utils.zero])}`
|
||||||
|
: `...scope[utils.zero]`;
|
||||||
|
ctx.addLine(`c${ctx.parentNode}.push(${zeroArgs});`);
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
let exprID: string;
|
||||||
|
if (typeof value === "string") {
|
||||||
|
exprID = `_${ctx.generateID()}`;
|
||||||
|
ctx.addLine(`let ${exprID} = ${ctx.formatExpression(value)};`);
|
||||||
|
} else {
|
||||||
|
exprID = `scope.${value.id}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
let protectID;
|
||||||
|
if (value.hasBody) {
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
protectID = ctx.startProtectScope();
|
||||||
|
ctx.addLine(
|
||||||
|
`${exprID} = ${exprID} instanceof utils.VDomArray ? utils.vDomToString(${exprID}) : ${exprID};`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if (node.childNodes.length) {
|
||||||
|
// ctx.addLine(`c${ctx.parentNode}.push(...vnodeArray);`);
|
||||||
|
ctx.addIf(`!${exprID}`);
|
||||||
|
// if (node.childNodes.length) {
|
||||||
|
// ctx.addElse();
|
||||||
|
qweb._compileChildren(node, ctx);
|
||||||
|
// }
|
||||||
|
|
||||||
|
ctx.closeIf();
|
||||||
|
}
|
||||||
|
if (ctx.parentTextNode) {
|
||||||
|
ctx.addIf(`${exprID} != null`);
|
||||||
|
ctx.addLine(`vn${ctx.parentTextNode}.text += ${exprID};`);
|
||||||
|
ctx.closeIf();
|
||||||
|
} else if (ctx.parentNode) {
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
ctx.addLine(`insertValue(c${ctx.parentNode}, ${exprID})`);
|
||||||
|
} else {
|
||||||
|
ctx.addIf(`${exprID} != null`);
|
||||||
|
|
||||||
|
let nodeID = ctx.generateID();
|
||||||
|
ctx.rootContext.rootNode = nodeID;
|
||||||
|
ctx.rootContext.parentTextNode = nodeID;
|
||||||
|
ctx.addLine(`let vn${nodeID} = {text: ${exprID}};`);
|
||||||
|
if (ctx.rootContext.shouldDefineResult) {
|
||||||
|
ctx.addLine(`result = vn${nodeID}`);
|
||||||
|
}
|
||||||
|
ctx.closeIf();
|
||||||
|
}
|
||||||
|
if (value.hasBody) {
|
||||||
|
ctx.stopProtectScope(protectID);
|
||||||
|
}
|
||||||
|
|
||||||
|
// ctx.addIf(`${exprID} != null`);
|
||||||
|
|
||||||
|
// if (ctx.escaping) {
|
||||||
|
// let protectID;
|
||||||
|
// if (value.hasBody) {
|
||||||
|
// ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
// protectID = ctx.startProtectScope();
|
||||||
|
// ctx.addLine(
|
||||||
|
// `${exprID} = ${exprID} instanceof utils.VDomArray ? utils.vDomToString(${exprID}) : ${exprID};`
|
||||||
|
// );
|
||||||
|
// }
|
||||||
|
// if (ctx.parentTextNode) {
|
||||||
|
// ctx.addLine(`vn${ctx.parentTextNode}.text += ${exprID};`);
|
||||||
|
// } else if (ctx.parentNode) {
|
||||||
|
// ctx.addLine(`c${ctx.parentNode}.push({text: ${exprID}});`);
|
||||||
|
// } else {
|
||||||
|
// let nodeID = ctx.generateID();
|
||||||
|
// ctx.rootContext.rootNode = nodeID;
|
||||||
|
// ctx.rootContext.parentTextNode = nodeID;
|
||||||
|
// ctx.addLine(`let vn${nodeID} = {text: ${exprID}};`);
|
||||||
|
// if (ctx.rootContext.shouldDefineResult) {
|
||||||
|
// ctx.addLine(`result = vn${nodeID}`);
|
||||||
|
// }
|
||||||
|
// }
|
||||||
|
// if (value.hasBody) {
|
||||||
|
// ctx.stopProtectScope(protectID);
|
||||||
|
// }
|
||||||
|
// } else {
|
||||||
|
// ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
// if (value.hasBody) {
|
||||||
|
// ctx.addLine(
|
||||||
|
// `const vnodeArray = ${exprID} instanceof utils.VDomArray ? ${exprID} : utils.htmlToVDOM(${exprID});`
|
||||||
|
// );
|
||||||
|
// ctx.addLine(`c${ctx.parentNode}.push(...vnodeArray);`);
|
||||||
|
// } else {
|
||||||
|
// ctx.addLine(`c${ctx.parentNode}.push(...utils.htmlToVDOM(${exprID}));`);
|
||||||
|
// }
|
||||||
|
// }
|
||||||
|
|
||||||
|
// ctx.closeIf();
|
||||||
|
}
|
||||||
|
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "esc",
|
||||||
|
priority: 70,
|
||||||
|
atNodeEncounter({ node, qweb, ctx }): boolean {
|
||||||
|
let value = ctx.getValue(node.getAttribute("t-esc")!);
|
||||||
|
compileValueNode(value, node, qweb, ctx.subContext("escaping", true));
|
||||||
|
return true;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "out",
|
||||||
|
priority: 70,
|
||||||
|
atNodeEncounter({ node, qweb, ctx }): boolean {
|
||||||
|
let value = ctx.getValue(node.getAttribute("t-out")!);
|
||||||
|
compileValueNode(value, node, qweb, ctx.subContext("escaping", true));
|
||||||
|
return true;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "raw",
|
||||||
|
priority: 80,
|
||||||
|
atNodeEncounter({ node, qweb, ctx }): boolean {
|
||||||
|
let value = ctx.getValue(node.getAttribute("t-raw")!);
|
||||||
|
compileValueNode(value, node, qweb, ctx);
|
||||||
|
return true;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-set
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "set",
|
||||||
|
extraNames: ["value"],
|
||||||
|
priority: 60,
|
||||||
|
atNodeEncounter({ node, qweb, ctx }): boolean {
|
||||||
|
ctx.rootContext.shouldDefineScope = true;
|
||||||
|
const variable = node.getAttribute("t-set")!;
|
||||||
|
let value = node.getAttribute("t-value")!;
|
||||||
|
ctx.variables[variable] = ctx.variables[variable] || ({} as QWebVar);
|
||||||
|
let qwebvar = ctx.variables[variable];
|
||||||
|
const hasBody = node.hasChildNodes();
|
||||||
|
|
||||||
|
qwebvar.id = variable;
|
||||||
|
qwebvar.expr = `scope.${variable}`;
|
||||||
|
if (value) {
|
||||||
|
const formattedValue = ctx.formatExpression(value);
|
||||||
|
let scopeExpr = `scope`;
|
||||||
|
if (ctx.protectedScopeNumber) {
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
scopeExpr = `utils.getScope(scope, '${variable}')`;
|
||||||
|
}
|
||||||
|
ctx.addLine(`${scopeExpr}.${variable} = ${formattedValue};`);
|
||||||
|
qwebvar.value = formattedValue;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (hasBody) {
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
if (value) {
|
||||||
|
ctx.addIf(`!(${qwebvar.expr})`);
|
||||||
|
}
|
||||||
|
const tempParentNodeID = ctx.generateID();
|
||||||
|
const _parentNode = ctx.parentNode;
|
||||||
|
ctx.parentNode = tempParentNodeID;
|
||||||
|
|
||||||
|
ctx.addLine(`let c${tempParentNodeID} = new utils.VDomArray();`);
|
||||||
|
const nodeCopy = node.cloneNode(true) as Element;
|
||||||
|
for (let attr of ["t-set", "t-value", "t-if", "t-else", "t-elif"]) {
|
||||||
|
nodeCopy.removeAttribute(attr);
|
||||||
|
}
|
||||||
|
qweb._compileNode(nodeCopy, ctx);
|
||||||
|
|
||||||
|
ctx.addLine(`${qwebvar.expr} = c${tempParentNodeID}`);
|
||||||
|
qwebvar.value = `c${tempParentNodeID}`;
|
||||||
|
qwebvar.hasBody = true;
|
||||||
|
|
||||||
|
ctx.parentNode = _parentNode;
|
||||||
|
if (value) {
|
||||||
|
ctx.closeIf();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-if, t-elif, t-else
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "if",
|
||||||
|
priority: 20,
|
||||||
|
atNodeEncounter({ node, ctx }): boolean {
|
||||||
|
let cond = ctx.getValue(node.getAttribute("t-if")!);
|
||||||
|
ctx.addIf(typeof cond === "string" ? ctx.formatExpression(cond) : `scope.${cond.id!}`);
|
||||||
|
return false;
|
||||||
|
},
|
||||||
|
finalize({ ctx }) {
|
||||||
|
ctx.closeIf();
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "elif",
|
||||||
|
priority: 30,
|
||||||
|
atNodeEncounter({ node, ctx }): boolean {
|
||||||
|
let cond = ctx.getValue(node.getAttribute("t-elif")!);
|
||||||
|
ctx.addLine(
|
||||||
|
`else if (${typeof cond === "string" ? ctx.formatExpression(cond) : `scope.${cond.id}`}) {`
|
||||||
|
);
|
||||||
|
ctx.indent();
|
||||||
|
return false;
|
||||||
|
},
|
||||||
|
finalize({ ctx }) {
|
||||||
|
ctx.closeIf();
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "else",
|
||||||
|
priority: 40,
|
||||||
|
atNodeEncounter({ ctx }): boolean {
|
||||||
|
ctx.addLine(`else {`);
|
||||||
|
ctx.indent();
|
||||||
|
return false;
|
||||||
|
},
|
||||||
|
finalize({ ctx }) {
|
||||||
|
ctx.closeIf();
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-call
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "call",
|
||||||
|
priority: 50,
|
||||||
|
atNodeEncounter({ node, qweb, ctx }): boolean {
|
||||||
|
// Step 1: sanity checks
|
||||||
|
// ------------------------------------------------
|
||||||
|
ctx.rootContext.shouldDefineScope = true;
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
const subTemplate = node.getAttribute("t-call")!;
|
||||||
|
const isDynamic = INTERP_REGEXP.test(subTemplate);
|
||||||
|
const nodeTemplate = qweb.templates[subTemplate];
|
||||||
|
if (!isDynamic && !nodeTemplate) {
|
||||||
|
throw new Error(`Cannot find template "${subTemplate}" (t-call)`);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Step 2: compile target template in sub templates
|
||||||
|
// ------------------------------------------------
|
||||||
|
let subIdstr: string;
|
||||||
|
if (isDynamic) {
|
||||||
|
const _id = ctx.generateID();
|
||||||
|
ctx.addLine(`let tname${_id} = ${ctx.interpolate(subTemplate)};`);
|
||||||
|
ctx.addLine(`let tid${_id} = this.subTemplates[tname${_id}];`);
|
||||||
|
ctx.addIf(`!tid${_id}`);
|
||||||
|
ctx.addLine(`tid${_id} = this.constructor.nextId++;`);
|
||||||
|
ctx.addLine(`this.subTemplates[tname${_id}] = tid${_id};`);
|
||||||
|
ctx.addLine(
|
||||||
|
`this.constructor.subTemplates[tid${_id}] = this._compile(tname${_id}, {hasParent: true, defineKey: true});`
|
||||||
|
);
|
||||||
|
ctx.closeIf();
|
||||||
|
subIdstr = `tid${_id}`;
|
||||||
|
} else {
|
||||||
|
let subId = qweb.subTemplates[subTemplate];
|
||||||
|
if (!subId) {
|
||||||
|
subId = QWeb.nextId++;
|
||||||
|
qweb.subTemplates[subTemplate] = subId;
|
||||||
|
const subTemplateFn = qweb._compile(subTemplate, { hasParent: true, defineKey: true });
|
||||||
|
QWeb.subTemplates[subId] = subTemplateFn;
|
||||||
|
}
|
||||||
|
subIdstr = `'${subId}'`;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Step 3: compile t-call body if necessary
|
||||||
|
// ------------------------------------------------
|
||||||
|
let hasBody = node.hasChildNodes();
|
||||||
|
const protectID = ctx.startProtectScope();
|
||||||
|
if (hasBody) {
|
||||||
|
// we add a sub scope to protect the ambient scope
|
||||||
|
ctx.addLine(`{`);
|
||||||
|
ctx.indent();
|
||||||
|
const nodeCopy = node.cloneNode(true) as Element;
|
||||||
|
for (let attr of ["t-if", "t-else", "t-elif", "t-call"]) {
|
||||||
|
nodeCopy.removeAttribute(attr);
|
||||||
|
}
|
||||||
|
// this local scope is intended to trap c__0
|
||||||
|
ctx.addLine(`{`);
|
||||||
|
ctx.indent();
|
||||||
|
ctx.addLine("let c__0 = [];");
|
||||||
|
qweb._compileNode(nodeCopy, ctx.subContext("parentNode", "__0"));
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
ctx.addLine("scope[utils.zero] = c__0;");
|
||||||
|
ctx.dedent();
|
||||||
|
ctx.addLine(`}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Step 4: add the appropriate function call to current component
|
||||||
|
// ------------------------------------------------
|
||||||
|
const parentComponent = ctx.rootContext.shouldDefineParent
|
||||||
|
? `parent`
|
||||||
|
: `utils.getComponent(context)`;
|
||||||
|
const key = ctx.generateTemplateKey();
|
||||||
|
const parentNode = ctx.parentNode ? `c${ctx.parentNode}` : "result";
|
||||||
|
const extra = `Object.assign({}, extra, {parentNode: ${parentNode}, parent: ${parentComponent}, key: ${key}})`;
|
||||||
|
if (ctx.parentNode) {
|
||||||
|
ctx.addLine(`this.constructor.subTemplates[${subIdstr}].call(this, scope, ${extra});`);
|
||||||
|
} else {
|
||||||
|
// this is a t-call with no parentnode, we need to extract the result
|
||||||
|
ctx.rootContext.shouldDefineResult = true;
|
||||||
|
ctx.addLine(`result = []`);
|
||||||
|
ctx.addLine(`this.constructor.subTemplates[${subIdstr}].call(this, scope, ${extra});`);
|
||||||
|
ctx.addLine(`result = result[0]`);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Step 5: restore previous scope
|
||||||
|
// ------------------------------------------------
|
||||||
|
if (hasBody) {
|
||||||
|
ctx.dedent();
|
||||||
|
ctx.addLine(`}`);
|
||||||
|
}
|
||||||
|
ctx.stopProtectScope(protectID);
|
||||||
|
|
||||||
|
return true;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-foreach
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "foreach",
|
||||||
|
extraNames: ["as"],
|
||||||
|
priority: 10,
|
||||||
|
atNodeEncounter({ node, qweb, ctx }): boolean {
|
||||||
|
ctx.rootContext.shouldDefineScope = true;
|
||||||
|
ctx = ctx.subContext("loopNumber", ctx.loopNumber + 1);
|
||||||
|
const elems = node.getAttribute("t-foreach")!;
|
||||||
|
const name = node.getAttribute("t-as")!;
|
||||||
|
let arrayID = ctx.generateID();
|
||||||
|
ctx.addLine(`let _${arrayID} = ${ctx.formatExpression(elems)};`);
|
||||||
|
ctx.addLine(`if (!_${arrayID}) { throw new Error('QWeb error: Invalid loop expression')}`);
|
||||||
|
let keysID = ctx.generateID();
|
||||||
|
let valuesID = ctx.generateID();
|
||||||
|
ctx.addLine(`let _${keysID} = _${valuesID} = _${arrayID};`);
|
||||||
|
ctx.addIf(`!(_${arrayID} instanceof Array)`);
|
||||||
|
ctx.addLine(`_${keysID} = Object.keys(_${arrayID});`);
|
||||||
|
ctx.addLine(`_${valuesID} = Object.values(_${arrayID});`);
|
||||||
|
ctx.closeIf();
|
||||||
|
ctx.addLine(`let _length${keysID} = _${keysID}.length;`);
|
||||||
|
let varsID = ctx.startProtectScope(true);
|
||||||
|
const loopVar = `i${ctx.loopNumber}`;
|
||||||
|
ctx.addLine(`for (let ${loopVar} = 0; ${loopVar} < _length${keysID}; ${loopVar}++) {`);
|
||||||
|
ctx.indent();
|
||||||
|
|
||||||
|
ctx.addLine(`scope.${name}_first = ${loopVar} === 0`);
|
||||||
|
ctx.addLine(`scope.${name}_last = ${loopVar} === _length${keysID} - 1`);
|
||||||
|
ctx.addLine(`scope.${name}_index = ${loopVar}`);
|
||||||
|
ctx.addLine(`scope.${name} = _${keysID}[${loopVar}]`);
|
||||||
|
ctx.addLine(`scope.${name}_value = _${valuesID}[${loopVar}]`);
|
||||||
|
const nodeCopy = <Element>node.cloneNode(true);
|
||||||
|
let shouldWarn =
|
||||||
|
!nodeCopy.hasAttribute("t-key") &&
|
||||||
|
node.children.length === 1 &&
|
||||||
|
node.children[0].tagName !== "t" &&
|
||||||
|
!node.children[0].hasAttribute("t-key");
|
||||||
|
if (shouldWarn) {
|
||||||
|
console.warn(
|
||||||
|
`Directive t-foreach should always be used with a t-key! (in template: '${ctx.templateName}')`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if (nodeCopy.hasAttribute("t-key")) {
|
||||||
|
const expr = ctx.formatExpression(nodeCopy.getAttribute("t-key")!);
|
||||||
|
ctx.addLine(`let key${ctx.loopNumber} = ${expr};`);
|
||||||
|
nodeCopy.removeAttribute("t-key");
|
||||||
|
} else {
|
||||||
|
ctx.addLine(`let key${ctx.loopNumber} = i${ctx.loopNumber};`);
|
||||||
|
}
|
||||||
|
|
||||||
|
nodeCopy.removeAttribute("t-foreach");
|
||||||
|
qweb._compileNode(nodeCopy, ctx);
|
||||||
|
ctx.dedent();
|
||||||
|
ctx.addLine("}");
|
||||||
|
ctx.stopProtectScope(varsID);
|
||||||
|
return true;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-debug
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "debug",
|
||||||
|
priority: 1,
|
||||||
|
atNodeEncounter({ ctx }) {
|
||||||
|
ctx.addLine("debugger;");
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-log
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "log",
|
||||||
|
priority: 1,
|
||||||
|
atNodeEncounter({ ctx, value }) {
|
||||||
|
const expr = ctx.formatExpression(value);
|
||||||
|
ctx.addLine(`console.log(${expr})`);
|
||||||
|
},
|
||||||
|
});
|
||||||
@@ -0,0 +1,212 @@
|
|||||||
|
import { compileExpr, compileExprToArray, QWebVar } from "./expression_parser";
|
||||||
|
|
||||||
|
export const INTERP_REGEXP = /\{\{.*?\}\}/g;
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Compilation Context
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export class CompilationContext {
|
||||||
|
static nextID: number = 1;
|
||||||
|
code: string[] = [];
|
||||||
|
variables: { [key: string]: QWebVar } = {};
|
||||||
|
escaping: boolean = false;
|
||||||
|
parentNode: number | null | string = null;
|
||||||
|
parentTextNode: number | null = null;
|
||||||
|
rootNode: number | null = null;
|
||||||
|
indentLevel: number = 0;
|
||||||
|
rootContext: CompilationContext;
|
||||||
|
shouldDefineParent: boolean = false;
|
||||||
|
shouldDefineScope: boolean = false;
|
||||||
|
protectedScopeNumber: number = 0;
|
||||||
|
shouldDefineQWeb: boolean = false;
|
||||||
|
shouldDefineUtils: boolean = false;
|
||||||
|
shouldDefineRefs: boolean = false;
|
||||||
|
shouldDefineResult: boolean = true;
|
||||||
|
loopNumber: number = 0;
|
||||||
|
inPreTag: boolean = false;
|
||||||
|
templateName: string;
|
||||||
|
allowMultipleRoots: boolean = false;
|
||||||
|
hasParentWidget: boolean = false;
|
||||||
|
hasKey0: boolean = false;
|
||||||
|
keyStack: boolean[] = [];
|
||||||
|
|
||||||
|
constructor(name?: string) {
|
||||||
|
this.rootContext = this;
|
||||||
|
this.templateName = name || "noname";
|
||||||
|
this.addLine("let h = this.h;");
|
||||||
|
}
|
||||||
|
|
||||||
|
generateID(): number {
|
||||||
|
return CompilationContext.nextID++;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This method generates a "template key", which is basically a unique key
|
||||||
|
* which depends on the currently set keys, and on the iteration numbers (if
|
||||||
|
* we are in a loop).
|
||||||
|
*
|
||||||
|
* Such a key is necessary when we need to associate an id to some element
|
||||||
|
* generated by a template (for example, a component)
|
||||||
|
*/
|
||||||
|
generateTemplateKey(prefix: string = ""): string {
|
||||||
|
const id = this.generateID();
|
||||||
|
if (this.loopNumber === 0 && !this.hasKey0) {
|
||||||
|
return `'${prefix}__${id}__'`;
|
||||||
|
}
|
||||||
|
let key = `\`${prefix}__${id}__`;
|
||||||
|
let start = this.hasKey0 ? 0 : 1;
|
||||||
|
for (let i = start; i < this.loopNumber + 1; i++) {
|
||||||
|
key += `\${key${i}}__`;
|
||||||
|
}
|
||||||
|
this.addLine(`let k${id} = ${key}\`;`);
|
||||||
|
return `k${id}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
generateCode(): string[] {
|
||||||
|
if (this.shouldDefineResult) {
|
||||||
|
this.code.unshift(" let result;");
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this.shouldDefineScope) {
|
||||||
|
this.code.unshift(" let scope = Object.create(context);");
|
||||||
|
}
|
||||||
|
if (this.shouldDefineRefs) {
|
||||||
|
this.code.unshift(" context.__owl__.refs = context.__owl__.refs || {};");
|
||||||
|
}
|
||||||
|
if (this.shouldDefineParent) {
|
||||||
|
if (this.hasParentWidget) {
|
||||||
|
this.code.unshift(" let parent = extra.parent;");
|
||||||
|
} else {
|
||||||
|
this.code.unshift(" let parent = context;");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (this.shouldDefineQWeb) {
|
||||||
|
this.code.unshift(" let QWeb = this.constructor;");
|
||||||
|
}
|
||||||
|
if (this.shouldDefineUtils) {
|
||||||
|
this.code.unshift(" let insertValue = utils.insertValue;");
|
||||||
|
this.code.unshift(" let utils = this.constructor.utils;");
|
||||||
|
}
|
||||||
|
return this.code;
|
||||||
|
}
|
||||||
|
|
||||||
|
withParent(node: number): CompilationContext {
|
||||||
|
if (
|
||||||
|
!this.allowMultipleRoots &&
|
||||||
|
this === this.rootContext &&
|
||||||
|
(this.parentNode || this.parentTextNode)
|
||||||
|
) {
|
||||||
|
throw new Error("A template should not have more than one root node");
|
||||||
|
}
|
||||||
|
if (!this.rootContext.rootNode) {
|
||||||
|
this.rootContext.rootNode = node;
|
||||||
|
}
|
||||||
|
if (!this.parentNode && this.rootContext.shouldDefineResult) {
|
||||||
|
this.addLine(`result = vn${node};`);
|
||||||
|
}
|
||||||
|
return this.subContext("parentNode", node);
|
||||||
|
}
|
||||||
|
|
||||||
|
subContext(key: keyof CompilationContext, value: any): CompilationContext {
|
||||||
|
const newContext = Object.create(this);
|
||||||
|
newContext[key] = value;
|
||||||
|
return newContext;
|
||||||
|
}
|
||||||
|
|
||||||
|
indent() {
|
||||||
|
this.rootContext.indentLevel++;
|
||||||
|
}
|
||||||
|
|
||||||
|
dedent() {
|
||||||
|
this.rootContext.indentLevel--;
|
||||||
|
}
|
||||||
|
|
||||||
|
addLine(line: string): number {
|
||||||
|
const prefix = new Array(this.indentLevel + 2).join(" ");
|
||||||
|
this.code.push(prefix + line);
|
||||||
|
return this.code.length - 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
addIf(condition: string) {
|
||||||
|
this.addLine(`if (${condition}) {`);
|
||||||
|
this.indent();
|
||||||
|
}
|
||||||
|
|
||||||
|
addElse() {
|
||||||
|
this.dedent();
|
||||||
|
this.addLine("} else {");
|
||||||
|
this.indent();
|
||||||
|
}
|
||||||
|
|
||||||
|
closeIf() {
|
||||||
|
this.dedent();
|
||||||
|
this.addLine("}");
|
||||||
|
}
|
||||||
|
|
||||||
|
getValue(val: any): QWebVar | string {
|
||||||
|
return val in this.variables ? this.getValue(this.variables[val]) : val;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Prepare an expression for being consumed at render time. Its main job
|
||||||
|
* is to
|
||||||
|
* - replace unknown variables by a lookup in the context
|
||||||
|
* - replace already defined variables by their internal name
|
||||||
|
*/
|
||||||
|
formatExpression(expr: string): string {
|
||||||
|
this.rootContext.shouldDefineScope = true;
|
||||||
|
return compileExpr(expr, this.variables);
|
||||||
|
}
|
||||||
|
captureExpression(expr: string): string {
|
||||||
|
this.rootContext.shouldDefineScope = true;
|
||||||
|
const argId = this.generateID();
|
||||||
|
const tokens = compileExprToArray(expr, this.variables);
|
||||||
|
const done = new Set();
|
||||||
|
return tokens
|
||||||
|
.map((tok) => {
|
||||||
|
if (tok.varName) {
|
||||||
|
if (!done.has(tok.varName)) {
|
||||||
|
done.add(tok.varName);
|
||||||
|
this.addLine(`const ${tok.varName}_${argId} = ${tok.value};`);
|
||||||
|
}
|
||||||
|
tok.value = `${tok.varName}_${argId}`;
|
||||||
|
}
|
||||||
|
return tok.value;
|
||||||
|
})
|
||||||
|
.join("");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Perform string interpolation on the given string. Note that if the whole
|
||||||
|
* string is an expression, it simply returns it (formatted and enclosed in
|
||||||
|
* parentheses).
|
||||||
|
* For instance:
|
||||||
|
* 'Hello {{x}}!' -> `Hello ${x}`
|
||||||
|
* '{{x ? 'a': 'b'}}' -> (x ? 'a' : 'b')
|
||||||
|
*/
|
||||||
|
interpolate(s: string): string {
|
||||||
|
let matches = s.match(INTERP_REGEXP);
|
||||||
|
if (matches && matches[0].length === s.length) {
|
||||||
|
return `(${this.formatExpression(s.slice(2, -2))})`;
|
||||||
|
}
|
||||||
|
|
||||||
|
let r = s.replace(/\{\{.*?\}\}/g, (s) => "${" + this.formatExpression(s.slice(2, -2)) + "}");
|
||||||
|
return "`" + r + "`";
|
||||||
|
}
|
||||||
|
startProtectScope(codeBlock?: boolean): number {
|
||||||
|
const protectID = this.generateID();
|
||||||
|
this.rootContext.protectedScopeNumber++;
|
||||||
|
this.rootContext.shouldDefineScope = true;
|
||||||
|
const scopeExpr = `Object.create(scope);`;
|
||||||
|
this.addLine(`let _origScope${protectID} = scope;`);
|
||||||
|
this.addLine(`scope = ${scopeExpr}`);
|
||||||
|
if (!codeBlock) {
|
||||||
|
this.addLine(`scope.__access_mode__ = 'ro';`);
|
||||||
|
}
|
||||||
|
return protectID;
|
||||||
|
}
|
||||||
|
stopProtectScope(protectID: number) {
|
||||||
|
this.rootContext.protectedScopeNumber--;
|
||||||
|
this.addLine(`scope = _origScope${protectID};`);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -25,12 +25,11 @@
|
|||||||
// Misc types, constants and helpers
|
// Misc types, constants and helpers
|
||||||
//------------------------------------------------------------------------------
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
const RESERVED_WORDS =
|
const RESERVED_WORDS = "true,false,NaN,null,undefined,debugger,console,window,in,instanceof,new,function,return,this,eval,void,Math,RegExp,Array,Object,Date".split(
|
||||||
"true,false,NaN,null,undefined,debugger,console,window,in,instanceof,new,function,return,this,eval,void,Math,RegExp,Array,Object,Date".split(
|
|
||||||
","
|
","
|
||||||
);
|
);
|
||||||
|
|
||||||
const WORD_REPLACEMENT: { [key: string]: string } = Object.assign(Object.create(null), {
|
const WORD_REPLACEMENT = Object.assign(Object.create(null), {
|
||||||
and: "&&",
|
and: "&&",
|
||||||
or: "||",
|
or: "||",
|
||||||
gt: ">",
|
gt: ">",
|
||||||
@@ -70,7 +69,6 @@ interface Token {
|
|||||||
size?: number;
|
size?: number;
|
||||||
varName?: string;
|
varName?: string;
|
||||||
replace?: Function;
|
replace?: Function;
|
||||||
isLocal?: boolean;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
const STATIC_TOKEN_MAP: { [key: string]: TKind } = Object.assign(Object.create(null), {
|
const STATIC_TOKEN_MAP: { [key: string]: TKind } = Object.assign(Object.create(null), {
|
||||||
@@ -119,7 +117,7 @@ let tokenizeString: Tokenizer = function (expr) {
|
|||||||
return {
|
return {
|
||||||
type: "TEMPLATE_STRING",
|
type: "TEMPLATE_STRING",
|
||||||
value: s,
|
value: s,
|
||||||
replace(replacer: any) {
|
replace(replacer) {
|
||||||
return s.replace(/\$\{(.*?)\}/g, (match, group) => {
|
return s.replace(/\$\{(.*?)\}/g, (match, group) => {
|
||||||
return "${" + replacer(group) + "}";
|
return "${" + replacer(group) + "}";
|
||||||
});
|
});
|
||||||
@@ -225,9 +223,8 @@ export function tokenize(expr: string): Token[] {
|
|||||||
// Expression "evaluator"
|
// Expression "evaluator"
|
||||||
//------------------------------------------------------------------------------
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
const isLeftSeparator = (token: Token) =>
|
const isLeftSeparator = (token) => token && (token.type === "LEFT_BRACE" || token.type === "COMMA");
|
||||||
token && (token.type === "LEFT_BRACE" || token.type === "COMMA");
|
const isRightSeparator = (token) =>
|
||||||
const isRightSeparator = (token: Token) =>
|
|
||||||
token && (token.type === "RIGHT_BRACE" || token.type === "COMMA");
|
token && (token.type === "RIGHT_BRACE" || token.type === "COMMA");
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -255,9 +252,10 @@ const isRightSeparator = (token: Token) =>
|
|||||||
* the arrow operator, then we add the current (or some previous tokens) token to
|
* the arrow operator, then we add the current (or some previous tokens) token to
|
||||||
* the list of variables so it does not get replaced by a lookup in the context
|
* the list of variables so it does not get replaced by a lookup in the context
|
||||||
*/
|
*/
|
||||||
export function compileExprToArray(expr: string): Token[] {
|
export function compileExprToArray(expr: string, scope: { [key: string]: QWebVar }): Token[] {
|
||||||
const localVars = new Set<string>();
|
scope = Object.create(scope);
|
||||||
const tokens = tokenize(expr);
|
const tokens = tokenize(expr);
|
||||||
|
|
||||||
let i = 0;
|
let i = 0;
|
||||||
let stack = []; // to track last opening [ or {
|
let stack = []; // to track last opening [ or {
|
||||||
|
|
||||||
@@ -300,7 +298,7 @@ export function compileExprToArray(expr: string): Token[] {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (token.type === "TEMPLATE_STRING") {
|
if (token.type === "TEMPLATE_STRING") {
|
||||||
token.value = token.replace!((expr: any) => compileExpr(expr));
|
token.value = token.replace((expr) => compileExpr(expr, scope));
|
||||||
}
|
}
|
||||||
if (nextToken && nextToken.type === "OPERATOR" && nextToken.value === "=>") {
|
if (nextToken && nextToken.type === "OPERATOR" && nextToken.value === "=>") {
|
||||||
if (token.type === "RIGHT_PAREN") {
|
if (token.type === "RIGHT_PAREN") {
|
||||||
@@ -308,49 +306,31 @@ export function compileExprToArray(expr: string): Token[] {
|
|||||||
while (j > 0 && tokens[j].type !== "LEFT_PAREN") {
|
while (j > 0 && tokens[j].type !== "LEFT_PAREN") {
|
||||||
if (tokens[j].type === "SYMBOL" && tokens[j].originalValue) {
|
if (tokens[j].type === "SYMBOL" && tokens[j].originalValue) {
|
||||||
tokens[j].value = tokens[j].originalValue!;
|
tokens[j].value = tokens[j].originalValue!;
|
||||||
localVars.add(tokens[j].value); //] = { id: tokens[j].value, expr: tokens[j].value };
|
scope[tokens[j].value] = { id: tokens[j].value, expr: tokens[j].value };
|
||||||
}
|
}
|
||||||
j--;
|
j--;
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
localVars.add(token.value); //] = { id: token.value, expr: token.value };
|
scope[token.value] = { id: token.value, expr: token.value };
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if (isVar) {
|
if (isVar) {
|
||||||
token.varName = token.value;
|
token.varName = token.value;
|
||||||
if (!localVars.has(token.value)) {
|
if (token.value in scope && "id" in scope[token.value]) {
|
||||||
|
token.value = scope[token.value].expr!;
|
||||||
|
} else {
|
||||||
token.originalValue = token.value;
|
token.originalValue = token.value;
|
||||||
token.value = `ctx['${token.value}']`;
|
token.value = `scope['${token.value}']`;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
i++;
|
i++;
|
||||||
}
|
}
|
||||||
// Mark all variables that have been used locally.
|
|
||||||
// This assumes the expression has only one scope (incorrect but "good enough for now")
|
|
||||||
for (const token of tokens) {
|
|
||||||
if (token.type === "SYMBOL" && localVars.has(token.value)) {
|
|
||||||
token.isLocal = true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return tokens;
|
return tokens;
|
||||||
}
|
}
|
||||||
|
|
||||||
export function compileExpr(expr: string): string {
|
export function compileExpr(expr: string, scope: { [key: string]: QWebVar }): string {
|
||||||
return compileExprToArray(expr)
|
return compileExprToArray(expr, scope)
|
||||||
.map((t) => t.value)
|
.map((t) => t.value)
|
||||||
.join("");
|
.join("");
|
||||||
}
|
}
|
||||||
|
|
||||||
export const INTERP_REGEXP = /\{\{.*?\}\}/g;
|
|
||||||
const INTERP_GROUP_REGEXP = /\{\{.*?\}\}/g;
|
|
||||||
|
|
||||||
export function interpolate(s: string): string {
|
|
||||||
let matches = s.match(INTERP_REGEXP);
|
|
||||||
if (matches && matches[0].length === s.length) {
|
|
||||||
return `(${compileExpr(s.slice(2, -2))})`;
|
|
||||||
}
|
|
||||||
|
|
||||||
let r = s.replace(INTERP_GROUP_REGEXP, (s) => "${" + compileExpr(s.slice(2, -2)) + "}");
|
|
||||||
return "`" + r + "`";
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,377 @@
|
|||||||
|
import { STATUS } from "../component/component";
|
||||||
|
import { VNode } from "../vdom/index";
|
||||||
|
import { INTERP_REGEXP } from "./compilation_context";
|
||||||
|
import { QWeb } from "./qweb";
|
||||||
|
import { browser } from "../browser";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Owl QWeb Extensions
|
||||||
|
*
|
||||||
|
* This file contains the implementation of non standard QWeb directives, added
|
||||||
|
* by Owl and that will only work on Owl projects:
|
||||||
|
*
|
||||||
|
* - t-on
|
||||||
|
* - t-ref
|
||||||
|
* - t-transition
|
||||||
|
* - t-mounted
|
||||||
|
* - t-slot
|
||||||
|
* - t-model
|
||||||
|
*/
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-on
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// these are pieces of code that will be injected into the event handler if
|
||||||
|
// modifiers are specified
|
||||||
|
export const MODS_CODE = {
|
||||||
|
prevent: "e.preventDefault();",
|
||||||
|
self: "if (e.target !== this.elm) {return}",
|
||||||
|
stop: "e.stopPropagation();",
|
||||||
|
};
|
||||||
|
|
||||||
|
interface HandlerInfo {
|
||||||
|
event: string;
|
||||||
|
handler: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const FNAMEREGEXP = /^[$A-Z_][0-9A-Z_$]*$/i;
|
||||||
|
|
||||||
|
export function makeHandlerCode(
|
||||||
|
ctx,
|
||||||
|
fullName,
|
||||||
|
value,
|
||||||
|
putInCache: boolean,
|
||||||
|
modcodes = MODS_CODE
|
||||||
|
): HandlerInfo {
|
||||||
|
let [event, ...mods] = fullName.slice(5).split(".");
|
||||||
|
if (mods.includes("capture")) {
|
||||||
|
event = "!" + event;
|
||||||
|
}
|
||||||
|
if (!event) {
|
||||||
|
throw new Error("Missing event name with t-on directive");
|
||||||
|
}
|
||||||
|
let code: string;
|
||||||
|
// check if it is a method with no args, a method with args or an expression
|
||||||
|
let args: string = "";
|
||||||
|
const name: string = value.replace(/\(.*\)/, function (_args) {
|
||||||
|
args = _args.slice(1, -1);
|
||||||
|
return "";
|
||||||
|
});
|
||||||
|
const isMethodCall = name.match(FNAMEREGEXP);
|
||||||
|
|
||||||
|
// then generate code
|
||||||
|
if (isMethodCall) {
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
const comp = `utils.getComponent(context)`;
|
||||||
|
if (args) {
|
||||||
|
const argId = ctx.generateID();
|
||||||
|
ctx.addLine(`let args${argId} = [${ctx.formatExpression(args)}];`);
|
||||||
|
code = `${comp}['${name}'](...args${argId}, e);`;
|
||||||
|
putInCache = false;
|
||||||
|
} else {
|
||||||
|
code = `${comp}['${name}'](e);`;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// if we get here, then it is an expression
|
||||||
|
// we need to capture every variable in it
|
||||||
|
putInCache = false;
|
||||||
|
code = ctx.captureExpression(value);
|
||||||
|
code = `const res = (() => { return ${code} })(); if (typeof res === 'function') { res(e) }`;
|
||||||
|
}
|
||||||
|
const modCode = mods.map((mod) => modcodes[mod]).join("");
|
||||||
|
let handler = `function (e) {if (context.__owl__.status === ${STATUS.DESTROYED}){return}${modCode}${code}}`;
|
||||||
|
if (putInCache) {
|
||||||
|
const key = ctx.generateTemplateKey(event);
|
||||||
|
ctx.addLine(`extra.handlers[${key}] = extra.handlers[${key}] || ${handler};`);
|
||||||
|
handler = `extra.handlers[${key}]`;
|
||||||
|
}
|
||||||
|
return { event, handler };
|
||||||
|
}
|
||||||
|
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "on",
|
||||||
|
priority: 90,
|
||||||
|
atNodeCreation({ ctx, fullName, value, nodeID }) {
|
||||||
|
const { event, handler } = makeHandlerCode(ctx, fullName, value, true);
|
||||||
|
ctx.addLine(`p${nodeID}.on['${event}'] = ${handler};`);
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-ref
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "ref",
|
||||||
|
priority: 95,
|
||||||
|
atNodeCreation({ ctx, value, addNodeHook }) {
|
||||||
|
ctx.rootContext.shouldDefineRefs = true;
|
||||||
|
const refKey = `ref${ctx.generateID()}`;
|
||||||
|
ctx.addLine(`const ${refKey} = ${ctx.interpolate(value)};`);
|
||||||
|
addNodeHook("create", `context.__owl__.refs[${refKey}] = n.elm;`);
|
||||||
|
addNodeHook("destroy", `delete context.__owl__.refs[${refKey}];`);
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-transition
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.utils.nextFrame = function (cb: () => void) {
|
||||||
|
requestAnimationFrame(() => requestAnimationFrame(cb));
|
||||||
|
};
|
||||||
|
|
||||||
|
QWeb.utils.transitionInsert = function (vn: VNode, name: string) {
|
||||||
|
const elm = <HTMLElement>vn.elm;
|
||||||
|
// remove potential duplicated vnode that is currently being removed, to
|
||||||
|
// prevent from having twice the same node in the DOM during an animation
|
||||||
|
const dup = elm.parentElement && elm.parentElement!.querySelector(`*[data-owl-key='${vn.key}']`);
|
||||||
|
if (dup) {
|
||||||
|
dup.remove();
|
||||||
|
}
|
||||||
|
|
||||||
|
elm.classList.add(name + "-enter");
|
||||||
|
elm.classList.add(name + "-enter-active");
|
||||||
|
elm.classList.remove(name + "-leave-active");
|
||||||
|
elm.classList.remove(name + "-leave-to");
|
||||||
|
const finalize = () => {
|
||||||
|
elm.classList.remove(name + "-enter-active");
|
||||||
|
elm.classList.remove(name + "-enter-to");
|
||||||
|
};
|
||||||
|
this.nextFrame(() => {
|
||||||
|
elm.classList.remove(name + "-enter");
|
||||||
|
elm.classList.add(name + "-enter-to");
|
||||||
|
whenTransitionEnd(elm, finalize);
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
QWeb.utils.transitionRemove = function (vn: VNode, name: string, rm: () => void) {
|
||||||
|
const elm = <HTMLElement>vn.elm;
|
||||||
|
elm.setAttribute("data-owl-key", vn.key!);
|
||||||
|
|
||||||
|
elm.classList.add(name + "-leave");
|
||||||
|
elm.classList.add(name + "-leave-active");
|
||||||
|
const finalize = () => {
|
||||||
|
if (!elm.classList.contains(name + "-leave-active")) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
elm.classList.remove(name + "-leave-active");
|
||||||
|
elm.classList.remove(name + "-leave-to");
|
||||||
|
rm();
|
||||||
|
};
|
||||||
|
this.nextFrame(() => {
|
||||||
|
elm.classList.remove(name + "-leave");
|
||||||
|
elm.classList.add(name + "-leave-to");
|
||||||
|
whenTransitionEnd(elm, finalize);
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
function getTimeout(delays: Array<string>, durations: Array<string>): number {
|
||||||
|
/* istanbul ignore next */
|
||||||
|
while (delays.length < durations.length) {
|
||||||
|
delays = delays.concat(delays);
|
||||||
|
}
|
||||||
|
|
||||||
|
return Math.max.apply(
|
||||||
|
null,
|
||||||
|
durations.map((d, i) => {
|
||||||
|
return toMs(d) + toMs(delays[i]);
|
||||||
|
})
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Old versions of Chromium (below 61.0.3163.100) formats floating pointer numbers
|
||||||
|
// in a locale-dependent way, using a comma instead of a dot.
|
||||||
|
// If comma is not replaced with a dot, the input will be rounded down (i.e. acting
|
||||||
|
// as a floor function) causing unexpected behaviors
|
||||||
|
function toMs(s: string): number {
|
||||||
|
return Number(s.slice(0, -1).replace(",", ".")) * 1000;
|
||||||
|
}
|
||||||
|
|
||||||
|
function whenTransitionEnd(elm: HTMLElement, cb) {
|
||||||
|
if (!elm.parentNode) {
|
||||||
|
// if we get here, this means that the element was removed for some other
|
||||||
|
// reasons, and in that case, we don't want to work on animation since nothing
|
||||||
|
// will be displayed anyway.
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const styles = window.getComputedStyle(elm);
|
||||||
|
const delays: Array<string> = (styles.transitionDelay || "").split(", ");
|
||||||
|
const durations: Array<string> = (styles.transitionDuration || "").split(", ");
|
||||||
|
const timeout: number = getTimeout(delays, durations);
|
||||||
|
if (timeout > 0) {
|
||||||
|
const transitionEndCB = () => {
|
||||||
|
if (!elm.parentNode) return;
|
||||||
|
cb();
|
||||||
|
browser.clearTimeout(fallbackTimeout);
|
||||||
|
elm.removeEventListener("transitionend", transitionEndCB);
|
||||||
|
};
|
||||||
|
elm.addEventListener("transitionend", transitionEndCB, { once: true });
|
||||||
|
const fallbackTimeout = browser.setTimeout(transitionEndCB, timeout + 1);
|
||||||
|
} else {
|
||||||
|
cb();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "transition",
|
||||||
|
priority: 96,
|
||||||
|
atNodeCreation({ ctx, value, addNodeHook }) {
|
||||||
|
if (!QWeb.enableTransitions) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
let name = value;
|
||||||
|
const hooks = {
|
||||||
|
insert: `utils.transitionInsert(vn, '${name}');`,
|
||||||
|
remove: `utils.transitionRemove(vn, '${name}', rm);`,
|
||||||
|
};
|
||||||
|
for (let hookName in hooks) {
|
||||||
|
addNodeHook(hookName, hooks[hookName]);
|
||||||
|
}
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-slot
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "slot",
|
||||||
|
priority: 80,
|
||||||
|
atNodeEncounter({ ctx, value, node, qweb }): boolean {
|
||||||
|
const slotKey = ctx.generateID();
|
||||||
|
const valueExpr = value.match(INTERP_REGEXP) ? ctx.interpolate(value) : `'${value}'`;
|
||||||
|
ctx.addLine(
|
||||||
|
`const slot${slotKey} = this.constructor.slots[context.__owl__.slotId + '_' + ${valueExpr}];`
|
||||||
|
);
|
||||||
|
ctx.addIf(`slot${slotKey}`);
|
||||||
|
let parentNode = `c${ctx.parentNode}`;
|
||||||
|
if (!ctx.parentNode) {
|
||||||
|
ctx.rootContext.shouldDefineResult = true;
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
parentNode = `children${ctx.generateID()}`;
|
||||||
|
ctx.addLine(`let ${parentNode}= []`);
|
||||||
|
ctx.addLine(`result = {}`);
|
||||||
|
}
|
||||||
|
ctx.addLine(
|
||||||
|
`slot${slotKey}.call(this, context.__owl__.scope, Object.assign({}, extra, {parentNode: ${parentNode}, parent: extra.parent || context}));`
|
||||||
|
);
|
||||||
|
if (!ctx.parentNode) {
|
||||||
|
ctx.addLine(`utils.defineProxy(result, ${parentNode}[0]);`);
|
||||||
|
}
|
||||||
|
if (node.hasChildNodes()) {
|
||||||
|
ctx.addElse();
|
||||||
|
const nodeCopy = <Element>node.cloneNode(true);
|
||||||
|
nodeCopy.removeAttribute("t-slot");
|
||||||
|
qweb._compileNode(nodeCopy, ctx);
|
||||||
|
}
|
||||||
|
ctx.closeIf();
|
||||||
|
return true;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-model
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.utils.toNumber = function (val: string): number | string {
|
||||||
|
const n = parseFloat(val);
|
||||||
|
return isNaN(n) ? val : n;
|
||||||
|
};
|
||||||
|
|
||||||
|
const hasDotAtTheEnd = /\.[\w_]+\s*$/;
|
||||||
|
const hasBracketsAtTheEnd = /\[[^\[]+\]\s*$/;
|
||||||
|
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "model",
|
||||||
|
priority: 42,
|
||||||
|
atNodeCreation({ ctx, nodeID, value, node, fullName, addNodeHook }) {
|
||||||
|
const type = node.getAttribute("type");
|
||||||
|
let handler;
|
||||||
|
let event = fullName.includes(".lazy") ? "change" : "input";
|
||||||
|
|
||||||
|
// First step: we need to understand the structure of the expression, and
|
||||||
|
// from it, extract a base expression (that we can capture, which is
|
||||||
|
// important because it will be used in a handler later) and a formatted
|
||||||
|
// expression (which uses the captured base expression)
|
||||||
|
//
|
||||||
|
// Also, we support 2 kinds of values: some.expr.value or some.expr[value]
|
||||||
|
// For the first one, we have:
|
||||||
|
// - base expression = scope[some].expr
|
||||||
|
// - expression = exprX.value (where exprX is the var that captures the base expr)
|
||||||
|
// and for the expression with brackets:
|
||||||
|
// - base expression = scope[some].expr
|
||||||
|
// - expression = exprX[keyX] (where exprX is the var that captures the base expr
|
||||||
|
// and keyX captures scope[value])
|
||||||
|
let expr: string;
|
||||||
|
let baseExpr: string;
|
||||||
|
|
||||||
|
if (hasDotAtTheEnd.test(value)) {
|
||||||
|
// we manage the case where the expr has a dot: some.expr.value
|
||||||
|
const index = value.lastIndexOf(".");
|
||||||
|
baseExpr = value.slice(0, index);
|
||||||
|
ctx.addLine(`let expr${nodeID} = ${ctx.formatExpression(baseExpr)};`);
|
||||||
|
expr = `expr${nodeID}${value.slice(index)}`;
|
||||||
|
} else if (hasBracketsAtTheEnd.test(value)) {
|
||||||
|
// we manage here the case where the expr ends in a bracket expression:
|
||||||
|
// some.expr[value]
|
||||||
|
const index = value.lastIndexOf("[");
|
||||||
|
baseExpr = value.slice(0, index);
|
||||||
|
ctx.addLine(`let expr${nodeID} = ${ctx.formatExpression(baseExpr)};`);
|
||||||
|
let exprKey = value.trimRight().slice(index + 1, -1);
|
||||||
|
ctx.addLine(`let exprKey${nodeID} = ${ctx.formatExpression(exprKey)};`);
|
||||||
|
expr = `expr${nodeID}[exprKey${nodeID}]`;
|
||||||
|
} else {
|
||||||
|
throw new Error(`Invalid t-model expression: "${value}" (it should be assignable)`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const key = ctx.generateTemplateKey();
|
||||||
|
if (node.tagName === "select") {
|
||||||
|
ctx.addLine(`p${nodeID}.props = {value: ${expr}};`);
|
||||||
|
addNodeHook("create", `n.elm.value=${expr};`);
|
||||||
|
event = "change";
|
||||||
|
handler = `(ev) => {${expr} = ev.target.value}`;
|
||||||
|
} else if (type === "checkbox") {
|
||||||
|
ctx.addLine(`p${nodeID}.props = {checked: ${expr}};`);
|
||||||
|
handler = `(ev) => {${expr} = ev.target.checked}`;
|
||||||
|
} else if (type === "radio") {
|
||||||
|
const nodeValue = node.getAttribute("value")!;
|
||||||
|
ctx.addLine(`p${nodeID}.props = {checked:${expr} === '${nodeValue}'};`);
|
||||||
|
handler = `(ev) => {${expr} = ev.target.value}`;
|
||||||
|
event = "click";
|
||||||
|
} else {
|
||||||
|
ctx.addLine(`p${nodeID}.props = {value: ${expr}};`);
|
||||||
|
const trimCode = fullName.includes(".trim") ? ".trim()" : "";
|
||||||
|
let valueCode = `ev.target.value${trimCode}`;
|
||||||
|
if (fullName.includes(".number")) {
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
valueCode = `utils.toNumber(${valueCode})`;
|
||||||
|
}
|
||||||
|
handler = `(ev) => {${expr} = ${valueCode}}`;
|
||||||
|
}
|
||||||
|
ctx.addLine(`extra.handlers[${key}] = extra.handlers[${key}] || (${handler});`);
|
||||||
|
ctx.addLine(`p${nodeID}.on['${event}'] = extra.handlers[${key}];`);
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// t-key
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
QWeb.addDirective({
|
||||||
|
name: "key",
|
||||||
|
priority: 45,
|
||||||
|
atNodeEncounter({ ctx, value, node }) {
|
||||||
|
if (ctx.loopNumber === 0) {
|
||||||
|
ctx.keyStack.push(ctx.rootContext.hasKey0);
|
||||||
|
ctx.rootContext.hasKey0 = true;
|
||||||
|
}
|
||||||
|
ctx.addLine("{");
|
||||||
|
ctx.indent();
|
||||||
|
ctx.addLine(`let key${ctx.loopNumber} = ${ctx.formatExpression(value)};`);
|
||||||
|
},
|
||||||
|
finalize({ ctx }) {
|
||||||
|
ctx.dedent();
|
||||||
|
ctx.addLine("}");
|
||||||
|
if (ctx.loopNumber === 0) {
|
||||||
|
ctx.rootContext.hasKey0 = ctx.keyStack.pop() as boolean;
|
||||||
|
}
|
||||||
|
},
|
||||||
|
});
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
import "./base_directives";
|
||||||
|
import "./extensions";
|
||||||
|
|
||||||
|
export { CompiledTemplate, QWeb } from "./qweb";
|
||||||
@@ -0,0 +1,945 @@
|
|||||||
|
import { EventBus } from "../core/event_bus";
|
||||||
|
import { h, patch, VNode } from "../vdom/index";
|
||||||
|
import { CompilationContext } from "./compilation_context";
|
||||||
|
import { shallowEqual, escape, _Markup } from "../utils";
|
||||||
|
import { addNS } from "../vdom/vdom";
|
||||||
|
import { htmlToVDOM } from "../vdom/html_to_vdom";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Owl QWeb Engine
|
||||||
|
*
|
||||||
|
* In this file, you will find a QWeb engine/template compiler. It is the core
|
||||||
|
* of how Owl component works.
|
||||||
|
*
|
||||||
|
* Briefly, Owl QWeb compiles XML templates into functions that output a virtual
|
||||||
|
* DOM representation.
|
||||||
|
*
|
||||||
|
* We have here:
|
||||||
|
* - a CompilationContext class, which is an internal object that contains all
|
||||||
|
* compilation specific information, while a template is being compiled.
|
||||||
|
* - a QWeb class: this is the code of the QWeb compiler.
|
||||||
|
*
|
||||||
|
* Note that this file does not contain the implementation of the QWeb
|
||||||
|
* directives (see qweb_directives.ts and qweb_extensions.ts).
|
||||||
|
*/
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Types
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
export type EvalContext = { [key: string]: any };
|
||||||
|
export type CompiledTemplate = (context: EvalContext, extra: any) => VNode;
|
||||||
|
|
||||||
|
interface Template {
|
||||||
|
elem: Element;
|
||||||
|
fn: CompiledTemplate;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface CompilationInfo {
|
||||||
|
node: Element;
|
||||||
|
qweb: QWeb;
|
||||||
|
ctx: CompilationContext;
|
||||||
|
fullName: string;
|
||||||
|
value: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface NodeCreationCompilationInfo extends CompilationInfo {
|
||||||
|
nodeID: number;
|
||||||
|
addNodeHook: Function;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface Directive {
|
||||||
|
name: string;
|
||||||
|
extraNames?: string[];
|
||||||
|
priority: number;
|
||||||
|
// if return true, then directive is fully applied and there is no need to
|
||||||
|
// keep processing node. Otherwise, we keep going.
|
||||||
|
atNodeEncounter?(info: CompilationInfo): boolean | void;
|
||||||
|
atNodeCreation?(info: NodeCreationCompilationInfo): void;
|
||||||
|
finalize?(info: CompilationInfo): void;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface QWebConfig {
|
||||||
|
templates?: string;
|
||||||
|
translateFn?(text: string): string;
|
||||||
|
}
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Const/global stuff/helpers
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export const TRANSLATABLE_ATTRS = ["label", "title", "placeholder", "alt"];
|
||||||
|
|
||||||
|
const lineBreakRE = /[\r\n]/;
|
||||||
|
const whitespaceRE = /\s+/g;
|
||||||
|
const translationRE = /^(\s*)([\s\S]+?)(\s*)$/;
|
||||||
|
|
||||||
|
const NODE_HOOKS_PARAMS = {
|
||||||
|
create: "(_, n)",
|
||||||
|
insert: "vn",
|
||||||
|
remove: "(vn, rm)",
|
||||||
|
destroy: "()",
|
||||||
|
};
|
||||||
|
|
||||||
|
interface Utils {
|
||||||
|
toClassObj(expr: any): Object;
|
||||||
|
shallowEqual(p1: Object, p2: Object): boolean;
|
||||||
|
[key: string]: any;
|
||||||
|
}
|
||||||
|
|
||||||
|
function isComponent(obj): boolean {
|
||||||
|
return obj && obj.hasOwnProperty("__owl__");
|
||||||
|
}
|
||||||
|
|
||||||
|
function insertValue(children: any[], value: any) {
|
||||||
|
if (value != null) {
|
||||||
|
if (value instanceof _Markup) {
|
||||||
|
children.push(...htmlToVDOM(value as any));
|
||||||
|
} else {
|
||||||
|
children.push({ text: value });
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
class VDomArray extends Array {
|
||||||
|
toString() {
|
||||||
|
return vDomToString(this);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function vDomToString(vdom: VNode[]): string {
|
||||||
|
return vdom
|
||||||
|
.map((vnode) => {
|
||||||
|
if (vnode.sel) {
|
||||||
|
const node = document.createElement(vnode.sel);
|
||||||
|
const result = patch(node, vnode);
|
||||||
|
return (<HTMLElement>result.elm).outerHTML;
|
||||||
|
} else {
|
||||||
|
return vnode.text;
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.join("");
|
||||||
|
}
|
||||||
|
|
||||||
|
const UTILS: Utils = {
|
||||||
|
zero: Symbol("zero"),
|
||||||
|
insertValue,
|
||||||
|
toClassObj(expr) {
|
||||||
|
const result = {};
|
||||||
|
if (typeof expr === "string") {
|
||||||
|
// we transform here a list of classes into an object:
|
||||||
|
// 'hey you' becomes {hey: true, you: true}
|
||||||
|
expr = expr.trim();
|
||||||
|
if (!expr) {
|
||||||
|
return {};
|
||||||
|
}
|
||||||
|
let words = expr.split(/\s+/);
|
||||||
|
for (let i = 0; i < words.length; i++) {
|
||||||
|
result[words[i]] = true;
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
// this is already an object, but we may need to split keys:
|
||||||
|
// {'a b': true, 'a c': false} should become {a: true, b: true, c: false}
|
||||||
|
for (let key in expr) {
|
||||||
|
const value = expr[key];
|
||||||
|
const words = key.split(/\s+/);
|
||||||
|
for (let word of words) {
|
||||||
|
result[word] = result[word] || value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
},
|
||||||
|
/**
|
||||||
|
* This method combines the current context with the variables defined in a
|
||||||
|
* scope for use in a slot.
|
||||||
|
*
|
||||||
|
* The implementation is kind of tricky because we want to preserve the
|
||||||
|
* prototype chain structure of the cloned result. So we need to traverse the
|
||||||
|
* prototype chain, cloning each level respectively.
|
||||||
|
*/
|
||||||
|
combine(context, scope) {
|
||||||
|
let clone = context;
|
||||||
|
const scopeStack = [];
|
||||||
|
while (!isComponent(scope)) {
|
||||||
|
scopeStack.push(scope);
|
||||||
|
scope = scope.__proto__;
|
||||||
|
}
|
||||||
|
while (scopeStack.length) {
|
||||||
|
let scope = scopeStack.pop();
|
||||||
|
clone = Object.create(clone);
|
||||||
|
Object.assign(clone, scope);
|
||||||
|
}
|
||||||
|
return clone;
|
||||||
|
},
|
||||||
|
shallowEqual,
|
||||||
|
addNameSpace(vnode) {
|
||||||
|
addNS(vnode.data, vnode.children, vnode.sel);
|
||||||
|
},
|
||||||
|
VDomArray,
|
||||||
|
vDomToString,
|
||||||
|
getComponent(obj) {
|
||||||
|
while (obj && !isComponent(obj)) {
|
||||||
|
obj = obj.__proto__;
|
||||||
|
}
|
||||||
|
return obj;
|
||||||
|
},
|
||||||
|
getScope(obj, property: string) {
|
||||||
|
const obj0 = obj;
|
||||||
|
while (
|
||||||
|
obj &&
|
||||||
|
!obj.hasOwnProperty(property) &&
|
||||||
|
!(obj.hasOwnProperty("__access_mode__") && obj.__access_mode__ === "ro")
|
||||||
|
) {
|
||||||
|
const newObj = obj.__proto__;
|
||||||
|
if (!newObj || isComponent(newObj)) {
|
||||||
|
return obj0;
|
||||||
|
}
|
||||||
|
obj = newObj;
|
||||||
|
}
|
||||||
|
return obj;
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
function parseXML(xml: string): Document {
|
||||||
|
const parser = new DOMParser();
|
||||||
|
|
||||||
|
const doc = parser.parseFromString(xml, "text/xml");
|
||||||
|
if (doc.getElementsByTagName("parsererror").length) {
|
||||||
|
let msg = "Invalid XML in template.";
|
||||||
|
const parsererrorText = doc.getElementsByTagName("parsererror")[0].textContent;
|
||||||
|
if (parsererrorText) {
|
||||||
|
msg += "\nThe parser has produced the following error message:\n" + parsererrorText;
|
||||||
|
const re = /\d+/g;
|
||||||
|
const firstMatch = re.exec(parsererrorText);
|
||||||
|
if (firstMatch) {
|
||||||
|
const lineNumber = Number(firstMatch[0]);
|
||||||
|
const line = xml.split("\n")[lineNumber - 1];
|
||||||
|
const secondMatch = re.exec(parsererrorText);
|
||||||
|
if (line && secondMatch) {
|
||||||
|
const columnIndex = Number(secondMatch[0]) - 1;
|
||||||
|
if (line[columnIndex]) {
|
||||||
|
msg +=
|
||||||
|
`\nThe error might be located at xml line ${lineNumber} column ${columnIndex}\n` +
|
||||||
|
`${line}\n${"-".repeat(columnIndex - 1)}^`;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
throw new Error(msg);
|
||||||
|
}
|
||||||
|
return doc;
|
||||||
|
}
|
||||||
|
|
||||||
|
function escapeQuotes(str: string): string {
|
||||||
|
return str.replace(/\'/g, "\\'");
|
||||||
|
}
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// QWeb rendering engine
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export class QWeb extends EventBus {
|
||||||
|
templates: { [name: string]: Template };
|
||||||
|
static utils = UTILS;
|
||||||
|
static components = Object.create(null);
|
||||||
|
|
||||||
|
static DIRECTIVE_NAMES: { [key: string]: 1 } = {
|
||||||
|
name: 1,
|
||||||
|
att: 1,
|
||||||
|
attf: 1,
|
||||||
|
translation: 1,
|
||||||
|
tag: 1,
|
||||||
|
};
|
||||||
|
static DIRECTIVES: Directive[] = [];
|
||||||
|
|
||||||
|
static TEMPLATES: { [name: string]: Template } = {};
|
||||||
|
|
||||||
|
static nextId: number = 1;
|
||||||
|
|
||||||
|
h = h;
|
||||||
|
// dev mode enables better error messages or more costly validations
|
||||||
|
static dev: boolean = false;
|
||||||
|
static enableTransitions: boolean = true;
|
||||||
|
|
||||||
|
// slots contains sub templates defined with t-set inside t-component nodes, and
|
||||||
|
// are meant to be used by the t-slot directive.
|
||||||
|
static slots = {};
|
||||||
|
static nextSlotId = 1;
|
||||||
|
|
||||||
|
// subTemplates are stored in two objects: a (local) mapping from a name to an
|
||||||
|
// id, and a (global) mapping from an id to the compiled function. This is
|
||||||
|
// necessary to ensure that global templates can be called with more than one
|
||||||
|
// QWeb instance.
|
||||||
|
subTemplates: { [key: string]: number } = {};
|
||||||
|
static subTemplates: { [id: number]: Function } = {};
|
||||||
|
|
||||||
|
isUpdating: boolean = false;
|
||||||
|
translateFn?: QWebConfig["translateFn"];
|
||||||
|
|
||||||
|
constructor(config: QWebConfig = {}) {
|
||||||
|
super();
|
||||||
|
this.templates = Object.create(QWeb.TEMPLATES);
|
||||||
|
if (config.templates) {
|
||||||
|
this.addTemplates(config.templates);
|
||||||
|
}
|
||||||
|
if (config.translateFn) {
|
||||||
|
this.translateFn = config.translateFn;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
static addDirective(directive: Directive) {
|
||||||
|
if (directive.name in QWeb.DIRECTIVE_NAMES) {
|
||||||
|
throw new Error(`Directive "${directive.name} already registered`);
|
||||||
|
}
|
||||||
|
QWeb.DIRECTIVES.push(directive);
|
||||||
|
QWeb.DIRECTIVE_NAMES[directive.name] = 1;
|
||||||
|
QWeb.DIRECTIVES.sort((d1, d2) => d1.priority - d2.priority);
|
||||||
|
if (directive.extraNames) {
|
||||||
|
directive.extraNames.forEach((n) => (QWeb.DIRECTIVE_NAMES[n] = 1));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
static registerComponent(name: string, Component: any) {
|
||||||
|
if (QWeb.components[name]) {
|
||||||
|
throw new Error(`Component '${name}' has already been registered`);
|
||||||
|
}
|
||||||
|
QWeb.components[name] = Component;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Register globally a template. All QWeb instances will obtain their
|
||||||
|
* templates from their own template map, and then, from the global static
|
||||||
|
* TEMPLATES property.
|
||||||
|
*/
|
||||||
|
static registerTemplate(name: string, template: string) {
|
||||||
|
if (QWeb.TEMPLATES[name]) {
|
||||||
|
throw new Error(`Template '${name}' has already been registered`);
|
||||||
|
}
|
||||||
|
const qweb = new QWeb();
|
||||||
|
qweb.addTemplate(name, template);
|
||||||
|
QWeb.TEMPLATES[name] = qweb.templates[name];
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add a template to the internal template map. Note that it is not
|
||||||
|
* immediately compiled.
|
||||||
|
*/
|
||||||
|
addTemplate(name: string, xmlString: string, allowDuplicate?: boolean) {
|
||||||
|
if (allowDuplicate && name in this.templates) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
const doc = parseXML(xmlString);
|
||||||
|
if (!doc.firstChild) {
|
||||||
|
throw new Error("Invalid template (should not be empty)");
|
||||||
|
}
|
||||||
|
this._addTemplate(name, <Element>doc.firstChild);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Load templates from a xml (as a string or xml document). This will look up
|
||||||
|
* for the first <templates> tag, and will consider each child of this as a
|
||||||
|
* template, with the name given by the t-name attribute.
|
||||||
|
*/
|
||||||
|
addTemplates(xmlstr: string | Document) {
|
||||||
|
if (!xmlstr) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
const doc = typeof xmlstr === "string" ? parseXML(xmlstr) : xmlstr;
|
||||||
|
const templates = doc.getElementsByTagName("templates")[0];
|
||||||
|
if (!templates) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
for (let elem of <any>templates.children) {
|
||||||
|
const name = elem.getAttribute("t-name");
|
||||||
|
this._addTemplate(name, elem);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
_addTemplate(name: string, elem: Element) {
|
||||||
|
if (name in this.templates) {
|
||||||
|
throw new Error(`Template ${name} already defined`);
|
||||||
|
}
|
||||||
|
this._processTemplate(elem);
|
||||||
|
const template = {
|
||||||
|
elem,
|
||||||
|
fn: function (this: QWeb, context, extra) {
|
||||||
|
const compiledFunction = this._compile(name);
|
||||||
|
template.fn = compiledFunction;
|
||||||
|
return compiledFunction.call(this, context, extra);
|
||||||
|
},
|
||||||
|
};
|
||||||
|
this.templates[name] = template;
|
||||||
|
}
|
||||||
|
|
||||||
|
_processTemplate(elem: Element) {
|
||||||
|
let tbranch = elem.querySelectorAll("[t-elif], [t-else]");
|
||||||
|
for (let i = 0, ilen = tbranch.length; i < ilen; i++) {
|
||||||
|
let node = tbranch[i];
|
||||||
|
let prevElem = node.previousElementSibling!;
|
||||||
|
let pattr = function (name) {
|
||||||
|
return prevElem.getAttribute(name);
|
||||||
|
};
|
||||||
|
let nattr = function (name) {
|
||||||
|
return +!!node.getAttribute(name);
|
||||||
|
};
|
||||||
|
if (prevElem && (pattr("t-if") || pattr("t-elif"))) {
|
||||||
|
if (pattr("t-foreach")) {
|
||||||
|
throw new Error(
|
||||||
|
"t-if cannot stay at the same level as t-foreach when using t-elif or t-else"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if (
|
||||||
|
["t-if", "t-elif", "t-else"].map(nattr).reduce(function (a, b) {
|
||||||
|
return a + b;
|
||||||
|
}) > 1
|
||||||
|
) {
|
||||||
|
throw new Error("Only one conditional branching directive is allowed per node");
|
||||||
|
}
|
||||||
|
// All text (with only spaces) and comment nodes (nodeType 8) between
|
||||||
|
// branch nodes are removed
|
||||||
|
let textNode;
|
||||||
|
while ((textNode = node.previousSibling) !== prevElem) {
|
||||||
|
if (textNode.nodeValue.trim().length && textNode.nodeType !== 8) {
|
||||||
|
throw new Error("text is not allowed between branching directives");
|
||||||
|
}
|
||||||
|
textNode.remove();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
throw new Error(
|
||||||
|
"t-elif and t-else directives must be preceded by a t-if or t-elif directive"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Render a template
|
||||||
|
*
|
||||||
|
* @param {string} name the template should already have been added
|
||||||
|
*/
|
||||||
|
render(name: string, context: EvalContext = {}, extra: any = null): VNode {
|
||||||
|
const template = this.templates[name];
|
||||||
|
if (!template) {
|
||||||
|
throw new Error(`Template ${name} does not exist`);
|
||||||
|
}
|
||||||
|
return template.fn.call(this, context, extra);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Render a template to a html string.
|
||||||
|
*
|
||||||
|
* Note that this is more limited than the `render` method: it is not suitable
|
||||||
|
* to render a full component tree, since this is an asynchronous operation.
|
||||||
|
* This method can only render templates without components.
|
||||||
|
*/
|
||||||
|
renderToString(name: string, context: EvalContext = {}, extra?: any): string {
|
||||||
|
const vnode = this.render(name, context, extra);
|
||||||
|
if (vnode.sel === undefined) {
|
||||||
|
return vnode.text!;
|
||||||
|
}
|
||||||
|
const node = document.createElement(vnode.sel);
|
||||||
|
const elem = patch(node, vnode).elm as HTMLElement;
|
||||||
|
function escapeTextNodes(node) {
|
||||||
|
if (node.nodeType === 3) {
|
||||||
|
node.textContent = escape(node.textContent);
|
||||||
|
}
|
||||||
|
for (let n of node.childNodes) {
|
||||||
|
escapeTextNodes(n);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
escapeTextNodes(elem);
|
||||||
|
return elem.outerHTML;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Force all widgets connected to this QWeb instance to rerender themselves.
|
||||||
|
*
|
||||||
|
* This method is mostly useful for external code that want to modify the
|
||||||
|
* application in some cases. For example, a router plugin.
|
||||||
|
*/
|
||||||
|
forceUpdate() {
|
||||||
|
this.isUpdating = true;
|
||||||
|
Promise.resolve().then(() => {
|
||||||
|
if (this.isUpdating) {
|
||||||
|
this.isUpdating = false;
|
||||||
|
this.trigger("update");
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
_compile(
|
||||||
|
name: string,
|
||||||
|
options: {
|
||||||
|
elem?: Element;
|
||||||
|
hasParent?: boolean;
|
||||||
|
defineKey?: boolean;
|
||||||
|
} = {}
|
||||||
|
): CompiledTemplate {
|
||||||
|
const elem = options.elem || this.templates[name].elem;
|
||||||
|
const isDebug = elem.attributes.hasOwnProperty("t-debug");
|
||||||
|
const ctx = new CompilationContext(name);
|
||||||
|
if (elem.tagName !== "t") {
|
||||||
|
ctx.shouldDefineResult = false;
|
||||||
|
}
|
||||||
|
if (options.hasParent) {
|
||||||
|
ctx.variables = Object.create(null);
|
||||||
|
ctx.parentNode = ctx.generateID();
|
||||||
|
ctx.allowMultipleRoots = true;
|
||||||
|
ctx.shouldDefineParent = true;
|
||||||
|
ctx.hasParentWidget = true;
|
||||||
|
ctx.shouldDefineResult = false;
|
||||||
|
ctx.addLine(`let c${ctx.parentNode} = extra.parentNode;`);
|
||||||
|
if (options.defineKey) {
|
||||||
|
ctx.addLine(`let key0 = extra.key || "";`);
|
||||||
|
ctx.hasKey0 = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
this._compileNode(elem, ctx);
|
||||||
|
|
||||||
|
if (!options.hasParent) {
|
||||||
|
if (ctx.shouldDefineResult) {
|
||||||
|
ctx.addLine(`return result;`);
|
||||||
|
} else {
|
||||||
|
if (!ctx.rootNode) {
|
||||||
|
throw new Error(`A template should have one root node (${ctx.templateName})`);
|
||||||
|
}
|
||||||
|
ctx.addLine(`return vn${ctx.rootNode};`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
let code = ctx.generateCode();
|
||||||
|
const templateName = ctx.templateName.replace(/`/g, "'").slice(0, 200);
|
||||||
|
code.unshift(` // Template name: "${templateName}"`);
|
||||||
|
|
||||||
|
let template;
|
||||||
|
try {
|
||||||
|
template = new Function("context, extra", code.join("\n")) as CompiledTemplate;
|
||||||
|
} catch (e) {
|
||||||
|
console.groupCollapsed(`Invalid Code generated by ${templateName}`);
|
||||||
|
console.warn(code.join("\n"));
|
||||||
|
console.groupEnd();
|
||||||
|
throw new Error(
|
||||||
|
`Invalid generated code while compiling template '${templateName}': ${e.message}`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if (isDebug) {
|
||||||
|
const tpl = this.templates[name];
|
||||||
|
if (tpl) {
|
||||||
|
const msg = `Template: ${tpl.elem.outerHTML}\nCompiled code:\n${template.toString()}`;
|
||||||
|
console.log(msg);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return template;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Generate code from an xml node
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
_compileNode(node: ChildNode, ctx: CompilationContext) {
|
||||||
|
if (!(node instanceof Element)) {
|
||||||
|
// this is a text node, there are no directive to apply
|
||||||
|
let text = node.textContent!;
|
||||||
|
if (!ctx.inPreTag) {
|
||||||
|
if (lineBreakRE.test(text) && !text.trim()) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
text = text.replace(whitespaceRE, " ");
|
||||||
|
}
|
||||||
|
if (this.translateFn) {
|
||||||
|
if ((node.parentNode as any).getAttribute("t-translation") !== "off") {
|
||||||
|
const match = translationRE.exec(text);
|
||||||
|
text = match[1] + this.translateFn(match[2]) + match[3];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (ctx.parentNode) {
|
||||||
|
if (node.nodeType === 3) {
|
||||||
|
ctx.addLine(`c${ctx.parentNode}.push({text: \`${text}\`});`);
|
||||||
|
} else if (node.nodeType === 8) {
|
||||||
|
ctx.addLine(`c${ctx.parentNode}.push(h('!', \`${text}\`));`);
|
||||||
|
}
|
||||||
|
} else if (ctx.parentTextNode) {
|
||||||
|
ctx.addLine(`vn${ctx.parentTextNode}.text += \`${text}\`;`);
|
||||||
|
} else {
|
||||||
|
// this is an unusual situation: this text node is the result of the
|
||||||
|
// template rendering.
|
||||||
|
let nodeID = ctx.generateID();
|
||||||
|
ctx.addLine(`let vn${nodeID} = {text: \`${text}\`};`);
|
||||||
|
ctx.addLine(`result = vn${nodeID};`);
|
||||||
|
ctx.rootContext.rootNode = nodeID;
|
||||||
|
ctx.rootContext.parentTextNode = nodeID;
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.tagName !== "t" && node.hasAttribute("t-call")) {
|
||||||
|
const tCallNode = document.implementation.createDocument(
|
||||||
|
"http://www.w3.org/1999/xhtml",
|
||||||
|
"t",
|
||||||
|
null
|
||||||
|
).documentElement;
|
||||||
|
tCallNode.setAttribute("t-call", node.getAttribute("t-call")!);
|
||||||
|
node.removeAttribute("t-call");
|
||||||
|
node.prepend(tCallNode);
|
||||||
|
}
|
||||||
|
|
||||||
|
const firstLetter = node.tagName[0];
|
||||||
|
if (firstLetter === firstLetter.toUpperCase()) {
|
||||||
|
// this is a component, we modify in place the xml document to change
|
||||||
|
// <SomeComponent ... /> to <SomeComponent t-component="SomeComponent" ... />
|
||||||
|
node.setAttribute("t-component", node.tagName);
|
||||||
|
} else if (node.tagName !== "t" && node.hasAttribute("t-component")) {
|
||||||
|
throw new Error(
|
||||||
|
`Directive 't-component' can only be used on <t> nodes (used on a <${node.tagName}>)`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
const attributes = (<Element>node).attributes;
|
||||||
|
|
||||||
|
const validDirectives: {
|
||||||
|
directive: Directive;
|
||||||
|
value: string;
|
||||||
|
fullName: string;
|
||||||
|
}[] = [];
|
||||||
|
|
||||||
|
const finalizers: typeof validDirectives = [];
|
||||||
|
|
||||||
|
// maybe this is not optimal: we iterate on all attributes here, and again
|
||||||
|
// just after for each directive.
|
||||||
|
for (let i = 0; i < attributes.length; i++) {
|
||||||
|
let attrName = attributes[i].name;
|
||||||
|
if (attrName.startsWith("t-")) {
|
||||||
|
let dName = attrName.slice(2).split(/-|\./)[0];
|
||||||
|
if (!(dName in QWeb.DIRECTIVE_NAMES)) {
|
||||||
|
throw new Error(`Unknown QWeb directive: '${attrName}'`);
|
||||||
|
}
|
||||||
|
if (
|
||||||
|
node.tagName !== "t" &&
|
||||||
|
(attrName === "t-esc" || attrName === "t-out" || attrName === "t-raw")
|
||||||
|
) {
|
||||||
|
const tNode = document.implementation.createDocument(
|
||||||
|
"http://www.w3.org/1999/xhtml",
|
||||||
|
"t",
|
||||||
|
null
|
||||||
|
).documentElement;
|
||||||
|
tNode.setAttribute(attrName, node.getAttribute(attrName)!);
|
||||||
|
for (let child of Array.from(node.childNodes)) {
|
||||||
|
tNode.appendChild(child);
|
||||||
|
}
|
||||||
|
node.appendChild(tNode);
|
||||||
|
node.removeAttribute(attrName);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const DIR_N = QWeb.DIRECTIVES.length;
|
||||||
|
const ATTR_N = attributes.length;
|
||||||
|
let withHandlers = false;
|
||||||
|
for (let i = 0; i < DIR_N; i++) {
|
||||||
|
let directive = QWeb.DIRECTIVES[i];
|
||||||
|
let fullName;
|
||||||
|
let value;
|
||||||
|
for (let j = 0; j < ATTR_N; j++) {
|
||||||
|
const name = attributes[j].name;
|
||||||
|
if (
|
||||||
|
name === "t-" + directive.name ||
|
||||||
|
name.startsWith("t-" + directive.name + "-") ||
|
||||||
|
name.startsWith("t-" + directive.name + ".")
|
||||||
|
) {
|
||||||
|
fullName = name;
|
||||||
|
value = attributes[j].textContent;
|
||||||
|
validDirectives.push({ directive, value, fullName });
|
||||||
|
if (directive.name === "on" || directive.name === "model") {
|
||||||
|
withHandlers = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
for (let { directive, value, fullName } of validDirectives) {
|
||||||
|
if (directive.finalize) {
|
||||||
|
finalizers.push({ directive, value, fullName });
|
||||||
|
}
|
||||||
|
if (directive.atNodeEncounter) {
|
||||||
|
const isDone = directive.atNodeEncounter({
|
||||||
|
node,
|
||||||
|
qweb: this,
|
||||||
|
ctx,
|
||||||
|
fullName,
|
||||||
|
value,
|
||||||
|
});
|
||||||
|
if (isDone) {
|
||||||
|
for (let { directive, value, fullName } of finalizers) {
|
||||||
|
directive.finalize!({ node, qweb: this, ctx, fullName, value });
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (node.nodeName !== "t" || node.hasAttribute("t-tag")) {
|
||||||
|
let nodeHooks = {};
|
||||||
|
let addNodeHook = function (hook, handler) {
|
||||||
|
nodeHooks[hook] = nodeHooks[hook] || [];
|
||||||
|
nodeHooks[hook].push(handler);
|
||||||
|
};
|
||||||
|
if (node.tagName === "select" && node.hasAttribute("t-att-value")) {
|
||||||
|
const value = node.getAttribute("t-att-value");
|
||||||
|
let exprId = ctx.generateID();
|
||||||
|
ctx.addLine(`let expr${exprId} = ${ctx.formatExpression(value)};`);
|
||||||
|
let expr = `expr${exprId}`;
|
||||||
|
node.setAttribute("t-att-value", expr);
|
||||||
|
addNodeHook("create", `n.elm.value=${expr};`);
|
||||||
|
}
|
||||||
|
let nodeID = this._compileGenericNode(node, ctx, withHandlers);
|
||||||
|
ctx = ctx.withParent(nodeID);
|
||||||
|
|
||||||
|
for (let { directive, value, fullName } of validDirectives) {
|
||||||
|
if (directive.atNodeCreation) {
|
||||||
|
directive.atNodeCreation({
|
||||||
|
node,
|
||||||
|
qweb: this,
|
||||||
|
ctx,
|
||||||
|
fullName,
|
||||||
|
value,
|
||||||
|
nodeID,
|
||||||
|
addNodeHook,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (Object.keys(nodeHooks).length) {
|
||||||
|
ctx.addLine(`p${nodeID}.hook = {`);
|
||||||
|
for (let hook in nodeHooks) {
|
||||||
|
ctx.addLine(` ${hook}: ${NODE_HOOKS_PARAMS[hook]} => {`);
|
||||||
|
for (let handler of nodeHooks[hook]) {
|
||||||
|
ctx.addLine(` ${handler}`);
|
||||||
|
}
|
||||||
|
ctx.addLine(` },`);
|
||||||
|
}
|
||||||
|
ctx.addLine(`};`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (node.nodeName === "pre") {
|
||||||
|
ctx = ctx.subContext("inPreTag", true);
|
||||||
|
}
|
||||||
|
|
||||||
|
this._compileChildren(node, ctx);
|
||||||
|
// svg support
|
||||||
|
// we hadd svg namespace if it is a svg or if it is a g, but only if it is
|
||||||
|
// the root node. This is the easiest way to support svg sub components:
|
||||||
|
// they need to have a g tag as root. Otherwise, we would need a complete
|
||||||
|
// list of allowed svg tags.
|
||||||
|
const shouldAddNS =
|
||||||
|
node.nodeName === "svg" || (node.nodeName === "g" && ctx.rootNode === ctx.parentNode);
|
||||||
|
if (shouldAddNS) {
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
ctx.addLine(`utils.addNameSpace(vn${ctx.parentNode});`);
|
||||||
|
}
|
||||||
|
|
||||||
|
for (let { directive, value, fullName } of finalizers) {
|
||||||
|
directive.finalize!({ node, qweb: this, ctx, fullName, value });
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
_compileGenericNode(
|
||||||
|
node: ChildNode,
|
||||||
|
ctx: CompilationContext,
|
||||||
|
withHandlers: boolean = true
|
||||||
|
): number {
|
||||||
|
// nodeType 1 is generic tag
|
||||||
|
if (node.nodeType !== 1) {
|
||||||
|
throw new Error("unsupported node type");
|
||||||
|
}
|
||||||
|
const attributes = (<Element>node).attributes;
|
||||||
|
const attrs: string[] = [];
|
||||||
|
const props: string[] = [];
|
||||||
|
const tattrs: number[] = [];
|
||||||
|
|
||||||
|
function handleProperties(key, val) {
|
||||||
|
let isProp = false;
|
||||||
|
switch (node.nodeName) {
|
||||||
|
case "input":
|
||||||
|
let type = (<Element>node).getAttribute("type");
|
||||||
|
if (type === "checkbox" || type === "radio") {
|
||||||
|
if (key === "checked" || key === "indeterminate") {
|
||||||
|
isProp = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (key === "value" || key === "readonly" || key === "disabled") {
|
||||||
|
isProp = true;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
case "option":
|
||||||
|
isProp = key === "selected" || key === "disabled";
|
||||||
|
break;
|
||||||
|
case "textarea":
|
||||||
|
isProp = key === "readonly" || key === "disabled" || key === "value";
|
||||||
|
break;
|
||||||
|
case "select":
|
||||||
|
isProp = key === "disabled" || key === "value";
|
||||||
|
break;
|
||||||
|
case "button":
|
||||||
|
case "optgroup":
|
||||||
|
isProp = key === "disabled";
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
if (isProp) {
|
||||||
|
props.push(`${key}: ${val}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
let classObj = "";
|
||||||
|
|
||||||
|
for (let i = 0; i < attributes.length; i++) {
|
||||||
|
let name = attributes[i].name;
|
||||||
|
let value = attributes[i].textContent!;
|
||||||
|
|
||||||
|
if (this.translateFn && TRANSLATABLE_ATTRS.includes(name)) {
|
||||||
|
value = this.translateFn(value);
|
||||||
|
}
|
||||||
|
|
||||||
|
// regular attributes
|
||||||
|
if (!name.startsWith("t-") && !(<Element>node).getAttribute("t-attf-" + name)) {
|
||||||
|
const attID = ctx.generateID();
|
||||||
|
if (name === "class") {
|
||||||
|
if ((value = value.trim())) {
|
||||||
|
let classDef = value
|
||||||
|
.split(/\s+/)
|
||||||
|
.map((a) => `'${escapeQuotes(a)}':true`)
|
||||||
|
.join(",");
|
||||||
|
if (classObj) {
|
||||||
|
ctx.addLine(`Object.assign(${classObj}, {${classDef}})`);
|
||||||
|
} else {
|
||||||
|
classObj = `_${ctx.generateID()}`;
|
||||||
|
ctx.addLine(`let ${classObj} = {${classDef}};`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
ctx.addLine(`let _${attID} = '${escapeQuotes(value)}';`);
|
||||||
|
if (!name.match(/^[a-zA-Z]+$/)) {
|
||||||
|
// attribute contains 'non letters' => we want to quote it
|
||||||
|
name = '"' + name + '"';
|
||||||
|
}
|
||||||
|
attrs.push(`${name}: _${attID}`);
|
||||||
|
handleProperties(name, `_${attID}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// dynamic attributes
|
||||||
|
if (name.startsWith("t-att-")) {
|
||||||
|
let attName = name.slice(6);
|
||||||
|
const v = ctx.getValue(value);
|
||||||
|
let formattedValue = typeof v === "string" ? ctx.formatExpression(v) : `scope.${v.id}`;
|
||||||
|
|
||||||
|
if (attName === "class") {
|
||||||
|
ctx.rootContext.shouldDefineUtils = true;
|
||||||
|
formattedValue = `utils.toClassObj(${formattedValue})`;
|
||||||
|
if (classObj) {
|
||||||
|
ctx.addLine(`Object.assign(${classObj}, ${formattedValue})`);
|
||||||
|
} else {
|
||||||
|
classObj = `_${ctx.generateID()}`;
|
||||||
|
ctx.addLine(`let ${classObj} = ${formattedValue};`);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
const attID = ctx.generateID();
|
||||||
|
if (!attName.match(/^[a-zA-Z]+$/)) {
|
||||||
|
// attribute contains 'non letters' => we want to quote it
|
||||||
|
attName = '"' + attName + '"';
|
||||||
|
}
|
||||||
|
// we need to combine dynamic with non dynamic attributes:
|
||||||
|
// class="a" t-att-class="'yop'" should be rendered as class="a yop"
|
||||||
|
const attValue = (<Element>node).getAttribute(attName);
|
||||||
|
if (attValue) {
|
||||||
|
const attValueID = ctx.generateID();
|
||||||
|
ctx.addLine(`let _${attValueID} = ${formattedValue};`);
|
||||||
|
formattedValue = `'${attValue}' + (_${attValueID} ? ' ' + _${attValueID} : '')`;
|
||||||
|
const attrIndex = attrs.findIndex((att) => att.startsWith(attName + ":"));
|
||||||
|
attrs.splice(attrIndex, 1);
|
||||||
|
}
|
||||||
|
if (node.nodeName === "select" && attName === "value") {
|
||||||
|
attrs.push(`${attName}: ${v}`);
|
||||||
|
handleProperties(attName, v);
|
||||||
|
} else {
|
||||||
|
ctx.addLine(`let _${attID} = ${formattedValue};`);
|
||||||
|
attrs.push(`${attName}: _${attID}`);
|
||||||
|
handleProperties(attName, "_" + attID);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (name.startsWith("t-attf-")) {
|
||||||
|
let attName = name.slice(7);
|
||||||
|
if (!attName.match(/^[a-zA-Z]+$/)) {
|
||||||
|
// attribute contains 'non letters' => we want to quote it
|
||||||
|
attName = '"' + attName + '"';
|
||||||
|
}
|
||||||
|
const formattedExpr = ctx.interpolate(value);
|
||||||
|
const attID = ctx.generateID();
|
||||||
|
let staticVal = (<Element>node).getAttribute(attName);
|
||||||
|
if (staticVal) {
|
||||||
|
ctx.addLine(`let _${attID} = '${staticVal} ' + ${formattedExpr};`);
|
||||||
|
} else {
|
||||||
|
ctx.addLine(`let _${attID} = ${formattedExpr};`);
|
||||||
|
}
|
||||||
|
attrs.push(`${attName}: _${attID}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
// t-att= attributes
|
||||||
|
if (name === "t-att") {
|
||||||
|
let id = ctx.generateID();
|
||||||
|
ctx.addLine(`let _${id} = ${ctx.formatExpression(value!)};`);
|
||||||
|
tattrs.push(id);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
let nodeID = ctx.generateID();
|
||||||
|
let key = ctx.loopNumber || ctx.hasKey0 ? `\`\${key${ctx.loopNumber}}_${nodeID}\`` : nodeID;
|
||||||
|
const parts = [`key:${key}`];
|
||||||
|
if (attrs.length + tattrs.length > 0) {
|
||||||
|
parts.push(`attrs:{${attrs.join(",")}}`);
|
||||||
|
}
|
||||||
|
if (props.length > 0) {
|
||||||
|
parts.push(`props:{${props.join(",")}}`);
|
||||||
|
}
|
||||||
|
if (classObj) {
|
||||||
|
parts.push(`class:${classObj}`);
|
||||||
|
}
|
||||||
|
if (withHandlers) {
|
||||||
|
parts.push(`on:{}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
ctx.addLine(`let c${nodeID} = [], p${nodeID} = {${parts.join(",")}};`);
|
||||||
|
for (let id of tattrs) {
|
||||||
|
ctx.addIf(`_${id} instanceof Array`);
|
||||||
|
ctx.addLine(`p${nodeID}.attrs[_${id}[0]] = _${id}[1];`);
|
||||||
|
ctx.addElse();
|
||||||
|
ctx.addLine(`for (let key in _${id}) {`);
|
||||||
|
ctx.indent();
|
||||||
|
ctx.addLine(`p${nodeID}.attrs[key] = _${id}[key];`);
|
||||||
|
ctx.dedent();
|
||||||
|
ctx.addLine(`}`);
|
||||||
|
ctx.closeIf();
|
||||||
|
}
|
||||||
|
let nodeName = `'${node.nodeName}'`;
|
||||||
|
if ((<Element>node).hasAttribute("t-tag")) {
|
||||||
|
const tagExpr = (<Element>node).getAttribute("t-tag");
|
||||||
|
(<Element>node).removeAttribute("t-tag");
|
||||||
|
nodeName = `tag${ctx.generateID()}`;
|
||||||
|
ctx.addLine(`let ${nodeName} = ${ctx.formatExpression(tagExpr)};`);
|
||||||
|
}
|
||||||
|
ctx.addLine(`let vn${nodeID} = h(${nodeName}, p${nodeID}, c${nodeID});`);
|
||||||
|
if (ctx.parentNode) {
|
||||||
|
ctx.addLine(`c${ctx.parentNode}.push(vn${nodeID});`);
|
||||||
|
} else if (ctx.loopNumber || ctx.hasKey0) {
|
||||||
|
ctx.rootContext.shouldDefineResult = true;
|
||||||
|
ctx.addLine(`result = vn${nodeID};`);
|
||||||
|
}
|
||||||
|
|
||||||
|
return nodeID;
|
||||||
|
}
|
||||||
|
|
||||||
|
_compileChildren(node: ChildNode, ctx: CompilationContext) {
|
||||||
|
if (node.childNodes.length > 0) {
|
||||||
|
for (let child of Array.from(node.childNodes)) {
|
||||||
|
this._compileNode(child, ctx);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,241 +0,0 @@
|
|||||||
import { onWillUnmount } from "./component/lifecycle_hooks";
|
|
||||||
import { ComponentNode, getCurrent } from "./component/component_node";
|
|
||||||
|
|
||||||
// Allows to get the target of a Reactive (used for making a new Reactive from the underlying object)
|
|
||||||
const TARGET = Symbol("Target");
|
|
||||||
// Special key to subscribe to, to be notified of key creation/deletion
|
|
||||||
const KEYCHANGES = Symbol("Key changes");
|
|
||||||
|
|
||||||
type ObjectKey = string | number | symbol;
|
|
||||||
type Target = object;
|
|
||||||
type Callback = () => void;
|
|
||||||
type Reactive<T extends Target = Target> = T & {
|
|
||||||
[TARGET]: any;
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Checks whether a given value can be made into a reactive object.
|
|
||||||
*
|
|
||||||
* @param value the value to check
|
|
||||||
* @returns whether the value can be made reactive
|
|
||||||
*/
|
|
||||||
function canBeMadeReactive(value: any): boolean {
|
|
||||||
return (
|
|
||||||
typeof value === "object" &&
|
|
||||||
value !== null &&
|
|
||||||
!(value instanceof Date) &&
|
|
||||||
!(value instanceof Promise) &&
|
|
||||||
!(value instanceof String) &&
|
|
||||||
!(value instanceof Number)
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
const targetToKeysToCallbacks = new WeakMap<Target, Map<ObjectKey, Set<Callback>>>();
|
|
||||||
/**
|
|
||||||
* Observes a given key on a target with an callback. The callback will be
|
|
||||||
* called when the given key changes on the target.
|
|
||||||
*
|
|
||||||
* @param target the target whose key should be observed
|
|
||||||
* @param key the key to observe (or Symbol(KEYCHANGES) for key creation
|
|
||||||
* or deletion)
|
|
||||||
* @param callback the function to call when the key changes
|
|
||||||
*/
|
|
||||||
function observeTargetKey(target: Target, key: ObjectKey, callback: Callback): void {
|
|
||||||
if (!targetToKeysToCallbacks.get(target)) {
|
|
||||||
targetToKeysToCallbacks.set(target, new Map());
|
|
||||||
}
|
|
||||||
const keyToCallbacks = targetToKeysToCallbacks.get(target)!;
|
|
||||||
if (!keyToCallbacks.get(key)) {
|
|
||||||
keyToCallbacks.set(key, new Set());
|
|
||||||
}
|
|
||||||
keyToCallbacks.get(key)!.add(callback);
|
|
||||||
if (!callbacksToTargets.has(callback)) {
|
|
||||||
callbacksToTargets.set(callback, new Set());
|
|
||||||
}
|
|
||||||
callbacksToTargets.get(callback)!.add(target);
|
|
||||||
}
|
|
||||||
/**
|
|
||||||
* Notify Reactives that are observing a given target that a key has changed on
|
|
||||||
* the target.
|
|
||||||
*
|
|
||||||
* @param target target whose Reactives should be notified that the target was
|
|
||||||
* changed.
|
|
||||||
* @param key the key that changed (or Symbol `KEYCHANGES` if a key was created
|
|
||||||
* or deleted)
|
|
||||||
*/
|
|
||||||
function notifyReactives(target: Target, key: ObjectKey): void {
|
|
||||||
const keyToCallbacks = targetToKeysToCallbacks.get(target);
|
|
||||||
if (!keyToCallbacks) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
const callbacks = keyToCallbacks.get(key);
|
|
||||||
if (!callbacks) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
// Loop on copy because clearReactivesForCallback will modify the set in place
|
|
||||||
for (const callback of [...callbacks]) {
|
|
||||||
clearReactivesForCallback(callback);
|
|
||||||
callback();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
const callbacksToTargets = new WeakMap<Callback, Set<Target>>();
|
|
||||||
/**
|
|
||||||
* Clears all subscriptions of the Reactives associated with a given callback.
|
|
||||||
*
|
|
||||||
* @param callback the callback for which the reactives need to be cleared
|
|
||||||
*/
|
|
||||||
function clearReactivesForCallback(callback: Callback): void {
|
|
||||||
const targetsToClear = callbacksToTargets.get(callback);
|
|
||||||
if (!targetsToClear) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
for (const target of targetsToClear) {
|
|
||||||
const observedKeys = targetToKeysToCallbacks.get(target);
|
|
||||||
if (!observedKeys) {
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
for (const callbacks of observedKeys.values()) {
|
|
||||||
callbacks.delete(callback);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
targetsToClear.clear();
|
|
||||||
}
|
|
||||||
|
|
||||||
const reactiveCache = new WeakMap<Target, WeakMap<Callback, Reactive>>();
|
|
||||||
/**
|
|
||||||
* Creates a reactive proxy for an object. Reading data on the reactive object
|
|
||||||
* subscribes to changes to the data. Writing data on the object will cause the
|
|
||||||
* notify callback to be called if there are suscriptions to that data. Nested
|
|
||||||
* objects and arrays are automatically made reactive as well.
|
|
||||||
*
|
|
||||||
* Whenever you are notified of a change, all subscriptions are cleared, and if
|
|
||||||
* you would like to be notified of any further changes, you should go read
|
|
||||||
* the underlying data again. We assume that if you don't go read it again after
|
|
||||||
* being notified, it means that you are no longer interested in that data.
|
|
||||||
*
|
|
||||||
* Subscriptions:
|
|
||||||
* + Reading a property on an object will subscribe you to changes in the value
|
|
||||||
* of that property.
|
|
||||||
* + Accessing an object keys (eg with Object.keys or with `for..in`) will
|
|
||||||
* subscribe you to the creation/deletion of keys. Checking the presence of a
|
|
||||||
* key on the object with 'in' has the same effect.
|
|
||||||
* - getOwnPropertyDescriptor does not currently subscribe you to the property.
|
|
||||||
* This is a choice that was made because changing a key's value will trigger
|
|
||||||
* this trap and we do not want to subscribe by writes. This also means that
|
|
||||||
* Object.hasOwnProperty doesn't subscribe as it goes through this trap.
|
|
||||||
*
|
|
||||||
* @param target the object for which to create a reactive proxy
|
|
||||||
* @param callback the function to call when an observed property of the
|
|
||||||
* reactive has changed
|
|
||||||
* @returns a proxy that tracks changes to it
|
|
||||||
*/
|
|
||||||
export function reactive<T extends Target>(target: T, callback: Callback = () => {}): Reactive<T> {
|
|
||||||
if (!canBeMadeReactive(target)) {
|
|
||||||
throw new Error(`Cannot make the given value reactive`);
|
|
||||||
}
|
|
||||||
const originalTarget = (target as Reactive)[TARGET];
|
|
||||||
if (originalTarget) {
|
|
||||||
return reactive(originalTarget, callback);
|
|
||||||
}
|
|
||||||
if (!reactiveCache.has(target)) {
|
|
||||||
reactiveCache.set(target, new Map());
|
|
||||||
}
|
|
||||||
const reactivesForTarget = reactiveCache.get(target)!;
|
|
||||||
if (!reactivesForTarget.has(callback)) {
|
|
||||||
const proxy = new Proxy(target, {
|
|
||||||
get(target: any, key: ObjectKey, proxy: Reactive<T>) {
|
|
||||||
if (key === TARGET) {
|
|
||||||
return target;
|
|
||||||
}
|
|
||||||
observeTargetKey(target, key, callback);
|
|
||||||
const value = Reflect.get(target, key, proxy);
|
|
||||||
if (!canBeMadeReactive(value)) {
|
|
||||||
return value;
|
|
||||||
}
|
|
||||||
return reactive(value, callback);
|
|
||||||
},
|
|
||||||
set(target, key, value, proxy) {
|
|
||||||
const isNewKey = !Object.hasOwnProperty.call(target, key);
|
|
||||||
const originalValue = Reflect.get(target, key, proxy);
|
|
||||||
const ret = Reflect.set(target, key, value, proxy);
|
|
||||||
if (isNewKey) {
|
|
||||||
notifyReactives(target, KEYCHANGES);
|
|
||||||
}
|
|
||||||
// While Array length may trigger the set trap, it's not actually set by this
|
|
||||||
// method but is updated behind the scenes, and the trap is not called with the
|
|
||||||
// new value. We disable the "same-value-optimization" for it because of that.
|
|
||||||
if (originalValue !== value || (Array.isArray(target) && key === "length")) {
|
|
||||||
notifyReactives(target, key);
|
|
||||||
}
|
|
||||||
return ret;
|
|
||||||
},
|
|
||||||
deleteProperty(target, key) {
|
|
||||||
const ret = Reflect.deleteProperty(target, key);
|
|
||||||
notifyReactives(target, KEYCHANGES);
|
|
||||||
notifyReactives(target, key);
|
|
||||||
return ret;
|
|
||||||
},
|
|
||||||
ownKeys(target) {
|
|
||||||
observeTargetKey(target, KEYCHANGES, callback);
|
|
||||||
return Reflect.ownKeys(target);
|
|
||||||
},
|
|
||||||
has(target, key) {
|
|
||||||
// TODO: this observes all key changes instead of only the presence of the argument key
|
|
||||||
observeTargetKey(target, KEYCHANGES, callback);
|
|
||||||
return Reflect.has(target, key);
|
|
||||||
},
|
|
||||||
});
|
|
||||||
reactivesForTarget.set(callback, proxy);
|
|
||||||
}
|
|
||||||
return reactivesForTarget.get(callback) as Reactive<T>;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Creates a batched version of a callback so that all calls to it in the same
|
|
||||||
* microtick will only call the original callback once.
|
|
||||||
*
|
|
||||||
* @param callback the callback to batch
|
|
||||||
* @returns a batched version of the original callback
|
|
||||||
*/
|
|
||||||
export function batched(callback: Callback): Callback {
|
|
||||||
let called = false;
|
|
||||||
return async () => {
|
|
||||||
// This await blocks all calls to the callback here, then releases them sequentially
|
|
||||||
// in the next microtick. This line decides the granularity of the batch.
|
|
||||||
await Promise.resolve();
|
|
||||||
if (!called) {
|
|
||||||
called = true;
|
|
||||||
callback();
|
|
||||||
// wait for all calls in this microtick to fall through before resetting "called"
|
|
||||||
// so that only the first call to the batched function calls the original callback
|
|
||||||
await Promise.resolve();
|
|
||||||
called = false;
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
const batchedRenderFunctions = new WeakMap<ComponentNode, Callback>();
|
|
||||||
/**
|
|
||||||
* Creates a reactive object that will be observed by the current component.
|
|
||||||
* Reading data from the returned object (eg during rendering) will cause the
|
|
||||||
* component to subscribe to that data and be rerendered when it changes.
|
|
||||||
*
|
|
||||||
* @param state the state to observe
|
|
||||||
* @returns a reactive object that will cause the component to re-render on
|
|
||||||
* relevant changes
|
|
||||||
* @see reactive
|
|
||||||
*/
|
|
||||||
export function useState<T extends object>(state: T): Reactive<T> {
|
|
||||||
const node = getCurrent()!;
|
|
||||||
if (!batchedRenderFunctions.has(node)) {
|
|
||||||
batchedRenderFunctions.set(
|
|
||||||
node,
|
|
||||||
batched(() => node.render())
|
|
||||||
);
|
|
||||||
onWillUnmount(() => clearReactivesForCallback(render));
|
|
||||||
}
|
|
||||||
const render = batchedRenderFunctions.get(node)!;
|
|
||||||
const reactiveState = reactive(state, render);
|
|
||||||
return reactiveState;
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,48 @@
|
|||||||
|
import { Component } from "../component/component";
|
||||||
|
import { xml } from "../tags";
|
||||||
|
import { Destination, RouterEnv } from "./router";
|
||||||
|
|
||||||
|
type Props = Destination;
|
||||||
|
|
||||||
|
export class Link<Env extends RouterEnv> extends Component<Props, Env> {
|
||||||
|
static template = xml`
|
||||||
|
<a t-att-class="{'router-link-active': isActive }"
|
||||||
|
t-att-href="href"
|
||||||
|
t-on-click="navigate">
|
||||||
|
<t t-slot="default"/>
|
||||||
|
</a>
|
||||||
|
`;
|
||||||
|
|
||||||
|
href: string = this.env.router.destToPath(this.props);
|
||||||
|
|
||||||
|
async willUpdateProps(nextProps) {
|
||||||
|
this.href = this.env.router.destToPath(nextProps);
|
||||||
|
}
|
||||||
|
|
||||||
|
get isActive() {
|
||||||
|
if (this.env.router.mode === "hash") {
|
||||||
|
return (<any>document.location).hash === this.href;
|
||||||
|
}
|
||||||
|
return (<any>document.location).pathname === this.href;
|
||||||
|
}
|
||||||
|
|
||||||
|
navigate(ev) {
|
||||||
|
// don't redirect with control keys
|
||||||
|
if (ev.metaKey || ev.altKey || ev.ctrlKey || ev.shiftKey) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
// don't redirect on right click
|
||||||
|
if (ev.button !== undefined && ev.button !== 0) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
// don't redirect if `target="_blank"`
|
||||||
|
if (ev.currentTarget && ev.currentTarget.getAttribute) {
|
||||||
|
const target = ev.currentTarget.getAttribute("target");
|
||||||
|
if (/\b_blank\b/i.test(target)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
ev.preventDefault();
|
||||||
|
this.env.router.navigate(this.props);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
import { Component } from "../component/component";
|
||||||
|
import { xml } from "../tags";
|
||||||
|
import { EnvWithRouter } from "./router";
|
||||||
|
|
||||||
|
export class RouteComponent extends Component<{}, EnvWithRouter> {
|
||||||
|
static template = xml`
|
||||||
|
<t>
|
||||||
|
<t
|
||||||
|
t-if="routeComponent"
|
||||||
|
t-component="routeComponent"
|
||||||
|
t-key="env.router.currentRouteName"
|
||||||
|
t-props="env.router.currentParams" />
|
||||||
|
</t>
|
||||||
|
`;
|
||||||
|
|
||||||
|
get routeComponent(): any {
|
||||||
|
return this.env.router.currentRoute && this.env.router.currentRoute.component;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,294 @@
|
|||||||
|
import { Env } from "../component/component";
|
||||||
|
import { QWeb } from "../qweb/index";
|
||||||
|
import { shallowEqual } from "../utils";
|
||||||
|
|
||||||
|
type NavigationGuard = (info: {
|
||||||
|
env: Env;
|
||||||
|
to: Route | null;
|
||||||
|
from: Route | null;
|
||||||
|
}) => boolean | Destination;
|
||||||
|
|
||||||
|
export interface Route {
|
||||||
|
name: string;
|
||||||
|
path: string;
|
||||||
|
extractionRegExp: RegExp;
|
||||||
|
component?: any;
|
||||||
|
redirect?: Destination;
|
||||||
|
params: string[];
|
||||||
|
beforeRouteEnter?: NavigationGuard;
|
||||||
|
}
|
||||||
|
|
||||||
|
export type RouteParams = { [key: string]: string | number };
|
||||||
|
|
||||||
|
export interface RouterEnv extends Env {
|
||||||
|
router: Router;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface Destination {
|
||||||
|
path?: string;
|
||||||
|
to?: string;
|
||||||
|
params?: RouteParams;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface PositiveMatchResult {
|
||||||
|
type: "match";
|
||||||
|
route: Route;
|
||||||
|
params: RouteParams;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface NegativeMatchResult {
|
||||||
|
type: "nomatch";
|
||||||
|
}
|
||||||
|
|
||||||
|
interface CancelledMatch {
|
||||||
|
type: "cancelled";
|
||||||
|
}
|
||||||
|
|
||||||
|
type MatchResult = PositiveMatchResult | NegativeMatchResult | CancelledMatch;
|
||||||
|
|
||||||
|
interface Options {
|
||||||
|
mode: Router["mode"];
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface EnvWithRouter extends Env {
|
||||||
|
router: Router;
|
||||||
|
}
|
||||||
|
|
||||||
|
const paramRegexp = /\{\{(.*?)\}\}/;
|
||||||
|
const globalParamRegexp = new RegExp(paramRegexp.source, "g");
|
||||||
|
|
||||||
|
export class Router {
|
||||||
|
currentRoute: Route | null = null;
|
||||||
|
currentParams: RouteParams | null = null;
|
||||||
|
mode: "history" | "hash";
|
||||||
|
|
||||||
|
routes: { [id: string]: Route };
|
||||||
|
routeIds: string[];
|
||||||
|
env: RouterEnv;
|
||||||
|
|
||||||
|
constructor(
|
||||||
|
env: Partial<EnvWithRouter>,
|
||||||
|
routes: Partial<Route>[],
|
||||||
|
options: Options = { mode: "history" }
|
||||||
|
) {
|
||||||
|
env.router = this;
|
||||||
|
this.mode = options.mode;
|
||||||
|
this.env = env as RouterEnv;
|
||||||
|
|
||||||
|
this.routes = {};
|
||||||
|
this.routeIds = [];
|
||||||
|
let nextId = 1;
|
||||||
|
for (let partialRoute of routes) {
|
||||||
|
if (!partialRoute.name) {
|
||||||
|
partialRoute.name = "__route__" + nextId++;
|
||||||
|
}
|
||||||
|
if (partialRoute.component) {
|
||||||
|
QWeb.registerComponent("__component__" + partialRoute.name, partialRoute.component);
|
||||||
|
}
|
||||||
|
if (partialRoute.redirect) {
|
||||||
|
this.validateDestination(partialRoute.redirect);
|
||||||
|
}
|
||||||
|
partialRoute.params = partialRoute.path ? findParams(partialRoute.path) : [];
|
||||||
|
partialRoute.extractionRegExp = makeExtractionRegExp(partialRoute.path);
|
||||||
|
this.routes[partialRoute.name] = partialRoute as Route;
|
||||||
|
this.routeIds.push(partialRoute.name);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
//--------------------------------------------------------------------------
|
||||||
|
// Public API
|
||||||
|
//--------------------------------------------------------------------------
|
||||||
|
|
||||||
|
async start() {
|
||||||
|
(this as any)._listener = (ev) => this._navigate(this.currentPath(), ev);
|
||||||
|
window.addEventListener("popstate", (this as any)._listener);
|
||||||
|
if (this.mode === "hash") {
|
||||||
|
window.addEventListener("hashchange", (this as any)._listener);
|
||||||
|
}
|
||||||
|
const result = await this.matchAndApplyRules(this.currentPath());
|
||||||
|
if (result.type === "match") {
|
||||||
|
this.currentRoute = result.route;
|
||||||
|
this.currentParams = result.params;
|
||||||
|
const currentPath = this.routeToPath(result.route, result.params);
|
||||||
|
if (currentPath !== this.currentPath()) {
|
||||||
|
this.setUrlFromPath(currentPath);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async navigate(to: Destination): Promise<boolean> {
|
||||||
|
const path = this.destToPath(to);
|
||||||
|
return this._navigate(path);
|
||||||
|
}
|
||||||
|
async _navigate(path: string, ev?: any): Promise<boolean> {
|
||||||
|
const initialName = this.currentRouteName;
|
||||||
|
const initialParams = this.currentParams;
|
||||||
|
const result = await this.matchAndApplyRules(path);
|
||||||
|
if (result.type === "match") {
|
||||||
|
let finalPath = this.routeToPath(result.route, result.params);
|
||||||
|
if (path.indexOf("?") > -1) {
|
||||||
|
finalPath += "?" + path.split("?")[1];
|
||||||
|
}
|
||||||
|
const isPopStateEvent = ev && ev instanceof PopStateEvent;
|
||||||
|
if (!isPopStateEvent) {
|
||||||
|
this.setUrlFromPath(finalPath);
|
||||||
|
}
|
||||||
|
this.currentRoute = result.route;
|
||||||
|
this.currentParams = result.params;
|
||||||
|
} else if (result.type === "nomatch") {
|
||||||
|
this.currentRoute = null;
|
||||||
|
this.currentParams = null;
|
||||||
|
}
|
||||||
|
const didChange =
|
||||||
|
this.currentRouteName !== initialName || !shallowEqual(this.currentParams, initialParams);
|
||||||
|
if (didChange) {
|
||||||
|
this.env.qweb.forceUpdate();
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
destToPath(dest: Destination): string {
|
||||||
|
this.validateDestination(dest);
|
||||||
|
return dest.path || this.routeToPath(this.routes[dest.to!], dest.params!);
|
||||||
|
}
|
||||||
|
|
||||||
|
get currentRouteName(): string | null {
|
||||||
|
return this.currentRoute && this.currentRoute.name;
|
||||||
|
}
|
||||||
|
|
||||||
|
//--------------------------------------------------------------------------
|
||||||
|
// Private helpers
|
||||||
|
//--------------------------------------------------------------------------
|
||||||
|
|
||||||
|
private setUrlFromPath(path: string) {
|
||||||
|
const separator = this.mode === "hash" ? location.pathname : "";
|
||||||
|
const url = location.origin + separator + path;
|
||||||
|
if (url !== window.location.href) {
|
||||||
|
window.history.pushState({}, path, url);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private validateDestination(dest: Destination) {
|
||||||
|
if ((!dest.path && !dest.to) || (dest.path && dest.to)) {
|
||||||
|
throw new Error(`Invalid destination: ${JSON.stringify(dest)}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private routeToPath(route: Route, params: RouteParams): string {
|
||||||
|
const prefix = this.mode === "hash" ? "#" : "";
|
||||||
|
return (
|
||||||
|
prefix +
|
||||||
|
route.path.replace(globalParamRegexp, (match, param) => {
|
||||||
|
const [key] = param.split(".");
|
||||||
|
return <string>params[key];
|
||||||
|
})
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
private currentPath(): string {
|
||||||
|
let result = this.mode === "history" ? window.location.pathname : window.location.hash.slice(1);
|
||||||
|
return result || "/";
|
||||||
|
}
|
||||||
|
|
||||||
|
private match(path: string): MatchResult {
|
||||||
|
for (let routeId of this.routeIds) {
|
||||||
|
let route = this.routes[routeId];
|
||||||
|
let params = this.getRouteParams(route, path);
|
||||||
|
if (params) {
|
||||||
|
return {
|
||||||
|
type: "match",
|
||||||
|
route: route,
|
||||||
|
params: params,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return { type: "nomatch" };
|
||||||
|
}
|
||||||
|
|
||||||
|
private async matchAndApplyRules(path: string): Promise<MatchResult> {
|
||||||
|
const result = this.match(path);
|
||||||
|
if (result.type === "match") {
|
||||||
|
return this.applyRules(result);
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
private async applyRules(matchResult: PositiveMatchResult): Promise<MatchResult> {
|
||||||
|
const route = matchResult.route;
|
||||||
|
if (route.redirect) {
|
||||||
|
const path = this.destToPath(route.redirect);
|
||||||
|
return this.matchAndApplyRules(path);
|
||||||
|
}
|
||||||
|
if (route.beforeRouteEnter) {
|
||||||
|
const result = await route.beforeRouteEnter({
|
||||||
|
env: this.env,
|
||||||
|
from: this.currentRoute,
|
||||||
|
to: route,
|
||||||
|
});
|
||||||
|
if (result === false) {
|
||||||
|
return { type: "cancelled" };
|
||||||
|
} else if (result !== true) {
|
||||||
|
// we want to navigate to another destination
|
||||||
|
const path = this.destToPath(result);
|
||||||
|
return this.matchAndApplyRules(path);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return matchResult;
|
||||||
|
}
|
||||||
|
|
||||||
|
private getRouteParams(route: Route, path: string): RouteParams | false {
|
||||||
|
if (route.path === "*") {
|
||||||
|
return {};
|
||||||
|
}
|
||||||
|
if (path.indexOf("?") > -1) {
|
||||||
|
path = path.split("?")[0];
|
||||||
|
}
|
||||||
|
if (path.startsWith("#")) {
|
||||||
|
path = path.slice(1);
|
||||||
|
}
|
||||||
|
const paramsMatch = path.match(route.extractionRegExp);
|
||||||
|
if (!paramsMatch) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
const result = {};
|
||||||
|
route.params.forEach((param, index) => {
|
||||||
|
const [key, suffix] = param.split(".");
|
||||||
|
const paramValue = paramsMatch[index + 1];
|
||||||
|
if (suffix === "number") {
|
||||||
|
return (result[key] = parseInt(paramValue, 10));
|
||||||
|
}
|
||||||
|
return (result[key] = paramValue);
|
||||||
|
});
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function findParams(str: string): string[] {
|
||||||
|
const result: string[] = [];
|
||||||
|
let m;
|
||||||
|
do {
|
||||||
|
m = globalParamRegexp.exec(str);
|
||||||
|
if (m) {
|
||||||
|
result.push(m[1]);
|
||||||
|
}
|
||||||
|
} while (m);
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
function escapeRegExp(str: string) {
|
||||||
|
return str.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
|
||||||
|
}
|
||||||
|
|
||||||
|
function makeExtractionRegExp(path: string) {
|
||||||
|
// replace param strings with capture groups so that we can build a regex to match over the path
|
||||||
|
const extractionString = path
|
||||||
|
.split(paramRegexp)
|
||||||
|
.map((part, index) => {
|
||||||
|
return index % 2 ? "(.*)" : escapeRegExp(part);
|
||||||
|
})
|
||||||
|
.join("");
|
||||||
|
// Example: /home/{{param1}}/{{param2}} => ^\/home\/(.*)\/(.*)$
|
||||||
|
return new RegExp(`^${extractionString}$`);
|
||||||
|
}
|
||||||
+173
@@ -0,0 +1,173 @@
|
|||||||
|
import { Component, Env } from "./component/component";
|
||||||
|
import { Context, useContextWithCB } from "./context";
|
||||||
|
import { onWillUpdateProps } from "./hooks";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Owl Store
|
||||||
|
*
|
||||||
|
* We have here:
|
||||||
|
* - a Store class
|
||||||
|
* - useStore hook
|
||||||
|
* - useDispatch hook
|
||||||
|
* - useGetters hook
|
||||||
|
*
|
||||||
|
* The Owl store is our answer to the problem of managing complex state across
|
||||||
|
* components. The main idea is that the store owns some state, allow external
|
||||||
|
* code to modify it through actions, and for each state changes,
|
||||||
|
* connected component will be notified, and updated if necessary.
|
||||||
|
*
|
||||||
|
* Note that this code is partly inspired by VueX and React/Redux
|
||||||
|
*/
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Store Definition
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export interface EnvWithStore extends Env {
|
||||||
|
store: Store;
|
||||||
|
}
|
||||||
|
|
||||||
|
export type Action = ({ state, dispatch, env, getters }, ...payload: any) => any;
|
||||||
|
export type Getter = ({ state: any, getters }, payload?) => any;
|
||||||
|
|
||||||
|
interface StoreConfig {
|
||||||
|
env?: Env;
|
||||||
|
state?: any;
|
||||||
|
actions?: { [name: string]: Action };
|
||||||
|
getters?: { [name: string]: Getter };
|
||||||
|
}
|
||||||
|
|
||||||
|
export class Store extends Context {
|
||||||
|
actions: any;
|
||||||
|
env: any;
|
||||||
|
getters: { [name: string]: (payload?) => any };
|
||||||
|
updateFunctions: { [key: number]: (() => boolean)[] };
|
||||||
|
|
||||||
|
constructor(config: StoreConfig) {
|
||||||
|
super(config.state);
|
||||||
|
this.actions = config.actions;
|
||||||
|
this.env = config.env;
|
||||||
|
this.getters = {};
|
||||||
|
this.updateFunctions = [];
|
||||||
|
if (config.getters) {
|
||||||
|
const firstArg = {
|
||||||
|
state: this.state,
|
||||||
|
getters: this.getters,
|
||||||
|
};
|
||||||
|
for (let g in config.getters) {
|
||||||
|
this.getters[g] = config.getters[g].bind(this, firstArg);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
dispatch(action: string, ...payload: any): Promise<void> | void {
|
||||||
|
if (!this.actions[action]) {
|
||||||
|
throw new Error(`[Error] action ${action} is undefined`);
|
||||||
|
}
|
||||||
|
const result = this.actions[action](
|
||||||
|
{
|
||||||
|
dispatch: this.dispatch.bind(this),
|
||||||
|
env: this.env,
|
||||||
|
state: this.state,
|
||||||
|
getters: this.getters,
|
||||||
|
},
|
||||||
|
...payload
|
||||||
|
);
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
__notifyComponents(): Promise<void> {
|
||||||
|
this.trigger("before-update");
|
||||||
|
return super.__notifyComponents();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
interface SelectorOptions {
|
||||||
|
store?: Store;
|
||||||
|
isEqual?: (a: any, b: any) => boolean;
|
||||||
|
onUpdate?: (result: any) => any;
|
||||||
|
}
|
||||||
|
|
||||||
|
const isStrictEqual = (a, b) => a === b;
|
||||||
|
|
||||||
|
export function useStore(selector, options: SelectorOptions = {}): any {
|
||||||
|
const component = Component.current as Component<any, EnvWithStore>;
|
||||||
|
const componentId = component.__owl__.id;
|
||||||
|
const store = options.store || (component.env.store as Store);
|
||||||
|
if (!(store instanceof Store)) {
|
||||||
|
throw new Error(`No store found when connecting '${component.constructor.name}'`);
|
||||||
|
}
|
||||||
|
let result = selector(store.state, component.props);
|
||||||
|
const hashFn = store.observer.revNumber.bind(store.observer);
|
||||||
|
let revNumber = hashFn(result);
|
||||||
|
const isEqual = options.isEqual || isStrictEqual;
|
||||||
|
if (!store.updateFunctions[componentId]) {
|
||||||
|
store.updateFunctions[componentId] = [];
|
||||||
|
}
|
||||||
|
function selectCompareUpdate(state, props): boolean {
|
||||||
|
const oldResult = result;
|
||||||
|
result = selector(state, props);
|
||||||
|
const newRevNumber = hashFn(result);
|
||||||
|
if ((newRevNumber > 0 && revNumber !== newRevNumber) || !isEqual(oldResult, result)) {
|
||||||
|
revNumber = newRevNumber;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
if (options.onUpdate) {
|
||||||
|
store.on("before-update", component, () => {
|
||||||
|
const newValue = selector(store!.state, component.props!);
|
||||||
|
options.onUpdate(newValue);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
store.updateFunctions[componentId].push(function (): boolean {
|
||||||
|
return selectCompareUpdate(store!.state, component.props);
|
||||||
|
});
|
||||||
|
|
||||||
|
useContextWithCB(store, component, function (): Promise<void> | void {
|
||||||
|
let shouldRender = false;
|
||||||
|
for (let fn of store.updateFunctions[componentId]) {
|
||||||
|
shouldRender = fn() || shouldRender;
|
||||||
|
}
|
||||||
|
if (shouldRender) {
|
||||||
|
return component.render();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
onWillUpdateProps((props) => {
|
||||||
|
selectCompareUpdate(store.state, props);
|
||||||
|
});
|
||||||
|
|
||||||
|
const __destroy = component.__destroy;
|
||||||
|
component.__destroy = (parent) => {
|
||||||
|
delete store.updateFunctions[componentId];
|
||||||
|
if (options.onUpdate) {
|
||||||
|
store.off("before-update", component);
|
||||||
|
}
|
||||||
|
__destroy.call(component, parent);
|
||||||
|
};
|
||||||
|
|
||||||
|
if (typeof result !== "object" || result === null) {
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
return new Proxy(result, {
|
||||||
|
get(target, k) {
|
||||||
|
return result[k];
|
||||||
|
},
|
||||||
|
set(target, k, v) {
|
||||||
|
throw new Error("Store state should only be modified through actions");
|
||||||
|
},
|
||||||
|
has(target, k) {
|
||||||
|
return k in result;
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useDispatch(store?: Store): Store["dispatch"] {
|
||||||
|
store = store || (Component.current!.env as EnvWithStore).store;
|
||||||
|
return store.dispatch.bind(store);
|
||||||
|
}
|
||||||
|
|
||||||
|
export function useGetters(store?: Store): Store["getters"] {
|
||||||
|
store = store || (Component.current!.env as EnvWithStore).store;
|
||||||
|
return store.getters;
|
||||||
|
}
|
||||||
+44
@@ -0,0 +1,44 @@
|
|||||||
|
import { QWeb } from "./qweb/index";
|
||||||
|
import { registerSheet } from "./component/styles";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Owl Tags
|
||||||
|
*
|
||||||
|
* We have here a (very) small collection of tag functions:
|
||||||
|
*
|
||||||
|
* - xml
|
||||||
|
*
|
||||||
|
* The plan is to add a few other tags such as css, globalcss.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* XML tag helper for defining templates. With this, one can simply define
|
||||||
|
* an inline template with just the template xml:
|
||||||
|
* ```js
|
||||||
|
* class A extends Component {
|
||||||
|
* static template = xml`<div>some template</div>`;
|
||||||
|
* }
|
||||||
|
* ```
|
||||||
|
*/
|
||||||
|
export function xml(strings, ...args) {
|
||||||
|
const name = `__template__${QWeb.nextId++}`;
|
||||||
|
const value = String.raw(strings, ...args);
|
||||||
|
QWeb.registerTemplate(name, value);
|
||||||
|
return name;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* CSS tag helper for defining inline stylesheets. With this, one can simply define
|
||||||
|
* an inline stylesheet with just the following code:
|
||||||
|
* ```js
|
||||||
|
* class A extends Component {
|
||||||
|
* static style = css`.component-a { color: red; }`;
|
||||||
|
* }
|
||||||
|
* ```
|
||||||
|
*/
|
||||||
|
export function css(strings, ...args) {
|
||||||
|
const name = `__sheet__${QWeb.nextId++}`;
|
||||||
|
const value = String.raw(strings, ...args);
|
||||||
|
registerSheet(name, value);
|
||||||
|
return name;
|
||||||
|
}
|
||||||
+147
-21
@@ -1,38 +1,164 @@
|
|||||||
export class EventBus extends EventTarget {
|
/**
|
||||||
trigger(name: string, payload?: any) {
|
* Owl Utils
|
||||||
this.dispatchEvent(new CustomEvent(name, { detail: payload }));
|
*
|
||||||
}
|
* We have here a small collection of utility functions:
|
||||||
}
|
*
|
||||||
|
* - whenReady
|
||||||
|
* - loadJS
|
||||||
|
* - loadFile
|
||||||
|
* - escape
|
||||||
|
* - debounce
|
||||||
|
*/
|
||||||
|
|
||||||
export function whenReady(fn?: any): Promise<void> {
|
import { browser } from "./browser";
|
||||||
|
|
||||||
|
export function whenReady(fn?: any) {
|
||||||
return new Promise(function (resolve) {
|
return new Promise(function (resolve) {
|
||||||
if (document.readyState !== "loading") {
|
if (document.readyState !== "loading") {
|
||||||
resolve(true);
|
(resolve as any)();
|
||||||
} else {
|
} else {
|
||||||
document.addEventListener("DOMContentLoaded", resolve, false);
|
document.addEventListener("DOMContentLoaded", resolve, false);
|
||||||
}
|
}
|
||||||
}).then(fn || function () {});
|
}).then(fn || function () {});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
const loadedScripts: { [key: string]: Promise<void> } = {};
|
||||||
|
|
||||||
|
export function loadJS(url: string): Promise<void> {
|
||||||
|
if (url in loadedScripts) {
|
||||||
|
return loadedScripts[url];
|
||||||
|
}
|
||||||
|
const promise: Promise<void> = new Promise(function (resolve, reject) {
|
||||||
|
const script = document.createElement("script");
|
||||||
|
script.type = "text/javascript";
|
||||||
|
script.src = url;
|
||||||
|
script.onload = function () {
|
||||||
|
resolve();
|
||||||
|
};
|
||||||
|
script.onerror = function () {
|
||||||
|
reject(`Error loading file '${url}'`);
|
||||||
|
};
|
||||||
|
const head = document.head || document.getElementsByTagName("head")[0];
|
||||||
|
head.appendChild(script);
|
||||||
|
});
|
||||||
|
loadedScripts[url] = promise;
|
||||||
|
return promise;
|
||||||
|
}
|
||||||
|
|
||||||
export async function loadFile(url: string): Promise<string> {
|
export async function loadFile(url: string): Promise<string> {
|
||||||
const result = await fetch(url);
|
const result = await browser.fetch(url);
|
||||||
if (!result.ok) {
|
if (!result.ok) {
|
||||||
throw new Error("Error while fetching xml templates");
|
throw new Error("Error while fetching xml templates");
|
||||||
}
|
}
|
||||||
return await result.text();
|
return await result.text();
|
||||||
}
|
}
|
||||||
|
|
||||||
/*
|
export function escape(str: string | number | undefined): string {
|
||||||
* This class just transports the fact that a string is safe
|
if (str === undefined) {
|
||||||
* to be injected as HTML. Overriding a JS primitive is quite painful though
|
return "";
|
||||||
* so we need to redfine toString and valueOf.
|
}
|
||||||
*/
|
if (typeof str === "number") {
|
||||||
export class Markup extends String {}
|
return String(str);
|
||||||
|
}
|
||||||
/*
|
const p = document.createElement("p");
|
||||||
* Marks a value as safe, that is, a value that can be injected as HTML directly.
|
p.textContent = str;
|
||||||
* It should be used to wrap the value passed to a t-out directive to allow a raw rendering.
|
return p.innerHTML;
|
||||||
*/
|
}
|
||||||
export function markup(value: any) {
|
|
||||||
return new Markup(value);
|
/**
|
||||||
|
* Returns a function, that, as long as it continues to be invoked, will not
|
||||||
|
* be triggered. The function will be called after it stops being called for
|
||||||
|
* N milliseconds. If `immediate` is passed, trigger the function on the
|
||||||
|
* leading edge, instead of the trailing.
|
||||||
|
*
|
||||||
|
* Inspired by https://davidwalsh.name/javascript-debounce-function
|
||||||
|
*/
|
||||||
|
export function debounce(func: Function, wait: number, immediate?: boolean): Function {
|
||||||
|
let timeout;
|
||||||
|
return function (this: any) {
|
||||||
|
const context = this;
|
||||||
|
const args = arguments;
|
||||||
|
function later() {
|
||||||
|
timeout = null;
|
||||||
|
if (!immediate) {
|
||||||
|
func.apply(context, args);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const callNow = immediate && !timeout;
|
||||||
|
browser.clearTimeout(timeout);
|
||||||
|
timeout = browser.setTimeout(later, wait);
|
||||||
|
if (callNow) {
|
||||||
|
func.apply(context, args);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export function shallowEqual(p1, p2): boolean {
|
||||||
|
for (let k in p1) {
|
||||||
|
if (p1[k] !== p2[k]) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
// notable issues:
|
||||||
|
// * objects can't be negative in JS, so !!"" -> false but
|
||||||
|
// !!(new String) -> true, likewise markup
|
||||||
|
// TODO (?)
|
||||||
|
// * Markup.join / Markup#join => escapes items and returns a Markup
|
||||||
|
// * Markup#replace => automatically escapes the replacements (difficult impl)
|
||||||
|
export class _Markup extends String {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns a markup object, which acts like a String but is considered safe by
|
||||||
|
* `_.escape`, and will therefore be injected as-is (without additional
|
||||||
|
* escaping) in templates. Can be used to inject dynamic HTML in templates
|
||||||
|
* (where the template itself can't), see first example.
|
||||||
|
*
|
||||||
|
* Can also be used as a *template tag*, in which case the literal content
|
||||||
|
* won't be escaped but the substitutions which are not already markup objects
|
||||||
|
* will be.
|
||||||
|
*
|
||||||
|
* ## WARNINGS:
|
||||||
|
* * A markup object is a `String` (boxed) but not a `string` (primitive), they
|
||||||
|
* typecheck differently which can be relevant.
|
||||||
|
* * To strip out the "markupness", just call `String(markup)`.
|
||||||
|
* * Most string operations (e.g. concatenation, `String#replace`, ...) will
|
||||||
|
* also strip out markupness
|
||||||
|
* * If the input is empty, returns a regular string (that way boolean tests
|
||||||
|
* work as expected).
|
||||||
|
*
|
||||||
|
* @returns a markup object
|
||||||
|
*
|
||||||
|
* @example regular function
|
||||||
|
* let h;
|
||||||
|
* if (someTest) {
|
||||||
|
* h = Markup(_t("This is a <strong>success</strong>"));
|
||||||
|
* } else {
|
||||||
|
* h = Markup(_t("Things did <strong>not</strong> work out"));
|
||||||
|
* }
|
||||||
|
* qweb.render("some_template", { message: h });
|
||||||
|
*
|
||||||
|
* @example template tag
|
||||||
|
* const escaped = "<some> text";
|
||||||
|
* const asis = Markup`some <b>text</b>`;
|
||||||
|
* const h = Markup`Regular strings get ${escaped} but markup is injected ${asis}`;
|
||||||
|
*/
|
||||||
|
export function Markup(v, ...exprs) {
|
||||||
|
if (!(v instanceof Array)) {
|
||||||
|
return v ? new _Markup(v) : "";
|
||||||
|
}
|
||||||
|
const elements = [];
|
||||||
|
let i = 0;
|
||||||
|
for (; i < exprs.length; ++i) {
|
||||||
|
elements.push(v[i], escape(exprs[i]));
|
||||||
|
}
|
||||||
|
elements.push(v[i]);
|
||||||
|
|
||||||
|
const s = elements.join("");
|
||||||
|
if (!s) {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
return new _Markup(s);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,34 @@
|
|||||||
|
import { VNode, h, addNS } from "./vdom";
|
||||||
|
|
||||||
|
const parser = new DOMParser();
|
||||||
|
|
||||||
|
export function htmlToVDOM(html: string): VNode[] {
|
||||||
|
const doc = parser.parseFromString(html, "text/html");
|
||||||
|
const result: VNode[] = [];
|
||||||
|
for (let child of doc.body.childNodes) {
|
||||||
|
result.push(htmlToVNode(child));
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
function htmlToVNode(node: ChildNode): VNode {
|
||||||
|
if (!(node instanceof Element)) {
|
||||||
|
if (node instanceof Comment) {
|
||||||
|
return h("!", node.textContent);
|
||||||
|
}
|
||||||
|
return { text: node.textContent! } as VNode;
|
||||||
|
}
|
||||||
|
const attrs = {};
|
||||||
|
for (let attr of node.attributes) {
|
||||||
|
attrs[attr.name] = attr.textContent;
|
||||||
|
}
|
||||||
|
const children: VNode[] = [];
|
||||||
|
for (let c of node.childNodes) {
|
||||||
|
children.push(htmlToVNode(c));
|
||||||
|
}
|
||||||
|
const vnode = h((node as Element).tagName, { attrs }, children);
|
||||||
|
if (vnode.sel === "svg") {
|
||||||
|
addNS(vnode.data, (vnode as any).children, vnode.sel);
|
||||||
|
}
|
||||||
|
return vnode;
|
||||||
|
}
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
import { attrsModule, classModule, eventListenersModule, propsModule } from "./modules";
|
||||||
|
import { init } from "./vdom";
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// patch
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
export { h, VNode } from "./vdom";
|
||||||
|
|
||||||
|
export const patch = init([eventListenersModule, attrsModule, propsModule, classModule]);
|
||||||
@@ -0,0 +1,247 @@
|
|||||||
|
import { Module, VNode, VNodeData } from "./vdom";
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// module/props.ts
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
function updateProps(oldVnode: VNode, vnode: VNode): void {
|
||||||
|
var key: string,
|
||||||
|
cur: any,
|
||||||
|
old: any,
|
||||||
|
elm = vnode.elm,
|
||||||
|
oldProps = (oldVnode.data as VNodeData).props,
|
||||||
|
props = (vnode.data as VNodeData).props;
|
||||||
|
|
||||||
|
if (!oldProps && !props) return;
|
||||||
|
if (oldProps === props) return;
|
||||||
|
oldProps = oldProps || {};
|
||||||
|
props = props || {};
|
||||||
|
|
||||||
|
for (key in oldProps) {
|
||||||
|
if (!props[key]) {
|
||||||
|
delete (elm as any)[key];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (key in props) {
|
||||||
|
cur = props[key];
|
||||||
|
old = oldProps[key];
|
||||||
|
if (old !== cur && (key !== "value" || (elm as any)[key] !== cur)) {
|
||||||
|
(elm as any)[key] = cur;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export const propsModule = {
|
||||||
|
create: updateProps,
|
||||||
|
update: updateProps,
|
||||||
|
} as Module;
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// module/eventlisteners.ts
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
function invokeHandler(handler: any, vnode?: VNode, event?: Event): void {
|
||||||
|
if (typeof handler === "function") {
|
||||||
|
// call function handler
|
||||||
|
handler.call(vnode, event, vnode);
|
||||||
|
} else if (typeof handler === "object") {
|
||||||
|
// call handler with arguments
|
||||||
|
if (typeof handler[0] === "function") {
|
||||||
|
// special case for single argument for performance
|
||||||
|
if (handler.length === 2) {
|
||||||
|
handler[0].call(vnode, handler[1], event, vnode);
|
||||||
|
} else {
|
||||||
|
var args = handler.slice(1);
|
||||||
|
args.push(event);
|
||||||
|
args.push(vnode);
|
||||||
|
handler[0].apply(vnode, args);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// call multiple handlers
|
||||||
|
for (let i = 0, iLen = handler.length; i < iLen; i++) {
|
||||||
|
invokeHandler(handler[i], vnode, event);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function handleEvent(event: Event, vnode: VNode) {
|
||||||
|
var name = event.type,
|
||||||
|
on = (vnode.data as VNodeData).on;
|
||||||
|
|
||||||
|
// call event handler(s) if exists
|
||||||
|
if (on) {
|
||||||
|
if (on[name]) {
|
||||||
|
invokeHandler(on[name], vnode, event);
|
||||||
|
} else if (on["!" + name]) {
|
||||||
|
invokeHandler(on["!" + name], vnode, event);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function createListener() {
|
||||||
|
return function handler(event: Event) {
|
||||||
|
handleEvent(event, (handler as any).vnode);
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function updateEventListeners(oldVnode: VNode, vnode?: VNode): void {
|
||||||
|
var oldOn = (oldVnode.data as VNodeData).on,
|
||||||
|
oldListener = (oldVnode as any).listener,
|
||||||
|
oldElm: Element = oldVnode.elm as Element,
|
||||||
|
on = vnode && (vnode.data as VNodeData).on,
|
||||||
|
elm: Element = (vnode && vnode.elm) as Element,
|
||||||
|
name: string;
|
||||||
|
|
||||||
|
// optimization for reused immutable handlers
|
||||||
|
if (oldOn === on) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// remove existing listeners which no longer used
|
||||||
|
if (oldOn && oldListener) {
|
||||||
|
// if element changed or deleted we remove all existing listeners unconditionally
|
||||||
|
if (!on) {
|
||||||
|
for (name in oldOn) {
|
||||||
|
// remove listener if element was changed or existing listeners removed
|
||||||
|
const capture = name.charAt(0) === "!";
|
||||||
|
name = capture ? name.slice(1) : name;
|
||||||
|
oldElm.removeEventListener(name, oldListener, capture);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
for (name in oldOn) {
|
||||||
|
// remove listener if existing listener removed
|
||||||
|
if (!on[name]) {
|
||||||
|
const capture = name.charAt(0) === "!";
|
||||||
|
name = capture ? name.slice(1) : name;
|
||||||
|
oldElm.removeEventListener(name, oldListener, capture);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// add new listeners which has not already attached
|
||||||
|
if (on) {
|
||||||
|
// reuse existing listener or create new
|
||||||
|
var listener = ((vnode as any).listener = (oldVnode as any).listener || createListener());
|
||||||
|
// update vnode for listener
|
||||||
|
listener.vnode = vnode;
|
||||||
|
|
||||||
|
// if element changed or added we add all needed listeners unconditionally
|
||||||
|
if (!oldOn) {
|
||||||
|
for (name in on) {
|
||||||
|
// add listener if element was changed or new listeners added
|
||||||
|
const capture = name.charAt(0) === "!";
|
||||||
|
name = capture ? name.slice(1) : name;
|
||||||
|
elm.addEventListener(name, listener, capture);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
for (name in on) {
|
||||||
|
// add listener if new listener added
|
||||||
|
if (!oldOn[name]) {
|
||||||
|
const capture = name.charAt(0) === "!";
|
||||||
|
name = capture ? name.slice(1) : name;
|
||||||
|
elm.addEventListener(name, listener, capture);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export const eventListenersModule = {
|
||||||
|
create: updateEventListeners,
|
||||||
|
update: updateEventListeners,
|
||||||
|
destroy: updateEventListeners,
|
||||||
|
} as Module;
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// attributes.ts
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
const xlinkNS = "http://www.w3.org/1999/xlink";
|
||||||
|
const xmlNS = "http://www.w3.org/XML/1998/namespace";
|
||||||
|
const colonChar = 58;
|
||||||
|
const xChar = 120;
|
||||||
|
|
||||||
|
function updateAttrs(oldVnode: VNode, vnode: VNode): void {
|
||||||
|
var key: string,
|
||||||
|
elm: Element = vnode.elm as Element,
|
||||||
|
oldAttrs = (oldVnode.data as VNodeData).attrs,
|
||||||
|
attrs = (vnode.data as VNodeData).attrs;
|
||||||
|
|
||||||
|
if (!oldAttrs && !attrs) return;
|
||||||
|
if (oldAttrs === attrs) return;
|
||||||
|
oldAttrs = oldAttrs || {};
|
||||||
|
attrs = attrs || {};
|
||||||
|
|
||||||
|
// update modified attributes, add new attributes
|
||||||
|
for (key in attrs) {
|
||||||
|
const cur = attrs[key];
|
||||||
|
const old = oldAttrs[key];
|
||||||
|
if (old !== cur) {
|
||||||
|
if (cur === true) {
|
||||||
|
elm.setAttribute(key, "");
|
||||||
|
} else if (cur === false) {
|
||||||
|
elm.removeAttribute(key);
|
||||||
|
} else {
|
||||||
|
if (key.charCodeAt(0) !== xChar) {
|
||||||
|
elm.setAttribute(key, cur);
|
||||||
|
} else if (key.charCodeAt(3) === colonChar) {
|
||||||
|
// Assume xml namespace
|
||||||
|
elm.setAttributeNS(xmlNS, key, cur);
|
||||||
|
} else if (key.charCodeAt(5) === colonChar) {
|
||||||
|
// Assume xlink namespace
|
||||||
|
elm.setAttributeNS(xlinkNS, key, cur);
|
||||||
|
} else {
|
||||||
|
elm.setAttribute(key, cur);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// remove removed attributes
|
||||||
|
// use `in` operator since the previous `for` iteration uses it (.i.e. add even attributes with undefined value)
|
||||||
|
// the other option is to remove all attributes with value == undefined
|
||||||
|
for (key in oldAttrs) {
|
||||||
|
if (!(key in attrs)) {
|
||||||
|
elm.removeAttribute(key);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export const attrsModule = {
|
||||||
|
create: updateAttrs,
|
||||||
|
update: updateAttrs,
|
||||||
|
} as Module;
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// class.ts
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
function updateClass(oldVnode: VNode, vnode: VNode): void {
|
||||||
|
var cur: any,
|
||||||
|
name: string,
|
||||||
|
elm: Element,
|
||||||
|
oldClass = (oldVnode.data as VNodeData).class,
|
||||||
|
klass = (vnode.data as VNodeData).class;
|
||||||
|
|
||||||
|
if (!oldClass && !klass) return;
|
||||||
|
if (oldClass === klass) return;
|
||||||
|
oldClass = oldClass || {};
|
||||||
|
klass = klass || {};
|
||||||
|
|
||||||
|
elm = vnode.elm as Element;
|
||||||
|
|
||||||
|
for (name in oldClass) {
|
||||||
|
if (name && !klass[name] && !Object.prototype.hasOwnProperty.call(klass, name)) {
|
||||||
|
// was `true` and now not provided
|
||||||
|
elm.classList.remove(name);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (name in klass) {
|
||||||
|
cur = klass[name];
|
||||||
|
if (cur !== oldClass[name]) {
|
||||||
|
(elm.classList as any)[cur ? "add" : "remove"](name);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export const classModule = { create: updateClass, update: updateClass } as Module;
|
||||||
@@ -0,0 +1,616 @@
|
|||||||
|
/**
|
||||||
|
* Owl VDOM
|
||||||
|
*
|
||||||
|
* This file contains an implementation of a virtual DOM, which is a system that
|
||||||
|
* can generate in-memory representations of a DOM tree, compare them, and
|
||||||
|
* eventually change a concrete DOM tree to match its representation, in an
|
||||||
|
* hopefully efficient way.
|
||||||
|
*
|
||||||
|
* Note that this code is a fork of Snabbdom, slightly tweaked/optimized for our
|
||||||
|
* needs (see https://github.com/snabbdom/snabbdom).
|
||||||
|
*
|
||||||
|
* The main exported values are:
|
||||||
|
* - interface VNode
|
||||||
|
* - h function (a helper function to generate a vnode)
|
||||||
|
* - patch function (to apply a vnode to an actual DOM node)
|
||||||
|
*/
|
||||||
|
|
||||||
|
// because those in TypeScript are too restrictive: https://github.com/Microsoft/TSJS-lib-generator/pull/237
|
||||||
|
declare global {
|
||||||
|
interface Element {
|
||||||
|
setAttribute(name: string, value: string | number | boolean): void;
|
||||||
|
setAttributeNS(
|
||||||
|
namespaceURI: string,
|
||||||
|
qualifiedName: string,
|
||||||
|
value: string | number | boolean
|
||||||
|
): void;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
type Props = Record<string, any>;
|
||||||
|
type Attrs = Record<string, string | number | boolean>;
|
||||||
|
type On = { [N in keyof HTMLElementEventMap]?: (ev: HTMLElementEventMap[N]) => void } & {
|
||||||
|
[event: string]: EventListener;
|
||||||
|
};
|
||||||
|
|
||||||
|
export interface Module {
|
||||||
|
pre: PreHook;
|
||||||
|
create: CreateHook;
|
||||||
|
update: UpdateHook;
|
||||||
|
destroy: DestroyHook;
|
||||||
|
remove: RemoveHook;
|
||||||
|
post: PostHook;
|
||||||
|
}
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// vnode.ts
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
type Key = string | number;
|
||||||
|
|
||||||
|
export interface VNode {
|
||||||
|
sel: string | undefined;
|
||||||
|
data: VNodeData | undefined;
|
||||||
|
children: Array<VNode | string> | undefined;
|
||||||
|
elm: Node | undefined;
|
||||||
|
text: string | undefined;
|
||||||
|
key: Key | undefined;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface VNodeData {
|
||||||
|
props?: Props;
|
||||||
|
attrs?: Attrs;
|
||||||
|
on?: On;
|
||||||
|
hook?: Hooks;
|
||||||
|
key?: Key;
|
||||||
|
ns?: string; // for SVGs
|
||||||
|
[key: string]: any; // for any other 3rd party module
|
||||||
|
}
|
||||||
|
|
||||||
|
function vnode(
|
||||||
|
sel: string | undefined,
|
||||||
|
data: any | undefined,
|
||||||
|
children: Array<VNode | string> | undefined,
|
||||||
|
text: string | undefined,
|
||||||
|
elm: Element | Text | undefined
|
||||||
|
): VNode {
|
||||||
|
let key = data === undefined ? undefined : data.key;
|
||||||
|
return { sel, data, children, text, elm, key };
|
||||||
|
}
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// snabbdom.ts
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
function isUndef(s: any): boolean {
|
||||||
|
return s === undefined;
|
||||||
|
}
|
||||||
|
function isDef(s: any): boolean {
|
||||||
|
return s !== undefined;
|
||||||
|
}
|
||||||
|
|
||||||
|
type VNodeQueue = Array<VNode>;
|
||||||
|
|
||||||
|
const emptyNode = vnode("", {}, [], undefined, undefined);
|
||||||
|
|
||||||
|
function sameVnode(vnode1: VNode, vnode2: VNode): boolean {
|
||||||
|
return vnode1.key === vnode2.key && vnode1.sel === vnode2.sel;
|
||||||
|
}
|
||||||
|
|
||||||
|
function isVnode(vnode: any): vnode is VNode {
|
||||||
|
return vnode.sel !== undefined;
|
||||||
|
}
|
||||||
|
|
||||||
|
type KeyToIndexMap = { [key: string]: number };
|
||||||
|
|
||||||
|
type ArraysOf<T> = { [K in keyof T]: T[K][] };
|
||||||
|
|
||||||
|
type ModuleHooks = ArraysOf<Module>;
|
||||||
|
|
||||||
|
function createKeyToOldIdx(
|
||||||
|
children: Array<VNode>,
|
||||||
|
beginIdx: number,
|
||||||
|
endIdx: number
|
||||||
|
): KeyToIndexMap {
|
||||||
|
let i: number,
|
||||||
|
map: KeyToIndexMap = {},
|
||||||
|
key: Key | undefined,
|
||||||
|
ch;
|
||||||
|
for (i = beginIdx; i <= endIdx; ++i) {
|
||||||
|
ch = children[i];
|
||||||
|
if (ch != null) {
|
||||||
|
key = ch.key;
|
||||||
|
if (key !== undefined) map[key] = i;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return map;
|
||||||
|
}
|
||||||
|
|
||||||
|
const hooks: (keyof Module)[] = ["create", "update", "remove", "destroy", "pre", "post"];
|
||||||
|
|
||||||
|
export function init(modules: Array<Partial<Module>>, domApi?: DOMAPI) {
|
||||||
|
let i: number,
|
||||||
|
j: number,
|
||||||
|
cbs = {} as ModuleHooks;
|
||||||
|
|
||||||
|
const api: DOMAPI = domApi !== undefined ? domApi : htmlDomApi;
|
||||||
|
|
||||||
|
for (i = 0; i < hooks.length; ++i) {
|
||||||
|
cbs[hooks[i]] = [];
|
||||||
|
for (j = 0; j < modules.length; ++j) {
|
||||||
|
const hook = modules[j][hooks[i]];
|
||||||
|
if (hook !== undefined) {
|
||||||
|
(cbs[hooks[i]] as Array<any>).push(hook);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function emptyNodeAt(elm: Element) {
|
||||||
|
const id = elm.id ? "#" + elm.id : "";
|
||||||
|
const c = elm.className ? "." + elm.className.split(" ").join(".") : "";
|
||||||
|
return vnode(api.tagName(elm).toLowerCase() + id + c, {}, [], undefined, elm);
|
||||||
|
}
|
||||||
|
|
||||||
|
function createRmCb(childElm: Node, listeners: number) {
|
||||||
|
return function rmCb() {
|
||||||
|
if (--listeners === 0) {
|
||||||
|
const parent = api.parentNode(childElm);
|
||||||
|
api.removeChild(parent, childElm);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function createElm(vnode: VNode, insertedVnodeQueue: VNodeQueue): Node {
|
||||||
|
let i: any,
|
||||||
|
iLen: number,
|
||||||
|
data = vnode.data;
|
||||||
|
if (data !== undefined) {
|
||||||
|
if (isDef((i = data.hook)) && isDef((i = i.init))) {
|
||||||
|
i(vnode);
|
||||||
|
data = vnode.data;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
let children = vnode.children,
|
||||||
|
sel = vnode.sel;
|
||||||
|
if (sel === "!") {
|
||||||
|
if (isUndef(vnode.text)) {
|
||||||
|
vnode.text = "";
|
||||||
|
}
|
||||||
|
vnode.elm = api.createComment(vnode.text as string);
|
||||||
|
} else if (sel !== undefined) {
|
||||||
|
const elm =
|
||||||
|
vnode.elm ||
|
||||||
|
(vnode.elm =
|
||||||
|
isDef(data) && isDef((i = (data as VNodeData).ns))
|
||||||
|
? api.createElementNS(i, sel)
|
||||||
|
: api.createElement(sel));
|
||||||
|
for (i = 0, iLen = cbs.create.length; i < iLen; ++i) cbs.create[i](emptyNode, vnode);
|
||||||
|
if (array(children)) {
|
||||||
|
for (i = 0, iLen = children.length; i < iLen; ++i) {
|
||||||
|
const ch = children[i];
|
||||||
|
if (ch != null) {
|
||||||
|
api.appendChild(elm, createElm(ch as VNode, insertedVnodeQueue));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else if (primitive(vnode.text)) {
|
||||||
|
api.appendChild(elm, api.createTextNode(vnode.text));
|
||||||
|
}
|
||||||
|
i = (vnode.data as VNodeData).hook; // Reuse variable
|
||||||
|
if (isDef(i)) {
|
||||||
|
if (i.create) i.create(emptyNode, vnode);
|
||||||
|
if (i.insert) insertedVnodeQueue.push(vnode);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
vnode.elm = api.createTextNode(vnode.text as string);
|
||||||
|
}
|
||||||
|
return vnode.elm;
|
||||||
|
}
|
||||||
|
|
||||||
|
function addVnodes(
|
||||||
|
parentElm: Node,
|
||||||
|
before: Node | null,
|
||||||
|
vnodes: Array<VNode>,
|
||||||
|
startIdx: number,
|
||||||
|
endIdx: number,
|
||||||
|
insertedVnodeQueue: VNodeQueue
|
||||||
|
) {
|
||||||
|
for (; startIdx <= endIdx; ++startIdx) {
|
||||||
|
const ch = vnodes[startIdx];
|
||||||
|
if (ch != null) {
|
||||||
|
api.insertBefore(parentElm, createElm(ch, insertedVnodeQueue), before);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function invokeDestroyHook(vnode: VNode) {
|
||||||
|
let i: any,
|
||||||
|
iLen: number,
|
||||||
|
j: number,
|
||||||
|
jLen: number,
|
||||||
|
data = vnode.data;
|
||||||
|
if (data !== undefined) {
|
||||||
|
if (isDef((i = data.hook)) && isDef((i = i.destroy))) i(vnode);
|
||||||
|
for (i = 0, iLen = cbs.destroy.length; i < iLen; ++i) cbs.destroy[i](vnode);
|
||||||
|
if (vnode.children !== undefined) {
|
||||||
|
for (j = 0, jLen = vnode.children.length; j < jLen; ++j) {
|
||||||
|
i = vnode.children[j];
|
||||||
|
if (i != null && typeof i !== "string") {
|
||||||
|
invokeDestroyHook(i);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function removeVnodes(
|
||||||
|
parentElm: Node,
|
||||||
|
vnodes: Array<VNode>,
|
||||||
|
startIdx: number,
|
||||||
|
endIdx: number
|
||||||
|
): void {
|
||||||
|
for (; startIdx <= endIdx; ++startIdx) {
|
||||||
|
let i: any,
|
||||||
|
iLen: number,
|
||||||
|
listeners: number,
|
||||||
|
rm: () => void,
|
||||||
|
ch = vnodes[startIdx];
|
||||||
|
if (ch != null) {
|
||||||
|
if (isDef(ch.sel)) {
|
||||||
|
invokeDestroyHook(ch);
|
||||||
|
listeners = cbs.remove.length + 1;
|
||||||
|
rm = createRmCb(ch.elm as Node, listeners);
|
||||||
|
for (i = 0, iLen = cbs.remove.length; i < iLen; ++i) cbs.remove[i](ch, rm);
|
||||||
|
if (isDef((i = ch.data)) && isDef((i = i.hook)) && isDef((i = i.remove))) {
|
||||||
|
i(ch, rm);
|
||||||
|
} else {
|
||||||
|
rm();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Text node
|
||||||
|
api.removeChild(parentElm, ch.elm as Node);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function updateChildren(
|
||||||
|
parentElm: Node,
|
||||||
|
oldCh: Array<VNode>,
|
||||||
|
newCh: Array<VNode>,
|
||||||
|
insertedVnodeQueue: VNodeQueue
|
||||||
|
) {
|
||||||
|
let oldStartIdx = 0,
|
||||||
|
newStartIdx = 0;
|
||||||
|
let oldEndIdx = oldCh.length - 1;
|
||||||
|
let oldStartVnode = oldCh[0];
|
||||||
|
let oldEndVnode = oldCh[oldEndIdx];
|
||||||
|
let newEndIdx = newCh.length - 1;
|
||||||
|
let newStartVnode = newCh[0];
|
||||||
|
let newEndVnode = newCh[newEndIdx];
|
||||||
|
let oldKeyToIdx: any;
|
||||||
|
let idxInOld: number;
|
||||||
|
let elmToMove: VNode;
|
||||||
|
let before: any;
|
||||||
|
|
||||||
|
while (oldStartIdx <= oldEndIdx && newStartIdx <= newEndIdx) {
|
||||||
|
if (oldStartVnode == null) {
|
||||||
|
oldStartVnode = oldCh[++oldStartIdx]; // Vnode might have been moved left
|
||||||
|
} else if (oldEndVnode == null) {
|
||||||
|
oldEndVnode = oldCh[--oldEndIdx];
|
||||||
|
} else if (newStartVnode == null) {
|
||||||
|
newStartVnode = newCh[++newStartIdx];
|
||||||
|
} else if (newEndVnode == null) {
|
||||||
|
newEndVnode = newCh[--newEndIdx];
|
||||||
|
} else if (sameVnode(oldStartVnode, newStartVnode)) {
|
||||||
|
patchVnode(oldStartVnode, newStartVnode, insertedVnodeQueue);
|
||||||
|
oldStartVnode = oldCh[++oldStartIdx];
|
||||||
|
newStartVnode = newCh[++newStartIdx];
|
||||||
|
} else if (sameVnode(oldEndVnode, newEndVnode)) {
|
||||||
|
patchVnode(oldEndVnode, newEndVnode, insertedVnodeQueue);
|
||||||
|
oldEndVnode = oldCh[--oldEndIdx];
|
||||||
|
newEndVnode = newCh[--newEndIdx];
|
||||||
|
} else if (sameVnode(oldStartVnode, newEndVnode)) {
|
||||||
|
// Vnode moved right
|
||||||
|
patchVnode(oldStartVnode, newEndVnode, insertedVnodeQueue);
|
||||||
|
api.insertBefore(
|
||||||
|
parentElm,
|
||||||
|
oldStartVnode.elm as Node,
|
||||||
|
api.nextSibling(oldEndVnode.elm as Node)
|
||||||
|
);
|
||||||
|
oldStartVnode = oldCh[++oldStartIdx];
|
||||||
|
newEndVnode = newCh[--newEndIdx];
|
||||||
|
} else if (sameVnode(oldEndVnode, newStartVnode)) {
|
||||||
|
// Vnode moved left
|
||||||
|
patchVnode(oldEndVnode, newStartVnode, insertedVnodeQueue);
|
||||||
|
api.insertBefore(parentElm, oldEndVnode.elm as Node, oldStartVnode.elm as Node);
|
||||||
|
oldEndVnode = oldCh[--oldEndIdx];
|
||||||
|
newStartVnode = newCh[++newStartIdx];
|
||||||
|
} else {
|
||||||
|
if (oldKeyToIdx === undefined) {
|
||||||
|
oldKeyToIdx = createKeyToOldIdx(oldCh, oldStartIdx, oldEndIdx);
|
||||||
|
}
|
||||||
|
idxInOld = oldKeyToIdx[newStartVnode.key as string];
|
||||||
|
if (isUndef(idxInOld)) {
|
||||||
|
// New element
|
||||||
|
api.insertBefore(
|
||||||
|
parentElm,
|
||||||
|
createElm(newStartVnode, insertedVnodeQueue),
|
||||||
|
oldStartVnode.elm as Node
|
||||||
|
);
|
||||||
|
newStartVnode = newCh[++newStartIdx];
|
||||||
|
} else {
|
||||||
|
elmToMove = oldCh[idxInOld];
|
||||||
|
if (elmToMove.sel !== newStartVnode.sel) {
|
||||||
|
api.insertBefore(
|
||||||
|
parentElm,
|
||||||
|
createElm(newStartVnode, insertedVnodeQueue),
|
||||||
|
oldStartVnode.elm as Node
|
||||||
|
);
|
||||||
|
} else {
|
||||||
|
patchVnode(elmToMove, newStartVnode, insertedVnodeQueue);
|
||||||
|
oldCh[idxInOld] = undefined as any;
|
||||||
|
api.insertBefore(parentElm, elmToMove.elm as Node, oldStartVnode.elm as Node);
|
||||||
|
}
|
||||||
|
newStartVnode = newCh[++newStartIdx];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (oldStartIdx <= oldEndIdx || newStartIdx <= newEndIdx) {
|
||||||
|
if (oldStartIdx > oldEndIdx) {
|
||||||
|
before = newCh[newEndIdx + 1] == null ? null : newCh[newEndIdx + 1].elm;
|
||||||
|
addVnodes(parentElm, before, newCh, newStartIdx, newEndIdx, insertedVnodeQueue);
|
||||||
|
} else {
|
||||||
|
removeVnodes(parentElm, oldCh, oldStartIdx, oldEndIdx);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function patchVnode(oldVnode: VNode, vnode: VNode, insertedVnodeQueue: VNodeQueue) {
|
||||||
|
let i: any, iLen: number, hook: any;
|
||||||
|
if (isDef((i = vnode.data)) && isDef((hook = i.hook)) && isDef((i = hook.prepatch))) {
|
||||||
|
i(oldVnode, vnode);
|
||||||
|
}
|
||||||
|
const elm = (vnode.elm = oldVnode.elm as Node);
|
||||||
|
let oldCh = oldVnode.children;
|
||||||
|
let ch = vnode.children;
|
||||||
|
if (oldVnode === vnode) return;
|
||||||
|
if (vnode.data !== undefined) {
|
||||||
|
for (i = 0, iLen = cbs.update.length; i < iLen; ++i) cbs.update[i](oldVnode, vnode);
|
||||||
|
i = vnode.data.hook;
|
||||||
|
if (isDef(i) && isDef((i = i.update))) i(oldVnode, vnode);
|
||||||
|
}
|
||||||
|
if (isUndef(vnode.text)) {
|
||||||
|
if (isDef(oldCh) && isDef(ch)) {
|
||||||
|
if (oldCh !== ch)
|
||||||
|
updateChildren(elm, oldCh as Array<VNode>, ch as Array<VNode>, insertedVnodeQueue);
|
||||||
|
} else if (isDef(ch)) {
|
||||||
|
if (isDef(oldVnode.text)) api.setTextContent(elm, "");
|
||||||
|
addVnodes(
|
||||||
|
elm,
|
||||||
|
null,
|
||||||
|
ch as Array<VNode>,
|
||||||
|
0,
|
||||||
|
(ch as Array<VNode>).length - 1,
|
||||||
|
insertedVnodeQueue
|
||||||
|
);
|
||||||
|
} else if (isDef(oldCh)) {
|
||||||
|
removeVnodes(elm, oldCh as Array<VNode>, 0, (oldCh as Array<VNode>).length - 1);
|
||||||
|
} else if (isDef(oldVnode.text)) {
|
||||||
|
api.setTextContent(elm, "");
|
||||||
|
}
|
||||||
|
} else if (oldVnode.text !== vnode.text) {
|
||||||
|
if (isDef(oldCh)) {
|
||||||
|
removeVnodes(elm, oldCh as Array<VNode>, 0, (oldCh as Array<VNode>).length - 1);
|
||||||
|
}
|
||||||
|
api.setTextContent(elm, vnode.text as string);
|
||||||
|
}
|
||||||
|
if (isDef(hook) && isDef((i = hook.postpatch))) {
|
||||||
|
i(oldVnode, vnode);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return function patch(oldVnode: VNode | Element, vnode: VNode): VNode {
|
||||||
|
let i: number, iLen: number, elm: Node, parent: Node;
|
||||||
|
const insertedVnodeQueue: VNodeQueue = [];
|
||||||
|
for (i = 0, iLen = cbs.pre.length; i < iLen; ++i) cbs.pre[i]();
|
||||||
|
|
||||||
|
if (!isVnode(oldVnode)) {
|
||||||
|
oldVnode = emptyNodeAt(oldVnode);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (sameVnode(oldVnode, vnode)) {
|
||||||
|
patchVnode(oldVnode, vnode, insertedVnodeQueue);
|
||||||
|
} else {
|
||||||
|
elm = oldVnode.elm as Node;
|
||||||
|
parent = api.parentNode(elm);
|
||||||
|
|
||||||
|
createElm(vnode, insertedVnodeQueue);
|
||||||
|
|
||||||
|
if (parent !== null) {
|
||||||
|
api.insertBefore(parent, vnode.elm as Node, api.nextSibling(elm));
|
||||||
|
removeVnodes(parent, [oldVnode], 0, 0);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
for (i = 0, iLen = insertedVnodeQueue.length; i < iLen; ++i) {
|
||||||
|
(((insertedVnodeQueue[i].data as VNodeData).hook as Hooks).insert as any)(
|
||||||
|
insertedVnodeQueue[i]
|
||||||
|
);
|
||||||
|
}
|
||||||
|
for (i = 0, iLen = cbs.post.length; i < iLen; ++i) cbs.post[i]();
|
||||||
|
return vnode;
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// is.ts
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
const array = Array.isArray;
|
||||||
|
function primitive(s: any): s is string | number {
|
||||||
|
return typeof s === "string" || typeof s === "number";
|
||||||
|
}
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// htmldomapi.ts
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
interface DOMAPI {
|
||||||
|
createElement: (tagName: any) => HTMLElement;
|
||||||
|
createElementNS: (namespaceURI: string, qualifiedName: string) => Element;
|
||||||
|
createTextNode: (text: string) => Text;
|
||||||
|
createComment: (text: string) => Comment;
|
||||||
|
insertBefore: (parentNode: Node, newNode: Node, referenceNode: Node | null) => void;
|
||||||
|
removeChild: (node: Node, child: Node) => void;
|
||||||
|
appendChild: (node: Node, child: Node) => void;
|
||||||
|
parentNode: (node: Node) => Node;
|
||||||
|
nextSibling: (node: Node) => Node;
|
||||||
|
tagName: (elm: Element) => string;
|
||||||
|
setTextContent: (node: Node, text: string | null) => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
function createElement(tagName: any): HTMLElement {
|
||||||
|
return document.createElement(tagName);
|
||||||
|
}
|
||||||
|
|
||||||
|
function createElementNS(namespaceURI: string, qualifiedName: string): Element {
|
||||||
|
return document.createElementNS(namespaceURI, qualifiedName);
|
||||||
|
}
|
||||||
|
|
||||||
|
function createTextNode(text: string): Text {
|
||||||
|
return document.createTextNode(text);
|
||||||
|
}
|
||||||
|
|
||||||
|
function createComment(text: string): Comment {
|
||||||
|
return document.createComment(text);
|
||||||
|
}
|
||||||
|
|
||||||
|
function insertBefore(parentNode: Node, newNode: Node, referenceNode: Node | null): void {
|
||||||
|
parentNode.insertBefore(newNode, referenceNode);
|
||||||
|
}
|
||||||
|
|
||||||
|
function removeChild(node: Node, child: Node): void {
|
||||||
|
node.removeChild(child);
|
||||||
|
}
|
||||||
|
|
||||||
|
function appendChild(node: Node, child: Node): void {
|
||||||
|
node.appendChild(child);
|
||||||
|
}
|
||||||
|
|
||||||
|
function parentNode(node: Node): Node | null {
|
||||||
|
return node.parentNode;
|
||||||
|
}
|
||||||
|
|
||||||
|
function nextSibling(node: Node): Node | null {
|
||||||
|
return node.nextSibling;
|
||||||
|
}
|
||||||
|
|
||||||
|
function tagName(elm: Element): string {
|
||||||
|
return elm.tagName;
|
||||||
|
}
|
||||||
|
|
||||||
|
function setTextContent(node: Node, text: string | null): void {
|
||||||
|
node.textContent = text;
|
||||||
|
}
|
||||||
|
|
||||||
|
const htmlDomApi = {
|
||||||
|
createElement,
|
||||||
|
createElementNS,
|
||||||
|
createTextNode,
|
||||||
|
createComment,
|
||||||
|
insertBefore,
|
||||||
|
removeChild,
|
||||||
|
appendChild,
|
||||||
|
parentNode,
|
||||||
|
nextSibling,
|
||||||
|
tagName,
|
||||||
|
setTextContent,
|
||||||
|
} as DOMAPI;
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// hooks.ts
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
type PreHook = () => any;
|
||||||
|
type InitHook = (vNode: VNode) => any;
|
||||||
|
type CreateHook = (emptyVNode: VNode, vNode: VNode) => any;
|
||||||
|
type InsertHook = (vNode: VNode) => any;
|
||||||
|
type PrePatchHook = (oldVNode: VNode, vNode: VNode) => any;
|
||||||
|
type UpdateHook = (oldVNode: VNode, vNode: VNode) => any;
|
||||||
|
type PostPatchHook = (oldVNode: VNode, vNode: VNode) => any;
|
||||||
|
type DestroyHook = (vNode: VNode) => any;
|
||||||
|
type RemoveHook = (vNode: VNode, removeCallback: () => void) => any;
|
||||||
|
type PostHook = () => any;
|
||||||
|
|
||||||
|
interface Hooks {
|
||||||
|
pre?: PreHook;
|
||||||
|
init?: InitHook;
|
||||||
|
create?: CreateHook;
|
||||||
|
insert?: InsertHook;
|
||||||
|
prepatch?: PrePatchHook;
|
||||||
|
update?: UpdateHook;
|
||||||
|
postpatch?: PostPatchHook;
|
||||||
|
destroy?: DestroyHook;
|
||||||
|
remove?: RemoveHook;
|
||||||
|
post?: PostHook;
|
||||||
|
}
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// h.ts
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
type VNodes = Array<VNode>;
|
||||||
|
type VNodeChildElement = VNode | string | number | undefined | null;
|
||||||
|
type ArrayOrElement<T> = T | T[];
|
||||||
|
type VNodeChildren = ArrayOrElement<VNodeChildElement>;
|
||||||
|
|
||||||
|
export function addNS(data: any, children: VNodes | undefined, sel: string | undefined): void {
|
||||||
|
if (sel === "dummy") {
|
||||||
|
// we do not need to add the namespace on dummy elements, they come from a
|
||||||
|
// subcomponent, which will handle the namespace itself
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
data.ns = "http://www.w3.org/2000/svg";
|
||||||
|
if (sel !== "foreignObject" && children !== undefined) {
|
||||||
|
for (let i = 0, iLen = children.length; i < iLen; ++i) {
|
||||||
|
const child = children[i];
|
||||||
|
let childData = child.data;
|
||||||
|
if (childData !== undefined) {
|
||||||
|
addNS(childData, (child as VNode).children as VNodes, child.sel);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function h(sel: string): VNode;
|
||||||
|
export function h(sel: string, data: VNodeData): VNode;
|
||||||
|
export function h(sel: string, children: VNodeChildren): VNode;
|
||||||
|
export function h(sel: string, data: VNodeData, children: VNodeChildren): VNode;
|
||||||
|
export function h(sel: any, b?: any, c?: any): VNode {
|
||||||
|
var data: VNodeData = {},
|
||||||
|
children: any,
|
||||||
|
text: any,
|
||||||
|
i: number,
|
||||||
|
iLen: number;
|
||||||
|
if (c !== undefined) {
|
||||||
|
data = b;
|
||||||
|
if (array(c)) {
|
||||||
|
children = c;
|
||||||
|
} else if (primitive(c)) {
|
||||||
|
text = c;
|
||||||
|
} else if (c && c.sel) {
|
||||||
|
children = [c];
|
||||||
|
}
|
||||||
|
} else if (b !== undefined) {
|
||||||
|
if (array(b)) {
|
||||||
|
children = b;
|
||||||
|
} else if (primitive(b)) {
|
||||||
|
text = b;
|
||||||
|
} else if (b && b.sel) {
|
||||||
|
children = [b];
|
||||||
|
} else {
|
||||||
|
data = b;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (children !== undefined) {
|
||||||
|
for (i = 0, iLen = children.length; i < iLen; ++i) {
|
||||||
|
if (primitive(children[i]))
|
||||||
|
children[i] = vnode(undefined, undefined, undefined, children[i], undefined);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return vnode(sel, data, children, text, undefined);
|
||||||
|
}
|
||||||
@@ -0,0 +1,200 @@
|
|||||||
|
// Jest Snapshot v1, https://goo.gl/fbAQLP
|
||||||
|
|
||||||
|
exports[`animations t-transition combined with component 1`] = `
|
||||||
|
"function anonymous(context, extra
|
||||||
|
) {
|
||||||
|
// Template name: \\"Parent\\"
|
||||||
|
let utils = this.constructor.utils;
|
||||||
|
let QWeb = this.constructor;
|
||||||
|
let parent = context;
|
||||||
|
let scope = Object.create(context);
|
||||||
|
let h = this.h;
|
||||||
|
let c1 = [], p1 = {key:1};
|
||||||
|
let vn1 = h('div', p1, c1);
|
||||||
|
// Component 'Child'
|
||||||
|
let w2 = '__3__' in parent.__owl__.cmap ? parent.__owl__.children[parent.__owl__.cmap['__3__']] : false;
|
||||||
|
let props2 = {};
|
||||||
|
if (w2 && w2.__owl__.currentFiber && !w2.__owl__.vnode) {
|
||||||
|
w2.destroy();
|
||||||
|
w2 = false;
|
||||||
|
}
|
||||||
|
if (w2) {
|
||||||
|
w2.__updateProps(props2, extra.fiber, undefined);
|
||||||
|
let pvnode = w2.__owl__.pvnode;
|
||||||
|
c1.push(pvnode);
|
||||||
|
} else {
|
||||||
|
let componentKey2 = \`Child\`;
|
||||||
|
let W2 = scope['Child'] || context.constructor.components[componentKey2] || QWeb.components[componentKey2];
|
||||||
|
if (!W2) {throw new Error('Cannot find the definition of component \\"' + componentKey2 + '\\"')}
|
||||||
|
w2 = new W2(parent, props2);
|
||||||
|
const __patch2 = w2.__patch;
|
||||||
|
w2.__patch = (t, vn) => {__patch2.call(w2, t, vn); if(!w2.__owl__.transitionInserted){w2.__owl__.transitionInserted = true;utils.transitionInsert(w2.__owl__.vnode, 'chimay');}};
|
||||||
|
parent.__owl__.cmap['__3__'] = w2.__owl__.id;
|
||||||
|
let fiber = w2.__prepare(extra.fiber, undefined, () => { const vnode = fiber.vnode; pvnode.sel = vnode.sel; });
|
||||||
|
let pvnode = h('dummy', {key: '__3__', hook: {remove() {},destroy(vn) {let finalize = () => {
|
||||||
|
w2.destroy();
|
||||||
|
};
|
||||||
|
delete w2.__owl__.transitionInserted;
|
||||||
|
utils.transitionRemove(vn, 'chimay', finalize);}}});
|
||||||
|
c1.push(pvnode);
|
||||||
|
w2.__owl__.pvnode = pvnode;
|
||||||
|
}
|
||||||
|
w2.__owl__.parentLastFiberId = extra.fiber.id;
|
||||||
|
return vn1;
|
||||||
|
}"
|
||||||
|
`;
|
||||||
|
|
||||||
|
exports[`animations t-transition combined with t-component and t-if 1`] = `
|
||||||
|
"function anonymous(context, extra
|
||||||
|
) {
|
||||||
|
// Template name: \\"Parent\\"
|
||||||
|
let utils = this.constructor.utils;
|
||||||
|
let QWeb = this.constructor;
|
||||||
|
let parent = context;
|
||||||
|
let scope = Object.create(context);
|
||||||
|
let h = this.h;
|
||||||
|
let c1 = [], p1 = {key:1};
|
||||||
|
let vn1 = h('div', p1, c1);
|
||||||
|
if (scope['state'].display) {
|
||||||
|
// Component 'Child'
|
||||||
|
let w2 = '__3__' in parent.__owl__.cmap ? parent.__owl__.children[parent.__owl__.cmap['__3__']] : false;
|
||||||
|
let props2 = {};
|
||||||
|
if (w2 && w2.__owl__.currentFiber && !w2.__owl__.vnode) {
|
||||||
|
w2.destroy();
|
||||||
|
w2 = false;
|
||||||
|
}
|
||||||
|
if (w2) {
|
||||||
|
w2.__updateProps(props2, extra.fiber, undefined);
|
||||||
|
let pvnode = w2.__owl__.pvnode;
|
||||||
|
c1.push(pvnode);
|
||||||
|
} else {
|
||||||
|
let componentKey2 = \`Child\`;
|
||||||
|
let W2 = scope['Child'] || context.constructor.components[componentKey2] || QWeb.components[componentKey2];
|
||||||
|
if (!W2) {throw new Error('Cannot find the definition of component \\"' + componentKey2 + '\\"')}
|
||||||
|
w2 = new W2(parent, props2);
|
||||||
|
const __patch2 = w2.__patch;
|
||||||
|
w2.__patch = (t, vn) => {__patch2.call(w2, t, vn); if(!w2.__owl__.transitionInserted){w2.__owl__.transitionInserted = true;utils.transitionInsert(w2.__owl__.vnode, 'chimay');}};
|
||||||
|
parent.__owl__.cmap['__3__'] = w2.__owl__.id;
|
||||||
|
let fiber = w2.__prepare(extra.fiber, undefined, () => { const vnode = fiber.vnode; pvnode.sel = vnode.sel; });
|
||||||
|
let pvnode = h('dummy', {key: '__3__', hook: {remove() {},destroy(vn) {let finalize = () => {
|
||||||
|
w2.destroy();
|
||||||
|
};
|
||||||
|
delete w2.__owl__.transitionInserted;
|
||||||
|
utils.transitionRemove(vn, 'chimay', finalize);}}});
|
||||||
|
c1.push(pvnode);
|
||||||
|
w2.__owl__.pvnode = pvnode;
|
||||||
|
}
|
||||||
|
w2.__owl__.parentLastFiberId = extra.fiber.id;
|
||||||
|
}
|
||||||
|
return vn1;
|
||||||
|
}"
|
||||||
|
`;
|
||||||
|
|
||||||
|
exports[`animations t-transition combined with t-component, remove and re-add before transitionend 1`] = `
|
||||||
|
"function anonymous(context, extra
|
||||||
|
) {
|
||||||
|
// Template name: \\"__template__2\\"
|
||||||
|
let utils = this.constructor.utils;
|
||||||
|
let QWeb = this.constructor;
|
||||||
|
let parent = context;
|
||||||
|
let scope = Object.create(context);
|
||||||
|
let h = this.h;
|
||||||
|
let c1 = [], p1 = {key:1};
|
||||||
|
let vn1 = h('div', p1, c1);
|
||||||
|
if (scope['state'].flag) {
|
||||||
|
// Component 'Child'
|
||||||
|
let w2 = '__3__' in parent.__owl__.cmap ? parent.__owl__.children[parent.__owl__.cmap['__3__']] : false;
|
||||||
|
let props2 = {};
|
||||||
|
if (w2 && w2.__owl__.currentFiber && !w2.__owl__.vnode) {
|
||||||
|
w2.destroy();
|
||||||
|
w2 = false;
|
||||||
|
}
|
||||||
|
if (w2) {
|
||||||
|
w2.__updateProps(props2, extra.fiber, undefined);
|
||||||
|
let pvnode = w2.__owl__.pvnode;
|
||||||
|
c1.push(pvnode);
|
||||||
|
} else {
|
||||||
|
let componentKey2 = \`Child\`;
|
||||||
|
let W2 = scope['Child'] || context.constructor.components[componentKey2] || QWeb.components[componentKey2];
|
||||||
|
if (!W2) {throw new Error('Cannot find the definition of component \\"' + componentKey2 + '\\"')}
|
||||||
|
w2 = new W2(parent, props2);
|
||||||
|
const __patch2 = w2.__patch;
|
||||||
|
w2.__patch = (t, vn) => {__patch2.call(w2, t, vn); if(!w2.__owl__.transitionInserted){w2.__owl__.transitionInserted = true;utils.transitionInsert(w2.__owl__.vnode, 'chimay');}};
|
||||||
|
parent.__owl__.cmap['__3__'] = w2.__owl__.id;
|
||||||
|
let fiber = w2.__prepare(extra.fiber, undefined, () => { const vnode = fiber.vnode; pvnode.sel = vnode.sel; });
|
||||||
|
let pvnode = h('dummy', {key: '__3__', hook: {remove() {},destroy(vn) {let finalize = () => {
|
||||||
|
w2.destroy();
|
||||||
|
};
|
||||||
|
delete w2.__owl__.transitionInserted;
|
||||||
|
utils.transitionRemove(vn, 'chimay', finalize);}}});
|
||||||
|
c1.push(pvnode);
|
||||||
|
w2.__owl__.pvnode = pvnode;
|
||||||
|
}
|
||||||
|
w2.__owl__.parentLastFiberId = extra.fiber.id;
|
||||||
|
}
|
||||||
|
return vn1;
|
||||||
|
}"
|
||||||
|
`;
|
||||||
|
|
||||||
|
exports[`animations t-transition with no delay/duration 1`] = `
|
||||||
|
"function anonymous(context, extra
|
||||||
|
) {
|
||||||
|
// Template name: \\"test\\"
|
||||||
|
let utils = this.constructor.utils;
|
||||||
|
let h = this.h;
|
||||||
|
let c1 = [], p1 = {key:1};
|
||||||
|
let vn1 = h('span', p1, c1);
|
||||||
|
p1.hook = {
|
||||||
|
insert: vn => {
|
||||||
|
utils.transitionInsert(vn, 'jupiler');
|
||||||
|
},
|
||||||
|
remove: (vn, rm) => {
|
||||||
|
utils.transitionRemove(vn, 'jupiler', rm);
|
||||||
|
},
|
||||||
|
};
|
||||||
|
c1.push({text: \`blue\`});
|
||||||
|
return vn1;
|
||||||
|
}"
|
||||||
|
`;
|
||||||
|
|
||||||
|
exports[`animations t-transition, on a simple node (insert) 1`] = `
|
||||||
|
"function anonymous(context, extra
|
||||||
|
) {
|
||||||
|
// Template name: \\"test\\"
|
||||||
|
let utils = this.constructor.utils;
|
||||||
|
let h = this.h;
|
||||||
|
let c1 = [], p1 = {key:1};
|
||||||
|
let vn1 = h('span', p1, c1);
|
||||||
|
p1.hook = {
|
||||||
|
insert: vn => {
|
||||||
|
utils.transitionInsert(vn, 'chimay');
|
||||||
|
},
|
||||||
|
remove: (vn, rm) => {
|
||||||
|
utils.transitionRemove(vn, 'chimay', rm);
|
||||||
|
},
|
||||||
|
};
|
||||||
|
c1.push({text: \`blue\`});
|
||||||
|
return vn1;
|
||||||
|
}"
|
||||||
|
`;
|
||||||
|
|
||||||
|
exports[`animations t-transition, on a simple node, not in the DOM 1`] = `
|
||||||
|
"function anonymous(context, extra
|
||||||
|
) {
|
||||||
|
// Template name: \\"test\\"
|
||||||
|
let utils = this.constructor.utils;
|
||||||
|
let h = this.h;
|
||||||
|
let c1 = [], p1 = {key:1};
|
||||||
|
let vn1 = h('span', p1, c1);
|
||||||
|
p1.hook = {
|
||||||
|
insert: vn => {
|
||||||
|
utils.transitionInsert(vn, 'chimay');
|
||||||
|
},
|
||||||
|
remove: (vn, rm) => {
|
||||||
|
utils.transitionRemove(vn, 'chimay', rm);
|
||||||
|
},
|
||||||
|
};
|
||||||
|
c1.push({text: \`blue\`});
|
||||||
|
return vn1;
|
||||||
|
}"
|
||||||
|
`;
|
||||||
@@ -1,384 +0,0 @@
|
|||||||
// Jest Snapshot v1, https://goo.gl/fbAQLP
|
|
||||||
|
|
||||||
exports[`Reactivity: useState concurrent renderings 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component } = bdom;
|
|
||||||
let { withDefault, getTemplate, prepareList, withKey, zero, call, callSlot, capture, isBoundary, shallowEqual, setContextValue, toNumber, safeOutput } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<span><block-text-0/><block-text-1/></span>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let d1 = ctx['context'][ctx['props'].key].n;
|
|
||||||
let d2 = ctx['state'].x;
|
|
||||||
return block1([d1, d2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState concurrent renderings 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component } = bdom;
|
|
||||||
let { withDefault, getTemplate, prepareList, withKey, zero, call, callSlot, capture, isBoundary, shallowEqual, setContextValue, toNumber, safeOutput } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<p><block-child-0/></p>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2 = component(\`ComponentC\`, {key: ctx['props'].key}, key + \`__1\`, node, ctx);
|
|
||||||
return block1([], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState concurrent renderings 3`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component } = bdom;
|
|
||||||
let { withDefault, getTemplate, prepareList, withKey, zero, call, callSlot, capture, isBoundary, shallowEqual, setContextValue, toNumber, safeOutput } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2 = component(\`ComponentB\`, {key: ctx['context'].key}, key + \`__1\`, node, ctx);
|
|
||||||
return block1([], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState destroyed component before being mounted is inactive 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2;
|
|
||||||
if (ctx['state'].flag) {
|
|
||||||
b2 = component(\`Child\`, {}, key+\`__1\`,null, node, ctx);
|
|
||||||
}
|
|
||||||
return block1([], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState destroyed component before being mounted is inactive 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<span><block-text-0/></span>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['contextObj'].a;
|
|
||||||
return block1([txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState destroyed component is inactive 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2;
|
|
||||||
if (ctx['state'].flag) {
|
|
||||||
b2 = component(\`Child\`, {}, key+\`__1\`,null, node, ctx);
|
|
||||||
}
|
|
||||||
return block1([], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState destroyed component is inactive 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<span><block-text-0/></span>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['contextObj'].a;
|
|
||||||
return block1([txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState one components can subscribe twice to same context 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-text-0/><block-text-1/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['contextObj1'].a;
|
|
||||||
let txt2 = ctx['contextObj2'].b;
|
|
||||||
return block1([txt1, txt2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState parent and children subscribed to same context 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/><block-text-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2 = component(\`Child\`, {}, key+\`__1\`,null, node, ctx);
|
|
||||||
let txt1 = ctx['contextObj'].b;
|
|
||||||
return block1([txt1], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState parent and children subscribed to same context 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<span><block-text-0/></span>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['contextObj'].a;
|
|
||||||
return block1([txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState several nodes on different level use same context 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component } = bdom;
|
|
||||||
let { withDefault, getTemplate, prepareList, withKey, zero, call, callSlot, capture, isBoundary, shallowEqual, setContextValue, toNumber, safeOutput } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-text-0/> <block-text-1/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let d1 = ctx['contextObj'].a;
|
|
||||||
let d2 = ctx['contextObj'].b;
|
|
||||||
return block1([d1, d2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState several nodes on different level use same context 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component } = bdom;
|
|
||||||
let { withDefault, getTemplate, prepareList, withKey, zero, call, callSlot, capture, isBoundary, shallowEqual, setContextValue, toNumber, safeOutput } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-text-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let d1 = ctx['contextObj'].b;
|
|
||||||
return block1([d1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState several nodes on different level use same context 3`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component } = bdom;
|
|
||||||
let { withDefault, getTemplate, prepareList, withKey, zero, call, callSlot, capture, isBoundary, shallowEqual, setContextValue, toNumber, safeOutput } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-text-0/><block-child-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let d1 = ctx['contextObj'].a;
|
|
||||||
let b2 = component(\`L3A\`, {}, key + \`__1\`, node, ctx);
|
|
||||||
return block1([d1], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState several nodes on different level use same context 4`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component } = bdom;
|
|
||||||
let { withDefault, getTemplate, prepareList, withKey, zero, call, callSlot, capture, isBoundary, shallowEqual, setContextValue, toNumber, safeOutput } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/><block-child-1/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2 = component(\`L2A\`, {}, key + \`__1\`, node, ctx);
|
|
||||||
let b3 = component(\`L2B\`, {}, key + \`__2\`, node, ctx);
|
|
||||||
return block1([], [b2, b3]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState two components are updated in parallel 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/><block-child-1/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2 = component(\`Child\`, {}, key+\`__1\`,null, node, ctx);
|
|
||||||
let b3 = component(\`Child\`, {}, key+\`__2\`,null, node, ctx);
|
|
||||||
return block1([], [b2, b3]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState two components are updated in parallel 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<span><block-text-0/></span>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['contextObj'].value;
|
|
||||||
return block1([txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState two components can subscribe to same context 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/><block-child-1/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2 = component(\`Child\`, {}, key+\`__1\`,null, node, ctx);
|
|
||||||
let b3 = component(\`Child\`, {}, key+\`__2\`,null, node, ctx);
|
|
||||||
return block1([], [b2, b3]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState two components can subscribe to same context 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<span><block-text-0/></span>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['contextObj'].value;
|
|
||||||
return block1([txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState two independent components on different levels are updated in parallel 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/><block-child-1/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2 = component(\`Child\`, {}, key+\`__1\`,null, node, ctx);
|
|
||||||
let b3 = component(\`Parent\`, {}, key+\`__2\`,null, node, ctx);
|
|
||||||
return block1([], [b2, b3]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState two independent components on different levels are updated in parallel 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<span><block-text-0/></span>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['contextObj'].value;
|
|
||||||
return block1([txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState two independent components on different levels are updated in parallel 3`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2 = component(\`Child\`, {}, key+\`__1\`,null, node, ctx);
|
|
||||||
return block1([], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState useContext=useState hook is reactive, for one component 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-text-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['contextObj'].value;
|
|
||||||
return block1([txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState useless atoms should be deleted 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { prepareList, withKey } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/> Total: <block-text-0/> Count: <block-text-1/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
ctx = Object.create(ctx);
|
|
||||||
const [k_block2, v_block2, l_block2, c_block2] = prepareList(Object.keys(ctx['state']));
|
|
||||||
for (let i1 = 0; i1 < l_block2; i1++) {
|
|
||||||
ctx[\`id\`] = v_block2[i1];
|
|
||||||
let key1 = ctx['id'];
|
|
||||||
c_block2[i1] = withKey(component(\`Quantity\`, {id: ctx['id']}, key+\`__1__\${key1}\`,null, node, ctx), key1);
|
|
||||||
}
|
|
||||||
ctx = ctx.__proto__;
|
|
||||||
let b2 = list(c_block2);
|
|
||||||
let txt1 = ctx['total'];
|
|
||||||
let txt2 = Object.keys(ctx['state']).length;
|
|
||||||
return block1([txt1, txt2], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState useless atoms should be deleted 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-text-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['state'].quantity;
|
|
||||||
return block1([txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`Reactivity: useState very simple use, with initial value 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-text-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['contextObj'].value;
|
|
||||||
return block1([txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
// Jest Snapshot v1, https://goo.gl/fbAQLP
|
||||||
|
|
||||||
|
exports[`various scenarios scenarios with async store updates and some components events 1`] = `"<div><button>Do stuff</button><div><span>Attachment 100</span><span>Name: text.txt</span></div></div>"`;
|
||||||
|
|
||||||
|
exports[`various scenarios scenarios with async store updates and some components events 2`] = `"<div><button>Do stuff</button></div>"`;
|
||||||
@@ -0,0 +1,452 @@
|
|||||||
|
import { Component, Env } from "../src/component/component";
|
||||||
|
import { useRef, useState } from "../src/hooks";
|
||||||
|
import { QWeb } from "../src/qweb/index";
|
||||||
|
import { xml } from "../src/tags";
|
||||||
|
import {
|
||||||
|
makeDeferred,
|
||||||
|
makeTestEnv,
|
||||||
|
makeTestFixture,
|
||||||
|
nextFrame,
|
||||||
|
patchNextFrame,
|
||||||
|
renderToDOM,
|
||||||
|
unpatchNextFrame,
|
||||||
|
} from "./helpers";
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Setup and helpers
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
// We create before each test:
|
||||||
|
// - fixture: a div, appended to the DOM, intended to be the target of dom
|
||||||
|
// manipulations. Note that it is removed after each test.
|
||||||
|
// - qweb: a new QWeb instance
|
||||||
|
// - env: a WEnv, necessary to create new components
|
||||||
|
// - cssEl: a stylesheet injected into the dom
|
||||||
|
|
||||||
|
let fixture: HTMLElement;
|
||||||
|
let qweb: QWeb;
|
||||||
|
let env: Env;
|
||||||
|
let cssEl: HTMLElement;
|
||||||
|
|
||||||
|
beforeEach(() => {
|
||||||
|
fixture = makeTestFixture();
|
||||||
|
env = makeTestEnv();
|
||||||
|
Component.env = env;
|
||||||
|
qweb = new QWeb();
|
||||||
|
});
|
||||||
|
|
||||||
|
afterEach(() => {
|
||||||
|
fixture.remove();
|
||||||
|
});
|
||||||
|
|
||||||
|
class Widget extends Component<any, any> {}
|
||||||
|
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
// Tests
|
||||||
|
//------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
describe("animations", () => {
|
||||||
|
beforeEach(() => {
|
||||||
|
cssEl = document.createElement("style");
|
||||||
|
let css = `
|
||||||
|
.chimay-enter-active, .chimay-leave-active {
|
||||||
|
transition-property: opacity;
|
||||||
|
transition-duration: 0.1s;
|
||||||
|
}
|
||||||
|
.chimay-enter, .chimay-leave-to {
|
||||||
|
opacity: 0;
|
||||||
|
}
|
||||||
|
`;
|
||||||
|
cssEl.textContent = css.trim();
|
||||||
|
document.head.appendChild(cssEl);
|
||||||
|
});
|
||||||
|
|
||||||
|
afterEach(() => {
|
||||||
|
document.head.removeChild(cssEl);
|
||||||
|
unpatchNextFrame();
|
||||||
|
});
|
||||||
|
|
||||||
|
test("t-transition, on a simple node (insert)", async () => {
|
||||||
|
expect.assertions(5);
|
||||||
|
qweb.addTemplate("test", `<span t-transition="chimay">blue</span>`);
|
||||||
|
|
||||||
|
let def = makeDeferred();
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
expect(node.className).toBe("chimay-enter chimay-enter-active");
|
||||||
|
cb();
|
||||||
|
expect(node.className).toBe("chimay-enter-active chimay-enter-to");
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
let node: HTMLElement = <HTMLElement>renderToDOM(qweb, "test");
|
||||||
|
fixture.appendChild(node);
|
||||||
|
|
||||||
|
expect(node.className).toBe("chimay-enter chimay-enter-active");
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
node.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(node.className).toBe("");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("t-transition, on a simple node, not in the DOM", async () => {
|
||||||
|
expect.assertions(5);
|
||||||
|
qweb.addTemplate("test", `<span t-transition="chimay">blue</span>`);
|
||||||
|
|
||||||
|
let def = makeDeferred();
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
expect(node.className).toBe("chimay-enter chimay-enter-active");
|
||||||
|
cb();
|
||||||
|
expect(node.className).toBe("chimay-enter-active chimay-enter-to");
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
let node: HTMLElement = <HTMLElement>renderToDOM(qweb, "test");
|
||||||
|
|
||||||
|
expect(node.className).toBe("chimay-enter chimay-enter-active");
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
node.dispatchEvent(new Event("transitionend"));
|
||||||
|
// we check here that the css classes have not been removed, since the
|
||||||
|
// element is not in the dom, we actually do not want to do anything.
|
||||||
|
expect(node.className).toBe("chimay-enter-active chimay-enter-to");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("t-transition with no delay/duration", async () => {
|
||||||
|
expect.assertions(4);
|
||||||
|
qweb.addTemplate("test", `<span t-transition="jupiler">blue</span>`);
|
||||||
|
|
||||||
|
let def = makeDeferred();
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
expect(node.className).toBe("jupiler-enter jupiler-enter-active");
|
||||||
|
cb();
|
||||||
|
expect(node.className).toBe("");
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
let node: HTMLElement = <HTMLElement>renderToDOM(qweb, "test");
|
||||||
|
fixture.appendChild(node);
|
||||||
|
expect(node.className).toBe("jupiler-enter jupiler-enter-active");
|
||||||
|
await def;
|
||||||
|
});
|
||||||
|
|
||||||
|
test("t-transition on a conditional node", async () => {
|
||||||
|
expect.assertions(7);
|
||||||
|
|
||||||
|
env.qweb.addTemplate(
|
||||||
|
"TestWidget",
|
||||||
|
`<div><span t-if="!state.hide" t-transition="chimay">blue</span></div>`
|
||||||
|
);
|
||||||
|
class TestWidget extends Widget {
|
||||||
|
state = useState({ hide: false });
|
||||||
|
}
|
||||||
|
const widget = new TestWidget();
|
||||||
|
|
||||||
|
// insert widget into the DOM
|
||||||
|
let def = makeDeferred();
|
||||||
|
var spanNode;
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
expect(spanNode.className).toBe("chimay-enter chimay-enter-active");
|
||||||
|
cb();
|
||||||
|
expect(spanNode.className).toBe("chimay-enter-active chimay-enter-to");
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
await widget.mount(fixture);
|
||||||
|
spanNode = widget.el!.children[0];
|
||||||
|
expect(spanNode.className).toBe("chimay-enter chimay-enter-active");
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
spanNode.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(spanNode.className).toBe("");
|
||||||
|
|
||||||
|
// remove span from the DOM
|
||||||
|
def = makeDeferred();
|
||||||
|
widget.state.hide = true;
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
expect(spanNode.className).toBe("chimay-leave chimay-leave-active");
|
||||||
|
cb();
|
||||||
|
expect(spanNode.className).toBe("chimay-leave-active chimay-leave-to");
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
spanNode.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(spanNode.className).toBe("");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("t-transition combined with t-ref", async () => {
|
||||||
|
expect.assertions(5);
|
||||||
|
|
||||||
|
env.qweb.addTemplate(
|
||||||
|
"TestWidget",
|
||||||
|
`<div><span t-ref="span" t-transition="chimay">blue</span></div>`
|
||||||
|
);
|
||||||
|
class TestWidget extends Widget {
|
||||||
|
state = useState({ hide: false });
|
||||||
|
span = useRef("span");
|
||||||
|
}
|
||||||
|
const widget = new TestWidget();
|
||||||
|
|
||||||
|
// insert widget into the DOM
|
||||||
|
let def = makeDeferred();
|
||||||
|
var spanNode;
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
expect(spanNode.className).toBe("chimay-enter chimay-enter-active");
|
||||||
|
cb();
|
||||||
|
expect(spanNode.className).toBe("chimay-enter-active chimay-enter-to");
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
await widget.mount(fixture);
|
||||||
|
spanNode = widget.el!.children[0];
|
||||||
|
expect(widget.span.el).toBe(spanNode);
|
||||||
|
expect(spanNode.className).toBe("chimay-enter chimay-enter-active");
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
spanNode.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(spanNode.className).toBe("");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("t-transition combined with component", async () => {
|
||||||
|
expect.assertions(5);
|
||||||
|
|
||||||
|
env.qweb.addTemplate("Parent", `<div><Child t-transition="chimay"/></div>`);
|
||||||
|
env.qweb.addTemplate("Child", `<span>blue</span>`);
|
||||||
|
class Child extends Widget {}
|
||||||
|
class Parent extends Widget {
|
||||||
|
static components = { Child: Child };
|
||||||
|
}
|
||||||
|
const widget = new Parent();
|
||||||
|
|
||||||
|
let def = makeDeferred();
|
||||||
|
var spanNode;
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
expect(fixture.innerHTML).toBe(
|
||||||
|
'<div><span class="chimay-enter chimay-enter-active">blue</span></div>'
|
||||||
|
);
|
||||||
|
cb();
|
||||||
|
expect(fixture.innerHTML).toBe(
|
||||||
|
'<div><span class="chimay-enter-active chimay-enter-to">blue</span></div>'
|
||||||
|
);
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
await widget.mount(fixture);
|
||||||
|
spanNode = widget.el!.children[0];
|
||||||
|
|
||||||
|
expect(env.qweb.templates.Parent.fn.toString()).toMatchSnapshot();
|
||||||
|
expect(fixture.innerHTML).toBe(
|
||||||
|
'<div><span class="chimay-enter chimay-enter-active">blue</span></div>'
|
||||||
|
);
|
||||||
|
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
spanNode.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(fixture.innerHTML).toBe('<div><span class="">blue</span></div>');
|
||||||
|
});
|
||||||
|
|
||||||
|
test("t-transition combined with t-component and t-if", async () => {
|
||||||
|
expect.assertions(8);
|
||||||
|
|
||||||
|
env.qweb.addTemplate(
|
||||||
|
"Parent",
|
||||||
|
`<div><t t-if="state.display" t-component="Child" t-transition="chimay"/></div>`
|
||||||
|
);
|
||||||
|
env.qweb.addTemplate("Child", `<span>blue</span>`);
|
||||||
|
class Child extends Widget {}
|
||||||
|
class Parent extends Widget {
|
||||||
|
static components = { Child: Child };
|
||||||
|
state = useState({ display: true });
|
||||||
|
}
|
||||||
|
const widget = new Parent();
|
||||||
|
|
||||||
|
let def = makeDeferred();
|
||||||
|
var spanNode;
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
expect(fixture.innerHTML).toBe(
|
||||||
|
'<div><span class="chimay-enter chimay-enter-active">blue</span></div>'
|
||||||
|
);
|
||||||
|
cb();
|
||||||
|
expect(fixture.innerHTML).toBe(
|
||||||
|
'<div><span class="chimay-enter-active chimay-enter-to">blue</span></div>'
|
||||||
|
);
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
await widget.mount(fixture);
|
||||||
|
spanNode = widget.el!.children[0];
|
||||||
|
|
||||||
|
expect(env.qweb.templates.Parent.fn.toString()).toMatchSnapshot();
|
||||||
|
expect(fixture.innerHTML).toBe(
|
||||||
|
'<div><span class="chimay-enter chimay-enter-active">blue</span></div>'
|
||||||
|
);
|
||||||
|
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
spanNode.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(fixture.innerHTML).toBe('<div><span class="">blue</span></div>');
|
||||||
|
|
||||||
|
// remove span from the DOM
|
||||||
|
def = makeDeferred();
|
||||||
|
widget.state.display = false;
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
expect(fixture.innerHTML).toBe(
|
||||||
|
'<div><span class="chimay-leave chimay-leave-active" data-owl-key="__3__">blue</span></div>'
|
||||||
|
);
|
||||||
|
cb();
|
||||||
|
expect(fixture.innerHTML).toBe(
|
||||||
|
'<div><span class="chimay-leave-active chimay-leave-to" data-owl-key="__3__">blue</span></div>'
|
||||||
|
);
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
spanNode.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(fixture.innerHTML).toBe("<div></div>");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("t-transition, remove and re-add before transitionend", async () => {
|
||||||
|
expect.assertions(11);
|
||||||
|
|
||||||
|
env.qweb.addTemplates(
|
||||||
|
`<templates>
|
||||||
|
<div t-name="Parent">
|
||||||
|
<button t-on-click="toggle">Toggle</button>
|
||||||
|
<span t-if="state.flag" t-transition="chimay">blue</span>
|
||||||
|
</div>
|
||||||
|
</templates>`
|
||||||
|
);
|
||||||
|
class Parent extends Widget {
|
||||||
|
state = useState({ flag: false });
|
||||||
|
|
||||||
|
toggle() {
|
||||||
|
this.state.flag = !this.state.flag;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const widget = new Parent();
|
||||||
|
await widget.mount(fixture);
|
||||||
|
let button = widget.el!.querySelector("button");
|
||||||
|
|
||||||
|
let def = makeDeferred();
|
||||||
|
let phase = "enter";
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
let spans = fixture.querySelectorAll("span");
|
||||||
|
expect(spans.length).toBe(1);
|
||||||
|
expect(spans[0].className).toBe(`chimay-${phase} chimay-${phase}-active`);
|
||||||
|
cb();
|
||||||
|
expect(spans[0].className).toBe(`chimay-${phase}-active chimay-${phase}-to`);
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
|
||||||
|
// click display the span
|
||||||
|
button!.click();
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
widget.el!.querySelector("span")!.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(fixture.innerHTML).toBe('<div><button>Toggle</button><span class="">blue</span></div>');
|
||||||
|
|
||||||
|
// click to remove the span, and click again to re-add it before transitionend
|
||||||
|
def = makeDeferred();
|
||||||
|
phase = "leave";
|
||||||
|
button!.click();
|
||||||
|
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
def = makeDeferred();
|
||||||
|
phase = "enter";
|
||||||
|
button!.click();
|
||||||
|
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
widget.el!.querySelector("span")!.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(fixture.innerHTML).toBe('<div><button>Toggle</button><span class="">blue</span></div>');
|
||||||
|
});
|
||||||
|
|
||||||
|
test("t-transition combined with t-component, remove and re-add before transitionend", async () => {
|
||||||
|
expect.assertions(12);
|
||||||
|
|
||||||
|
class Child extends Widget {
|
||||||
|
static template = xml`<span>blue</span>`;
|
||||||
|
}
|
||||||
|
class Parent extends Widget {
|
||||||
|
static template = xml`
|
||||||
|
<div t-name="Parent">
|
||||||
|
<t t-if="state.flag" t-component="Child" t-transition="chimay"/>
|
||||||
|
</div>`;
|
||||||
|
static components = { Child };
|
||||||
|
state = useState({ flag: false });
|
||||||
|
}
|
||||||
|
|
||||||
|
const widget = new Parent();
|
||||||
|
await widget.mount(fixture);
|
||||||
|
expect(env.qweb.templates[Parent.template].fn.toString()).toMatchSnapshot();
|
||||||
|
|
||||||
|
let def = makeDeferred();
|
||||||
|
let phase = "enter";
|
||||||
|
patchNextFrame((cb) => {
|
||||||
|
let spans = fixture.querySelectorAll("span");
|
||||||
|
expect(spans.length).toBe(1);
|
||||||
|
expect(spans[0].className).toBe(`chimay-${phase} chimay-${phase}-active`);
|
||||||
|
cb();
|
||||||
|
expect(spans[0].className).toBe(`chimay-${phase}-active chimay-${phase}-to`);
|
||||||
|
def.resolve();
|
||||||
|
});
|
||||||
|
|
||||||
|
// display the span
|
||||||
|
widget.state.flag = true;
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
widget.el!.querySelector("span")!.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(fixture.innerHTML).toBe('<div><span class="">blue</span></div>');
|
||||||
|
|
||||||
|
// click to remove the span, and click again to re-add it before transitionend
|
||||||
|
def = makeDeferred();
|
||||||
|
phase = "leave";
|
||||||
|
|
||||||
|
widget.state.flag = false;
|
||||||
|
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
def = makeDeferred();
|
||||||
|
phase = "enter";
|
||||||
|
widget.state.flag = true;
|
||||||
|
|
||||||
|
await def; // wait for the mocked repaint to be done
|
||||||
|
widget.el!.querySelector("span")!.dispatchEvent(new Event("transitionend")); // mock end of css transition
|
||||||
|
expect(fixture.innerHTML).toBe('<div><span class="" data-owl-key="__3__">blue</span></div>');
|
||||||
|
});
|
||||||
|
|
||||||
|
test("transitionInsert is called the correct amount of times", async () => {
|
||||||
|
const oldTransitionInsert = QWeb.utils.transitionInsert;
|
||||||
|
QWeb.utils.transitionInsert = jest.fn(oldTransitionInsert);
|
||||||
|
|
||||||
|
class Child extends Widget {
|
||||||
|
static template = xml`<span>blue</span>`;
|
||||||
|
}
|
||||||
|
class Parent extends Widget {
|
||||||
|
static template = xml`
|
||||||
|
<div t-name="Parent">
|
||||||
|
<Child t-if="state.flag" t-transition="chimay"/>
|
||||||
|
</div>`;
|
||||||
|
static components = { Child };
|
||||||
|
state = useState({ flag: false });
|
||||||
|
}
|
||||||
|
|
||||||
|
patchNextFrame((cb) => cb());
|
||||||
|
|
||||||
|
const widget = new Parent();
|
||||||
|
await widget.mount(fixture);
|
||||||
|
|
||||||
|
widget.state.flag = true;
|
||||||
|
|
||||||
|
await nextFrame();
|
||||||
|
widget.el!.querySelector("span")!.dispatchEvent(new Event("transitionend"));
|
||||||
|
expect(fixture.innerHTML).toBe('<div><span class="">blue</span></div>');
|
||||||
|
expect(QWeb.utils.transitionInsert).toBeCalledTimes(1);
|
||||||
|
|
||||||
|
widget.state.flag = false;
|
||||||
|
await nextFrame();
|
||||||
|
expect(fixture.innerHTML).toBe(
|
||||||
|
'<div><span class="chimay-leave-active chimay-leave-to" data-owl-key="__3__">blue</span></div>'
|
||||||
|
);
|
||||||
|
expect(QWeb.utils.transitionInsert).toBeCalledTimes(1);
|
||||||
|
|
||||||
|
widget.state.flag = true;
|
||||||
|
await nextFrame();
|
||||||
|
expect(fixture.innerHTML).toBe(
|
||||||
|
'<div><span class="chimay-enter-active chimay-enter-to" data-owl-key="__3__">blue</span></div>'
|
||||||
|
);
|
||||||
|
expect(QWeb.utils.transitionInsert).toBeCalledTimes(2);
|
||||||
|
|
||||||
|
widget.state.flag = false;
|
||||||
|
await nextFrame();
|
||||||
|
widget.state.flag = true;
|
||||||
|
await nextFrame();
|
||||||
|
|
||||||
|
expect(QWeb.utils.transitionInsert).toBeCalledTimes(3);
|
||||||
|
widget.el!.querySelector("span")!.dispatchEvent(new Event("transitionend"));
|
||||||
|
expect(fixture.innerHTML).toBe('<div><span class="" data-owl-key="__3__">blue</span></div>');
|
||||||
|
QWeb.utils.transitionInsert = oldTransitionInsert;
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -1,43 +0,0 @@
|
|||||||
// Jest Snapshot v1, https://goo.gl/fbAQLP
|
|
||||||
|
|
||||||
exports[`app App supports env with getters/setters 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-text-0/> <block-text-1/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['env'].someVal;
|
|
||||||
let txt2 = Object.keys(ctx['env'].services);
|
|
||||||
return block1([txt1, txt2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`app can configure an app with props 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-text-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let txt1 = ctx['props'].value;
|
|
||||||
return block1([txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`app destroy remove the widget from the DOM 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
return block1();
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
@@ -1,62 +0,0 @@
|
|||||||
import { App, Component, xml } from "../../src";
|
|
||||||
import { status } from "../../src/component/status";
|
|
||||||
import { makeTestFixture, snapshotEverything, nextTick, elem } from "../helpers";
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
snapshotEverything();
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("app", () => {
|
|
||||||
test("destroy remove the widget from the DOM", async () => {
|
|
||||||
class SomeComponent extends Component {
|
|
||||||
static template = xml`<div/>`;
|
|
||||||
}
|
|
||||||
|
|
||||||
const app = new App(SomeComponent);
|
|
||||||
const comp = await app.mount(fixture);
|
|
||||||
const el = elem(comp);
|
|
||||||
expect(document.contains(el)).toBe(true);
|
|
||||||
app.destroy();
|
|
||||||
expect(document.contains(el)).toBe(false);
|
|
||||||
expect(status(comp)).toBe("destroyed");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("App supports env with getters/setters", async () => {
|
|
||||||
let someVal = "maggot";
|
|
||||||
|
|
||||||
const services: any = { serv1: "" };
|
|
||||||
const env = {
|
|
||||||
get someVal() {
|
|
||||||
return someVal;
|
|
||||||
},
|
|
||||||
services,
|
|
||||||
};
|
|
||||||
|
|
||||||
class SomeComponent extends Component {
|
|
||||||
static template = xml`<div><t t-esc="env.someVal" /> <t t-esc="Object.keys(env.services)" /></div>`;
|
|
||||||
}
|
|
||||||
|
|
||||||
const app = new App(SomeComponent, { env });
|
|
||||||
const comp = await app.mount(fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div>maggot serv1</div>");
|
|
||||||
someVal = "brain";
|
|
||||||
services.serv2 = "";
|
|
||||||
comp.render();
|
|
||||||
await nextTick();
|
|
||||||
expect(fixture.innerHTML).toBe("<div>brain serv1,serv2</div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("can configure an app with props", async () => {
|
|
||||||
class SomeComponent extends Component {
|
|
||||||
static template = xml`<div t-esc="props.value"/>`;
|
|
||||||
}
|
|
||||||
|
|
||||||
const app = new App(SomeComponent, { props: { value: 333 } });
|
|
||||||
await app.mount(fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div>333</div>");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,297 +0,0 @@
|
|||||||
import { createBlock, mount, patch, remove, text } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("adding/patching blocks", () => {
|
|
||||||
test("simple block", async () => {
|
|
||||||
const block = createBlock("<div>foo</div>");
|
|
||||||
const tree = block();
|
|
||||||
expect(tree.el).toBe(undefined);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(tree.el).not.toBe(undefined);
|
|
||||||
expect(fixture.innerHTML).toBe("<div>foo</div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with dynamic content", async () => {
|
|
||||||
const block = createBlock("<div><p><block-text-0/></p></div>");
|
|
||||||
const tree = block(["foo"]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>foo</p></div>");
|
|
||||||
patch(tree, block(["bar"]));
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>bar</p></div>");
|
|
||||||
|
|
||||||
patch(tree, block(["foo"]));
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>foo</p></div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with 2 dynamic text nodes", async () => {
|
|
||||||
const block = createBlock("<div><p><block-text-0/></p><span><block-text-1/></span></div>");
|
|
||||||
const tree = block(["foo", "bar"]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>foo</p><span>bar</span></div>");
|
|
||||||
patch(tree, block(["appa", "yip yip"]));
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>appa</p><span>yip yip</span></div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with multiple references", async () => {
|
|
||||||
const block1 = createBlock(
|
|
||||||
"<div><block-text-0/><p><block-text-1/><block-text-2/></p><block-text-3/></div>"
|
|
||||||
);
|
|
||||||
const tree = block1(["1", "2", "3", "4"]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div>1<p>23</p>4</div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("falsy values in block nodes", () => {
|
|
||||||
const cases = [
|
|
||||||
[false, "false"],
|
|
||||||
[undefined, ""],
|
|
||||||
[null, ""],
|
|
||||||
[0, "0"],
|
|
||||||
["", ""],
|
|
||||||
];
|
|
||||||
const block = createBlock("<p><block-text-0/></p>");
|
|
||||||
|
|
||||||
for (let [value, result] of cases) {
|
|
||||||
const fixture = makeTestFixture();
|
|
||||||
mount(block([value as any]), fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<p>${result}</p>`);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("sub blocks", () => {
|
|
||||||
test("block with subblock (only child)", async () => {
|
|
||||||
const block1 = createBlock("<div><block-child-0/></div>");
|
|
||||||
const block2 = createBlock("<p>yip yip</p>");
|
|
||||||
const tree = block1([], [block2()]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>yip yip</p></div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with subblock (first child with sibling)", async () => {
|
|
||||||
const block1 = createBlock("<div><block-child-0/><span>something</span></div>");
|
|
||||||
const block2 = createBlock("<p>yip yip</p>");
|
|
||||||
const tree = block1([], [block2()]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>yip yip</p><span>something</span></div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with subblock (last child with sibling)", async () => {
|
|
||||||
const block1 = createBlock("<div><span>something</span><block-child-0/></div>");
|
|
||||||
const block2 = createBlock("<p>yip yip</p>");
|
|
||||||
const tree = block1([], [block2()]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
|
|
||||||
expect(fixture.innerHTML).toBe("<div><span>something</span><p>yip yip</p></div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with 2 subblocks", async () => {
|
|
||||||
const block1 = createBlock("<div><block-child-0/><block-child-1/></div>");
|
|
||||||
const block2 = createBlock("<p>yip yip</p>");
|
|
||||||
const tree = block1([], [block2(), text("appa")]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>yip yip</p>appa</div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with subblock with siblings", async () => {
|
|
||||||
const block1 = createBlock("<div><p>1</p><block-child-0/><p>2</p></div>");
|
|
||||||
const block2 = createBlock("<p>yip yip</p>");
|
|
||||||
|
|
||||||
const tree = block1([], [block2()]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>1</p><p>yip yip</p><p>2</p></div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with text, subblock and siblings", async () => {
|
|
||||||
let block1 = createBlock(`<div><p>before<block-child-0/>after</p><block-child-1/></div>`);
|
|
||||||
|
|
||||||
let tree = block1([], [text("water"), text("fire")]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>beforewaterafter</p>fire</div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with conditional child", async () => {
|
|
||||||
const block1 = createBlock("<div><p><block-child-0/></p></div>");
|
|
||||||
const block2 = createBlock("<span>foo</span>");
|
|
||||||
|
|
||||||
const tree = block1();
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p></p></div>");
|
|
||||||
|
|
||||||
patch(tree, block1([], [block2()]));
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p><span>foo</span></p></div>");
|
|
||||||
|
|
||||||
patch(tree, block1());
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p></p></div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with subblock with dynamic content", async () => {
|
|
||||||
const block1 = createBlock("<div><block-child-0/></div>");
|
|
||||||
const block2 = createBlock("<p><block-text-0/></p>");
|
|
||||||
const tree = block1([], [block2(["yip yip"])]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>yip yip</p></div>");
|
|
||||||
|
|
||||||
patch(tree, block1([], [block2(["foo"])]));
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>foo</p></div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with dynamic content and subblock", async () => {
|
|
||||||
const block1 = createBlock("<div><block-child-0/><p><block-text-0/></p></div>");
|
|
||||||
const block2 = createBlock("<p>sub block</p>");
|
|
||||||
const tree = block1(["yip yip"], [block2()]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>sub block</p><p>yip yip</p></div>");
|
|
||||||
|
|
||||||
patch(tree, block1(["foo"], [block2()]));
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>sub block</p><p>foo</p></div>");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("remove elem blocks", () => {
|
|
||||||
test("elem block can be removed", async () => {
|
|
||||||
const block = createBlock("<div>foo</div>");
|
|
||||||
const tree = block();
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div>foo</div>");
|
|
||||||
remove(tree);
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
expect(fixture.childNodes.length).toBe(0);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("misc", () => {
|
|
||||||
test("constructed block as correct number of refs", () => {
|
|
||||||
const block = createBlock("<p><p><block-text-0/></p><block-text-1/></p>");
|
|
||||||
const tree = block(["a", "b"]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p><p>a</p>b</p>");
|
|
||||||
expect((tree as any).refs.length).toBe(2);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block vnode can be used as text", () => {
|
|
||||||
const block = createBlock("<p>a</p>");
|
|
||||||
mount(text(block() as any), fixture);
|
|
||||||
expect(fixture.textContent).toBe("<p>a</p>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block vnode can be used to represent a <tr>", () => {
|
|
||||||
const block = createBlock("<tr><td>tomato</td></tr>");
|
|
||||||
const tree = block();
|
|
||||||
const fixture = document.createElement("table");
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.outerHTML).toBe("<table><tr><td>tomato</td></tr></table>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block vnode with <tr> can be used as text ", () => {
|
|
||||||
const block = createBlock("<tr><td>tomato</td></tr>");
|
|
||||||
mount(text(block() as any), fixture);
|
|
||||||
expect(fixture.textContent).toBe("<tr><td>tomato</td></tr>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("call toString for function/objects if used as inline text in block", () => {
|
|
||||||
const block = createBlock("<p><block-text-0/><block-text-1/></p>");
|
|
||||||
const f = () => 3;
|
|
||||||
const g = () => 4;
|
|
||||||
g.toString = () => "tostring";
|
|
||||||
mount(block([f, g]), fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p>() => 3tostring</p>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with 2 subblocks: variation", async () => {
|
|
||||||
const block = createBlock("<a><b><c><block-child-0/>2</c></b><block-child-1/></a>");
|
|
||||||
const tree = block([], [text("1"), text("3")]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<a><b><c>12</c></b>3</a>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("block with 2 subblocks: another variation", async () => {
|
|
||||||
const block = createBlock(
|
|
||||||
`<a block-attribute-0="hello"><b><c><block-child-0/>2</c></b><block-child-1/></a>`
|
|
||||||
);
|
|
||||||
const tree = block(["world"], [text("1"), text("3")]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<a hello="world"><b><c>12</c></b>3</a>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("namespace is not propagated to siblings", () => {
|
|
||||||
const block = createBlock(`<div><svg block-ns="someNameSpace"><g/></svg><div></div></div>`);
|
|
||||||
|
|
||||||
const fixture = makeTestFixture();
|
|
||||||
mount(block(), fixture);
|
|
||||||
|
|
||||||
expect(fixture.innerHTML).toBe("<div><svg><g></g></svg><div></div></div>");
|
|
||||||
expect(fixture.querySelector("svg")!.namespaceURI).toBe("someNameSpace");
|
|
||||||
expect(fixture.querySelector("g")!.namespaceURI).toBe("someNameSpace");
|
|
||||||
const allDivs = fixture.querySelectorAll("div");
|
|
||||||
expect(Array.from(allDivs).map((el) => el.namespaceURI)).toEqual([
|
|
||||||
"http://www.w3.org/1999/xhtml",
|
|
||||||
"http://www.w3.org/1999/xhtml",
|
|
||||||
]);
|
|
||||||
});
|
|
||||||
|
|
||||||
// test.skip("reusing a block skips patching process", async () => {
|
|
||||||
// const block = createBlock('<div><block-text-0/></div>');
|
|
||||||
// const foo = block(["foo"]);
|
|
||||||
// const bar = block(["bar"]);
|
|
||||||
// let fooCounter = 0;
|
|
||||||
// let barCounter = 0;
|
|
||||||
// let fooValue = "foo";
|
|
||||||
// let barValue = "bar";
|
|
||||||
// Object.defineProperty(foo.data, 0, {
|
|
||||||
// get() {
|
|
||||||
// fooCounter++;
|
|
||||||
// return fooValue;
|
|
||||||
// },
|
|
||||||
// });
|
|
||||||
// Object.defineProperty(bar.data, 0, {
|
|
||||||
// get() {
|
|
||||||
// barCounter++;
|
|
||||||
// return barValue;
|
|
||||||
// },
|
|
||||||
// set(val) {
|
|
||||||
// barValue = val;
|
|
||||||
// },
|
|
||||||
// });
|
|
||||||
|
|
||||||
// const bdom = multi([foo, bar]);
|
|
||||||
// mount(bdom, fixture);
|
|
||||||
// expect(fooCounter).toBe(1);
|
|
||||||
// expect(barCounter).toBe(1);
|
|
||||||
// expect(fixture.innerHTML).toBe("<div>foo</div><div>bar</div>");
|
|
||||||
|
|
||||||
// patch(bdom, multi([foo, block(["otherbar"])]));
|
|
||||||
// expect(fixture.innerHTML).toBe("foootherbar");
|
|
||||||
// expect(fooCounter).toBe(1);
|
|
||||||
// expect(barCounter).toBe(2);
|
|
||||||
// });
|
|
||||||
});
|
|
||||||
@@ -1,182 +0,0 @@
|
|||||||
import { mount, patch, createBlock } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
test("simple attribute", async () => {
|
|
||||||
const block = createBlock('<div block-attribute-0="hello"></div>');
|
|
||||||
const tree = block(["world"]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<div hello="world"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block(["owl"]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div hello="owl"></div>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("updating attribute with falsy value", async () => {
|
|
||||||
const block = createBlock('<div block-attribute-0="hello"></div>');
|
|
||||||
const tree = block([false]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<div></div>`);
|
|
||||||
|
|
||||||
patch(tree, block(["owl"]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div hello="owl"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([false]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div></div>`);
|
|
||||||
|
|
||||||
patch(tree, block(["owl"]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div hello="owl"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([undefined]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div></div>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("dynamic attribute (pair)", async () => {
|
|
||||||
const block = createBlock('<div block-attributes="0"></div>');
|
|
||||||
const tree = block([["hello", "world"]]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<div hello="world"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([["ola", "mundo"]]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div ola="mundo"></div>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("dynamic attribute (pair, with false value)", async () => {
|
|
||||||
const block = createBlock('<div block-attributes="0"></div>');
|
|
||||||
const tree = block([["hello", false]]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<div></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([["hello", "world"]]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div hello="world"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([["hello", false]]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div></div>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("dynamic attribute (object)", async () => {
|
|
||||||
const block = createBlock('<div block-attributes="0"></div>');
|
|
||||||
const tree = block([{ hello: "world" }]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<div hello="world"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([{ ola: "mundo" }]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div ola="mundo"></div>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("dynamic attribute (object), with falsy values", async () => {
|
|
||||||
const block = createBlock('<div block-attributes="0"></div>');
|
|
||||||
const tree = block([{ hello: "world", blip: false }]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<div hello="world"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([{ ola: "mundo", blip: undefined }]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div ola="mundo"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([{ ola: false, blip: 1 }]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div blip="1"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([{ ola: undefined, blip: undefined }]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div></div>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("class attribute", async () => {
|
|
||||||
const block = createBlock('<div block-attribute-0="class"></div>');
|
|
||||||
const tree = block(["fire"]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<div class="fire"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block(["water"]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div class="water"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([""]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div class=""></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([0]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div class="0"></div>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("attribute with undefined value", async () => {
|
|
||||||
const block = createBlock('<div block-attribute-0="abc"></div>');
|
|
||||||
const tree = block([undefined]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<div></div>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("class attribute with undefined value", async () => {
|
|
||||||
const block = createBlock('<div block-attribute-0="class"></div>');
|
|
||||||
const tree = block([undefined]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<div></div>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("class attribute (with a preexisting value", async () => {
|
|
||||||
const block = createBlock('<div class="tomato" block-attribute-0="class"></div>');
|
|
||||||
const tree = block(["potato"]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<div class="tomato potato"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block(["squash"]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div class="tomato squash"></div>`);
|
|
||||||
|
|
||||||
patch(tree, block([""]));
|
|
||||||
expect(fixture.innerHTML).toBe(`<div class="tomato"></div>`);
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("properties", () => {
|
|
||||||
test("input with value attribute", () => {
|
|
||||||
// render input with initial value
|
|
||||||
const block = createBlock(`<input block-attribute-0="value"/>`);
|
|
||||||
|
|
||||||
const tree = block(["zucchini"]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
// const bnode1 = renderToBdom(template, { v: "zucchini" });
|
|
||||||
// const fixture = makeTestFixture();
|
|
||||||
// mount(bnode1, fixture);
|
|
||||||
const input = fixture.querySelector("input")!;
|
|
||||||
expect(input.value).toBe("zucchini");
|
|
||||||
|
|
||||||
// change value manually in input, to simulate user input
|
|
||||||
input.value = "tomato";
|
|
||||||
expect(input.value).toBe("tomato");
|
|
||||||
|
|
||||||
// rerender with a different value, and patch actual dom, to check that
|
|
||||||
// input value was properly reset by owl
|
|
||||||
patch(tree, block(["potato"]));
|
|
||||||
expect(input.value).toBe("potato");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("input type=checkbox with checked attribute", () => {
|
|
||||||
// render input with initial value
|
|
||||||
const block = createBlock(`<input type="checkbox" block-attribute-0="checked"/>`);
|
|
||||||
|
|
||||||
const tree = block([true]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(`<input type="checkbox">`);
|
|
||||||
const input = fixture.querySelector("input")!;
|
|
||||||
expect(input.checked).toBe(true);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,273 +0,0 @@
|
|||||||
import { mount, createBlock, multi, config, patch } from "../../src/blockdom";
|
|
||||||
// import { defaultHandler, setupMainHandler } from "../../src/bdom/block";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
let initialHandler = config.mainEventHandler;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
config.mainEventHandler = initialHandler;
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
test("simple event handling, with function", async () => {
|
|
||||||
const block = createBlock('<div block-handler-0="click"></div>');
|
|
||||||
let n = 0;
|
|
||||||
const tree = block([() => n++]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
|
|
||||||
expect(fixture.firstChild).toBeInstanceOf(HTMLDivElement);
|
|
||||||
expect(n).toBe(0);
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
expect(n).toBe(1);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("simple event handling, with function and argument", async () => {
|
|
||||||
const block = createBlock('<div block-handler-0="click"></div>');
|
|
||||||
let n = 0;
|
|
||||||
const onClick = (arg: number) => {
|
|
||||||
n += arg;
|
|
||||||
};
|
|
||||||
const tree = block([[onClick, 3]]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
|
|
||||||
expect(fixture.firstChild).toBeInstanceOf(HTMLDivElement);
|
|
||||||
expect(n).toBe(0);
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
expect(n).toBe(3);
|
|
||||||
|
|
||||||
patch(tree, block([[onClick, 5]]));
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
expect(n).toBe(8);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("simple event handling ", async () => {
|
|
||||||
config.mainEventHandler = (data, ev) => {
|
|
||||||
if (typeof data === "function") {
|
|
||||||
data();
|
|
||||||
} else {
|
|
||||||
const [owner, method] = data;
|
|
||||||
owner[method]();
|
|
||||||
}
|
|
||||||
return false;
|
|
||||||
};
|
|
||||||
|
|
||||||
const block = createBlock('<div block-handler-0="click"></div>');
|
|
||||||
let n = 0;
|
|
||||||
const obj = { f: () => n++ };
|
|
||||||
const tree = block([[obj, "f"]]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
|
|
||||||
expect(fixture.firstChild).toBeInstanceOf(HTMLDivElement);
|
|
||||||
expect(n).toBe(0);
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
expect(n).toBe(1);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("can bind two handlers on same node", async () => {
|
|
||||||
const block = createBlock('<div block-handler-0="click" block-handler-1="dblclick"></div>');
|
|
||||||
let steps: string[] = [];
|
|
||||||
let handleClick = () => steps.push("click");
|
|
||||||
let handleDblClick = () => steps.push("dblclick");
|
|
||||||
const tree = block([handleClick, handleDblClick]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
(fixture.firstChild as HTMLDivElement).dispatchEvent(new Event("dblclick", { bubbles: true }));
|
|
||||||
expect(steps).toEqual(["click", "dblclick"]);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("two same block nodes with different handlers", async () => {
|
|
||||||
const block = createBlock('<div block-handler-0="click"></div>');
|
|
||||||
let steps: string[] = [];
|
|
||||||
let handler1 = () => steps.push("1");
|
|
||||||
let handler2 = () => steps.push("2");
|
|
||||||
const tree = multi([block([handler1]), block([handler2])]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div><div></div>");
|
|
||||||
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
(fixture.firstChild!.nextSibling as HTMLDivElement).click();
|
|
||||||
expect(steps).toEqual(["1", "2"]);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("two same block nodes with different handlers (synthetic)", async () => {
|
|
||||||
const block = createBlock('<div block-handler-0="click.synthetic"></div>');
|
|
||||||
let steps: string[] = [];
|
|
||||||
let handler1 = () => steps.push("1");
|
|
||||||
let handler2 = () => steps.push("2");
|
|
||||||
const tree = multi([block([handler1]), block([handler2])]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div><div></div>");
|
|
||||||
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
(fixture.firstChild!.nextSibling as HTMLDivElement).click();
|
|
||||||
expect(steps).toEqual(["1", "2"]);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("two event handlers on same event", async () => {
|
|
||||||
const block = createBlock('<div block-handler-0="click" block-handler-1="click"></div>');
|
|
||||||
let n = 0;
|
|
||||||
let m = 0;
|
|
||||||
const tree = block([() => m++, () => n++]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
|
|
||||||
expect(m).toBe(0);
|
|
||||||
expect(n).toBe(0);
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
expect(m).toBe(1);
|
|
||||||
expect(n).toBe(1);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("two synthetic event handlers on same event", async () => {
|
|
||||||
const block = createBlock(
|
|
||||||
'<div block-handler-0="click.synthetic" block-handler-1="click.synthetic"></div>'
|
|
||||||
);
|
|
||||||
let n = 0;
|
|
||||||
let m = 0;
|
|
||||||
const tree = block([() => m++, () => n++]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
|
|
||||||
expect(m).toBe(0);
|
|
||||||
expect(n).toBe(0);
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
expect(m).toBe(1);
|
|
||||||
expect(n).toBe(1);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("synthetic and native handlers can cohabitate", async () => {
|
|
||||||
const block = createBlock(
|
|
||||||
'<div block-handler-0="click.synthetic"><div block-handler-1="click"/></div>'
|
|
||||||
);
|
|
||||||
let steps: string[] = [];
|
|
||||||
let handler1 = () => steps.push("1");
|
|
||||||
let handler2 = () => steps.push("2");
|
|
||||||
const tree = block([handler1, handler2]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><div></div></div>");
|
|
||||||
|
|
||||||
(fixture.firstChild!.firstChild as HTMLDivElement).click();
|
|
||||||
expect(steps).toEqual(["2", "1"]);
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
expect(steps).toEqual(["2", "1", "1"]);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("synthetic and native handlers can cohabitate (2)", async () => {
|
|
||||||
const block = createBlock(
|
|
||||||
'<div block-handler-0="click"><div block-handler-1="click.synthetic"/></div>'
|
|
||||||
);
|
|
||||||
let steps: string[] = [];
|
|
||||||
let handler1 = () => steps.push("1");
|
|
||||||
let handler2 = () => steps.push("2");
|
|
||||||
const tree = block([handler1, handler2]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><div></div></div>");
|
|
||||||
|
|
||||||
(fixture.firstChild!.firstChild as HTMLDivElement).click();
|
|
||||||
expect(steps).toEqual(["1", "2"]);
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
expect(steps).toEqual(["1", "2", "1"]);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("synthetic and native handlers can cohabitate (3)", async () => {
|
|
||||||
const parent = createBlock(`<div block-handler-0="click"><block-child-0/><block-child-1/></div>`);
|
|
||||||
const block = createBlock('<div block-handler-0="click"/>');
|
|
||||||
const blockSynth = createBlock('<div block-handler-0="click.synthetic"/>');
|
|
||||||
let steps: string[] = [];
|
|
||||||
const handler0 = () => steps.push("0");
|
|
||||||
let handler1 = () => steps.push("1");
|
|
||||||
let handler2 = () => steps.push("2");
|
|
||||||
const tree = parent([handler0], [block([handler1]), blockSynth([handler2])]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><div></div><div></div></div>");
|
|
||||||
|
|
||||||
const children = fixture.children[0].children;
|
|
||||||
|
|
||||||
(children[0] as HTMLElement).click();
|
|
||||||
expect(steps).toEqual(["1", "0"]);
|
|
||||||
(children[1] as HTMLElement).click();
|
|
||||||
expect(steps).toEqual(["1", "0", "0", "2"]);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("synthetic and native handlers can cohabitate (4)", async () => {
|
|
||||||
const parent = createBlock(`<div block-handler-0="click"><block-child-0/><block-child-1/></div>`);
|
|
||||||
const block = createBlock('<div block-handler-0="click"/>');
|
|
||||||
const blockSynth = createBlock('<div block-handler-0="click.synthetic"/>');
|
|
||||||
let steps: string[] = [];
|
|
||||||
const handler0 = (ev: Event) => {
|
|
||||||
steps.push("0");
|
|
||||||
ev.stopPropagation();
|
|
||||||
};
|
|
||||||
let handler1 = () => steps.push("1");
|
|
||||||
let handler2 = () => steps.push("2");
|
|
||||||
const tree = parent([handler0], [block([handler1]), blockSynth([handler2])]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><div></div><div></div></div>");
|
|
||||||
|
|
||||||
const children = fixture.children[0].children;
|
|
||||||
|
|
||||||
(children[0] as HTMLElement).click();
|
|
||||||
expect(steps).toEqual(["1", "0"]);
|
|
||||||
(children[1] as HTMLElement).click();
|
|
||||||
expect(steps).toEqual(["1", "0", "0"]);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("synthetic and native handlers can cohabitate (5)", async () => {
|
|
||||||
const block = createBlock('<div block-handler-0="click.synthetic" block-handler-1="click"/>');
|
|
||||||
let steps: string[] = [];
|
|
||||||
let handler1 = () => steps.push("1");
|
|
||||||
let handler2 = () => steps.push("2");
|
|
||||||
const tree = block([handler1, handler2]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
expect(steps).toEqual(["2", "1"]);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("synthetic and native handlers can cohabitate (6)", async () => {
|
|
||||||
const block = createBlock(`<div
|
|
||||||
block-handler-0="click.synthetic"
|
|
||||||
block-handler-1="click"
|
|
||||||
block-handler-2="click.synthetic"
|
|
||||||
block-handler-3="click"
|
|
||||||
/>`);
|
|
||||||
let steps: string[] = [];
|
|
||||||
const handler1 = () => steps.push("1");
|
|
||||||
const handler2 = () => steps.push("2");
|
|
||||||
const handler3 = () => steps.push("3");
|
|
||||||
const handler4 = () => steps.push("4");
|
|
||||||
const tree = block([handler1, handler2, handler3, handler4]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
|
|
||||||
(fixture.firstChild as HTMLDivElement).click();
|
|
||||||
expect(steps).toEqual(["2", "4", "1", "3"]);
|
|
||||||
});
|
|
||||||
@@ -1,57 +0,0 @@
|
|||||||
import { createBlock, mount, patch, remove } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
test("simple callback ref", async () => {
|
|
||||||
const block = createBlock('<div><span block-ref="0">hey</span></div>');
|
|
||||||
let arg: any = undefined;
|
|
||||||
let n = 0;
|
|
||||||
const refFn = (_arg: any) => {
|
|
||||||
n++;
|
|
||||||
arg = _arg;
|
|
||||||
};
|
|
||||||
|
|
||||||
const tree = block([refFn]);
|
|
||||||
|
|
||||||
expect(arg).toBeUndefined();
|
|
||||||
expect(n).toBe(0);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><span>hey</span></div>");
|
|
||||||
expect(n).toBe(1);
|
|
||||||
|
|
||||||
expect(arg).toBeInstanceOf(HTMLSpanElement);
|
|
||||||
expect(arg!.innerHTML).toBe("hey");
|
|
||||||
|
|
||||||
patch(tree, block([refFn]));
|
|
||||||
expect(n).toBe(1);
|
|
||||||
|
|
||||||
remove(tree);
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
expect(arg).toBeNull();
|
|
||||||
expect(n).toBe(2);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("is in dom when callback is called", async () => {
|
|
||||||
expect.assertions(1);
|
|
||||||
const block = createBlock('<div><span block-ref="0">hey</span></div>');
|
|
||||||
const refFn = (span: any) => {
|
|
||||||
expect(document.body.contains(span)).toBeTruthy();
|
|
||||||
};
|
|
||||||
|
|
||||||
const tree = block([refFn]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
});
|
|
||||||
@@ -1,26 +0,0 @@
|
|||||||
import { comment, mount } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
test("simple comment node", async () => {
|
|
||||||
const tree = comment("foo");
|
|
||||||
expect(tree.el).toBe(undefined);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<!--foo-->");
|
|
||||||
expect(tree.el).not.toBe(undefined);
|
|
||||||
tree.remove();
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
});
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
let lastFixture: any = null;
|
|
||||||
|
|
||||||
export function makeTestFixture() {
|
|
||||||
let fixture = document.createElement("div");
|
|
||||||
document.body.appendChild(fixture);
|
|
||||||
if (lastFixture) {
|
|
||||||
lastFixture.remove();
|
|
||||||
}
|
|
||||||
lastFixture = fixture;
|
|
||||||
return fixture;
|
|
||||||
}
|
|
||||||
@@ -1,48 +0,0 @@
|
|||||||
import { html, mount, patch, text } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Tests
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
describe("html block", () => {
|
|
||||||
test("can be mounted and patched", async () => {
|
|
||||||
const tree = html("<span>1</span><span>2</span>");
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<span>1</span><span>2</span>");
|
|
||||||
|
|
||||||
patch(tree, html("<div>coucou</div>"));
|
|
||||||
expect(fixture.innerHTML).toBe("<div>coucou</div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("html vnode can be used as text", () => {
|
|
||||||
mount(text(html("<p>a</p>") as any), fixture);
|
|
||||||
expect(fixture.textContent).toBe("<p>a</p>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("html vnode can represent <tr>", () => {
|
|
||||||
const fixture = document.createElement("table");
|
|
||||||
// const block = createBlock('<table><block-child-0/></table>');
|
|
||||||
// const tree = block([], [html(`<tr><td>tomato</td></tr>`)]);
|
|
||||||
const tree = html(`<tr><td>tomato</td></tr>`);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<tr><td>tomato</td></tr>");
|
|
||||||
|
|
||||||
patch(tree, html(`<tr><td>potato</td></tr>`));
|
|
||||||
expect(fixture.innerHTML).toBe("<tr><td>potato</td></tr>");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,458 +0,0 @@
|
|||||||
import { list, mount, multi, patch, text, createBlock, VNode, withKey } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
function kText(str: string, key: any): VNode {
|
|
||||||
return withKey(text(str), key);
|
|
||||||
}
|
|
||||||
|
|
||||||
function n(n: number) {
|
|
||||||
return kText(String(n), n);
|
|
||||||
}
|
|
||||||
|
|
||||||
const span = createBlock("<span><block-text-0/></span>");
|
|
||||||
const p = createBlock("<p><block-text-0/></p>");
|
|
||||||
|
|
||||||
function kSpan(str: string, key: any): VNode {
|
|
||||||
return withKey(span([str]), key);
|
|
||||||
}
|
|
||||||
|
|
||||||
function kPair(n: number): VNode {
|
|
||||||
const bnodes = [p([String(n)]), p([String(n)])];
|
|
||||||
return withKey(multi(bnodes), n);
|
|
||||||
}
|
|
||||||
|
|
||||||
describe("list node: misc", () => {
|
|
||||||
test("list node", async () => {
|
|
||||||
const bnodes = [1, 2, 3].map((key) => kText(`text${key}`, key));
|
|
||||||
|
|
||||||
const tree = list(bnodes);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("text1text2text3");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("list vnode can be used as text", () => {
|
|
||||||
mount(text(list([text("a"), text("b")]) as any), fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("ab");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("a list block can be removed and leaves nothing", async () => {
|
|
||||||
const bnodes = [
|
|
||||||
{ id: 1, name: "sheep" },
|
|
||||||
{ id: 2, name: "cow" },
|
|
||||||
].map((elem) => kText(elem.name, elem.id));
|
|
||||||
|
|
||||||
const tree = list(bnodes);
|
|
||||||
expect(fixture.childNodes.length).toBe(0);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.childNodes.length).toBe(3);
|
|
||||||
expect(fixture.innerHTML).toBe("sheepcow");
|
|
||||||
|
|
||||||
tree.remove();
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
expect(fixture.childNodes.length).toBe(0);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("patching a list block inside an elem block", async () => {
|
|
||||||
const block = createBlock("<div><block-child-0/></div>");
|
|
||||||
const tree = block();
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
|
|
||||||
patch(tree, block([], [list([1, 2, 3].map(n))]));
|
|
||||||
expect(fixture.innerHTML).toBe("<div>123</div>");
|
|
||||||
|
|
||||||
patch(tree, block([], [list([])]));
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
|
|
||||||
patch(tree, block([], [list([1, 2, 3].map(n))]));
|
|
||||||
expect(fixture.innerHTML).toBe("<div>123</div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("list of lists", async () => {
|
|
||||||
const tree = list([
|
|
||||||
withKey(list([kText("a1", "1"), kText("a2", "2")]), "a"),
|
|
||||||
withKey(list([kText("b1", "1"), kText("b2", "2")]), "b"),
|
|
||||||
]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("a1a2b1b2");
|
|
||||||
|
|
||||||
patch(
|
|
||||||
tree,
|
|
||||||
list([
|
|
||||||
withKey(list([kText("b1", "1"), kText("b2", "2")]), "b"),
|
|
||||||
withKey(list([kText("a1", "1"), kText("a2", "2")]), "a"),
|
|
||||||
])
|
|
||||||
);
|
|
||||||
|
|
||||||
expect(fixture.innerHTML).toBe("b1b2a1a2");
|
|
||||||
|
|
||||||
patch(
|
|
||||||
tree,
|
|
||||||
list([
|
|
||||||
withKey(list([kText("a2", "2"), kText("a1", "1")]), "a"),
|
|
||||||
withKey(list([kText("b2", "2"), kText("b1", "1")]), "b"),
|
|
||||||
])
|
|
||||||
);
|
|
||||||
|
|
||||||
expect(fixture.innerHTML).toBe("a2a1b2b1");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("adding/removing elements", () => {
|
|
||||||
test("removing elements", () => {
|
|
||||||
const tree = list([kText("a", "a")]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("a");
|
|
||||||
|
|
||||||
patch(tree, list([]));
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("removing 1 elements from 2", () => {
|
|
||||||
const tree = list([kText("a", "a"), kText("b", "b")]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("ab");
|
|
||||||
|
|
||||||
patch(tree, list([kText("a", "a")]));
|
|
||||||
expect(fixture.innerHTML).toBe("a");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("removing elements", () => {
|
|
||||||
const tree = list([kSpan("a", "a")]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<span>a</span>");
|
|
||||||
|
|
||||||
patch(tree, list([]));
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("removing elements, variation", () => {
|
|
||||||
const f = (i: number) => {
|
|
||||||
const b = multi([span([`a${i}`]), span([`b${i}`])]);
|
|
||||||
b.key = i;
|
|
||||||
return b;
|
|
||||||
};
|
|
||||||
const tree = list([f(1), f(2)]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<span>a1</span><span>b1</span><span>a2</span><span>b2</span>");
|
|
||||||
|
|
||||||
patch(tree, list([]));
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("adding one element at the end", () => {
|
|
||||||
const tree = list([n(1), n(2)]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("12");
|
|
||||||
|
|
||||||
patch(tree, list([n(1), n(2), n(3)]));
|
|
||||||
expect(fixture.innerHTML).toBe("123");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("adding one element at the end", () => {
|
|
||||||
const tree = list([n(1)]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("1");
|
|
||||||
|
|
||||||
patch(tree, list([n(1), n(2), n(3)]));
|
|
||||||
expect(fixture.innerHTML).toBe("123");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("prepend elements: 4,5 => 1,2,3,4,5", () => {
|
|
||||||
const tree = list([n(4), n(5)]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("45");
|
|
||||||
|
|
||||||
patch(tree, list([n(1), n(2), n(3), n(4), n(5)]));
|
|
||||||
expect(fixture.innerHTML).toBe("12345");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("prepend elements: 4,5 => 1,2,3,4,5 (with multi)", () => {
|
|
||||||
const tree = list([kPair(4), kPair(5)]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p>4</p><p>4</p><p>5</p><p>5</p>");
|
|
||||||
|
|
||||||
patch(tree, list([1, 2, 3, 4, 5].map(kPair)));
|
|
||||||
expect(fixture.innerHTML).toBe(
|
|
||||||
"<p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p><p>4</p><p>4</p><p>5</p><p>5</p>"
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("add element in middle: 1,2,4,5 => 1,2,3,4,5", () => {
|
|
||||||
const tree = list([1, 2, 4, 5].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("1245");
|
|
||||||
|
|
||||||
patch(tree, list([1, 2, 3, 4, 5].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("12345");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("add element in middle: 1,2,4,5 => 1,2,3,4,5 (multi)", () => {
|
|
||||||
const tree = list([1, 2, 4, 5].map(kPair));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(
|
|
||||||
"<p>1</p><p>1</p><p>2</p><p>2</p><p>4</p><p>4</p><p>5</p><p>5</p>"
|
|
||||||
);
|
|
||||||
|
|
||||||
patch(tree, list([1, 2, 3, 4, 5].map(kPair)));
|
|
||||||
expect(fixture.innerHTML).toBe(
|
|
||||||
"<p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p><p>4</p><p>4</p><p>5</p><p>5</p>"
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("add element at beginning and end: 2,3,4 => 1,2,3,4,5", () => {
|
|
||||||
const tree = list([2, 3, 4].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("234");
|
|
||||||
|
|
||||||
patch(tree, list([1, 2, 3, 4, 5].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("12345");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("add element at beginning and end: 2,3,4 => 1,2,3,4,5 (multi)", () => {
|
|
||||||
const tree = list([2, 3, 4].map(kPair));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p>2</p><p>2</p><p>3</p><p>3</p><p>4</p><p>4</p>");
|
|
||||||
|
|
||||||
patch(tree, list([1, 2, 3, 4, 5].map(kPair)));
|
|
||||||
expect(fixture.innerHTML).toBe(
|
|
||||||
"<p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p><p>4</p><p>4</p><p>5</p><p>5</p>"
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("adds children: [] => [1,2,3]", () => {
|
|
||||||
const tree = list([].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
|
|
||||||
patch(tree, list([1, 2, 3].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("123");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("adds children: [] => [1,2,3] (multi)", () => {
|
|
||||||
const tree = list([].map(kPair));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
|
|
||||||
patch(tree, list([1, 2, 3].map(kPair)));
|
|
||||||
expect(fixture.innerHTML).toBe("<p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("adds children: [] => [1,2,3] (inside elem)", () => {
|
|
||||||
const block = createBlock("<p><block-child-0/></p>");
|
|
||||||
const tree = block([], []);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p></p>");
|
|
||||||
|
|
||||||
patch(tree, block([], [list([1, 2, 3].map(n))]));
|
|
||||||
expect(fixture.innerHTML).toBe("<p>123</p>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("adds children: [] => [1,2,3] (inside elem, multi)", () => {
|
|
||||||
const block = createBlock("<p><block-child-0/></p>");
|
|
||||||
const tree = block([], []);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p></p>");
|
|
||||||
|
|
||||||
patch(tree, block([], [list([1, 2, 3].map(kPair))]));
|
|
||||||
expect(fixture.innerHTML).toBe("<p><p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p></p>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("remove children: [1,2,3] => []", () => {
|
|
||||||
const tree = list([1, 2, 3].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("123");
|
|
||||||
|
|
||||||
patch(tree, list([].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("remove children: [1,2,3] => [] (multi)", () => {
|
|
||||||
const tree = list([1, 2, 3].map(kPair));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p>");
|
|
||||||
|
|
||||||
patch(tree, list([].map(kPair)));
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("remove children: [1,2,3] => [] (inside elem)", () => {
|
|
||||||
const block = createBlock("<p><block-child-0/></p>");
|
|
||||||
const tree = block([], [list([1, 2, 3].map(n))]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p>123</p>");
|
|
||||||
|
|
||||||
patch(tree, block([], [list([])]));
|
|
||||||
expect(fixture.innerHTML).toBe("<p></p>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("remove children from the beginning: [1,2,3,4,5] => [3,4,5]", () => {
|
|
||||||
const tree = list([1, 2, 3, 4, 5].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("12345");
|
|
||||||
|
|
||||||
patch(tree, list([3, 4, 5].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("345");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("remove children from the beginning: [1,2,3,4,5] => [3,4,5] (multi)", () => {
|
|
||||||
const tree = list([1, 2, 3, 4, 5].map(kPair));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(
|
|
||||||
"<p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p><p>4</p><p>4</p><p>5</p><p>5</p>"
|
|
||||||
);
|
|
||||||
patch(tree, list([3, 4, 5].map(kPair)));
|
|
||||||
expect(fixture.innerHTML).toBe("<p>3</p><p>3</p><p>4</p><p>4</p><p>5</p><p>5</p>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("remove children from the end: [1,2,3,4,5] => [1,2,3]", () => {
|
|
||||||
const tree = list([1, 2, 3, 4, 5].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("12345");
|
|
||||||
|
|
||||||
patch(tree, list([1, 2, 3].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("123");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("remove children from the middle: [1,2,3,4,5] => [1,2,4,5]", () => {
|
|
||||||
const tree = list([1, 2, 3, 4, 5].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("12345");
|
|
||||||
|
|
||||||
patch(tree, list([1, 2, 4, 5].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("1245");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("element reordering", () => {
|
|
||||||
test("move element forward: [1,2,3,4] => [2,3,1,4]", () => {
|
|
||||||
const tree = list([1, 2, 3, 4].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("1234");
|
|
||||||
|
|
||||||
patch(tree, list([2, 3, 1, 4].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("2314");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("move element forward: [1,2,3,4] => [2,3,1,4] (multi)", () => {
|
|
||||||
const tree = list([1, 2, 3, 4].map(kPair));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(
|
|
||||||
"<p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p><p>4</p><p>4</p>"
|
|
||||||
);
|
|
||||||
patch(tree, list([2, 3, 1, 4].map(kPair)));
|
|
||||||
expect(fixture.innerHTML).toBe(
|
|
||||||
"<p>2</p><p>2</p><p>3</p><p>3</p><p>1</p><p>1</p><p>4</p><p>4</p>"
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("move element to end: [1,2,3] => [2,3,1]", () => {
|
|
||||||
const tree = list([1, 2, 3].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("123");
|
|
||||||
|
|
||||||
patch(tree, list([2, 3, 1].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("231");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("move element to end: [1,2,3] => [2,3,1] (multi)", () => {
|
|
||||||
const tree = list([1, 2, 3].map(kPair));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p>");
|
|
||||||
|
|
||||||
patch(tree, list([2, 3, 1].map(kPair)));
|
|
||||||
expect(fixture.innerHTML).toBe("<p>2</p><p>2</p><p>3</p><p>3</p><p>1</p><p>1</p>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("move element backward: [1,2,3,4] => [1,4,2,3]", () => {
|
|
||||||
const tree = list([1, 2, 3, 4].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("1234");
|
|
||||||
|
|
||||||
patch(tree, list([1, 4, 2, 3].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("1423");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("swaps first and last: [1,2,3,4] => [4,3,2,1]", () => {
|
|
||||||
const tree = list([1, 2, 3, 4].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("1234");
|
|
||||||
|
|
||||||
patch(tree, list([4, 3, 2, 1].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("4321");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("miscellaneous operations", () => {
|
|
||||||
test("move to left and replace: [1,2,3,4,5] => [4,1,2,3,6]", () => {
|
|
||||||
const tree = list([1, 2, 3, 4, 5].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("12345");
|
|
||||||
|
|
||||||
patch(tree, list([4, 1, 2, 3, 6].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("41236");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("move to left and replace: [1,2,3,4,5] => [4,1,2,3,6] (multi)", () => {
|
|
||||||
const tree = list([1, 2, 3, 4, 5].map(kPair));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(
|
|
||||||
"<p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p><p>4</p><p>4</p><p>5</p><p>5</p>"
|
|
||||||
);
|
|
||||||
|
|
||||||
patch(tree, list([4, 1, 2, 3, 6].map(kPair)));
|
|
||||||
expect(fixture.innerHTML).toBe(
|
|
||||||
"<p>4</p><p>4</p><p>1</p><p>1</p><p>2</p><p>2</p><p>3</p><p>3</p><p>6</p><p>6</p>"
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("move to left and leave hole: [1,4,5] => [4,6]", () => {
|
|
||||||
const tree = list([1, 4, 5].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("145");
|
|
||||||
|
|
||||||
patch(tree, list([4, 6].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("46");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("[2,4,5] => [4,5,3]", () => {
|
|
||||||
const tree = list([2, 4, 5].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("245");
|
|
||||||
|
|
||||||
patch(tree, list([4, 5, 3].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("453");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("reverse elements [1,2,3,4,5,6,7,8] => [8,7,6,5,4,3,2,1]", () => {
|
|
||||||
const tree = list([1, 2, 3, 4, 5, 6, 7, 8].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("12345678");
|
|
||||||
|
|
||||||
patch(tree, list([8, 7, 6, 5, 4, 3, 2, 1].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("87654321");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("some permutation [0,1,2,3,4,5] => [4,3,2,1,5,0]", () => {
|
|
||||||
const tree = list([0, 1, 2, 3, 4, 5].map(n));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("012345");
|
|
||||||
|
|
||||||
patch(tree, list([4, 3, 2, 1, 5, 0].map(n)));
|
|
||||||
expect(fixture.innerHTML).toBe("432150");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,86 +0,0 @@
|
|||||||
import { mount, multi, patch, text, createBlock } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("multi blocks", () => {
|
|
||||||
test("multiblock with 2 text blocks", async () => {
|
|
||||||
const tree = multi([text("foo"), text("bar")]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("foobar");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("a multiblock can be removed and leaves no extra text nodes", async () => {
|
|
||||||
const block1 = createBlock("<div>foo</div>");
|
|
||||||
const block2 = createBlock("<span>bar</span>");
|
|
||||||
|
|
||||||
const tree = multi([block1(), block2()]);
|
|
||||||
|
|
||||||
expect(fixture.childNodes.length).toBe(0);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.childNodes.length).toBe(2);
|
|
||||||
tree.remove();
|
|
||||||
expect(fixture.childNodes.length).toBe(0);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("multiblock with an empty children", async () => {
|
|
||||||
const block = createBlock("<div>foo</div>");
|
|
||||||
const tree = multi([block(), undefined]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div>foo</div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("multi block in a regular block", async () => {
|
|
||||||
const block1 = createBlock("<div><block-child-0/></div>");
|
|
||||||
const block2 = createBlock("<span>yip yip</span>");
|
|
||||||
|
|
||||||
const tree = block1([], [multi([block2()])]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><span>yip yip</span></div>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("patching a multiblock ", async () => {
|
|
||||||
const tree = multi([text("foo"), text("bar")]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("foobar");
|
|
||||||
|
|
||||||
patch(tree, multi([text("blip"), text("bar")]));
|
|
||||||
expect(fixture.innerHTML).toBe("blipbar");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("simple multi with multiple roots", async () => {
|
|
||||||
const block1 = createBlock("<div>foo</div>");
|
|
||||||
const block2 = createBlock("<span>bar</span>");
|
|
||||||
|
|
||||||
const tree = multi([block1(), block2()]);
|
|
||||||
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div>foo</div><span>bar</span>");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("multi vnode can be used as text", () => {
|
|
||||||
mount(text(multi([text("a"), text("b")]) as any), fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("ab");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("multi inside a block", async () => {
|
|
||||||
const block = createBlock("<div><block-child-0/></div>");
|
|
||||||
const tree = block([], [multi([text("foo"), text("bar")])]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div>foobar</div>");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,72 +0,0 @@
|
|||||||
import { createBlock, mount } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
const XHTML_URI = "http://www.w3.org/1999/xhtml";
|
|
||||||
const SVG_URI = "http://www.w3.org/2000/svg";
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Tests
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
describe("namespace", () => {
|
|
||||||
test("default namespace is xhtml", () => {
|
|
||||||
const block = createBlock(`<tag/>`);
|
|
||||||
const tree = block();
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<tag></tag>");
|
|
||||||
expect(fixture.firstElementChild!.namespaceURI).toBe(XHTML_URI);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("namespace can be changed with block-ns", () => {
|
|
||||||
const block = createBlock(`<tag block-ns="${SVG_URI}"/>`);
|
|
||||||
const tree = block();
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<tag></tag>");
|
|
||||||
expect(fixture.firstElementChild!.namespaceURI).toBe(SVG_URI);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("namespace is kept for children", () => {
|
|
||||||
const block = createBlock(
|
|
||||||
`<parent block-ns="${SVG_URI}"><child><subchild/></child><child/></parent>`
|
|
||||||
);
|
|
||||||
const tree = block();
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(
|
|
||||||
"<parent><child><subchild></subchild></child><child></child></parent>"
|
|
||||||
);
|
|
||||||
const parent = fixture.firstElementChild!;
|
|
||||||
const child1 = parent.firstElementChild!;
|
|
||||||
const subchild = child1.firstElementChild!;
|
|
||||||
const child2 = child1.nextElementSibling!;
|
|
||||||
expect(parent.namespaceURI).toBe(SVG_URI);
|
|
||||||
expect(child1.namespaceURI).toBe(SVG_URI);
|
|
||||||
expect(child2.namespaceURI).toBe(SVG_URI);
|
|
||||||
expect(subchild.namespaceURI).toBe(SVG_URI);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("various namespaces in same block", () => {
|
|
||||||
const block = createBlock(`<none><one block-ns="one"/><two block-ns="two"/></none>`);
|
|
||||||
const tree = block();
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<none><one></one><two></two></none>");
|
|
||||||
const none = fixture.firstElementChild!;
|
|
||||||
const one = none.firstElementChild!;
|
|
||||||
const two = one.nextElementSibling!;
|
|
||||||
expect(none.namespaceURI).toBe(XHTML_URI);
|
|
||||||
expect(one.namespaceURI).toBe("one");
|
|
||||||
expect(two.namespaceURI).toBe("two");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,84 +0,0 @@
|
|||||||
import { createBlock, mount, multi, patch } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("before remove is called", () => {
|
|
||||||
test("simple removal", async () => {
|
|
||||||
const block1 = createBlock("<div><block-child-0/></div>");
|
|
||||||
const block2 = createBlock("<p>coucou</p>");
|
|
||||||
|
|
||||||
const child = block2();
|
|
||||||
const tree = block1([], [child]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>coucou</p></div>");
|
|
||||||
|
|
||||||
let n = 1;
|
|
||||||
child.beforeRemove = () => n++;
|
|
||||||
patch(tree, block1([], []), true);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
expect(n).toBe(2);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("removal, variation with grandchild", async () => {
|
|
||||||
const block1 = createBlock("<p><block-child-0/></p>");
|
|
||||||
const block2 = createBlock("<span>coucou</span>");
|
|
||||||
|
|
||||||
const child = block2();
|
|
||||||
const tree = block1([], [block1([], [child])]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p><p><span>coucou</span></p></p>");
|
|
||||||
|
|
||||||
let n = 1;
|
|
||||||
child.beforeRemove = () => n++;
|
|
||||||
patch(tree, block1([], []), true);
|
|
||||||
expect(fixture.innerHTML).toBe("<p></p>");
|
|
||||||
expect(n).toBe(2);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("remove a child of a multi", async () => {
|
|
||||||
const block1 = createBlock("<div><block-child-0/></div>");
|
|
||||||
const block2 = createBlock("<p>coucou</p>");
|
|
||||||
|
|
||||||
const child1 = block2();
|
|
||||||
const child2 = block2();
|
|
||||||
const tree = block1([], [multi([child1, child2])]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>coucou</p><p>coucou</p></div>");
|
|
||||||
|
|
||||||
let n = 1;
|
|
||||||
child1.beforeRemove = () => n++;
|
|
||||||
patch(tree, block1([], [multi([])]), true);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
expect(n).toBe(2);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("remove a multi", async () => {
|
|
||||||
const block1 = createBlock("<div><block-child-0/></div>");
|
|
||||||
const block2 = createBlock("<p>coucou</p>");
|
|
||||||
|
|
||||||
const child1 = block2();
|
|
||||||
const child2 = block2();
|
|
||||||
const tree = block1([], [multi([child1, child2])]);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<div><p>coucou</p><p>coucou</p></div>");
|
|
||||||
|
|
||||||
let n = 1;
|
|
||||||
child1.beforeRemove = () => n++;
|
|
||||||
patch(tree, block1([], []), true);
|
|
||||||
expect(fixture.innerHTML).toBe("<div></div>");
|
|
||||||
expect(n).toBe(2);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,69 +0,0 @@
|
|||||||
import { mount, patch, remove, text } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("adding/patching text", () => {
|
|
||||||
test("simple text node", async () => {
|
|
||||||
const tree = text("foo");
|
|
||||||
expect(tree.el).toBe(undefined);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("foo");
|
|
||||||
expect(tree.el).not.toBe(undefined);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("patching a simple text node", async () => {
|
|
||||||
const tree = text("foo");
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("foo");
|
|
||||||
|
|
||||||
patch(tree, text("bar"));
|
|
||||||
expect(fixture.innerHTML).toBe("bar");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("falsy values in text nodes", () => {
|
|
||||||
const cases = [
|
|
||||||
[false, "false"],
|
|
||||||
[undefined, ""],
|
|
||||||
[null, ""],
|
|
||||||
[0, "0"],
|
|
||||||
["", ""],
|
|
||||||
];
|
|
||||||
for (let [value, result] of cases) {
|
|
||||||
const fixture = makeTestFixture();
|
|
||||||
mount(text(value as any), fixture);
|
|
||||||
expect(fixture.innerHTML).toBe(result);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
test("vtext node can be used as text", () => {
|
|
||||||
const t = text("foo") as any;
|
|
||||||
mount(text(t), fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("foo");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("remove text blocks", () => {
|
|
||||||
test("a text block can be removed", async () => {
|
|
||||||
const tree = text("cat");
|
|
||||||
expect(fixture.childNodes.length).toBe(0);
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("cat");
|
|
||||||
expect(fixture.childNodes.length).toBe(1);
|
|
||||||
remove(tree);
|
|
||||||
expect(fixture.innerHTML).toBe("");
|
|
||||||
expect(fixture.childNodes.length).toBe(0);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,114 +0,0 @@
|
|||||||
import { createBlock, mount, patch, text, toggler } from "../../src/blockdom";
|
|
||||||
import { makeTestFixture } from "./helpers";
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
// Setup and helpers
|
|
||||||
//------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
let fixture: HTMLElement;
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
fixture = makeTestFixture();
|
|
||||||
});
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
fixture.remove();
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("togglers", () => {
|
|
||||||
test("can mount and update text nodes", async () => {
|
|
||||||
const tree = toggler("key", text("foo"));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("foo");
|
|
||||||
const textnode = fixture.firstChild!;
|
|
||||||
expect(textnode.textContent).toBe("foo");
|
|
||||||
patch(tree, toggler("key", text("bar")));
|
|
||||||
expect(fixture.innerHTML).toBe("bar");
|
|
||||||
expect(fixture.firstChild).toBe(textnode);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("can toggle between two text nodes (different key)", async () => {
|
|
||||||
const tree = toggler("key1", text("foo"));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("foo");
|
|
||||||
const textnode = fixture.firstChild!;
|
|
||||||
expect(textnode.textContent).toBe("foo");
|
|
||||||
patch(tree, toggler("key2", text("bar")));
|
|
||||||
expect(fixture.innerHTML).toBe("bar");
|
|
||||||
expect(fixture.firstChild).not.toBe(textnode);
|
|
||||||
|
|
||||||
// we check here that the key was properly reset
|
|
||||||
const other = fixture.firstChild;
|
|
||||||
patch(tree, toggler("key1", text("foo")));
|
|
||||||
expect(fixture.innerHTML).toBe("foo");
|
|
||||||
expect(fixture.firstChild).not.toBe(other);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("can toggle between text node and block", async () => {
|
|
||||||
const block = createBlock("<p>hey</p>");
|
|
||||||
const tree = toggler("key1", text("foo"));
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("foo");
|
|
||||||
const textnode = fixture.firstChild!;
|
|
||||||
patch(tree, toggler("key2", block()));
|
|
||||||
expect(fixture.innerHTML).toBe("<p>hey</p>");
|
|
||||||
expect(fixture.firstChild).not.toBe(textnode);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("beforeRemove is called", () => {
|
|
||||||
const block = createBlock("<p>hey</p>");
|
|
||||||
|
|
||||||
function blockOverriden() {
|
|
||||||
const vn = block();
|
|
||||||
vn.beforeRemove = () => {
|
|
||||||
steps.push("beforeRemove");
|
|
||||||
};
|
|
||||||
return vn;
|
|
||||||
}
|
|
||||||
|
|
||||||
const steps: string[] = [];
|
|
||||||
const tree = toggler("key1", blockOverriden());
|
|
||||||
mount(tree, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p>hey</p>");
|
|
||||||
patch(tree, toggler("key2", text("foo")));
|
|
||||||
expect(fixture.innerHTML).toBe("foo");
|
|
||||||
|
|
||||||
patch(tree, toggler("key3", blockOverriden()), true);
|
|
||||||
expect(fixture.innerHTML).toBe("<p>hey</p>");
|
|
||||||
|
|
||||||
patch(tree, toggler("key2", text("foo")), true);
|
|
||||||
expect(fixture.innerHTML).toBe("foo");
|
|
||||||
|
|
||||||
expect(steps).toEqual(["beforeRemove"]);
|
|
||||||
});
|
|
||||||
|
|
||||||
test("beforeRemove is called when within a block", () => {
|
|
||||||
const block = createBlock("<p><block-child-0/></p>");
|
|
||||||
const conditionalBlock = createBlock("<p>hey</p>");
|
|
||||||
|
|
||||||
const steps: string[] = [];
|
|
||||||
|
|
||||||
function blockOverriden() {
|
|
||||||
const vn = conditionalBlock();
|
|
||||||
vn.beforeRemove = function () {
|
|
||||||
steps.push("beforeRemove");
|
|
||||||
};
|
|
||||||
return vn;
|
|
||||||
}
|
|
||||||
const mainBlock = block([], [toggler("key1", blockOverriden())]);
|
|
||||||
|
|
||||||
mount(mainBlock, fixture);
|
|
||||||
expect(fixture.innerHTML).toBe("<p><p>hey</p></p>");
|
|
||||||
|
|
||||||
patch(mainBlock, block([], []));
|
|
||||||
expect(fixture.innerHTML).toBe("<p></p>");
|
|
||||||
|
|
||||||
patch(mainBlock, block([], [toggler("key1", blockOverriden())]), true);
|
|
||||||
expect(fixture.innerHTML).toBe("<p><p>hey</p></p>");
|
|
||||||
|
|
||||||
patch(mainBlock, block([], []), true);
|
|
||||||
expect(fixture.innerHTML).toBe("<p></p>");
|
|
||||||
|
|
||||||
expect(steps).toEqual(["beforeRemove"]);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,696 +0,0 @@
|
|||||||
// Jest Snapshot v1, https://goo.gl/fbAQLP
|
|
||||||
|
|
||||||
exports[`attributes changing a class with t-att-class (preexisting class 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div class=\\"hoy\\" block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['v'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes changing a class with t-att-class 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['v'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes changing an attribute with t-att- 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"value\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['v'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes class and t-att-class should combine together 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\" class=\\"hello\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['value'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes class and t-attf-class with ternary operation 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div class=\\"hello\\" block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = (ctx['value']?'world':'');
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes dynamic attribute evaluating to 0 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"foo\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['value'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes dynamic attribute falsy variable 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"foo\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['value'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes dynamic attribute with a dash 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"data-action-id\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['id'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes dynamic attributes 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"foo\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = 'bar';
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes dynamic class attribute 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['c'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes dynamic class attribute evaluating to 0 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['value'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes dynamic empty class attribute 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['c'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes dynamic formatted attributes with a dash 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"aria-label\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = \`Some text \${ctx['id']}\`;
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes dynamic undefined class attribute 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['c'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes dynamic undefined generic attribute 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"thing\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['c'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes fixed variable 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"foo\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['value'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes format expression 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"foo\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = (ctx['value']+37);
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes format literal 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"foo\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = \`bar\`;
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes format multiple 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"foo\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = \`a \${ctx['value1']} is \${ctx['value2']} of \${ctx['value3']} ]\`;
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes format value 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"foo\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = \`b\${ctx['value']}r\`;
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes from object variables set previously 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { isBoundary, withDefault, setContextValue } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><span block-attribute-0=\\"class\\"/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
ctx = Object.create(ctx);
|
|
||||||
ctx[isBoundary] = 1
|
|
||||||
setContextValue(ctx, \\"o\\", {a:'b'});
|
|
||||||
let attr1 = ctx['o'].a;
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes from variables set previously (no external node) 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { isBoundary, withDefault, setContextValue } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<span block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
ctx = Object.create(ctx);
|
|
||||||
ctx[isBoundary] = 1
|
|
||||||
setContextValue(ctx, \\"abc\\", 'def');
|
|
||||||
let attr1 = ctx['abc'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes from variables set previously 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { isBoundary, withDefault, setContextValue } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><span block-attribute-0=\\"class\\"/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
ctx = Object.create(ctx);
|
|
||||||
ctx[isBoundary] = 1
|
|
||||||
setContextValue(ctx, \\"abc\\", 'def');
|
|
||||||
let attr1 = ctx['abc'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes object 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attributes=\\"0\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['value'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes static attributes 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div foo=\\"a\\" bar=\\"b\\" baz=\\"c\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
return block1();
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes static attributes on void elements 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<img src=\\"/test.skip.jpg\\" alt=\\"Test\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
return block1();
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes static attributes with dashes 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div aria-label=\\"Close\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
return block1();
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes t-att-class and class should combine together 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div class=\\"hello\\" block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['value'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes t-att-class with multiple classes 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = {'a b c':ctx['value']};
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes t-att-class with multiple classes 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = {['a b c']:ctx['value']};
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes t-att-class with multiple classes, some of which are duplicate 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = {'a b c':ctx['value'],'a b d':!ctx['value']};
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes t-att-class with object 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div class=\\"static\\" block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = {a:ctx['b'],c:ctx['d'],e:ctx['f']};
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes t-attf-class 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = \`hello\`;
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes t-attf-class should combine with class 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div class=\\"hello\\" block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = \`world\`;
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes t-attf-class with multiple classes 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = \`hello \${ctx['word']}\`;
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes t-attf-class with multiple classes separated by multiple spaces 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = \`hello \${ctx['word']}\`;
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes tuple literal 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attributes=\\"0\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ['foo','bar'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes tuple variable 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attributes=\\"0\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['value'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes two classes 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div class=\\"a b\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
return block1();
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes two dynamic attributes 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-attribute-0=\\"foo\\" block-attribute-1=\\"bar\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = 'bar';
|
|
||||||
let attr2 = 'foo';
|
|
||||||
return block1([attr1, attr2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes updating classes (with obj notation) 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div class=\\"hoy\\" block-attribute-0=\\"class\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = {'a b':ctx['condition']};
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes various escapes 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div foo=\\"<foo\\" block-attribute-0=\\"bar\\" block-attribute-1=\\"baz\\" block-attributes=\\"2\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['bar'];
|
|
||||||
let attr2 = \`<\${ctx['baz']}>\`;
|
|
||||||
let attr3 = ctx['qux'];
|
|
||||||
return block1([attr1, attr2, attr3]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`attributes various escapes 2 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div> < </div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
return block1();
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`special cases for some specific html attributes/properties input of type checkbox with t-att-indeterminate 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<input type=\\"checkbox\\" block-attribute-0=\\"indeterminate\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['v'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`special cases for some specific html attributes/properties input type= checkbox, with t-att-checked 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<input type=\\"checkbox\\" block-attribute-0=\\"checked\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['flag'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`special cases for some specific html attributes/properties input with t-att-value 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<input block-attribute-0=\\"value\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['v'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`special cases for some specific html attributes/properties select with t-att-value 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<select block-attribute-0=\\"value\\"><option value=\\"potato\\">Potato</option><option value=\\"tomato\\">Tomato</option><option value=\\"onion\\">Onion</option></select>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['value'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`special cases for some specific html attributes/properties textarea with t-att-value 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<textarea block-attribute-0=\\"value\\"/>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let attr1 = ctx['v'];
|
|
||||||
return block1([attr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`special cases for some specific html attributes/properties various boolean html attributes 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><input type=\\"checkbox\\" checked=\\"checked\\"/><input checked=\\"checked\\"/><div checked=\\"checked\\"/><div selected=\\"selected\\"/><option selected=\\"selected\\" other=\\"1\\"/><input readonly=\\"readonly\\"/><button disabled=\\"disabled\\"/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
return block1();
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
@@ -1,46 +0,0 @@
|
|||||||
// Jest Snapshot v1, https://goo.gl/fbAQLP
|
|
||||||
|
|
||||||
exports[`comments only a comment 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
return comment(\` comment\`);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`comments properly handle comments 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div>hello <!-- comment-->owl</div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
return block1();
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`comments properly handle comments between t-if/t-else 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/><block-child-1/></div>\`);
|
|
||||||
let block2 = createBlock(\`<span>true</span>\`);
|
|
||||||
let block3 = createBlock(\`<span>owl</span>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2,b3;
|
|
||||||
if (true) {
|
|
||||||
b2 = block2();
|
|
||||||
} else {
|
|
||||||
b3 = block3();
|
|
||||||
}
|
|
||||||
return block1([], [b2, b3]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
@@ -1,530 +0,0 @@
|
|||||||
// Jest Snapshot v1, https://goo.gl/fbAQLP
|
|
||||||
|
|
||||||
exports[`t-on can bind event handler 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['add'], ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on can bind handlers with arguments 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
const v1 = ctx['add'];
|
|
||||||
let hdlr1 = [()=>v1(5), ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on can bind handlers with empty object 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
const v1 = ctx['doSomething'];
|
|
||||||
let hdlr1 = [()=>v1({}), ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on can bind handlers with empty object (with non empty inner string) 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
const v1 = ctx['doSomething'];
|
|
||||||
let hdlr1 = [()=>v1({}), ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on can bind handlers with empty object (with non empty inner string) 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { prepareList, withKey } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<ul><block-child-0/></ul>\`);
|
|
||||||
let block3 = createBlock(\`<li><a block-handler-0=\\"click\\">link</a></li>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
ctx = Object.create(ctx);
|
|
||||||
const [k_block2, v_block2, l_block2, c_block2] = prepareList(['someval']);
|
|
||||||
for (let i1 = 0; i1 < l_block2; i1++) {
|
|
||||||
ctx[\`action\`] = v_block2[i1];
|
|
||||||
ctx[\`action_index\`] = i1;
|
|
||||||
let key1 = ctx['action_index'];
|
|
||||||
const v1 = ctx['activate'];
|
|
||||||
const v2 = ctx['action'];
|
|
||||||
let hdlr1 = [()=>v1(v2), ctx];
|
|
||||||
c_block2[i1] = withKey(block3([hdlr1]), key1);
|
|
||||||
}
|
|
||||||
let b2 = list(c_block2);
|
|
||||||
return block1([], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on can bind handlers with object arguments 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
const v1 = ctx['add'];
|
|
||||||
let hdlr1 = [()=>v1({val:5}), ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on can bind two event handlers 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\" block-handler-1=\\"dblclick\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['handleClick'], ctx];
|
|
||||||
let hdlr2 = [ctx['handleDblClick'], ctx];
|
|
||||||
return block1([hdlr1, hdlr2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on handler is bound to proper owner 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['add'], ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on handler is bound to proper owner, part 2 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { prepareList, withKey } = helpers;
|
|
||||||
|
|
||||||
let block2 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
ctx = Object.create(ctx);
|
|
||||||
const [k_block1, v_block1, l_block1, c_block1] = prepareList([1]);
|
|
||||||
for (let i1 = 0; i1 < l_block1; i1++) {
|
|
||||||
ctx[\`value\`] = v_block1[i1];
|
|
||||||
let key1 = ctx['value'];
|
|
||||||
let hdlr1 = [ctx['add'], ctx];
|
|
||||||
c_block1[i1] = withKey(block2([hdlr1]), key1);
|
|
||||||
}
|
|
||||||
return list(c_block1);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on handler is bound to proper owner, part 3 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { getTemplate } = helpers;
|
|
||||||
const callTemplate_1 = getTemplate(\`sub\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
return callTemplate_1.call(this, ctx, node, key + \`__1\`);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on handler is bound to proper owner, part 3 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['add'], ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on handler is bound to proper owner, part 4 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { prepareList, getTemplate, withKey } = helpers;
|
|
||||||
const callTemplate_1 = getTemplate(\`sub\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
ctx = Object.create(ctx);
|
|
||||||
const [k_block1, v_block1, l_block1, c_block1] = prepareList([1]);
|
|
||||||
for (let i1 = 0; i1 < l_block1; i1++) {
|
|
||||||
ctx[\`value\`] = v_block1[i1];
|
|
||||||
ctx[\`value_first\`] = i1 === 0;
|
|
||||||
ctx[\`value_last\`] = i1 === v_block1.length - 1;
|
|
||||||
ctx[\`value_index\`] = i1;
|
|
||||||
ctx[\`value_value\`] = k_block1[i1];
|
|
||||||
let key1 = ctx['value'];
|
|
||||||
c_block1[i1] = withKey(callTemplate_1.call(this, ctx, node, key + \`__1__\${key1}\`), key1);
|
|
||||||
}
|
|
||||||
return list(c_block1);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on handler is bound to proper owner, part 4 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['add'], ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on receive event in first argument 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['add'], ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (native listener) basic support for native listener 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div class=\\"myClass\\" block-handler-0=\\"click\\"><button block-handler-1=\\"click\\">Button</button></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['divClicked'], ctx];
|
|
||||||
let hdlr2 = [ctx['btnClicked'], ctx];
|
|
||||||
return block1([hdlr1, hdlr2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (native listener) t-on combined with t-esc 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><button block-handler-0=\\"click\\"><block-text-1/></button></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['onClick'], ctx];
|
|
||||||
let txt1 = ctx['text'];
|
|
||||||
return block1([hdlr1, txt1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (native listener) t-on combined with t-out 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { safeOutput } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><button block-handler-0=\\"click\\"><block-child-0/></button></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['onClick'], ctx];
|
|
||||||
let b2 = safeOutput(ctx['html']);
|
|
||||||
return block1([hdlr1], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (native listener) t-on with .capture modifier 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-handler-0=\\"click.capture\\"><button block-handler-1=\\"click\\">Button</button></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [\\"capture\\", ctx['onCapture'], ctx];
|
|
||||||
let hdlr2 = [ctx['doSomething'], ctx];
|
|
||||||
return block1([hdlr1, hdlr2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (native listener) t-on with empty handler (only modifiers) 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><button block-handler-0=\\"click.prevent\\">Button</button></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [\\"prevent\\", , ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (native listener) t-on with prevent and self modifiers (order matters) 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><button block-handler-0=\\"click.prevent.self\\"><span>Button</span></button></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [\\"prevent\\",\\"self\\", ctx['onClick'], ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (native listener) t-on with prevent and/or stop modifiers 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><button block-handler-0=\\"click.prevent\\">Button 1</button><button block-handler-1=\\"click.stop\\">Button 2</button><button block-handler-2=\\"click.prevent.stop\\">Button 3</button></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [\\"prevent\\", ctx['onClickPrevented'], ctx];
|
|
||||||
let hdlr2 = [\\"stop\\", ctx['onClickStopped'], ctx];
|
|
||||||
let hdlr3 = [\\"prevent\\",\\"stop\\", ctx['onClickPreventedAndStopped'], ctx];
|
|
||||||
return block1([hdlr1, hdlr2, hdlr3]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (native listener) t-on with prevent modifier in t-foreach 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { prepareList, withKey } = helpers;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/></div>\`);
|
|
||||||
let block3 = createBlock(\`<a href=\\"#\\" block-handler-0=\\"click.prevent\\"> Edit <block-text-1/></a>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
ctx = Object.create(ctx);
|
|
||||||
const [k_block2, v_block2, l_block2, c_block2] = prepareList(ctx['projects']);
|
|
||||||
for (let i1 = 0; i1 < l_block2; i1++) {
|
|
||||||
ctx[\`project\`] = v_block2[i1];
|
|
||||||
let key1 = ctx['project'];
|
|
||||||
const v1 = ctx['onEdit'];
|
|
||||||
const v2 = ctx['project'];
|
|
||||||
let hdlr1 = [\\"prevent\\", ev=>v1(v2.id,ev), ctx];
|
|
||||||
let txt1 = ctx['project'].name;
|
|
||||||
c_block2[i1] = withKey(block3([hdlr1, txt1]), key1);
|
|
||||||
}
|
|
||||||
let b2 = list(c_block2);
|
|
||||||
return block1([], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (native listener) t-on with self and prevent modifiers (order matters) 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><button block-handler-0=\\"click.self.prevent\\"><span>Button</span></button></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [\\"self\\",\\"prevent\\", ctx['onClick'], ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (native listener) t-on with self modifier 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><button block-handler-0=\\"click\\"><span>Button</span></button><button block-handler-1=\\"click.self\\"><span>Button</span></button></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['onClick'], ctx];
|
|
||||||
let hdlr2 = [\\"self\\", ctx['onClickSelf'], ctx];
|
|
||||||
return block1([hdlr1, hdlr2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on modifiers (synthetic listener) basic support for synthetic 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div block-handler-0=\\"click.synthetic\\"><button block-handler-1=\\"click.synthetic\\">Button</button></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [\\"synthetic\\", ctx['divClicked'], ctx];
|
|
||||||
let hdlr2 = [\\"synthetic\\", ctx['btnClicked'], ctx];
|
|
||||||
return block1([hdlr1, hdlr2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on with inline statement (function call) 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
const v1 = ctx['state'];
|
|
||||||
let hdlr1 = [()=>v1.incrementCounter(2), ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on with inline statement 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Click</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
const v1 = ctx['state'];
|
|
||||||
let hdlr1 = [()=>v1.counter++, ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on with inline statement, part 2 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Toggle</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
const v1 = ctx['state'];
|
|
||||||
let hdlr1 = [()=>v1.flag=!v1.flag, ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on with inline statement, part 3 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<button block-handler-0=\\"click\\">Toggle</button>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
const v1 = ctx['state'];
|
|
||||||
const v2 = ctx['someFunction'];
|
|
||||||
let hdlr1 = [()=>v1.n=v2(3), ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on with t-call 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { getTemplate } = helpers;
|
|
||||||
const callTemplate_1 = getTemplate(\`sub\`);
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2 = callTemplate_1.call(this, ctx, node, key + \`__1\`);
|
|
||||||
return block1([], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on with t-call 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<p block-handler-0=\\"click\\">lucas</p>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let hdlr1 = [ctx['update'], ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on, with arguments and t-call 1`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
let { getTemplate } = helpers;
|
|
||||||
const callTemplate_1 = getTemplate(\`sub\`);
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<div><block-child-0/></div>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
let b2 = callTemplate_1.call(this, ctx, node, key + \`__1\`);
|
|
||||||
return block1([], [b2]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
|
|
||||||
exports[`t-on t-on, with arguments and t-call 2`] = `
|
|
||||||
"function anonymous(bdom, helpers
|
|
||||||
) {
|
|
||||||
let { text, createBlock, list, multi, html, toggler, component, comment } = bdom;
|
|
||||||
|
|
||||||
let block1 = createBlock(\`<p block-handler-0=\\"click\\">lucas</p>\`);
|
|
||||||
|
|
||||||
return function template(ctx, node, key = \\"\\") {
|
|
||||||
const v1 = ctx['value'];
|
|
||||||
let hdlr1 = [()=>this.update(v1), ctx];
|
|
||||||
return block1([hdlr1]);
|
|
||||||
}
|
|
||||||
}"
|
|
||||||
`;
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user