企业产品设计 · 新资源

Samsung One UI 设计系统.

通过完整的原创阅读偏好预览,了解 One UI 的浏览与交互结构、24dp 边距建议、200% 文本缩放要求,以及深色外观和明确的重置恢复方式。

OpenDesign 指南6 个章节17 个参考条目原始应用指南
01

Samsung One UI 设计系统界面预览

切换外观,查看 200% 阅读文字,并取消或确认重置。

查看阅读偏好与恢复操作打开完整示例
完整的原始 HTML/CSS/JavaScript;使用原生浏览器控件和对话框,并非 Samsung 平台组件。· 实现参考
02

Samsung One UI 设计系统设计参考

Samsung 公开的布局与无障碍指导,并将原始 CSS 研究中的设计选择单独标注。未臆造未公开的配色、字体或组件 API。

已发布的布局与无障碍要求

来源
名称 / 规则值 / 配置用途
Side marginsAt least 24dp on left and right原生布局参考;不要将 dp 擅自标记为 CSS 像素。
Viewing and interaction areasViewing above; frequently used interaction below有意识地安排上下文和可触达的操作;这是布局原则,不是固定的屏幕高度比例。
Cutout handlingAdapt placement to camera cutouts and orientation不要将关键内容放在设备挖孔区域后面。
Text resizingUp to 200% without losing content or function已发布的无障碍指导;浏览器研究通过明确的阅读字号控件演示段落自适应排版。
Target separationLarge enough touch areas with space between them公开文本未在此处规定数值下限;示例中的 48px 控件是原创的网页设计选择。

已发布的交互规则

来源
名称 / 规则值 / 配置用途
Complex gesturesProvide an alternative action不要将拖动或多指操作设为完成任务的唯一方式。
Automatic contentProvide control for moving content over 5 seconds本研究不包含自动轮播或定时消失的内容。
Error recoveryClear message and focus on the next useful action使用清晰可见的文本,并提供明确的恢复操作。
Screen transitionsFeedback and an explicit way back重置对话框提供取消操作,并支持通过键盘 Escape 键恢复。
Focus blocksSubdued surfaces for function-focused content颜色角色指导;未将任何数值配色臆造为官方令牌导出内容。

原创的浏览器研究设计选择——非 Samsung 令牌

来源
名称 / 规则值 / 配置用途
--study-background#F3F3F6 为此独立的浏览器演绎版本专门设计。此数值并非官方 One UI 设计令牌。
--study-card#FFFFFF 为此独立的浏览器演绎版本专门设计。此数值并非官方 One UI 设计令牌。
--study-text#17171C 为此独立的浏览器演绎版本专门设计。此数值并非官方 One UI 设计令牌。
--study-action#2557C8 为此独立的浏览器演绎版本专门设计。此数值并非官方 One UI 设计令牌。
Card radius24px为此独立的浏览器演绎版本专门设计。此数值并非官方 One UI 设计令牌。
Minimum control height48px为此独立的浏览器演绎版本专门设计。此数值并非官方 One UI 设计令牌。
Reading-size options100%, 150%, 200%为此独立的浏览器演绎版本专门设计。此数值并非官方 One UI 设计令牌。
03

Samsung One UI 设计系统完整指南

实用指南,介绍如何为真实界面选择、应用和评审此系统。

DESIGN-samsung-one-ui.md

完整指导、实现起点和源代码链接。

下载指南

Samsung One UI 设计系统 One UI 设计指导与浏览器适用范围

将 One UI 视为平台指导

One UI 描述了 Samsung 设备上的交互方式,包括手机、大屏设备和折叠屏设备。它不是通用的网页组件包。此处的示例是关于阅读偏好的原创浏览器研究,展示了阅读区域、下方的交互区域和明确的恢复操作,但不声称使用了 Samsung 组件或更改了设备设置。

摘自本 OpenDesign 指南

确保实现参数的说明准确

此参考将已发布的要求与原创的浏览器参数区分开来。原生边距以原始单位 24dp 记录;预览中的 24px 内边距则是有意采用的网页实现方式。蓝色、灰色界面表面和 24px 卡片圆角都是原创研究设计值。这样的区分可避免 AI Agent 将视觉上看似合理的 CSS 变量误认为经过验证的 Samsung 令牌。

  • 区分 dp 与 CSS px。
  • 将原创配色和圆角选择标注为原创。
  • 不要将浏览器预览描述为 Samsung 系统设置。

Samsung One UI 设计系统阅读区域与可触达操作

让首屏区域发挥实际作用

上方区域标明“阅读偏好”,并提供简短的背景说明。下方的分组设置和阅读示例承载主要任务;“应用”和“重置”操作放在这些分组之后。这样的结构既便于阅读标题,也能将相关操作集中在一起,而不是把互不相关的控件分散在装饰性的设备外框周围。

调整结构,而不是伪造设备界面

此浏览器研究不包含操作系统状态栏、摄像头挖孔或设备权限。窄屏布局会保留所有设置,并允许操作行改为纵向排列。原生实现仍需考虑实际安全区域、挖孔、屏幕方向和折叠屏状态变化。响应式浏览器截图无法验证这些设备特有的行为。

