Proposal: high-level message-list action API
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 25/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Da chiarire
- Stato di attività
- Attiva
- Stack tecnologico
- javascript
Direzione di ricerca
Start with the proposed MessageListAction API shape and the separately prepared prototype. Work through the six design questions with maintainers before defining implementation scope; done means the API boundary, lifecycle, state model, and message identifier path have an agreed direction.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Proposal: high-level message-list action API
Problem
Thunderbird WebExtensions can interact with messages through standard APIs and can add context-menu entries, toolbar/action buttons and message-display UI. There is currently no standard high-level entry point for an extension-owned action attached directly to each visible message row in the thread pane.
Some add-ons therefore use privileged Experiments to manipulate about:3pane DOM structures directly. That couples add-ons to Thunderbird internals and makes review and long-term compatibility difficult.
Proposed capability
Add a reusable MessageListAction Experiment draft that lets an extension:
- register one message-list action with a title and extension icon;
- provide ephemeral per-message presentation state (
visible,enabled,active, optional title override); - receive a WebExtension event when the user invokes the action;
- receive standard WebExtension message/tab objects rather than Thunderbird internals.
The implementation would own all thread-pane DOM integration. Extensions would not receive DOM nodes, gDBView, message headers, folder URIs or native message keys.
Example uses
- follow-up / reminder extensions;
- CRM or ticket-linking extensions;
- bookmarking / triage tools;
- task integrations;
- custom message-state workflows.
Proposed shape
await browser.MessageListAction.register({
title: "Track message",
icons: {"16": "icons/track-16.svg", "32": "icons/track-32.svg"}
});
await browser.MessageListAction.setState(message.id, {
active: true,
title: "Stop tracking message"
});
browser.MessageListAction.onClicked.addListener((message, tab) => {
// Extension business logic.
});
Additional methods proposed for discussion:
update(details)unregister()clearState(messageId)clearAllStates()
Design principles
The API is deliberately high-level and narrow. It does not expose arbitrary message-list customization, custom columns, raw DOM injection, XUL, internal message keys, persistence, or application-specific concepts.
The Experiment owns lifecycle cleanup. Presentation state is ephemeral; persistent state remains the extension's responsibility.
Questions for maintainers
- Is a dedicated row action an acceptable stable UI primitive for the message list?
- Should the namespace follow an existing action API naming pattern instead of
MessageListAction? - Should the first draft support one action per extension or a collection of actions?
- Should state be push-based (
setState) or requested lazily through an event/callback when rows render? - Which message identifier/conversion path should the Experiment use so the public boundary remains aligned with the standard
messagesAPI? - Should this be explored as a core API directly rather than maintained as a longer-lived Experiment?
Prototype
A minimal schema/sample/prototype implementation has been prepared separately. It intentionally keeps application logic outside the Experiment and can be reshaped based on this design discussion before a PR is opened.
- Lingua principale
- JavaScript
- Stelle
- 33
- Fork
- 18
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Nessun modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di thunderbird/webext-experiments
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
-
Proposal: narrowly scoped account order APIForse già presa Una pull request collegata a questa issue è aperta o già unita. Aperta
Difficoltà 5/5 Più di una settimana Idoneità per principianti 25/100
-
Difficoltà 3/5 1-2 giorni Idoneità per principianti 55/100
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 20/100
thunderbird/webext-experiments#61 · 2 commenti ·
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 25/100
thunderbird/webext-experiments#60 · 1 commento ·
Tutte le issue di thunderbird/webext-experiments
Issue simili
-
Edit: Hello TasteApertachannels:edit check:passed
Difficoltà 2/5 1-3 ore Idoneità per principianti 67/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
I maintainer di solito rispondono entro 2 giorni
-
bug
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
hiero-ledger/hiero-sdk-js#4793 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
addyosmani/agent-skills#802 ·
I maintainer di solito rispondono entro 4 giorni
-
26.04 bug dark-mode Easy Hack impress symptom: visual
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
CollaboraOnline/online#16421 · 1 commento ·