Files
marqdo/examples/browser-app/app.mq.md
T
cflmyandCursor 687c168014 feat(parse): use nested YAML import: maps instead of one-liner binds
Frontmatter imports are now valid YAML (`import:` / `导入:` with bind→target
entries), removing spaced keys. Add `marqdo migrate imports`, hard-error the
old one-liner form, and migrate lib/ext/examples/tests/docs accordingly.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-23 19:33:58 +08:00

286 lines
6.4 KiB
Markdown

---
markup: occlusion
title: browser-app (route E+)
description: list CRUD, storage, navigate, interval, fetch_all, ws — GFM + lib/browser
import:
browser: lib/browser.mq.md
table: lib/table.mq.md
text: lib/text.mq.md
---
# main
**`ticks` = 0**
**`bag` = ""**
**`path` = "/"**
**`ws_id` = "echo"**
`wire` =
| @ | 选择器 | 事件 | 调用 | 委托 | 值选择器 |
|---|--------|------|------|------|----------|
| 1 | "#add" | click | add | | "#draft" |
| 2 | "#save" | click | save_draft | | "#draft" |
| 3 | "#load" | click | load_draft | | |
| 4 | "#start-tick" | click | start_tick | | |
| 5 | "#stop-tick" | click | stop_tick | | |
| 6 | "#nav-home" | click | go_home | | |
| 7 | "#nav-about" | click | go_about | | |
| 8 | "#nav-net" | click | go_net | | |
| 9 | "window" | popstate | on_pop | | |
| 10 | "#items" | click | on_item | "button[data-id]" | |
| 11 | "#fetch-all" | click | do_fetch_all | | |
| 12 | "#ws-open" | click | ws_open | | |
| 13 | "#ws-send" | click | ws_send | | "#ws-msg" |
| 14 | "#ws-close" | click | ws_close | | |
| 15 | "#copy-log" | click | copy_log | | |
| 16 | "#dl-list" | click | dl_list | | |
`nav` =
| url | replace |
|-----|---------|
| / | False |
`st` =
| op | key | then |
|----|-----|------|
| get | mq-draft | on_draft |
`boot` =
| wire | navigate | storage |
|------|----------|---------|
| `wire` | `nav` | `st` |
*boot*
## add
+ `value`=""
1. `value` != ""
1. `bag` == ""
**`bag` = value**
2. *
**`bag` = bag + "\n" + value**
**`parts` = > text.str_split s=bag sep="\n"**
**`html` = ""**
- [item](遍历 parts 为 item)
1. `item` != ""
**`html` = html + "<li><span>" + item + "</span> <button type=\"button\" data-id=\"" + item + "\">删</button></li>"**
**`ret` = > browser.set_html sel="#items" html=html**
**`clr` = > browser.set_value sel="#draft" value=""**
**`ret` = > browser.merge a=ret b=clr**
**`f` = > browser.focus sel="#draft"**
*> browser.merge a=ret b=f*
2. *
****
## on_item
+ `data_id`=""
1. `data_id` != ""
**`parts` = > text.str_split s=bag sep="\n"**
**`next` = ""**
- [item](遍历 parts 为 item)
1. `item` != ""
1. `item` != `data_id`
1. `next` == ""
**`next` = item**
2. *
**`next` = next + "\n" + item**
**`bag` = next**
**`parts2` = > text.str_split s=bag sep="\n"**
**`html` = ""**
- [item](遍历 parts2 为 item)
1. `item` != ""
**`html` = html + "<li><span>" + item + "</span> <button type=\"button\" data-id=\"" + item + "\">删</button></li>"**
**`ret` = > browser.set_html sel="#items" html=html**
**`msg` = "removed " + data_id**
**`t` = > browser.set_text sel="#log" text=msg**
*> browser.merge a=ret b=t*
2. *
****
## save_draft
+ `value`=""
`st` =
| op | key | value |
|----|-----|-------|
| set | mq-draft | `value` |
**`msg` = > browser.set_text sel="#log" text="draft saved"**
**`s` = > browser.storage spec=st**
*> browser.merge a=msg b=s*
## load_draft
`st` =
| op | key | then |
|----|-----|------|
| get | mq-draft | on_draft |
*> browser.storage spec=st*
## on_draft
+ `ok`=True
+ `value`=""
+ `found`=False
1. `found`
**`ret` = > browser.set_value sel="#draft" value=value**
**`msg` = > browser.set_text sel="#log" text="draft loaded"**
*> browser.merge a=ret b=msg*
2. *
*> browser.set_text sel="#log" text="no draft"*
## start_tick
*> browser.interval ms=1000 then="on_tick" id="tick"*
## stop_tick
*> browser.clear_interval id="tick"*
## on_tick
+ `ok`=True
+ `id`=""
**`ticks` = ticks + 1**
**`label` = > str ticks**
*> browser.set_text sel="#tick" text=label*
## go_home
**`path` = "/"**
*> show_path*
## go_about
**`path` = "/about"**
*> show_path*
## go_net
**`path` = "/net"**
*> show_path*
## on_pop
+ `path`=""
**`path` = path**
*> show_path*
## show_path
**`hide` = > table.put in=None at="hidden" value=""**
**`show` = > table.put in=None at="hidden" value=False**
1. `path` == "/about"
`attrs` =
| #panel-about | #panel-home | #panel-net |
|--------------|-------------|------------|
| `show` | `hide` | `hide` |
2. *
1. `path` == "/net"
`attrs` =
| #panel-net | #panel-home | #panel-about |
|------------|-------------|--------------|
| `show` | `hide` | `hide` |
2. *
`attrs` =
| #panel-home | #panel-about | #panel-net |
|-------------|--------------|------------|
| `show` | `hide` | `hide` |
**`label` = "path: " + path**
**`ret` = > browser.set_text sel="#path" text=label**
**`a` = > browser.wrap key="set_attr" value=attrs**
**`ret` = > browser.merge a=ret b=a**
**`nav` = > browser.navigate url=path**
*> browser.merge a=ret b=nav*
## do_fetch_all
`reqs` =
| @ | url |
|---|-----|
| 1 | "https://httpbin.org/uuid" |
| 2 | "https://httpbin.org/uuid" |
**`msg` = > browser.set_text sel="#net-out" text="fetch_all…"**
**`fa` = > browser.fetch_all requests=reqs then="on_fetch_all"**
*> browser.merge a=msg b=fa*
## on_fetch_all
+ `ok`=True
+ `results`=None
*> browser.set_text sel="#net-out" text="fetch_all done (see console / results in session)"*
## ws_open
`w` =
| op | id | url | then_open | then_message | then_error | then_close |
|----|----|-----|-----------|--------------|------------|------------|
| open | `ws_id` | "wss://echo.websocket.events" | on_ws_open | on_ws_msg | on_ws_err | on_ws_close |
*> browser.ws spec=w*
## on_ws_open
+ `ok`=True
+ `id`=""
*> browser.set_text sel="#net-out" text="ws open"*
## on_ws_msg
+ `ok`=True
+ `data`=""
**`msg` = "ws ← " + data**
*> browser.set_text sel="#net-out" text=msg*
## on_ws_err
+ `ok`=False
+ `error`=""
**`msg` = "ws error: " + error**
*> browser.set_text sel="#net-out" text=msg*
## on_ws_close
+ `ok`=True
*> browser.set_text sel="#net-out" text="ws closed"*
## ws_send
+ `value`=""
`w` =
| op | id | data |
|----|----|------|
| send | `ws_id` | `value` |
*> browser.ws spec=w*
## ws_close
`w` =
| op | id |
|----|----|
| close | `ws_id` |
*> browser.ws spec=w*
## copy_log
**`msg` = > browser.set_text sel="#log" text="copied bag to clipboard"**
**`c` = > browser.clipboard text=bag**
*> browser.merge a=msg b=c*
## dl_list
**`msg` = > browser.set_text sel="#log" text="download started"**
**`d` = > browser.download body=bag filename="items.txt"**
*> browser.merge a=msg b=d*