(w3.info)Data Structures


Next: Miscellaneous Functions Prev: Global Variables Up: Programming Interface

Data Structures
===============

   Form objects are used to store information about a FORM data entry
area.
  1. `'w3form'

  2. A cons pair of (METHOD . URL), where METHOD specifies what method
     to use to retrieve the form when it is submitted (ie: `GET') and
     URL is a fully specified URL pointing at where to submit the FORM
     data to.

  3. The type of input area this is.  (ie: `CHECKBOX' or `RADIO')

  4. The name of the input tag.  This is used when sending the form to
     the server, so that the server can tell what data is what.

  5. The default value of the input area.  Gotten from the INPUT tag at
     creation time.

  6. The current value of the input area.

  7. Whether the item is checked or not.  Only used for RADIO or
     CHECKBOX items.

  8. The size (in characters) of the input area.  Not used for CHECKBOX,
     RADIO, or TEXTAREA input areas.

  9. The maximum length of the input.  Only used for TEXT or PASSWORD
     input areas.

 10. The form that this input area belongs to.  Each form in the same
     buffer has a unique identifier assigned when the document is
     parsed.  It is used when the form is submitted to get only the
     data for the correct form.

 11. A list of strings that represent the choices for this input area.
     Only used for SELECT tags.

   A new development in the World Wide Web is the concept of collapsible
areas of text.  If a zone controls one of these regions, it will be
marked with the w3expandlist property.  The format of this structure is:

  1. `'w3expandlist'

  2. A marker representing the start of the hidden text as a buffer
     position.

  3. A marker representing the end of the hidden text as a buffer
     position.

   A zone with the w3graphic property is a link to an inlined image's
source file.
  1. `'w3graphic'

  2. The full URL of the inlined image.  This is only ever returned if
     the inlined image is the only extent under point, or
     `w3-follow-inlined-image' is invoked.

   A zone with the w3 property is a full-fledged hypertext link to
another document.
  1. `'w3'

  2. The ID attribute of this link.  Used for resolving references to
     specific points within a document (ie: `file.html#sectionA'.

  3. The HREF attribute of this link.  This is a fully specified URL
     pointing at a network resource.  All relative directory references
     should have been removed before being stored in this structure.

  4. The text between the <A> and </A> tags.  This is used to build
     menus or to get the text of a link without doing a
     buffer-substring.

  5. The URN attribute of this link.  Currently not used for anything,
     waiting for the URN specification to be hammered out.

  6. The REL attribute of this link.  Specifies the links relevance to
     the current document.

  7. The REV attribute of this link.  Specifies the current documents
     relevance to the link.

  8. The METHODS attribute, which tells what methods can be used on this
     link.  (ie: `GET, HEAD, PUT'.


automatically generated by info2www