Proposal: high-level message-list action API
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Cần làm rõ
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- javascript
Hướng nghiên cứu
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.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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.
- Ngôn ngữ chính
- JavaScript
- Star
- 33
- Fork
- 18
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của thunderbird/webext-experiments
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
-
Proposal: narrowly scoped account order APICó thể đã có người làm Có pull request liên kết đang mở hoặc đã được merge. Đang mở
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 55/100
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 20/100
thunderbird/webext-experiments#61 · 2 bình luận ·
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
thunderbird/webext-experiments#60 · 1 bình luận ·
Tất cả issue của thunderbird/webext-experiments
Issue tương tự
-
Edit: Hello TasteĐang mởchannels:edit check:passed
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 67/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
Maintainer thường phản hồi trong vòng 2 ngày
-
bug
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
hiero-ledger/hiero-sdk-js#4793 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
addyosmani/agent-skills#802 ·
Maintainer thường phản hồi trong vòng 4 ngày
-
26.04 bug dark-mode Easy Hack impress symptom: visual
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
CollaboraOnline/online#16421 · 1 bình luận ·