1 /*
  2     Copyright 2008-2023
  3         Matthias Ehmann,
  4         Michael Gerhaeuser,
  5         Carsten Miller,
  6         Bianca Valentin,
  7         Alfred Wassermann,
  8         Peter Wilfahrt
  9 
 10     This file is part of JSXGraph.
 11 
 12     JSXGraph is free software dual licensed under the GNU LGPL or MIT License.
 13 
 14     You can redistribute it and/or modify it under the terms of the
 15 
 16       * GNU Lesser General Public License as published by
 17         the Free Software Foundation, either version 3 of the License, or
 18         (at your option) any later version
 19       OR
 20       * MIT License: https://github.com/jsxgraph/jsxgraph/blob/master/LICENSE.MIT
 21 
 22     JSXGraph is distributed in the hope that it will be useful,
 23     but WITHOUT ANY WARRANTY; without even the implied warranty of
 24     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 25     GNU Lesser General Public License for more details.
 26 
 27     You should have received a copy of the GNU Lesser General Public License and
 28     the MIT License along with JSXGraph. If not, see <https://www.gnu.org/licenses/>
 29     and <https://opensource.org/licenses/MIT/>.
 30  */
 31 
 32 /*global JXG: true, define: true, window: true*/
 33 /*jslint nomen: true, plusplus: true*/
 34 
 35 /**
 36  * @fileoverview In this file the Text element is defined.
 37  */
 38 
 39 import JXG from "../jxg";
 40 import Env from "../utils/env";
 41 import Type from "../utils/type";
 42 
 43 var priv = {
 44     ButtonClickEventHandler: function () {
 45         if (this._handler) {
 46             this._handler();
 47         }
 48         this.board.update();
 49     }
 50 };
 51 
 52 /**
 53  * @class This element is used to provide a constructor for special texts containing a
 54  * form button element.
 55  * <p>
 56  * For this element, the attribute "display" has to have the value 'html' (which is the default).
 57  * <p>
 58  * The underlying HTML button element can be accessed through the sub-object 'rendNodeButton', e.g. to
 59  * add event listeners.
 60  *
 61  * @pseudo
 62  * @name Button
 63  * @augments Text
 64  * @constructor
 65  * @type JXG.Text
 66  *
 67  * @param {number,function_number,function_String,function_function} x,y,label,handler Parent elements for button elements.
 68  *  <p>
 69  *  x and y are the coordinates of the lower left corner of the text box.
 70  *   The position of the text is fixed,
 71  *  x and y are numbers. The position is variable if x or y are functions.
 72  *  <p>
 73  *  The label of the input element may be given  as string.
 74  *  <p>
 75  *  The (optional) handler function which is called when the button is pressed.
 76  *
 77  * @example
 78  *  var p = board.create('point', [0.5, 0.5], {id: 'p1'});
 79  *
 80  *  // Create a button element at position [1,2].
 81  *  var button1 = board.create('button', [1, 2, 'Change Y with JavaScript', function() {
 82  *      p.moveTo([p.X(), p.Y() + 0.5], 100);
 83  *  }], {});
 84  *
 85  *  // Create a button element at position [1,4].
 86  *  var button2 = board.create('button', [1, 4, 'Change Y with JessieCode',
 87  *      "$('p1').Y = $('p1').Y() - 0.5;"
 88  *  ], {});
 89  *
 90  * </pre><div class="jxgbox" id="JXGf19b1bce-dd00-4e35-be97-ff1817d11514" style="width: 500px; height: 300px;"></div>
 91  * <script type="text/javascript">
 92  *  var t1_board = JXG.JSXGraph.initBoard('JXGf19b1bce-dd00-4e35-be97-ff1817d11514', {boundingbox: [-3, 6, 5, -3], axis: true, showcopyright: false, shownavigation: false});
 93  *  var p = t1_board.create('point', [0, -1], {id: 'p1'});
 94  *
 95  *  // Create a button element at position [1,2].
 96  *  var button1 = t1_board.create('button', [1, 2, 'Change Y with JavaScript', function() {
 97  *      p.moveTo([p.X(), p.Y() + 0.5], 100);
 98  *  }], {});
 99  *
100  *  // Create a button element at position [1,4].
101  *  var button2 = t1_board.create('button', [1, 4, 'Change Y with JessieCode',
102  *      "$('p1').Y = $('p1').Y() - 0.5;"
103  *  ], {});
104  *
105  * </script><pre>
106  *
107  * @example
108  * // A toggle button
109  * var butt = board.create('button', [-2, -2, 'Off', function() {
110  *   var txt;
111  *   butt.value = !butt.value;
112  *   if (butt.value) {
113  *   	txt = 'On';
114  *   } else {
115  *   	txt = 'Off';
116  *   }
117  * 	butt.rendNodeButton.innerHTML = txt;
118  * }]);
119  *
120  * // Set initial value for the button
121  * if (!JXG.exists(butt.value)) {
122  * 	butt.value = false;
123  * }
124  *
125  * var p = board.create('point', [2, -2], {
126  * 	visible: () => butt.value
127  * });
128  *
129  *
130  *
131  * </pre><div id="JXGa1eaab8f-c73b-4660-96ce-4ca17bcac4d6" class="jxgbox" style="width: 300px; height: 300px;"></div>
132  * <script type="text/javascript">
133  *     (function() {
134  *         var board = JXG.JSXGraph.initBoard('JXGa1eaab8f-c73b-4660-96ce-4ca17bcac4d6',
135  *             {boundingbox: [-8, 8, 8,-8], axis: true, showcopyright: false, shownavigation: false});
136  *     var butt = board.create('button', [-2, -2, 'Off', function() {
137  *       var txt;
138  *       butt.value = !butt.value;
139  *       if (butt.value) {
140  *       	txt = 'On';
141  *       } else {
142  *       	txt = 'Off';
143  *       }
144  *     	butt.rendNodeButton.innerHTML = txt;
145  *     }]);
146  *
147  *     // Set initial value for the button
148  *     if (!JXG.exists(butt.value)) {
149  *     	butt.value = false;
150  *     }
151  *
152  *     var p = board.create('point', [2, -2], {
153  *     	visible: () => butt.value
154  *     });
155  *
156  *     })();
157  *
158  * </script><pre>
159  *
160  * @example
161  *         var i1 = board.create('input', [-3, 4, 'sin(x)', 'f(x)='], {cssStyle: 'width:4em', maxlength: 2});
162  *         var c1 = board.create('checkbox', [-3, 2, 'label 1'], {});
163  *         var b1 = board.create('button', [-3, -1, 'Change texts', function () {
164  *                 i1.setText('g(x)');
165  *                 i1.set('cos(x)');
166  *                 c1.setText('label 2');
167  *                 b1.setText('Texts are changed');
168  *             }],
169  *             {cssStyle: 'width:400px'});
170  *
171  * </pre><div id="JXG11cac8ff-2354-47e7-9da4-eb928e53de05" class="jxgbox" style="width: 300px; height: 300px;"></div>
172  * <script type="text/javascript">
173  *     (function() {
174  *         var board = JXG.JSXGraph.initBoard('JXG11cac8ff-2354-47e7-9da4-eb928e53de05',
175  *             {boundingbox: [-8, 8, 8,-8], axis: true, showcopyright: false, shownavigation: false});
176  *             var i1 = board.create('input', [-3, 4, 'sin(x)', 'f(x)='], {cssStyle: 'width:4em', maxlength: 2});
177  *             var c1 = board.create('checkbox', [-3, 2, 'label 1'], {});
178  *             var b1 = board.create('button', [-3, -1, 'Change texts', function () {
179  *                     i1.setText('g(x)');
180  *                     i1.set('cos(x)');
181  *                     c1.setText('label 2');
182  *                     b1.setText('Texts are changed');
183  *                 }],
184  *                 {cssStyle: 'width:400px'});
185  *
186  *     })();
187  *
188  * </script><pre>
189  *
190  */
191 JXG.createButton = function (board, parents, attributes) {
192     var t,
193         par,
194         attr = Type.copyAttributes(attributes, board.options, "button");
195 
196     //if (parents.length < 3) {
197     //throw new Error("JSXGraph: Can't create button with parent types '" +
198     //    (typeof parents[0]) + "' and '" + (typeof parents[1]) + "'." +
199     //    "\nPossible parents are: [x, y, label, handler]");
200     //}
201 
202     // 1. Create empty button
203     par = [parents[0], parents[1], '<button type="button" style="width:100%;"></button>'];
204     t = board.create("text", par, attr);
205     t.type = Type.OBJECT_TYPE_BUTTON;
206 
207     t.rendNodeButton = t.rendNode.childNodes[0];
208     t.rendNodeButton.id = t.rendNode.id + "_button";
209     // t.rendNodeButton.innerHTML = parents[2];
210 
211     t.rendNodeTag = t.rendNodeButton; // Needed for unified treatment in setAttribute
212     t.rendNodeTag.disabled = !!attr.disabled;
213 
214     // 2. Set parents[2] (string|function) as content of the button.
215     // abstract.js selects the correct DOM element for the update
216     t.setText(parents[2]);
217 
218     // This sets the font-size of the button text
219     t.visPropOld.fontsize = "0px";
220     board.renderer.updateTextStyle(t, false);
221 
222     if (parents[3]) {
223         if (Type.isString(parents[3])) {
224             t._jc = new JXG.JessieCode();
225             t._jc.use(board);
226             t._handler = function () {
227                 t._jc.parse(parents[3]);
228             };
229         } else {
230             t._handler = parents[3];
231         }
232     }
233 
234     Env.addEvent(t.rendNodeButton, "click", priv.ButtonClickEventHandler, t);
235     Env.addEvent(
236         t.rendNodeButton,
237         "mousedown",
238         function (evt) {
239             if (Type.exists(evt.stopPropagation)) {
240                 evt.stopPropagation();
241             }
242         },
243         t
244     );
245     Env.addEvent(
246         t.rendNodeButton,
247         "touchstart",
248         function (evt) {
249             if (Type.exists(evt.stopPropagation)) {
250                 evt.stopPropagation();
251             }
252         },
253         t
254     );
255     Env.addEvent(
256         t.rendNodeButton,
257         "pointerdown",
258         function (evt) {
259             if (Type.exists(evt.stopPropagation)) {
260                 evt.stopPropagation();
261             }
262         },
263         t
264     );
265 
266     return t;
267 };
268 
269 JXG.registerElement("button", JXG.createButton);
270 
271 // export default {
272 //     createButton: JXG.createButton
273 // };
274