Exclusivobeta

Posting As <mv-posting-as>

Proteção de identidade para editores e áreas de ação em apps com várias contas (marca vs pessoal, caixa de e-mail compartilhada vs você mesmo, personificação, espaços de trabalho de clientes, produção vs sandbox): ela torna inconfundível, no momento de agir, a identidade com a qual você está prestes a agir. A identidade vem escrita no próprio botão de ação (“Post as @AcmeCorp”, com o avatar, também no nome acessível), a moldura assume a cor dessa identidade e um padrão (listras, pontos, hachura cruzada, grade), com o tipo de conta por extenso, e um seletor no cabeçalho (listbox) troca de identidade no meio do rascunho sem perder o texto. Regras de proteção pegam os momentos em que você age como uma identidade achando que é a outra: uma voz pessoal em uma conta de organização (primeira pessoa, gírias informais ou marcas como hashtags que pertencem a outra identidade, com um “Switch to Maya Chen” em um clique), uma identidade trocada depois de o rascunho ter começado, uma conta que você nunca usou ou que costuma ser operada por colegas, além das suas próprias regras. Identidades de alto risco (marca, personificação, produção por padrão) e qualquer aviso em aberto exigem uma confirmação em uma etapa ou um pressionar e segurar; mv-act é cancelável e waitUntil(promise) mostra um estado pendente e mantém o rascunho em caso de falha. Cada ação abre então uma janela para desfazer ligada à identidade usada (“Posted as @AcmeCorp · Undo”), e a identidade escolhida pode ser lembrada por contexto (por conversa, por canal, por cliente).

CategoriaFormulários
TipoWeb Component (<mv-posting-as>)
Statusbeta
KitConfiança e privacidade
Também instalabutton
Keywordsexclusive, culture, identity, multi-account, account, brand-account, shared-inbox, shared-mailbox, impersonation, view-as, workspace, agency, production, composer, send-as, post-as, guard, mismatch, confirm, hold-to-send, undo, remember

When to use

  • A social or community tool lets people post from brand accounts and their own account in the same composer
  • Agents reply from a shared mailbox or as themselves, and the choice should be remembered per thread
  • Support staff impersonate customers or act in a client's workspace and every write must show whose name it's under
  • A console deploys or runs commands in production and sandbox orgs, and production needs a deliberate hold

Avoid when

  • Users only need to see which environment the whole app runs in, not which identity a single action uses → use Env Marker instead
  • The action is irreversible and needs two people or two deliberate keys, whoever it's made as → use Two-Key instead
  • The app has one identity per user: a plain submit button and an account menu are enough → use Button instead

Instalação

node scripts/add.mjs posting-as --out ./src/marvelous

Agente de IA com o servidor MCP do Marvelous UI: install_components({ slugs: ["posting-as"], target_dir: "<absolute path>/src/marvelous", framework: "react" }).

Arquivos copiados (dependências incluídas): tokens/tokens.css, core/base.css, core/dismiss.js, core/dom.js, core/element.js, core/focus.js, core/motion.js, core/position.js, components/posting-as/posting-as.js, components/posting-as/posting-as.css, components/button/button.css.

Uso

Início rápido, a menor marcação que funciona:

<mv-posting-as verb="Reply">
  <data data-identity="priya" data-kind="work" data-handle="[email protected]">Priya Natarajan</data>
  <data data-identity="support" data-kind="shared" data-handle="[email protected]">Acme Support</data>
  <textarea aria-label="Reply text"></textarea>
</mv-posting-as>

Marcação de referência, para usar como ponto de partida e personalizar com atributos, data-* e variáveis CSS:

