1: # The LearningOnline Network with CAPA
2: # edit mode helpers
3: #
4: # $Id: edit.pm,v 1.106 2007/05/22 01:03:35 albertel 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:
29: package Apache::edit;
30:
31: use strict;
32: use Apache::lonnet;
33: use HTML::Entities();
34: use Apache::lonlocal;
35: use lib '/home/httpd/lib/perl/';
36: use LONCAPA;
37:
38:
39: # Global Vars
40: # default list of colors to use in editing
41: @Apache::edit::colorlist=('#ffffff','#ff0000','#00ff00','#0000ff','#0ff000','#000ff0','#f0000f');
42: # depth of nesting of edit
43: $Apache::edit::colordepth=0;
44: @Apache::edit::inserttag=();
45: # image-type responses: active background image and curdepth at definition
46: $Apache::edit::bgimgsrc='';
47: $Apache::edit::bgimgsrccurdepth='';
48:
49: sub initialize_edit {
50: $Apache::edit::colordepth=0;
51: @Apache::edit::inserttag=();
52: }
53:
54: sub tag_start {
55: my ($target,$token,$description) = @_;
56: my $result='';
57: if ($target eq "edit") {
58: my $tag=$token->[1];
59: if (!$description) {
60: $description=&Apache::lonxml::description($token);
61: if (!$description) { $description="<$tag>"; }
62: }
63: $result.= &start_table($token)."<tr><td>$description</td>
64: <td>Delete".
65: &deletelist($target,$token)
66: ."</td>
67: <td>".
68: &insertlist($target,$token);
69: #<td>".
70: # &movebuttons($target,$token).
71: # "</tr><tr><td colspan=\"3\">\n";
72: my @help = Apache::lonxml::helpinfo($token);
73: if ($help[0]) {
74: $result .= '</td><td align="right" valign="top">' .
75: Apache::loncommon::help_open_topic(@help);
76: } else { $result .= "</td><td> "; }
77: $result .= &end_row().&start_spanning_row();
78: }
79: return $result;
80: }
81:
82: sub tag_end {
83: my ($target,$token,$description) = @_;
84: my $result='';
85: if ($target eq 'edit') {
86: $result.="</td></tr>".&end_table()."\n";
87: }
88: return $result;
89: }
90:
91: sub start_table {
92: my ($token)=@_;
93: my $tag = &Apache::lonxml::get_tag($token);
94:
95: my $color = $Apache::lonxml::insertlist{"$tag.color"};
96: &Apache::lonxml::debug(" $tag -- $color");
97: if (!defined($color)) {
98: $color = $Apache::edit::colorlist[$Apache::edit::colordepth];
99: }
100: $Apache::edit::colordepth++;
101: push(@Apache::edit::inserttag,$token->[1]);
102: my $result='<div align="right">';
103: $result.='<table bgcolor="'.$color.'" width="97%" border="0" cellspacing="5" cellpadding="3">';
104: return $result;
105: }
106:
107: sub end_table {
108: $Apache::edit::colordepth--;
109: my $result='</table></div>';
110: $result.='<div align="left"><table><tr><td>';
111:
112: my ($tagname,$closingtag);
113: if (defined($Apache::edit::inserttag[-2])) {
114: $tagname=$Apache::edit::inserttag[-2];
115: } else {
116: if ($Apache::lonhomework::parsing_a_task) {
117: $tagname='Task';
118: } else {
119: $tagname='problem';
120: }
121: }
122: if (defined($Apache::edit::inserttag[-1])) {
123: $closingtag=$Apache::edit::inserttag[-1];
124: }
125: $result.=&innerinsertlist('edit',$tagname,$closingtag).
126: "</td></tr></table></div>";
127: my $last = pop(@Apache::edit::inserttag);
128: return $result;
129: }
130:
131: sub start_spanning_row { return '<tr><td colspan="4" bgcolor="#DDDDDD">';}
132: sub start_row { return '<tr><td bgcolor="#DDDDDD">'; }
133: sub end_row { return '</td></tr>'; }
134:
135: sub movebuttons {
136: my ($target,$token) = @_;
137: my $result='<input type="submit" name="moveup.'.
138: $Apache::lonxml::curdepth.'" value="Move Up" />';
139: $result.='<input type="submit" name="movedown.'.
140: $Apache::lonxml::curdepth.'" value="Move Down" />';
141: return $result;
142: }
143:
144: sub deletelist {
145: my ($target,$token) = @_;
146: my $result = "<select name=\"delete_$Apache::lonxml::curdepth\">
147: <option></option>
148: <option>Yes</option>
149: </select>";
150: return $result;
151: }
152:
153: sub handle_delete {
154: if (!$env{"form.delete_$Apache::lonxml::curdepth"}) { return ''; }
155: my ($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
156: my $result=0;
157: if ($space) {
158: my $sub1="$space\:\:delete_$token->[1]";
159: {
160: no strict 'refs';
161: if (defined &$sub1) {
162: $result=&$sub1($target,$token,$tagstack,$parstack,$parser,$safeeval,$style);
163: }
164: }
165: }
166: if (!$result) {
167: my $endtag='/'.$token->[1];
168: my $bodytext=&Apache::lonxml::get_all_text($endtag,$parser,$style);
169: $$parser['-1']->get_token();
170: &Apache::lonxml::debug("Deleting :$bodytext: for $token->[1]");
171: &Apache::lonxml::end_tag($tagstack,$parstack,$token);
172: }
173: return 1;
174: }
175:
176: sub get_insert_list {
177: my ($tagname) = @_;
178: my $result='';
179: my @tags= ();
180: #&Apache::lonxml::debug("keys ".join("\n",sort(keys(%Apache::lonxml::insertlist))));
181: if ($Apache::lonxml::insertlist{"$tagname.which"}) {
182: push (@tags, @{ $Apache::lonxml::insertlist{"$tagname.which"} });
183: }
184: foreach my $namespace (@Apache::lonxml::namespace) {
185: if ($Apache::lonxml::insertlist{"$namespace".'::'."$tagname.which"}) {
186: push (@tags, @{ $Apache::lonxml::insertlist{"$namespace".'::'."$tagname.which"} });
187: }
188: }
189: if (@tags) {
190: my %options;
191: foreach my $tag (@tags) {
192: my $descrip=$Apache::lonxml::insertlist{"$tag.description"};
193: my $tagnum =$Apache::lonxml::insertlist{"$tag.num"};
194: $options{$descrip} ="<option value=\"$tagnum\">".
195: $descrip."</option>\n";
196: }
197: foreach my $option (sort(keys(%options))) {$result.=$options{$option};}
198: if ($result) { $result='<option selected="selected"></option>'.$result; }
199: }
200: return $result;
201: }
202:
203: sub insertlist {
204: my ($target,$token) = @_;
205: return &innerinsertlist($target,$token->[1]);
206: }
207:
208: sub innerinsertlist {
209: my ($target,$tagname,$closingtag) = @_;
210: my $result;
211: my $after='';
212: if ($closingtag) {
213: $after='_after_'.$closingtag;
214: }
215: if ($target eq 'edit') {
216: my $optionlist= &get_insert_list($tagname);
217: if ($optionlist) {
218: $result = "Insert:
219: <select name=\"insert$after\_$Apache::lonxml::curdepth\">
220: $optionlist
221: </select>"
222: } else {
223: $result=" ";
224: }
225: }
226: return $result;
227: }
228:
229: sub handle_insert {
230: if ($env{"form.insert_$Apache::lonxml::curdepth"} eq '') { return ''; }
231: my $tagnum = $env{"form.insert_$Apache::lonxml::curdepth"};
232: return &do_insert($tagnum);
233: }
234:
235: sub handle_insertafter {
236: my $tagname=shift;
237: if ($env{"form.insert_after_$tagname\_$Apache::lonxml::curdepth"} eq '') {
238: return '';
239: }
240: my $tagnum =$env{"form.insert_after_$tagname\_$Apache::lonxml::curdepth"};
241: return &do_insert($tagnum,1);
242: }
243:
244: sub do_insert {
245: my ($tagnum,$after) = @_;
246: my $result;
247:
248: my $newtag = $Apache::lonxml::insertlist{"$tagnum.tag"};
249: my $func = $Apache::lonxml::insertlist{"$newtag.function"};
250: if ($func eq 'default') {
251: my $namespace;
252: if ($newtag =~ /::/) { ($namespace,$newtag) = split(/::/,$newtag); }
253: my $depth = scalar(@Apache::lonxml::depthcounter);
254: $depth -- if ($after);
255: my $inset = "\t"x$depth;
256: $result.="\n$inset<$newtag>\n$inset</$newtag>";
257: } else {
258: if (defined(&$func)) {
259: {
260: no strict 'refs';
261: $result.=&$func();
262: }
263: } else {
264: &Apache::lonxml::error("Unable to insert tag $newtag, $func was not defined. ($tagnum)");
265: }
266: }
267: return $result;
268: }
269:
270: sub insert_img {
271: return '
272: <img />';
273: }
274:
275: sub insert_responseparam {
276: return '
277: <responseparam />';
278: }
279:
280: sub insert_parameter {
281: return '
282: <parameter />';
283: }
284:
285: sub insert_formularesponse {
286: return '
287: <formularesponse answer="" samples="">
288: <responseparam description="Numerical Tolerance" type="tolerance" default="0.00001" name="tol" />
289: <textline size="25"/>
290: <hintgroup>
291: <startouttext /><endouttext />
292: </hintgroup>
293: </formularesponse>';
294: }
295:
296: sub insert_numericalresponse {
297: return '
298: <numericalresponse answer="">
299: <responseparam type="tolerance" default="5%" name="tol" description="Numerical Tolerance" />
300: <responseparam name="sig" type="int_range,0-16" default="0,15" description="Significant Figures" />
301: <textline />
302: <hintgroup>
303: <startouttext /><endouttext />
304: </hintgroup>
305: </numericalresponse>';
306: }
307:
308: sub insert_customresponse {
309: return '
310: <customresponse>
311: <answer type="loncapa/perl">
312: </answer>
313: <textline />
314: <hintgroup>
315: <startouttext /><endouttext />
316: </hintgroup>
317: </customresponse>';
318: }
319:
320: sub insert_customresponse_answer {
321: return '
322: <answer type="loncapa/perl">
323: </answer>
324: ';
325: }
326:
327: sub insert_customhint {
328: return '
329: <customhint>
330: <answer type="loncapa/perl">
331: </answer>
332: </customhint>';
333: }
334:
335: sub insert_customhint_answer {
336: return '
337: <answer type="loncapa/perl">
338: </answer>
339: ';
340: }
341:
342: sub insert_mathresponse {
343: return '
344: <mathresponse>
345: <answer>
346: </answer>
347: <textline />
348: <hintgroup>
349: <startouttext />
350: <endouttext />
351: </hintgroup>
352: </mathresponse>';
353: }
354:
355: sub insert_mathresponse_answer {
356: return '
357: <answer>
358: </answer>
359: ';
360: }
361:
362: sub insert_mathhint {
363: return '
364: <mathhint>
365: <answer>
366: </answer>
367: </mathhint>';
368: }
369:
370: sub insert_mathhint_answer {
371: return '
372: <answer>
373: </answer>
374: ';
375: }
376:
377: sub insert_stringresponse {
378: return '
379: <stringresponse answer="" type="">
380: <textline />
381: <hintgroup>
382: <startouttext /><endouttext />
383: </hintgroup>
384: </stringresponse>';
385: }
386:
387: sub insert_essayresponse {
388: return '
389: <essayresponse>
390: <textfield></textfield>
391: </essayresponse>';
392: }
393:
394: sub insert_imageresponse {
395: return '
396: <imageresponse max="1">
397: <foilgroup>
398: <foil>
399: </foil>
400: </foilgroup>
401: <hintgroup>
402: <startouttext /><endouttext />
403: </hintgroup>
404: </imageresponse>';
405: }
406:
407: sub insert_optionresponse {
408: return '
409: <optionresponse max="10">
410: <foilgroup options="">
411: <foil>
412: <startouttext /><endouttext />
413: </foil>
414: </foilgroup>
415: <hintgroup>
416: <startouttext /><endouttext />
417: </hintgroup>
418: </optionresponse>';
419: }
420:
421: sub insert_organicresponse {
422: return '
423: <organicresponse>
424: <textline />
425: <hintgroup>
426: <startouttext /><endouttext />
427: </hintgroup>
428: </organicresponse>';
429: }
430:
431: sub insert_organicstructure {
432: return '
433: <organicstructure />
434: ';
435: }
436:
437: sub insert_radiobuttonresponse {
438: return '
439: <radiobuttonresponse max="10">
440: <foilgroup>
441: <foil>
442: <startouttext /><endouttext />
443: </foil>
444: </foilgroup>
445: <hintgroup>
446: <startouttext /><endouttext />
447: </hintgroup>
448: </radiobuttonresponse>';
449: }
450:
451: sub insert_reactionresponse {
452: return '
453: <reactionresponse>
454: <textline />
455: <hintgroup>
456: <startouttext /><endouttext />
457: </hintgroup>
458: </reactionresponse>';
459: }
460:
461: sub insert_rankresponse {
462: return '
463: <rankresponse max="10">
464: <foilgroup options="">
465: <foil>
466: <startouttext /><endouttext />
467: </foil>
468: </foilgroup>
469: <hintgroup>
470: <startouttext /><endouttext />
471: </hintgroup>
472: </rankresponse>';
473: }
474:
475: sub insert_matchresponse {
476: return '
477: <matchresponse max="10">
478: <foilgroup options="">
479: <itemgroup>
480: </itemgroup>
481: <foil>
482: <startouttext /><endouttext />
483: </foil>
484: </foilgroup>
485: <hintgroup>
486: <startouttext /><endouttext />
487: </hintgroup>
488: </matchresponse>';
489: }
490:
491: sub insert_displayduedate { return '<displayduedate />'; }
492: sub insert_displaytitle { return '<displaytitle />'; }
493: sub insert_hintpart {
494: return '
495: <hintpart on="default">
496: <startouttext/><endouttext />
497: </hintpart>';
498: }
499:
500: sub insert_hintgroup {
501: return '
502: <hintgroup>
503: <startouttext /><endouttext />
504: </hintgroup>';
505: }
506:
507: sub insert_numericalhint {
508: return '
509: <numericalhint>
510: </numericalhint>';
511: }
512:
513: sub insert_stringhint {
514: return '
515: <stringhint>
516: </stringhint>';
517: }
518:
519: sub insert_formulahint {
520: return '
521: <formulahint>
522: </formulahint>';
523: }
524:
525: sub insert_radiobuttonhint {
526: return '
527: <radiobuttonhint>
528: </radiobuttonhint>';
529: }
530:
531: sub insert_optionhint {
532: return '
533: <optionhint>
534: </optionhint>';
535: }
536:
537: sub insert_startouttext {
538: return "<startouttext /><endouttext />";
539: }
540:
541: sub insert_script {
542: return "\n<script type=\"loncapa/perl\"></script>";
543: }
544:
545: sub js_change_detection {
546: my $unsaved=&mt("There are unsaved changes");
547: return (<<SCRIPT);
548: <script type="text/javascript">
549: var clean = true;
550: var is_submit = false;
551: var still_ask = false;
552: function compareForm(event_) {
553: if (!event_ && window.event) {
554: event_ = window.event;
555: }
556: if ((!is_submit || (is_submit && still_ask)) && !clean) {
557: still_ask = false;
558: is_submit = false;
559: event_.returnValue = "$unsaved";
560: return "$unsaved";
561: }
562: }
563: function unClean() {
564: clean=false;
565: }
566: window.onbeforeunload = compareForm;
567: </script>
568: SCRIPT
569: }
570:
571: sub form_change_detection {
572: return ' onsubmit="is_submit=true;" ';
573: }
574:
575: sub element_change_detection {
576: return ' onchange="unClean();" ';
577: }
578:
579: sub submit_ask_anyway {
580: return ' onclick="still_ask=true;" ';
581: }
582:
583: sub textarea_sizes {
584: my ($data)=@_;
585: my $count=0;
586: my $maxlength=-1;
587: foreach (split ("\n", $$data)) {
588: $count+=int(length($_)/79);
589: $count++;
590: if (length($_) > $maxlength) { $maxlength = length($_); }
591: }
592: my $rows = $count;
593: my $cols = $maxlength;
594: return ($rows,$cols);
595: }
596:
597: sub editline {
598: my ($tag,$data,$description,$size)=@_;
599: $data=&HTML::Entities::encode($data,'<>&"');
600: if ($description) { $description="<br />".$description."<br />"; }
601: my $change_code = &element_change_detection();
602: my $result = <<"END";
603: $description
604: <input type="text" name="homework_edit_$Apache::lonxml::curdepth"
605: value="$data" size="$size" $change_code />
606: END
607: return $result;
608: }
609:
610: sub editfield {
611: my ($tag,$data,$description,$minwidth,$minheight,$usehtmlarea)=@_;
612:
613: my ($rows,$cols)=&textarea_sizes(\$data);
614: if (&Apache::lonhtmlcommon::htmlareabrowser() &&
615: !&Apache::lonhtmlcommon::htmlareablocked()) {
616: $rows+=7; # make room for HTMLarea
617: $minheight+=7; # make room for HTMLarea
618: }
619: if ($cols > 80) { $cols = 80; }
620: if ($cols < $minwidth ) { $cols = $minwidth; }
621: if ($rows < $minheight) { $rows = $minheight; }
622: if ($description) { $description="<br />".$description."<br />"; }
623: if ($usehtmlarea) {
624: &Apache::lonhtmlcommon::add_htmlareafields('homework_edit_'.
625: $Apache::lonxml::curdepth);
626: }
627: # remove typesetting whitespace from between data and the end tag
628: # to make the edit look prettier
629: $data =~ s/\n?[ \t]*$//;
630:
631: return $description."\n".'<textarea style="width:100%" rows="'.$rows.
632: '" cols="'.$cols.'" name="homework_edit_'.
633: $Apache::lonxml::curdepth.'" id="homework_edit_'.
634: $Apache::lonxml::curdepth.'" '.&element_change_detection().'>'.
635: &HTML::Entities::encode($data,'<>&"').'</textarea>'.
636: ($usehtmlarea?&Apache::lonhtmlcommon::spelllink('lonhomework',
637: 'homework_edit_'.$Apache::lonxml::curdepth):'')."\n";
638: }
639:
640: sub modifiedfield {
641: my ($endtag,$parser) = @_;
642: my $result;
643: $result=$env{"form.homework_edit_$Apache::lonxml::curdepth"};
644: my $bodytext=&Apache::lonxml::get_all_text($endtag,$parser);
645: # textareas throw away intial \n
646: if ($bodytext=~/^\n/) {
647: $result="\n".$result;
648: }
649: # if there is typesetting whitespace from between the data and the end tag
650: # restore to keep the source looking pretty
651: if ($bodytext =~ /(\n?[ \t]*)$/) {
652: $result .= $1;
653: }
654: return $result;
655: }
656:
657: # Returns a 1 if the token has been modified and you should rebuild the tag
658: # side-effects, will modify the $token if new values are found
659: sub get_new_args {
660: my ($token,$parstack,$safeeval,@args)=@_;
661: my $rebuild=0;
662: foreach my $arg (@args) {
663: #just want the string that it was set to
664: my $value=$token->[2]->{$arg};
665: my $element=&html_element_name($arg);
666: my $newvalue=$env{"form.$element"};
667: &Apache::lonxml::debug("for:$arg: cur is :$value: new is :$newvalue:");
668: if (defined($newvalue) && $value ne $newvalue) {
669: if (ref($newvalue) eq 'ARRAY') {
670: $token->[2]->{$arg}=join(',',@$newvalue);
671: } else {
672: $token->[2]->{$arg}=$newvalue;
673: }
674: $rebuild=1;
675: } elsif (!defined($newvalue) && defined($value)) {
676: delete($token->[2]->{$arg});
677: $rebuild=1;
678: }
679: }
680: return $rebuild;
681: }
682:
683: # looks for /> on start tags
684: sub rebuild_tag {
685: my ($token) = @_;
686: my $result;
687: if ($token->[0] eq 'S') {
688: $result = '<'.$token->[1];
689: while (my ($key,$val)= each(%{$token->[2]})) {
690: $val=~s:^\s+|\s+$::g;
691: $val=~s:"::g; #"
692: &Apache::lonxml::debug("setting :$key: to :$val:");
693: $result.=' '.$key.'="'.$val.'"';
694: }
695: if ($token->[4] =~ m:/>$:) {
696: $result.=' />';
697: } else {
698: $result.='>';
699: }
700: } elsif ( $token->[0] eq 'E' ) {
701: $result = '</'.$token->[1].'>';
702: }
703: return $result;
704: }
705:
706: sub html_element_name {
707: my ($name) = @_;
708: return $name.'_'.$Apache::lonxml::curdepth;
709: }
710:
711: sub hidden_arg {
712: my ($name,$token) = @_;
713: my $result;
714: my $arg=$token->[2]{$name};
715: $result='<input name="'.&html_element_name($name).
716: '" type="hidden" value="'.$arg.'" />';
717: return $result;
718: }
719:
720: sub checked_arg {
721: my ($description,$name,$list,$token) = @_;
722: my $result;
723: my $optionlist="";
724: my $allselected=$token->[2]{$name};
725: $result=&mt($description);
726: foreach my $option (@$list) {
727: my ($value,$text);
728: if ( ref($option) eq 'ARRAY') {
729: $value='value="'.$$option[0].'"';
730: $text=$$option[1];
731: $option=$$option[0];
732: } else {
733: $text=$option;
734: $value='value="'.$option.'"';
735: }
736: $result.="<nobr><label><input type='checkbox' $value name='".
737: &html_element_name($name)."'";
738: foreach my $selected (split(/,/,$allselected)) {
739: if ( $selected eq $option ) {
740: $result.=" checked='checked' ";
741: last;
742: }
743: }
744: $result.=&element_change_detection()." />$text</label></nobr>\n";
745: }
746: return $result;
747: }
748:
749: sub text_arg {
750: my ($description,$name,$token,$size) = @_;
751: my $result;
752: if (!defined $size) { $size=20; }
753: my $arg=$token->[2]{$name};
754: $result=&mt($description).' <input name="'.&html_element_name($name).
755: '" type="text" value="'.$arg.'" size="'.$size.'" '.
756: &element_change_detection().'/>';
757: return '<nobr>'.$result.'</nobr>';
758: }
759:
760: sub select_arg {
761: my ($description,$name,$list,$token) = @_;
762: my $result;
763: my $optionlist="";
764: my $selected=$token->[2]{$name};
765: foreach my $option (@$list) {
766: my ($text,$value);
767: if ( ref($option) eq 'ARRAY') {
768: $value='value="'.&HTML::Entities::encode($$option[0]).'"';
769: $text=$$option[1];
770: $option=$$option[0];
771: } else {
772: $text=$option;
773: $value='value="'.&HTML::Entities::encode($option,'\'"&<>').'"';
774: }
775: if ( $selected eq $option ) {
776: $optionlist.="<option $value selected=\"selected\">$text</option>\n";
777: } else {
778: $optionlist.="<option $value >$text</option>\n";
779: }
780: }
781: $result.='<nobr>'.$description.' <select name="'.
782: &html_element_name($name).'" '.&element_change_detection().' >
783: '.$optionlist.'
784: </select></nobr>';
785: return $result;
786: }
787:
788: sub select_or_text_arg {
789: my ($description,$name,$list,$token,$size) = @_;
790: my $result;
791: my $optionlist="";
792: my $found=0;
793: my $selected=$token->[2]{$name};
794: foreach my $option (@$list) {
795: my ($text,$value);
796: if ( ref($option) eq 'ARRAY') {
797: $value='value="'.&HTML::Entities::encode($$option[0]).'"';
798: $text=$$option[1];
799: $option=$$option[0];
800: } else {
801: $text=$option;
802: $value='value="'.&HTML::Entities::encode($option,'\'"&<>').'"';
803: }
804: if ( $selected eq $option ) {
805: $optionlist.="<option $value selected=\"selected\">$text</option>\n";
806: $found=1;
807: } else {
808: $optionlist.="<option $value>$text</option>\n";
809: }
810: }
811: $optionlist.="<option value=\"TYPEDINVALUE\"".
812: ((!$found)?' selected="selected"':'').
813: ">".&mt('Type-in value')."</option>\n";
814: #
815: my $change_code=&element_change_detection();
816: my $element=&html_element_name($name);
817: my $selectelement='select_list_'.$element;
818: my $typeinelement='type_in_'.$element;
819: my $typeinvalue=($found?'':$selected);
820: #
821: my $hiddenvalue='this.form.'.$element.'.value';
822: my $selectedindex='this.form.'.$selectelement.'.selectedIndex';
823: my $selectedvalue='this.form.'.$selectelement.
824: '.options['.$selectedindex.'].value';
825: my $typedinvalue='this.form.'.$typeinelement.'.value';
826: my $selecttypeinindex='this.form.'.$selectelement.'.options.length';
827: $description=&mt($description);
828: #
829: return (<<ENDSELECTORTYPE);
830: <nobr>
831: $description
832: <select name="$selectelement"
833: onChange="if ($selectedvalue!='TYPEDINVALUE') { $hiddenvalue=$selectedvalue; $typedinvalue=''; }" >
834: $optionlist
835: </select>
836: <input type="text" size="$size" name="$typeinelement"
837: value="$typeinvalue"
838: onChange="$hiddenvalue=$typedinvalue;"
839: onFocus="$selectedindex=$selecttypeinindex-1;" />
840: <input type="hidden" name="$element" value="$selected" $change_code />
841: </nobr>
842: ENDSELECTORTYPE
843: }
844:
845: #----------------------------------------------------- image coordinates
846: # single image coordinates, x, y
847: sub entercoords {
848: my ($idx,$idy,$mode,$width,$height) = @_;
849: unless ($Apache::edit::bgimgsrc) { return ''; }
850: if ($idx) { $idx.='_'; }
851: if ($idy) { $idy.='_'; }
852: my $bgfile=&escape(&Apache::lonnet::filelocation($Apache::lonxml::pwd[-1],$Apache::edit::bgimgsrc));
853: my $form = 'lonhomework';
854: my $element;
855: if (! defined($mode) || $mode eq 'attribute') {
856: $element = &escape("$Apache::lonxml::curdepth");
857: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
858: $element = &escape('homework_edit_'.
859: $Apache::lonxml::curdepth);
860: }
861: my $id=$Apache::lonxml::curdepth;
862: my %data=("imagechoice.$id.type" =>'point',
863: "imagechoice.$id.formname" =>$form,
864: "imagechoice.$id.formx" =>"$idx$element",
865: "imagechoice.$id.formy" =>"$idy$element",
866: "imagechoice.$id.file" =>$bgfile,
867: "imagechoice.$id.formcoord" =>$element);
868: if ($height) {
869: $data{"imagechoice.$id.formheight"}=$height.'_'.
870: $Apache::edit::bgimgsrccurdepth;
871: }
872: if ($width) {
873: $data{"imagechoice.$id.formwidth"}=$width.'_'.
874: $Apache::edit::bgimgsrccurdepth;
875: }
876: &Apache::lonnet::appenv(%data);
877: my $text="Click Coordinates";
878: my $result='<a href="/adm/imagechoice?token='.$id.'" target="imagechoice">'.$text.'</a>';
879: return $result;
880: }
881:
882: # coordinates (x1,y1)-(x2,y2)...
883: # mode can be either box, or polygon
884: sub entercoord {
885: my ($idx,$mode,$width,$height,$type) = @_;
886: unless ($Apache::edit::bgimgsrc) { return ''; }
887: my $bgfile=&escape(&Apache::lonnet::filelocation($Apache::lonxml::pwd[-1],$Apache::edit::bgimgsrc));
888: my $form = 'lonhomework';
889: my $element;
890: if (! defined($mode) || $mode eq 'attribute') {
891: $element = &escape("$idx\_$Apache::lonxml::curdepth");
892: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
893: $element = &escape('homework_edit_'.
894: $Apache::lonxml::curdepth);
895: }
896: my $id=$Apache::lonxml::curdepth;
897: my %data=("imagechoice.$id.type" =>$type,
898: "imagechoice.$id.formname" =>$form,
899: "imagechoice.$id.file" =>$bgfile,
900: "imagechoice.$id.formcoord" =>$element);
901: if ($height) {
902: $data{"imagechoice.$id.formheight"}=$height.'_'.
903: $Apache::edit::bgimgsrccurdepth;
904: }
905: if ($width) {
906: $data{"imagechoice.$id.formwidth"}=$width.'_'.
907: $Apache::edit::bgimgsrccurdepth;
908: }
909: &Apache::lonnet::appenv(%data);
910: my $text="Enter Coordinates";
911: if ($type eq 'polygon') { $text='Create Polygon Data'; }
912: my $result='<a href="/adm/imagechoice?token='.$id.'" target="imagechoice">'.$text.'</a>';
913: return $result;
914: }
915:
916: sub deletecoorddata {
917: &Apache::lonnet::delenv("imagechoice\\.");
918: }
919:
920: #----------------------------------------------------- browse
921: sub browse {
922: # insert a link to call up the filesystem browser (lonindexer)
923: my ($id, $mode, $titleid) = @_;
924: my $form = 'lonhomework';
925: my $element;
926: if (! defined($mode) || $mode eq 'attribute') {
927: $element = &escape("$id\_$Apache::lonxml::curdepth");
928: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
929: $element = &escape('homework_edit_'.
930: $Apache::lonxml::curdepth);
931: }
932: my $titleelement;
933: if ($titleid) {
934: $titleelement=",'','','".&escape("$titleid\_$Apache::lonxml::curdepth")."'";
935: }
936: my $result = <<"ENDBUTTON";
937: <a href=\"javascript:openbrowser('$form','$element'$titleelement)\"\>Select</a>
938: ENDBUTTON
939: return $result;
940: }
941:
942: #----------------------------------------------------- browse
943: sub search {
944: # insert a link to call up the filesystem browser (lonindexer)
945: my ($id, $mode, $titleid) = @_;
946: my $form = 'lonhomework';
947: my $element;
948: if (! defined($mode) || $mode eq 'attribute') {
949: $element = &escape("$id\_$Apache::lonxml::curdepth");
950: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
951: $element = &escape('homework_edit_'.
952: $Apache::lonxml::curdepth);
953: }
954: my $titleelement;
955: if ($titleid) {
956: $titleelement=",'".&escape("$titleid\_$Apache::lonxml::curdepth")."'";
957: }
958: my $result = <<"ENDBUTTON";
959: <a href=\"javascript:opensearcher('$form','$element'$titleelement)\"\>Search</a>
960: ENDBUTTON
961: return $result;
962: }
963:
964:
965: 1;
966: __END__
967:
968: =head1 NAME
969:
970: Apache::edit - edit mode helpers
971:
972: =head1 SYNOPSIS
973:
974: Invoked by many homework and xml related modules.
975:
976: &Apache::edit::SUBROUTINENAME(ARGUMENTS);
977:
978: =head1 INTRODUCTION
979:
980: This module outputs HTML syntax helpful for the rendering of edit
981: mode interfaces.
982:
983: This is part of the LearningOnline Network with CAPA project
984: described at http://www.lon-capa.org.
985:
986: =head1 HANDLER SUBROUTINE
987:
988: There is no handler subroutine.
989:
990: =head1 OTHER SUBROUTINES
991:
992: =over 4
993:
994: =item *
995:
996: initialize_edit() : initialize edit (set colordepth to zero)
997:
998: =item *
999:
1000: tag_start($target,$token,$description) : provide deletion and insertion lists
1001: for the manipulation of a start tag; return a scalar string
1002:
1003: =item *
1004:
1005: tag_end($target,$token,$description) : ending syntax corresponding to
1006: &tag_start. return a scalar string.
1007:
1008: =item *
1009:
1010: start_table($token) : start table; update colordepth; return scalar string.
1011:
1012: =item *
1013:
1014: end_table() : reduce color depth; end table; return scalar string
1015:
1016: =item *
1017:
1018: start_spanning_row() : start a new table row spanning the 'edit' environment.
1019:
1020: =item *
1021:
1022: start_row() : start a new table row and element.
1023:
1024: =item *
1025:
1026: end_row() : end current table element and row.
1027:
1028: =item *
1029:
1030: movebuttons($target,$token) : move-up and move-down buttons; return scalar
1031: string
1032:
1033: =item *
1034:
1035: deletelist($target,$token) : provide a yes option in an HTML select element;
1036: return scalar string
1037:
1038: =item *
1039:
1040: handle_delete($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,
1041: $style) : respond to a user delete request by passing relevant stack
1042: and array information to various rendering functions; return a scalar string
1043:
1044: =item *
1045:
1046: get_insert_list($token) : provide an insertion list based on possibilities
1047: from lonxml; return a scalar string
1048:
1049: =item *
1050:
1051: insertlist($target,$token) : api that uses get_insert_list;
1052: return a scalar string
1053:
1054: =item *
1055:
1056: handleinsert($token) : provide an insertion list based on possibilities
1057: from lonxml; return a scalar string
1058:
1059: =item *
1060:
1061: get_insert_list($token) : provide an insertion list based on possibilities
1062: from lonxml; return a scalar string
1063:
1064: =item *
1065: browse($elementname) : provide a link which will open up the filesystem
1066: browser (lonindexer) and, once a file is selected, place the result in
1067: the form element $elementname.
1068:
1069: =item *
1070: search($elementname) : provide a link which will open up the filesystem
1071: searcher (lonsearchcat) and, once a file is selected, place the result in
1072: the form element $elementname.
1073:
1074: =item *
1075: editline(tag,data,description,size): Provide a <input type="text" ../> for
1076: single-line text entry. This is to be used for text enclosed by tags, not
1077: arguements/parameters associated with a tag.
1078:
1079: =back
1080:
1081: incomplete...
1082:
1083: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>