WebSVN – Moodle – Diff – /lib/form/duration.php

  * Duration element
+ *
  * HTML class for a length of time. For example, 30 minutes of 4 days. The
  * values returned to PHP is the duration in seconds (an int rounded to the nearest second).
+ *
+ * By default, only durations >= 0 can be input. If you want to allow negative
+ * durations set the option allownegative.
+ *
  * @package   core_form
  * @category  form
  * @copyright 2009 Tim Hunt
  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  */
 class MoodleQuickForm_duration extends MoodleQuickForm_group {
     /**
      * Control the field names for form elements
      * optional => if true, show a checkbox beside the element to turn it on (or off)
      * defaultunit => which unit is default when the form is blank (default Minutes).
+     * allownegative => are durations < 0 allowed? (default false)
      * @var array
      */
-    protected $_options = ['optional' => false, 'defaultunit' => MINSECS];
+    protected $_options = ['optional' => false, 'defaultunit' => MINSECS, 'allownegative' => false];
     /** @var array associative array of time units (days, hours, minutes, seconds) */
     private $_units = null;
     *      'optional' => true/false - whether to display an 'enabled' checkbox next to the element.
     *      'defaultunit' => 1|MINSECS|HOURSECS|DAYSECS|WEEKSECS - the default unit to display when
     *              the time is blank. If not specified, minutes is used.
     *      'units' => array containing some or all of 1, MINSECS, HOURSECS, DAYSECS and WEEKSECS
     *              which unit choices to offer.
+    *      'allownegative' => true/false - are durations < 0 allowed? (default false)
     * @param mixed $attributes Either a typical HTML attribute string or an associative array
     */
     public function __construct($elementName = null, $elementLabel = null,
             $options = [], $attributes = null) {
         parent::__construct($elementName, $elementLabel, $attributes);
         // Set the options, do not bother setting bogus ones
         if (!is_array($options)) {
             $options = [];
+        }
         $this->_options['optional'] = !empty($options['optional']);
+        $this->_options['allownegative'] = !empty($options['allownegative']);
         if (isset($options['defaultunit'])) {
             if (!array_key_exists($options['defaultunit'], $this->get_units())) {
                 throw new coding_exception($options['defaultunit'] .
                         ' is not a recognised unit in MoodleQuickForm_duration.');
+            }
         $attributes = $this->getAttributesForFormElement();
         if (!isset($attributes['size'])) {
             $attributes['size'] = 3;
+        }
         $this->_elements = [];
-        // E_STRICT creating elements without forms is nasty because it internally uses $this
         $number = $this->createFormElement('text', 'number',
                 get_string('time', 'form'), $attributes, true);
         $number->set_force_ltr(true);
         $this->_elements[] = $number;
         unset($attributes['size']);
             default:
                 return parent::onQuickFormEvent($event, $arg, $caller);
+        }
+    }
+    #[\Override]
+    public function validateSubmitValue($values) {
+        if ($this->exportValue($values) < 0 && !$this->_options['allownegative']) {
+            return get_string('err_positiveduration', 'core_form');
+        }
+        return null;
+    }
     /**
      * Returns HTML for advchecbox form element.
+     *
      * @return string

Proyectos de Subversion Moodle

(root)/lib/form/duration.php – Rev 1 → 1441