浮层与状态反馈
文档审阅帮助浮层

在文档审阅场景中完成帮助浮层：包含真实内容、可操作控件、清晰状态反馈和跨尺寸布局。
浮层与状态反馈帮助浮层HTMLCSSJavaScript
启用 JavaScript 后可编辑、运行和保存此案例。固定源码如下：
<!doctype html>
<html lang="zh-Hans" dir="ltr">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>文档审阅帮助浮层</title>
  <style>
    :root { --ink:#24213a; --paper:#f6f1e8; --accent:#e6a23c; --secondary:#a8a1d8; --line:color-mix(in srgb, var(--ink) 18%, transparent); --shadow:0 24px 60px color-mix(in srgb, var(--ink) 16%, transparent); color-scheme:light; }
    * { box-sizing:border-box; }
    html { min-width:320px; background:var(--paper); }
    body { min-height:100vh; margin:0; overflow-x:hidden; color:var(--ink); font-family:"Songti SC","Noto Serif SC",Georgia,serif; background:linear-gradient(90deg,transparent 49.7%,color-mix(in srgb,var(--ink) 7%,transparent) 50%,transparent 50.3%),var(--paper); }
    button,input,select,textarea { color:inherit; font:inherit; }
    button,[role="button"],input,select,textarea { accent-color:var(--accent); }
    button { cursor:pointer; }
    button:focus-visible,input:focus-visible,select:focus-visible,textarea:focus-visible,[tabindex]:focus-visible { outline:3px solid var(--accent); outline-offset:3px; }
    [hidden] { display:none !important; }
    @media (max-width:700px) { .mast h1 { line-height:1.08 !important; letter-spacing:-.035em !important; overflow-wrap:anywhere; } }
    @media (prefers-reduced-motion:reduce) { *,*::before,*::after { scroll-behavior:auto !important; animation-duration:.01ms !important; animation-iteration-count:1 !important; transition-duration:.01ms !important; } }
    .page{width:min(1180px,calc(100% - 40px));margin:auto;padding:7vw 0}.mast{display:grid;grid-template-columns:minmax(0,1.6fr) minmax(180px,.4fr);gap:5vw;align-items:end;margin-bottom:38px}.mast h1{font-family:"Songti SC",Georgia,serif;font-weight:800;font-size:clamp(42px,9vw,92px);max-width:920px;margin:0;line-height:.94}.eyebrow{display:block;margin-bottom:14px;color:var(--accent);font:800 11px/1 ui-monospace,monospace;letter-spacing:.24em}.intro{max-width:58ch;line-height:1.9}.scenario{align-self:start;padding-top:10px;border-top:1px solid var(--ink);font-style:italic}.demo{border-radius:0;border-width:2px;box-shadow:14px 14px 0 color-mix(in srgb,var(--ink) 18%,transparent);position:relative;overflow:hidden;min-height:420px;padding:clamp(22px,4vw,48px);background:var(--paper)}@media(max-width:700px){.page{width:calc(100% - 22px);padding:26px 0}.mast{grid-template-columns:1fr}.demo{min-height:340px;padding:18px}}
    .panel{padding:24px;border-block:1px solid var(--ink);background:transparent}.stack{display:grid;gap:22px}.row{display:flex;flex-wrap:wrap;gap:16px}.action{padding:8px 0;border:0;border-bottom:1px solid currentColor;background:transparent;letter-spacing:.08em}.action.primary,.action.is-active{color:var(--accent);border-bottom-width:4px}.status{min-height:28px;margin-top:20px;font-style:italic}.metric{font-family:Didot,serif;font-size:clamp(38px,8vw,76px)}.muted{max-width:54ch;line-height:1.8}.meter{position:relative;height:3px;background:var(--line)}.meter>i{position:absolute;inset:0 auto 0 0;background:var(--accent)}.chip{padding-bottom:3px;border-bottom:1px solid var(--ink);font-size:13px}
    .composition-studio{display:grid;gap:14px}.studio-ruler{display:flex;justify-content:space-between;padding:0 4px;color:color-mix(in srgb,var(--ink) 55%,transparent);font:700 11px/1 ui-monospace,monospace;letter-spacing:.14em}.studio-ruler::before{content:"01 / WORKING PROTOTYPE"}.studio-ruler::after{content:"360 · 768 · 1440"}.composition-studio .demo::after{content:"";position:absolute;right:18px;bottom:18px;width:24px;height:24px;border-right:2px solid var(--accent);border-bottom:2px solid var(--accent);pointer-events:none}
    .help-popover-demo{position:relative;display:grid;grid-template-columns:1fr minmax(190px,.4fr);gap:18px;min-height:370px}.help-document{display:grid;align-content:center;gap:18px;padding:clamp(24px,5vw,54px);border:1px solid var(--line);border-radius:24px;background:var(--paper)}.help-document h2{margin:0;font-size:clamp(32px,6vw,62px)}.help-setting{display:grid;grid-template-columns:1fr auto auto;gap:14px;align-items:center;padding:16px;border:1px solid var(--line);border-radius:14px}.help-setting small{display:block;margin-top:5px;opacity:.65}.help-setting>button{padding:8px;border:0;border-bottom:1px solid currentColor;background:transparent}.help-toggle{position:relative}.help-toggle input{position:absolute;opacity:0}.help-toggle span{display:block;width:45px;height:26px;padding:3px;border-radius:999px;background:var(--line)}.help-toggle span::after{content:"";display:block;width:20px;height:20px;border-radius:50%;background:var(--paper);transition:transform .18s}.help-toggle input:checked+span{background:var(--accent)}.help-toggle input:checked+span::after{transform:translateX(19px)}.help-toggle input:focus-visible+span{outline:3px solid var(--accent);outline-offset:3px}.help-popover{width:min(360px,calc(100% - 24px));padding:20px;border:1px solid var(--line);border-radius:18px;color:var(--ink);background:var(--paper);box-shadow:0 22px 55px #0004}.help-popover header{display:flex;justify-content:space-between;align-items:center;font:800 10px/1 ui-monospace,monospace;letter-spacing:.15em}.help-popover header button{width:34px;height:34px;border:0;border-radius:50%;background:var(--line)}.help-popover a{color:var(--accent);font-weight:900}.help-tip{display:grid;place-content:center;gap:16px;padding:22px;border-radius:24px;color:var(--paper);background:var(--ink)}.help-tip>span{display:grid;width:56px;height:56px;place-items:center;border:1px solid currentColor;border-radius:50%;font-size:28px}@media(max-width:650px){.help-popover-demo{grid-template-columns:1fr}.help-setting{grid-template-columns:1fr auto}.help-setting>button{grid-row:2}.help-tip{min-height:170px}}.workflow-dispatch{display:grid;grid-template-columns:minmax(210px,.48fr) minmax(0,1.52fr);gap:18px}.dispatch-console{display:grid;align-content:start;gap:16px;padding:22px;border:1px solid var(--line);border-radius:18px;background:color-mix(in srgb,var(--secondary) 12%,var(--paper))}.dispatch-console h2{margin:.2em 0}.dispatch-console form,.dispatch-console label{display:grid;gap:7px}.dispatch-console input,.dispatch-console select{min-width:0;width:100%;padding:10px;border:1px solid var(--line);border-radius:8px;background:var(--paper)}.dispatch-console fieldset{display:flex;gap:12px;border:1px solid var(--line);border-radius:10px}.dispatch-console fieldset label{display:flex;align-items:center}.dispatch-workbench{--dispatch-load:.22;min-width:0;padding:14px;border-left:8px solid color-mix(in srgb,var(--accent) calc(var(--dispatch-load)*100%),var(--line));background:linear-gradient(90deg,color-mix(in srgb,var(--accent) 8%,transparent),transparent 28%)}.dispatch-workbench[data-dispatch-priority="urgent"]{box-shadow:inset 0 0 0 2px var(--accent)}@media(max-width:900px){.workflow-dispatch{grid-template-columns:1fr}.dispatch-console{order:2}}
  </style>
</head>
<body data-aesthetic="editorial" data-composition="studio">
  <main class="page">
    <header class="mast"><div><span class="eyebrow">editorial / 帮助浮层 / INTERMEDIATE</span><h1>文档审阅帮助浮层</h1><p class="intro">在文档审阅场景中完成帮助浮层：包含真实内容、可操作控件、清晰状态反馈和跨尺寸布局。</p></div><span class="scenario">文档审阅</span></header>
    <div class="composition-studio"><div class="studio-ruler" aria-hidden="true"></div><section class="demo" aria-label="文档审阅帮助浮层交互区域"><div class="workflow-dispatch"><aside class="dispatch-console"><span class="eyebrow">文档审阅 DISPATCH</span><h2>审阅队列调度台</h2><form id="workflowDispatchForm"><label>任务类型<select id="workflowDispatchKind"><option>文字修改</option><option>结构建议</option><option>发布确认</option></select></label><label>待审数量<input id="workflowDispatchAmount" type="number" min="1" max="9999" value="27"><span>条</span></label><fieldset><legend>处理优先级</legend><label><input type="radio" name="workflowPriority" value="normal" checked>常规</label><label><input type="radio" name="workflowPriority" value="urgent">紧急</label></fieldset><button class="action primary" type="submit">提交审阅</button></form><label>当前任务<select id="workflowDispatchActive" aria-label="切换当前任务"><option value="1">文字修改</option><option value="2">结构建议</option></select></label><output id="workflowDispatchSummary">等待调度</output></aside><section id="workflowCore" class="workflow-core dispatch-workbench" data-dispatch-priority="normal"><!-- 11DZ_CORE_START:overlays-feedback-help-popover --><section class="help-popover-demo"><div class="help-document"><span class="eyebrow">HELP POPOVER</span><h2>文档审阅设置说明</h2><p>帮助内容由触发按钮就地打开，不阻断当前任务。</p><div class="help-setting"><div><strong>文档审阅计划</strong><small>保留最近一次配置</small></div><button id="helpPopoverTrigger" type="button" aria-expanded="false" aria-controls="helpPopover" data-core-bridge="overlays-feedback-help-popover">这是什么？</button><label class="help-toggle"><input type="checkbox" checked aria-label="启用文档审阅计划"><span aria-hidden="true"></span></label></div></div><div id="helpPopover" class="help-popover" popover role="note"><header><span>QUICK HELP</span><button id="helpPopoverClose" type="button" aria-label="关闭帮助">×</button></header><h3>文档审阅计划</h3><p>启用后只会在当前浏览器中保存偏好，不会发出网络请求。</p><a href="#help-detail">查看完整说明</a></div><aside class="help-tip"><span aria-hidden="true">?</span><p>支持 Popover API；旧浏览器自动回退到可切换面板。</p></aside></section><!-- 11DZ_CORE_END --></section></div><p id="status" class="status" role="status" aria-live="polite"></p></section></div>
  </main>
  <script>
    'use strict';
    const statusOutput = document.querySelector('#status');
    const announce = message => { statusOutput.textContent = message; };
    /* 11DZ_CORE_SCRIPT_START:overlays-feedback-help-popover */
const helpPopover=document.querySelector('#helpPopover');const helpPopoverTrigger=document.querySelector('#helpPopoverTrigger');const helpPopoverClose=document.querySelector('#helpPopoverClose');const supportsPopover=typeof helpPopover.showPopover==='function';helpPopover.hidden=!supportsPopover;function helpIsOpen(){return supportsPopover?helpPopover.matches(':popover-open'):!helpPopover.hidden;}function setHelpPopover(open){if(supportsPopover){if(open&&!helpIsOpen())helpPopover.showPopover();if(!open&&helpIsOpen())helpPopover.hidePopover();}else helpPopover.hidden=!open;helpPopoverTrigger.setAttribute('aria-expanded',String(open));announce(open?'帮助浮层已展开':'帮助浮层已关闭');}helpPopoverTrigger.addEventListener('click',()=>setHelpPopover(!helpIsOpen()));helpPopoverClose.addEventListener('click',()=>{setHelpPopover(false);helpPopoverTrigger.focus();});helpPopover.addEventListener('toggle',event=>{helpPopoverTrigger.setAttribute('aria-expanded',String(event.newState==='open'));});document.querySelector('.help-popover a').addEventListener('click',event=>{event.preventDefault();announce('已定位完整说明');});document.addEventListener('keydown',event=>{if(event.key==='Escape'&&helpIsOpen()){setHelpPopover(false);helpPopoverTrigger.focus();}});
/* 11DZ_CORE_SCRIPT_END */
const workflowBridgeSpec={"name":"overlays-feedback-help-popover","selector":"[data-core-bridge=\"overlays-feedback-help-popover\"]","mode":"click","key":"Enter"};const workflowBridgeCore=document.querySelector('#workflowCore');const workflowBridgeControl=workflowBridgeCore.querySelector(workflowBridgeSpec.selector);if(!workflowBridgeControl)throw new Error('Missing core bridge: '+workflowBridgeSpec.name);const workflowBridgeControlledId=workflowBridgeControl.getAttribute('aria-controls');const workflowBridgeControlled=workflowBridgeControlledId?document.getElementById(workflowBridgeControlledId):null;workflowBridgeCore.dataset.workflowBridge=workflowBridgeSpec.name;workflowBridgeCore.dataset.workflowVersion='0';function workflowBridgeSerialize(){const visualNode=workflowBridgeCore.firstElementChild||workflowBridgeCore;const visual=getComputedStyle(visualNode);const outputs=[...workflowBridgeCore.querySelectorAll('output,[role="status"],[aria-live],meter,progress')].map(node=>node.textContent.trim()+'|'+node.getAttribute('aria-valuenow')+'|'+node.getAttribute('value'));const canvas=[...workflowBridgeCore.querySelectorAll('canvas')].map(node=>{try{return node.toDataURL().slice(-160);}catch{return 'canvas-unavailable';}});return JSON.stringify({html:workflowBridgeCore.innerHTML,status:statusOutput.textContent,outputs,canvas,visual:[visual.display,visual.visibility,visual.opacity,visual.transform,visual.filter,visual.backgroundColor,visual.width,visual.height],scroll:workflowBridgeSpec.mode==='scroll'?workflowBridgeControl.scrollTop:null});}let workflowBridgeLastEffect=workflowBridgeSerialize();function workflowBridgeSummary(){const label=(workflowBridgeControl.getAttribute('aria-label')||workflowBridgeControl.textContent||workflowBridgeControl.value||workflowBridgeSpec.name).trim().replace(/\s+/g,' ').slice(0,72);return label+' · 核心版本 '+workflowBridgeCore.dataset.workflowVersion;}function workflowBridgeCommit(){const effect=workflowBridgeSerialize();if(effect===workflowBridgeLastEffect)return {changed:false,summary:workflowBridgeSummary()};workflowBridgeLastEffect=effect;workflowBridgeCore.dataset.workflowVersion=String(Number(workflowBridgeCore.dataset.workflowVersion||0)+1);return {changed:true,summary:workflowBridgeSummary()};}function workflowBridgeScheduleCommit(){queueMicrotask(workflowBridgeCommit);setTimeout(workflowBridgeCommit,0);}workflowBridgeControl.addEventListener("click",workflowBridgeScheduleCommit);const workflowBridgeStateTargets=new Set(workflowBridgeCore.querySelectorAll('dialog'));if(workflowBridgeControlled&&workflowBridgeCore.contains(workflowBridgeControlled))workflowBridgeStateTargets.add(workflowBridgeControlled);workflowBridgeStateTargets.forEach(target=>['close','cancel','toggle'].forEach(eventName=>target.addEventListener(eventName,workflowBridgeScheduleCommit)));function workflowBridgeActivate(){workflowBridgeControl.focus();workflowBridgeControl.click();const result=workflowBridgeCommit();setTimeout(workflowBridgeCommit,0);return result;}function workflowBridgeReset(){workflowBridgeCore.dataset.workflowVersion='0';workflowBridgeLastEffect=workflowBridgeSerialize();}
const workflowDispatchCore=document.querySelector('#workflowCore');const workflowDispatchForm=document.querySelector('#workflowDispatchForm');const workflowDispatchSelect=document.querySelector('#workflowDispatchActive');const workflowDispatchJobs=new Map([["1",{"label":"文字修改","amount":12,"priority":"normal","touches":0}],["2",{"label":"结构建议","amount":21,"priority":"urgent","touches":0}]]);let workflowDispatchSerial=workflowDispatchJobs.size;function workflowDispatchDrive(job,activate=false){workflowDispatchCore.dataset.dispatchPriority=job.priority;workflowDispatchCore.style.setProperty('--dispatch-load',Math.min(.95,.16+job.amount/120));const bridge=activate?workflowBridgeActivate():{changed:false,summary:workflowBridgeSummary()};document.querySelector('#workflowDispatchSummary').textContent=job.label+' · '+job.amount+' 条 · '+bridge.summary;announce('审阅队列当前任务：'+job.label);}function workflowDispatchRender(activeId,activate=false){workflowDispatchSelect.replaceChildren(...[...workflowDispatchJobs].map(([id,job])=>{const option=document.createElement('option');option.value=id;option.textContent=job.label+(job.priority==='urgent'?' · 紧急':'');return option;}));workflowDispatchSelect.value=activeId;workflowDispatchDrive(workflowDispatchJobs.get(activeId),activate);}workflowDispatchForm.addEventListener('submit',event=>{event.preventDefault();const data=new FormData(workflowDispatchForm);const id=String(++workflowDispatchSerial);workflowDispatchJobs.set(id,{label:document.querySelector('#workflowDispatchKind').value,amount:Math.max(1,Number(document.querySelector('#workflowDispatchAmount').value)||1),priority:data.get('workflowPriority'),touches:0});workflowDispatchRender(id,true);});workflowDispatchSelect.addEventListener('change',()=>workflowDispatchDrive(workflowDispatchJobs.get(workflowDispatchSelect.value),true));workflowDispatchCore.addEventListener('focusin',()=>{const job=workflowDispatchJobs.get(workflowDispatchSelect.value);if(!job)return;job.touches+=1;document.querySelector('#workflowDispatchSummary').textContent=job.label+' · '+job.amount+' 条 · '+workflowBridgeSummary();});workflowDispatchRender('1',false);
workflowBridgeReset();
  </script>
</body>
</html>