工作方式
- 下载入门主题一个 .zip,内含
theme.json和theme.css,已通过所有检查。解压后,修改其中的id和name。 - 编写您的 CSS为页面的部件设置样式,并设定它的令牌。针对页面现有的样子编写规则;您无需改动它的标记。
- 重新压缩将文件压缩成 .zip,或压缩包含它们的文件夹。图片和字体与
theme.css放在一起,并列在theme.json中。 - 店主添加店主在管理后台中添加 .zip:门店,选择门店,自取点单,您的主题,然后为小程序、二维码页面或两者选择它。
主题只是 CSS。菜单、价格、购物篮和付款都由页面自身负责,因此主题不会导致订单出错。
主题包
一个 .zip,最大 5 MB。theme.json 和 theme.css 位于顶层,或位于顶层的同一个文件夹中。其他每个文件都必须列在 theme.json 的 files 中。
- 图片:png、jpg 或 webp。字体:woff2。不支持 SVG,因为它可能包含脚本。
- 文件名为纯小写字母,内部不能有文件夹:
bg.webp、stall.woff2。 - 最多 30 个文件,每个 1 MB。
theme.css最大 150 KB,theme.json最大 16 KB。 - 您的电脑自动添加的内容(
__MACOSX、.DS_Store)会被忽略。其他未列出的文件会被拒绝。
theme.json
记录主题的作者、适用的模式、文件,以及店主无需修改您的 CSS 即可更改的设置。
{
"contract": 1,
"id": "night-market",
"name": "Night Market",
"version": "1.0.0",
"author": { "name": "Sok Dara", "url": "https://example.com" },
"description": "Kraft paper by day, dark roast by night.",
"modes": ["light", "dark"],
"files": ["bg.webp", "stall.woff2"],
"settings": [
{ "type": "color", "id": "stall", "label": "Stall color", "light": "#B4532A", "dark": "#E08A5F" },
{ "type": "switch", "id": "paper", "label": "Paper texture", "on": true }
]
}contract | 主题所依据的规范。目前为:1。 |
id | 2 到 40 个小写字母、数字和连字符。使用相同的 id 再次添加,会替换该店铺中的主题:即新版本。 |
name | 店主在管理后台中看到的名称,最多 40 个字母。 |
version | 三个数字,如 1.0.0。 |
author | name,如果愿意,可加上 url。 |
description | 关于主题的一句话,最多 280 个字母。 |
modes | light、dark 或两者。只适用于一种模式的主题始终以该模式显示,页面会隐藏模式切换。 |
files | CSS 引用的每一张图片和字体。 |
settings | 最多 12 项。color 带有 light 和 dark 两个值,读取为 var(--setting-<id>);switch 开启时设置 html[data-setting-<id>]。 |
页面为主题提供的内容
无论哪种外观、哪个主题,页面的标记都相同。以下属性设置在 <html> 上:
data-theme-pkg | 您主题的 id。检查器会将您的每条规则限定在该 id 之下。 |
data-theme | light 或 dark:顾客的选择、手机的设置,或 Telegram 的设置。 |
data-tg | 页面位于 Telegram 内。--tg-top 是 Telegram 按钮所占的空间。 |
data-scrolled | 菜单已滚动到页眉下方。 |
lang | en、fr、km 或 zh。高棉语和中文需要带有其字符的字体:对它们保留 var(--sans) 或 var(--km)。 |
令牌
由您设置,写在 :root 或 html 上,以及 [data-theme="dark"] 中:
--bg--bg-deep--panel--line--line-soft--ink--ink-soft--muted--look-backdrop--look-hero--look-hero-r--look-r--look-r-sm--look-bw--look-shadow--look-shadow-color--look-tile--look-img--look-head--look-blur--look-chip-r--look-badge-r
由您读取,但不设置:锁定的颜色,以及店铺自己的强调色,为每种模式调整为可读。
--primary--danger--ok--warn--info--acc-*--tg-*--acc-solid--acc-ink--acc-tint--acc-line
:root {
--bg: #FBF7F1;
--panel: #FFFFFF;
--look-r: 18px;
}
html[data-theme="dark"] {
--bg: #16130F;
--panel: #221D17;
}
.to-section h2 {
color: var(--setting-stall);
border-bottom: 2px solid var(--acc-line);
}
html[data-setting-paper] .to {
background: url('bg.webp');
}用 --acc-solid、--acc-ink、--acc-tint 和 --acc-line 表示店铺的品牌色。每家使用您主题的店铺都保留其自己的颜色。
部件和状态
主题可以设置样式的类名,按区域列出。您可以为其中的任何元素设置样式;以下是保持不变的名称。
| 区域 | 类名 |
|---|---|
| 页面 | .to.to-menu.po-nobar.po-bar |
| 页眉 | .to-head.to-logo.to-lang.look-mode.lang-menu.lang-menu-panel.lang-menu-name.lang-menu-chev.po-hours.po-hours-head.po-deals.po-member |
| 分区 | .po-catbar.to-cats.po-layout.to-section.to-grid |
| 菜品,列表 | .po-dish.po-dish-open.to-dish-img.to-dish-text.to-dish-desc.po-initial.po-deal-mark |
| 菜品,网格 | .po-card.po-card-open.to-card-img.to-card-text.po-card-foot |
| 按钮和价格 | .po-add.to-stepper.to-price.to-icon-btn |
| 点餐 | .to-bar.to-sheet.to-sheet-head.to-field.to-opt.to-group.to-lines.to-sum |
状态
.in 表示菜品在购物篮中;.reveal 随后 .seen 表示菜品或标题在滚动进入视野前后的状态(仅首屏以下,减少动态效果时从不);.no-photo 表示没有图片的菜品;.on 表示当前可见的分区标签;aria-pressed 用于列表和网格切换。
检查内容
每个主题包在添加时都会检查。拒绝时会列出每个问题及其所在行,以便一次性修正。
| 拒绝项 | 原因 |
|---|---|
| 反斜杠转义 | 它们可以拼写任何内容,包括 url(。 |
@import,以及 @media、@supports、@container、@keyframes、@font-face 之外的所有 at 规则 | 不会从外部加载任何内容;也不会改变页面规则的顺序。 |
url() 指向主题包自身文件之外的任何地方 | 外部链接可能会告诉另一个网站有人打开了该页面。 |
!important | 锁定的规则使用它,因此主题的任何内容都无法压过它们。 |
| 设置锁定的令牌 | 点餐按钮、状态和错误保持其颜色;强调色仍为店铺自己的。 |
content 中的文字 | 主题不能在页面上书写内容,例如伪造的价格。""、none 和计数器都可以。 |
expression(、javascript:、-moz-binding、behavior | 它们会运行或获取某些内容。 |
| 嵌套规则、无法解析的 CSS,或超过 150 KB | 每条规则都按其书写的方式限定范围。 |
通过检查的内容会限定在 html[data-theme-pkg="<id>"] 之下,其 @keyframes 改名为主题自己的名称,其 url() 指向文件提供的位置。
始终不变的内容
在您的 CSS 之后,页面会添加任何主题都无法压过的规则,因此每家店铺都能安全地点餐:
- 主要点餐按钮保持其颜色,并始终是完整、可读的按钮。
- 错误和拒绝保持其红色。
- 价格始终可读。
- 键盘焦点始终可见。
- 在减少动态效果下,没有任何内容移动。
在店铺中试用
添加主题需要 Growth 或 Pro 套餐。在 您的主题 下添加 .zip,然后为小程序或二维码页面选择它。从管理后台打开页面,即可查看浅色和深色模式、列表和网格,以及高棉语和中文下的效果。
- 使用相同的
id再次添加会替换它,使用它的店铺会保留该主题:这就是您发布新版本的方式。 - 移除主题后,每家店铺都会恢复为其页面外观。
- 您的 CSS 按版本缓存,因此每次上传都有新的地址,顾客永远不会看到只加载了一半的内容。
规范版本
本页的类名、状态和令牌属于规范 1。我们只增加内容,不改名。如果某次变更不得不破坏它,那就是规范 2,页面会持续为每个主题提供其所指定的规范,直到它被更新。