Files
marqdo/examples/web-net-site/public/client.mq.md

7.7 KiB

markup, title, import
markup title import
occlusion Network-site echo client
browser table text
lib/browser.mq.md lib/table.mq.md lib/text.mq.md

The client owns connection state and a plain text message log. Native controls are declared by components/live.mq.md. The relative socket path follows the page's actual host and port, while the server resource owns echo behavior.

main

返回 类型 说明
result map Native event wiring, socket opening and initial status effects

The button click carries the current input value to send. A connection opening enables the button; closure or error disables it. Incoming text appends to retained entry state and never becomes HTML. This is a live echo demonstration, not durable storage or an automatic reconnection loop. BrowserSession keeps entry bindings for callbacks, so they are state rather than fictitious public parameters.

We ws_id = "live" and messages = "" before describing the transport.

wire =

@ 选择器 事件 调用 值选择器
1 "#live-send" click send "#live-msg"
2 "#live-msg" keydown on_key "#live-msg"

open =

op id url then_open then_message then_error then_close
open ws_id /live on_open on_message on_error on_close

We bindings = [Bind the existing send control](table.put(in=None, at="wire", value=wire)) and socket = Describe the same-origin WebSocket connection. Return [Keep transport and native control wiring together](browser.merge(a=bindings, b=socket)).

_status

参数 类型 默认 说明
text text required Plain connection status to display
disabled bool required Actual native disabled state for the send button
返回 类型 说明
result map Combined status-text and button-attribute effects

Use text and disabled to keep connection feedback consistent with the send control. The attribute must remain a boolean: the bridge removes disabled when False, while the string "false" would still be a present HTML boolean attribute. These effects describe a DOM update and do not send or retry a message.

We attributes = [Keep the actual boolean attribute value](table.put(in=None, at="disabled", value=disabled)) and status = [Describe plain connection feedback](browser.set_text(sel="#live-status", text=text)) and button = [Describe actual send availability](browser.set_attr(sel="#live-send", attrs=attributes)). Return [Keep the independent effect kinds together](browser.merge(a=status, b=button)).

on_open

参数 类型 默认 说明
ok bool True Actual browser transport opening result
返回 类型 说明
result map Connected feedback and enabled send, or failed feedback and disabled send

Use ok=True from the opening callback. A successful opening proves only the transport is ready; an echoed message is observed separately. Failed opening keeps send disabled and visible as failure. The client does not publish a fake initial echo or silently retry.

  1. ok Return [Enable sending only after transport opens](_status(text="connected", disabled=False)). Return [Keep failed opening visible](_status(text="connection failed", disabled=True)).

_send

参数 类型 默认 说明
value text required Input text supplied by a click or Enter callback
channel text required Existing socket id retained by the client entry
返回 类型 说明
result any One actual send instruction, or None for empty trimmed input

Use value and channel to share the original widget's send policy. Trim surrounding whitespace and ignore an empty result. A nonempty message remains plain text, never a command or HTML. The official bridge reports transport errors separately. This helper receives its channel explicitly rather than assuming an ordinary nested call automatically captures entry state.

We payload = Keep the original trim-before-send behavior.

  1. payload == "" Return None because an empty or whitespace-only input performs no send.

operation =

op id data
send channel payload

Return Send one nonempty message through the existing connection.

send

参数 类型 默认 说明
value text "" Current text supplied by the send-button wiring
返回 类型 说明
result any Send effect for nonempty trimmed input, otherwise None

Use value="" from a button click. The direct browser callback can read retained entry state and passes that socket id explicitly to the pure send helper. The log updates only after an actual echo arrives, so clicking cannot fabricate successful delivery. Whitespace-only input retains the original widget's no-send behavior.

Return [Apply the shared send policy to this click](_send(value=value, channel=ws_id)).

on_key

参数 类型 默认 说明
key text "" Actual key name supplied by the official bridge
value text "" Current message input supplied by this control's value selector
返回 类型 说明
result any Enter uses the same send policy as the button; other keys return None

Use key="" and value="" from the keyboard wiring. Preserve the original Enter shortcut without sending on every keydown. Enter and click share trimming and empty-input behavior, and neither appends a local echo before a real frame arrives. This callback does not install another DOM handler or start a second socket.

  1. key == "Enter" Return [Apply exactly the button's send policy](_send(value=value, channel=ws_id)). Return None for an ordinary editing key.

on_message

参数 类型 默认 说明
data text "" Actual echoed text frame from the server
返回 类型 说明
result map Plain text update containing the retained echo log

Use data="" from the message callback. Append each real frame and a newline to entry state, preserving earlier messages as the old widget did. set_text escapes content through the bridge; a message containing markup is shown literally. Reloading starts a fresh demonstration log and no durable history is claimed.

We messages = [Retain the next observed echo](messages + "echo: " + data + "\n"). Return [Display the complete observed log as text](browser.set_text(sel="#live-out", text=messages)).

on_error

参数 类型 默认 说明
error text "" Browser transport error description
返回 类型 说明
result map Error feedback and disabled sending

Use error="" to retain the actual transport failure beside the controls. No previous message is erased and no new send is attempted. The page can be reloaded for a fresh connection; this demonstration has no hidden reconnect policy.

We message = "error: " + error. Return [Keep failure and send availability consistent](_status(text=message, disabled=True)).

on_close

返回 类型 说明
result map Closed feedback with disabled send control

A close notification keeps the message log readable while marking the socket unavailable. It neither clears entry state nor silently creates another connection. Subsequent sends require a newly opened page session rather than a fabricated successful transport.

Return [Keep closure visible](_status(text="closed", disabled=True)).