企业产品设计 · 新资源

Visa Product 设计系统.

使用 Visa 的 Nova CSS,通过原生单选控件、替代色标题栏和确认摘要,打造清晰的账单格式偏好设置。查看精确的 1.6.5 主题值、可缩放间距和完整的样式表集成。

OpenDesign 指南7 个章节40 条参考条目原始应用指南
01

Visa Product 设计系统 界面预览

选择格式和频率,查看本地偏好设置并重置。

账单格式偏好设置打开完整示例
本地嵌入原生 @visa/nova-styles 1.6.5 CSS 和 Visa 主题;移除远程 font-face 规则并使用系统字体。保留原始应用布局和本地脚本。· 实现参考
02

Visa Product 设计系统 设计参考

已发布的 @visa/nova-styles 1.6.5 样式、Visa 主题和示例元数据。默认/浅色值与备用和深色覆盖值分别列出。预览在本地嵌入官方 CSS,移除远程 font-face 规则,并使用系统字体作为回退。

默认配色

来源
名称 / 规则值 / 配置用途
--palette-default-active#1434cb Visa 1.6.5 默认/浅色主题参考。
--palette-default-active-hover#173be8 Visa 1.6.5 默认/浅色主题参考。
--palette-default-active-pressed#0f2595 Visa 1.6.5 默认/浅色主题参考。
--palette-default-active-accent#fcc015 Visa 1.6.5 默认/浅色主题参考。
--palette-default-surface-1#ffffff Visa 1.6.5 默认/浅色主题参考。
--palette-default-surface-2#f5f5f5 Visa 1.6.5 默认/浅色主题参考。
--palette-default-surface-3#f0f0f0 Visa 1.6.5 默认/浅色主题参考。
--palette-default-text#000000 Visa 1.6.5 默认/浅色主题参考。
--palette-default-text-subtle#4a4a4a Visa 1.6.5 默认/浅色主题参考。
--palette-default-text-on-active#ffffff Visa 1.6.5 默认/浅色主题参考。
--palette-default-borderrgba(0, 0, 0, 0.1)Visa 1.6.5 默认/浅色主题参考。

主题尺寸与排版

来源
名称 / 规则值 / 配置用途
--theme-font-size14pxVisa 1.6.5 默认/浅色主题参考。
--theme-border-radius6pxVisa 1.6.5 默认/浅色主题参考。
--typography-headline-1-font-size2.2857142857remVisa 1.6.5 默认/浅色主题参考。
--typography-headline-2-font-size1.7857142857remVisa 1.6.5 默认/浅色主题参考。
--typography-headline-3-font-size1.4285714286remVisa 1.6.5 默认/浅色主题参考。
--typography-body-1-font-size1.1428571429remVisa 1.6.5 默认/浅色主题参考。
--typography-body-2-font-size1remVisa 1.6.5 默认/浅色主题参考。
--typography-body-3-font-size0.8571428571remVisa 1.6.5 默认/浅色主题参考。

可缩放尺寸

来源
名称 / 规则值 / 配置用途
--size-scalable-4calc(4px * var(--theme-scale-factor))基础可缩放尺寸;响应式上下文可能会额外应用缩放系数。
--size-scalable-8calc(8px * var(--theme-scale-factor))基础可缩放尺寸;响应式上下文可能会额外应用缩放系数。
--size-scalable-12calc(12px * var(--theme-scale-factor))基础可缩放尺寸;响应式上下文可能会额外应用缩放系数。
--size-scalable-16calc(16px * var(--theme-scale-factor))基础可缩放尺寸;响应式上下文可能会额外应用缩放系数。
--size-scalable-24calc(24px * var(--theme-scale-factor))基础可缩放尺寸;响应式上下文可能会额外应用缩放系数。
--size-scalable-32calc(32px * var(--theme-scale-factor))基础可缩放尺寸;响应式上下文可能会额外应用缩放系数。
--size-scalable-40calc(40px * var(--theme-scale-factor))基础可缩放尺寸;响应式上下文可能会额外应用缩放系数。

已发布的实用工具类和组件类

来源
名称 / 规则值 / 配置用途
v-flexFlex layout间距示例需要父级元素。
v-gap-20Gap utility在官方默认间距示例中展示。
v-col-gap-20Column gap utility分隔列。
v-buttonPrimary button使用原生 button 元素。
v-button-secondarySecondary modifier示例中的辅助重置操作。
v-radioNative radio style保留相同的名称和不同的值。
v-labelLabel style保留关联标签或包裹式标签。
v-alternateAlternate palette context显示在界面表面或按钮上。
v-typography-headline-1Headline visual role应用于本页面语义上的 h1。

