1140838 - Make MDN <menu> type description understandable, doc context not popup

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: HTML, defect)

Description

[Adrian Aichner [:anaran]]

See these links:

https://developer.mozilla.org/en-US/docs/Web/HTML/Element/menu

  referenced from

https://developer.mozilla.org/en-US/docs/Web/HTML/Element/menu

Details:

I am not able to understand "this is the missing value default if ..." in the description below.

Do these sentences under popup and toolbar make sense?

Could they be reworded to be clearer?

type
    This attribute indicates the kind of menu being declared, and can be one of two values.

        popup: The popup menu state, which represents a group of commands activated through another element. This might be through the menu attribute of a <button>, or an element with a contextmenu attribute. When nesting <menu> elements directly within one another, this is the missing value default if the parent is already in this state.
        toolbar: The toolbar menu state, which represents a series of commands for user interaction. This is the missing value default, except where the parent element is a <menu> in the popup menu state.

Comment 1

[Adrian Aichner [:anaran]]

http://dev.w3.org/html5/spec-LC/interactive-elements.html#the-menu-element
is the best upstream info I was able to find.

It mentions the list state:

"The attribute may also be omitted. The missing value default is the list state, which indicates that the element is merely a list of commands that is neither declaring a context menu nor defining a toolbar."

Perhaps MDN should reword along these lines and mention the missing default separately, not twice under popup and toolbar.

Comment 2

[Jean-Yves Perrier [:teoli]]

Hi!

Thanks for the info! It is a wiki, can you try to fix it? It would be helpful and save us a lot of time: takes quite a lot of time to dig into a new context and fix, even if it "simple".

Don't be afraid, you can't break anything.

Thanks in advance for the help, really appreciated!

Comment 3

[Adrian Aichner [:anaran]]

I guess bug 1100749 can not quickly be fixed considering
https://bugzilla.mozilla.org/showdependencygraph.cgi?id=1100749

Comment 4

[Adrian Aichner [:anaran]]

See bug 1140838 comment 10 for my suggested replacement of type popup with context to document current implementation and to make the type default documentation more approachable.

Comment 5

[Adrian Aichner [:anaran]]

Correction:

See bug 897102 comment 10 for my suggested replacement of type popup with context to document current implementation and to make the type default documentation more approachable.

Comment 6

[Adrian Aichner [:anaran]]

See
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/menu$compare?locale=en-US&to=773095&from=766493
for my temporary fix.

Comment 7

[Adrian Aichner [:anaran]]

Hi Jean-Yves, can you please confirm my temporary fix as per bug 897102 comment 10.

Comment 8

[Jean-Yves Perrier [:teoli]]

Adrian, it looks good! Thanks.