2 | This example demonstrates the use of the "forward" feature. 3 |
4 |
5 | Enter a URL in the entry field and then press the Forward button to go to that url. 6 | 7 | URL: $urlField $forwardBtn -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/respond/phone/_wtabset.scss: -------------------------------------------------------------------------------- 1 | 2 | @if $wc-use-respond == true and $wc-respond-reduce-gap-when-narrow == true { 3 | // Do not make role='tab' smaller because the padding is part of the hit zone. 4 | [role='tabpanel'] { 5 | padding: $wc-phone-gap-normal; 6 | } 7 | } 8 | -------------------------------------------------------------------------------- /wcomponents-core/src/test/resources/wcomponents-test.properties: -------------------------------------------------------------------------------- 1 | bordertech.wcomponents.factory.impl.com.github.bordertech.wcomponents.util.LookupTable=com.github.bordertech.wcomponents.TestLookupTable 2 | 3 | # Resource bundle base name for internationalisation tests 4 | bordertech.wcomponents.i18n.baseName=i18n/test 5 | -------------------------------------------------------------------------------- /wcomponents-test-lib/spotbugs-exclude-filter.xml: -------------------------------------------------------------------------------- 1 | 2 || $!key | 6 |$!{context.get($key).getClass().getName()} | 7 |
| 7 | 8 | $text 9 | $duplicateButton 10 | $clearButton 11 | 12 | |
5 | * This interface is used to mark components which use AJAX to handle their internal state. 6 | * 7 | * @author Jonathan Austin 8 | * @since 1.1.0 9 | */ 10 | public interface AjaxInternalTrigger extends WComponent { 11 | } 12 | -------------------------------------------------------------------------------- /wcomponents-core/src/test/resources/com/github/bordertech/wcomponents/velocity/VelocityRenderer_Test.vm: -------------------------------------------------------------------------------- 1 | [this=$!{this}] 2 | [this.someProperty=$!{this.someProperty}] 3 | [uicontext=$!{uicontext}] 4 | [uic=$!{uic}] 5 | [children=$!{children}] 6 | [childA=$!{childA}] 7 | [childB=$!{childB}] 8 | [childC=$!{childC}] 9 | [velocityMapParam=$!{velocityMapParam}] 10 | [test_list=$!{test_list}] 11 | -------------------------------------------------------------------------------- /wcomponents-i18n/package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "wcomponents-i18n", 3 | "version": "1.0.0", 4 | "description": "i18n utilities for WComponents", 5 | "main": "po2json.js", 6 | "scripts": { 7 | "test": "echo \"Error: no test specified\" && exit 1" 8 | }, 9 | "author": "ricksbrown", 10 | "license": "LGPL-3.0", 11 | "dependencies": { 12 | "i18next-conv": "^3.0.3" 13 | } 14 | } 15 | -------------------------------------------------------------------------------- /wcomponents-examples/src/test/java/com/github/bordertech/wcomponents/examples/SeleniumTests.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents.examples; 2 | 3 | /** 4 | * This is a JUnit4.8 {@link org.junit.experimental.categories.Category Category} for marking Selenium unit tests. 5 | * 6 | * @author Yiannis Paschalidis 7 | * @since 1.0.0 8 | */ 9 | public interface SeleniumTests { 10 | } 11 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/components/_wlink.scss: -------------------------------------------------------------------------------- 1 | // CSS for WLink 2 | // ############################################################################# 3 | // Links which contain a positioned image must be forced to be inline block. 4 | .wc_a_ilb { 5 | display: inline-block; 6 | } 7 | 8 | 9 | a { 10 | &[aria-disabled = 'true'] { 11 | color: $wc-clr-disabled-fg; 12 | } 13 | } 14 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/fix/uc/_wtogglebutton.scss: -------------------------------------------------------------------------------- 1 | 2 | 3 | @if $wc-use-respond == true { 4 | .wc-togglebutton { 5 | &[data-wc-component], 6 | > button { 7 | &::after { 8 | height: 100%; 9 | } 10 | } 11 | 12 | &.wc_ro_sel, 13 | > [aria-checked='true'] { 14 | &::after { 15 | left: 50%; 16 | } 17 | } 18 | } 19 | } 20 | -------------------------------------------------------------------------------- /wcomponents-examples/src/main/resources/com/github/bordertech/wcomponents/examples/repeater/ProductItemRenderer.vm: -------------------------------------------------------------------------------- 1 | #set( $data = $this.getData() ) 2 |
3 |
5 | * This interface is used to mark components which are able to respond to the user "dropping" items via drag and 6 | * drop.
7 | * 8 | * @author Rick Brown 9 | * @since 1.0.0 10 | */ 11 | public interface DropZone extends WComponent { 12 | } 13 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/WBeanContainer.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * An extension of WBeanComponent which supports children. 5 | * 6 | * @author Yiannis Paschalidis 7 | * @deprecated Use {@link WContainer} instead. 8 | */ 9 | @Deprecated 10 | public class WBeanContainer extends WContainer { 11 | // Deprecated 12 | } 13 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/WSeparator.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * WSeparator provides spacing between items in a WMenu or WSubMenu. It is not a general purpose component. 5 | * 6 | * @author Yiannis Paschalidis 7 | * @since 1.0.0 8 | */ 9 | public class WSeparator extends AbstractWComponent implements MenuItem { 10 | } 11 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/resources/wcomponents.properties: -------------------------------------------------------------------------------- 1 | ## Version properties 2 | include=wcomponents-version.properties 3 | 4 | ## Main WComponent properties 5 | include=com/github/bordertech/wcomponents/web.properties 6 | 7 | ## Testing properties -- only present in the class path when tests are being run. 8 | include=wcomponents-test.properties 9 | include=wcomponents-test-lib-test.properties 10 | -------------------------------------------------------------------------------- /wcomponents-examples/src/main/resources/com/github/bordertech/wcomponents/examples/picker/TreePicker.vm: -------------------------------------------------------------------------------- 1 |7 | $src 8 |9 | 10 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/js/wc/string/sprintf.mjs: -------------------------------------------------------------------------------- 1 | /** 2 | * This module exists to abstract away the underlying printf implementation. 3 | * sprintf attaches itself to "window" if it can find nothing else. 4 | * It is not a native ES module. 5 | */ 6 | import "sprintf-js/src/sprintf.js"; 7 | 8 | /** 9 | * @param {any[]} args 10 | * @returns {string} 11 | */ 12 | export default function(...args) { 13 | // @ts-ignore 14 | return window.sprintf(...args); 15 | } 16 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/components/_audiovideo.scss: -------------------------------------------------------------------------------- 1 | // ############################################################################# 2 | // styles for WAudio and WVideo when the media is not able to be handled by the 3 | // user agent natively. 4 | // ############################################################################# 5 | 6 | .wc-src, 7 | .wc-track { 8 | display: inline-block; 9 | 10 | & + & { 11 | margin-left: $wc-gap-normal; 12 | } 13 | } 14 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/MessageContainer.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * MessageContainer - Interface for a {@link WComponent} that displays {@link WMessages}. 5 | * 6 | * @author Yiannis Paschalidis 7 | * @since 1.0.0 8 | */ 9 | public interface MessageContainer { 10 | 11 | /** 12 | * @return the WMessages contained by this MessageContainer. 13 | */ 14 | WMessages getMessages(); 15 | } 16 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/WSkipLinks.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * WSkipLinks is a component which has a heading and a list of internal links. These links will move the cursor point to 5 | * the first focusable element within a WPanel which has an accessKey set. 6 | * 7 | * @author Yiannis Paschalidis 8 | * @since 1.0.0 9 | */ 10 | public class WSkipLinks extends AbstractWComponent { 11 | } 12 | -------------------------------------------------------------------------------- /wcomponents-examples/src/main/resources/i18n/example.properties: -------------------------------------------------------------------------------- 1 | # Developers should use distinct message ids rather than text. 2 | ENTER_NAME_PROMPT=Your name 3 | SUBMIT_FORM=Submit 4 | HELLO_NAME=Hello {0} 5 | Output=Output 6 | DATE_PROMPT=Date of birth 7 | CLIENT_SIDE_PROMPT=Use client side validation? 8 | 9 | # Alternatively, internationalisation can be implemented by simply providing a translation of default text 10 | Internationalisation\ example=Internationalisation example 11 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/components/_collapsibletoggle.scss: -------------------------------------------------------------------------------- 1 | // The expand and collapse all buttons and their wrapper. 2 | // Common for WCollapsibleToggle and WTable's RowExpansion's expandAll. 3 | .wc_coltog { 4 | @include tight-box; 5 | list-style-type: none; 6 | 7 | > li { 8 | display: inline-block; 9 | 10 | + li { 11 | margin-left: $wc-gap-normal; 12 | } 13 | } 14 | 15 | button > .fa::before { 16 | @include margin($pos: right); 17 | } 18 | } 19 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/fix/uc/_wtable.scss: -------------------------------------------------------------------------------- 1 | 2 | 3 | @if $wc-use-respond == true { 4 | .wc_table_bottom_controls, 5 | .wc_table_top_controls { 6 | 7 | > div { 8 | display: block; 9 | } 10 | 11 | .wc_table_pag_cont { 12 | > span, 13 | > label { 14 | display: block; 15 | } 16 | } 17 | } 18 | 19 | @if $wc-use-respond-table == true { 20 | [sortable] > thead th > .fa { 21 | float: right; 22 | } 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/wc-edge.scss: -------------------------------------------------------------------------------- 1 | // Fixes for Microsoft Edge 2 | 3 | // IMPORTS of all required variables. 4 | // ############################################################################# 5 | // Import WComponent vars 6 | @import 'vars/wc'; 7 | // Import WComponent mixins once rather than per use. 8 | @import 'mixins/common'; 9 | 10 | // ############################################################################# 11 | // Edge specific files 12 | @import 'fix/edge/wtree'; 13 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/common/_list.scss: -------------------------------------------------------------------------------- 1 | // Styles applied to list output of many components. 2 | // See also ../components/_layout.scss for listlayout styles 3 | 4 | 5 | // represents a list with no bullets 6 | .wc_list_nb { 7 | @include tight-box; 8 | list-style-type: none; 9 | } 10 | 11 | // text mode option and optgroup emulation 12 | .wc_inoptgroup { 13 | text-indent: $wc-gap-large; 14 | } 15 | 16 | // opt group emulator 17 | .wc-optgroup { 18 | font-weight: bold; 19 | } 20 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/render/webxml/WFieldWarningIndicatorRenderer.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents.render.webxml; 2 | 3 | import com.github.bordertech.wcomponents.validation.WFieldWarningIndicator; 4 | 5 | /** 6 | * Layout manager for the {@link WFieldWarningIndicator} component. 7 | * 8 | * @author Jonathan Austin 9 | * @since 1.0.0 10 | */ 11 | final class WFieldWarningIndicatorRenderer extends AbstractWFieldIndicatorRenderer { 12 | } 13 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/js/wc/array/diff.mjs: -------------------------------------------------------------------------------- 1 | /** 2 | * Returns the difference between two arrays. 3 | * @param arr1 The array to compare against. 4 | * @param arr2 The array to compare. 5 | * @returns {Array} The items found in arr1 but not in arr2. 6 | */ 7 | export default function diff(arr1, arr2) { 8 | if (arr1 && arr2 && Array.isArray(arr1) && Array.isArray(arr2)) { 9 | return arr1.filter(function(item) { 10 | return arr2.indexOf(item) < 0; 11 | }); 12 | } 13 | return []; 14 | } 15 | -------------------------------------------------------------------------------- /wcomponents-core/src/test/java/com/github/bordertech/wcomponents/TestSampleException.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * This class assists in the unit testing of WComponents. 5 | * 6 | * @author Anthony O'Connor 7 | * @since 1.0.0 8 | */ 9 | public class TestSampleException extends Exception { 10 | 11 | /** 12 | * constructor. 13 | * 14 | * @param message sample message. 15 | */ 16 | public TestSampleException(final String message) { 17 | super(message); 18 | } 19 | } 20 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/wcdebug/_script.scss: -------------------------------------------------------------------------------- 1 | // CSS to highlight console.warn and cosole.error output 2 | body { 3 | &.wc_loggedwarn { 4 | background-color: $wc-debug-color-warning; 5 | 6 | &::before { 7 | content: 'Warnings in the console, do not panic'; 8 | } 9 | } 10 | 11 | &.wc_loggederror { //the error style MUST TRUMP the warn style 12 | background-color: $wc-debug-color-error; 13 | 14 | &::before { 15 | content: 'Script error! Danger! Panic!'; 16 | } 17 | } 18 | } 19 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/Option.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * Describes an option in a list-type control, e.g. {@link WDropdown}, {@link WMultiSelect} etc. 5 | * 6 | * @author Yiannis Paschalidis 7 | * @since 1.0.0 8 | */ 9 | public interface Option { 10 | 11 | /** 12 | * @return the code for this option. 13 | */ 14 | String getCode(); 15 | 16 | /** 17 | * @return the textual description of this option. 18 | */ 19 | String getDesc(); 20 | } 21 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/components/_clipboard.scss: -------------------------------------------------------------------------------- 1 | // ############################################################################# 2 | // clipboard 3 | // ############################################################################# 4 | 5 | button.wc-clipboard { 6 | margin-left: $wc-gap-normal; 7 | display: none; 8 | opacity: 50%; 9 | &:hover { 10 | opacity: 100%; 11 | } 12 | &:focus { 13 | opacity: 100%; 14 | } 15 | } 16 | 17 | body.wc-clipwrite button.wc-clipboard { 18 | display: inline-block; 19 | } 20 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/MenuItemGroup.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * A menu item that can group other menu items. 5 | *
6 | * Even though MenuItemGroup extends MenuContainer, it is not allowed to have a nested MenuItemGroup. 7 | *
8 | * 9 | * @author Jonathan Austin 10 | * @since 1.0.2 11 | * @deprecated menu groups are not compatible with WCAG 2.0. 12 | */ 13 | @Deprecated 14 | public interface MenuItemGroup extends MenuItem, MenuContainer { 15 | } 16 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/SelectionToggleable.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * Components that have a selection which can be toggled by {@link WSelectToggle} 5 | * must implement this interface. 6 | */ 7 | public interface SelectionToggleable { 8 | 9 | /** 10 | * Sets the selections for this component. 11 | * 12 | * @param selected if true, select everything. If false, deselect everything. 13 | */ 14 | void toggleSelection(boolean selected); 15 | 16 | } 17 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/servlet/NoContextException.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents.servlet; 2 | 3 | import com.github.bordertech.wcomponents.util.SystemException; 4 | 5 | /** 6 | * A request was received that expected a User Context to already exist. 7 | */ 8 | public class NoContextException extends SystemException { 9 | 10 | /** 11 | * @param message the error message 12 | */ 13 | public NoContextException(final String message) { 14 | super(message); 15 | } 16 | 17 | } 18 | -------------------------------------------------------------------------------- /wcomponents-examples/src/main/resources/com/github/bordertech/wcomponents/examples/WButtonExample.vm: -------------------------------------------------------------------------------- 1 |Examples of the various ways WButton can be configured.
2 | $plainBtn 3 |5 | * This interface is used to mark components which are able to trigger an AJAX request.
6 | * 7 | *8 | * NOTE: Components must not implement this interface unless they already support client-side AJAX triggering. 9 | * Implementing this interface does 10 | * NOT automatically enable a component to be used an AJAX trigger.
11 | * 12 | * @author Yiannis Paschalidis 13 | * @since 1.0.0 14 | */ 15 | public interface AjaxTrigger extends WComponent { 16 | } 17 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/resources/schema/ui/v1/session.xsd: -------------------------------------------------------------------------------- 1 | 2 |5 | * This interface is used to mark components which are to be individually targeted for replacement with AJAX.
6 | * 7 | *8 | * NOTE: Components must not implement this interface unless they already support client-side AJAX targeting. 9 | * Implementing this interface does 10 | * NOT automatically enable a component to be used an AJAX target.
11 | * 12 | * @author Yiannis Paschalidis 13 | * @since 1.0.0 14 | */ 15 | public interface AjaxTarget extends WComponent { 16 | } 17 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/container/SessionTokenException.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents.container; 2 | 3 | import com.github.bordertech.wcomponents.util.SystemException; 4 | 5 | /** 6 | * An invalid session token was provided on the request. 7 | *8 | * This usually occurs when a user interacts with a page and the session has expired. 9 | *
10 | */ 11 | public class SessionTokenException extends SystemException { 12 | 13 | /** 14 | * @param message the session token message 15 | */ 16 | public SessionTokenException(final String message) { 17 | super(message); 18 | } 19 | 20 | } 21 | -------------------------------------------------------------------------------- /wcomponents-xslt/src/main/xslt/wc.ui.clipboard.xsl: -------------------------------------------------------------------------------- 1 |5 | * This interface is used to mark components which can be targeted by a Subordinate control.
6 | * 7 | *8 | * NOTE: Components must not implement this interface unless they already support client-side Subordinate 9 | * targeting. Implementing this interface does 10 | * NOT automatically enable a component to be used an Subordinate target.
11 | * 12 | * @author Yiannis Paschalidis 13 | * @since 1.0.0 14 | */ 15 | public interface SubordinateTarget extends WComponent { 16 | } 17 | -------------------------------------------------------------------------------- /wcomponents-core/src/test/java/com/github/bordertech/wcomponents/MockContentStreamAccess.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | import java.io.ByteArrayInputStream; 4 | import java.io.InputStream; 5 | 6 | /** 7 | * MockContentStreamAccess - a ContentStreamAccess useful for unit testing. 8 | * 9 | * @author Yiannis Paschalidis 10 | * @since 1.0.0 11 | */ 12 | public class MockContentStreamAccess extends MockContentAccess implements ContentStreamAccess { 13 | 14 | /** 15 | * @return a stream to the content. 16 | */ 17 | @Override 18 | public InputStream getStream() { 19 | return new ByteArrayInputStream(getBytes()); 20 | } 21 | } 22 | -------------------------------------------------------------------------------- /wcomponents-examples/src/main/java/com/github/bordertech/wcomponents/examples/TextDuplicatorVelocity2.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents.examples; 2 | 3 | /** 4 | * An example extension of {@link TextDuplicatorVelocityImpl} to show how different a template can be specified. 5 | * 6 | * @author Martin Shevchenko 7 | * @since 1.0.0 8 | */ 9 | public class TextDuplicatorVelocity2 extends TextDuplicatorVelocityImpl { 10 | 11 | /** 12 | * Creates a TextDuplicator_Velocity2. 13 | */ 14 | public TextDuplicatorVelocity2() { 15 | super("com/github/bordertech/wcomponents/examples/TextDuplicator_Velocity2.vm", "Pretty Duplicator 2"); 16 | } 17 | } 18 | -------------------------------------------------------------------------------- /.editorconfig: -------------------------------------------------------------------------------- 1 | # EditorConfig: http://EditorConfig.org 2 | 3 | # top-most EditorConfig file 4 | root = true 5 | 6 | [*] 7 | charset=utf-8 8 | end_of_line=lf 9 | insert_final_newline=true 10 | indent_style=tab 11 | indent_size=4 12 | 13 | [*.java] 14 | trim_trailing_whitespace=true 15 | 16 | [*.{js,mjs}] 17 | trim_trailing_whitespace=true 18 | 19 | [*.properties] 20 | trim_trailing_whitespace=false 21 | 22 | [*.{css,sass,scss}] 23 | indent_style=space 24 | indent_size=2 25 | trim_trailing_whitespace=true 26 | 27 | [*.{yml,yaml}] 28 | indent_style=space 29 | indent_size=2 30 | 31 | [*.md] 32 | indent_style=space 33 | indent_size=2 34 | trim_trailing_whitespace=true 35 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/mixins/_mandatory.scss: -------------------------------------------------------------------------------- 1 | // ############################################################################# 2 | // MANDATORY Indcator 3 | // ############################################################################# 4 | 5 | $wc-mandatory-size: .5em !default; 6 | $wc-mandatory-offset: $wc-gap-small !default; 7 | 8 | @mixin mandatory-indicator { 9 | display: none; 10 | @if $wc-mandatory-offset != 0 { 11 | margin-left: $wc-mandatory-offset; 12 | } 13 | 14 | @if $wc-mandatory-size != -1 $wc-mandatory-size != 0 and $wc-mandatory-size != inherit and $wc-mandatory-size != 1em { 15 | font-size: $wc-mandatory-size; 16 | } 17 | } 18 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/SubordinateTrigger.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | *5 | * This interface is used to mark components which are able to trigger a client-side Subordinate.
6 | * 7 | *8 | * NOTE: Components must not implement this interface unless they already support triggering client-side 9 | * Subordinates. Implementing this interface does 10 | * NOT automatically enable a component to be used an Subordinate trigger.
11 | * 12 | * @author Yiannis Paschalidis 13 | * @since 1.0.0 14 | */ 15 | public interface SubordinateTrigger extends WComponent { 16 | } 17 | -------------------------------------------------------------------------------- /wcomponents-xslt/src/main/xslt/wc.ui.version.xsl: -------------------------------------------------------------------------------- 1 | 2 |8 | * This exception usually occurs when a trigger has become not visible due to other AJAX activity on the page 9 | *
10 | */ 11 | public class AjaxTriggerException extends SystemException { 12 | 13 | /** 14 | * @param message the AJAX trigger message 15 | */ 16 | public AjaxTriggerException(final String message) { 17 | super(message); 18 | } 19 | 20 | } 21 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/fix/uc/_button.scss: -------------------------------------------------------------------------------- 1 | 2 | 3 | @if $wc-use-respond == true { 4 | // make north (before text) look like west 5 | .wc_btn_imgn { 6 | > img { 7 | @include margin(bottom, 0); 8 | @include margin(right); 9 | float: left; 10 | } 11 | } 12 | 13 | // make south (after text) look like east 14 | .wc_btn_imgs { 15 | > img { 16 | @include margin(top, 0); 17 | @include margin(left); 18 | float: right; 19 | } 20 | } 21 | 22 | .wc_btn_imge { 23 | > img { 24 | float: right; 25 | } 26 | } 27 | 28 | .wc_btn_imgw { 29 | > img { 30 | float: left; 31 | } 32 | } 33 | } 34 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/Marginable.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * WComponents that can have a margin. 5 | * 6 | * @author Jonathan Austin 7 | * @since 1.0.0 8 | */ 9 | public interface Marginable extends WComponent { 10 | 11 | /** 12 | * Set the margin for the component, or null for no margin. 13 | * 14 | * @param margin the margin for the component 15 | */ 16 | void setMargin(final Margin margin); 17 | 18 | /** 19 | * Get the margin for the component, or null if not set. 20 | * 21 | * @return the margin for the component, or null if not set 22 | */ 23 | Margin getMargin(); 24 | } 25 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/subordinate/builder/SyntaxException.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents.subordinate.builder; 2 | 3 | /** 4 | * Thrown to indicate that an expression is syntactically invalid. 5 | * 6 | * @author Yiannis Paschalidis 7 | * @since 1.0.0 8 | */ 9 | class SyntaxException extends RuntimeException { 10 | 11 | /** 12 | * Default serialisation identifier. 13 | */ 14 | private static final long serialVersionUID = 1L; 15 | 16 | /** 17 | * Creates a SyntaxException. 18 | * 19 | * @param message the detail message. 20 | */ 21 | SyntaxException(final String message) { 22 | super(message); 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/js/wc/key.mjs: -------------------------------------------------------------------------------- 1 | /** 2 | * Module to provide key press information. 3 | * @module 4 | */ 5 | export default { 6 | /** 7 | * Determine if this is a "META" key. 8 | * @param {string|KeyboardEvent} key The pressed key (can be the KeyboardEvent itself or its `code` or `key` property). 9 | * @returns {Boolean} true if the key is either ALT, CTRL, META or SHIFT 10 | */ 11 | isMeta: function(key) { 12 | if (key) { 13 | const metas = ["Alt", "Control", "Meta", "Shift"]; 14 | /** @type string */ 15 | const keyName = key["key"] || key["code"] || key; 16 | return metas.some(meta => keyName.startsWith(meta)); 17 | } 18 | return false; 19 | } 20 | }; 21 | -------------------------------------------------------------------------------- /wcomponents-theme/src/test/spec/wc.file.getFileSize.test.mjs: -------------------------------------------------------------------------------- 1 | import getFileSize from "wc/file/getFileSize.mjs"; 2 | import {addFilesToInput, getInput} from "../helpers/specUtils.mjs"; 3 | describe("wc/file/getFileSize", () => { 4 | let testHolder; 5 | 6 | beforeEach(() => { 7 | testHolder = document.body.appendChild(document.createElement("div")); 8 | testHolder.innerHTML = ``; 9 | }); 10 | 11 | it("can get the file size", function() { 12 | const element = getInput(testHolder, "file1"); 13 | addFilesToInput(element, [{ value: "SixteenChars.gif", type: "image/gif" }]); 14 | expect(getFileSize(element)[0]).toBe(16); 15 | }); 16 | }); 17 | 18 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/components/_wselecttoggle.scss: -------------------------------------------------------------------------------- 1 | // ############################################################################# 2 | // WSelectToggle 3 | // ############################################################################# 4 | 5 | .wc_seltog { 6 | > button { 7 | margin-left: $wc-gap-normal; 8 | 9 | &:first-child { 10 | margin-left: 0; 11 | } 12 | } 13 | 14 | &[role='checkbox'] { 15 | + label { 16 | margin-left: $wc-gap-small; 17 | } 18 | 19 | > .fa { 20 | text-align: left; 21 | width: $wc-icon-size; 22 | } 23 | } 24 | 25 | &[data-wc-value][aria-checked='true'] { 26 | font-weight: bold; 27 | } 28 | } 29 | -------------------------------------------------------------------------------- /wcomponents-examples/src/main/java/com/github/bordertech/wcomponents/examples/subordinate/SubordinateControlSuite.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents.examples.subordinate; 2 | 3 | import com.github.bordertech.wcomponents.WContainer; 4 | 5 | /** 6 | * This suite of examples is intended to keep UI Designers aware of what SubordinateControl components are available to 7 | * Developers. 8 | * 9 | * @author Martin Shevchenko 10 | * @since 1.0.0 11 | */ 12 | public class SubordinateControlSuite extends WContainer { 13 | 14 | /** 15 | * Creates a SubordinateControlSuite. 16 | */ 17 | public SubordinateControlSuite() { 18 | setTemplate(SubordinateControlSuite.class); 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/BeanBoundComponentModel.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * The {@link ComponentModel} for {@link BeanBound} components. 5 | * 6 | * @author Yiannis Paschalidis 7 | * @since 1.0.0 8 | */ 9 | public class BeanBoundComponentModel extends DataBoundComponentModel { 10 | 11 | /** 12 | * The associated bean. 13 | */ 14 | private Object bean; 15 | 16 | /** 17 | * @return the bean. 18 | */ 19 | protected Object getBean() { 20 | return bean; 21 | } 22 | 23 | /** 24 | * @param bean the bean to set. 25 | */ 26 | protected void setBean(final Object bean) { 27 | this.bean = bean; 28 | } 29 | } 30 | -------------------------------------------------------------------------------- /wcomponents-examples/src/main/resources/i18n/example_fr_CA.properties: -------------------------------------------------------------------------------- 1 | # You can implement internationalisation by simply providing a translation of the english text 2 | Internationalisation\ example=Par exemple l'internationalisation 3 | 4 | # Alternatively, you may wish to use distinct message ids rather than text 5 | ENTER_NAME_PROMPT=Entrez votre nom 6 | SUBMIT_FORM=Soumettre 7 | HELLO_NAME=Bonjour {0} 8 | Output=La sortie de cet exemple 9 | DATE_PROMPT=Date de naissance 10 | CLIENT_SIDE_PROMPT=Utiliser la validation dans le navigateur? 11 | 12 | # The following are internal WComponent messages which have been internationalised 13 | bordertech.wcomponents.message.fieldMandatory=S''il vous pla\u00eet entrez {0} -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/fix/uc/_wmenu.scss: -------------------------------------------------------------------------------- 1 | 2 | 3 | @if $wc-use-respond == true { 4 | .wc-submenu-o { 5 | > .wc-decoratedlabel { 6 | max-width: 90%; 7 | width: auto; 8 | } 9 | 10 | > .fa { 11 | float: right; 12 | } 13 | } 14 | 15 | .wc-menuitem { 16 | &.wc-icon-before, 17 | &.wc-icon-after { 18 | .wc-decoratedlabel { 19 | max-width: 90%; 20 | width: auto; 21 | } 22 | } 23 | } 24 | 25 | // full screen sub menus 26 | .wc-menu-type-column, 27 | .wc_menu_bar { 28 | .wc_closesubmenu { 29 | .wc-decoratedlabel { 30 | max-width: 90%; 31 | width: auto; 32 | } 33 | } 34 | } 35 | } 36 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/wc-ie11.scss: -------------------------------------------------------------------------------- 1 | // Fixes for IE 11 and before. 2 | // NOTE: nothing before IE11 will work anyway! 3 | 4 | // IMPORTS of all required variables. 5 | // ############################################################################# 6 | // Import WComponent vars 7 | @import 'vars/wc'; 8 | // Import WComponent mixins once rather than per use. 9 | @import 'mixins/common'; 10 | 11 | // ############################################################################# 12 | // IE specific files 13 | @import 'fix/ie11/button'; 14 | @import 'fix/ie11/combo'; 15 | @import 'fix/ie11/wmenu'; 16 | @import 'fix/ie11/wmultifileupload'; 17 | @import 'fix/ie11/wtabset'; 18 | @import 'fix/ie11/wtree'; 19 | -------------------------------------------------------------------------------- /wcomponents-core/src/test/java/com/github/bordertech/wcomponents/subordinate/builder/SyntaxException_Test.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents.subordinate.builder; 2 | 3 | import org.junit.Assert; 4 | import org.junit.Test; 5 | 6 | /** 7 | * JUnit tests for the {@link SyntaxException} class. 8 | * 9 | * @author Yiannis Paschalidis 10 | * @since 1.0.0 11 | */ 12 | public final class SyntaxException_Test { 13 | 14 | @Test 15 | public void testConstructor() { 16 | String message = "SyntaxException_Test.testConstructor.message"; 17 | SyntaxException exception = new SyntaxException(message); 18 | 19 | Assert.assertEquals("Incorrect message", message, exception.getMessage()); 20 | } 21 | } 22 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/sass/respond/phone/_wmenu.scss: -------------------------------------------------------------------------------- 1 | @if $wc-use-respond == true { 2 | // full screen sub menus 3 | .wc-menu-type-column, 4 | .wc_menu_bar { 5 | .wc_submenucontent { 6 | @include border-box; 7 | height: 100%; 8 | left: 0; 9 | overflow: auto; 10 | position: fixed; 11 | top: 0; 12 | white-space: normal; 13 | width: 100%; 14 | 15 | > [role] { 16 | font-size: $wc-menu-font-larger; 17 | } 18 | } 19 | 20 | .wc_closesubmenu { 21 | display: block; 22 | 23 | .wc-decoratedlabel { 24 | display: inline-table; 25 | max-width: calc(100% - #{$wc-gap-normal}); 26 | } 27 | } 28 | } 29 | } 30 | -------------------------------------------------------------------------------- /wcomponents-examples-lde/src/main/java/com/github/bordertech/wcomponents/examples/lde/StandaloneLauncherProxy.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents.examples.lde; 2 | 3 | import com.github.bordertech.wcomponents.lde.StandaloneLauncher; 4 | 5 | /** 6 | * Acts as a proxy to the StandaloneLauncherProxy, intended use is the executable jar built by this module. 7 | * 8 | * @author Rick Brown 9 | */ 10 | public class StandaloneLauncherProxy { 11 | 12 | /** 13 | * The entry point to the launcher. 14 | * 15 | * @param args command-line arguments, ignored. 16 | * @throws Exception on error 17 | */ 18 | public static void main(final String args[]) throws Exception { 19 | StandaloneLauncher.main(args); 20 | } 21 | } 22 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/js/wc/debug/indicator.mjs: -------------------------------------------------------------------------------- 1 | /** 2 | * Provides an indicator that debug mode is on. 3 | * 4 | * @module 5 | */ 6 | import initialise from "wc/dom/initialise.mjs"; 7 | import processResponse from "wc/ui/ajax/processResponse.mjs"; 8 | 9 | /** 10 | * Count the number of Element nodes in the current document and set it as the value of an attribute on 11 | * document.body. 12 | * @function 13 | * @private 14 | */ 15 | function countElements() { 16 | document.body.setAttribute("data-wc-nodeCount", String(document.getElementsByTagName("*").length)); 17 | } 18 | 19 | initialise.register({ 20 | postInit: () => { 21 | countElements(); 22 | processResponse.subscribe(countElements, true); 23 | } 24 | }); 25 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/js/wc/dom/toDocFragment.mjs: -------------------------------------------------------------------------------- 1 | /** 2 | * "Safe" conversion of HTML to DocumentFragment. 3 | * @param {String} html the HTML to convert to a document fragment 4 | * TODO doubt we need this any more, deleted half of it already (also could use HTML templates) 5 | */ 6 | export default function toDocFragment(html) { 7 | const result = document.createDocumentFragment(); 8 | const tmpDF = document.createDocumentFragment(); 9 | const tmpElement = tmpDF.ownerDocument.createElement("div"); 10 | const tmpContainer = tmpDF.appendChild(tmpElement); 11 | tmpContainer.innerHTML = html; 12 | let next; 13 | while ((next = tmpContainer.firstChild)) { 14 | result.appendChild(next); 15 | } 16 | return result; 17 | } 18 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/BeanProviderBoundComponentModel.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * The {@link ComponentModel} for {@link BeanProviderBound} components. 5 | * 6 | * @author Yiannis Paschalidis 7 | * @since 1.0.0 8 | */ 9 | public class BeanProviderBoundComponentModel extends DataBoundComponentModel { 10 | 11 | /** 12 | * The bean id. 13 | */ 14 | private Object beanId; 15 | 16 | /** 17 | * @return the bean id. 18 | */ 19 | protected Object getBeanId() { 20 | return beanId; 21 | } 22 | 23 | /** 24 | * @param beanId the bean id to set. 25 | */ 26 | protected void setBeanId(final Object beanId) { 27 | this.beanId = beanId; 28 | } 29 | } 30 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/Placeholderable.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * This is a marker interface to indicate that this component can take placeholder text. 5 | * @author Rick Brown 6 | * @since 1.4 7 | */ 8 | public interface Placeholderable extends WComponent { 9 | 10 | /** 11 | * Set placeholder text which will appear in the field if it is editable and has no content. 12 | * @param placeholder The text to set as the placeholder. 13 | */ 14 | void setPlaceholder(final String placeholder); 15 | 16 | /** 17 | * Get the placeholder text, if explicitly set. 18 | * @return The placeholder text, if set. 19 | */ 20 | String getPlaceholder(); 21 | } 22 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/Image.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | import java.awt.Dimension; 4 | 5 | /** 6 | * Represents an image. Implementations can choose whether to explicitly store the byte[] or fetch it from some sort of 7 | * streaming resource as needed to service the {@link #getBytes} method as needed. 8 | * 9 | * @author James Gifford, Martin Shevchenko 10 | * @since 1.0.0 11 | */ 12 | public interface Image extends ContentAccess { 13 | 14 | /** 15 | * @return the natural size of the image, or null if no natural size is known. If only one dimension is known, use a 16 | * negative value (eg, -1) for the other dimension. 17 | */ 18 | Dimension getSize(); 19 | } 20 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/Disableable.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * Expresses the notion that a WComponent can handle the idea of being "enabled" or "disabled". 5 | * 6 | * @author James Gifford 7 | * @since 1.0.0 8 | */ 9 | public interface Disableable extends WComponent { 10 | 11 | /** 12 | * Indicates whether the Disableable is disabled. 13 | * 14 | * @return true if the Disableable is disabled, otherwise false. 15 | */ 16 | boolean isDisabled(); 17 | 18 | /** 19 | * Sets whether the Disableable is disabled. 20 | * 21 | * @param disabled if true, the Disableable is disabled. If false, it is enabled. 22 | */ 23 | void setDisabled(boolean disabled); 24 | } 25 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/Mandatable.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | /** 4 | * Expresses the notion that a WComponent can handle the idea of being "mandatory" or "optional". 5 | * 6 | * @author Jonathan Austin 7 | * @since 1.0.0 8 | */ 9 | public interface Mandatable extends WComponent { 10 | 11 | /** 12 | * Set whether or not this component is mandatory. 13 | * 14 | * @param mandatory true for mandatory, false for optional. 15 | */ 16 | void setMandatory(final boolean mandatory); 17 | 18 | /** 19 | * Indicates whether or not this component is mandatory. 20 | * 21 | * @return true if the input is mandatory, false otherwise. 22 | */ 23 | boolean isMandatory(); 24 | } 25 | -------------------------------------------------------------------------------- /wcomponents-core/src/test/java/com/github/bordertech/wcomponents/MockImage.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | import java.awt.Dimension; 4 | 5 | /** 6 | * MockImage - implementation of Image useful for unit testing. 7 | * 8 | * @author Yiannis Paschalidis 9 | * @since 1.0.0 10 | */ 11 | public class MockImage extends MockContentAccess implements Image { 12 | 13 | /** 14 | * The image size, in pixels. 15 | */ 16 | private Dimension size; 17 | 18 | /** 19 | * @return Returns the size. 20 | */ 21 | @Override 22 | public Dimension getSize() { 23 | return size; 24 | } 25 | 26 | /** 27 | * @param size The size to set. 28 | */ 29 | public void setSize(final Dimension size) { 30 | this.size = size; 31 | } 32 | } 33 | -------------------------------------------------------------------------------- /wcomponents-core/src/test/java/com/github/bordertech/wcomponents/WPrintButton_Test.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | import org.junit.Assert; 4 | import org.junit.Test; 5 | 6 | /** 7 | * WPrintButton_Test - Unit tests for {@link WPrintButton}. 8 | * 9 | * @author Yiannis Paschalidis 10 | * @since 1.0.0 11 | */ 12 | public class WPrintButton_Test { 13 | 14 | @Test 15 | public void testConstructors() { 16 | String text = "WPrintButton_Test.testConstructors"; 17 | 18 | WPrintButton button = new WPrintButton(); 19 | Assert.assertEquals("Incorrect button text", "Print", button.getText()); 20 | 21 | button = new WPrintButton(text); 22 | Assert.assertEquals("Incorrect button text", text, button.getText()); 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /wcomponents-theme/src/main/js/wc/date/daysInMonth.mjs: -------------------------------------------------------------------------------- 1 | /** 2 | * Get the number of days in a given month of a given year. 3 | * 4 | * @example var today = new Date(); 5 | * daysInMonth(today.getFullYear(), today.getMonth()+1); // month is not zero based (why not??)(because it isn't!!) 6 | * // will return the number of days in the current month. 7 | * 8 | * @function 9 | * @alias module:wc/date/daysInMonth 10 | * @param {number} year The 2 or 4 digit year to check. 11 | * @param {number} month The month - this NOT zero based, ie january = 1, december = 12 12 | * @returns {number} The number of days in the month if we can determine it. 13 | */ 14 | export default function daysInMonth(year, month) { 15 | return new Date(year, month, 0).getDate(); 16 | } 17 | -------------------------------------------------------------------------------- /wcomponents-core/src/test/java/com/github/bordertech/wcomponents/WImageEditor_Test.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | import java.awt.Dimension; 4 | import org.junit.Test; 5 | 6 | /** 7 | * Unit tests for {@link WImageEditor} 8 | */ 9 | public class WImageEditor_Test extends AbstractWComponentTestCase { 10 | 11 | @Test 12 | public void testDuplicateComponentModels() { 13 | WImageEditor imageEditor = new WImageEditor(); 14 | assertNoDuplicateComponentModels(imageEditor, "overlayUrl", "test"); 15 | assertNoDuplicateComponentModels(imageEditor, "useCamera", true); 16 | assertNoDuplicateComponentModels(imageEditor, "renderInline", true); 17 | assertNoDuplicateComponentModels(imageEditor, "size", new Dimension(100, 213)); 18 | } 19 | } 20 | -------------------------------------------------------------------------------- /wcomponents-core/src/main/java/com/github/bordertech/wcomponents/MenuContainer.java: -------------------------------------------------------------------------------- 1 | package com.github.bordertech.wcomponents; 2 | 3 | import java.util.List; 4 | 5 | /** 6 | * A component that can hold menu items. 7 | * 8 | * @author Jonathan Austin 9 | * @since 1.0.2 10 | */ 11 | public interface MenuContainer extends WComponent { 12 | 13 | /** 14 | * @param item the menu item to add 15 | */ 16 | void addMenuItem(final MenuItem item); 17 | 18 | /** 19 | * @param item the menu item to remove 20 | */ 21 | void removeMenuItem(final MenuItem item); 22 | 23 | /** 24 | * Remove all menu items. 25 | */ 26 | void removeAllMenuItems(); 27 | 28 | /** 29 | * @return the items of this menu container 30 | */ 31 | List