Files
marqdo/ext/web/web.mq.md
T
cflmyandCursor ee019fb1c2 Add ext/web forms (design §5.5): fields, validate, submit, GET|POST /_form.
Also fix static links (URLs with dots) being misread as db fields.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-11 17:55:29 +08:00

3.5 KiB


title: ext/web/web description: Official web site classes (English). Tables + methods; no bag glue.

lib/plugin.mq.md lib/sys.mq.md lib/json.mq.md


ensure_plugin

Load the ABI v2 web plugin once.

*p = > plugin.native_path name=web *

  1. p

plugin.load path=p

print text=ext/web: native web plugin not found (build marqdo_plugin_web or marqdo ext add web) sys.exit code=1


page

+ `title`="Marqdo Web"
+ `intro`=""

ensure_plugin > web_page_new title=title intro=intro

compose_components

+ `components`

Assemble nav / sidebar / footer from a page table (|组件|样式| or |src|style|).

> web_compose_components page=self components=components

compose_main

+ `main`

Assemble main from a bind table (|属性|值|样式| or |front|back|css|).

> web_compose_main page=self main=main

render

+ `db`=None

Offline HTML for tests / previews.

  1. db *url = > json.get value=db key=url * > web_render page=self url=url

> web_render page=self

style

+ `name`=""

Style tables live as ## exports in site style modules; compose resolves them by path.

self

process

+ `style`=None
+ `name`=None
+ `path`=None

self

db

+ `url`="sqlite:site.db"

ensure_plugin > web_db_new url=url

init

+ `name`
+ `fields`

*url = > json.get value=self key=url * > web_db_init url=url name=name fields=fields

insert

+ `table`
+ `rows`

*url = > json.get value=self key=url * > web_db_insert url=url table=table rows=rows

select

+ `table`
+ `where`=None
+ `limit`=200

*url = > json.get value=self key=url * *r = > web_db_select url=url table=table limit=limit * > json.get value=r key=rows

get

+ `table`
+ `id`

*url = > json.get value=self key=url * > web_db_get url=url table=table id=id

update

+ `table`
+ `id`
+ `row`

*url = > json.get value=self key=url * > web_db_update url=url table=table id=id row=row

delete

+ `table`
+ `id`

*url = > json.get value=self key=url * > web_db_delete url=url table=table id=id

exec

+ `sql`
+ `args`=None

*url = > json.get value=self key=url * > web_db_exec url=url sql=sql args=args

form

+ `table`=None
+ `action`=insert
+ `id`=None

Field table + rules table; submit writes through # db.

ensure_plugin > web_form_new table=table action=action id=id

fields

+ `fields`

> web_form_fields form=self fields=fields

rules

+ `rules`

> web_form_rules form=self rules=rules

validate

+ `rules`=None
+ `data`

> web_form_validate form=self rules=rules data=data

render

+ `id`=form
+ `data`=None
+ `errors`=None

> web_form_render form=self id=id data=data errors=errors

submit

+ `data`
+ `db`

*url = > json.get value=db key=url * > web_form_submit form=self data=data url=url

app

+ `page`
+ `db`=None
+ `admin`=False
+ `host`=127.0.0.1
+ `port`=18081

ensure_plugin > web_app_new page=page db=db admin=admin host=host port=port

route

+ `path`
+ `page`=None

self

mount_form

+ `id`
+ `form`

Register GET|POST /_form/{id} for listen.

> web_app_mount_form app=self id=id form=form

listen

Serve /, /_part/{id}, /_form/{id}, and optional /admin.

> web_listen app=self