Web Editing Working Group Charter
This charter has been replaced by a newer version.
The mission of the Web Editing Working Group is to explore limitations in existing browser primitives, provide use cases for new APIs and suggest solutions either by standardizing of existing behaviors or introducing new APIs relevant for text editing. The goal is to facilitate the creation of fully-featured editing systems as well as small editors using JavaScript.
Start date | 10 June 2021 |
---|---|
End date | 09 September 2023 |
Chairs | Johannes Wilm (W3C Invited Expert) |
Team Contacts | Xiaoqian Wu (0.1 FTE) |
Meeting Schedule |
Teleconferences: Not more often than once per month.
Face-to-face: we will meet during the W3C's annual Technical Plenary week; additional face-to-face meetings may be scheduled by consent of the participants, usually no more than 3 times per year. |
Scope
Background
Enabling rich editing experience on the web is currently a challenging task. One of the reasons is lack of requirements in the behavior of the contenteditable attribute in HTML. Currently, it is the only browser primitive providing a rich editing surface to web developers. Also, there is a limited support for low-level editing APIs that would allow web developers to build rich editing experiences without getting browsers' interference in this process.
In Scope
The scope of Web Editing WG covers all aspects of text editing on the web, which may include:
- Textual input and text manipulation.
- Text editing related events.
- Selection.
- Clipboard.
- Undo.
- Spellcheck and grammar checking.
- DOM level manipulation of other elements inside of contenteditable elements.
- Revisiting of under-specified existing editing related features.
- Incubating features related to text editing that may eventually go under the scope of another WG, e.g. Highlight API.
Out of Scope
The following features are out of scope and will not be addressed by this Working group.
- Non DOM-based editing, e.g. canvas or media content.
- Editing of content other than text and text related content. For example, an image editor, a 3D modeler or a movie cutter would be out of scope.
Deliverables
More detailed milestones and updated publication schedules are available on the group publication status page.
Draft state indicates the state of the deliverable at the time of the charter approval. Expected completion indicates when the deliverable is projected to become a Recommendation, or otherwise reach a stable state.
Normative Specifications
The Working Group will deliver the following W3C normative specifications:
- Clipboard API and events
-
This document describes APIs for accessing data on the system clipboard. It provides operations for overriding the default clipboard actions (cut, copy and paste), and for directly accessing the clipboard contents.
Draft state: Working Draft
Expected completion: Q3 2022
-
Clipboard API and events
Latest publication: 3 February 2021 -
Latest publication: 3 February 2021
Reference Draft: https://www.w3.org/TR/2015/WD-clipboard-apis-20151215/
associated Call for Exclusion on 16 November 2006 ended on 14 April 2007
Produced under Web API Working Group charter
-
Clipboard API and events
- Input Events
-
This specification defines additions to events for text and related input to allow for the monitoring and manipulation of default browser behavior in the context of text editor applications and other applications that deal with text input and text formatting. This specification builds on the UI events spec.
Draft state: Working Draft
Expected completion: Q3 2022
-
Input Events
Latest publication: Draft 30 May 2019 -
Reference Draft: https://www.w3.org/TR/2016/WD-input-events-20160830/
associated Call for Exclusion on 30 August 2016 ended on 27 January 2017
Produced under Working Group Charter: https://www.w3.org/2015/10/webplatform-charter.html
-
Input Events
- Selection API
-
This document is a preliminary draft of a specification for the Selection API and selection related functionality. It replaces a couple of old sections of the HTML specification, the selection part of the old DOM Range specification.
This document defines APIs for selection, which allows users and authors to select a portion of a document or specify a point of interest for copy, paste, and other editing operations.
Draft state: Working Draft
Expected completion: Q3 2022
-
Selection API
Latest publication: 19 December 2020 -
Reference Draft: https://www.w3.org/TR/2015/WD-selection-api-20151124/
associated Call for Exclusion on 07 October 2014 ended on 06 March 2015
Produced under Web Applications Working Group charter
-
Selection API
Other Deliverables
Depending on the working group progress, the Group may also produce W3C Recommendations for the following documents:
- VirtualKeyboardAPI
-
Today on the web, User Agents respond to the presence of the virtual (software) keyboard, without any exposure of this information to the web page. This document proposes a new web API surface for virtual keyboards that developers can use to enable better customization of their webpage's content and experiences.
Draft state: Explainer.
- EditContextAPI
-
The EditContext is a new API that simplifies the process of integrating a web app with advanced text input methods, improves accessibility and performance, and unlocks new capabilities for web-based editors.
Draft state: Explainer.
- SpellcheckAPI
Draft state: No draft, see Minutes from Editing TF Fukuoka TPAC Meeting.
- Primer or Best Practice documents to support web developers when designing applications.
Draft state: No draft.
Timeline
All specifications produced by the Web Editing Working Group are expected to progress during this charter period. The charter does not include a detailed timeline for each specification because such information is speculative and easily becomes inaccurate. However, a rough estimation of completion is available in the detailed list of Deliverables when possible.
Success Criteria
In order to advance to Proposed Recommendation, each specification is expected to have at least two independent implementations of each feature defined in the specification.
Each specification should contain separate sections detailing all known security and privacy implications for implementers, Web authors, and end users.
Each specification must have an accompanying test suite, which is ideally developed in parallel to the specification.
Each specification should contain a section on accessibility that describes the benefits and impacts, including ways specification features can be used to address them, and recommendations for maximising accessibility in implementations.
To promote interoperability, all changes made to specifications should have tests where applicable.
Coordination
For all specifications, this Working Group will seek horizontal review for accessibility, internationalization, performance, privacy, and security with the relevant Working and Interest Groups, and with the TAG. Invitation for review must be issued during each major standards-track document transition, including FPWD. The Working Group is encouraged to engage collaboratively with the horizontal review groups throughout development of each specification. The Working Group is advised to seek a review at least 3 months before first entering CR and is encouraged to proactively notify the horizontal review groups when major changes occur in a specification following a review.
Additional technical coordination with the following Groups will be made, per the W3C Process Document:
W3C Groups
- WebApps Working Group
- Overlapping specifications such as UIEvents.
- CSS Working Group
- Overlapping specifications such as Highlight API.
- Accessible Platform Architectures (APA) Working Group
- Explore accessibility use cases and gap analysis and ensure new specifications provide needed accessibility features.
- Accessibility Guidelines Working Group
- The Accessibility Guidelines Working Group (AG WG) maintains the Authoring Tool Accessibility Guidelines (ATAG) 2.0, which provides guidelines for how authoring tools and environments can support accessibility for authors with disabilities, as well as promoting production of accessible content by all authors.
- Internationalization Working Group
- There are many internationalisation considerations regarding input, changing writing directions an language-specific punctuation and layout conventions, use of different keyboards and virtual keyboards, etc.
- Web Platform Incubator Community Group
- This group provides a lightweight venue for proposing, incubating, and discussing new web platform features. The Web Editing Working group can incubate and review new proposals that are within scope of our charter within the WICG. Once such WICG-incubated proposal is implemented and available in at least one major browser, and has support from one more, it may be adopted by the Web Editing Working group.
External Organizations
Participation
To be successful, this Working Group is expected to have 6 or more active participants for its duration, including representatives from the key implementors of this specification, and active Editors and Test Leads for each specification. The Chairs, specification Editors, and Test Leads are expected to contribute half of a working day per week towards the Working Group. There is no minimum requirement for other Participants.
The group encourages questions, comments and issues on its public mailing lists and document repositories, as described in Communication.
The group also welcomes non-Members to contribute technical submissions for consideration upon their agreement to the terms of the W3C Patent Policy.
Participants in the group are required (by the W3C Process) to follow the W3C Code of Ethics and Professional Conduct.
Communication
Technical discussions for this Working Group are conducted in public: the meeting minutes from teleconference and face-to-face meetings will be archived for public review, and technical discussions and issue tracking will be conducted in a manner that can be both read and written to by the general public. Working Drafts and Editor's Drafts of specifications will be developed on a public repository and may permit direct public contribution requests. The meetings themselves are not open to public participation, however.
Information about the group (including details about deliverables, issues, actions, status, participants, and meetings) will be available from the Web Editing Working Group home page.
Most Web Editing Working Group teleconferences will focus on discussion of particular specifications, and will be conducted on an as-needed basis.
This group primarily conducts its technical work in GitHub issues. The public is invited to review, discuss, and contribute to this work.
The group may use its public mailing list public-editing-tf@w3.org (archive) for administrative purposes.
Decision Policy
This group will seek to make decisions through consensus and due process, per the W3C Process Document (section 3.3). Typically, an editor or other participant makes an initial proposal, which is then refined in discussion with members of the group and other reviewers, and consensus emerges with little formal voting being required.
However, if a decision is necessary for timely progress and consensus is not achieved after careful consideration of the range of views presented, the Chairs may call for a group vote and record a decision along with any objections.
To afford asynchronous decisions and organizational deliberation, any resolution (including publication decisions) taken in a face-to-face meeting or teleconference will be considered provisional. A call for consensus (CfC) will be issued for all resolutions (for example, via email, GitHub issue or web-based survey), with a response period from 7 working days, depending on the chair's evaluation of the group consensus on the issue. If no objections are raised by the end of the response period, the resolution will be considered to have consensus as a resolution of the Working Group.
All decisions made by the group should be considered resolved unless and until new information becomes available or unless reopened at the discretion of the Chairs or the Director.
This charter is written in accordance with the W3C Process Document (Section 3.4, Votes) and includes no voting procedures beyond what the Process Document requires.
Patent Policy
This Working Group operates under the W3C Patent Policy (Version of 15 September 2020). To promote the widest adoption of Web standards, W3C seeks to issue Web specifications that can be implemented, according to this policy, on a Royalty-Free basis. For more information about disclosure obligations for this group, please see the W3C Patent Policy Implementation.
Licensing
This Working Group will use the W3C Software and Document license for all its deliverables.
About this Charter
This charter has been created according to section 5.2 of the Process Document. In the event of a conflict between this document or the provisions of any charter and the W3C Process, the W3C Process shall take precedence.
Charter History
The following table lists details of all changes from the initial charter, per the W3C Process Document (section 5.2.3):
Charter Period | Start Date | End Date | Changes |
---|---|---|---|
Initial Charter | 10 June 2021 | 09 June 2023 | none |
Charter Extension | 10 June 2023 | 09 September 2023 | Charter extended until 09 September 2023, for the group to develop a new charter. Grisha Lyukshin stepped down as co-chair. |