Message/DOM/DOMWebForms.dis

Namespace:
  @DOMCore:
    http://suika.fam.cx/~wakaba/archive/2004/8/18/dom-core#
  @lang:
     http://suika.fam.cx/~wakaba/archive/2004/8/18/lang#
  @license:
     http://suika.fam.cx/~wakaba/archive/2004/8/18/license#
  @ManakaiDOMCore:
    http://suika.fam.cx/~wakaba/archive/2004/mdom-core#
  @ManakaiDOMHTML:
    http://suika.fam.cx/~wakaba/archive/2004/mdom/html#
  @TreeCore:\
  @xhtml1:
    http://www.w3.org/1999/xhtml
Module:
  @Name:  DOMWebForms
  @Namespace:
     http://suika.fam.cx/~wakaba/archive/2004/dom/html#
  @BindingName:
     @@@:  html
     @@Type:
        lang:IDL-DOM
     @@prefix:  dom.w3c.org
     @@Condition:DOM1
  @BindingName:
     @@@:  html2
     @@Type:
        lang:IDL-DOM
     @@prefix:  dom.w3c.org
     @@Condition:DOM2
  @FullName:
    @@lang:en
    @@@: DOM Web Forms Module
  @Description:
    @@lang:en
    @@@:
      Interfaces to manipulate Web Forms elements or form controls. 
      \
      {NOTE:: Most interfaces are originally defined in DOM 
              Levels 1 and 2 HTML Modules and later ammended 
              by the Web Forms 2.0 Specification.  These 
              standards are based on DOM Level 0 implementations. 
      \
      }

  @Author:
     @@FullName: Wakaba
     @@Mail:  [email protected]
  @License:
     license:Perl+MPL
  @Date.RCS:
     $Date: 2004/10/17 12:48:49 $

  @ConditionDef:
    @@Name:DOM1
  @ConditionDef:
    @@Name:DOM2
    @@ISA:DOM1
  @ConditionDef:
    @@Name:WF20
    @@ISA:DOM2
  @NormalCondition:WF20

  @Feature:
    @@Name:WebForms
    @@Version:2.0
    @@FullName:
      @@@lang:en
      @@@@:Web Forms 2.0
    @@Condition:WF20
  
  @Require:
     @@Module:
        @@@Name:  DOMHTML
        @@@Namespace:
          http://suika.fam.cx/~wakaba/archive/2004/dom/html#

DataTypeAlias:
  @Name:  DOMString
  @Type:
     DOMCore:DOMString

IF:
  @Name:  HTMLOptionsCollection
  @Description:
    @@lang:en
    @@@:
      A list of nodes representing HTML <HE:option> elements.  
      An individual node may be accessed by either ordinal index 
      or the <HA:name> or <HA:id> of the node.
      \
      <IF:HTMLOptionCollection> objects are <EM:live>; they are 
      automatically updated when the underlying document 
      is changed.
      
  @Level[list]:  2
  @SpecLevel[list]:  2
  @Attr:
     @@Name:  length
     @@Description:
       @@@lang:en
       @@@@:
         The length of the list.
     @@Get:
        @@@Type:
           DOMMain:unsigned-long
     @@Set:
        @@@Type:
           DOMMain:unsigned-long
        @@@Exception:
           @@@@Name:  NOT_SUPPORTED_ERR
           @@@@Type:
              DOMCore:DOMException
           @@@@SubType:
             @@@@@QName:
               ManakaiDOMHTML:MDOMHTML_IMPL_NOSUPPORT_SET_OPTION_LENGTH
             @@@@@Description:
               @@@@@@lang:en
               @@@@@@@:
                 Setting the length is not allowed by the DOM 
                 implementation.
  @Method:
     @@Name:  item
     @@Description:
       @@@lang:en
       @@@@:
         Retrieve a node specified by ordinal index.
     @@Param:
        @@@Name:  index
        @@@Type:
           DOMMain:unsigned-long
        @@@Description:
          @@@@lang:en
          @@@@@:
            Ordinal index of the node to retrieve, in the 
            document order.  The index origin is <DOM:0>.
     @@Return:
        @@@Type:  Node
        @@@Description:
          @@@@lang:en
          @@@@@:
            The <P:index>th node.
        @@@InCase:
          @@@@Value:
            @@@@@is-null:1
          @@@@Description:
            @@@@@lang:en
            @@@@@@:
              The <P:index> is out of range.
  @Method:
     @@Name:  namedItem
     @@Description:
       @@@lang:en
       @@@@:
         Retrieve a node using a name. 
       \
         It first searches for a <IF:Node> with a matching <HA:id> 
         attributes.  If it does not find one, it searches for a 
         <IF:Node> (that are allowed to specify a <HA:name> attribute).
         with a matching <HA:name> attribute.
     @@Param:
        @@@Name:  name
        @@@Type:  DOMString
        @@@Description:
          @@@@lang:en
          @@@@@:
            The name of the node to retrieve.  The matching is 
            case-insensitive in HTML documents and case-sensitve 
            in XHTML documents.
     @@Return:
        @@@Type:  
          DOMCore:Node
        @@@Description:
          @@@@lang:en
          @@@@@:
            The <IF:Node> with a <HA:name> or <HA:id> whose 
            value matches with <P:name>.
        @@@InCase:
          @@@@Value:
            @@@@@is-null:1
          @@@@Description:
            @@@@@lang:en
            @@@@@@:
              There is no node with such a <P:name>.