组合约定

来源
名称 / 规则值 / 配置用途
Radio groupOne shared name per question格式和频率是相互独立的选项组。
fieldset / legendGroup question说明这些选项分别对应什么问题。
checkedNative selected state不要仅使用 CSS 来表示选中状态。
disabledNative unavailable state如果无法使用,请保留可见说明。
aria-describedbyOptional supporting description如果附加文本不属于标签,请将其关联起来。
03

Visa Product 设计系统完整指南

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

DESIGN-visa.md

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

下载指南

Visa Product 设计系统 包含易读确认状态的偏好设置任务

让每个问题彼此独立

示例要求用户选择账单格式和摘要频率。这是两个独立的单选组:更改频率不会取消已选的格式。主要操作前会重复显示这两项选择,方便用户查看结果,无需解读图标或猜测隐藏的默认值。

摘自本 OpenDesign 指南

确认偏好设置仅记录本地确认状态。此页面不会请求卡号、检索账户、生成账单或更改金融服务设置。这样,示例便能专注展示设计系统的选择与反馈行为。

阅读配套规范

Visa Product 设计系统 Nova 样式与 Visa 主题需分别导入

结构并不等同于完整主题

官方安装说明要求先导入 styles.css,再导入 themes/visa/index.css。前者提供组件和实用工具规则,后者提供 Visa 主题。只加载其中一个并非完整集成。独立示例和导入代码片段均保留了这一顺序。

已检查的程序包版本为 1.6.5。示例在本地嵌入其 CSS,因此查看时无需向第三方请求样式表。已移除远程 font-face 声明,应用明确使用系统字体作为回退;这是采用本地字体替代方案并明确说明的原生 Nova CSS,并不表示与专有字体完全一致。

阅读配套规范

Visa Product 设计系统 默认配色与备用配色均配有对应的前景色

不要在移植填充色时遗漏对应的文本角色

默认/浅色主题中的活动色为 #1434cb,悬停时为 #173be8,按下时为 #0f2595。活动色上的文本角色为白色。备用主题上下文会改变角色映射,因此示例在页眉界面表面使用 v-alternate,而不是只覆盖背景色。

强调色 #fcc015 并非通用按钮填充色。主题上下文决定如何使用强调色和活动色角色。参考表描述的是默认配色;同一款式表中后续定义的深色和备用主题不会被合并成一组容易引起误解的数值。

阅读配套规范

Visa Product 设计系统 根据主题根字号理解 rem 比例

14 像素的主题根字号会改变常见的 rem 换算预期

Visa 主题定义了 14 像素的字体根字号。因此,headline-1 的值约为 2.285714rem,按该根字号计算对应 32 像素,而不是假设根字号为 16 像素时得出的值。body-1 约为 1.142857rem,body-2 为 1rem。

可缩放尺寸令牌表示一个像素数值乘以主题缩放因子的结果。在响应式场景中,还可能引入第二个因子。在应用中调整间距时,应保留这一表达式;只复制默认计算值会丢失这种关联。示例在频率选项控件中使用官方间距工具类,整体分栏布局则采用原应用的尺寸。

阅读配套规范

Visa Product 设计系统:Nova 外观下的原生单选按钮语义

样式化圆形控件不等于单选按钮组

公开元数据将 v-radio 应用于真正的 input type="radio",并与 label 配对。预览保留了这一原生结构,并将每个选项的可见说明包裹在对应的 label 中。键盘方向键可在组内移动,浏览器和辅助技术也能识别选中状态。

每个问题都用 fieldset 和 legend 命名。格式选项说明了各自的特点:PDF 是可下载的样例,而 HTML 被描述为可重排格式。具体产品内容为原创;控件结构和类名则来自原生库。

  • 为两个格式选项使用同一个 name,为频率选项使用另一个 name。
  • 让单选按钮的 value 与可见说明文字保持区分,这样摘要就能使用稳定的标签。
  • 使用 checked 和 disabled 属性表示状态,不要只依赖装饰性类名。

阅读配套规范

Visa Product 设计系统 Nova CSS 为控件添加样式;原生 HTML 负责选择

将分组和审核逻辑放在样式表之外

示例在真正的单选按钮输入上使用 Nova 的 v-radio 类。共享 name 属性可确保格式选项互斥,另一个 name 则将频率选项分开。fieldset 和 legend 提供分组上下文;关联的 label 则使完整的选项文字成为控件的无障碍名称。

