ov-horizon
src/ov-horizon.js
A STILL OF demo/horizon.html
Attributes
| attribute | |
|---|---|
check | |
max-age | |
source |
Properties
| property | type | kind | accepts | staleness |
|---|---|---|---|---|
air | Structured | structured | not on the reading protocol | not applicable |
Events
None.
Using it
import 'overscan'
import 'overscan/overscan.css'
<ov-horizon
source="doc-air"
max-age="2"
>
</ov-horizon>
<script type="module">
import '../src/ov-source.js';
/* One reading, held: level-ish flight in a gentle left bank. No clock
and no randomness in it, so the reference shows the same display
every time it opens. */
window.Overscan.source('doc-air', () => ({ pitch: 5, roll: -15, speed: 250,
altitude: 9000, vs: 800, age: 0.1, cross: { pitch: 5, roll: -15 } }), { hz: 4 });
</script>import { OvHorizon } from 'overscan/react'
<OvHorizon
source="doc-air"
max-age="2"
air={data}
/>import { OvHorizon } from 'overscan/vue'
<OvHorizon
source="doc-air"
max-age="2"
:air="data"
/>import OvHorizon from 'overscan/svelte/OvHorizon.svelte'
<OvHorizon
source="doc-air"
max-age="2"
air={data}
/>The CSS is a separate import in every framework. A single element can be imported on its own instead of the whole kit: import 'overscan/src/ov-chart.js'
A reading is set as a PROPERTY, never an attribute. An attribute is a string, so an array cannot survive one and a null arrives as the word "null", which the protocol would read as a value rather than a dropout.
Every ov: event is bound with addEventListener. The colon has no declarative spelling in Svelte 5, where the on: directive is gone and "onov:commit" is not an identifier, nor in JSX. Vue can bind it.
The wrapper applies attributes ITSELF and hands the framework nothing but a ref. All three frameworks set a prop as a property when the name exists on the element, and this kit has 72 getter-only properties across 39 elements. Assigning one throws, and in React it does not degrade: the whole tree fails to render. 13 elements have a getter-only name that is also a real attribute (at, bearing, digits, duration, floor, fov, fresh, hold, lat, lon, period, pitch, range, ring, rings, span, step, sweep, sweeps, traces, value), which are the ones a reader would naturally pass in markup.