Definition of "Toolbar", Alternate Menu Type?

Xaxio Brandish <[email protected]> Wed, 13 Mar 2013 17:00:10 -0400
Newsgroups gmane.comp.web.html.general
Message-ID <CABAoKZngC9AH-e-BxzDaSch=UBtf-LPu0eRjcg5VJ3pnxPr71g@mail.gmail.com>
--00235447117472f8fd04d7d4b360
Content-Type: text/plain; charset=UTF-8

Good afternoon,

Pardon my ignorance, but I cannot seem to find a definition of "toolbar"
anywhere in the HTML specification.

The Candidate Recommendation states:

"If a menu element's type attribute is in the toolbar state, then the
> element represents a list of active commands that the user can immediately
> interact with."
>
(http://www.w3.org/TR/html5/interactive-elements.html#toolbar-state)

and

"A menu (or toolbar) consists of a list of zero or more of the following
> components:
>
>     Commands, which can be marked as default commands
>     Separators
>     Other menus (which allows the list to be nested)"
>
(
http://www.w3.org/TR/html5/interactive-elements.html#building-menus-and-toolbars<https://mail.google.com/mail/u/0/%28http://www.w3.org/TR/html5/interactive-elements.html#building-menus-and-toolbars%29>
)


The Editor's Draft states:

"If a menu element's type attribute is in the toolbar state, then the
> element represents a toolbar consisting of its contents, in the form of
> either an unordered list of items (represented by li elements), each of
> which represents a command that the user can perform or activate, or, if
> the element has no li element children, flow content describing available
> commands."
>
(
http://www.w3.org/html/wg/drafts/html/master/interactive-elements.html#toolbar-state
)

and the subsequent menu (or toolbar) text seems to have changed to:

> "A pop-up menu consists of a list of zero or more menu items, which can be
> any of:
>
>     Commands, which can be marked as default commands (menuitem)
>     Separators (hr)
>     Other menus, which allows the list to be nested (menu)"
>
(no subsection link)

 I have a few questions based on these pieces of text. Please allow me to
enumerate them to make them easier to address.

1) How is "toolbar" defined?

a) Unsourced Wikipedia states currently "In a graphical user interface, on
a computer monitor, a toolbar is a GUI widget on which on-screen buttons,
icons, menus, or other input or output elements are placed."
(http://en.wikipedia.org/wiki/Toolbar)

b) Unsourced Wiktionary states currently "A row of buttons, usually marked
with icons, used to activate the functions of an application or operating
system".
(http://en.wiktionary.org/wiki/toolbar)

c) Merriam-Webster states that a toolbar is "a strip of icons on a computer
display providing quick access to certain function".
(http://east.merriam-webster.com/dictionary/toolbar)

d) Can a toolbar consist entirely of text, without using icons?

e) Must a toolbar be a row (implying a horizontal visualization) instead of
a column?

2) Based on the draft text, are the terms "menu" and "toolbar"
interchangeable, or is a toolbar *definitively* a type of menu?

a) The text in the Draft that has changed to state "A pop-up menu..." and
then define the contents of a menu seems like it should be valid for any
menu, regardless of whether it is constantly visible or a pop-up menu.  Why
was this changed?

3) Regardless of whether looking at the CR or Draft, the <menu> element
only takes a type of either "popup" or "toolbar".  The <contextmenu>
element appears only to be relevant to right-click events.  Please consider
the following scenario:

A viewport exists, split horizontally by a graphical line into two parts,
with the left part taking 15% of the horizontal space and the right part
taking 85% of the horizontal space. The left side of the viewport displays
contextual information.  The area on the right side of the viewport
contains various elements with which an end user can interact.  When an
element on the right part is clicked (not right-clicked), the left side of
the viewport is updated with *contextual* information relevant to the
clicked element.  This contextual information consists of the size of the
element, the background color of the element, a link that can be clicked to
expand the width and height of the element (a command), and an element that
can be hovered over to display yet more actions and information associated
with the element.

