{
  "_description": "本文件由 data/ 生成：请改动来源文件，不要改这里。各字段的证据边界见接入指南。",
  "schemaVersion": "1.0.0",
  "kind": "entry",
  "locale": "zh-CN",
  "id": "determinate-progress",
  "name": {
    "zh": "确定进度条",
    "en": "Determinate Progress Bar"
  },
  "page": "https://designvocabulary.com/zh/entries/determinate-progress/",
  "self": "https://designvocabulary.com/zh/entries/determinate-progress.json",
  "alternates": {
    "zh-CN": "https://designvocabulary.com/zh/entries/determinate-progress.json",
    "en": "https://designvocabulary.com/en/entries/determinate-progress.json"
  },
  "site": {
    "catalogSchemaVersion": "0.1.0",
    "entries": 158,
    "index": "https://designvocabulary.com/zh/entries/index.json",
    "query": "https://designvocabulary.com/api/query?lang=zh",
    "guide": "https://designvocabulary.com/zh/agents/",
    "llms": "https://designvocabulary.com/llms.txt"
  },
  "provenance": {
    "sourceBacked": [
      "entry.definition"
    ],
    "editorial": [
      "entry.boundary",
      "entry.signature",
      "entry.when",
      "entry.when_not",
      "entry.tradeoff",
      "entry.comparison",
      "entry.rules",
      "entry.requirements",
      "entry.relations",
      "entry.implementationNote",
      "entry.behavior"
    ],
    "scope": "定义参考以上来源；数字界面示例、选择建议、条件关系及配方由本样例编辑，尚未经用户研究验证。",
    "editorialStatus": "sample-reviewed",
    "specimenData": "fictional",
    "specimenNote": "示例为原创虚构界面；定义附来源，用法与配方为编辑建议。",
    "sources": [
      {
        "id": "carbon-progress",
        "url": "https://carbondesignsystem.com/components/progress-bar/usage/",
        "title": "Carbon · Progress bar",
        "checkedAt": "2026-09-15",
        "archive": {
          "status": "available",
          "confirmed": true,
          "url": "https://web.archive.org/web/20260915165300/https://carbondesignsystem.com/components/progress-bar/usage/",
          "capturedAt": "2026-09-15T16:53:00Z",
          "lookupUrl": "https://web.archive.org/web/20260915*/https://carbondesignsystem.com/components/progress-bar/usage/"
        }
      }
    ],
    "lists": [
      {
        "id": "M-C",
        "edition": "classic",
        "seat": 2,
        "origin": "editorial-reconstruction",
        "page": "https://designvocabulary.com/zh/lists/M-C/",
        "json": "https://designvocabulary.com/zh/lists/M-C.json"
      }
    ],
    "ordered": false,
    "listDisclaimer": "席位号是编辑位置，不是评分、排名或人气统计；清单未收满时保持原样，不补足。"
  },
  "entry": {
    "id": "determinate-progress",
    "type": "micro",
    "name": {
      "zh": "确定进度条",
      "en": "Determinate Progress Bar"
    },
    "aliases": [
      "Progress Bar",
      "百分比进度",
      "可测进度"
    ],
    "granularity": "state",
    "intents": [
      "wait-for-content",
      "track-progress"
    ],
    "tags": [
      "加载",
      "上传",
      "真实进度",
      "百分比",
      "progress"
    ],
    "definition": "在已知总量和完成量时，用进度条表示实际完成比例。",
    "boundary": "百分比必须对应已完成工作；本演示使用手动推进的模拟任务，不代表真实网络速度。",
    "signature": [
      "明确的任务名称",
      "可计算的完成量和总量",
      "完成或失败的终态"
    ],
    "when": [
      "系统提供真实的完成量与总量",
      "用户需要判断任务走到哪一步"
    ],
    "when_not": [
      "未知进度却用定时器伪造百分比",
      "把上传结束误当作服务器处理结束"
    ],
    "tradeoff": "进度更具体，但多阶段任务的总量与统计口径需要可靠。",
    "comparison": {
      "focus": "告诉用户完成了多少",
      "mechanism": "真实完成量 / 总量",
      "cost": "依赖可靠进度数据"
    },
    "sources": [
      {
        "id": "carbon-progress",
        "title": "Carbon · Progress bar",
        "url": "https://carbondesignsystem.com/components/progress-bar/usage/",
        "claim": "区分确定与不确定进度，确定模式用于可量化的进展。",
        "checkedAt": "2026-09-15",
        "archive": {
          "lookupUrl": "https://web.archive.org/web/20260915*/https://carbondesignsystem.com/components/progress-bar/usage/",
          "status": "available",
          "checkedAt": "2026-09-15T16:51:23.998Z",
          "jobId": "spn2-6e1e1bb11e36ab96223035765b5f0c213507b98b",
          "url": "https://web.archive.org/web/20260915165300/https://carbondesignsystem.com/components/progress-bar/usage/",
          "timestamp": "20260915165300"
        }
      }
    ],
    "relations": [
      {
        "target": "skeleton",
        "kind": "alternative",
        "condition": "呈现等待状态",
        "reason": "没有可靠完成量时不能选择确定百分比。",
        "basis": "editorial"
      },
      {
        "target": "calm-technology",
        "kind": "composes_with",
        "condition": "进度无需立即回应",
        "reason": "使用非打断式状态呈现。",
        "basis": "editorial"
      }
    ],
    "rules": [
      {
        "when": "无法获得真实完成量",
        "instruction": "不要显示伪造的确定百分比。",
        "strength": "must",
        "basis": "editorial"
      },
      {
        "when": "任务完成",
        "instruction": "显示完成状态并说明下一步。",
        "strength": "must",
        "basis": "editorial"
      }
    ],
    "requirements": [
      {
        "fact": "measurable_progress",
        "value": true,
        "reason": "确定进度必须有可靠的已完成量和总量。"
      }
    ],
    "behavior": {
      "states": [
        "idle",
        "progress",
        "success",
        "error"
      ],
      "a11y": [
        "进度有名称",
        "使用原生 progress，避免每个百分点都读屏播报"
      ],
      "motion": "手动推进，无自动动画"
    },
    "demo": "determinate-progress",
    "version": "0.1.0",
    "editorialStatus": "sample-reviewed",
    "demoCapabilities": [
      "keyboard",
      "reduced_motion"
    ],
    "implementationNote": "能力标签只描述本演示；应用到产品时仍须重新验证。",
    "searchTerms": [
      "loading",
      "upload",
      "measured progress",
      "percentage",
      "progress"
    ]
  }
}