Samsung One UI 设计系统克制的界面表面与明确的外观设置

使用背景色块对相关内容进行分组

每项设置和阅读示例都放在克制的卡片表面上。操作颜色用于标识可交互选项,说明文字则使用独立的弱化颜色角色。深色外观会切换相同的颜色角色,而不是在浅色界面上覆盖一层深色。这些 CSS 颜色均为原创的演绎设计值,可下载的源文件也对此作了标注。

切换外观时保留设置

外观复选框只影响预览主题,不会清除已选的阅读字号,也不表示 Samsung 系统偏好已更改。选项发生变化时,应用会清除先前的已应用确认状态,避免状态消息描述已不再成立的状态。

Samsung One UI 设计系统阅读字号与自适应排版

明确展示 200% 的情况

阅读字号控件提供 100、150 和 200 百分比选项。它会调整示例段落的字号,并允许卡片自然扩展。文字不会被截断、不会与相邻控件重叠,也不需要另设固定高度的区域。该控件仅用于展示阅读示例,并不表示会更改浏览器或操作系统的所有字体设置。

确保完整文字始终可见

Samsung One UI 设计系统应用、重置与对话框焦点

使用与操作相符的确认文案

“应用到此预览”会显示所选外观和阅读字号百分比。消息明确说明没有向设备发送任何内容。这是一条持续显示的状态消息,而不是很快消失的 Toast,让读者有时间查看结果。更改任一设置都会清除之前的确认消息。

将重置设为明确的选择

“重置”会打开原生浏览器对话框,其中包含“保留偏好设置”和“重置”操作。取消和按 Escape 键都会保留当前的两项选择。确认重置后,外观会恢复为浅色,字号会恢复为标准大小,焦点也会返回打开对话框的操作控件。完整的状态转换逻辑已在源码中实现,并非仅以未明确说明的处理函数代替。

Samsung One UI 设计系统完整浏览器示例与原生开发后续步骤

运行时无需虚构 One UI 依赖

完整的 HTML 文档包含所有样式、内容和 JavaScript。将其保存为 index.html 并在本地提供服务。它不会请求外部字体或运行时资源,也不需要 Samsung SDK。迁移到原生应用时,请使用 One UI 和 Android 官方资源,了解实际平台控件、密度单位、无障碍服务和配置变更。

  1. 保存提供的独立 HTML 文档。
  2. 在本地提供其目录,并打开预览。
  3. 测试 200% 阅读字号和两种外观模式。
  4. 分别验证取消、Escape 键和确认重置。

按容易暴露问题的顺序进行测试

选择深色外观和 200% 阅读字号,应用后查看确认消息。打开重置对话框,取消并确认两项选择均保留。按 Escape 键重复一次,然后确认重置,检查数值是否恢复、焦点是否返回。分别在桌面端和手机端宽度下检查放大后的段落,确保文字和控件均未被裁切。

Samsung One UI 设计系统组件示例

index.html — 完整的阅读偏好设置示例

完整布局、浅色与深色角色、文本缩放控件,以及支持安全取消的重置对话框。

