1: # The LearningOnline Network with CAPA
2: # edit mode helpers
3: #
4: # $Id: edit.pm,v 1.49 2003/05/06 11:54:08 www Exp $
5: #
6: # Copyright Michigan State University Board of Trustees
7: #
8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
9: #
10: # LON-CAPA is free software; you can redistribute it and/or modify
11: # it under the terms of the GNU General Public License as published by
12: # the Free Software Foundation; either version 2 of the License, or
13: # (at your option) any later version.
14: #
15: # LON-CAPA is distributed in the hope that it will be useful,
16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18: # GNU General Public License for more details.
19: #
20: # You should have received a copy of the GNU General Public License
21: # along with LON-CAPA; if not, write to the Free Software
22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23: #
24: # /home/httpd/html/adm/gpl.txt
25: #
26: # http://www.lon-capa.org/
27: #
28: # 3/20 Guy
29: # 01/10/02 Matthew
30: # 03/06/02 Matthew
31: package Apache::edit;
32:
33: use strict;
34: use Apache::lonnet();
35: use HTML::Entities();
36:
37: # Global Vars
38: # default list of colors to use in editing
39: @Apache::edit::colorlist=('#ffffff','#ff0000','#00ff00','#0000ff','#0ff000','#000ff0','#f0000f');
40: # depth of nesting of edit
41: $Apache::edit::colordepth=0;
42: @Apache::edit::inserttag=();
43: # image-type responses: active background image and curdepth at definition
44: $Apache::edit::bgimgsrc='';
45: $Apache::edit::bgimgsrccurdepth='';
46:
47: sub initialize_edit {
48: $Apache::edit::colordepth=0;
49: @Apache::edit::inserttag=();
50: }
51:
52: sub tag_start {
53: my ($target,$token,$description) = @_;
54: my $result='';
55: if ($target eq "edit") {
56: my $tag=$token->[1];
57: if (!$description) {
58: $description=&Apache::lonxml::description($token);
59: if (!$description) { $description="<$tag>"; }
60: }
61: $result.= &start_table($token)."<tr><td>$description</td>
62: <td>Delete".
63: &deletelist($target,$token)
64: ."</td>
65: <td>".
66: &insertlist($target,$token).&end_row().&start_spanning_row();
67: #<td>".
68: # &movebuttons($target,$token).
69: # "</tr><tr><td colspan=\"3\">\n";
70: }
71: return $result;
72: }
73:
74: sub tag_end {
75: my ($target,$token,$description) = @_;
76: my $result='';
77: if ($target eq 'edit') {
78: my $tag=$token->[1];
79: if (!defined($description)) {
80: $result.="</td></tr><tr><td></$tag></td><td colspan=\"2\"> </td>";
81: } else {
82: if ($description ne '') { $result.="</td></tr><tr><td>$description</td><td colspan=\"2\"> </td>"; }
83: }
84: $result.="</tr>".&end_table()."\n";
85: }
86: return $result;
87: }
88:
89: sub start_table {
90: my ($token)=@_;
91: my $tag = $token->[1];
92: my $tagnum;
93: foreach my $namespace (reverse @Apache::lonxml::namespace) {
94: my $testtag=$namespace.'::'.$tag;
95: $tagnum=$Apache::lonxml::insertlist{"$testtag.num"};
96: if (defined($tagnum)) { last; }
97: }
98: if (!defined ($tagnum)) { $tagnum=$Apache::lonxml::insertlist{"$tag.num"}; }
99: my $color = $Apache::lonxml::insertlist{"$tagnum.color"};
100: if (!defined($color)) {
101: $color = $Apache::edit::colorlist[$Apache::edit::colordepth];
102: }
103: $Apache::edit::colordepth++;
104: push(@Apache::edit::inserttag,$token->[1]);
105: my $result='<div align="right">';
106: $result.='<table bgcolor="'.$color.'" width="97%" border="0" cellspacing="5" cellpadding="3">';
107: return $result;
108: }
109:
110: sub end_table {
111: $Apache::edit::colordepth--;
112: my $result='</table></div>';
113: $result.="<table><tr><td>";
114:
115: my ($tagname,$closingtag);
116: if (defined($Apache::edit::inserttag[-2])) {
117: $tagname=$Apache::edit::inserttag[-2];
118: } else {$tagname='problem';}
119: if (defined($Apache::edit::inserttag[-1])) {
120: $closingtag=$Apache::edit::inserttag[-1];
121: }
122: $result.=&innerinsertlist('edit',$tagname,$closingtag).
123: "</td></tr></table>";
124: pop(@Apache::edit::inserttag);
125: return $result;
126: }
127:
128: sub start_spanning_row { return '<tr><td colspan="3" bgcolor="#DDDDDD">';}
129: sub start_row { return '<tr><td bgcolor="#DDDDDD">'; }
130: sub end_row { return '</td></tr>'; }
131:
132: sub movebuttons {
133: my ($target,$token) = @_;
134: my $result='<input type="submit" name="moveup.'.
135: $Apache::lonxml::curdepth.'" value="Move Up" />';
136: $result.='<input type="submit" name="movedown.'.
137: $Apache::lonxml::curdepth.'" value="Move Down" />';
138: return $result;
139: }
140:
141: sub deletelist {
142: my ($target,$token) = @_;
143: my $result = "<select name=\"delete_$Apache::lonxml::curdepth\">
144: <option></option>
145: <option>Yes</option>
146: </select>";
147: return $result;
148: }
149:
150: sub handle_delete {
151: if (!$ENV{"form.delete_$Apache::lonxml::curdepth"}) { return ''; }
152: my ($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
153: my $result=0;
154: if ($space) {
155: my $sub1="$space\:\:delete_$token->[1]";
156: {
157: no strict 'refs';
158: if (defined &$sub1) {
159: $result=&$sub1($target,$token,$tagstack,$parstack,$parser,$safeeval,$style);
160: }
161: }
162: }
163: if (!$result) {
164: my $endtag='/'.$token->[1];
165: my $bodytext=&Apache::lonxml::get_all_text($endtag,$parser);
166: $$parser['-1']->get_token();
167: &Apache::lonxml::debug("Deleting :$bodytext: for $token->[1]");
168: &Apache::lonxml::end_tag($tagstack,$parstack,$token);
169: }
170: return 1;
171: }
172:
173: sub get_insert_list {
174: my ($tagname) = @_;
175: my $result='';
176: my @tagnums= ();
177: #&Apache::lonxml::debug("keys ".join("\n",sort(keys(%Apache::lonxml::insertlist))));
178: if ($Apache::lonxml::insertlist{"$tagname.which"}) {
179: push (@tagnums, @{ $Apache::lonxml::insertlist{"$tagname.which"} });
180: }
181: foreach my $namespace (@Apache::lonxml::namespace) {
182: if ($Apache::lonxml::insertlist{"$namespace".'::'."$tagname.which"}) {
183: push (@tagnums, @{ $Apache::lonxml::insertlist{"$namespace".'::'."$tagname.which"} });
184: }
185: }
186: if (@tagnums) {
187: my %options;
188: foreach my $tagnum (@tagnums) {
189: my $descrip=$Apache::lonxml::insertlist{"$tagnum.description"};
190: $options{$descrip} ="<option value=\"$tagnum\">".$descrip."</option>\n";
191: }
192: foreach my $option (sort(keys(%options))) { $result.=$options{$option}; }
193: if ($result) { $result='<option selected="on"></option>'.$result; }
194: }
195: return $result;
196: }
197:
198: sub insertlist {
199: my ($target,$token) = @_;
200: return &innerinsertlist($target,$token->[1]);
201: }
202:
203: sub innerinsertlist {
204: my ($target,$tagname,$closingtag) = @_;
205: my $result;
206: my $after='';
207: if ($closingtag) {
208: $after='_after_'.$closingtag;
209: }
210: if ($target eq 'edit') {
211: my $optionlist= &get_insert_list($tagname);
212: if ($optionlist) {
213: $result = "Insert:
214: <select name=\"insert$after\_$Apache::lonxml::curdepth\">
215: $optionlist
216: </select>"
217: } else {
218: $result=" ";
219: }
220: }
221: return $result;
222: }
223:
224: sub handle_insert {
225: if ($ENV{"form.insert_$Apache::lonxml::curdepth"} eq '') { return ''; }
226: my $result;
227: my $tagnum = $ENV{"form.insert_$Apache::lonxml::curdepth"};
228: my $func=$Apache::lonxml::insertlist{"$tagnum.function"};
229: if ($func eq 'default') {
230: my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
231: my $namespace;
232: if ($newtag =~ /::/) { ($namespace,$newtag) = split(/::/,$newtag); }
233: $result.="\n<$newtag>\n</$newtag>";
234: } else {
235: if (defined(&$func)) {
236: {
237: no strict 'refs';
238: $result.=&$func();
239: }
240: } else {
241: my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
242: &Apache::lonxml::error("Unable to insert tag $newtag, $func was not defined.");
243: }
244: }
245: return $result;
246: }
247:
248: sub handle_insertafter {
249: my $tagname=shift;
250: if ($ENV{"form.insert_after_$tagname\_$Apache::lonxml::curdepth"} eq '')
251: { return ''; }
252: my $result;
253: my $tagnum =$ENV{"form.insert_after_$tagname\_$Apache::lonxml::curdepth"};
254: my $func=$Apache::lonxml::insertlist{"$tagnum.function"};
255: if ($func eq 'default') {
256: my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
257: my $namespace;
258: if ($newtag =~ /::/) { ($namespace,$newtag) = split(/::/,$newtag); }
259: $result.="\n<$newtag>\n</$newtag>";
260: } else {
261: if (defined(&$func)) {
262: {
263: no strict 'refs';
264: $result.=&$func();
265: }
266: } else {
267: my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
268: &Apache::lonxml::error("Unable to insert (after) tag $newtag, $func was not defined. ($tagname $tagnum)");
269: }
270: }
271: return $result;
272: }
273:
274: sub insert_responseparam {
275: return '
276: <responseparam />';
277: }
278:
279: sub insert_formularesponse {
280: return '
281: <formularesponse answer="" samples="">
282: <textline />
283: <hintgroup>
284: </hintgroup>
285: </formularesponse>';
286: }
287:
288: sub insert_numericalresponse {
289: return '
290: <numericalresponse answer="">
291: <textline />
292: <hintgroup>
293: </hintgroup>
294: </numericalresponse>';
295: }
296:
297: sub insert_stringresponse {
298: return '
299: <stringresponse answer="" type="">
300: <textline />
301: <hintgroup>
302: </hintgroup>
303: </stringresponse>';
304: }
305:
306: sub insert_essayresponse {
307: return '
308: <essayresponse>
309: <textfield></textfield>
310: </essayresponse>';
311: }
312:
313: sub insert_optionresponse {
314: return '
315: <optionresponse max="10">
316: <foilgroup options="">
317: </foilgroup>
318: <hintgroup>
319: </hintgroup>
320: </optionresponse>';
321: }
322:
323: sub insert_radiobuttonresponse {
324: return '
325: <radiobuttonresponse max="10">
326: <foilgroup>
327: </foilgroup>
328: <hintgroup>
329: </hintgroup>
330: </radiobuttonresponse>';
331: }
332:
333: sub insert_rankresponse {
334: return '
335: <rankresponse max="10">
336: <foilgroup options="">
337: </foilgroup>
338: <hintgroup>
339: </hintgroup>
340: </rankresponse>';
341: }
342:
343: sub insert_matchresponse {
344: return '
345: <matchresponse max="10">
346: <foilgroup options="">
347: <itemgroup>
348: </itemgroup>
349: </foilgroup>
350: <hintgroup>
351: </hintgroup>
352: </matchresponse>';
353: }
354:
355: sub insert_displayduedate { return '<displayduedate />'; }
356: sub insert_displaytitle { return '<displaytitle />'; }
357: sub insert_hintpart {
358: return '
359: <hintpart on="default">
360: <startouttext/>
361: <endouttext />
362: </hintpart>';
363: }
364:
365: sub insert_numericalhint {
366: return '
367: <numericalhint>
368: </numericalhint>';
369: }
370:
371: sub insert_stringhint {
372: return '
373: <stringhint>
374: </stringhint>';
375: }
376:
377: sub insert_formulahint {
378: return '
379: <formulahint>
380: </formulahint>';
381: }
382:
383: sub insert_radiobuttonhint {
384: return '
385: <radiobuttonhint>
386: </radiobuttonhint>';
387: }
388:
389: sub insert_startouttext {
390: return "<startouttext />\n<endouttext />";
391: }
392:
393: sub insert_script {
394: return "\n<script type=\"loncapa/perl\">\n</script>";
395: }
396:
397: sub textarea_sizes {
398: my ($data)=@_;
399: my $count=0;
400: my $maxlength=-1;
401: foreach (split ("\n", $$data)) { $count++;
402: if (length($_) > $maxlength) { $maxlength = length($_); }
403: }
404: my $rows = $count;
405: my $cols = $maxlength;
406: return ($rows,$cols);
407: }
408:
409: sub editline {
410: my ($tag,$data,$description,$size)=@_;
411: $data=&HTML::Entities::encode($data);
412: if ($description) { $description="<br />".$description."<br />"; }
413: my $result = <<"END";
414: $description
415: <input type="text" name="homework_edit_$Apache::lonxml::curdepth"
416: value="$data" size="$size" />
417: END
418: return $result;
419: }
420:
421: sub editfield {
422: my ($tag,$data,$description,$minwidth,$minheight)=@_;
423:
424: my ($rows,$cols)=&textarea_sizes(\$data);
425: if ($cols > 80) { $cols = 80; }
426: if ($cols < $minwidth ) { $cols = $minwidth; }
427: if ($rows < $minheight) { $rows = $minheight; }
428: if ($description) { $description="<br />".$description."<br />"; }
429: return $description."\n".' <textarea rows="'.$rows.
430: '" cols="'.$cols.'" name="homework_edit_'.$Apache::lonxml::curdepth.'">'.
431: &HTML::Entities::encode($data).'</textarea>'."\n";
432: }
433:
434: sub modifiedfield {
435: my ($token) = @_;
436: my $result;
437: # foreach my $envkey (sort keys %ENV) {
438: # &Apache::lonxml::debug("$envkey ---- $ENV{$envkey}");
439: # }
440: # &Apache::lonxml::debug("I want homework_edit_$Apache::lonxml::curdepth");
441: # &Apache::lonxml::debug($ENV{"form.homework_edit_$Apache::lonxml::curdepth"});
442: $result=$ENV{"form.homework_edit_$Apache::lonxml::curdepth"};
443: return $result;
444: }
445:
446: # Returns a 1 if the token has been modified and you should rebuild the tag
447: # side-effects, will modify the $token if new values are found
448: sub get_new_args {
449: my ($token,$parstack,$safeeval,@args)=@_;
450: my $rebuild=0;
451: foreach my $arg (@args) {
452: #just want the string that it was set to
453: my $value=$token->[2]->{$arg};
454: my $element=&html_element_name($arg);
455: my $newvalue=$ENV{"form.$element"};
456: &Apache::lonxml::debug(" for:$arg: cur is :$value: new is :$newvalue:");
457: if ($value ne $newvalue) {
458: $token->[2]->{$arg}=$newvalue;
459: $rebuild=1;
460: }
461: }
462: return $rebuild;
463: }
464:
465: # looks for /> on start tags
466: sub rebuild_tag {
467: my ($token) = @_;
468: my $result;
469: if ($token->[0] eq 'S') {
470: $result = '<'.$token->[1];
471: while (my ($key,$val)= each(%{$token->[2]})) {
472: $val=~s:^\s+|\s+$::g;
473: $val=~s:"::g; #"
474: &Apache::lonxml::debug("setting :$key: to :$val:");
475: $result.=' '.$key.'="'.$val.'"';
476: }
477: if ($token->[4] =~ m:/>$:) {
478: $result.=' />';
479: } else {
480: $result.='>';
481: }
482: } elsif ( $token->[0] eq 'E' ) {
483: $result = '</'.$token->[1].'>';
484: }
485: return $result;
486: }
487:
488: sub html_element_name {
489: my ($name) = @_;
490: return $name.'_'.$Apache::lonxml::curdepth;
491: }
492:
493: sub hidden_arg {
494: my ($name,$token) = @_;
495: my $result;
496: my $arg=$token->[2]{$name};
497: $result='<input name="'.&html_element_name($name).
498: '" type="hidden" value="'.$arg.'" />';
499: return $result;
500: }
501:
502: sub text_arg {
503: my ($description,$name,$token,$size) = @_;
504: my $result;
505: if (!defined $size) { $size=20; }
506: my $arg=$token->[2]{$name};
507: $result=$description.' <input name="'.&html_element_name($name).
508: '" type="text" value="'.$arg.'" size="'.$size.'" />';
509: return $result;
510: }
511:
512: sub select_arg {
513: my ($description,$name,$list,$token) = @_;
514: my $result;
515: my $optionlist="";
516: my $selected=$token->[2]{$name};
517: foreach my $option (@$list) {
518: my $value;
519: if ( ref($option) eq 'ARRAY') {
520: $value='value="'.$$option[0].'"';
521: $option=$$option[1];
522: } else {
523: $value='value="'.$option.'"';
524: }
525: if ( $selected eq $option ) {
526: $optionlist.="<option $value selected=\"on\">$option</option>\n";
527: } else {
528: $optionlist.="<option $value >$option</option>\n";
529: }
530: }
531: $result.=$description.' <select name="'.&html_element_name($name).
532: '">
533: '.$optionlist.'
534: </select>';
535: return $result;
536: }
537:
538: sub select_or_text_arg {
539: my ($description,$name,$list,$token,$size) = @_;
540: my $result;
541: my $optionlist="";
542: my $found=0;
543: my $selected=$token->[2]{$name};
544: foreach my $option (@$list) {
545: my $value;
546: if ( ref($option) eq 'ARRAY') {
547: $value='value="'.$$option[0].'"';
548: $option=$$option[1];
549: } else {
550: $value='value="'.$option.'"';
551: }
552: if ( $selected eq $option ) {
553: $optionlist.="<option $value selected=\"on\">$option</option>\n";
554: $found=1;
555: } else {
556: $optionlist.="<option $value>$option</option>\n";
557: }
558: }
559: $optionlist.="<option value=\"TYPEDINVALUE\">Type in value</option>\n";
560: if (($found) || (!$selected)) {
561: $result.=$description.' <select name="'.&html_element_name($name)
562: .'">
563: '.$optionlist.'
564: </select>';
565: } else {
566: $result.=&text_arg($description,$name,$token,$size);
567: }
568: return $result;
569: }
570:
571: #----------------------------------------------------- image coordinates
572: # single image coordinates, x, y
573: sub entercoords {
574: my ($idx,,$idy,$mode,$width,$height) = @_;
575: unless ($Apache::edit::bgimgsrc) { return ''; }
576: if ($idx) { $idx.='_'; }
577: if ($idy) { $idy.='_'; }
578: my $bgfile=&Apache::lonnet::escape($Apache::edit::bgimgsrc);
579: my $form = 'lonhomework';
580: my $element;
581: if (! defined($mode) || $mode eq 'attribute') {
582: $element = &Apache::lonnet::escape("$Apache::lonxml::curdepth");
583: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
584: $element = &Apache::lonnet::escape('homework_edit_'.
585: $Apache::lonxml::curdepth);
586: }
587: my $formheight='';
588: if ($height) {
589: $formheight='&formheight='.$height.'_'.$Apache::edit::bgimgsrccurdepth;
590: }
591: my $formwidth='';
592: if ($width) {
593: $formwidth='&formwidth='.$width.'_'.$Apache::edit::bgimgsrccurdepth;
594: }
595: my $result = <<"ENDBUTTON";
596: <a href="/cgi-bin/imagechoice.pl?formname=$form&file=$bgfile&formx=$idx$element&formy=$idy$element$formheight$formwidth"
597: target="imagechoice">Click Coordinates</a>
598: ENDBUTTON
599: return $result;
600: }
601:
602: # coordinate pair (x1,y1)-(x2,y2)
603: sub entercoordpair {
604: my ($id,$mode,$width,$height) = @_;
605: unless ($Apache::edit::bgimgsrc) { return ''; }
606: my $bgfile=&Apache::lonnet::escape($Apache::edit::bgimgsrc);
607: my $form = 'lonhomework';
608: my $element;
609: if (! defined($mode) || $mode eq 'attribute') {
610: $element = &Apache::lonnet::escape("$id\_$Apache::lonxml::curdepth");
611: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
612: $element = &Apache::lonnet::escape('homework_edit_'.
613: $Apache::lonxml::curdepth);
614: }
615: my $formheight='';
616: if ($height) {
617: $formheight='&formheight='.$height.'_'.$Apache::edit::bgimgsrccurdepth;
618: }
619: my $formwidth='';
620: if ($width) {
621: $formwidth='&formwidth='.$width.'_'.$Apache::edit::bgimgsrccurdepth;
622: }
623: my $result = <<"ENDBUTTON";
624: <a href="/cgi-bin/imagechoice.pl?mode=pair&formname=$form&file=$bgfile$formheight$formwidth"
625: target="imagechoice">Click Coordinate Pair</a>
626: ENDBUTTON
627: return $result;
628: }
629: #----------------------------------------------------- browse
630: sub browse {
631: # insert a link to call up the filesystem browser (lonindexer)
632: my ($id, $mode) = @_;
633: my $form = 'lonhomework';
634: my $element;
635: if (! defined($mode) || $mode eq 'attribute') {
636: $element = &Apache::lonnet::escape("$id\_$Apache::lonxml::curdepth");
637: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
638: $element = &Apache::lonnet::escape('homework_edit_'.
639: $Apache::lonxml::curdepth);
640: }
641: my $result = <<"ENDBUTTON";
642: <a href=\"javascript:openbrowser('$form','$element')\"\>Browse</a>
643: ENDBUTTON
644: return $result;
645: }
646:
647: #----------------------------------------------------- browse
648: sub search {
649: # insert a link to call up the filesystem browser (lonindexer)
650: my ($id, $mode) = @_;
651: my $form = 'lonhomework';
652: my $element;
653: if (! defined($mode) || $mode eq 'attribute') {
654: $element = &Apache::lonnet::escape("$id\_$Apache::lonxml::curdepth");
655: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
656: $element = &Apache::lonnet::escape('homework_edit_'.
657: $Apache::lonxml::curdepth);
658: }
659: my $result = <<"ENDBUTTON";
660: <a href=\"javascript:opensearcher('$form','$element')\"\>Search</a>
661: ENDBUTTON
662: return $result;
663: }
664:
665:
666: 1;
667: __END__
668:
669: =head1 NAME
670:
671: Apache::edit - edit mode helpers
672:
673: =head1 SYNOPSIS
674:
675: Invoked by many homework and xml related modules.
676:
677: &Apache::edit::SUBROUTINENAME(ARGUMENTS);
678:
679: =head1 INTRODUCTION
680:
681: This module outputs HTML syntax helpful for the rendering of edit
682: mode interfaces.
683:
684: This is part of the LearningOnline Network with CAPA project
685: described at http://www.lon-capa.org.
686:
687: =head1 HANDLER SUBROUTINE
688:
689: There is no handler subroutine.
690:
691: =head1 OTHER SUBROUTINES
692:
693: =over 4
694:
695: =item *
696:
697: initialize_edit() : initialize edit (set colordepth to zero)
698:
699: =item *
700:
701: tag_start($target,$token,$description) : provide deletion and insertion lists
702: for the manipulation of a start tag; return a scalar string
703:
704: =item *
705:
706: tag_end($target,$token,$description) : ending syntax corresponding to
707: &tag_start. return a scalar string.
708:
709: =item *
710:
711: start_table($token) : start table; update colordepth; return scalar string.
712:
713: =item *
714:
715: end_table() : reduce color depth; end table; return scalar string
716:
717: =item *
718:
719: start_spanning_row() : start a new table row spanning the 'edit' environment.
720:
721: =item *
722:
723: start_row() : start a new table row and element.
724:
725: =item *
726:
727: end_row() : end current table element and row.
728:
729: =item *
730:
731: movebuttons($target,$token) : move-up and move-down buttons; return scalar
732: string
733:
734: =item *
735:
736: deletelist($target,$token) : provide a yes option in an HTML select element;
737: return scalar string
738:
739: =item *
740:
741: handle_delete($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,
742: $style) : respond to a user delete request by passing relevant stack
743: and array information to various rendering functions; return a scalar string
744:
745: =item *
746:
747: get_insert_list($token) : provide an insertion list based on possibilities
748: from lonxml; return a scalar string
749:
750: =item *
751:
752: insertlist($target,$token) : api that uses get_insert_list;
753: return a scalar string
754:
755: =item *
756:
757: handleinsert($token) : provide an insertion list based on possibilities
758: from lonxml; return a scalar string
759:
760: =item *
761:
762: get_insert_list($token) : provide an insertion list based on possibilities
763: from lonxml; return a scalar string
764:
765: =item *
766: browse($elementname) : provide a link which will open up the filesystem
767: browser (lonindexer) and, once a file is selected, place the result in
768: the form element $elementname.
769:
770: =item *
771: search($elementname) : provide a link which will open up the filesystem
772: searcher (lonsearchcat) and, once a file is selected, place the result in
773: the form element $elementname.
774:
775: =item *
776: editline(tag,data,description,size): Provide a <input type="text" ../> for
777: single-line text entry. This is to be used for text enclosed by tags, not
778: arguements/parameters associated with a tag.
779:
780: =back
781:
782: incomplete...
783:
784: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>