Skip to content

Commit

Permalink
clean up and merge existing docs
Browse files Browse the repository at this point in the history
  • Loading branch information
johanneswilm committed Nov 30, 2015
1 parent 7cbb113 commit 37a1e19
Show file tree
Hide file tree
Showing 4 changed files with 16 additions and 20,319 deletions.
9 changes: 4 additions & 5 deletions contentEditable.html
Expand Up @@ -158,8 +158,6 @@ <h2>contenteditable</h2>
<p>The contenteditable attribute is an enumerated attribute whose keywords are the empty string (""), "events", "caret", "typing", "plaintext-only", "true", and "false".
There is one additional state, the <code>inherit</code> state, which is the missing value default (and the invalid value default).</p>

<p>The state "true" is currently not well-defined and its usage is discouraged. An initial attempt has been made to specify the behavior of editing commands that work in the "true" state in the <a href="https://w3c.github.io/editing/execCommand.html">execCommand spec</a>.</p>

<p>The empty string and the "true" keyword map to the <code>true</code> state. The other keywords map to their respective states.</p>

The <code>false</code> state indicates that the element is not editable.
Expand Down Expand Up @@ -194,11 +192,12 @@ <h2>Meaning of states</h2>
default browser controlled movement of the caret. The "typing" state adds handling of text input through IME and keyboard, and
deletion within an IME composition. The "true" state adds handling of deletion of content for keyboard input as well as deletion of non-textual content and editing commands through the execCommand command.</p>

<p>The state "plaintext-only" is deprecated and its usage is discouraged.</p>
<p>The states "events", "caret" and "typing" are defined in this document.</a>

<h2>Definition of behavior per state</h2>
<p>The state "true" is currently not well-defined and its usage is discouraged. An initial attempt has been made to specify the behavior of the "true" state in the <a href="https://w3c.github.io/editing/contentEditableTrue.html">contentEditable=True spec</a>.</p>

<p>The state "plaintext-only" is deprecated and its usage is discouraged.</p>

<p>The states "events", "caret" and "typing" are defined below.</a>
</section>

<section>
Expand Down
125 changes: 6 additions & 119 deletions contentEditableEvents.html
@@ -1,119 +1,6 @@
<!DOCTYPE html>

<html lang='en'>
<head>
<meta charset='utf-8'>

<title>Content Editable</title>
<script async="" class='remove' src=
'https://www.w3.org/Tools/respec/respec-w3c-common'></script>
<script class='remove'>
var respecConfig = {
specStatus: "ED"
, shortName: "ContentEditable"
, editors: [{ name: "Johannes Wilm",
mailto: "johannes@fiduswriter.org",
company: "Invited Expert"},
{ name: "Ben Peters",
mailto: "BenjamP@microsoft.com",
company: "Microsoft",
companyURL: "http://www.microsoft.com",
note: "until <time>2015-02-23</time>"},]
, wg: "Web Platform Working Group"
, wgURI: "http://www.w3.org/WebPlatform/WG/"
, license: "w3c-software-doc"
, wgPublicList: "public-editing-tf"
, otherLinks: [{
key: 'Participate',
data: [{
value: 'We are on GitHub.',
href: 'https://github.com/w3c/editing'
}, {
value: 'File a bug.',
href: 'https://github.com/w3c/editing/issues'
}, {
value: 'Commit history.',
href: 'https://github.com/w3c/editing/commits/gh-pages'
}, {
value: 'Mailing list.',
href: 'http://lists.w3.org/Archives/Public/public-editing-tf/'
}]
}]
, localBiblio: {
'css-cascade-3': {
title: 'CSS Cascading and Inheritance Level 3',
href: 'http://www.w3.org/TR/css-cascade-3/',
authors: ['Elika J. Etemad. W3C CSSWG.', 'Tab Atkins Jr. W3C CSSWG.']
}
}
, wgPatentURI: "http://www.w3.org/2004/01/pp-impl/83482/status"
, edDraftURI: "http://w3c.github.io/editing/contentEditableEvents.html"
};
</script>
</head>

<body>
<section id='abstract'>
<p>This specification defines the expected behaviors for for elements
with the contenteditable attribute set to `true`, `typing`, `caret` or
`events`. This specification builds on HTML5.</p>
</section>

<section id='sotd'>
<p></p>
</section>

<section>
<h2 id="problems_and_use_cases">Problem and Use Cases</h2>

<p>The problems solved by and use cases for this document by this
document are tracked in the <a href=
"http://w3c.github.io/editing/editing-explainer.html">Editing
Explainer</a> document.</p>
</section>



<section>
<h2 id="introduction">Introduction</h2>

<p style="font-style: italic">This section is not normative</p>

<p>The <a>editing host</a> can have one of four states: events, caret,
typing and true. The state is determined by the value of the
contenteditable attribute of the editing host.</p>

<p>The <code>events</code> state is the foundation of rich text editing
on the web, and designed to be used only with a script-based editor
implementation. It is not meant to be a stand-alone solution.</p>

<p>There is no default browser behavior for user input in
contenteditable. Instead, it fires Device-Independent Events
that can be handled by scripts. Details on those events can be found in
the <a href="http://www.w3.org/TR/selection-api/">Selection API</a> and
<a href="http://w3c.github.io/editing/input-events.html">Input
Events</a> specifications.</p>

<p class="note">When the selections contains a
<a>editing host</a>, `execCommand` and
`queryCommand` may not work as they do in other editable elements, or
may even fail to execute. These methods are not interoperable nor
guaranteed to work against `contentEditable`, and their uses are
strongly discouraged.
</p>
</section>



<section>
<h2 id="acknowledgements">Acknowledgements</h2>

<p>Thanks to: Robin Berjon, Olivier Forget, Marijn Haverbek, Koji
Ishii, Frederico Caldeira Knabben, Piotrek Koszuliński, Ryosuke Niwa,
Joanmarie, Johan Sörlin, Cristian Talau...
and everyone in the Editing Taskforce for their input and feedback.
</p>
</section>
</section>
</body>
</html>
<!doctype html>
<meta charset="utf-8">
<meta http-equiv="refresh" content="0; url=https://w3c.github.io/editing/contentEditable.html">
<title>Moved…</title>
<p>Moved to
<a href="https://w3c.github.io/editing/contentEditable.html">https://w3c.github.io/editing/contentEditable.html</a>

0 comments on commit 37a1e19

Please sign in to comment.