<div id="pa-demo" style="width:min(100%,58rem);margin-inline:auto">
  <style>
    #pa-demo { display:grid; gap:1.25rem; align-content:start }
    #pa-demo .pa-app { display:grid; gap:.875rem; padding:1rem; border:1px solid var(--mv-border); border-radius:var(--mv-radius-xl); background:var(--mv-bg-subtle) }
    #pa-demo .pa-top { display:flex; align-items:center; gap:.75rem; flex-wrap:wrap }
    #pa-demo .pa-title { display:grid; gap:.125rem; flex:1 1 16rem; min-width:0 }
    #pa-demo .pa-title strong { font-size:.9375rem; letter-spacing:-.01em }
    #pa-demo .pa-title span { color:var(--mv-fg-muted); font-size:.8125rem }
    #pa-demo .pa-row { display:grid; grid-template-columns:repeat(auto-fit,minmax(min(100%,24rem),1fr)); gap:1.25rem; align-items:start }
    #pa-demo .pa-controls { display:flex; align-items:center; justify-content:space-between; gap:.75rem 1rem; flex-wrap:wrap }
    #pa-demo .pa-log { margin:0; min-height:1.25rem; color:var(--mv-fg-muted); font:.75rem/1.4 var(--mv-font-mono); flex:1 1 18rem }
    #pa-demo .pa-actions { display:flex; align-items:center; gap:.5rem; flex-wrap:wrap }
    #pa-demo .mv-choice { font-size:.8125rem }
    #pa-demo .pa-threads { display:flex; gap:.375rem; flex-wrap:wrap }
    #pa-demo .pa-thread[aria-pressed="true"] { background:var(--mv-bg-emphasis); border-color:var(--mv-border-strong) }
    #pa-demo .pa-quote { margin:0; padding:.625rem .75rem; border-left:3px solid var(--mv-border-strong); border-radius:var(--mv-radius-sm); background:var(--mv-surface); color:var(--mv-fg-muted); font-size:.8125rem; line-height:1.5 }
    #pa-demo .pa-quote b { color:var(--mv-fg); font-weight:600 }
    #pa-demo input[data-posting-as-field] { min-height:0; padding-block:.875rem }
  </style>

  <!-- 1 · Social publishing: a personal-sounding draft on the brand account -->
  <section class="pa-app" aria-label="Social publishing">
    <div class="pa-top">
      <span class="pa-title">
        <strong>Launch week queue</strong>
        <span>Three accounts share this composer. The draft below reads like Maya, but it’s about to go out as the brand.</span>
      </span>
      <span class="mv-badge" data-variant="secondary">4 scheduled</span>
    </div>

    <mv-posting-as id="pa-social" value="acme" verb="Post">
      <data data-identity="acme" data-kind="brand" data-handle="@AcmeCorp" data-markers="#AcmeLaunch, our customers, our team, we’re hiring" data-last-self="2026-06-18" data-last-others="0">Acme Corp</data>
      <data data-identity="maya" data-kind="personal" data-handle="@mayachen" data-markers="#weekendvibes, #trailrunning, my kid">Maya Chen</data>
      <data data-identity="help" data-kind="shared" data-handle="@AcmeHelp" data-markers="#AcmeStatus, ticket" data-last-self="2026-02-09" data-last-others="12">Acme Support</data>
      <span slot="context">Scheduled for Oct 7, 9:00 AM</span>
      <textarea data-posting-as-field aria-label="Post text" rows="3" placeholder="Write a post…">Finally ran my first trail half marathon this morning, legs are toast lol #trailrunning #weekendvibes</textarea>
      <button slot="actions" type="button" class="mv-button" data-variant="ghost" data-size="icon" aria-label="Add image"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="4" width="18" height="16" rx="2"/><circle cx="9" cy="10" r="2"/><path d="m21 16-5-5-9 9"/></svg></button>
      <button slot="actions" type="button" class="mv-button" data-variant="ghost" data-size="icon" aria-label="Add link"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 14a4 4 0 0 0 5.7 0l3-3a4 4 0 0 0-5.7-5.7l-1 1"/><path d="M14 10a4 4 0 0 0-5.7 0l-3 3a4 4 0 0 0 5.7 5.7l1-1"/></svg></button>
    </mv-posting-as>

    <div class="pa-controls">
      <p class="pa-log" id="pa-log" aria-live="polite">Brand draft loaded.</p>
      <span class="pa-actions">
        <label class="mv-choice"><input type="checkbox" role="switch" class="mv-switch" id="pa-hold"> Hold to post on high-stakes accounts</label>
        <button type="button" class="mv-button" data-variant="outline" data-size="sm" id="pa-reset">Reset draft</button>
      </span>
    </div>
  </section>

  <div class="pa-row">
    <!-- 2 · Shared inbox: the identity is remembered per thread -->
    <section class="pa-app" aria-label="Support inbox">
      <div class="pa-top">
        <span class="pa-title">
          <strong>Support inbox</strong>
          <span>Each thread remembers who you reply as.</span>
        </span>
        <span class="pa-threads" role="group" aria-label="Thread">
          <button type="button" class="mv-button pa-thread" data-variant="outline" data-size="sm" data-thread="2231" aria-pressed="true">#2231</button>
          <button type="button" class="mv-button pa-thread" data-variant="outline" data-size="sm" data-thread="2232" aria-pressed="false">#2232</button>
        </span>
      </div>
      <p class="pa-quote" id="pa-quote"><b>Lucía Fernández</b> · Refund for order 88213 hasn’t shown up on my card yet. Can you check?</p>
      <mv-posting-as id="pa-inbox" verb="Reply" noun="reply">
        <data data-identity="priya" data-kind="work" data-kind-label="You" data-handle="[email protected]" data-last-self="2026-09-23">Priya Natarajan</data>
        <data data-identity="support" data-kind="shared" data-handle="[email protected]" data-last-self="2026-08-12" data-last-others="14">Acme Support</data>
        <textarea data-posting-as-field aria-label="Reply text" rows="2" placeholder="Write a reply…">Hi Lucía, the refund was issued on Sep 21 and usually takes 3 to 5 business days to appear.</textarea>
      </mv-posting-as>
    </section>

    <!-- 3 · Production deploy: hold to act as the high-stakes identity -->
    <section class="pa-app" aria-label="Deploy">
      <div class="pa-top">
        <span class="pa-title">
          <strong>Release v2.14.0</strong>
          <span>Production needs a deliberate hold; staging deploys on click.</span>
        </span>
      </div>
      <mv-posting-as id="pa-deploy" value="prod" verb="Deploy" noun="deploy" confirm="hold" hold="1.2s" guards="">
        <data data-identity="prod" data-kind="production" data-handle="acme-prod" data-initials="P">Production · us-east-1</data>
        <data data-identity="staging" data-kind="staging" data-kind-label="Staging" data-pattern="dots" data-tint="var(--mv-info)" data-handle="acme-staging" data-initials="S">Staging · us-east-1</data>
        <input data-posting-as-field type="text" aria-label="Release note" value="Checkout: retry declined cards once before failing">
      </mv-posting-as>
    </section>
  </div>

  <script type="module">
    const root = document.getElementById("pa-demo");
    const social = document.getElementById("pa-social");
    const inbox = document.getElementById("pa-inbox");
    const deploy = document.getElementById("pa-deploy");
    const log = document.getElementById("pa-log");
    const say = (text) => { log.textContent = text; };
    const DRAFT = "Finally ran my first trail half marathon this morning, legs are toast lol #trailrunning #weekendvibes";

    social.addEventListener("mv-identity-mismatch", (e) => say(`mv-identity-mismatch · ${e.detail.rule}: ${e.detail.title}`));
    social.addEventListener("mv-identity-change", (e) => say(`mv-identity-change · ${e.detail.previous?.handle} → ${e.detail.identity.handle} (${e.detail.reason}), draft kept`));
    social.addEventListener("mv-act", (e) => {
      say(`mv-act · publishing as ${e.detail.identity.handle}…`);
      // A fake publishing endpoint: 500 ms round trip.
      e.detail.waitUntil(new Promise((resolve) => setTimeout(resolve, 500)));
    });
    social.addEventListener("mv-undo", (e) => say(`mv-undo · post by ${e.detail.identity.handle} retracted`));
    social.addEventListener("mv-commit", (e) => say(`mv-commit · post by ${e.detail.identity.handle} is final`));

    const hold = document.getElementById("pa-hold");
    hold.addEventListener("change", () => { social.confirm = hold.checked ? "hold" : "step"; });
    document.getElementById("pa-reset").addEventListener("click", () => {
      social.value = "acme";
      const field = social.querySelector("[data-posting-as-field]");
      // Emptying the field first starts a fresh draft: dismissed warnings can show again.
      field.value = "";
      field.dispatchEvent(new Event("input", { bubbles: true }));
      field.value = DRAFT;
      field.dispatchEvent(new Event("input", { bubbles: true }));
      say("Brand draft loaded.");
    });

    // Inbox: one draft and one remembered identity per thread.
    const threads = {
      2231: { quote: ["Lucía Fernández", "Refund for order 88213 hasn’t shown up on my card yet. Can you check?"], draft: "Hi Lucía, the refund was issued on Sep 21 and usually takes 3 to 5 business days to appear.", as: "support" },
      2232: { quote: ["Kenji Watanabe", "Thanks for the quick call earlier, can you send me the deck you mentioned?"], draft: "Hi Kenji, great talking to you! Here’s the deck from our call.", as: "priya" },
    };
    try { for (const [id, t] of Object.entries(threads)) localStorage.setItem(`mv-posting-as:demo-inbox-${id}`, t.as); } catch {}
    const inboxField = inbox.querySelector("[data-posting-as-field]");
    const quote = document.getElementById("pa-quote");
    const openThread = (id) => {
      const t = threads[id];
      quote.replaceChildren(Object.assign(document.createElement("b"), { textContent: t.quote[0] }), ` · ${t.quote[1]}`);
      inboxField.value = t.draft;
      inbox.remember = `demo-inbox-${id}`;
      inboxField.dispatchEvent(new Event("input", { bubbles: true }));
      for (const b of root.querySelectorAll(".pa-thread")) b.setAttribute("aria-pressed", String(b.dataset.thread === id));
    };
    let current = "2231";
    inboxField.addEventListener("input", () => { threads[current].draft = inboxField.value; });
    for (const b of root.querySelectorAll(".pa-thread")) b.addEventListener("click", () => { current = b.dataset.thread; openThread(current); });
    customElements.whenDefined("mv-posting-as").then(() => openThread(current));

    deploy.addEventListener("mv-act", (e) => e.detail.waitUntil(new Promise((resolve) => setTimeout(resolve, 700))));
    deploy.addEventListener("mv-commit", () => {
      const f = deploy.querySelector("[data-posting-as-field]");
      if (!f.value) f.value = "Checkout: retry declined cards once before failing";
      f.dispatchEvent(new Event("input", { bubbles: true }));
    });
  </script>
