{
  "_description": "本文件由 data/ 生成：请改动来源文件，不要改这里。各字段的证据边界见接入指南。",
  "schemaVersion": "1.0.0",
  "kind": "entry",
  "locale": "zh-CN",
  "id": "inline-edit",
  "name": {
    "zh": "行内编辑",
    "en": "Inline Edit"
  },
  "page": "https://designvocabulary.com/zh/entries/inline-edit/",
  "self": "https://designvocabulary.com/zh/entries/inline-edit.json",
  "alternates": {
    "zh-CN": "https://designvocabulary.com/zh/entries/inline-edit.json",
    "en": "https://designvocabulary.com/en/entries/inline-edit.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": "atlassian-inline",
        "url": "https://atlassian.design/components/inline-edit",
        "title": "Atlassian Design · Inline edit",
        "checkedAt": "2026-09-15",
        "archive": {
          "status": "available",
          "confirmed": true,
          "url": "https://web.archive.org/web/20260915165217/https://atlassian.design/components/inline-edit",
          "capturedAt": "2026-09-15T16:52:17Z",
          "lookupUrl": "https://web.archive.org/web/20260915*/https://atlassian.design/components/inline-edit"
        }
      }
    ],
    "lists": [
      {
        "id": "I-C",
        "edition": "classic",
        "seat": 2,
        "origin": "editorial-reconstruction",
        "page": "https://designvocabulary.com/zh/lists/I-C/",
        "json": "https://designvocabulary.com/zh/lists/I-C.json"
      }
    ],
    "ordered": false,
    "listDisclaimer": "席位号是编辑位置，不是评分、排名或人气统计；清单未收满时保持原样，不补足。"
  },
  "entry": {
    "id": "inline-edit",
    "type": "interaction",
    "name": {
      "zh": "行内编辑",
      "en": "Inline Edit"
    },
    "aliases": [
      "就地编辑",
      "edit-in-place"
    ],
    "granularity": "component",
    "intents": [
      "edit-in-place",
      "configure"
    ],
    "tags": [
      "编辑",
      "保存",
      "取消",
      "文本",
      "非模态"
    ],
    "definition": "在原来的阅读位置切换为编辑控件，完成后回到阅读状态。",
    "boundary": "不是自动保存的同义词；保存时机、取消语义和错误处理必须另行明确。",
    "signature": [
      "阅读与编辑在同一上下文",
      "明确的保存和取消",
      "失败时保留输入"
    ],
    "when": [
      "高频修改短字段",
      "用户需要保留周边内容作为参照"
    ],
    "when_not": [
      "修改需要复杂说明或跨字段验证",
      "无明确提示就让点击外部丢弃输入"
    ],
    "tradeoff": "上下文连续，但编辑入口、焦点恢复与保存状态需要精心处理。",
    "comparison": {
      "focus": "在原位修改内容",
      "mechanism": "阅读与编辑切换",
      "cost": "管理未保存值、校验和焦点"
    },
    "sources": [
      {
        "id": "atlassian-inline",
        "title": "Atlassian Design · Inline edit",
        "url": "https://atlassian.design/components/inline-edit",
        "claim": "组件在同一页面的阅读与编辑状态之间切换。",
        "checkedAt": "2026-09-15",
        "archive": {
          "lookupUrl": "https://web.archive.org/web/20260915*/https://atlassian.design/components/inline-edit",
          "status": "available",
          "checkedAt": "2026-09-15T16:50:40.136Z",
          "jobId": "spn2-d931b84ec728ee359a86e37a9b3be6dec300eae6",
          "url": "https://web.archive.org/web/20260915165217/https://atlassian.design/components/inline-edit",
          "timestamp": "20260915165217"
        }
      }
    ],
    "relations": [
      {
        "target": "master-detail",
        "kind": "composes_with",
        "condition": "编辑当前详情中的短字段",
        "reason": "保留所选项目上下文。",
        "basis": "editorial"
      },
      {
        "target": "recognition",
        "kind": "composes_with",
        "condition": "让用户发现编辑动作",
        "reason": "使用明确的编辑入口。",
        "basis": "editorial"
      }
    ],
    "rules": [
      {
        "when": "按 Escape 或取消",
        "instruction": "恢复原值并把焦点送回编辑入口。",
        "strength": "must",
        "basis": "editorial"
      },
      {
        "when": "保存失败",
        "instruction": "保留草稿并说明修复方法。",
        "strength": "must",
        "basis": "editorial"
      }
    ],
    "requirements": [
      {
        "fact": "short_field",
        "value": true,
        "reason": "本词条样例面向短字段；长表单应另评估编辑流程。"
      }
    ],
    "behavior": {
      "states": [
        "read",
        "edit",
        "error",
        "saved",
        "cancelled"
      ],
      "a11y": [
        "编辑入口有名称",
        "进入编辑后聚焦输入，退出后恢复"
      ],
      "motion": "无"
    },
    "demo": "inline-edit",
    "version": "0.1.0",
    "editorialStatus": "sample-reviewed",
    "demoCapabilities": [
      "keyboard",
      "reduced_motion"
    ],
    "implementationNote": "能力标签只描述本演示；应用到产品时仍须重新验证。",
    "searchTerms": [
      "editing",
      "save",
      "cancel",
      "text",
      "non-modal"
    ]
  }
}