File:  [LON-CAPA] / loncom / homework / edit.pm
Revision 1.113: download - view: text, annotated - select for diffs
Tue Jan 15 03:09:09 2008 UTC (16 years, 3 months ago) by raeburn
Branches: MAIN
CVS tags: version_2_6_X, version_2_6_3, version_2_6_2, version_2_6_1, HEAD
Bug 5579. Form elements named problemmode were moved in structuretags.pm rev 1.408.  The result was that a button click of 'Calculate Answers' resulted in @{$env{'form.problemmode'}} in which the last array item was 'View' not 'Calculate Answers'.

Eliminate the dependency on form element ordering by setting the value of problemmode on a buttonclick via javascript:setmode().

    1: # The LearningOnline Network with CAPA 
    2: # edit mode helpers
    3: #
    4: # $Id: edit.pm,v 1.113 2008/01/15 03:09:09 raeburn 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>&nbsp;"; }
   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="&nbsp;";
  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:     my ($extra_action) = @_;
  581:     return ' onclick="still_ask=true;'.$extra_action.'" ';
  582: }
  583: 
  584: sub textarea_sizes {
  585:     my ($data)=@_;
  586:     my $count=0;
  587:     my $maxlength=-1;
  588:     foreach (split ("\n", $$data)) {
  589: 	$count+=int(length($_)/79);
  590: 	$count++;
  591: 	if (length($_) > $maxlength) { $maxlength = length($_); }
  592:     }
  593:     my $rows = $count;
  594:     my $cols = $maxlength;
  595:     return ($rows,$cols);
  596: }
  597: 
  598: sub editline {
  599:     my ($tag,$data,$description,$size)=@_;
  600:     $data=&HTML::Entities::encode($data,'<>&"');
  601:     if ($description) { $description=$description."<br />"; }
  602:     my $change_code = &element_change_detection();
  603:     my $result = <<"END";
  604: $description
  605: <input type="text" name="homework_edit_$Apache::lonxml::curdepth" 
  606:        value="$data" size="$size" $change_code />
  607: END
  608:     return $result;
  609: }
  610: 
  611: sub editfield {
  612:     my ($tag,$data,$description,$minwidth,$minheight,$usehtmlarea)=@_;
  613: 
  614:     my ($rows,$cols)=&textarea_sizes(\$data);
  615:     if (&Apache::lonhtmlcommon::htmlareabrowser() &&
  616: 	!&Apache::lonhtmlcommon::htmlareablocked()) {
  617: 	$rows+=7;      # make room for HTMLarea
  618: 	$minheight+=7; # make room for HTMLarea
  619:     }
  620:     if ($cols > 80) { $cols = 80; }
  621:     if ($cols < $minwidth ) { $cols = $minwidth; }
  622:     if ($rows < $minheight) { $rows = $minheight; }
  623:     if ($description) { $description=$description."<br />"; }
  624:     if ($usehtmlarea) {
  625: 	&Apache::lonhtmlcommon::add_htmlareafields('homework_edit_'.
  626: 						   $Apache::lonxml::curdepth);
  627:     }
  628:     # remove typesetting whitespace from between data and the end tag
  629:     # to make the edit look prettier
  630:     $data =~ s/\n?[ \t]*$//;
  631: 
  632:     return $description."\n".'<textarea style="width:100%" rows="'.$rows.
  633: 	'" cols="'.$cols.'" name="homework_edit_'.
  634: 	$Apache::lonxml::curdepth.'" id="homework_edit_'.
  635: 	$Apache::lonxml::curdepth.'" '.&element_change_detection().'>'.
  636: 	&HTML::Entities::encode($data,'<>&"').'</textarea>'.
  637: 	($usehtmlarea?&Apache::lonhtmlcommon::spelllink('lonhomework',
  638: 			 'homework_edit_'.$Apache::lonxml::curdepth):'')."\n";
  639: }
  640: 
  641: sub modifiedfield {
  642:     my ($endtag,$parser) = @_;
  643:     my $result;
  644:     $result=$env{"form.homework_edit_$Apache::lonxml::curdepth"};
  645:     my $bodytext=&Apache::lonxml::get_all_text($endtag,$parser);
  646:     # textareas throw away intial \n 
  647:     if ($bodytext=~/^\n/) {
  648: 	$result="\n".$result;
  649:     }
  650:     # if there is typesetting whitespace from between the data and the end tag
  651:     # restore to keep the source looking pretty
  652:     if ($bodytext =~ /(\n?[ \t]*)$/) {
  653: 	$result .= $1;
  654:     }
  655:     return $result;
  656: }
  657: 
  658: # Returns a 1 if the token has been modified and you should rebuild the tag
  659: # side-effects, will modify the $token if new values are found
  660: sub get_new_args {
  661:     my ($token,$parstack,$safeeval,@args)=@_;
  662:     my $rebuild=0;
  663:     foreach my $arg (@args) {
  664: 	#just want the string that it was set to
  665: 	my $value=$token->[2]->{$arg};
  666: 	my $element=&html_element_name($arg);
  667: 	my $newvalue=$env{"form.$element"};
  668: 	&Apache::lonxml::debug("for:$arg: cur is :$value: new is :$newvalue:");
  669: 	if (defined($newvalue) && $value ne $newvalue) {
  670: 	    if (ref($newvalue) eq 'ARRAY') {
  671: 		$token->[2]->{$arg}=join(',',@$newvalue);
  672: 	    } else {
  673: 		$token->[2]->{$arg}=$newvalue;
  674: 	    }
  675: 	    $rebuild=1;
  676: 	    # add new attributes to the of the attribute seq
  677: 	    if (!grep { $arg eq $_ } (@{ $token->[3] })) {
  678: 		push(@{ $token->[3] },$arg);
  679: 	    }
  680: 	} elsif (!defined($newvalue) && defined($value)) {
  681: 	    delete($token->[2]->{$arg});
  682: 	    $rebuild=1;
  683: 	}
  684:     }
  685:     return $rebuild;
  686: }
  687: 
  688: # looks for /> on start tags
  689: sub rebuild_tag {
  690:     my ($token) = @_;
  691:     my $result;
  692:     if ($token->[0] eq 'S') {
  693: 	$result = '<'.$token->[1];
  694: 	foreach my $attribute (@{ $token->[3] }) {
  695: 	    my $value = $token->[2]{$attribute};
  696: 	    next if ($value eq '');
  697: 	    $value =~s/^\s+|\s+$//g;
  698: 	    $value =~s/\"//g;
  699: 	    &Apache::lonxml::debug("setting :$attribute: to  :$value:");
  700: 	    $result.=' '.$attribute.'="'.$value.'"';
  701: 	}
  702: 	if ($token->[4] =~ m:/>$:) {
  703: 	    $result.=' />';
  704: 	} else {
  705: 	    $result.='>';
  706: 	}
  707:     } elsif ( $token->[0] eq 'E' ) {
  708: 	$result = '</'.$token->[1].'>';
  709:     }
  710:     return $result;
  711: }
  712: 
  713: sub html_element_name {
  714:     my ($name) = @_;
  715:     return $name.'_'.$Apache::lonxml::curdepth;
  716: }
  717: 
  718: sub hidden_arg {
  719:     my ($name,$token) = @_;
  720:     my $result;
  721:     my $arg=$token->[2]{$name};
  722:     $result='<input name="'.&html_element_name($name).
  723: 	'" type="hidden" value="'.$arg.'" />';
  724:     return $result;
  725: }
  726: 
  727: sub checked_arg {
  728:     my ($description,$name,$list,$token) = @_;
  729:     my $result;
  730:     my $optionlist="";
  731:     my $allselected=$token->[2]{$name};
  732:     $result=&mt($description);
  733:     foreach my $option (@$list) {
  734: 	my ($value,$text);
  735: 	if ( ref($option) eq 'ARRAY') {
  736: 	    $value='value="'.$$option[0].'"';
  737: 	    $text=$$option[1];
  738: 	    $option=$$option[0];
  739: 	} else {
  740: 	    $text=$option;
  741: 	    $value='value="'.$option.'"';
  742: 	}
  743: 	$result.="<nobr><label><input type='checkbox' $value name='".
  744: 	    &html_element_name($name)."'";
  745: 	foreach my $selected (split(/,/,$allselected)) {
  746: 	    if ( $selected eq $option ) {
  747: 		$result.=" checked='checked' ";
  748: 		last;
  749: 	    }
  750: 	}
  751: 	$result.=&element_change_detection()." />$text</label></nobr>\n";
  752:     }
  753:     return $result;
  754: }
  755: 
  756: sub text_arg {
  757:     my ($description,$name,$token,$size) = @_;
  758:     my $result;
  759:     if (!defined $size) { $size=20; }
  760:     my $arg=$token->[2]{$name};
  761:     $result=&mt($description).'&nbsp;<input name="'.&html_element_name($name).
  762: 	'" type="text" value="'.$arg.'" size="'.$size.'" '.
  763: 	&element_change_detection().'/>';
  764:     return '<nobr>'.$result.'</nobr>';
  765: }
  766: 
  767: sub select_arg {
  768:     my ($description,$name,$list,$token) = @_;
  769:     my $result;
  770:     my $optionlist="";
  771:     my $selected=$token->[2]{$name};
  772:     foreach my $option (@$list) {
  773: 	my ($text,$value);
  774: 	if ( ref($option) eq 'ARRAY') {
  775: 	    $value='value="'.&HTML::Entities::encode($$option[0]).'"';
  776: 	    $text=$$option[1];
  777: 	    $option=$$option[0];
  778: 	} else {
  779: 	    $text=$option;
  780: 	    $value='value="'.&HTML::Entities::encode($option,'\'"&<>').'"';
  781: 	}
  782: 	if ( $selected eq $option ) {
  783: 	    $optionlist.="<option $value selected=\"selected\">$text</option>\n";
  784: 	} else {
  785: 	    $optionlist.="<option $value >$text</option>\n";
  786: 	}
  787:     }
  788:     $result.='<nobr>'.$description.'&nbsp;<select name="'.
  789: 	&html_element_name($name).'" '.&element_change_detection().' >
  790:        '.$optionlist.'
  791:       </select></nobr>';
  792:     return $result;
  793: }
  794: 
  795: sub select_or_text_arg {
  796:     my ($description,$name,$list,$token,$size) = @_;
  797:     my $result;
  798:     my $optionlist="";
  799:     my $found=0;
  800:     my $selected=$token->[2]{$name};
  801:     foreach my $option (@$list) {
  802: 	my ($text,$value);
  803: 	if ( ref($option) eq 'ARRAY') {
  804: 	    $value='value="'.&HTML::Entities::encode($$option[0]).'"';
  805: 	    $text=$$option[1];
  806: 	    $option=$$option[0];
  807: 	} else {
  808: 	    $text=$option;
  809: 	    $value='value="'.&HTML::Entities::encode($option,'\'"&<>').'"';
  810: 	}
  811: 	if ( $selected eq $option ) {
  812: 	    $optionlist.="<option $value selected=\"selected\">$text</option>\n";
  813: 	    $found=1;
  814: 	} else {
  815: 	    $optionlist.="<option $value>$text</option>\n";
  816: 	}
  817:     }
  818:     $optionlist.="<option value=\"TYPEDINVALUE\"".
  819:  	((!$found)?' selected="selected"':'').
  820:  	">".&mt('Type-in value')."</option>\n";
  821: #
  822:     my $change_code=&element_change_detection();
  823:     my $element=&html_element_name($name);
  824:     my $selectelement='select_list_'.$element;
  825:     my $typeinelement='type_in_'.$element;
  826:     my $typeinvalue=($found?'':$selected);
  827: #
  828:     my $hiddenvalue='this.form.'.$element.'.value';
  829:     my $selectedindex='this.form.'.$selectelement.'.selectedIndex';
  830:     my $selectedvalue='this.form.'.$selectelement.
  831: 	     '.options['.$selectedindex.'].value';
  832:     my $typedinvalue='this.form.'.$typeinelement.'.value';
  833:     my $selecttypeinindex='this.form.'.$selectelement.'.options.length';
  834:     $description=&mt($description);
  835: #
  836:     return (<<ENDSELECTORTYPE);
  837: <nobr>
  838: $description
  839: &nbsp;<select name="$selectelement"
  840: onChange="if ($selectedvalue!='TYPEDINVALUE') { $hiddenvalue=$selectedvalue; $typedinvalue=''; }" >
  841: $optionlist
  842: </select>
  843: <input type="text" size="$size" name="$typeinelement"
  844:        value="$typeinvalue" 
  845: onChange="$hiddenvalue=$typedinvalue;"
  846: onFocus="$selectedindex=$selecttypeinindex-1;" />
  847: <input type="hidden" name="$element" value="$selected" $change_code />
  848: </nobr>
  849: ENDSELECTORTYPE
  850: }
  851: 
  852: #----------------------------------------------------- image coordinates
  853: # single image coordinates, x, y 
  854: sub entercoords {
  855:     my ($idx,$idy,$mode,$width,$height) = @_;
  856:     unless ($Apache::edit::bgimgsrc) { return ''; }
  857:     if ($idx) { $idx.='_'; }
  858:     if ($idy) { $idy.='_'; }
  859:     my $bgfile=&escape(&Apache::lonnet::filelocation($Apache::lonxml::pwd[-1],$Apache::edit::bgimgsrc));
  860:     my $form    = 'lonhomework';
  861:     my $element;
  862:     if (! defined($mode) || $mode eq 'attribute') {
  863:         $element = &escape("$Apache::lonxml::curdepth");
  864:     } elsif ($mode eq 'textnode') {  # for data between <tag> ... </tag>
  865:         $element = &escape('homework_edit_'.
  866:                                            $Apache::lonxml::curdepth);
  867:     }
  868:     my $id=$Apache::lonxml::curdepth;
  869:     my %data=("imagechoice.$id.type"      =>'point',
  870: 	      "imagechoice.$id.formname"  =>$form,
  871: 	      "imagechoice.$id.formx"     =>"$idx$element",
  872: 	      "imagechoice.$id.formy"     =>"$idy$element",
  873: 	      "imagechoice.$id.file"      =>$bgfile,
  874: 	      "imagechoice.$id.formcoord" =>$element);
  875:     if ($height) {
  876: 	$data{"imagechoice.$id.formheight"}=$height.'_'.
  877: 	    $Apache::edit::bgimgsrccurdepth;
  878:     }
  879:     if ($width) {
  880: 	$data{"imagechoice.$id.formwidth"}=$width.'_'.
  881: 	    $Apache::edit::bgimgsrccurdepth;
  882:     }
  883:     &Apache::lonnet::appenv(%data);
  884:     my $text="Click Coordinates";
  885:     my $result='<a href="/adm/imagechoice?token='.$id.'" target="imagechoice">'.$text.'</a>';
  886:     return $result;
  887: }
  888: 
  889: # coordinates (x1,y1)-(x2,y2)...
  890: # mode can be either box, or polygon
  891: sub entercoord {
  892:     my ($idx,$mode,$width,$height,$type) = @_;
  893:     unless ($Apache::edit::bgimgsrc) { return ''; }
  894:     my $bgfile=&escape(&Apache::lonnet::filelocation($Apache::lonxml::pwd[-1],$Apache::edit::bgimgsrc));
  895:     my $form    = 'lonhomework';
  896:     my $element;
  897:     if (! defined($mode) || $mode eq 'attribute') {
  898:         $element = &escape("$idx\_$Apache::lonxml::curdepth");
  899:     } elsif ($mode eq 'textnode') {  # for data between <tag> ... </tag>
  900:         $element = &escape('homework_edit_'.
  901:                                            $Apache::lonxml::curdepth);
  902:     }
  903:     my $id=$Apache::lonxml::curdepth;
  904:     my %data=("imagechoice.$id.type"      =>$type,
  905: 	      "imagechoice.$id.formname"  =>$form,
  906: 	      "imagechoice.$id.file"      =>$bgfile,
  907: 	      "imagechoice.$id.formcoord" =>$element);
  908:     if ($height) {
  909: 	$data{"imagechoice.$id.formheight"}=$height.'_'.
  910: 	    $Apache::edit::bgimgsrccurdepth;
  911:     }
  912:     if ($width) {
  913: 	$data{"imagechoice.$id.formwidth"}=$width.'_'.
  914: 	    $Apache::edit::bgimgsrccurdepth;
  915:     }
  916:     &Apache::lonnet::appenv(%data);
  917:     my $text="Enter Coordinates";
  918:     if ($type eq 'polygon') { $text='Create Polygon Data'; }
  919:     my $result='<a href="/adm/imagechoice?token='.$id.'" target="imagechoice">'.$text.'</a>';
  920:     return $result;
  921: }
  922: 
  923: sub deletecoorddata {
  924:     &Apache::lonnet::delenv("imagechoice\\.");
  925: }
  926: 
  927: #----------------------------------------------------- browse
  928: sub browse {
  929:     # insert a link to call up the filesystem browser (lonindexer)
  930:     my ($id, $mode, $titleid, $only) = @_;
  931:     my $form    = 'lonhomework';
  932:     my $element;
  933:     if (! defined($mode) || $mode eq 'attribute') {
  934:         $element = &escape("$id\_$Apache::lonxml::curdepth");
  935:     } elsif ($mode eq 'textnode') {  # for data between <tag> ... </tag>
  936:         $element = &escape('homework_edit_'.
  937:                                            $Apache::lonxml::curdepth);	
  938:     }
  939:     my $titleelement;
  940:     if ($titleid) {
  941: 	$titleelement=",'$only','','".&escape("$titleid\_$Apache::lonxml::curdepth")."'";
  942:     } else {
  943:         $titleelement=",'$only'";
  944:     }
  945:     my $result = <<"ENDBUTTON";
  946: <a href=\"javascript:openbrowser('$form','$element'$titleelement)\"\>Select</a>
  947: ENDBUTTON
  948:     return $result;
  949: }
  950: 
  951: #----------------------------------------------------- browse
  952: sub search {
  953:     # insert a link to call up the filesystem browser (lonindexer)
  954:     my ($id, $mode, $titleid) = @_;
  955:     my $form    = 'lonhomework';
  956:     my $element;
  957:     if (! defined($mode) || $mode eq 'attribute') {
  958:         $element = &escape("$id\_$Apache::lonxml::curdepth");
  959:     } elsif ($mode eq 'textnode') {  # for data between <tag> ... </tag>
  960:         $element = &escape('homework_edit_'.
  961:                                            $Apache::lonxml::curdepth);
  962:     }
  963:     my $titleelement;
  964:     if ($titleid) {
  965: 	$titleelement=",'".&escape("$titleid\_$Apache::lonxml::curdepth")."'";
  966:     }
  967:     my $result = <<"ENDBUTTON";
  968: <a href=\"javascript:opensearcher('$form','$element'$titleelement)\"\>Search</a>
  969: ENDBUTTON
  970:     return $result;
  971: }
  972: 
  973: 
  974: 1;
  975: __END__
  976: 
  977: =head1 NAME
  978: 
  979: Apache::edit - edit mode helpers
  980: 
  981: =head1 SYNOPSIS
  982: 
  983: Invoked by many homework and xml related modules.
  984: 
  985:  &Apache::edit::SUBROUTINENAME(ARGUMENTS);
  986: 
  987: =head1 INTRODUCTION
  988: 
  989: This module outputs HTML syntax helpful for the rendering of edit
  990: mode interfaces.
  991: 
  992: This is part of the LearningOnline Network with CAPA project
  993: described at http://www.lon-capa.org.
  994: 
  995: =head1 HANDLER SUBROUTINE
  996: 
  997: There is no handler subroutine.
  998: 
  999: =head1 OTHER SUBROUTINES
 1000: 
 1001: =over 4
 1002: 
 1003: =item *
 1004: 
 1005: initialize_edit() : initialize edit (set colordepth to zero)
 1006: 
 1007: =item *
 1008: 
 1009: tag_start($target,$token,$description) : provide deletion and insertion lists
 1010: for the manipulation of a start tag; return a scalar string
 1011: 
 1012: =item *
 1013: 
 1014: tag_end($target,$token,$description) : ending syntax corresponding to
 1015: &tag_start. return a scalar string.
 1016: 
 1017: =item *
 1018: 
 1019: start_table($token) : start table; update colordepth; return scalar string.
 1020: 
 1021: =item *
 1022: 
 1023: end_table() : reduce color depth; end table; return scalar string
 1024: 
 1025: =item *
 1026: 
 1027: start_spanning_row() : start a new table row spanning the 'edit' environment.
 1028: 
 1029: =item *
 1030: 
 1031: start_row() : start a new table row and element. 
 1032: 
 1033: =item *
 1034: 
 1035: end_row() : end current table element and row.
 1036: 
 1037: =item *
 1038: 
 1039: movebuttons($target,$token) : move-up and move-down buttons; return scalar
 1040: string
 1041: 
 1042: =item *
 1043: 
 1044: deletelist($target,$token) : provide a yes option in an HTML select element;
 1045: return scalar string
 1046: 
 1047: =item *
 1048: 
 1049: handle_delete($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,
 1050: $style) : respond to a user delete request by passing relevant stack
 1051: and array information to various rendering functions; return a scalar string
 1052: 
 1053: =item *
 1054: 
 1055: get_insert_list($token) : provide an insertion list based on possibilities
 1056: from lonxml; return a scalar string
 1057: 
 1058: =item *
 1059: 
 1060: insertlist($target,$token) : api that uses get_insert_list;
 1061: return a scalar string
 1062: 
 1063: =item *
 1064: 
 1065: handleinsert($token) : provide an insertion list based on possibilities
 1066: from lonxml; return a scalar string
 1067: 
 1068: =item *
 1069: 
 1070: get_insert_list($token) : provide an insertion list based on possibilities
 1071: from lonxml; return a scalar string
 1072: 
 1073: =item *
 1074: browse($elementname) : provide a link which will open up the filesystem
 1075: browser (lonindexer) and, once a file is selected, place the result in
 1076: the form element $elementname.
 1077: 
 1078: =item *
 1079: search($elementname) : provide a link which will open up the filesystem
 1080: searcher (lonsearchcat) and, once a file is selected, place the result in
 1081: the form element $elementname.
 1082: 
 1083: =item *
 1084: editline(tag,data,description,size): Provide a <input type="text" ../> for
 1085: single-line text entry.  This is to be used for text enclosed by tags, not
 1086: arguements/parameters associated with a tag.
 1087: 
 1088: =back
 1089: 
 1090: incomplete...
 1091: 
 1092: =cut

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>