Author: Margarita Fisher
Date: March 22, 2002
1 Project Description |
In the latest release of Java Plug-in we added progress bar to display applet download progress; tags to specify background/foreground and progress bar colors; tag to provide a custom message instead of usual debugging=confusing messages.
Every one of these changes has its own group of supporters. Latest updates to the gray box overwrite legacy behavior and this causes complaints from users that got used to the old gray box behavior and liked it.
We need to make gray box more customizable and give it some default behavior that would be acceptable to regular users and would not change from one release to the next.
2 Technical Description |
1. Downloading Java code
By default, we want to provide a simple yet informative feedback to the consumer users that content is being retrieved for them. In all cases, JPI's Gray Box will not provide a border to delineate the area occupied by the Java content. (A border might clash with the content when it gets loaded and begins rendering.)
1.1 Default
A small animated graphic will be placed in the upper left corner. This graphic will be 24x24 and be 6 pixels from the top and left sides of the area. If the whole area occupied by JPI is less than 36x36, display nothing for feedback. The graphic will be provided later by UE.
The status bar will display "Loading Java content..." when mouse points at the gray box area.
1.2 Custom image
The developer also has the option of providing a custom graphic. Special tag for the image is:
IMAGE = "my_image.gif"
If a custom graphic is provided, it should be the same size as the area JPI occupies. If these sizes do not match, the graphic will be placed in the upper left corner of the area specified for JPI. If it's too big, part of it gets chopped off. If it's too small, there's some extra white space around it. If it fits perfectly, great.
The image file should be either GIF or JPG file format. It should reside in the same directory where other resources for the applet are residing, i.e. if there is a "CODEBASE" provided, this image file should be in the codebase directory. The image file for the splash screen should not be in a jar file with other resources for the plug-in, since we want to display it while downloading resources for the applet.
The status bar will display "Loading Java content..." when mouse points at the gray box area.
1.3 Progress bar
The developer can also request that a progress bar be provided instead of the default animated graphic. This progress bar will horizontally fill the area except for 6 pixels on the right and left. Place the text "Loading Java content..." above the progress bar and left aligned with it. Progress bar is purple by default.
Special tag to turn the progress bar ON:
PROGRESSBAR = "true"
Once again, the status bar displays "Loading Java content..." when mouse points at the gray box.
1.4 Applet text message.
The developer can also customize the text. If a new text string is provided, it is utilized for the progress bar, and status bar.
HTML tag to specify message string:
BOXMESSAGE = "Message string here."
1.5 Custom colors for gray box.
The developer can provide custom foreground, background and progress bar colors. By default, the foreground and background colors are obtained from the HTML page occupied by the JPI.
HTML tag to specify background color: BOXBGCOLOR = "153, 153, 204"
HTML tag to specify foreground color: BOXFGCOLOR = "red"
HTML tag to specify progress color: PROGRESSCOLOR = "33FF33"
Note: Three color tags above are shown using different available formats that are supported by plug-in. See usability document on color specifications.
The precedence order for these variables is:
1) If no parameters are provided, the default visualization is used.
2) If a custom graphic is provided, the "custom graphic" situation is used.
3) If a progress bar is asked for, the progress bar is displayed with the default text and color.
4) If custom text is provided, the progress bar is displayed with the custom text.
Custom colors can be provided for any situation. (For some situations, it is a bit unclear what these colors would affect.)
2. Failure
In the event that the code does not download or run cleanly, the JPI's Gray Box should display error information similar to other web content/media types.
The area occupied by the JPI will have a single pixel border (using the foreground color). A small "broken" graphic will occupy the upper left corner of the space (as it is defined above for the default case). Remove the current test string from the status bar and provide no new text string.
Right mouse button click on the applet's area will popup a menu with an option to open Java Console.
3 Marketing |
4 Management and Planning |
Size of this effort? Small[] Medium[X] Large[]
What is the priority? 1[X] 2[] 3[]
Hopper
Margarita Fisher
To be determined.
|
  |   |   |   |   |
Complete | Started | Not Started | Difficulties | Trouble |
Appendices (as needed, suggestions below) |
|
Revision History |
|