a) How would the left side of the viewport be defined?  It is not used for
navigation, so <nav> does not seem to apply.  It is neither a toolbar by
the above definitions (there are no icons or buttons for it), nor is it a
popup menu, since it is constantly visible.  By the CR definition of menu
contents, it *seems* like it should be a menu.

b) Would it make sense to define a third type for the menu element for this
type of situation, or would it fall under the jurisdiction of another
element entirely?  I ask in the interest of maintaining semantic markup.

If I have addressed this to the wrong mailing list, please inform me.

--Xaxio

--00235447117472f8fd04d7d4b360
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div><div><div>Good afternoon,<br><br>Pardon my ignorance,=
 but I cannot seem to find a definition of &quot;toolbar&quot; anywhere in =
the HTML specification.<br><br></div>The Candidate Recommendation states:<b=
r>

<br></div><div><blockquote style=3D"margin:0px 0px 0px 0.8ex;border-left:1p=
x solid rgb(204,204,204);padding-left:1ex" class=3D"gmail_quote">&quot;If a=
 menu element&#39;s type attribute is in the toolbar state, then the elemen=
t represents a list of active commands that the user can immediately intera=
ct with.&quot;<br>

</blockquote><div></div>(<a href=3D"http://www.w3.org/TR/html5/interactive-=
elements.html#toolbar-state">http://www.w3.org/TR/html5/interactive-element=
s.html#toolbar-state</a>)<br><br>and<br><br><blockquote style=3D"margin:0px=
 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" cla=
ss=3D"gmail_quote">

&quot;A menu (or toolbar) consists of a list of zero or more of the followi=
ng components:<br><br>=C2=A0=C2=A0=C2=A0 Commands, which can be marked as d=
efault commands<br>=C2=A0=C2=A0=C2=A0 Separators<br>=C2=A0=C2=A0=C2=A0 Othe=
r menus (which allows the list to be nested)&quot;<br>

</blockquote>(<a href=3D"https://mail.google.com/mail/u/0/%28http://www.w3.=
org/TR/html5/interactive-elements.html#building-menus-and-toolbars%29">http=
://www.w3.org/TR/html5/interactive-elements.html#building-menus-and-toolbar=
s</a>)<br>

<br><br></div>The Editor&#39;s Draft states:<br></div><div><br><blockquote =
style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);pa=
dding-left:1ex" class=3D"gmail_quote">&quot;If a menu element&#39;s type at=
tribute is in the toolbar state, then the element represents a toolbar cons=
isting of its contents, in the form of either an unordered list of items (r=
epresented by li elements), each of which represents a command that the use=
r can perform or activate, or, if the element has no li element children, f=
low content describing available commands.&quot;<br>

</blockquote>(<a href=3D"http://www.w3.org/html/wg/drafts/html/master/inter=
active-elements.html#toolbar-state">http://www.w3.org/html/wg/drafts/html/m=
aster/interactive-elements.html#toolbar-state</a>)<br><br></div>and the sub=
sequent menu (or toolbar) text seems to have changed to:<br>

<blockquote style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204=
,204,204);padding-left:1ex" class=3D"gmail_quote">&quot;A pop-up menu consi=
sts of a list of zero or more menu items, which can be any of:<br><br>=C2=
=A0=C2=A0=C2=A0 Commands, which can be marked as default commands (menuitem=
)<br>

=C2=A0=C2=A0=C2=A0 Separators (hr)<br>=C2=A0=C2=A0=C2=A0 Other menus, which=
 allows the list to be nested (menu)&quot;<br></blockquote><div>(no subsect=
ion link)<br><br></div><div>=C2=A0I have a few questions based on these pie=
ces of text. Please allow me to enumerate them to make them easier to addre=
ss.<br>

<br></div><div>1) How is &quot;toolbar&quot; defined?<br><br><div style=3D"=
margin-left:40px">a) Unsourced Wikipedia states currently &quot;In a graphi=
cal user interface, on a computer monitor, a toolbar is a GUI widget on whi=
ch on-screen buttons, icons, menus, or other input or output elements are p=
laced.&quot;<br>