##IF:HTMLOptionCollection

IF:
  @Name:  HTMLFormElement
  @Description:
    @@lang:en
    @@@:
      This interface encompasses behavior similar to a collection 
      and an element.  It provides direct access to the contained 
      form controls as well as attributes of the form element.
  @ISA:  
    DOMHTML:HTMLElement
  @ElementType:
    @@QName:
      xhtml1:form
  @Attr:
     @@Name:  elements
     @@Description:
       @@@lang:en
       @@@@:
         A collection of all form controls in this form.
     @@Get:
        @@@Type:  
          DOMHTML:HTMLCollection
  @Attr:
     @@Name:  length
     @@Description:
       @@@lang:en
       @@@@:
         The number of form controls in this form.
     @@Get:
        @@@Type:
           DOMMain:long
  @Attr:
     @@Name:  name
     @@Description:
       @@@lang:en
       @@@@:
         The name of the form.
         \
         {NOTE:: The DOM HTML Specifications does not mention 
                 to the HTML 4.01 <HA:name> attribute, which is 
                 added for backward compatibility with DOM Level 0.
         \
         }
     @@DocAttr:
       @@@Name:name
     @@Get:
        @@@Type:  DOMString
     @@Set:
        @@@Type:  DOMString
  @Attr:
     @@Name:  acceptCharset
     @@DocAttr:
       @@@Name:accept-charset
     @@Get:
        @@@Type:  DOMString
     @@Set:
        @@@Type:  DOMString
  @Attr:
     @@Name:  action
     @@DocAttr:
       @@@Name:action
     @@Get:
        @@@Type:  DOMString
     @@Set:
        @@@Type:  DOMString
  @Attr:
     @@Name:  enctype
     @@DocAttr:
       @@@Name:enctype
     @@Get:
        @@@Type:  DOMString
     @@Set:
        @@@Type:  DOMString
  @Attr:
     @@Name:  method
     @@DocAttr:
       @@@Name:method
     @@Get:
        @@@Type:  DOMString
     @@Set:
        @@@Type:  DOMString
  @Attr:
     @@Name:  target
     @@DocAttr:
       @@@Name:targeet
     @@Get:
        @@@Type:  DOMString
     @@Set:
        @@@Type:  DOMString
  @Method:
     @@Name:  submit
     @@Description:
       @@@lang:en
       @@@@:
         Submit the form, as the activation of submit buttons do.
         \
         {NOTE:: The <HA:onsubmit> or <EV:submit> event handler is not 
         guaranteed to be triggered when invoking this method 
         for historical reasons.  DOM Level 3 <EV:ev:submit> 
         event is defined not to triggered on this method.
         \
         }
     @@Return:  
  @Method:
     @@Name:  reset
     @@Description:
       @@@lang:en
       @@@@:
         Restore current values of form controls to initial values, 
         as the activation of reset buttons do.
     @@Return:  
##IF:HTMLFormElement

IF:
  @Name:  HTMLSelectElement
  @ISA:  
    DOMHTML:HTMLElement
  @ElementType:
    @@QName:
      xhtml1:select
  @Attr:
     @@Name:  type
     @@Description:
       @@@lang:en
       @@@@:
         The type of this form control.
     @@Get:
        @@@Type:  DOMString
        @@@InCase:
          @@@@Value:select-one
          @@@@Description:
            @@@@@lang:en
            @@@@@@:
              <A:HTMLSelectElement.multiple> is <DOM:false>.
        @@@InCase:
          @@@@Value:select-multiple
          @@@@Description:
            @@@@@lang:en
            @@@@@@:
              <A:HTMLSelectElement.multiple> is <DOM:true>.
        @@@Def:
          @@@@Type:
            lang:Perl
          @@@@@:
            __DEEP{
              $r = $self->multiple ? "select-multiple" : "select-one";
            }__;
  @Attr
