Files
marqdo/ext/web/client/index.mq.md
T

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).
cap table
ext/web/_capability/index.mq.md lib/table.mq.md

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.

  1. boot
    1. source != "" Return "<script type="module" src="" + bridge + "" data-mq-wasm="" + wasm + "" data-mq-source-url="" + source + ""></script>".
      Return "<script type="module" src="" + bridge + ""></script>".
    Return "<script type="module" src="" + bridge + "" data-mq-no-boot="1"></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)).

  1. attrs We retain spec = [Set the attrs field in the new record](table.put(in=spec, at="attrs", value=attrs)).

_ = 1

  1. remove We retain spec = [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)).