Customizing the user interface with LESS and property files
You can customize the user interface by using the LESS and Property files. The LESS and Property files reduce the effort of modifying numerous CSS entries when you need to apply a common style across the application.
Note: The LESS, CSS, and Property files that are provided
with the application are available in the
<INSTALL_DIR>/repository/eardata/isccs/war/isccs/resources/css/isccs
directory.
You must not modify any of these files.- Customize the CSS in one of the following ways:
- If you want to customize a specific property such as the color
of a user interface element across the application, do the following
steps:
- Create a properties file, for example
properties.txt
and include only those methods or properties that you want to modify. You must use the same method or property as defined by the application and assign the required value. You can refer to the methods or properties in theisccs-less-properties.txt
file that is provided with the application. - Run the following Ant script from the
<INSTALL_DIR>/bin
folder:./sci_ant.sh -f compileLessAndGenerateCSS.xml -DcustomLessFileLoc=/data/temp/CustomFiles/
Where/data/temp/CustomFiles/
refers to the location of the custom LESS and property files.The following .css files are updated to include the required changes and are available in the<INSTALL_DIR>/repository/eardata/isccs/war/isccs/resources/css/isccs
directory.isccs.css
isccs_rtl.css
isccs-pa-dss.css
- Create a properties file, for example
- If you want to modify a specific CSS entry such as the font size
in a panel across the application, do the following steps:
- Create a
.less
file, for examplenewstyles.less
and include only those CSS entries that you want to modify. You must use the same attribute names as defined by the application and assign the required value. You can refer to the.less
files that are provided with the application. - Run the following Ant script from the
<INSTALL_DIR>/bin
folder:./sci_ant.sh -f compileLessAndGenerateCSS.xml -DcustomLessFileLoc=/data/temp/CustomFiles/
Where/data/temp/CustomFiles/
refers to the location of the custom LESS and property files.The following .css files are updated to include the required changes and is available in the<INSTALL_DIR>/repository/eardata/isccs/war/isccs/resources/css/isccs
directory.isccs.css
isccs_rtl.css
isccs-pa-dss.css
- Create a
- Similarly, if you add more screens by extending the application, define custom properties and methods, and run the Ant script. The .css files are updated to include the style for the extended screens.
Alternatively, you can run the Ant script in the following ways:./sci_ant.sh -f compileLessAndGenerateCSS.xml
: You are prompted to provide the location of the.less
files../sci_ant.sh -f compileLessAndGenerateCSS.xml -DcustomLessFileLoc=
: You are not prompted to provide the location of the.less
files. You can run this command to revert to the default styles provided by the application.
- If you want to customize a specific property such as the color
of a user interface element across the application, do the following
steps:
- After customizing the application, build and deploy the application WAR or EAR as per your requirements.
The following LESS files are also provided with the application:
isccs-common.less
: This file contains the styles that are commonly applied across the application. For example, colors of panel headers.isccs-dev-ref.less
: This file contains the styles that are specific to certain screens.isccs-images.less
: This file contains the styles that are applied to images.isccs-override.less
: This file contains the styles that are provided by the Dojo framework and are overridden.
Note: When you are applying styles to a bi-directional user interface,
you must ensure that the directional issues are addressed. For example,
to paginate in a right-to-left user interface, the right arrow is
used to go to the previous page and the left arrow is used to go to
the next page. Whereas, the behavior in a left-to-right user interface
is opposite. Therefore, to apply styles to a left-to-right user interface,
use
isccs-ltr-less-properties.txt
. Similarly, to
apply styles to a right-to-left user interface, use isccs-rtl-less-properties.txt
.