[{"data":1,"prerenderedAt":491},["ShallowReactive",2],{"learn-concept-/zh/learn/progressive-disclosure":3},{"id":4,"title":5,"body":6,"cardImage":431,"cardImageAlt":432,"date":433,"description":434,"domain":435,"domainKey":436,"extension":437,"featured":438,"fullName":439,"interaction":440,"maturity":441,"mentalModel":335,"meta":442,"navigation":443,"neighbors":444,"ogImage":475,"path":476,"published":443,"robots":475,"seo":477,"shortName":5,"sitemap":478,"socialImage":475,"socialImageAlt":475,"sources":479,"stem":485,"tags":486,"translationKey":440,"updated":433,"__hash__":490},"learnZh/zh/learn/progressive-disclosure.md","渐进披露",{"type":7,"value":8,"toc":417},"minimal",[9,12,16,23,26,31,34,37,40,46,50,53,64,67,70,83,86,90,93,145,148,152,155,158,170,173,176,182,185,192,199,203,220,224,244,247,283,286,328,331,351,354,374,378],[10,11,5],"h1",{"id":5},[13,14,15],"p",{},"一个功能丰富的产品很容易把所有能力同时倒在用户面前。每一项设置都可能合理，但它们一起出现时，最常见的任务反而更难开始。",[13,17,18,19],{},"Progressive Disclosure（渐进披露）提供了另一种安排复杂度的方法：",[20,21,22],"strong",{},"先给用户完成当前目标所需的最小完整界面，再随着意图和上下文逐层显露次要或高级选项。",[13,24,25],{},"它不是删除复杂度，而是决定复杂度什么时候出现。",[27,28,30],"h2",{"id":29},"相机的-auto-与-pro","相机的 Auto 与 Pro",[13,32,33],{},"拿起相机时，大多数人只需要构图和按快门。Auto 模式先替用户处理曝光、对焦和白平衡，因此第一秒就能完成拍照。",[13,35,36],{},"需要控制运动模糊时，可以进入更深一层调整快门速度；需要精确掌控时，再进入 Pro 模式控制光圈、快门与感光度。",[13,38,39],{},"专业能力没有消失，只是没有在第一次拍照之前向所有人收费。",[13,41,42,43],{},"但“这张照片会被永久删除”不能被藏进高级层。",[20,44,45],{},"低频不等于低重要性；风险和后果必须参与分层。",[27,47,49],{"id":48},"第一层要最小但必须完整","第一层要最小，但必须完整",[13,51,52],{},"假设用户只想导出一份报告。第一层可以是：",[54,55,61],"pre",{"className":56,"code":58,"language":59,"meta":60},[57],"language-text","文件名       quarterly-report\n格式         PDF（Portable Document Format，便携式文档格式）\n保存到       Downloads\n             [ 高级选项 ] [ 导出 ]\n","text","",[62,63,58],"code",{"__ignoreMap":60},[13,65,66],{},"用户不展开任何内容，也能完成最常见任务，并且知道结果是什么。第二层再放页面范围、图像质量与元数据；第三层放颜色配置、字体嵌入与压缩算法。",[13,68,69],{},"这三层分别回答：",[71,72,73,77,80],"ol",{},[74,75,76],"li",{},"我要完成什么？",[74,78,79],{},"结果需要怎样调整？",[74,81,82],{},"我要怎样控制底层实现？",[13,84,85],{},"如果第一层只有一个模糊按钮，而重要默认值全藏在后面，那不是渐进披露，而是隐藏决策。",[27,87,89],{"id":88},"怎样决定什么先出现","怎样决定什么先出现？",[13,91,92],{},"不要从“哪些控件可以折叠”开始。先为每项信息判断四个维度：",[94,95,96,109],"table",{},[97,98,99],"thead",{},[100,101,102,106],"tr",{},[103,104,105],"th",{},"维度",[103,107,108],{},"要问的问题",[110,111,112,121,129,137],"tbody",{},[100,113,114,118],{},[115,116,117],"td",{},"必要性",[115,119,120],{},"没有它，当前任务还能完成吗？",[100,122,123,126],{},[115,124,125],{},"频率",[115,127,128],{},"有多少用户、多少次任务会用到？",[100,130,131,134],{},[115,132,133],{},"风险",[115,135,136],{},"隐藏它会不会改变费用、权限、安全或不可逆后果？",[100,138,139,142],{},[115,140,141],{},"依赖",[115,143,144],{},"它是否只有在另一个选择出现后才有意义？",[13,146,147],{},"频繁、必需或高风险的信息通常留在第一层；低频、低风险且依赖特定意图的信息适合后置。",[27,149,151],{"id":150},"一个-artificial-intelligenceai人工智能agent-例子","一个 Artificial Intelligence（AI，人工智能）Agent 例子",[13,153,154],{},"AI Agent 的设置很容易堆满模型、工具、上下文、预算、记忆、运行环境和审批策略。",[13,156,157],{},"一个合理起点可能是：",[159,160,161,164,167],"ul",{},[74,162,163],{},"第一层：目标、输入和输出；",[74,165,166],{},"第二层：受众、语气、长度和允许使用的来源；",[74,168,169],{},"第三层：模型、重试、预算和工具配置。",[13,171,172],{},"但 Tool access（工具权限）、外部写入、费用上限和破坏性操作属于高风险后果。即使低频，也应该在执行前明确显示或确认，不能因为“这是高级设置”就藏起来。",[13,174,175],{},"所以真实的分层不只是新手对专家，而是：",[54,177,180],{"className":178,"code":179,"language":59,"meta":60},[57],"披露层级 = 任务相关性 × 使用频率 × 选项依赖 × 行为后果\n",[62,181,179],{"__ignoreMap":60},[27,183,184],{"id":184},"入口本身也是设计",[13,186,187,188,191],{},"“显示格式设置”比孤立的 ",[62,189,190],{},"+"," 或三点图标更容易形成正确预期。披露入口应该靠近它控制的内容，并说明将出现什么。",[13,193,194,195,198],{},"在网页里，Disclosure（披露控件）通常由一个按钮和一块受控内容组成。WAI-ARIA（Web Accessibility Initiative – Accessible Rich Internet Applications，Web 无障碍倡议—无障碍富互联网应用）Authoring Practices Guide 建议使用真正的按钮，用 ",[62,196,197],{},"aria-expanded"," 暴露状态，让 Enter 与 Space 都能切换，并且不要只靠 hover。",[27,200,202],{"id":201},"什么时候适合","什么时候适合？",[159,204,205,208,211,214,217],{},[74,206,207],{},"功能很多，但常见任务只需要一个稳定子集；",[74,209,210],{},"选项有自然依赖，例如打开“自定义压缩”后才需要压缩率；",[74,212,213],{},"新手需要快速进入，专家仍需要完整控制；",[74,215,216],{},"移动端、侧栏或属性面板的空间有限；",[74,218,219],{},"详细信息有价值，但不是每个人每次都要读。",[27,221,223],{"id":222},"什么时候会变坏","什么时候会变坏？",[159,225,226,229,232,235,238,241],{},[74,227,228],{},"用户需要同时比较价格、权限或方案，却必须逐个展开；",[74,230,231],{},"总价、自动续费、删除后果或公开范围被藏起来；",[74,233,234],{},"两行说明也做成折叠区，白白增加一次操作；",[74,236,237],{},"专家每次都要打开相同区域；",[74,239,240],{},"隐藏内容无法被快速扫描、查找或打印；",[74,242,243],{},"入口标签含糊，用户根本不知道功能存在。",[13,245,246],{},"常见失败包括：",[159,248,249,259,265,271,277],{},[74,250,251,254,255,258],{},[20,252,253],{},"点击隧道："," ",[62,256,257],{},"More → Advanced → Customize → Details"," 才找到常用设置；",[74,260,261,264],{},[20,262,263],{},"神秘入口："," 只有一个不知道会打开什么的图标；",[74,266,267,270],{},[20,268,269],{},"隐藏风险："," 用视觉简洁掩盖费用、权限或不可逆后果；",[74,272,273,276],{},[20,274,275],{},"状态失忆："," 每次都忘记专家的展开选择，或折叠时清空输入；",[74,278,279,282],{},[20,280,281],{},"隐藏依赖："," 第一层结果受隐藏默认值影响，却没有任何摘要。",[27,284,285],{"id":285},"看清概念邻居",[159,287,288,298,304,310,316,322],{},[74,289,290,293,294,297],{},[20,291,292],{},"Disclosure Widget（披露控件）是实现机制。"," 按钮、三角形、",[62,295,296],{},"details/summary"," 或 Accordion（手风琴）负责显示和隐藏；渐进披露是决定为什么、何时、披露什么的策略。",[74,299,300,303],{},[20,301,302],{},"Contextual Disclosure（情境披露）是触发变体。"," 勾选 “Schedule” 后出现日期与时区，内容随着状态变得相关。",[74,305,306,309],{},[20,307,308],{},"Staged Disclosure（分阶段披露）是流程变体。"," 把内容放进连续步骤或 Wizard（向导），更强调任务顺序。",[74,311,312,315],{},[20,313,314],{},"Information Architecture（信息架构）是结构基础。"," 它负责分类、命名与连接；错误分类不会因为折叠动画而变好。",[74,317,318,321],{},[20,319,320],{},"Defaults（默认值）是决策捷径。"," 它让第一层可以直接工作，但隐藏默认值也可能制造意外。",[74,323,324,327],{},[20,325,326],{},"Feature Gating（功能门控）是访问策略。"," 它决定能不能用；渐进披露通常只改变什么时候看见。",[27,329,330],{"id":330},"记住这六件事",[71,332,333,336,339,342,345,348],{},[74,334,335],{},"复杂度不要被删除，而要按用户意图分期支付。",[74,337,338],{},"第一层必须最小但完整：任务能完成，结果看得见。",[74,340,341],{},"分层同时考虑必要性、频率、依赖与后果。",[74,343,344],{},"低频风险不能为了简洁被藏起来。",[74,346,347],{},"披露控件是机制，渐进披露是策略。",[74,349,350],{},"如果用户总在找、总在展开或总被隐藏默认值惊讶，分层就失败了。",[27,352,353],{"id":353},"自测",[71,355,356,359,362,365,368,371],{},[74,357,358],{},"用户不展开任何内容，能否完成最常见任务并预测结果？",[74,360,361],{},"哪些信息虽然低频，却因为费用、权限或不可逆性必须一直可见？",[74,363,364],{},"触发器是否说明将出现什么？",[74,366,367],{},"第二层是否增加新的决策价值？",[74,369,370],{},"键盘和辅助技术能否感知展开状态？",[74,372,373],{},"专家是否总在重复打开同一层？",[27,375,377],{"id":376},"further-reading","Further reading",[159,379,380,389,396,403,410],{},[74,381,382],{},[383,384,388],"a",{"href":385,"rel":386},"https://developer.apple.com/design/human-interface-guidelines/disclosure-controls",[387],"nofollow","Apple Human Interface Guidelines · Disclosure controls",[74,390,391],{},[383,392,395],{"href":393,"rel":394},"https://www.ibm.com/docs/en/technical-content?topic=practices-progressive-disclosure",[387],"IBM Documentation · Progressive Disclosure",[74,397,398],{},[383,399,402],{"href":400,"rel":401},"https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/",[387],"W3C WAI-ARIA Authoring Practices Guide · Disclosure Pattern",[74,404,405],{},[383,406,409],{"href":407,"rel":408},"https://carbondesignsystem.com/components/accordion/usage/",[387],"Carbon Design System · Accordion usage",[74,411,412],{},[383,413,416],{"href":414,"rel":415},"https://doi.org/10.1177/001872088402600402",[387],"Carroll & Carrithers (1984) · Blocking learner error states in a training-wheels system",{"title":60,"searchDepth":418,"depth":418,"links":419},2,[420,421,422,423,424,425,426,427,428,429,430],{"id":29,"depth":418,"text":30},{"id":48,"depth":418,"text":49},{"id":88,"depth":418,"text":89},{"id":150,"depth":418,"text":151},{"id":184,"depth":418,"text":184},{"id":201,"depth":418,"text":202},{"id":222,"depth":418,"text":223},{"id":285,"depth":418,"text":285},{"id":330,"depth":418,"text":330},{"id":353,"depth":418,"text":353},{"id":376,"depth":418,"text":377},"/learn-img/progressive-disclosure/card-4x5.jpg","三层纸艺界面分别标注“必要”“情境”和“专家”，表示选项随着用户意图加深而逐层显露。","2026-07-17","先给用户完成当前目标所需的最小完整界面，再随着意图与上下文逐层显露复杂度。","交互设计","interaction-design","md",false,"Progressive Disclosure · 渐进披露","progressive-disclosure","growing",{},true,[445,450,455,460,465,470],{"name":446,"fullName":447,"category":448,"summary":449},"Disclosure Widget","Disclosure Widget · 披露控件","实现机制","负责显示或隐藏内容；渐进披露则决定什么内容应该在什么时候出现。",{"name":451,"fullName":452,"category":453,"summary":454},"Contextual Disclosure","Contextual Disclosure · 情境披露","触发变体","当用户选择或环境变化使某项内容相关时，才在原地显露它。",{"name":456,"fullName":457,"category":458,"summary":459},"Staged Disclosure","Staged Disclosure · 分阶段披露","流程变体","把信息分布在连续步骤或页面中，更强调顺序和阶段转换。",{"name":461,"fullName":462,"category":463,"summary":464},"Information Architecture","Information Architecture · 信息架构","结构基础","决定信息怎样分类与连接；渐进披露决定一次交互中哪一层先出现。",{"name":466,"fullName":467,"category":468,"summary":469},"Defaults","Defaults · 默认值","决策捷径","预先选择常见答案，让第一层可以完整工作；隐藏默认值也可能制造意外。",{"name":471,"fullName":472,"category":473,"summary":474},"Feature Gating","Feature Gating · 功能门控","访问策略","决定用户是否有权使用功能；渐进披露通常只改变功能何时可见。",null,"/zh/learn/progressive-disclosure",{"title":5,"description":434},{"loc":476},[480,481,482,483,484],{"title":388,"url":385},{"title":395,"url":393},{"title":402,"url":400},{"title":409,"url":407},{"title":416,"url":414},"zh/learn/progressive-disclosure",[435,487,488,489],"复杂度","信息架构","可发现性","0Gs0DuwVRbuXEfIETGOdV2BisxGJ1saoq9KSSbc0aGs",1785418435121]