mozilla

Revision 142790 of Proxy UI

  • Revision slug: Proxy_UI
  • Revision title: Proxy UI
  • Revision id: 142790
  • Created:
  • Creator: Benc
  • Is current revision? No
  • Comment /* =Selecting the proxy "mode") */ nits + introduce "related proxy mode" term

Revision Content

Products

Firefox

Menu: Preferences > Advanced Tab > Networking tab > Connection button.

Thunderbird

Menu: Preferences > Advanced Tab > Networking tab > Connection button.

Seamonkey

Menu: Preferences > Advanced group > Proxies panel

Menu: right-click on lower-right.

Camino

Configured in OS (Networking Preferences)




UI Elements

Preference UI

Selecting the proxy "mode"

All product's Proxy preference panels share a basic design: a radio button that selects the proxy mode, then "related proxy mode" UI when needed. For the purposes of this document, "proxy mode" means both:

  • Whatever was selected in the UI (as opposed to the value of the <tt>network.proxy.type</tt>.
  • The underlying behavior.

The currently available modes are based on "network.proxy.type".

For example, Firefox 3:

[ ] No Proxy
[ ] Auto-detect proxy settings for this network
[ ] Manual proxy configuration:
[ ] Automatic proxy configuration URL:

"related proxy mode" UI elements

  • Manual proxy is a list of proxy types that require a hostname and a port number.
  • Proxy autoconfiguration has a URL field and a reload button.

Behavior

Default value:

  • "No Proxy" is selected
  • All "type" radio buttons are enabled, but not selected.

Enabling and disabling related fields

When a radio button is selected, the related UI elements are enabled (and editable). The previously selected radio button becomes unselected, and the related UI of the previous button is disabled (and is not editable).

Saving changes

  • Click "OK" to save changes to prefs.
  • Click "Cancel" to discard changes.

The radio buttons do not map to the proxy type in order (due the evolution of the UI):

Proxy mode "network.proxy.type"
No Proxy (direct) network.proxy.type=0
Auto-detect proxy settings... (WPAD) network.proxy.type=4
Manual proxy configuration (manual) network.proxy.type=1
Automatic proxy configuration URL (PAC) network.proxy.type=2


No proxy for

Cut and paste magic: Bug 311779 (FF and SB only).

Offline|Online "plug"
Location

Status bar on the right side.

Right-click

A menu is displayed that has the following items:

Online (Proxy: None) Online (Proxy: Auto Discover) Online (Proxy: Auto URL) Online (Proxy: Manual) --- Proxy Configuration...

<h7 name="Details">Details</h7> The menu should display the current proxy mode with a dot. The modes that can have an empty configuration (Auto URL and Manual) will be disabled if the prefs are blank. Selecting an enabled item sets the menu selection and the proxy mode (network.proxy.type) Selecting a disabled item is not allowed. Selecting "Proxy Configuration..." opens the Preferences panel to "Advanced > Proxies"

(TBdescribed: changing the prefs values).

Unfiled bug: changing proxy mode does not update the menu.

Mouseover

When online, the tooltip will include the current proxy mode:

Code

http://mxr.mozilla.org/seamonkey/source/suite/common/utilityOverlay.xul

Bugs

Bug 243624

Revision Source

<h4 name="Products">Products</h4>
<h6 name="Firefox">Firefox</h6>
<p>Menu: Preferences &gt; Advanced Tab &gt; Networking tab &gt; Connection button.
</p>
<h6 name="Thunderbird">Thunderbird</h6>
<p>Menu: Preferences &gt; Advanced Tab &gt; Networking tab &gt; Connection button.
</p>
<h6 name="Seamonkey">Seamonkey</h6>
<p>Menu: Preferences &gt; Advanced group &gt; Proxies panel
</p><p>Menu: right-click on lower-right.
</p>
<h6 name="Camino">Camino</h6>
<p>Configured in OS (Networking Preferences)
</p><p><br>
</p><p><br>
</p><p><br>
</p>
<h4 name="UI_Elements">UI Elements</h4>
<h5 name="Preference_UI">Preference UI</h5>
<h4 name="Selecting_the_proxy_.22mode.22">Selecting the proxy "mode"</h4>
<p>All product's Proxy preference panels share a basic design: a radio button that selects the proxy mode, then "related proxy mode" UI when needed. For the purposes of this document, "proxy mode" means both:
</p>
<ul><li> Whatever was selected in the UI (as opposed to the value of the <tt>network.proxy.type</tt>.
</li><li> The underlying behavior.
</li></ul>
<p>The currently available modes are based on "<a class="external" href="http://kb.mozillazine.org/Network.proxy.type">network.proxy.type</a>".
</p><p>For example, Firefox 3:
</p>
<pre>[ ] No Proxy
[ ] Auto-detect proxy settings for this network
[ ] Manual proxy configuration:
[ ] Automatic proxy configuration URL:
</pre>
<p>"related proxy mode" UI elements
</p>
<ul><li>Manual proxy is a list of proxy types that require a hostname and a port number.
</li><li>Proxy autoconfiguration has a URL field and a reload button.
</li></ul>
<h3 name="Behavior">Behavior</h3>
<p>Default value: 
</p>
<ul><li>"No Proxy" is selected
</li><li> All "type" radio buttons are enabled, but not selected.
</li></ul>
<h3 name="Enabling_and_disabling_related_fields">Enabling and disabling related fields</h3>
<p>When a radio button is selected, the related UI elements are enabled (and editable). The previously selected radio button becomes unselected, and the related UI of the previous button is disabled (and is not editable).
</p>
<h3 name="Saving_changes">Saving changes</h3>
<ul><li>Click "OK" to save changes to prefs.
</li><li>Click "Cancel" to discard changes.
</li></ul>
<p>The radio buttons do not map to the proxy type in order (due the evolution of the UI):
</p>
<table class="standard-table">

<tbody><tr>
<th> Proxy mode </th><th> "network.proxy.type"
</th></tr>
<tr>
<td>No Proxy (direct) </td><td> network.proxy.type=0
</td></tr>
<tr>
<td>Auto-detect proxy settings... (WPAD) </td><td> network.proxy.type=4
</td></tr>
<tr>
<td>Manual proxy configuration (manual) </td><td> network.proxy.type=1
</td></tr>
<tr>
<td>Automatic proxy configuration URL (PAC) </td><td> network.proxy.type=2
</td></tr></tbody></table>
<p><br>
No proxy for
</p><p>Cut and paste magic: Bug 311779 (FF and SB only).
</p>
<h6 name="Offline|Online_.22plug.22">Offline|Online "plug"</h6>
<h6 name="Location">Location</h6>
<p>Status bar on the right side.
</p>
<h6 name="Right-click">Right-click</h6>
<p>A menu is displayed that has the following items:
</p><p>Online (Proxy: None)
Online (Proxy: Auto Discover)
Online (Proxy: Auto URL)
Online (Proxy: Manual)
---
Proxy Configuration...
</p><p><h7 name="Details">Details</h7>
The menu should display the current proxy mode with a dot.
The modes that can have an empty configuration (Auto URL and Manual) will be disabled if the prefs are blank.
Selecting an enabled item sets the menu selection and the proxy mode (network.proxy.type)
Selecting a disabled item is not allowed.
Selecting "Proxy Configuration..." opens the Preferences panel to "Advanced &gt; Proxies"
</p><p>(TBdescribed: changing the prefs values).
</p><p>Unfiled bug: changing proxy mode does not update the menu.
</p><p>Mouseover
</p><p>When online, the tooltip will include the current proxy mode:
</p>
<h6 name="Code">Code</h6>
<p>http://mxr.mozilla.org/seamonkey/source/suite/common/utilityOverlay.xul
</p>
<h6 name="Bugs">Bugs</h6>
<p>Bug 243624
</p>
Revert to this revision