Also fix static links (URLs with dots) being misread as db fields. Co-authored-by: Cursor <cursoragent@cursor.com>
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 *
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=
titleintro=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.
db*url= > json.get value=dbkey=url * > web_render page=selfurl=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=
tableaction=actionid=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=
pagedb=dbadmin=adminhost=hostport=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