</div>

Referência cultural

O Médico e o Monstro, Robert Louis Stevenson (1886, livro). Um homem vive como duas identidades, e o perigo está em agir como uma acreditando, ou fingindo, que é a outra. Na interface, a identidade com a qual você está prestes a agir vem escrita no próprio botão, dá cor e textura a todo o editor, e é questionada quando as palavras, o histórico do rascunho ou o passado da conta indicam que você é, na verdade, outra pessoa.

API

Attributes

NameTipoDefaultDescription
valuestringId of the identity you act as. Reflected by the component; setting it switches identity (reason "api", cancelable). A remembered choice wins over it at startup.
verbstringPostAction verb written on the button and in every message: Post, Reply, Send, Sign, Deploy, Run…
donestringPast tense used by the receipt and messages. Derived for common verbs (Posted, Replied, Sent, Deployed, Ran…), otherwise verb + "ed".
nounstringpostWhat an act produces, used by the history rule (“Teammates made the last 14 replies from support@…”).
confirmstep | holdstepHow high-stakes identities (and any open warning) are confirmed: step = the first press arms the button (“Confirm: post as @AcmeCorp”, a 5 s fuse drains, Escape cancels) and a second press acts; hold = press and hold the button (pointer, Space or Enter) until the fill completes.
holdtime ("1s", "800ms")1sHold duration in hold mode (clamped between 300 ms and 5 s).
undotime8sUndo window after each act. "0" shows the receipt for 4 s without Undo.
rememberstringContext key (per thread, channel, client…): the chosen identity is stored in localStorage under it and restored when the key is set again. Changing the key switches to that context's identity (reason "restore") and starts a fresh draft origin.
guardsspace-separated listvoice switch historyBuilt-in rules to run. voice: personal register on a "we" identity (first person singular, casual slang) or markers of another identity in the text. switch: the identity changed after the draft was started. history: first time acting as this identity, or teammates made the last 3+ acts. An empty value turns every built-in rule off (your rules still run).
allow-emptybooleanAllows acting with an empty field (default: the button is aria-disabled until the field has text).
keep-draftbooleanKeeps the text in the field after a successful act (default: the field is cleared and Undo restores it).
no-shortcutbooleanDisables Ctrl/⌘+Enter in the field (which goes through the same confirm step or moves focus to the button in hold mode).
data-identity (child)stringDeclares an identity: any direct child element carrying it (e.g. <data>), hidden by the component. Its text is the name; options as data-*: kind (personal | brand | shared | impersonating | client | production | work | any string), handle, avatar (image URL), initials, kind-label, tint (any CSS color), pattern (solid | stripes | dots | cross | grid), stakes (high | normal), confirm (step | hold | none), voice (we | me | any), markers (comma list of words, phrases, #tags or @handles typical of this identity), last-self (ISO date you last acted as it, or "never"), last-others (acts by teammates since), default.
data-posting-as-field (child)booleanMarks the field whose text is guarded and cleared (textarea, input or contenteditable) and gives it a borderless default style. Without it, the first text field inside is used.
data-kind / data-pattern / data-stakes / data-method / data-armed / data-pending / data-switchedstateSet on the element for styling: the current identity's kind, pattern and stakes, the confirm method in force (none | step | hold), armed (step confirm waiting), pending (waitUntil in flight), switched (one-shot, 700 ms after an identity change).

Properties

NameTipoDescription
identitiesArray<{ id, name, handle?, kind?, avatar?, initials?, kindLabel?, tint?, pattern?, stakes?, confirm?, voice?, markers?, lastSelf?, lastOthers?, default? }>Read the normalized identities, or set them from data instead of child markup (overrides the children).
identityobjectThe identity you currently act as (read-only copy).
noticesArray<{ rule, level, title, message, matches, suggest }>Open (not acknowledged) warnings (read-only).
rulesArray<(ctx) => notice | notice[] | null>Your own guards. ctx: { identity, identities, text, draftIdentity, verb }. Return { title, message, suggest? (identity id), level? ("warning" forces a confirm, "info" doesn't), id?, matches? }. Re-run on every edit (debounced) and identity change.
fieldElementThe guarded field (set it to point at a field that isn't the first one).
stringsPartial<Record<string, string>>Overrides for every visible text and announcement (act, actName, confirm, confirmName, hold, holdName, pending, voiceTitle, voiceText, markersTitle, markersText, switchedTitle, switchedText, firstTitle, firstText, othersTitle, othersText, errorTitle, errorText, switchTo, keep, receipt, undo, announce*…). Placeholders: {verb} {verbLower} {done} {doneLower} {name} {handle} {who} (handle + name) {kind} {kindLower} {nouns} {matches} {other}.
pending / armedbooleanRead-only state.
value / verb / done / noun / confirm / hold / undo / remember / guards / allowEmpty / keepDraft / noShortcutreflectedMirror the attributes.

Methods

NameDescription
switchTo(id)Switches identity and keeps the draft (emits the cancelable mv-identity-change with reason "api"). Returns false if refused or unknown.
submit()Acts now as the current identity, skipping the confirm step (for when your own UI already confirmed). Returns Promise<boolean>.
undoLast()Undoes the last act while its window is open (same as the Undo button).
evaluate()Re-runs the guards, e.g. after you updated an identity's history or your rules' inputs.
acknowledge(rule?)Acknowledges every open warning (or one rule's): they stay hidden for this draft and stop forcing a confirmation.
openSwitcher() / closeSwitcher()Opens or closes the identity listbox.

Events

NameDescription
mv-identity-changeBefore the identity changes. detail: { identity, previous, reason: "user" | "suggest" | "api" | "restore" | "undo", draft }. Cancelable except for "undo": preventDefault() keeps the current identity (and reverts value).
mv-identity-mismatchA guard raised a new warning (once per draft and warning). detail: { identity, rule: "voice" | "switch" | "history" | your rule, level, title, message, matches (the words that triggered it), suggest (identity or null) }.
mv-actCancelable, when the act is confirmed. detail: { identity, text, field, via: "click" | "confirm" | "hold" | "keyboard" | "api", notices, waitUntil(promise) }. Call waitUntil() synchronously with your request: the button shows “Posting as @AcmeCorp…” (aria-busy); a rejection keeps the draft and shows an error. preventDefault() cancels the act.
mv-act-errorA waitUntil promise rejected. detail: { identity, text, error }.
mv-undoCancelable, when Undo is chosen during the window. detail: { identity, text }. Retract the act here; the draft and the identity are restored.
mv-commitThe undo window ended without Undo: the act is final. detail: { identity, text }.

Content structure

NameDescription
(content)The app's field (textarea, input, contenteditable) and anything around it, left in place between the identity header and the footer.
actionsChildren with slot="actions" (attach, emoji, schedule buttons) are moved to the start of the footer.
contextChildren with slot="context" (channel, recipient, schedule) are moved to the end of the header.

CSS classes

NameDescription
mv-posting-as-head / -who / -name / -handle / -kind / -swatch / -contextHeader: the identity chip (button opening the listbox) with avatar, name, handle and the kind label with its pattern swatch.
mv-posting-as-list / -optionThe switcher (role=listbox, Popover API top layer when available), one option per identity with data-kind and data-pattern.
mv-posting-as-notices / -noticeWarnings (data-rule, data-level="warning | info | error"): -notice-icon, -notice-title, -notice-text, -notice-actions.
mv-posting-as-receipt“Posted as @AcmeCorp · 2:41 PM · Undo” with a draining -receipt-meter.
mv-posting-as-foot / -tools / -hint / -actFooter: your actions, the Ctrl+Enter hint and the act button (data-state="ready | armed | hold | pending", data-holding while pressed; -act-fill, -act-timer, -act-handle).
mv-posting-as-avatarImage or initials avatar (square for brand, client and production kinds; data-size="sm | xs").

CSS variables

NameDefaultDescription
--mv-posting-as-personal / -brand / -shared / -impersonating / -client / -production / -workfg-muted / accent / info / warning / success / danger / violetTint of each kind: frame outline, header texture, kind label, act button.
--mv-posting-as-tintSet by the component from an identity's data-tint (wins over its kind's tint).
--mv-posting-as-radiusvar(--mv-radius-xl)Frame corner radius.

Accessibility

The act button's accessible name always carries the identity: “Post as @AcmeCorp, Acme Corp, Brand account” (the visible label comes first, so voice control matches it); armed it becomes “Confirm: post as @AcmeCorp… Press again to post.”, in hold mode “Hold to post as…”, pending it is aria-busy, and it is aria-disabled (still focusable) while the field is empty. Open warnings are real text with a title, an icon and actions, and are linked to the button with aria-describedby, so they are read before acting; a new warning is announced once, politely. Kinds are never told by color alone: the kind is spelled out (“Brand account”, “Impersonating”) and drawn as a pattern (stripes, dots, cross-hatch, grid), which becomes a border style (double, dotted, dashed) in forced-colors mode. The header chip is a button with aria-haspopup="listbox" and aria-expanded (name: “Acting as Acme Corp @AcmeCorp Brand account. Change identity”); ArrowDown/Up, Enter or Space open the listbox with focus on the current option, Arrow keys, Home/End and typeahead move, Enter/Space choose, Escape closes and returns focus, Tab closes; options expose aria-selected and say when they need confirmation. Switching keeps the draft and announces “Now acting as Maya Chen, Personal. Your draft is kept.” Ctrl/⌘+Enter in the field follows the same confirm rules. Hold works with the pointer, Space or Enter held down; a click with no press behind it (assistive technology) falls back to the two-step confirm, so the action never depends on a timed gesture alone. Arming, cancel (Escape), acting, errors (assertive), undo availability and undo are announced in visually hidden live regions. The undo button is named “Undo: post as @AcmeCorp”; after Undo, focus returns to the restored draft. Reduced motion (OS or data-motion="reduce"): no switch ring, no slide-ins; the hold fill and the draining fuses remain as progress indicators.

Esta página foi traduzida com IA. Informar um problema de tradução