(<a href=3D"http://en.wikipedia.org/wiki/Toolbar">http://en.wikipedia.org/w=
iki/Toolbar</a>)<br><br></div><div style=3D"margin-left:40px">b) Unsourced =
Wiktionary states currently &quot;A row of buttons, usually marked with ico=
ns, used to activate the functions of an application or operating system&qu=
ot;.<br>

(<a href=3D"http://en.wiktionary.org/wiki/toolbar">http://en.wiktionary.org=
/wiki/toolbar</a>)<br><br></div><div style=3D"margin-left:40px">c) Merriam-=
Webster states that a toolbar is &quot;<span class=3D"">a strip of icons on=
 a computer display providing quick access to certain function&quot;.<br>

(<a href=3D"http://east.merriam-webster.com/dictionary/toolbar">http://east=
..merriam-webster.com/dictionary/toolbar</a>)<br><br></span></div><div style=
=3D"margin-left:40px"><span class=3D"">d) Can a toolbar consist entirely of=
 text, without using icons?<br>

<br></span></div><div style=3D"margin-left:40px"><span class=3D"">e) Must a=
 toolbar be a row (implying a horizontal visualization) instead of a column=
?<br> </span></div><br></div><div>2) Based on the draft text, are the terms=
 &quot;menu&quot; and &quot;toolbar&quot; interchangeable, or is a toolbar =
*definitively* a type of menu?<br>

<br><div style=3D"margin-left:40px">a) The text in the Draft that has chang=
ed to state &quot;A pop-up menu...&quot; and then define the contents of a =
menu seems like it should be valid for any menu, regardless of whether it i=
s constantly visible or a pop-up menu.=C2=A0 Why was this changed?<br>

</div><br></div><div>3) Regardless of whether looking at the CR or Draft, t=
he &lt;menu&gt; element only takes a type of either &quot;popup&quot; or &q=
uot;toolbar&quot;.=C2=A0 The &lt;contextmenu&gt; element appears only to be=
 relevant to right-click events.=C2=A0 Please consider the following scenar=
io:<br>

<div style=3D"margin-left:40px"><span style=3D"background-color:rgb(243,243=
,243)"><br></span></div><div style=3D"margin-left:40px"><span style=3D"back=
ground-color:rgb(243,243,243)">A viewport exists, split horizontally by a g=
raphical line into two parts, with the left part taking 15% of the horizont=
al space and the right part taking 85% of the horizontal space. The left si=
de of the viewport displays contextual information.=C2=A0 The area on the r=
ight side of the viewport contains various elements with which an end user =
can interact.=C2=A0 When an element on the right part is clicked (not right=
-clicked), the left side of the viewport is updated with *contextual* infor=
mation relevant to the clicked element.=C2=A0 This contextual information c=
onsists of the size of the element, the background color of the element, a =
link that can be clicked to expand the width and height of the element (a c=
ommand), and an element that can be hovered over to display yet more action=
s and information associated with the element.</span><br>

<br></div><div style=3D"margin-left:40px">a) How would the left side of the=
 viewport be defined?=C2=A0 It is not used for navigation, so &lt;nav&gt; d=
oes not seem to apply.=C2=A0 It is neither a toolbar by the above definitio=
ns (there are no icons or buttons for it), nor is it a popup menu, since it=
 is constantly visible.=C2=A0 By the CR definition of menu contents, it *se=
ems* like it should be a menu.<br>

</div><div style=3D"margin-left:40px"><br>b) Would it make sense to define =
a third type for the menu element for this type of situation, or would it f=
all under the jurisdiction of another element entirely?=C2=A0 I ask in the =
interest of maintaining semantic markup.<br>

<br></div>If I have addressed this to the wrong mailing list, please inform=
 me.<br><br></div><div>--Xaxio<br></div></div>

--00235447117472f8fd04d7d4b360--