Labs/Jetpack/JEP/12: Difference between revisions
| Line 20: | Line 20: | ||
The functions to manipulate and access the selection lives in <code>jetpack.selection</code>. | The functions to manipulate and access the selection lives in <code>jetpack.selection</code>. | ||
==== Getting and Setting ==== | ==== Getting and Setting the Selection ==== | ||
Getting and setting the selection live in a family of getters and setters, dependent on the format. | Getting and setting the selection live in a family of getters and setters, dependent on the format. For the first version of <code>.selection</code> we include to formats: text, and html. | ||
'''Setting the selection''' | '''Setting the selection''' | ||
| Line 28: | Line 28: | ||
<pre class="brush:js;toolbar:false;"> | <pre class="brush:js;toolbar:false;"> | ||
jetpack.selection.text = "Hello"; | jetpack.selection.text = "Hello"; | ||
jetpack.selection.html = "<b>Hello</b>"; | jetpack.selection.html = "<b>Hello</b>";</pre> | ||
''' Getting the selection''' | |||
jetpack.selection.html | |||
<pre class="brush:js;toolbar:false;"> | |||
var textOfSel = jetpack.selection.text; | |||
var htmlOfSel = jetpack.selection.html;</pre> | |||
Eventually, one may be able to do <code>jetpack.selection.fragment</code> which would let you manipulate the selection live. That is, however, outside the scope of JEP 12. | |||
==== onSelection ==== | |||
Revision as of 00:12, 26 June 2009
|
THIS PAGE IS A WORKING DRAFT | 
|
| The page may be difficult to navigate, and some information on its subject might be incomplete and/or evolving rapidly. If you have any questions or ideas, please add them as a new topic on the discussion page. |
JEP 12 - jetpack.selection
- Champion: Aza Raskin <aza at mozilla dot com>
- Status: Implementing
- Type: API Track
- Created: 24 June 2009
- Reference Implementation: jetpack.future.import("selection")
- JEP Index
Introduction and Rationale
Performing a selection is one of fundamental computer-human interactions, acting as a close proxy for a users locus of attention. Even at the time of the writing of this JEP, numerous Jetpacks have already implemented disparate ways of getting and detecting selections.
Jetpacks should be able to set, get, and listen for selection events.
Proposal
The functions to manipulate and access the selection lives in jetpack.selection.
Getting and Setting the Selection
Getting and setting the selection live in a family of getters and setters, dependent on the format. For the first version of .selection we include to formats: text, and html.
Setting the selection
jetpack.selection.text = "Hello"; jetpack.selection.html = "<b>Hello</b>";
Getting the selection
var textOfSel = jetpack.selection.text; var htmlOfSel = jetpack.selection.html;
Eventually, one may be able to do jetpack.selection.fragment which would let you manipulate the selection live. That is, however, outside the scope of JEP 12.