Skip to content

Page(页面) ​

带路由的 HTML 页面:独立完整页,或通过 Layout 占位注入

是什么 ​

Page 是 Kooboo 站点中有 URL 的 HTML 资源。用户访问 /about 时,渲染引擎加载对应 Page,再按需套上 Layout、解析其中的 <view> 与服务端绑定。

与 k.page 不同:k.page 只改当前这次请求的 title/meta;Page 资源才是站点页面仓库里的实体,由 k.site.pages 管理。

两种写法 ​

1. 独立完整页面 ​

不引用 Layout,Page 自身包含完整 <!DOCTYPE html> 结构,适合落地页或极简页。

若在 <head> 中需要输出 View(如全局 Tailwind 片段),不能写 <view id="...">,应使用 View — 在 head 中引用。

html
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>关于我们</title>
</head>
<body>
    <script env="server">
        var title = '关于我们';
    </script>
    <h1 k-content="title"></h1>
    <view id="hero"></view>
</body>
</html>

2. 使用 Layout(推荐多页站点) ​

Page body 只写布局引用与占位内容,公共 head/导航在 Layout 中维护。

html
<layout id="main">
    <placeholder id="Main">
        <div class="prose">
            <h1>主内容</h1>
            <p>仅本页差异部分</p>
        </div>
    </placeholder>
    <placeholder id="Sider">
        <aside>侧栏</aside>
    </placeholder>
</layout>
元素说明
<layout id="...">id = Layout 资源名称,与后台 Layout 名一致
<placeholder id="...">id = Layout 里某个 k-placeholder 的名称
占位内部普通 HTML,可含 <view>、内联 script,以及 <script env="server">

名称对齐

Layout 中 k-placeholder="Main" 与 Page 中 <placeholder id="Main"> 必须一致。拼写或大小写不一致会导致占位区空白。

引用 View ​

在 Page(或 Layout、View)任意位置插入可复用片段:

html
<view id="product_card"></view>

id 对应站点 View 资源名称。详见 View。

脚本与样式 ​

  • 全局:在 Layout 的 <head> 用 <link href="...">、<script src="..."> 引用 Style / Script 的路由 URL
  • 本页:可在 Page 内写 <script env="server">(KScript)或 <script type="module">(前端 ES Module)

推荐结构:<script env="server"> 数据脚本放在区块顶部,前端交互 script 放在 View 底部或独立 Script 资源。

组件拆分原则 ​

Page 不宜堆过多 markup。出现以下情况时,把区块拆成 View:

  • 多个语义区(Header / Hero / Features / Footer)
  • 多页复用的块(商品卡片、文章列表)
  • 单页超过 3–4 个明显独立区块

拆分后 Page 只保留骨架与占位,细节在 View 及其 Script 中维护。

用脚本管理 Page ​

创建页面、注册 URL、绑定 Layout 名称等,见 k.site.pages。

相关文档 ​