第5章 Fronty 文档第 5 章:编辑文本、图片、图标、链接、组件及关联字段
Fronty 文档
编辑文本、图片、图标、链接、组件和关联字段
使用 Attributes 面板编辑各类常见内容,上传可访问的媒体,创建安全的链接目标,并保持数据库连接不受影响。
最后验证日期:2026-09-01
可用性
可用。语义字段、媒体与图标选择器、链接目标、高级控件以及兼容的数据绑定均已实现。
套餐 所有套餐均可使用核心内容编辑功能;存储、图库素材、数据库和条目页的额度因套餐而异。
角色 网站的 Owner、administrator 或 editor,以及可访问已连接数据的相应角色。
开始之前 需在可视化编辑器中选中一个元素。使用关联字段还需具备 collection 或条目页数据上下文。
本页目录
- 优先使用语义字段,再考虑高级控件
- 编辑文本、标题、按钮和操作
- 将表单标签配置为一套无障碍系统
- 选择、上传、描述并调整图片
- 粘贴并验证可播放的视频地址
- 使用图库图标或自己的图片
- 创建清晰、安全的目标
- 了解会有哪些控件
- 编辑关联内容时不悄悄破坏它
- 完成内容、移动端和无障碍检查
优先使用语义字段,再考虑高级控件 #
选中一个元素并打开 Attributes。最上方的控件使用通俗的标签来编辑该元素的核心内容:文本、图片、目标、来源、状态或行为。修改会实时显示在画布上。双击以文本为主的元素可直接聚焦其主内容字段。
当语义字段无法满足特殊情况时,向下滚动到 Advanced settings。根据元素类型,分组可能包括 General、Spacing、Size、Grid layout、Alignment、Typography、Background、Borders、Shadows、Image、Link、Animation、Position、Visibility、Carousel、Pagination、Data source 和 Layout behavior。
编辑器首次打开时 Advanced settings 默认展开。点击其标题可折叠或重新展开整个分组;该状态在当前编辑会话中选择其他元素时依然保留。如果某个容器没有精选字段但有技术属性,面板会显示"请选择内部元素"的提示,同时保持这些高级分组可用。
编辑文本、标题、按钮和操作 #
选中文字或标题并修改 Content。只有当它需要区别于 Site Styles 时,才使用元素本身的颜色、字体、字号、字重和对齐控件。
保持标题层级符合逻辑的大纲结构,不要仅因视觉大小而选择某个标题级别。
对于按钮,可编辑其标签、样式、可选图标和链接。标签应描述操作结果,例如"查看价格"或"发送咨询"。
打开 Preview,用键盘和鼠标分别验证操作结果。编辑画布会有意阻止访客动作的触发。
紧凑选择工具栏中也提供文字对齐选项。按钮可能提供 variant 和 outline 切换。在访客预览中检查 Mobile 视口和 200% 浏览器缩放下的换行情况;按钮不能丢失标签、焦点轮廓或可点击的有效尺寸。
将表单标签配置为一套无障碍系统 #
选中表单本身(而非单个答题字段),以便在整个表单范围内统一标签行为:
- Labels:Above、Beside 或 Hidden。Hidden 会移除可见文字。文本类输入框、文本域、下拉选择和单选组会保留表单标签作为可访问名称;而 checkbox-group 的选项有意保留各自的选项名称。
- Label size、Label weight 和 Label colour:设置一致的视觉层级。其他技术性控件还包括大小写和字间距。
- Mark required answers with:Star、"required" 或 Nothing。视觉标记是对字段必填行为的补充,绝不能是传达验证信息的唯一方式。
- 当 Labels 为 Beside 时,使用高级 label-width 设置来控制标签列的宽度。帮助文字仍跟随答题字段,而不是变成另一列。当视口宽度不超过 479 px 时,Beside 会自动把标签堆叠到答题字段上方,无论该宽度如何设置。
可见标签在选中时会聚焦到对应答题字段,通常对所有人都更清晰。对 Pick several 组使用 Hidden 时要格外小心:其各个选项会保留自己的名称,但被隐藏的组标签不会成为该组的程序化名称。除非已验证有等效的上下文信息,否则请保持组标签可见。预览时要考虑键盘和屏幕阅读器行为:标签措辞、必填提示、帮助文字和错误信息应描述同一个字段。
选择、上传、描述并调整图片 #
选中图片或 logo 并打开其图片字段。根据网站配置,选择器可提供 URL、Upload、Library 和 Stock photos。
- 使用 Upload 上传自己的文件。大型位图在能产出更小的可用文件时会被自动优化;最长边限制为 2560 像素,且仅在 WebP 更小时才使用该格式。SVG 和 GIF 保持原格式。
- 已有网站资源时使用 Library,避免上传重复文件。删除图库资源是永久性的,可能破坏所有仍在使用其 URL 的页面,所以请先查找并替换引用。
- 根据图片在上下文中的用途撰写 Image description。纯装饰性图片可留空描述。不要逐字重复图片旁边的说明文字。
- 选择能在 Desktop、Tablet 和 Mobile 下保持重要内容可见的图片适配方式。容器形状变化时裁剪效果可能改变。
- 如果图片可点击,配置 Click action,并确保键盘和屏幕阅读器用户也能实现同样的目的。
外观效果包括 Original、Mono、Noir、Warm、Cool、Fade 和 Vivid,以及亮度、对比度、饱和度、黑白、棕褐色、色调、模糊等微调。这些调整是无损的:回到 Original 即可移除视觉效果。使用大幅首屏大图后请预览页面性能。
选择资源、在裁剪中保留重要主体、撰写恰当的替代文字,并验证发布后的交互效果。
粘贴并验证可播放的视频地址 #
选中视频并打开 Video。预览会一直显示,而地址编辑器默认折叠在状态摘要(如"暂无视频——请粘贴地址")之后。点击摘要展开字段;其展开或折叠状态在当前编辑会话中会保留。从浏览器地址栏粘贴地址:YouTube 或 Vimeo 的观看、分享或嵌入链接都可以,MP4 URL 等可直接播放的视频文件地址也可以。没有视频 Upload 选项卡,因为当前的媒体上传端点只接受图片,不支持视频文件。
保存前字段会确认其解析结果。YouTube 和 Vimeo 会显示带服务标识的封面图;直接文件会尝试显示其真实首帧。频道、个人主页、播放列表、格式错误的地址或无法播放的文件都会收到具体的提示信息,而不会默默留下一个空白的画布播放器。
当所选视频支持时,可配置封面、自动播放、循环和静音行为。避免强制出声和包含关键信息的自动播放。为有意义的语音提供字幕或文字稿,并确保控件可以键盘操作。最后,使用访客 Preview 进行验证——封面图只能验证视频源,只有真实播放器才能验证播放、控件、字幕和移动端表现。
使用图库图标或自己的图片 #
选中图标并打开图标字段。选择 Library 可搜索图库,或选择 Your picture 使用图片地址,或上传自己的 SVG、PNG、WebP 或其他支持的图片文件。对于简单的自定义符号,SVG 通常是最清晰、最轻量的选择。
图库搜索能理解常见的相关词汇,会对相近结果排序并显示匹配数量。一次只渲染有限数量的结果,所以当看不到目标图标时,请细化范围过宽的查询。然后在语义图标控件中设置颜色和大小。
不要让符号成为陌生操作的唯一解释。应搭配可见文字,或确保周围的可交互控件拥有可访问名称。装饰性图标不应重复表达已有的含义。
创建清晰、安全的目标 #
打开链接字段,或右键选择链接操作。选择器支持:
| 类型 | 适用场景 | 发布前检查 |
|---|---|---|
| Page | 本网站的另一个页面。 | 选择托管页面而不是手动输入路径。较大的网站提供页面搜索。 |
| Section | 当前页面上的命名区域。 | 选择该区域;如有固定页头会遮挡内容,请设置滚动偏移。 |
| Website | 外部或自定义网址。 | 使用完整的加密地址;仅当新标签页对上下文有益时才在新标签页打开。 |
| 发起邮件。 | 验证地址,并保持可见标签易于理解,而不是只暴露原始语法。 | |
| Phone | 在支持的设备上发起通话。 | 使用国际格式号码,并在附近显示可读的号码。 |
对于不适合托管选项的目标,仍可使用自定义地址。预览每一个链接目标。避免使用"点击这里";链接文字脱离上下文也应能被理解。编辑器会阻止不安全的嵌套可交互内容,例如在可点击卡片内再放一个链接。如果目标字段不可用,请选中正确的外层元素,而不是通过 Advanced settings 强行填写原始链接值。
了解会有哪些控件 #
| 选中的内容 | 主要控件 | 访客端检查 |
|---|---|---|
| 文本或标题 | Content、颜色、字体、字号、字重、对齐、点击操作。 | 标题顺序、可读行宽、缩放、对比度。 |
| 按钮 | Label、样式、图标、目标。 | 明确的名称、焦点、键盘激活、目标尺寸。 |
| 图片或 logo | 资源、描述、外观/效果、适配、点击操作。 | 替代文字、裁剪、文件大小、目标。 |
| 视频 | 来源、封面、自动播放、循环、静音。 | 控件、字幕、动效偏好、不强制播放声音。 |
| 图标 | 图库或自己的图片、颜色、大小。 | 含义有名称;避免装饰性重复。 |
| 表单控件 | Label、名称、类型、选项、必填,以及适用的验证或目标。 | 可见标签、错误恢复、tab 顺序、真实提交。 |
| 菜单、下拉或标签页 | 条目、标签、目标、选中状态、布局。 | 触控、键盘、焦点移动、展开状态。 |
| 轮播或分页 | 条目、导航、计时、显示和分页设置。 | 暂停/控制、键盘可达、关键内容不被隐藏。 |
| Section | 区块宽度、内容宽度、背景、媒体、图片适配。 | 阅读顺序、对比度、溢出、响应式裁剪。 |
| Collection | Edit data、Edit card design、连接和条目页操作。 | 空数据、加载中、错误、单行、长内容以及真实条目等状态。 |
并非每个控件都出现在每个组件上。如果找不到某个字段,请确认当前选中项并使用祖先路径。容器可以负责背景和布局,而其子元素负责内容或链接目标。
编辑关联内容时不悄悄破坏它 #
collection 卡片或条目页上下文中的兼容字段可以读取数据库列。其 Attributes 控件会显示 Connected to 加列名,或 From column 提示,而不是表现得像普通自由文本。
- 选中 collection,选择 Edit data 修改数据行,或 Edit card design 修改重复模板。
- 对符合条件的未连接 collection,使用 Connect a database。嵌套列表则可能提供 Connect this list to a column。
- 在卡片或条目设计中,对兼容的文本、图片、链接、颜色等字段使用旁边的绑定控件,并选择目标列。
- 检查几条有代表性的数据行。某一行可能暴露缺失值、超长标题、异常图片或无效的条目链接。
修改卡片设计会影响所有渲染出来的行。修改 Edit data 会更改数据记录。为每个条目创建页面还需要稳定的唯一 slug 和路由;发布条目链接前请遵循动态内容指南。
完成内容、移动端和无障碍检查 #
- 不残留占位文案、示例价格、虚假声明或未说明的空白字段。
- 标题构成有意义的大纲,控件拥有明确可见的标签。
- 有信息价值的图片有符合上下文的描述;装饰性图片不会产生重复播报。
- 每个链接和点击操作都有真实的目标和可理解的目的。外部、邮件和电话操作使用正确的格式。
- 关联元素仍指向预期的列,并在空数据、典型数据、长内容和缺失值等各种记录下正常工作。
- 图片足够清晰但不臃肿,重要内容在响应式裁剪后依然保留。
- 已在 Preview 中检查 Desktop、Tablet、Mobile、纯键盘操作以及 200% 访客浏览器缩放。
如何判断成功了保存的页面重新打开时内容符合预期,所有媒体资源和链接在访客 Preview 中正常加载,数据库驱动的字段随记录变化,并且页面在不依赖颜色、悬停或图片的情况下依然易于理解。
功能概览
如需更简短的产品说明,请参阅:
- Visual editor
- Dynamic content
相关指南
-
使用可视化编辑器
学习完整的编辑流程:选中准确的元素、添加和排列内容、检查响应式表现、恢复更改并安全保存。
-
动态内容与条目页
设计一个可复用的组件,把字段绑定到数据表,并创建带有记录专属元数据的稳定详情路由。
-
移动端、无障碍与速度
测试响应式布局,用键盘完成主要使用路径,并依据实测的性能数据而非视觉假设。