https://github.com/kusaladithya/jsp-template
Template inheritance tag library you can manage template layouts.
https://github.com/kusaladithya/jsp-template
jap-template-inheritence jsp-template
Last synced: 3 months ago
JSON representation
Template inheritance tag library you can manage template layouts.
- Host: GitHub
- URL: https://github.com/kusaladithya/jsp-template
- Owner: KusalAdithya
- Created: 2024-12-04T11:44:26.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2025-02-07T11:24:46.000Z (4 months ago)
- Last Synced: 2025-02-07T12:33:03.718Z (4 months ago)
- Topics: jap-template-inheritence, jsp-template
- Language: Java
- Homepage:
- Size: 18.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# JSP Template Inheritance
The upgraded version of this repository: [kwon37xi/jsp-template-inheritance](https://github.com/kwon37xi/jsp-template-inheritance)
This version compatible with JDK 11.
[](https://github.com/KusalAdithya/jsp-template-inheritance)
With these template inheritance tag library you can manage template layouts.
You don't need to use layout frameworks like [Sitemesh](http://wiki.sitemesh.org/display/sitemesh/Home) or
[Apache Tiles](http://tiles.apache.org/).
If you use freemarker, refer to [freemarker-template-inheritance](https://github.com/kwon37xi/freemarker-template-inheritance).
### Maven dependencies
```xml
com.waka.template
jsp-template
1.0
```
### Gradle dependencies
```groovy
dependencies {
implementation 'com.waka.template:jsp-template:1.0'
}
```
## Usage
### web.xml
```xml
jsp-inheritance-prefix
/WEB-INF/layouts/
jsp-inheritance-suffix
.jsp
```
### /WEB-INF/layouts/base.jsp : layout
```jsp
<%@page contentType="text/html; charset=UTF-8" %>
<%@taglib uri="http://com.waka.template/jsp-template" prefix="layout" %>
JSP Template Inheritance
Head
header
Contents
Contents will be placed under this h2
```
### view.jsp : contents
```jsp
<%@page contentType="text/html; charset=UTF-8" %>
<%@taglib uri="http://com.waka.template/jsp-template" prefix="layout" %>
This is an example about layout management with JSP Template Inheritance
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin porta,
augue ut ornare sagittis, diam libero facilisis augue, quis accumsan enim velit a mauris.
Ut eleifend elit ante, sit amet suscipit leo lobortis eu. Quisque vitae lorem feugiat,
lacinia nulla eu, interdum eros. Ut dignissim tincidunt nisl ac iaculis.
Praesent consectetur arcu vitae tellus scelerisque venenatis.
Morbi vel leo eros. In id libero ultricies, laoreet enim et, tempor magna.
Vestibulum lorem velit, accumsan id purus at, lobortis fermentum diam.
Aenean nec placerat elit. Aenean vel sem arcu.
```
### PutType
1. APPEND : The put contents will be appended after block's contents. default.
1. PREPEND : The put contents will be prepended before block's contents.
1. REPLACE : The put contents will replace block's contents. The block's contents will be removed.
PutType vlaues are case insensitive.
### Layout path prefix/suffix
In web.xml you can set `jsp-inheritance-prefix` and `jsp-inheritance-suffix` context parameters.
The layout name will be prefixed and suffixed with these parameters.
When you set `jsp-inheritance-prefix` as `/WEB-INF/layouts/`, `jsp-ineheritance-suffix` as
`.jsp` and call `` the layout file URL will be `/WEB-INF/layouts/base.jsp`.
The prefix and suffix can be omitted.
### Example
`example` module is web application layout example. Run the module and browse .
Refer to `index.jsp`, `WEB-INF/layouts/base.jsp`, `WEB-INF/layouts/secondLayout.jsp`.
## Known problems
If you want to pass a variable from a child page to it's layout page, the variable must be added to **REQUEST scope**.
## Reference
1. [freemarker-template-inheritance](https://github.com/kwon37xi/freemarker-template-inheritance)
2. [jsp-template-inheritance](https://github.com/kwon37xi/jsp-template-inheritance)