CSS 软件包不会替用户选择选项、管理应用持久化,也不会创建审核记录。提供的脚本会读取两个原生选项组并生成本地摘要。编辑任一选项时,摘要会清除,因为之前的值已无法代表当前偏好。

实现时应同时保留结构样式表和 Visa 主题。备用页眉使用 v-alternate,表单则保持在默认配色上下文中;不要只修改背景、却不处理前景角色,以此模仿页眉。

阅读配套规范

Visa Product 设计系统 在所有屏幕宽度下保持一致的阅读顺序

移动摘要位置,不改变任务顺序

在宽屏上,选项组和当前选择摘要并排显示。在小屏上,摘要位于表单之后。原有文档插图因不提供任务信息而隐藏,所有标签、说明和操作仍会保留。

CSS 库支持现代主流浏览器。官方开发指南并未承诺兼容旧版浏览器,因此生产团队应针对实际支持的版本进行测试,而不能把现代浏览器中的预览成功视为普遍兼容。

  1. 加载固定版本的结构样式 CSS 和 Visa 主题,然后添加应用布局样式。
  2. 选择 Accessible HTML 和 Quarterly,检查偏好设置,并确认两项选择都显示在摘要中。
  3. 更改任一选项,确认审核反馈会重置,然后测试 Reset 和窄屏布局。

阅读配套规范

Visa Product 设计系统组件示例

完整的 Nova CSS 偏好设置组合

两个原生单选按钮组会即时更新摘要;主要操作会明确创建本地审核状态。