1	wakaba	1.1	Namespace:
2			@DOMCore:
3			http://suika.fam.cx/~wakaba/archive/2004/8/18/dom-core#
4			@lang:
5			http://suika.fam.cx/~wakaba/archive/2004/8/18/lang#
6			@license:
7			http://suika.fam.cx/~wakaba/archive/2004/8/18/license#
8			@ManakaiDOMCore:
9			http://suika.fam.cx/~wakaba/archive/2004/mdom-core#
10			@ManakaiDOMHTML:
11			http://suika.fam.cx/~wakaba/archive/2004/mdom/html#
12			@TreeCore:\
13			@xhtml1:
14			http://www.w3.org/1999/xhtml
15			Module:
16			@Name: DOMWebForms
17			@Namespace:
18			http://suika.fam.cx/~wakaba/archive/2004/dom/html#
19			@BindingName:
20			@@@: html
21			@@Type:
22			lang:IDL-DOM
23			@@prefix: dom.w3c.org
24			@@Condition:DOM1
25			@BindingName:
26			@@@: html2
27			@@Type:
28			lang:IDL-DOM
29			@@prefix: dom.w3c.org
30			@@Condition:DOM2
31			@FullName:
32			@@lang:en
33			@@@: DOM Web Forms Module
34			@Description:
35			@@lang:en
36			@@@:
37			Interfaces to manipulate Web Forms elements or form controls.
38			\
39			{NOTE:: Most interfaces are originally defined in DOM
40			Levels 1 and 2 HTML Modules and later ammended
41			by the Web Forms 2.0 Specification. These
42			standards are based on DOM Level 0 implementations.
43			\
44			}
45
46			@Author:
47			@@FullName: Wakaba
48			@@Mail: [email protected]
49			@License:
50			license:Perl+MPL
51			@Date.RCS:
52			$Date: 2004/10/17 12:48:49 $
53
54			@ConditionDef:
55			@@Name:DOM1
56			@ConditionDef:
57			@@Name:DOM2
58			@@ISA:DOM1
59			@ConditionDef:
60			@@Name:WF20
61			@@ISA:DOM2
62			@NormalCondition:WF20
63
64			@Feature:
65			@@Name:WebForms
66			@@Version:2.0
67			@@FullName:
68			@@@lang:en
69			@@@@:Web Forms 2.0
70			@@Condition:WF20
71
72			@Require:
73			@@Module:
74			@@@Name: DOMHTML
75			@@@Namespace:
76			http://suika.fam.cx/~wakaba/archive/2004/dom/html#
77
78			DataTypeAlias:
79			@Name: DOMString
80			@Type:
81			DOMCore:DOMString
82
83			IF:
84			@Name: HTMLOptionsCollection
85			@Description:
86			@@lang:en
87			@@@:
88			A list of nodes representing HTML <HE:option> elements.
89			An individual node may be accessed by either ordinal index
90			or the <HA:name> or <HA:id> of the node.
91			\
92			<IF:HTMLOptionCollection> objects are <EM:live>; they are
93			automatically updated when the underlying document
94			is changed.
95
96			@Level[list]: 2
97			@SpecLevel[list]: 2
98			@Attr:
99			@@Name: length
100			@@Description:
101			@@@lang:en
102			@@@@:
103			The length of the list.
104			@@Get:
105			@@@Type:
106			DOMMain:unsigned-long
107			@@Set:
108			@@@Type:
109			DOMMain:unsigned-long
110			@@@Exception:
111			@@@@Name: NOT_SUPPORTED_ERR
112			@@@@Type:
113			DOMCore:DOMException
114			@@@@SubType:
115			@@@@@QName:
116			ManakaiDOMHTML:MDOMHTML_IMPL_NOSUPPORT_SET_OPTION_LENGTH
117			@@@@@Description:
118			@@@@@@lang:en
119			@@@@@@@:
120			Setting the length is not allowed by the DOM
121			implementation.
122			@Method:
123			@@Name: item
124			@@Description:
125			@@@lang:en
126			@@@@:
127			Retrieve a node specified by ordinal index.
128			@@Param:
129			@@@Name: index
130			@@@Type:
131			DOMMain:unsigned-long
132			@@@Description:
133			@@@@lang:en
134			@@@@@:
135			Ordinal index of the node to retrieve, in the
136			document order. The index origin is <DOM:0>.
137			@@Return:
138			@@@Type: Node
139			@@@Description:
140			@@@@lang:en
141			@@@@@:
142			The <P:index>th node.
143			@@@InCase:
144			@@@@Value:
145			@@@@@is-null:1
146			@@@@Description:
147			@@@@@lang:en
148			@@@@@@:
149			The <P:index> is out of range.
150			@Method:
151			@@Name: namedItem
152			@@Description:
153			@@@lang:en
154			@@@@:
155			Retrieve a node using a name.
156			\
157			It first searches for a <IF:Node> with a matching <HA:id>
158			attributes. If it does not find one, it searches for a
159			<IF:Node> (that are allowed to specify a <HA:name> attribute).
160			with a matching <HA:name> attribute.
161			@@Param:
162			@@@Name: name
163			@@@Type: DOMString
164			@@@Description:
165			@@@@lang:en
166			@@@@@:
167			The name of the node to retrieve. The matching is
168			case-insensitive in HTML documents and case-sensitve
169			in XHTML documents.
170			@@Return:
171			@@@Type:
172			DOMCore:Node
173			@@@Description:
174			@@@@lang:en
175			@@@@@:
176			The <IF:Node> with a <HA:name> or <HA:id> whose
177			value matches with <P:name>.
178			@@@InCase:
179			@@@@Value:
180			@@@@@is-null:1
181			@@@@Description:
182			@@@@@lang:en
183			@@@@@@:
184			There is no node with such a <P:name>.
185			##IF:HTMLOptionCollection
186
187			IF:
188			@Name: HTMLFormElement
189			@Description:
190			@@lang:en
191			@@@:
192			This interface encompasses behavior similar to a collection
193			and an element. It provides direct access to the contained
194			form controls as well as attributes of the form element.
195			@ISA:
196			DOMHTML:HTMLElement
197			@ElementType:
198			@@QName:
199			xhtml1:form
200			@Attr:
201			@@Name: elements
202			@@Description:
203			@@@lang:en
204			@@@@:
205			A collection of all form controls in this form.
206			@@Get:
207			@@@Type:
208			DOMHTML:HTMLCollection
209			@Attr:
210			@@Name: length
211			@@Description:
212			@@@lang:en
213			@@@@:
214			The number of form controls in this form.
215			@@Get:
216			@@@Type:
217			DOMMain:long
218			@Attr:
219			@@Name: name
220			@@Description:
221			@@@lang:en
222			@@@@:
223			The name of the form.
224			\
225			{NOTE:: The DOM HTML Specifications does not mention
226			to the HTML 4.01 <HA:name> attribute, which is
227			added for backward compatibility with DOM Level 0.
228			\
229			}
230			@@DocAttr:
231			@@@Name:name
232			@@Get:
233			@@@Type: DOMString
234			@@Set:
235			@@@Type: DOMString
236			@Attr:
237			@@Name: acceptCharset
238			@@DocAttr:
239			@@@Name:accept-charset
240			@@Get:
241			@@@Type: DOMString
242			@@Set:
243			@@@Type: DOMString
244			@Attr:
245			@@Name: action
246			@@DocAttr:
247			@@@Name:action
248			@@Get:
249			@@@Type: DOMString
250			@@Set:
251			@@@Type: DOMString
252			@Attr:
253			@@Name: enctype
254			@@DocAttr:
255			@@@Name:enctype
256			@@Get:
257			@@@Type: DOMString
258			@@Set:
259			@@@Type: DOMString
260			@Attr:
261			@@Name: method
262			@@DocAttr:
263			@@@Name:method
264			@@Get:
265			@@@Type: DOMString
266			@@Set:
267			@@@Type: DOMString
268			@Attr:
269			@@Name: target
270			@@DocAttr:
271			@@@Name:targeet
272			@@Get:
273			@@@Type: DOMString
274			@@Set:
275			@@@Type: DOMString
276			@Method:
277			@@Name: submit
278			@@Description:
279			@@@lang:en
280			@@@@:
281			Submit the form, as the activation of submit buttons do.
282			\
283			{NOTE:: The <HA:onsubmit> or <EV:submit> event handler is not
284			guaranteed to be triggered when invoking this method
285			for historical reasons. DOM Level 3 <EV:ev:submit>
286			event is defined not to triggered on this method.
287			\
288			}
289			@@Return:
290			@Method:
291			@@Name: reset
292			@@Description:
293			@@@lang:en
294			@@@@:
295			Restore current values of form controls to initial values,
296			as the activation of reset buttons do.
297			@@Return:
298			##IF:HTMLFormElement
299
300			IF:
301			@Name: HTMLSelectElement
302			@ISA:
303			DOMHTML:HTMLElement
304			@ElementType:
305			@@QName:
306			xhtml1:select
307			@Attr:
308			@@Name: type
309			@@Description:
310			@@@lang:en
311			@@@@:
312			The type of this form control.
313			@@Get:
314			@@@Type: DOMString
315			@@@InCase:
316			@@@@Value:select-one
317			@@@@Description:
318			@@@@@lang:en
319			@@@@@@:
320			<A:HTMLSelectElement.multiple> is <DOM:false>.
321			@@@InCase:
322			@@@@Value:select-multiple
323			@@@@Description:
324			@@@@@lang:en
325			@@@@@@:
326			<A:HTMLSelectElement.multiple> is <DOM:true>.
327			@@@Def:
328			@@@@Type:
329			lang:Perl
330			@@@@@:
331			__DEEP{
332			$r = $self->multiple ? "select-multiple" : "select-one";
333			}__;
334			@Attr