1   package com.atlassian.webtest.ui.keys;
2   
3   /**
4    * <p>
5    * Enumeration of possible type modes. Surprisingly, there are many ways to insert a text into a HTML
6    * input on a page. They differ in speed, reliability and events raised by the browser. Every element
7    * in the framework capable of inserting a text into it should document its default type mode and
8    * optionally expose methods for different type modes.
9    *
10   * <p>
11   * <b>NOTE:</b> use this facility sparingly, most of the time you should be relying on the default
12   * type mode of any element. Implementations are not obliged to honour this setting. 
13   */
14  public enum TypeMode
15  {
16  
17      /**
18       * The type target decides itself about the type mode. This is the recommended option in most cases!
19       *
20       */
21      DEFAULT,
22  
23      /**
24       * Simply set the value of a HTML element. This is the fastest way, but <b>will not</b> invoke any events.
25       *
26       */
27      INSERT,
28  
29      /**
30       * Insert all characters and invoke all events for the last typed key.
31       *
32       */
33      INSERT_WITH_EVENT,
34  
35      /**
36       * Type into the component invoking all associated key events for each stroke.
37       *
38       */
39      TYPE
40  }