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