-
Notifications
You must be signed in to change notification settings - Fork 19
/
overview.html
executable file
·2343 lines (2086 loc) · 106 KB
/
overview.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1" />
<style type="text/css">
dt { font-weight: bold; }
h3 { text-decoration: underline; }
dd { margin-top: 10px; margin-bottom: 10px; }
dd p { margin-top: 0px; }
dd div { margin: 10px 0px; }
</style>
<title>JWt 4.10.3</title>
</head>
<body>
This is the reference documentation
for <a href="https://www.webtoolkit.eu/jwt">JWt</a>.
<h1>Release notes</h1>
This page lists important notes on migrating existing applications to
newer version of JWt. It lists changes in the library that may break
the way you build JWt, the way you configure JWt or the JWt API and
behaviour. It also indicates the main changes from version to verison.
<h2>Release 4.10.4 (March 6, 2024)</h2>
<p>
Wt 4.10.4 is a (smaller) patch release that addresses the following issues.
This release is somewhat smaller due to bigger features being in the works.
Developers can expect some bigger new features in the authentication framework soon!
</p>
<ul>
<li>
<a href="https://redmine.emweb.be/issues/11685">Issue #11685</a>:
render child widgets differently when updating an existing widget. The JavaScript code that is being called by the framework to dynamically add children to an HTML element was changed so that it always appends them instead of setting the whole content. This is to avoid a widget that was added in JavaScript (with no Java counterpart) from being overwritten if the HTML of the parent would be written to.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/12283" target="_blank">Issue #12283</a>:
this corrects an additional mistake, made on top of <a href="https://redmine.webtoolkit.eu/issues/12006" target="_blank">Issue #12006</a>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/12145" target="_blank">Issue #12145</a>:
a change to the internal enum class <a href="namespaceWt.html#aeb01f25d7c9d4a4498fb3dadc8d168c5">Property</a> caused an index and its value to be out of sync for a couple values.
</li>
</ul>
<h2>Release 4.10.3 (December 20, 2023)</h2>
<p>
Wt 4.10.3 is a patch release that addresses the following issues:
</p>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11934">Issue #11934</a>:
this corrects the rendering of a vertical <a href="eu/webtoolkit/jwt/WSlider.html">WSlider</a> for all themes. Additionally an improvement was made that introduces <a href="eu/webtoolkit/jwt/WSlider.html#setTickLength(eu.webtoolkit.jwt.WLength)">WSlider::setTickLength</a>, that allows users to set the length (width or height of the line, depending on whether the <code>WSlider</code> is <code>Orientation::Horizontal</code> or <code>Orientation::Vertical</code>) of the ticks.
For the native slider, ticks have also been enabled. Although both the positioning (the side on which ticks are placed) and their length cannot be changed. Only their interval can be manipulated through <a href="eu/webtoolkit/jwt/WSlider.html#setTickInterval(int)">WSlider::setTickInterval</a>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/12005">Issues #12005</a>:
a step value can now be set on a <a href="eu/webtoolkit/jwt/WSlider.html">WSlider</a>, using <a href="eu/webtoolkit/jwt/WSlider.html#setStep(int)">WSlider::setStep</a>.
This functions for both the native and non-native sliders. By default the step value is set to 1.
</li>
<li>
<a href="https://redmine.emweb.be/issues/12148">Issue #12148</a>:
attributes on the main page's <html> and <body> tags can now be specified. The new functions are:
<ul>
<li><a href="eu/webtoolkit/jwt/WApplication.html#setHtmlAttribute(java.lang.String,java.lang.String)">WApplication::setHtmlAttribute</a></li>
<li><a href="eu/webtoolkit/jwt/WApplication.html#setBodyAttribute(java.lang.String,java.lang.String)">WApplication::setBodyAttribute</a></li>
</ul>
</li>
<li>
<a href="https://redmine.emweb.be/issues/12036">Issue #12036</a>:
ensures that if a <a href="eu/webtoolkit/jwt/WCheckBox.html">WCheckBox</a> and <a href="eu/webtoolkit/jwt/WRadioButton.html">WRadioButton</a> have a custom style class, it remains in place after applying the <a href="eu/webtoolkit/jwt/WBootstrap5Theme.html">WBootstrap5Theme</a>.
</li>
</ul>
<h2>Release 4.10.2 (November 8, 2023)</h2>
<p>
Wt 4.10.2 is a patch release that addresses the following issues:
</p>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11932">Issue #11932</a>:
when calling <a href="eu/webtoolkit/jwt/WPushButton.html#setMenu(eu.webtoolkit.jwt.WPopupMenu)">WPushButton::setMenu</a> after a <a href="eu/webtoolkit/jwt/WPopupMenu.html">WPopupMenu</a> had already been added,
the second menu wasn't added to the button, and both <code>WPopupMenu</code>s were removed. Now, the new <code>WPopupMenu</code> is correctly added to the button.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11984">Issue #11984</a>:
corrected <a href="eu/webtoolkit/jwt/WTableView.html">WTableView</a>'s drag & drop functionality. When a <a href="eu/webtoolkit/jwt/WAbstractItemModel.html">WAbstractItemModel</a>'s items have the flags for drag & drop enabled (found in <a href="eu/webtoolkit/jwt/ItemFlag.html">ItemFlag</a>), the <a href="eu/webtoolkit/jwt/WAbstractItemView.html">WAbstractItemView</a> has <a href="eu/webtoolkit/jwt/WAbstractItemView.html#setDragEnabled(boolean)">setDragEnabled(true)</a> and <a href="eu/webtoolkit/jwt/WAbstractItemView.html#setEnabledDropLocations(eu.webtoolkit.jwt.DropLocation,eu.webtoolkit.jwt.DropLocation...)">setEnabledDropLocations()</a> set to <a href="eu/webtoolkit/jwt/DropLocation.html">DropLocation::BetweenRows</a>, the view will now correctly drop the items at the location indicated by the cursor, and will no longer cause an issue when moving the cursor out of the table when dragging.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11985">Issue #11985</a>:
ensures that if a <a href="eu/webtoolkit/jwt/WStringListModel.html">WStringListModel</a> is used in a <a href="eu/webtoolkit/jwt/WTableView.html">WTableView</a> that allows drag & drop, the content of the
model is correctly updated.
</li>
<li>
<a href="https://redmine.emweb.be/issues/12012">Issue #12012</a>:
due to an oversight in <a href="https://redmine.webtoolkit.eu/issues/10512">Issue #10512</a>, the keyboard and mouse events for a <a href="eu/webtoolkit/jwt/WTreeView.html">WTreeView</a>'s node were missing.
</li>
<a href="https://redmine.emweb.be/issues/11882">Issue #11882</a>:
the <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/fieldset">fieldset</a> element, used by <a href="eu/webtoolkit/jwt/WGroupBox.html">WGroupBox</a> has been corrected when using Bootstrap 5.
A default HTML value was used here, which caused the content to not be rendered correctly.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/12006">Issue #12006</a>
a JavaScript error could occur if no semicolon was added to the JS code when called by <a href="eu/webtoolkit/jwt/WWidget.html#setJavaScriptMember(java.lang.String,java.lang.String)">setJavaScriptMember</a> or <a href="eu/webtoolkit/jwt/DomElement.html#callJavaScript(java.lang.String)">callJavaScript</a>.
</li>
</ul>
<h2>Release 4.10.0 (May 30, 2023)</h2>
<p>
JWt 4.10.0 mainly consists of new features that provide some convenience and a back-end improvement.
</p>
<h3>New features</h3>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11627" target="_blank">Issue #11627</a>:
The included Servlet API JAR was updated to version 4.0.4, the last version that still
uses the <code>javax</code> namespace, and the Servlet 2.5 support was removed. Now
<a href="eu/webtoolkit/jwt/ServletInit.html">ServletInit</a> will set the default
request encoding of the
<a href="https://jakarta.ee/specifications/servlet/4.0/apidocs/javax/servlet/servletcontext"
target="_blank">ServletContext</a> to UTF-8.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/7279">Issue #7279</a>:
added <a href="eu/webtoolkit/jwt/WEmailEdit.html">WEmailEdit</a> and
<a href="eu/webtoolkit/jwt/WEmailValidator.html">WEmailValidator</a>, implementing
a <code><input type="email"></code>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8760" target="_blank">Issue #8760</a>:
extended <a href="eu/webtoolkit/jwt/auth/AuthWidget.html">Auth.AuthWidget</a> with the option to resend verificiation emails. When email verification is configured to be required and the email somehow got lost, the user would be stuck not being able to log in.
When the user tries to log in now, an info message will be shown saying they need to verify their email first along with a new button to resend the verification email. The user must then enter the email address again in a dialog before the email is sent.<br/>
The virtual methods <a href="eu/webtoolkit/jwt/auth/AuthWidget.html#letResendEmailVerification()">AuthWidget.letResendEmailVerification()</a> and <a href="eu/webtoolkit/jwt/auth/AuthWidget.html#getCreateResendEmailVerificationView()">AuthWidget.getCreateResendEmailVerificationView()</a> can be used to customize the UI.
</li>
</ul>
<h3>Other improvements</h3>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11412" target="_blank">Issue #11412</a>:
shift-click to open a new window did not work for links to internal paths. Shift-click is now handled by the browser, like ctrl- and meta-click.
</li>
</ul>
<h2>Release 4.9.2 (April 18, 2023)</h2>
<p>
Wt 4.9.2 is a patch release that addresses the following issues:
</p>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11307" target="_blank">Issue #11307</a>:
fixed an issue with multiple validators where custom error messages would not be copied
before assigning arguments, causing more arguments to be appended every time the getter was used.
To fix this, we made <a href="eu/webtoolkit/jwt/WString.html">WString</a> cloneable, and made sure
the copy construction in the original C++ code is
translated to a call to <a href="eu/webtoolkit/jwt/WString.html#clone()">WString#clone()</a>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11321" target="_blank">Issue #11321</a>:
fixed JWt's string splitting behavior to match Wt.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11424" target="_blank">Issue #11424</a>:
fixed redundant calls of
<a href="eu/webtoolkit/jwt/WDialog.html#setClosable(boolean)">WDialog#setClosable(false)</a>
causing a "widget not in container" error to be logged.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/10908" target="_blank">Issue #10908</a>:
fixed an issue with
<a href="eu/webtoolkit/jwt/WBootstrap5Theme.html">WBootstrap5Theme</a>
where the selection of a
<a href="eu/webtoolkit/jwt/WSuggestionPopup.html">WSuggestionPopup</a>
was not updated when using the arrow keys. We also made sure to scroll the currently
selected option into view when selected using the arrow keys.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11433" target="_blank">Issue #11433</a>:
fixed a regression in the treeview-dragdrop example where dropping a file on the folder view was not working anymore.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11379" target="_blank">Issue #11379</a>:
fixed a JavaScript error in <a href="eu/webtoolkit/jwt/WPaintedWidget.html">WPaintedWidget</a>.
</li>
</ul>
<h2>Release 4.9.1 (January 20, 2023)</h2>
<p>
JWt 4.9.1 is a patch release that addresses the following issues:
</p>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11230" target="_blank">Issue #11230</a>:
fixed an issue with
<a href="eu/webtoolkit/jwt/WApplication.html#suspend(java.time.Duration)">WApplication#suspend()</a>
where widgets would incorrectly believe they were still
<a href="eu/webtoolkit/jwt/WWidget.html#isRendered()">rendered</a> when unsuspending.
This would cause problems with e.g. <a href="eu/webtoolkit/jwt/WTextEdit.html">WTextEdit</a>
inside of a
<a href="eu/webtoolkit/jwt/WTemplate.html">WTemplate</a>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11240" target="_blank">Issue #11240</a>:
fixed an issue where the lazy loading logic breaks when removing and inserting a large
number of rows in a <a href="eu/webtoolkit/jwt/WTreeView.html">WTreeView</a>
(<a href="https://github.com/emweb/wt/pull/199" target="_blank">PR #199</a> by John Stark).
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11180" target="_blank">Issue #11180</a>:
fixes a regression in JWt 4.9.0 where
<a href="eu/webtoolkit/jwt/EntryPointType.html#WidgetSet">WidgetSet</a> mode
failed with a "classList is undefined" error.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11207" target="_blank">Issue #11207</a>:
fixes a regression in JWt 4.9.0 where
<a href="eu/webtoolkit/jwt/WWidget.html#setScrollVisibilityEnabled(boolean)">scroll visibility</a>
didn't work anymore.
</li>
<li>
Fixed a couple of <a href="eu/webtoolkit/jwt/WDialog.html">WDialog</a>-related
regressions when using
<a href="eu/webtoolkit/jwt/WBootstrap5Theme.html">WBootstrap5Theme</a>:
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11233" target="_blank">Issue #11233</a>:
hidden <a href="eu/webtoolkit/jwt/WDialog.html">WDialog</a>s would remain visible.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11248" target="_blank">Issue #11248</a>:
contents of a dialog could be cut off when
<a href="eu/webtoolkit/jwt/WWidget.html#setWidth(eu.webtoolkit.jwt.WLength)">setting the width</a>,
and
<a href="eu/webtoolkit/jwt/WDialog.html#setResizable(boolean)">resizing of dialogs</a>
didn't work.
</li>
</ul>
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/10138" target="_blank">Issue #10138</a>:
fixed ant build on Windows caused by ANTLR putting its output in a different location
depending on the operating system.
</li>
</ul>
<h2>Release 4.9.0 (December 22, 2022)</h2>
<p>
JWt 4.9.0 features a lot of changes under the hood: we have painstakingly removed jQuery from JWt,
modernized the JavaScript, and added a linter, formatter, and a new minifier in the process.
</p>
<p>
Also, now that we added some tooling to customize WBootstrap5Theme, the
<a href="http://jwt.emweb.be/jwt-gallery/gallery" target="_blank">widget gallery</a>'s
primary color was updated to be more in line with JWt's website.
</p>
<h3>Backwards incompatible changes</h3>
<h4>JWt now requires Java 11</h4>
<p>
JWt 4.9.0 bumps the minimum required Java version up to 11. We changed all of the
<code>build.xml</code> files to use <code>release="11"</code> instead of the old
<code>source</code> and <code>target</code> options.
</p>
<h4>Removal of jQuery</h4>
<p>
We removed every use of jQuery from JWt, and jQuery is now no longer automatically loaded.
This means that if you relied on the included jQuery version (for example, the <code>$</code> object or function),
you will have to make some changes to make it work with JWt 4.9.0. There are several options:
</p>
<ul>
<li>
<p>
Replace your uses of jQuery with vanilla JavaScript, which is what we did.
</p>
<p>
For example, the <code>$</code> function can often be replaced with
<a href="https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector" target="_blank">querySelector</a> or
<a href="https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll" target="_blank">querySelectorAll</a>.
</p>
</li>
<li>
<p>
Load jQuery yourself using
<a href="eu/webtoolkit/jwt/WApplication.html#require(java.lang.String,java.lang.String)">WApplication#require()</a>.
<a href="eu/webtoolkit/jwt/WApplication.html#requireJQuery(java.lang.String)">WApplication#requireJQuery()</a>
has been marked as deprecated.
</p>
<p>
For example:
<code>application.require("https://code.jquery.com/jquery-3.6.1.slim.min.js", "$");</code>.
</p>
</li>
</ul>
<h4>Changes to WBootstrap5Theme</h4>
<dl>
<dt>Collapsible panels</dt>
<dd>
<a href="eu/webtoolkit/jwt/WBootstrap5Theme.html">WBootstrap5Theme</a>
has used an
<a href="https://getbootstrap.com/docs/5.2/components/accordion/" target="_blank">accordion</a>
instead of a
<a href="https://getbootstrap.com/docs/5.2/components/card/" target="_blank">card</a>
for collapsible panels since its introduction in JWt 4.6.0.
Now, <a href="eu/webtoolkit/jwt/WPanel.html">WPanel</a> always uses a
<a href="https://getbootstrap.com/docs/5.2/components/card/" target="_blank">card</a>.
This allows all panels to have a consistent appearance, regardless of whether they can be collapsed or not.
Additionally, the
<a href="eu/webtoolkit/jwt/WPanel.html#collapse()">WPanel#collapse()</a> and
<a href="eu/webtoolkit/jwt/WPanel.html#expand()">WPanel#expand()</a> functions will now work
as expected with
<a href="eu/webtoolkit/jwt/WBootstrap5Theme.html">WBootstrap5Theme</a>.
This change resolves <a href="https://redmine.webtoolkit.eu/issues/10364" target="_blank">issue #10364</a>.
</dd>
<dt>Bootstrap 5 theme customization</dt>
<dd>
We've made it easier to customize the Bootstrap 5 theme.
<a href="eu/webtoolkit/jwt/WBootstrap5Theme.html">WBootstrap5Theme</a> now loads
a single CSS file that is built from
<a href="https://sass-lang.com/" target="_blank">Sass</a> source files.
The
<a href="http://jwt.emweb.be/jwt-gallery/gallery" target="_blank">widget gallery</a>
makes use of this by changing the primary color from Bootstrap's blue to the orange
used in JWt's logo and homepage.
This change resolves <a href="https://redmine.webtoolkit.eu/issues/9350" target="_blank">issue #9350</a>.
</dd>
</dl>
<h3>New features</h3>
<ul>
<li>
Added
<a href="eu/webtoolkit/jwt/WProgressBar.html#setValueStyleClass(java.lang.String)">WProgressBar#setValueStyleClass()</a>
(<a href="https://github.com/emweb/wt/pull/131" target="_blank">PR #131</a>
by maximiliank on GitHub).
</li>
<li>
Added <a href="eu/webtoolkit/jwt/Utils.html#htmlAttributeValue(java.lang.String)">Utils#htmlAttributeValue()</a>
to escape values if they are put into the value of an HTML tag.
</li>
</ul>
<h3>Other improvements</h3>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11067" target="_blank">Issue #11067</a>:
<a href="eu/webtoolkit/jwt/WWidget.html#animateShow(eu.webtoolkit.jwt.WAnimation)">animateShow()</a> and
<a href="eu/webtoolkit/jwt/WWidget.html#animateHide(eu.webtoolkit.jwt.WAnimation)">animateHide()</a> were
overhauled to use the
<a
href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API"
target="_blank">Web Animations API</a>. This fixes issues with choppy animations.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8629" target="_blank">Issue #8629</a>:
In order to ease maintenance, and make contributing to (J)Wt easier, we changed the JavaScript
minifier from the old version of Google Closure compiler we were using to
<a href="https://terser.org/" target="_blank">terser</a>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/10966" target="_blank">Issue #10966</a>:
Added a JavaScript formatter to format (J)Wt's JavaScript code.
Its usage is detailed in the Wt source tree at
<a
href="https://github.com/emweb/wt/blob/master/doc/development/javascript.md"
target="_blank"><code>doc/development/javascript.md</code></a>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/10395" target="_blank">Issue #10395</a>:
<a href="eu/webtoolkit/jwt/WPanel.html#setTitleBar(boolean)">WPanel#setTitleBar(false)</a>
now automatically calls
<a href="eu/webtoolkit/jwt/WPanel.html#setCollapsible(boolean)">WPanel#setCollapsible(false)</a>.
</li>
</ul>
<h3>Bug fixes</h3>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9076" target="_blank">Issue #9076</a>:
<a href="eu/webtoolkit/jwt/WDateEdit.html">WDateEdit</a>
gave a javascript error when opening the calendar popup if the
application was rendered in
<a href="eu/webtoolkit/jwt/EntryPointType.html#WidgetSet">WidgetSet</a>
mode.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/11138" target="_blank">Issue #11138</a>:
Fixed an issue in the widget gallery where images would not be loaded correctly if the path of the servlet
context is non-empty.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/10488" target="_blank">Issue #10488</a>:
Long polling requests interrupted on the server side now no longer prevent keep alive requests from being sent,
and thus the session from timing out. This was possible when JWt is deployed behind a reverse proxy that has
a shorter request timeout than the
<a href="eu/webtoolkit/jwt/Configuration.html#getServerPushTimeout()">server push timeout</a>.
</li>
</ul>
<h2>Release 4.8.3 (December 22, 2022)</h2>
<p>
JWt 4.8.3 is a patch release that addresses the following issues:
</p>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/10995" target="_blank">Issue #10995</a>:
fixed an issue with <a href="eu/webtoolkit/jwt/WContainerWidget.html">WContainerWidget</a>
where a session could terminate with the text "WContainerWidget: error parsing: undefined".
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8093" target="_blank">Issue #8093</a>:
fixed an issue where the bottom axis could be clipped off of a tall
<a href="eu/webtoolkit/jwt/chart/WCartesianChart.html">WCartesianChart</a>
(<a href="https://github.com/emweb/wt/pull/178" target="_blank">PR #178</a> by Apivan Tuntakurn).
</li>
</ul>
<h2>Release 4.8.2 (November 4, 2022)</h2>
<p>
JWt 4.8.2 is a simple patch release that fixes
<a href="https://redmine.webtoolkit.eu/issues/10976" target="_blank">issue #10976</a>:
<a href="eu/webtoolkit/jwt/WAbstractItemView.html#setHeaderAlignment(int,java.util.EnumSet)">WAbstractItemView#setHeaderAlignment</a>
would not properly update vertical alignment.
</p>
<h2>Release 4.8.1 (September 22, 2022)</h2>
<p>
JWt 4.8.1 is a simple patch release that addresses
<a href="https://redmine.webtoolkit.eu/issues/10825" target="_blank">issue #10825</a>.
Some left over JavaScript code in
<a href="eu/webtoolkit/jwt/WGoogleMap.html#setMapTypeControl(eu.webtoolkit.jwt.MapTypeControl)">WGoogleMap#setMapTypeControl</a>
targeting the v2 API would cause a JavaScript error.
</p>
<h2>Release 4.8.0 (July 8, 2022)</h2>
<p>
JWt 4.8.0 doesn't come with any big new features, but it does include some improvements.
</p>
<h3>Changes in default behavior</h3>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8660" target="_blank">Issue #8660</a>:
The default value of
<a href="eu/webtoolkit/jwt/auth/OAuthService.html#isPopupEnabled()">OAuthService#isPopupEnabled()</a>
was changed from <code>true</code> to <code>false</code>.
This means that the default method when using OAuth is always to redirect instead of using a popup.
</li>
</ul>
<h3>Improvements</h3>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/10019" target="_blank">Issue #10019</a>:
Added a cleaner fix for <a href="https://redmine.webtoolkit.eu/issues/9922" target="_blank">issue #9922</a>.
Instead of discarding responses containing only <code>{}</code>, JWt now no longer delineates its JavaScript
with curly brackets.
</li>
<li>
<a href="https://github.com/emweb/wt/pull/192" target="_blank">PR #192</a>:
Removed obsolete <code>cursor: hand</code>
</li>
</ul>
<h3>Bug fixes</h3>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9938" target="_blank">Issue #9938</a>:
The close icon for a <a href="eu/webtoolkit/jwt/WDialog.html">WDialog</a> was displayed on the left side
of the title bar when using bootstrap 5. This was fixed by using the Bootstrap 5 appropriate
<code><button></code> with the <code>btn-close</code> style class.
A new <code>Wt.WDialog.titlebar</code> template was introduced so that the rendering
of the title bar can be overridden.
</li>
</ul>
<h2>Release 4.7.3 (July 8, 2022)</h2>
<p>
Wt 4.7.3 is a patch release that addresses the following issues:
</p>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/10341" target="_blank">Issue #10341</a>:
Fixed an issue where JavaScript validators would incorrectly mark a
<a href="eu/webtoolkit/jwt/WLineEdit.html">WLineEdit</a>
that used an
<a href="eu/webtoolkit/jwt/WLineEdit.html#setInputMask(java.lang.String)">input mask</a>
as invalid, since they would not take the input mask into account.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9719" target="_blank">Issue #9719</a>
(<a href="https://github.com/emweb/wt/pull/186" target="_blank">PR #186</a>):
Fixed a regression where panning an interactive
<a href="eu/webtoolkit/jwt/chart/WCartesianChart.html">WCartesianChart</a>
would not update the
<a href="eu/webtoolkit/jwt/chart/WAxisSliderWidget.html">WAxisSliderWidget</a>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/10362" target="_blank">Issue #10362</a>:
<a href="eu/webtoolkit/jwt/WPanel.html#collapse()">WPanel#collapse()</a> and
<a href="eu/webtoolkit/jwt/WPanel.html#expand()">WPanel#expand()</a>
would cause a null pointer exception
<a href="eu/webtoolkit/jwt/WBootstrap5Theme.html">WBootstrap5Theme</a>. Now they do nothing.
</li>
<li>
<a href="https://github.com/emweb/wt/pull/188" target="_blank">PR #188</a>:
Fixed an issue where
<a href="eu/webtoolkit/jwt/WAbstractItemModel.html#insertColumn(int)">WTable#insertColumn</a>
would not properly associate the table with the newly created column.
</li>
<li>
Fixed <a href="https://redmine.webtoolkit.eu/issues/9923" target="_blank">issue #9923</a>:
A <a href="eu/webtoolkit/jwt/WFileDropWidget.html">WFileDropWidget</a> with
<a href="eu/webtoolkit/jwt/WFileDropWidget.html#setAcceptDrops(boolean)">setAcceptDrops()</a>
<code>false</code> and
<a href="eu/webtoolkit/jwt/WFileDropWidget.html#setDropIndicationEnabled(boolean)">setDropIndicationEnabled()</a>
<code>true</code> would render the page unresponsive.
</li>
<li>
Fixed <a href="https://redmine.webtoolkit.eu/issues/10578" target="_blank">issue #10578</a>:
Changing the validator of a
<a href="eu/webtoolkit/jwt/WDateEdit.html">WDateEdit</a> would not update the
<a href="eu/webtoolkit/jwt/WDateEdit.html#getBottom()">getBottom()</a> and
<a href="eu/webtoolkit/jwt/WDateEdit.html#getTop()">getTop()</a> of the
<code>WDateEdit</code> correctly.
</li>
</ul>
<h2>Release 4.7.2 (May 12, 2022)</h2>
<p>
JWt 4.7.2 is a patch release that addresses the following issue:
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/10003" target="_blank">Issue #10003</a>:
Calling <a href="eu/webtoolkit/jwt/WApplication.html#refresh()">WApplication#refresh()</a>
in the application constructor (e.g. by setting the locale) would produce a JavaScript error if there was
a <a href="eu/webtoolkit/jwt/WSpinBox.html">WSpinBox</a> in the widget tree.
</li>
</ul>
</p>
<h2>Release 4.7.1 (April 15, 2022)</h2>
<p>
JWt 4.7.1 is a patch release that addresses the following issues:
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9922" target="_blank">Issue #9922</a>:
JWt would send an update to the browser on every call to
<a href="eu/webtoolkit/jwt/WApplication.html#triggerUpdate()">WApplication#triggerUpdate()</a>
if server push was enabled.
This is because JWt thought the state was dirty when its JavaScript response buffer contained only <code>{}</code> (empty
block). This has been fixed by not sending a response if the buffer contains only <code>{}</code>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9695" target="_blank">Issue #9695</a>:
If a <a href="eu/webtoolkit/jwt/WSuggestionPopup.html">WSuggestionPopup</a> was created before the dialog it appears in,
it would be displayed below the dialog. The <code>z-index</code> of
<code>WSuggestionPopup</code> is now calculated using javascript so it is always shown on top.
</li>
</ul>
</p>
<h2>Release 4.7.0 (March 11, 2022)</h2>
<p>JWt 4.7.0 is a smaller release with no major new features to speak of, just some improvements and bug fixes here and there.</p>
<h3>Notable changes in default behavior</h3>
<p>These changes affect default behavior in JWt, and may require special attention:</p>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/7434" target="_blank">Issue #7434</a>:
<a href="eu/webtoolkit/jwt/WColor.html#getCssText()">WColor#getCssText()</a> now outputs
the color in <code>rgba</code> format by default.
It is now possible to set the opacity using such functions as
<a href="eu/webtoolkit/jwt/WCssDecorationStyle.html#setBackgroundColor(eu.webtoolkit.jwt.WColor)">WCssDecorationStyle#setBackgroundColor()</a>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8782" target="_blank">Issue #8782</a>:
When using drag/drop in combination with
<a href="eu/webtoolkit/jwt/WStandardItemModel.html">WStandardItemModel</a>,
the item flags are now copied. Previously, after dragging an item one time
the <a href="eu/webtoolkit/jwt/ItemFlag.html#DragEnabled">ItemFlag.DragEnabled</a>
flag would be lost and the item would no longer be draggable.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9591" target="_blank">Issue #9591</a>:
Added <a href="eu/webtoolkit/jwt/servlet/WebRequest.html#getUrlScheme(eu.webtoolkit.jwt.Configuration)">WebRequest#getUrlScheme</a>,
which looks at <code>X-Forwarded-Proto</code> if JWt is behind a trusted reverse proxy.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9056" target="_blank">Issue #9056</a>:
<a href="eu/webtoolkit/jwt/WFileDropWidget.html#getUploads()">WFileDropWidget#uploads()</a> now returns a copy of the list of uploads.
</li>
</ul>
<h3>Removals</h3>
<ul>
<li>
Since Google Maps v2 is no longer available as of May 26 2021, JWt no longer supports v2.
</li>
</ul>
<h2>Release 4.6.3 (March 10, 2022)</h2>
<p>
JWt 4.6.3 is a patch release that addresses the following issues:
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9790" target="_blank">Issue #9790</a>:
A localized <a href="eu/webtoolkit/jwt/WText.html">WText</a> with <a href="eu/webtoolkit/jwt/TextFormat.html#XHTML">TextFormat.XHTML</a> was not refreshed properly when using arguments.
</li>
</ul>
</p>
<h2>Release 4.6.2 (February 15, 2022)</h2>
<p>
JWt 4.6.2 is a patch release that addresses the following issues:
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9424" target="_blank">Issue #9424</a>:
The special "no selection" status of
<a href="eu/webtoolkit/jwt/WComboBox.html">WComboBox</a>
was lost if the items were rerendered, e.g. if the model changed.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9606" target="_blank">Issue #9606</a>:
fixed an exception being thrown in <a href="eu/webtoolkit/jwt/WMenuItem.html">WMenuItem</a>.
</li>
</ul>
</p>
<h2>Release 4.6.1 (December 23, 2021)</h2>
<p>
JWt 4.6.1 is a single bug fix release, fixing a regression
(<a href="https://redmine.webtoolkit.eu/issues/9523" target="_blank">issue #9523</a>).
A potential null dereference would crash the Wt site or widget gallery every few days.
</p>
<h2>Release 4.6.0 (December 14, 2021)</h2>
<p>JWt 4.6.0 has been a long time coming, but development has not been standing still. Among other things,
JWt 4.6.0 adds support for Bootstrap 5.</p>
<h3>Bootstrap 5 theming support (<a href="https://redmine.webtoolkit.eu/issues/7418" target="_blank">issue #7418</a>)</h3>
<p>
We split up <a href="eu/webtoolkit/jwt/WBootstrapTheme.html">WBootstrapTheme</a> into
<a href="eu/webtoolkit/jwt/WBootstrap2Theme.html">WBootstrap2Theme</a> and
<a href="eu/webtoolkit/jwt/WBootstrap3Theme.html">WBootstrap3Theme</a>, and added
<a href="eu/webtoolkit/jwt/WBootstrap5Theme.html">WBootstrap5Theme</a>. We found that the
different Bootstrap versions were distinct enough to warrant splitting each version of the theme up into its own class.
</p>
<p>
We abandoned development of <code>WBootstrap4Theme</code>, since there were still some unsolved
issues with it, and we didn't expect many users to be interested in it.
</p>
<p>
We also updated the design of the <a href="http://jwt.emweb.be/jwt-gallery/gallery" target="_blank">widget gallery</a>.
It now uses Bootstrap 5, and no longer uses box layouts, instead opting for a more responsive design featuring
a collapsible menu on narrow screens. This means that the widget gallery is finally usable on mobile phones!
</p>
<h3>Other features and improvements</h3>
<ul>
<li>
It is now possible to suspend the <a href="eu/webtoolkit/jwt/WApplication.html">WApplication</a> using the
<a href="eu/webtoolkit/jwt/WApplication.html#suspend(java.time.Duration)">suspend</a> function. Previously,
logging in using an external authentication provider required a popup, but this can now be done through a redirect
(<a href="eu/webtoolkit/jwt/auth/OAuthService.html#setPopupEnabled(boolean)">OAuthService#setPopupEnabled()</a>).
This can also be useful for redirecting to payment providers.
(See <a href="https://redmine.webtoolkit.eu/issues/7742" target="_blank">issue #7742</a>.)
</li>
<li>
The Bootstrap themes now no longer need an active <a href="eu/webtoolkit/jwt/WApplication.html">WApplication</a>
upon construction to properly function, through the addition of an <a href="eu/webtoolkit/jwt/WTheme.html#init(eu.webtoolkit.jwt.WApplication)">init()</a> function.
(See <a href="https://redmine.webtoolkit.eu/issues/9204" target="_blank">issue #9204</a>.)
</li>
<li>The <a href="eu/webtoolkit/jwt/WAbstractItemView.html">WAbstractItemView</a> now allows drag/drop in between rows.
See <a href="eu/webtoolkit/jwt/WAbstractItemView.html#setEnabledDropLocations(eu.webtoolkit.jwt.DropLocation,eu.webtoolkit.jwt.DropLocation...)">setEnabledDropLocations()</a>.
(See <a href="https://redmine.webtoolkit.eu/issues/8636" target="_blank">issue #8636</a>.)</li>
<li>Ability to change the row header count of <a href="eu/webtoolkit/jwt/WTableView.html" target="_blank">WTableView</a>
after it is rendered (see <a href="https://redmine.webtoolkit.eu/issues/8077" target="_blank">issue #8077</a>).</li>
<li>Splitting up updates to stay under the form data limit when many updates are rapidly generated
(<a href="https://redmine.webtoolkit.eu/issues/7990" target="_blank">issue #7990</a>).</li>
<li>Revert delay of <a href="eu/webtoolkit/jwt/WWidget.html#load()">WWidget#load()</a>.
Load now happens when a widget is added to the widget tree.
(See <a href="https://redmine.webtoolkit.eu/issues/7968" target="_blank">issue #7968</a>.)</li>
<li>Added option to not automatically select first suggestion of a
<a href="eu/webtoolkit/jwt/WSuggestionPopup.html">WSuggestionPopup</a>.</li>
</ul>
<h3>Bug fixes</h3>
<ul>
<li><a href="https://redmine.webtoolkit.eu/issues/8972" target="_blank">Issue #8972</a>: fixed a regression with
<a href="eu/webtoolkit/jwt/WResource.html#setInternalPath(java.lang.String)">WResource::setInternalPath()</a>.</li>
<li><a href="https://redmine.webtoolkit.eu/issues/8531" target="_blank">Issue #8531</a>:
fixed deletion/modification of remember me cookie when using websockets.</li>
<li><a href="https://redmine.webtoolkit.eu/issues/8336" target="_blank">Issue #8336</a>: fixed
<a href="eu/webtoolkit/jwt/WNavigationBar.html">WNavigationBar</a> regression: popup menu remains selected.</li>
<li><a href="https://redmine.webtoolkit.eu/issues/8135" target="_blank">Issue #8135</a>:
<a href="eu/webtoolkit/jwt/WMenu.html">WMenu</a> submenu selection not proparly propagated.</li>
<li><a href="https://redmine.webtoolkit.eu/issues/7811" target="_blank">Issue #7811</a>: invalid ackId.</li>
<li><a href="https://redmine.webtoolkit.eu/issues/7975" target="_blank">Issue #7975</a>: drag-drop icon under dialog.</li>
</ul>
<h2>Release 4.5.1 (October 7, 2021)</h2>
<p>JWt 4.5.1 is a bugfix release containing the following changes:</p>
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/9008" target="_blank">Issue #9008</a>:
Fixed possible JavaScript issues by appending a semicolon to all JavaScript statements when using
<a href="eu/webtoolkit/jwt/WApplication.html#doJavaScript(java.lang.String,boolean)">doJavaScript</a>.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8765" target="_blank">Issue #8765</a>:
fixed an issue where <code>trustedProxies</code> was <code>null</code> if the <a href="eu/webtoolkit/jwt/Configuration.html">Configuration</a>
was loaded from an XML file.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8407" target="_blank">Issue #8407</a>:
fixed an issue in <a href="eu/webtoolkit/jwt/WTreeView.html">WTreeView</a> where the expand icon was not removed
when removing the last child.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8376" target="_blank">Issue #8376</a>:
made dragging and dropping icons work correctly in
<a href="eu/webtoolkit/jwt/WAbstractItemView.html">WAbstractItemView</a> by
preventing the default action.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8335" target="_blank">Issue #8335</a>:
fixed an issue where
<a href="eu/webtoolkit/jwt/WWidget.html#layoutSizeChanged(int,int)">WWidget#layoutSizeChanged()</a> would
sometimes not be called.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8311" target="_blank">Issue #8311</a>:
fixed day of week conversion issue that caused <a href="eu/webtoolkit/jwt/WCalendar.html">WCalendar</a> to show up wrong.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8194" target="_blank">Issue #8194</a>:
fixed an issue where
<a href="eu/webtoolkit/jwt/WVirtualImage.html">WVirtualImage</a> would break if you added a
<a href="eu/webtoolkit/jwt/WInteractWidget.html#mouseMoved()">mouseMoved()</a> handler to images.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8114" target="_blank">Issue #8114</a>:
fixed a possible JavaScript error in <a href="eu/webtoolkit/jwt/WCanvasPaintDevice.html">WCanvasPaintDevice</a>
if an image load handler was executed after the painted widget was already removed.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/8041" target="_blank">Issue #8041</a>:
fixed an inconsistency in how ellipses were rendered when using
<a href="eu/webtoolkit/jwt/WPainter.html#drawArc(eu.webtoolkit.jwt.WRectF,int,int)">drawArc()</a> with
wide <a href="eu/webtoolkit/jwt/WPen.html">WPen</a> on an HTML canvas.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/7998" target="_blank">Issue #7998</a>:
made sure the scroll position is preserved when a <a href="eu/webtoolkit/jwt/WTreeView.html">WTreeView</a>
is sorted.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/7996" target="_blank">Issue #7996</a>:
clarified the documentation of <a href="eu/webtoolkit/jwt/WInteractWidget.html#clicked()">WInteractWidget#clicked()</a>
to note that middle clicks do not emit the clicked event.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/7912" target="_blank">Issue #7912</a>:
fixed JavaScript errors when using <a href="eu/webtoolkit/jwt/WPopupMenu.html">WPopupMenu</a>
in <a href="eu/webtoolkit/jwt/EntryPointType.html#WidgetSet">WidgetSet</a>
mode.
</li>
<li>
Added warning to the <a href="eu/webtoolkit/jwt/WSuggestionPopup.html">WSuggestionPopup</a> documentation: this widget should not be bound to a template.
</li>
<li>
Fixed an issue where the
<a href="eu/webtoolkit/jwt/WWidget.html#scrollVisibilityChanged()">scrollVisibilityChanged()</a>
signal would not always be created.
</li>
<li>
Fixed a "size is not a function" issue when using jQuery 3.x (contributed by Steven Köhler)
</li>
</ul>
<h2>Release 4.5.0 (December 15, 2020)</h2>
<ul>
<li>
Added
<a href="eu/webtoolkit/jwt/Configuration.html#setTrustedProxies(java.util.List)">Configuration#setTrustedProxies</a> and
<a href="eu/webtoolkit/jwt/Configuration.html#setOriginalIPHeader(java.lang.String)">Configuration#setOriginalIPHeader</a>
and deprecated
<a href="eu/webtoolkit/jwt/Configuration.html#setBehindReverseProxy(boolean)">Configuration::setBehindReverseProxy</a>.
</li>
<li>
Added a fix for when
<a href="eu/webtoolkit/jwt/EntryPointType.html#WidgetSet">WidgetSet</a>
mode is used to load two different instances of Wt. This could cause
a JavaScript error when using popup menus or suggestion popups.
</li>
</ul>
<h2>Release 4.4.0 (August 3, 2020)</h2>
<p>In this release, the JWt version makes a leap forward. In September 2017 Wt 4.0.0
was released, and now JWt has finally caught up. Since we keep Wt and JWt in sync, that means
we suddenly jump from version 3.6.0 to version 4.4.0.</p>
<h3>JWt 4 changes</h3>
<dl>
<dt>
Enums
</dt>
<dd>
With Wt 4, many of the names of enums changed to be a bit more sensible, since C++11 supports
scoped enums. This means that many of the enums in JWt had to change, too. This probably
constitutes the bulk of the changes that you will have to make when porting to JWt 4.
</dd>
<dt>
<a href="eu/webtoolkit/jwt/ItemDataRole.html">ItemDataRole</a> as a proper class
</dt>
<dd>
Previously, we would use <tt>int</tt> for roles in
<a href="eu/webtoolkit/jwt/WAbstractItemModel.html">WAbstractItemModel</a>. Now,
<a href="eu/webtoolkit/jwt/ItemDataRole.html">ItemDataRole</a> has become a proper class.
Instead of an integer for user-defined roles, you can now use
<tt>ItemDataRole.of(ItemDataRole.User.getValue() + 1)</tt>.
</dd>
<dt>
i18n changes
</dt>
<dd>
JWt 4 now supports plural expressions, using <a href="eu/webtoolkit/jwt/WString.html#trn-java.lang.String-long-">WString#trn</a>.
String retrieved through
<a href="eu/webtoolkit/jwt/WString.html#tr-java.lang.String-">tr</a> and
<a href="eu/webtoolkit/jwt/WString.html#trn-java.lang.String-long-">trn</a>
now include information about whether the original string
was XHTML encoded, and
<a href="eu/webtoolkit/jwt/WString.html#toString--">toString</a> and
<a href="eu/webtoolkit/jwt/WString.html#toXhtml--">toXhtml</a> will properly (un)escape the string.
</dd>
<dt>
<tt>WObject#setObjectName</tt>
</dt>
<dd>
<a href="eu/webtoolkit/jwt/WObject.html#setObjectName-java.lang.String-">WObject#setObjectName</a>
no longer affects the id of the widget. It is now placed into an extra attribute called
<tt>data-object-name</tt> instead. Changing the id could often lead
to nasty bugs, since JWt relies on the id to identify a widget.
</dd>
<dt>
CSS flex based layout implementation
</dt>
<dd>
<a href="eu/webtoolkit/jwt/WLayout.html">WBoxLayout</a> is now implemented using CSS flex.
Should you encounter any issues, you can still switch
back to the old JavaScript based implementation using
<a href="eu/webtoolkit/jwt/WLayout.html#setPreferredImplementation-eu.webtoolkit.jwt.LayoutImplementation-">WLayout#setPreferredImplementation</a>.
You can globally change the default with the static method
<a href="eu/webtoolkit/jwt/WLayout.html#setDefaultImplementation-eu.webtoolkit.jwt.LayoutImplementation-">WLayout#setDefaultImplementation</a>.
Note: setting the default is not thread safe, it should be changed when the servlet is being initialized.
</dd>
<dt>
ANTLR4
</dt>
<dd>
All of the included parsers were updated to use ANTLR 4 instead of ANTLR 3.
</dd>
<dt>
Java 8
</dt>
<dd>
The minimum supported Java version is now Java 8. This allowed us to also use Java 8's <tt>time</tt> API a bit more.
You will notice that in many places, a <tt>Duration</tt> is now used instead of an <tt>int</tt>.
</dd>
</dl>
<h3>Security related</h3>
<p>
JWt now rejects GET requests for Ajax-enabled sessions that are not for resources, as an
extra means to prevent session hijacking attempts. Wt patch provided by Bruce Toll in
<a href="https://redmine.webtoolkit.eu/issues/7585" target="_blank">issue #7585</a>.
</p>
<h3>Multiple X axes</h3>
<p>
<a href="eu/webtoolkit/jwt/chart/WCartesianChart.html">WCartesianChart</a>: similar to how
JWt 3.3.11 added support for multiple Y axes, JWt 4.4.0 adds support for multiple X axes,
too. Instead of trying to squeeze another <tt>int</tt> argument into functions like
<a href="eu/webtoolkit/jwt/chart/WCartesianChart.html#map-double-double-int-int-int-">WCartesianChart#map</a>,
we decided to add overloads that take two <a href="eu/webtoolkit/jwt/chart/WAxis.html">WAxis</a> references.
</p>
<h3>Bug fixes</h3>
<ul>
<li>
Auth:
<ul>
<li>
<a href="https://redmine.webtoolkit.eu/issues/7518" target="_blank">Issue #7518</a>: previously, it was
not possible to set
<a href="eu/webtoolkit/jwt/auth/AbstractPasswordService.AbstractStrengthValidator.html">AbstractStrengthValidator</a>
to non-mandatory. This has now been fixed. It now also correctly reports
<a href="eu/webtoolkit/jwt/WValidator.State.html#InvalidEmpty">InvalidEmpty</a> when the input is left empty.
</li>
<li>
Fixed an issue where signal listeners connected to <a href="eu/webtoolkit/jwt/auth/Login.html#changed--">Login#changed()</a>
would still have the old session id, which would afterwards be updated, causing resource urls created in the slot
to have the wrong session id.
</li>
</ul>
</li>
<li>
<a href="eu/webtoolkit/jwt/WPaintedWidget.html">WPaintedWidget</a>: fixed an issue where combining incremental painting (<a href="eu/webtoolkit/jwt/PaintFlag.html#PaintUpdate">PaintFlag.PaintUpdate</a>) with images could cause the first paint event to be discarded, resulting in an incomplete result.
</li>
<li>
Previously, having multiple instances of <a href="eu/webtoolkit/jwt/WGoogleMap.html">WGoogleMap</a> could cause JavaScript errors. This has now been resolved.
</li>
</ul>
<h2>Release 3.6.0 (March 26, 2020)</h2>
<p>JWt 3.6.0 looks like a pretty major change if you just look at the diff. This is however mostly formatting, since we changed the
formatting of the source code from being based on Eclipse to <a href="https://github.com/google/google-java-format" target="_blank">google-java-format</a>.</p>
<p>We've also made <a href="eu/webtoolkit/jwt/auth/AbstractUserDatabase.Transaction.html">AbstractUserDatabase.Transaction</a> <tt>AutoCloseable</tt>. If the transaction
is not committed or rollbacked, it is automatically rolled back.</p>
<p>Some small changes in behaviour that you may want to be aware of:</p>
<ul>
<li>
<a href="eu/webtoolkit/jwt/WCanvasPaintDevice.html">WCanvasPaintDevice</a>: instead of stopping the drawing entirely when <tt>drawImage()</tt> fails (e.g. because of a missing image),
the image will be skipped but drawing will continue. An error will be logged to the console.
</li>
<li>
<a href="https://redmine.webtoolkit.eu/issues/7404" target="_blank">Issue #7404</a>: reparenting of popup widgets should only stop at scroll bars.