nsp-struts1-taglib

NSP taglib for Apache Struts1 Tag Library

• <bean:xxx/> - Bean taglib
• <html:xxx/> - HTML taglib
• <logic:xxx/> - Logic taglib
• See TypeScript declaration files for API detail.

SYNOPSIS

import {createNSP} from "nsp-server-pages";
import {beanTags, htmlTags, logicTags} from "nsp-struts1-taglib";

const nsp = createNSP();

nsp.addTagLib({ns: "bean", tag: beanTags});
nsp.addTagLib({ns: "html", tag: htmlTags});
nsp.addTagLib({ns: "logic", tag: logicTags});

const render = await nsp.loadJSP("path/to/template.jsp");

const context = {};

const html = await render(context);

console.log(html);

COMMONJS

• Both ES Modules and CommonJS supported.

const {createNSP} = require("nsp-server-pages");
const {beanTags, htmlTags, logicTags} = require("nsp-struts1-taglib");

COMPATIBILITY

35 / 58 tags implemented. Contributions for missing tags are welcome here!

Struts Bean Tags

| Tag | Class | Status | Note | |--------------------|--------------|------------|--------------------------------------------------------------| | <bean:cookie> | CookieTag | 👍 OK | | | <bean:define> | DefineTag | 👍 OK | | | <bean:header> | HeaderTag | 👍 OK | | | <bean:include> | IncludeTag | 🕑 Not Yet | | | <bean:message> | MessageTag | 🕑 Not Yet | | | <bean:page> | PageTag | 🕑 Not Yet | | | <bean:parameter> | ParameterTag | 👍 OK | | | <bean:resource> | ResourceTag | 👍 OK | implement nsp.hook("bean:resource", (name) => string) hook | | <bean:size> | SizeTag | 👍 OK | | | <bean:struts> | StrutsTag | 🚫 N/A | not implemented by design | | <bean:write> | WriteTag | 👍 OK | format="" not supported yet |

Struts HTML Tags

| Tag | Class | Status | Note | |----------------------------|------------------------|------------|-------------------------------------| | <html:base> | BaseTag | 🕑 Not Yet | | | <html:button> | ButtonTag | 🕑 Not Yet | | | <html:cancel> | CancelTag | 🕑 Not Yet | | | <html:checkbox> | CheckboxTag | 🕑 Not Yet | | | <html:errors> | ErrorsTag | 🕑 Not Yet | | | <html:file> | FileTag | 🕑 Not Yet | | | <html:form> | FormTag | 👍 OK | some features not supported yet | | <html:frame> | FrameTag | 👍 OK | | | <html:hidden> | HiddenTag | 👍 OK | | | <html:html> | HtmlTag | 👍 OK | Locale not supported yet | | <html:image> | ImageTag | 👍 OK | message resources not supported yet | | <html:img> | ImgTag | 🕑 Not Yet | | | <html:javascript> | JavascriptValidatorTag | 🕑 Not Yet | | | <html:label> | LabelTag | 🕑 Not Yet | | | <html:link> | LinkTag | 👍 OK | some features not supported yet | | <html:messages> | MessagesTag | 🕑 Not Yet | | | <html:multibox> | MultiboxTag | 👍 OK | | | <html:optionsCollection> | OptionsCollectionTag | 🕑 Not Yet | | | <html:options> | OptionsTag | 👍 OK | some features not supported yet | | <html:option> | OptionTag | 👍 OK | message resources not supported yet | | <html:param> | ParamTag | 🕑 Not Yet | | | <html:password> | PasswordTag | 🕑 Not Yet | | | <html:radio> | RadioTag | 👍 OK | | | <html:reset> | ResetTag | 🕑 Not Yet | | | <html:rewrite> | RewriteTag | 👍 OK | some features not supported yet | | <html:select> | SelectTag | 👍 OK | | | <html:submit> | SubmitTag | 👍 OK | | | <html:textarea> | TextareaTag | 👍 OK | | | <html:text> | TextTag | 👍 OK | | | <html:xhtml> | XhtmlTag | 🕑 Not Yet | |

Struts Logic Taglib

| Tag | Class | Status | Note | |------------------------------|-----------------------|------------|-------------------------------------| | <logic:empty> | EmptyTag | 👍 OK | | | <logic:equal> | EqualTag | 👍 OK | | | <logic:forward> | ForwardTag | 👍 OK | | | <logic:greaterEqual> | GreaterEqualTag | 👍 OK | | | <logic:greaterThan> | GreaterThanTag | 👍 OK | | | <logic:iterate> | IterateTag | 👍 OK | | | <logic:lessEqual> | LessEqualTag | 👍 OK | | | <logic:lessThan> | LessThanTag | 👍 OK | | | <logic:match> | MatchTag | 👍 OK | | | <logic:messagesNotPresent> | MessagesNotPresentTag | 🕑 Not Yet | message resources not supported yet | | <logic:messagesPresent> | MessagesPresentTag | 🕑 Not Yet | message resources not supported yet | | <logic:notEmpty> | NotEmptyTag | 👍 OK | | | <logic:notEqual> | NotEqualTag | 👍 OK | | | <logic:notMatch> | NotMatchTag | 👍 OK | | | <logic:notPresent> | NotPresentTag | 👍 OK | | | <logic:present> | PresentTag | 👍 OK | | | <logic:redirect> | RedirectTag | 🚫 N/A | not implemented by design |

Struts Nested Taglib

Not supported yet.

INHERITANCE

Import struts1Impl to inherit a class from the taglib.

import {Struts1Html} from "nsp-struts1-taglib";
import {struts1Impl} from "nsp-struts1-taglib/impl";

export class MyTextareaTag extends struts1Impl.html.TextareaTag {
    protected attr: MyTextareaTagAttr;

    render() {
        const {some} = this.attr;
        if (some) {
            // do something
        } else {
            // do something else
        }
        return super.render();
    }
}

interface MyTextareaTagAttr extends Struts1Html.TextareaTagAttr {
    some?: string; // add your custom attributes here
}

LINKS

• https://github.com/kawanet/nsp-server-pages
• https://github.com/kawanet/nsp-jstl-taglib
• https://github.com/kawanet/nsp-struts1-taglib
• https://github.com/kawanet/nsp-seasar2-taglib
• https://github.com/apache/struts1
• https://github.com/apache/struts1/tree/trunk/taglib/src/main/java/org/apache/struts/taglib
• https://github.com/apache/struts1/tree/trunk/taglib/src/main/resources/META-INF/tld

LICENSE

// SPDX-License-Identifier: Apache-2.0