You are looking at historical revision 16508 of this page. It may differ significantly from its current revision.
html-utils
Introduction
html-tags is an extension which provides procedures to ease the generation of some frequently used [X]HTML structures.
Author
Procedures
[procedure] (itemize ITEMS #!key LIST-ID LIST-CLASS QUOTE-PROCEDURE)Generates an HTML unordered list of ITEMS. The following attributes may be used:
- LIST-ID: the value for the HTML id attribute for the list.
- LIST-CLASS: the value for the HTML class attribute for the list.
- QUOTE-PROCEDURE: an one-argument procedure to specify the quoting of attributes' values for tags.
Generates an HTML ordered list of ITEMS. See itemize.
[procedure] (html-page CONTENTS #!key CSS TITLE (DOCTYPE "") (HEADERS "") CHARSET)Generates an HTML page containing CONTENTS (a string). If contents starts with "<body" (case insensitive), html-page won't use the <body> tag to enclose CONTENS. The following keywords arguments may be used to customize the page:
- HEADERS: a string containing additional headers to be inserted in the section delimited by the <header> tag. Default = "".
- TITLE: the title for the page (to be used in the <title> tag). Default = "".
- CSS: may be either a path to a Cascading Style Sheet file, to be linked from the generated page (the default value is #f, so no CSS is used) or a list of paths to CSS files. If a list of paths is used, the elements which are also lists are read and inlined into the generated page. Example: css: '("css1.css" ("css2.css")). In the example, css1.css would be linked from the generated page (using the link tag) and css2.css would be inlined into the generated page (e.g., html-page would read the css2.css file and inline its contents in the HTML code).
- DOCTYPE: specifies the document type of the generated page. The default value is doctype:html-4.01-strict. The possible values are the ones available from the doctype egg.
- CHARSET: specifies the default charset to be used in the corresponding meta tag of the document. The default value is "iso-8859-1".
Generates an HTML combo box using <select> and <option> tags. The keyword parameters ID, ONCHANGE, ONKEYUP, DISABLED, LENGTH, MULTIPLE, SELECTEDINDEX, SIZE, TABINDEX, TYPE and CLASS are passed to the <select> procedure (from html-tags). DEFAULT is the value from the list of options to be selected. If FIRST-EMPTY is #t, the first option of the combo box will be empty.
<example> <expr>(combo-box "test" '(#(1 1) #(2 2) #(3 3)) first-empty: #t default: 2)</expr> <result>"<select name='test' id='test'><option></option><option value='1'>1</option><option value='2' selected>2</option><option value='3'>3</option></select>"</result> </example>
[procedure] (hidden-input NAME/LIST #!optional VALUE ID)Generates an HTML hidden input field. NAME/LIST can be either a string representing the name attribute of the HTML input tag or an alist mapping names to values to be used by the corresponding input tags. When NAME/LIST is a string, so representing the name of the input tag, the optional values VALUE and ID can be used to be represent the values of their corresponding HTML attributes.
[procedure] (tabularize ITEMS #!key TABLE-ID TABLE-CLASS QUOTE-PROCEDURE EVEN-ROW-CLASS ODD-ROW-CLASS)Generates an HTML table from ITEMS (a list of lists). The following keyword parameters may be used:
- TABLE-ID: the value for the HTML id attribute for the table.
- TABLE-CLASS: the value for the HTML class attribute for the table.
- QUOTE-PROCEDURE: an one-argument procedure to specify the quoting of attributes' values for tags.
- EVEN-ROW-CLASS: the value for the HTML class attribute for even rows of the the table.
- ODD-ROW-CLASS: the value for the HTML class attribute for odd rows of the the table.
Examples
<example> <expr>(tabularize '((1 2 3) (4 5 6)))</expr> <result>"<table><tr><td>1</td><td>2</td><td>3</td></tr><tr><td>4</td><td>5</td><td>6</td></tr></table>"</result> </example>
<example> <expr>(tabularize '((1 2 3) (4 5 6)) table-id: "test" even-row-class: "yellow" odd-row-class: "blue")</expr> <result>"<table id='test'><tr class='yellow'><td>1</td><td>2</td><td>3</td></tr><tr class='blue'><td>4</td><td>5</td><td>6</td></tr></table>"</result> </example>
License
BSD
Requirements
Version history
- 0.1
- Initial release