1: # The LearningOnline Network with CAPA
2: # edit mode helpers
3: #
4: # $Id: edit.pm,v 1.109 2007/09/07 00:21:05 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: #FIXME do this in non random order
690: foreach my $attribute (@{ $token->[3] }) {
691: my $value = $token->[2]{$attribute};
692: $value =~s/^\s+|\s+$//g;
693: $value =~s/\"//g;
694: &Apache::lonxml::debug("setting :$attribute: to :$value:");
695: $result.=' '.$attribute.'="'.$value.'"';
696: }
697: if ($token->[4] =~ m:/>$:) {
698: $result.=' />';
699: } else {
700: $result.='>';
701: }
702: } elsif ( $token->[0] eq 'E' ) {
703: $result = '</'.$token->[1].'>';
704: }
705: return $result;
706: }
707:
708: sub html_element_name {
709: my ($name) = @_;
710: return $name.'_'.$Apache::lonxml::curdepth;
711: }
712:
713: sub hidden_arg {
714: my ($name,$token) = @_;
715: my $result;
716: my $arg=$token->[2]{$name};
717: $result='<input name="'.&html_element_name($name).
718: '" type="hidden" value="'.$arg.'" />';
719: return $result;
720: }
721:
722: sub checked_arg {
723: my ($description,$name,$list,$token) = @_;
724: my $result;
725: my $optionlist="";
726: my $allselected=$token->[2]{$name};
727: $result=&mt($description);
728: foreach my $option (@$list) {
729: my ($value,$text);
730: if ( ref($option) eq 'ARRAY') {
731: $value='value="'.$$option[0].'"';
732: $text=$$option[1];
733: $option=$$option[0];
734: } else {
735: $text=$option;
736: $value='value="'.$option.'"';
737: }
738: $result.="<nobr><label><input type='checkbox' $value name='".
739: &html_element_name($name)."'";
740: foreach my $selected (split(/,/,$allselected)) {
741: if ( $selected eq $option ) {
742: $result.=" checked='checked' ";
743: last;
744: }
745: }
746: $result.=&element_change_detection()." />$text</label></nobr>\n";
747: }
748: return $result;
749: }
750:
751: sub text_arg {
752: my ($description,$name,$token,$size) = @_;
753: my $result;
754: if (!defined $size) { $size=20; }
755: my $arg=$token->[2]{$name};
756: $result=&mt($description).' <input name="'.&html_element_name($name).
757: '" type="text" value="'.$arg.'" size="'.$size.'" '.
758: &element_change_detection().'/>';
759: return '<nobr>'.$result.'</nobr>';
760: }
761:
762: sub select_arg {
763: my ($description,$name,$list,$token) = @_;
764: my $result;
765: my $optionlist="";
766: my $selected=$token->[2]{$name};
767: foreach my $option (@$list) {
768: my ($text,$value);
769: if ( ref($option) eq 'ARRAY') {
770: $value='value="'.&HTML::Entities::encode($$option[0]).'"';
771: $text=$$option[1];
772: $option=$$option[0];
773: } else {
774: $text=$option;
775: $value='value="'.&HTML::Entities::encode($option,'\'"&<>').'"';
776: }
777: if ( $selected eq $option ) {
778: $optionlist.="<option $value selected=\"selected\">$text</option>\n";
779: } else {
780: $optionlist.="<option $value >$text</option>\n";
781: }
782: }
783: $result.='<nobr>'.$description.' <select name="'.
784: &html_element_name($name).'" '.&element_change_detection().' >
785: '.$optionlist.'
786: </select></nobr>';
787: return $result;
788: }
789:
790: sub select_or_text_arg {
791: my ($description,$name,$list,$token,$size) = @_;
792: my $result;
793: my $optionlist="";
794: my $found=0;
795: my $selected=$token->[2]{$name};
796: foreach my $option (@$list) {
797: my ($text,$value);
798: if ( ref($option) eq 'ARRAY') {
799: $value='value="'.&HTML::Entities::encode($$option[0]).'"';
800: $text=$$option[1];
801: $option=$$option[0];
802: } else {
803: $text=$option;
804: $value='value="'.&HTML::Entities::encode($option,'\'"&<>').'"';
805: }
806: if ( $selected eq $option ) {
807: $optionlist.="<option $value selected=\"selected\">$text</option>\n";
808: $found=1;
809: } else {
810: $optionlist.="<option $value>$text</option>\n";
811: }
812: }
813: $optionlist.="<option value=\"TYPEDINVALUE\"".
814: ((!$found)?' selected="selected"':'').
815: ">".&mt('Type-in value')."</option>\n";
816: #
817: my $change_code=&element_change_detection();
818: my $element=&html_element_name($name);
819: my $selectelement='select_list_'.$element;
820: my $typeinelement='type_in_'.$element;
821: my $typeinvalue=($found?'':$selected);
822: #
823: my $hiddenvalue='this.form.'.$element.'.value';
824: my $selectedindex='this.form.'.$selectelement.'.selectedIndex';
825: my $selectedvalue='this.form.'.$selectelement.
826: '.options['.$selectedindex.'].value';
827: my $typedinvalue='this.form.'.$typeinelement.'.value';
828: my $selecttypeinindex='this.form.'.$selectelement.'.options.length';
829: $description=&mt($description);
830: #
831: return (<<ENDSELECTORTYPE);
832: <nobr>
833: $description
834: <select name="$selectelement"
835: onChange="if ($selectedvalue!='TYPEDINVALUE') { $hiddenvalue=$selectedvalue; $typedinvalue=''; }" >
836: $optionlist
837: </select>
838: <input type="text" size="$size" name="$typeinelement"
839: value="$typeinvalue"
840: onChange="$hiddenvalue=$typedinvalue;"
841: onFocus="$selectedindex=$selecttypeinindex-1;" />
842: <input type="hidden" name="$element" value="$selected" $change_code />
843: </nobr>
844: ENDSELECTORTYPE
845: }
846:
847: #----------------------------------------------------- image coordinates
848: # single image coordinates, x, y
849: sub entercoords {
850: my ($idx,$idy,$mode,$width,$height) = @_;
851: unless ($Apache::edit::bgimgsrc) { return ''; }
852: if ($idx) { $idx.='_'; }
853: if ($idy) { $idy.='_'; }
854: my $bgfile=&escape(&Apache::lonnet::filelocation($Apache::lonxml::pwd[-1],$Apache::edit::bgimgsrc));
855: my $form = 'lonhomework';
856: my $element;
857: if (! defined($mode) || $mode eq 'attribute') {
858: $element = &escape("$Apache::lonxml::curdepth");
859: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
860: $element = &escape('homework_edit_'.
861: $Apache::lonxml::curdepth);
862: }
863: my $id=$Apache::lonxml::curdepth;
864: my %data=("imagechoice.$id.type" =>'point',
865: "imagechoice.$id.formname" =>$form,
866: "imagechoice.$id.formx" =>"$idx$element",
867: "imagechoice.$id.formy" =>"$idy$element",
868: "imagechoice.$id.file" =>$bgfile,
869: "imagechoice.$id.formcoord" =>$element);
870: if ($height) {
871: $data{"imagechoice.$id.formheight"}=$height.'_'.
872: $Apache::edit::bgimgsrccurdepth;
873: }
874: if ($width) {
875: $data{"imagechoice.$id.formwidth"}=$width.'_'.
876: $Apache::edit::bgimgsrccurdepth;
877: }
878: &Apache::lonnet::appenv(%data);
879: my $text="Click Coordinates";
880: my $result='<a href="/adm/imagechoice?token='.$id.'" target="imagechoice">'.$text.'</a>';
881: return $result;
882: }
883:
884: # coordinates (x1,y1)-(x2,y2)...
885: # mode can be either box, or polygon
886: sub entercoord {
887: my ($idx,$mode,$width,$height,$type) = @_;
888: unless ($Apache::edit::bgimgsrc) { return ''; }
889: my $bgfile=&escape(&Apache::lonnet::filelocation($Apache::lonxml::pwd[-1],$Apache::edit::bgimgsrc));
890: my $form = 'lonhomework';
891: my $element;
892: if (! defined($mode) || $mode eq 'attribute') {
893: $element = &escape("$idx\_$Apache::lonxml::curdepth");
894: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
895: $element = &escape('homework_edit_'.
896: $Apache::lonxml::curdepth);
897: }
898: my $id=$Apache::lonxml::curdepth;
899: my %data=("imagechoice.$id.type" =>$type,
900: "imagechoice.$id.formname" =>$form,
901: "imagechoice.$id.file" =>$bgfile,
902: "imagechoice.$id.formcoord" =>$element);
903: if ($height) {
904: $data{"imagechoice.$id.formheight"}=$height.'_'.
905: $Apache::edit::bgimgsrccurdepth;
906: }
907: if ($width) {
908: $data{"imagechoice.$id.formwidth"}=$width.'_'.
909: $Apache::edit::bgimgsrccurdepth;
910: }
911: &Apache::lonnet::appenv(%data);
912: my $text="Enter Coordinates";
913: if ($type eq 'polygon') { $text='Create Polygon Data'; }
914: my $result='<a href="/adm/imagechoice?token='.$id.'" target="imagechoice">'.$text.'</a>';
915: return $result;
916: }
917:
918: sub deletecoorddata {
919: &Apache::lonnet::delenv("imagechoice\\.");
920: }
921:
922: #----------------------------------------------------- browse
923: sub browse {
924: # insert a link to call up the filesystem browser (lonindexer)
925: my ($id, $mode, $titleid, $only) = @_;
926: my $form = 'lonhomework';
927: my $element;
928: if (! defined($mode) || $mode eq 'attribute') {
929: $element = &escape("$id\_$Apache::lonxml::curdepth");
930: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
931: $element = &escape('homework_edit_'.
932: $Apache::lonxml::curdepth);
933: }
934: my $titleelement;
935: if ($titleid) {
936: $titleelement=",'$only','','".&escape("$titleid\_$Apache::lonxml::curdepth")."'";
937: } else {
938: $titleelement=",'$only'";
939: }
940: my $result = <<"ENDBUTTON";
941: <a href=\"javascript:openbrowser('$form','$element'$titleelement)\"\>Select</a>
942: ENDBUTTON
943: return $result;
944: }
945:
946: #----------------------------------------------------- browse
947: sub search {
948: # insert a link to call up the filesystem browser (lonindexer)
949: my ($id, $mode, $titleid) = @_;
950: my $form = 'lonhomework';
951: my $element;
952: if (! defined($mode) || $mode eq 'attribute') {
953: $element = &escape("$id\_$Apache::lonxml::curdepth");
954: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
955: $element = &escape('homework_edit_'.
956: $Apache::lonxml::curdepth);
957: }
958: my $titleelement;
959: if ($titleid) {
960: $titleelement=",'".&escape("$titleid\_$Apache::lonxml::curdepth")."'";
961: }
962: my $result = <<"ENDBUTTON";
963: <a href=\"javascript:opensearcher('$form','$element'$titleelement)\"\>Search</a>
964: ENDBUTTON
965: return $result;
966: }
967:
968:
969: 1;
970: __END__
971:
972: =head1 NAME
973:
974: Apache::edit - edit mode helpers
975:
976: =head1 SYNOPSIS
977:
978: Invoked by many homework and xml related modules.
979:
980: &Apache::edit::SUBROUTINENAME(ARGUMENTS);
981:
982: =head1 INTRODUCTION
983:
984: This module outputs HTML syntax helpful for the rendering of edit
985: mode interfaces.
986:
987: This is part of the LearningOnline Network with CAPA project
988: described at http://www.lon-capa.org.
989:
990: =head1 HANDLER SUBROUTINE
991:
992: There is no handler subroutine.
993:
994: =head1 OTHER SUBROUTINES
995:
996: =over 4
997:
998: =item *
999:
1000: initialize_edit() : initialize edit (set colordepth to zero)
1001:
1002: =item *
1003:
1004: tag_start($target,$token,$description) : provide deletion and insertion lists
1005: for the manipulation of a start tag; return a scalar string
1006:
1007: =item *
1008:
1009: tag_end($target,$token,$description) : ending syntax corresponding to
1010: &tag_start. return a scalar string.
1011:
1012: =item *
1013:
1014: start_table($token) : start table; update colordepth; return scalar string.
1015:
1016: =item *
1017:
1018: end_table() : reduce color depth; end table; return scalar string
1019:
1020: =item *
1021:
1022: start_spanning_row() : start a new table row spanning the 'edit' environment.
1023:
1024: =item *
1025:
1026: start_row() : start a new table row and element.
1027:
1028: =item *
1029:
1030: end_row() : end current table element and row.
1031:
1032: =item *
1033:
1034: movebuttons($target,$token) : move-up and move-down buttons; return scalar
1035: string
1036:
1037: =item *
1038:
1039: deletelist($target,$token) : provide a yes option in an HTML select element;
1040: return scalar string
1041:
1042: =item *
1043:
1044: handle_delete($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,
1045: $style) : respond to a user delete request by passing relevant stack
1046: and array information to various rendering functions; return a scalar string
1047:
1048: =item *
1049:
1050: get_insert_list($token) : provide an insertion list based on possibilities
1051: from lonxml; return a scalar string
1052:
1053: =item *
1054:
1055: insertlist($target,$token) : api that uses get_insert_list;
1056: return a scalar string
1057:
1058: =item *
1059:
1060: handleinsert($token) : provide an insertion list based on possibilities
1061: from lonxml; return a scalar string
1062:
1063: =item *
1064:
1065: get_insert_list($token) : provide an insertion list based on possibilities
1066: from lonxml; return a scalar string
1067:
1068: =item *
1069: browse($elementname) : provide a link which will open up the filesystem
1070: browser (lonindexer) and, once a file is selected, place the result in
1071: the form element $elementname.
1072:
1073: =item *
1074: search($elementname) : provide a link which will open up the filesystem
1075: searcher (lonsearchcat) and, once a file is selected, place the result in
1076: the form element $elementname.
1077:
1078: =item *
1079: editline(tag,data,description,size): Provide a <input type="text" ../> for
1080: single-line text entry. This is to be used for text enclosed by tags, not
1081: arguements/parameters associated with a tag.
1082:
1083: =back
1084:
1085: incomplete...
1086:
1087: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>