此范例展示了如何实现跨浏览器的即时更新。
状态在所有连接中是全局共享的,逻辑由服务器维护。
此外,文件标题是动态生成并即时更新的。
thermostat.tsx
import { Link } from '../components/router.js'
import { Style } from '../components/style.js'
import { o } from '../jsx/jsx.js'
import { sessions } from '../session.js'
import { Update, UpdateIn } from '../components/update.js'
import type { ServerMessage } from '../../../client/types'
import SourceCode from '../components/source-code.js'
import { Routes, StaticPageRoute } from '../routes.js'
import type { Node } from '../jsx/types'
import { apiEndpointTitle, title } from '../../config.js'
import { Locale } from '../components/locale.js'
import { Context } from '../context.js'
const UpdateInterval = 1000
type Status = 'cooling' | 'heating' | 'idle'
const StatusStyles: Record<Status, string> = {
heating: `
background: #f83;
background: linear-gradient(180deg, #f83 0%, #f54 100%);
color: white;
`.replace(/\n/g, ' '),
cooling: `
background: #6ae;
background: linear-gradient(180deg, #6ae 0%, #17d 100%);
color: white;
`.replace(/\n/g, ' '),
idle: `
background: #eef;
background: radial-gradient(#fff 0%, #eef 100%);
color: black;
`.replace(/\n/g, ' '),
}
class State {
private _current = 27
private _target = 25.5
private _status: Status = 'idle'
private tick = () => {
if (this.current === this.target) {
this.status = 'idle'
this.timer = null
return
}
if (this.current > this.target) {
this.status = 'cooling'
this.current -= 0.5
} else if (this.current < this.target) {
this.status = 'heating'
this.current += 0.5
}
this.timer = setTimeout(this.tick, UpdateInterval)
}
private timer: NodeJS.Timeout | null = setTimeout(this.tick)
get status() {
return this._status
}
set status(value: Status) {
if (this._status === value) return
this._status = value
let messages: ServerMessage[] = [
['update-in', '#thermostat #status', value, this.title],
[
'update-attrs',
'#thermostat .outer.circle',
{
style: StatusStyles[value],
},
],
]
update(['batch', messages])
}
get target() {
return this._target
}
set target(value: number) {
if (this._target === value) return
this._target = value
update(['update-in', '#thermostat #target', value.toFixed(1), this.title])
if (!this.timer) {
this.timer = setTimeout(this.tick)
}
}
get current() {
return this._current
}
set current(value: number) {
if (this._current === value) return
this._current = value
update(['update-in', '#thermostat #current', value.toFixed(1), this.title])
}
get targetText() {
return this.target.toFixed(1) + '°'
}
get currentText() {
return this.current.toFixed(1) + '°'
}
get title() {
return title(`C: ${this.currentText} | T: ${this.targetText} | Thermostat`)
}
}
const state = new State()
function inc() {
state.target += 0.5
return (
<UpdateIn
to="/thermostat"
selector="#thermostat #target"
content={state.target.toFixed(1)}
title={state.title}
/>
)
}
function dec() {
state.target -= 0.5
return (
<UpdateIn
to="/thermostat"
selector="#thermostat #target"
content={state.target.toFixed(1)}
title={state.title}
/>
)
}
function update(message: ServerMessage) {
sessions.forEach(session => {
if (session.url === '/thermostat') {
session.ws.send(message)
}
})
return <Update to="/thermostat" message={message} />
}
/* the root node is statically built at boot-time (doesn't need to be reconstructed at request-time) */
let Thermostat: Node = (
<div id="thermostat">
{Style(/* css */ `
#thermostat button {
margin: 0.25em;
font-size: larger;
}
#thermostat [data-live=redirect] {
display: block;
}
#thermostat .title {
width: min(72vw,72vh);
text-align: center;
}
#thermostat .circle.outer {
--size: min(72vw,72vh);
background-color: #eef;
display: flex;
flex-direction: column;
justify-content: center;
}
#thermostat .circle.outer > div {
display: flex;
flex-direction: row;
justify-content: center;
}
#thermostat .circle.outer > .text-container {
font-size: 1.25em;
padding: min(3vw,3vh);
}
#thermostat .circle.middle {
--size: min(48vw,48vh);
display: flex;
flex-direction: row;
justify-content: center;
background-color: #eee;
color: black;
}
#thermostat .circle.middle > div {
display: flex;
flex-direction: column;
justify-content: center;
}
#thermostat .circle.middle button {
border: none;
width: min(12vw,12vh);
height: min(12vw,12vh);
margin: 0;
background-color: transparent;
font-size: 2em;
cursor: pointer;
}
#thermostat .circle.middle button:hover {
outline: 1px solid gray;
}
#thermostat .circle.inner {
--size: min(24vw,24vh);
background-color: white;
display: flex;
flex-direction: column;
text-align: center;
justify-content: center;
font-size: 1.6em;
}
#thermostat .circle {
border-radius: 100%;
border: 1px solid black;
width: var(--size);
height: var(--size);
}
`)}
<h1>
<Locale en="Thermostat Demo" zh_hk="恆溫器示範" zh_cn="恒温器演示" />
</h1>
<p>
<Locale
en="This demo illustrates how to do cross-browser realtime update."
zh_hk="此範例展示了如何實現跨瀏覽器的即時更新。"
zh_cn="此范例展示了如何实现跨浏览器的即时更新。"
/>
</p>
<p>
<Locale
en="The state is globally shared (for all connections) and the logic is maintained on the server."
zh_hk="狀態在所有連線中是全域共享的,邏輯由伺服器維護。"
zh_cn="状态在所有连接中是全局共享的,逻辑由服务器维护。"
/>
</p>
<p>
<Locale
en="In addition, the document title is dynamically generated and updated in realtime."
zh_hk="此外,文件標題是動態生成並即時更新的。"
zh_cn="此外,文件标题是动态生成并即时更新的。"
/>
</p>
<h2 class="title">
<Locale en="Interactive UIs" zh_hk="互動式介面" zh_cn="互动界面" />
</h2>
<div class="outer circle" style={StatusStyles[state.status]}>
<div class="text-container">
<Locale en="Target:" zh_hk="目標溫度:" zh_cn="目标温度:" />
<span
title={
<Locale
en="Target temperature in celsius degree"
zh_hk="攝氏目標溫度"
zh_cn="摄氏目标温度"
/>
}
>
<span id="target">
{
/* this fraction is wrapped in an inline functional component to evaluate the state at request-time */
[() => state.target.toFixed(1)]
}
</span>
°
</span>
</div>
<div>
<div class="middle circle">
<div>
<Link
href="/thermostat/dec"
no-history
title={
<Locale
en="Reduce target temperature by 0.5 celsius degree"
zh_hk="降低目標溫度0.5攝氏度"
zh_cn="降低目标温度0.5摄氏度"
/>
}
>
<button>-</button>
</Link>
</div>
<div>
<div class="inner circle">
<span
title={
<Locale
en="Current temperature in celsius degree"
zh_hk="當前攝氏溫度"
zh_cn="当前摄氏温度"
/>
}
>
<span id="current">{[() => state.current.toFixed(1)]}</span>
°
</span>
</div>
</div>
<div>
<Link
href="/thermostat/inc"
no-history
title={
<Locale
en="Increase target temperature by 0.5 celsius degree"
zh_hk="增加目標溫度0.5攝氏度"
zh_cn="增加目标温度0.5摄氏度"
/>
}
>
<button>+</button>
</Link>
</div>
</div>
</div>
<div class="text-container">
<span
id="status"
title={
<Locale en="Current status" zh_hk="當前狀態" zh_cn="当前状态" />
}
>
{[() => state.status]}
</span>
</div>
</div>
<SourceCode page="thermostat.tsx" />
<p>
<a href="https://dockyard.com/blog/2018/12/12/phoenix-liveview-interactive-real-time-apps-no-need-to-write-javascript">
<Locale en="Layout reference" zh_hk="介面參考" zh_cn="介面參考" />
</a>
</p>
</div>
)
function index(context: Context): StaticPageRoute {
return {
title: (
<Locale en="Thermostat Demo" zh_hk="恆溫器示範" zh_cn="恒温器演示" />
),
description: (
<Locale
en={`A real-time updated thermostat demo application. Current temperature: ${state.currentText}; target temperature: ${state.targetText}.`}
zh_hk={`一個即時更新的溫控器範例應用程式。當前溫度:${state.currentText};目標溫度:${state.targetText}。`}
zh_cn={`一个即时更新的温控器范例应用程序。当前温度:${state.currentText};目标温度:${state.targetText}。`}
/>
),
node: Thermostat,
}
}
let routes = {
'/thermostat': {
menuText: (
<Locale en="Thermostat Demo" zh_hk="恆溫器示範" zh_cn="恒温器演示" />
),
resolve: index,
},
'/thermostat/inc': {
title: apiEndpointTitle,
description: 'increase target temperature of the demo thermostat',
node: [inc],
streaming: false,
},
'/thermostat/dec': {
title: apiEndpointTitle,
description: 'decrease target temperature of the demo thermostat',
node: [dec],
streaming: false,
},
} satisfies Routes
export default { routes }