进阶 fronty.com 2026-11-22 10:54:48 · 7 阅读

第8章 将数据库行连接到列表和详情页

Fronty 文档 将数据库行连接到列表和详情页 设计一个可复用的组件,把它的字段绑定到数据表,并通过每条记录专属的元数据创建稳定的详情路由。

最后验证于 2026-09-01

可用性 有限可用 列表、绑定、详情路由和动态详情元数据均已实现。但详情路由的站点地图覆盖尚不完整。

方案:所有方案均可用,受数据表、行数、页面数和用量额度限制。 角色:编辑者;如果集合使用数据表,还需额外的数据库编辑权限。 开始前:准备一个包含有代表性的内联行或表格行的集合,并为每个详情路由准备一个唯一且适合作为 URL 的值。

本页内容 准备数据表和路由字段 设计卡片并绑定字段 筛选、排序并限制可见条目 为每行数据创建一个页面设计 规划 slug 变更和行删除 验证列表和详情页行为

准备数据表和路由字段 # 先从卡片和详情页真正需要的字段开始:标题、摘要、图片、正文、分类、发布状态,以及一个稳定的 slug。slug 应该唯一、小写、可读,并且不依赖数据库行 ID。 还要想清楚可选字段为空时如何展示。缺图不应该出现裂图图标;缺价格不应该渲染出一个莫名其妙的零;未发布的行不应该意外成为可被发现的公开条目。

设计卡片并绑定字段 # 选中集合。工具栏会显示 Edit data、Edit card design,以及在尚未关联数据表时的 Connect a database。 将集合连接到目标数据表,然后选择 Edit card design,用真实的短文本、长文本和空值设计一张完整的卡片。 在卡片内选中一个文本、标题、图片、按钮、图标、视频、徽章或其他受支持的元素,选择 Magic Bind Data,再挑选一个兼容的列;编辑器会保留该元素原有的布局和样式。 对每个动态值重复此操作。链接列填充链接目标,图片列填充图片源,图标列填充图标,普通文本列填充可见内容。选择器会自动过滤不兼容的选项。 要更改绑定,直接选择另一列即可。当选择器显示已有连接时,选择 Disconnect data 可把当前结果还原为普通可编辑内容。

嵌套在另一个集合中的列表可以使用 Connect this list to a column 来渲染结构化的子行。 在详情页上,提供数据的集合之外的元素可以使用 Connect this element to item data。

Animated walkthrough 把一张卡片设计绑定到多条真实数据行 卡片标题通过 Magic Bind Data 连接后,集合会为每条数据库行显示不同的值。

筛选、排序并限制可见条目 # 打开集合的 Edit data 对话框,选择 Filter items。 在 Show items where 下,选择一个字段和 is、is not、contains、greater than 或 less than,然后输入值。 可选地设置 Sort 字段和 A → Z 或 Z → A,并填写数值型的 Limit。选择器包含卡片设计中的字段,以及已连接集合从数据表获取的列。 选择 Apply 应用。选择 Clear 可一次性清除筛选、排序和限制;Cancel 则保持不变。

为每行数据创建一个页面设计 # 选中集合并选择 Page for each item。无法在 Shared Element 内进行此配置,需先解除该副本的链接。 在 1. Your items 中,选择 Inline collection data 或某个数据表,以及用作网址的 Column 和用作条目名称的 Column。 在 2. Their page 中,为这些条目创建新页面或复用已有的详情页,输入参数化地址(如 /products/:slug),并选择一个真实的 Item 进行预览。 在 3. The way in 中,选择访客的点击入口:符合条件的整张卡片、已有的链接,或 Add a "Read more" button。 解决所有校验提示,然后保存,Fronty 会打开共享的页面设计。在该页面上使用 Magic Bind Data 绑定标题、正文、图片、链接及其他行专属的值。

每个 URL 值必须非空且唯一,并采用类似 hello-world 的短格式:仅含字母、数字和连字符,不含斜杠。当某一列误填了完整路径或前缀时,对话框会提供 Fix URL values 来去掉前缀。预览或 URL 检查失败时应重试,不要强行保存。 两条种子数据应能从同一设计生成两个不同的稳定 URL。配置会拒绝有歧义的条目 URL,而不是冒着指向错误行的风险。 在编辑器暴露相应控件的地方,绑定条目专属的标题、描述和主图。托管层可以渲染动态条目元数据,但可发现性和渲染是两回事:当前客户站点的站点地图并不会枚举每一个参数化的条目路由。

Animated walkthrough 把一个详情页设计映射到稳定的行 URL 路由列、条目名称、共享页面设计和条目入口被连接成一份可检视的映射。

规划 slug 变更和行删除 # 修改已发布的 slug 会改变公开地址。如果旧 URL 已有流量或外链,请更新链接并在 Fronty 之外安排重定向。删除关联行之前,先检查哪些页面正在展示它。 路由冲突必须在发布前解决:条目路由不能安全地与普通页面或其他条目共用同一地址。建议使用集合前缀(如 /products/slug),而不是把每个条目都放在站点根路径下。

验证列表和详情页行为 # 如果一切正常,你会看到:两行不同的数据渲染成两个列表项和两个稳定的详情 URL;编辑某一行只会改变它自己的输出;缺失的可选字段能优雅降级;每个条目无需事先知道 URL 即可被访问。

仅用键盘测试卡片和条目链接。只有当卡片只有一个符合条件的根元素且没有冲突的嵌套可点击内容时,才会提供整卡链接;否则请使用命名清晰的链接或按钮。在手机宽度下,验证长标题、缺图、嵌套列表和空结果状态,确保没有横向滚动或被隐藏的操作。

功能概览 更简短的产品说明请参阅: 动态内容 网站数据库

相关指南 数据库基础 编辑集合的内联行、把可复用内容迁移到数据库表、安全地使用 AI 和 JSON,以及避免敏感数据出现在公开内容中。 SEO、社交与 AI 可见性 控制页面身份和预览效果,验证 Fronty 自动渲染的内容,并了解哪些工作仍需手动处理或依赖外部渠道。 就绪度与发布 了解草稿和发布、解决完整的就绪度检查清单、安全发布,并了解当前可回滚的范围。

评论 (0)