3.8 KiB
markup, title, description, import
| markup | title | description | import | ||||
|---|---|---|---|---|---|---|---|
| occlusion | ext/web/client | Browser Runtime helpers (WASM bridge). Prefer lib/browser for effect tables (ADR 0007). |
|
Browser helpers describe the official Marqdo WASM bridge and small effects. They construct text/maps without a native server. Keep initial page layout in layout components, and use lib/browser for client logic.
marqdo call ext/web/client/index.mq.md embed --json
marqdo call ext/web/client/index.mq.md text_patch 'sel="#status"' 'text="Ready"' --json
The bridge and WASM assets must actually be hosted at the chosen URLs. embed returns a loading descriptor; it does not install assets or implement business JavaScript. Native HTML snippets here are runtime integration, not an invitation to put complete navigation/footer markup in authored content. Changes require browser bridge tests and matching Chinese entry points.
embed
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| bridge | text | "/static/marqdo-bridge.js" | bridge script URL |
| wasm | text | "/static/marqdo_wasm.wasm" | wasm URL |
| source | text | "" | optional source URL |
| boot | bool | True | auto boot |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | HTML script tag |
Use bridge="/static/marqdo-bridge.js", wasm="/static/marqdo_wasm.wasm", source="", boot=True as the inputs for this operation.
HTML snippet that loads the official browser Marqdo bridge (route C/D). Defaults:
bridge="/static/marqdo-bridge.js", wasm="/static/marqdo_wasm.wasm",
source="", boot=True . With boot and non-empty source, auto-mounts. No author
JS. Not a substitute for file-partitioned Document layout.
bootsource!= "" Return "<script type="module" src="" + bridge + "" data-mq-wasm="" + wasm + "" data-mq-source-url="" + source + ""></script>".-
-
text_patch
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| sel | text | required | CSS selector |
| text | text | required | text content |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | effects map |
Use sel, text as the inputs for this operation.
Build a set_text effects map for selector sel with string text. Prefer
lib/browser in client .mq.md programs; this helper is for call-side sketches.
We retain m = [Return the updated structured value](table.put(in=None, at=sel, value=text)).
Return [Set the set_text field in the new record](table.put(in=None, at="set_text", value=m)).
dom_patch
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| sel | text | required | CSS selector |
| html | text | "" | optional HTML |
| attrs | any | None | optional attrs map |
| remove | bool | False | remove node |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | effects map |
Use sel, html="", attrs=None, remove=False as the inputs for this operation.
Build a dom effects map for selector sel. Optional html="", attrs=None,
remove=False . Prefer View/Markdown over raw html patches for page shells.
We retain spec = [Set the html field in the new record](table.put(in=None, at="html", value=html)).
attrsWe retainspec= [Set the attrs field in the new record](table.put(in=spec, at="attrs", value=attrs)).-
_ = 1
removeWe retainspec= [Set the remove field in the new record](table.put(in=spec, at="remove", value=True)).-
_ = 1
We retain m = [Return the updated structured value](table.put(in=None, at=sel, value=spec)).
Return [Set the dom field in the new record](table.put(in=None, at="dom", value=m)).