html
<!-- index.html after installing @visa/[email protected] in a Vite vanilla project -->
<!doctype html><html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Statement preference</title>
<link rel="stylesheet" href="/node_modules/@visa/nova-styles/styles.css">
<link rel="stylesheet" href="/node_modules/@visa/nova-styles/themes/visa/index.css">
<style>:root{font-family:Arial,sans-serif}body{font-family:Arial,sans-serif;background:#fff}*{box-sizing:border-box}.app{max-width:1150px;margin:auto;padding:24px}.hero{padding:32px;display:grid;grid-template-columns:1fr 150px;align-items:center;gap:24px;border-radius:6px}.hero h1{font-family:Arial,sans-serif;font-weight:600;line-height:1.2;margin:12px 0 16px}.hero p{font-family:Arial,sans-serif}.eyebrow{font-size:11px;letter-spacing:.12em;font-weight:600}.paper{width:120px;height:150px;background:white;border-radius:6px;transform:rotate(8deg);padding:20px;box-shadow:8px 8px 0 #0f2595;position:relative}.paper span{display:block;height:3px;background:#1434cb;margin:10px 0;width:70px}.paper span:nth-child(2){width:45px}.paper b{position:absolute;bottom:10px;right:15px;color:#1434cb;font:600 36px Arial}.workspace{display:grid;grid-template-columns:1.5fr 1fr;gap:40px;margin:32px 0}.workspace h2,.workspace legend{font-family:Arial,sans-serif;font-weight:600}.hint{font-size:14px;color:#4a4a4a;line-height:1.5;margin:12px 0 16px}.option{display:flex;gap:16px;padding:20px 16px;border:1px solid #ddd;border-radius:6px;margin:12px 0;cursor:pointer}.option:has(:checked){border:2px solid #1434cb;padding:19px 15px;background:#f6f9ff}.option b{font-size:16px}.option small{display:block;font-size:14px;color:#4a4a4a;line-height:1.5;margin-top:4px}.option .v-radio{flex-shrink:0}.frequency{margin-top:28px}.frequency legend{margin-bottom:16px}.actions{display:flex;gap:12px;flex-wrap:wrap;margin-top:28px}.v-button{font-family:Arial,sans-serif}.summary{background:#f5f5f5;padding:24px;border-radius:6px;align-self:start;min-height:285px}.summary h2{margin:16px 0 8px}.rule{height:1px;background:#ddd;margin-top:20px}.status{padding:16px 0;font-size:14px;line-height:1.5}.confirmed{color:#1434cb;font-weight:600}footer{font-size:12px;color:#4a4a4a;border-top:1px solid #ddd;padding-top:16px;line-height:1.5}@media(max-width:650px){.app{padding:16px}.hero{padding:24px;grid-template-columns:1fr}.paper{display:none}.workspace{grid-template-columns:1fr;gap:24px}.hero h1{font-size:28px}.option{padding:16px 12px}.option:has(:checked){padding:15px 11px}}
</style><main class="app"><header class="v-surface v-alternate hero"><div><p class="eyebrow">ACCOUNT PREFERENCES / SAMPLE</p><h1 class="v-typography-headline-1">Choose how you read<br>your statement.</h1><p class="v-typography-body-1">One clear choice, with the details visible before you confirm.</p></div><div class="paper" aria-hidden="true"><span></span><span></span><span></span><b>01</b></div></header><div class="workspace"><form id="form"><fieldset><legend class="v-typography-headline-3">Statement format</legend><p class="hint">This page stores a demonstration preference only.</p><label class="option"><input class="v-radio" type="radio" name="delivery" value="Digital PDF" checked><span><b>Digital PDF</b><small>A downloadable sample statement for offline reading.</small></span></label><label class="option"><input class="v-radio" type="radio" name="delivery" value="Accessible HTML"><span><b>Accessible HTML</b><small>A reflowable sample statement with structured headings.</small></span></label></fieldset><fieldset class="frequency"><legend class="v-typography-headline-3">Summary frequency</legend><div class="v-flex v-gap-16"><label class="v-flex v-align-items-center v-gap-4"><input class="v-radio" type="radio" name="frequency" value="Monthly" checked>Monthly</label><label class="v-flex v-align-items-center v-gap-4"><input class="v-radio" type="radio" name="frequency" value="Quarterly">Quarterly</label></div></fieldset><div class="actions"><button class="v-button" type="submit">Review preference</button><button class="v-button v-button-secondary" id="reset" type="button">Reset</button></div></form><aside class="summary"><p class="eyebrow">YOUR CURRENT SELECTION</p><h2 class="v-typography-headline-3" id="selection">Digital PDF</h2><p id="period">Monthly summary</p><div class="rule"></div><p class="hint">No account data is used. No statement is generated or delivered.</p><p class="status" id="status" role="status">Review your preference to create a local confirmation.</p></aside></div><footer>Nova styles 1.6.5 and Visa theme. The example application styles use a system-font fallback. Original demonstration, no financial service connection.</footer></main>
<script>const form=document.querySelector('#form'),status=document.querySelector('#status');function update(){document.querySelector('#selection').textContent=form.elements.delivery.value;document.querySelector('#period').textContent=form.elements.frequency.value+' summary';status.textContent='Review your preference to create a local confirmation.';status.classList.remove('confirmed')}form.onchange=update;form.onsubmit=e=>{e.preventDefault();status.textContent='Reviewed locally: '+form.elements.delivery.value+', '+form.elements.frequency.value.toLowerCase()+'. No account setting changed.';status.classList.add('confirmed')};document.querySelector('#reset').onclick=()=>{HTMLFormElement.prototype.reset.call(form);update()};</script>
</html>

代码参考

  • CSS 提供组件外观;简短脚本负责应用行为。
  • 更改偏好设置会清除之前的审核状态。
  • 备用页眉使用真正的主题上下文,而不是手工绘制的配色仿制品。
  • 将完整的 HTML 保存为 index.html,并在能够访问固定版本公共 CSS URL 的浏览器中打开。本指南中的嵌入式预览会在本地加载这些样式。

同时加载结构样式和主题

在打包应用中,应在应用样式表之前一次性导入这两个层。

javascript
import '@visa/nova-styles/styles.css';
import '@visa/nova-styles/themes/visa/index.css';
import './application.css';

代码参考

  • 缺少主题文件时,结构类可能仍然存在,但不会应用预期的 Visa 令牌。
04

Visa Product 设计系统 AI Agent 设置

实现起点

完整的 HTML 使用已验证的 styles.css 和 themes/visa/index.css 路径。两者缺一不可。此指南中的 iframe 在本地嵌入了这些样式;官方远程 font-face 声明未包含在其中。

终端 / HTML
npm create vite@latest statement-preference -- --template vanilla
cd statement-preference
npm install
npm install @visa/[email protected]
# Replace index.html with the complete example below.
npm run dev

适用于你项目的提示词

Agent 提示词
使用固定的结构和主题CSS,构建 Visa Nova 对账单偏好示例。保留原生单选按钮组、清晰的图例和关联标签。区分默认主题与备用主题的角色,并在换算 rem 值时留意 14px 的根字号。将审核状态保留在本地,更改后清除过期的确认信息,并在小屏幕上将摘要纵向排列。
05

Visa Product 设计系统 来源与范围

独立的OpenDesign指南,使用原生 Nova CSS。此虚构的偏好设置任务不会使用账户数据,也不会更改任何金融服务。预览页面会说明字体替代情况。