html
<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Reading preferences study</title><style>
/* Original web-study values, not exported Samsung design tokens. */
:root{--study-background:#f3f3f6;--study-card:#fff;--study-text:#17171c;--study-muted:#5b5b66;--study-action:#2557c8;--study-border:#d9d9e1;--study-text-scale:1}*{box-sizing:border-box}body{margin:0;background:var(--study-background);font-family:Arial,sans-serif;color:var(--study-text)}body.dark{--study-background:#101014;--study-card:#222228;--study-text:#f7f7fb;--study-muted:#bbbbc8;--study-action:#9bbaff;--study-border:#41414c}main{max-width:980px;padding:32px;margin:auto}.context{font-size:13px;line-height:1.6;color:var(--study-muted);max-width:74ch}.phone{max-width:560px;margin:32px auto;background:var(--study-background)}.viewing{padding:40px 24px 32px;min-height:230px;display:flex;flex-direction:column;justify-content:flex-end}.viewing p{font-size:14px;margin:0 0 16px;color:var(--study-muted)}h1{font-size:40px;line-height:1.15;margin:0;letter-spacing:-.025em}h2,.setting-title{font-size:20px;line-height:1.4;margin:0}section.settings{padding:0 24px}.card{border-radius:24px;background:var(--study-card);padding:24px;margin-bottom:16px}.setting{display:flex;gap:24px;justify-content:space-between;align-items:center}.setting p{font-size:14px;line-height:1.5;color:var(--study-muted);margin:8px 0 0}input[type=checkbox]{width:28px;height:28px;accent-color:var(--study-action);flex-shrink:0}label{cursor:pointer}.field{display:grid;gap:12px}select,button{font:inherit}select{width:100%;border:1px solid var(--study-border);border-radius:12px;padding:12px;background:var(--study-card);color:var(--study-text);min-height:48px}.sample{font-size:calc(16px * var(--study-text-scale));line-height:1.55;overflow-wrap:anywhere;margin:16px 0 0}.actions{padding:16px 24px 24px;display:grid;grid-template-columns:1fr 1fr;gap:16px}button{border:0;border-radius:999px;min-height:48px;padding:12px 16px;color:var(--study-action);background:var(--study-card);font-weight:700;cursor:pointer}.primary{background:var(--study-action);color:var(--study-background)}:focus-visible{outline:3px solid var(--study-action);outline-offset:4px}dialog{width:min(440px,calc(100% - 32px));border:0;border-radius:24px;padding:24px;background:var(--study-card);color:var(--study-text)}dialog::backdrop{background:#0008}dialog p{line-height:1.6}dialog .dialog-actions{display:flex;gap:12px;justify-content:flex-end;flex-wrap:wrap}#confirmation{font-size:14px;line-height:1.5;padding:0 24px 16px;color:var(--study-muted)}#confirmation:empty{display:none}@media(max-width:600px){main{padding:16px}.phone{margin:16px auto}.viewing{padding:32px 24px}.card{padding:20px}.actions{grid-template-columns:1fr}.setting{gap:16px}h1{font-size:34px}h2,.setting-title{font-size:18px}}
</style></head><body><main><p class="context">OpenDesign original One UI-inspired web study. This demonstrates viewing and interaction areas, readable settings and explicit recovery. It does not control a Samsung device or run native One UI components.</p><div class="phone"><header class="viewing"><p>Make space to read</p><h1>Reading preferences</h1></header><section class="settings" aria-label="Reading preferences"><div class="card"><label class="setting"><span><strong class="setting-title">Dark appearance</strong><p>Use a darker surface in this preview.</p></span><input type="checkbox" id="dark" aria-label="Dark appearance"></label></div><div class="card"><label class="field" for="size"><strong class="setting-title">Reading size</strong><select id="size"><option value="1">Standard · 100%</option><option value="1.5">Large · 150%</option><option value="2">Extra large · 200%</option></select></label></div><div class="card"><h2>A moment to pause</h2><p class="sample">A clear page gives each idea room to breathe. Keep the words that help the reader decide what to do next.</p></div></section><div class="actions"><button id="reset">Reset preferences</button><button class="primary" id="apply">Apply to this preview</button></div><p id="confirmation" role="status"></p></div><dialog aria-labelledby="reset-title"><h2 id="reset-title">Reset reading preferences?</h2><p>This returns the preview to its light appearance and standard reading size.</p><div class="dialog-actions"><button id="cancel">Keep preferences</button><button id="confirm-reset" class="primary">Reset</button></div></dialog><p class="context">Published references include the 24dp side-margin guidance and text scaling up to 200%. CSS pixels here are an original browser interpretation of the layout; app colors and radii are explicitly original. Reading-size changes affect the sample paragraph so its reflow can be inspected. No preference is saved beyond this page.</p></main><script>
const dark=document.querySelector('#dark'),size=document.querySelector('#size'),confirmation=document.querySelector('#confirmation'),dialog=document.querySelector('dialog');function refresh(){document.body.classList.toggle('dark',dark.checked);document.documentElement.style.setProperty('--study-text-scale',size.value);confirmation.textContent='';}dark.onchange=refresh;size.onchange=refresh;document.querySelector('#apply').onclick=()=>{confirmation.textContent=`Applied to this preview: ${dark.checked?'dark':'light'} appearance, ${Math.round(Number(size.value)*100)}% reading size. Nothing was sent to a device.`};document.querySelector('#reset').onclick=()=>dialog.showModal();document.querySelector('#cancel').onclick=()=>dialog.close();document.querySelector('#confirm-reset').onclick=()=>{dark.checked=false;size.value='1';refresh();dialog.close();confirmation.textContent='Light appearance and standard reading size restored.';};dialog.addEventListener('close',()=>document.querySelector('#reset').focus());
</script></body></html>

代码参考

  • 以 study 为前缀的颜色和尺寸是原创的网页设计取值。
  • 阅读字号会改变示例段落;不会修改浏览器或设备偏好设置。
04

Samsung One UI 设计系统 Agent 设置

实现起点

此示例运行的是原创浏览器示例。它不包含 One UI npm 包或 Samsung 原生运行时。

sh
# Save the supplied complete example as index.html.
python3 -m http.server 8000
# Open http://localhost:8000/

适用于你项目的提示词

Agent 提示词
将提供的 One UI 灵感阅读示例构建为明确标注为原创的浏览器实现。保留浏览与交互区域、200% 下的响应式文本重排、明确的外观状态、仅限本地的确认、安全取消的重置以及焦点返回。将原生 dp 要求与原创的 CSS 像素取值分开。
05

Samsung One UI 设计系统来源与范围

基于 One UI 原则的原创 OpenDesign 浏览器实现。它不是原生 One UI 运行时,也不会更改设备设置。参考资料中已区分已发布的要求与原创网页取值。