varam
v1.1.0
Published
change CSS var via URL param
Downloads
15
Maintainers
Readme
varam
change CSS var via URL param
mention desired param
place data-varam
on any scope to represent CSS var
<samp data-varam="oil ink">
- only scoped mentions will change
- scope page via root
<html data-varam="oil ink">
- combine data with URL params to update matching
var
- combining
?oil=olive&ink=black
would style eachvar
--oil: olive;
--ink: black;
var your style
background: var(--oil);
color: var(--ink);
code sensible default style
font-size: var(--size, 1em);
writing-mode: var(--mode, horizontal-tb);
code hyperlinks with &
?oil=orange&ink=black
javascript
automagic
🚥 varam
automagically runs when you load varam.js
<script async src="varam.js"></script>
- URL params are read and only read
- CSS var are updated where matching
- async or defer to your desire
updating
- performant updating
- we minimize reflow
- just load the script to go with the flow with real URL
- updaters return boolean whether reflow expected
- update if you change dom (otherwise no need)
updaters
varam.flow()
automagic doesvaram(location.search)
with real URLvaram.reset()
to reset state likevaram("")
but leave URL alonevaram.fresh(...)
is how varam performantly interacts with style
boolean
true
when update was madefalse
when update needless
help
varam.help()
for help in your console
diagnostic
varam.meta
content interpretedvaram.state
latest statevaram.via
paramethod"flow"
or"meta"
staging
- default checks
location.search
not meta - staging meta simulates alternate search
- omit meta unless you're staging
<meta name="varam" content="oil=purple">