7

我在另一个问题中询问了传递属性，发现我可以为组件创建一个自定义渲染器，<p:autocomplete>但问题是我的自定义渲染器将用于我的项目（站点范围）中的每个 p:autocomplete。因此，我选择创建一个自定义组件，该组件扩展org.primefaces.component.autocomplete.AutoComplete并向文本框添加必要的属性。

我最初的想法是添加一个构造函数，但它似乎不起作用，因为此时属性映射为空：

@FacesComponent("com.mycomponents.SiteSearch")
public class SiteSearch extends AutoComplete {

    public SiteSearch() {
        Map<String,Object> attrs = getAttributes();
        attrs.put("x-webkit-speech", null); 
        attrs.put("x-webkit-grammer", "builtin:search");
        attrs.put("onwebkitspeechchange", "this.form.submit();");
        attrs.put("placeholder", "Enter a Search Term");
    }   
}

我的另一个想法是让这个自定义组件为空（空类），然后指定一个自定义渲染器来扩展org.primefaces.component.autocomplete.AutoCompleteRenderer和修改那里的属性。

毕竟，我只需要一种方法将这些属性与这个文本框分开，所以仅仅在 p:autoComplete 上放置一个自定义渲染器是行不通的（除非我可以为这个使用 renderType= 属性p：自动完成？）。

4

1 回答 1

18

如果您需要一个使用不同渲染器的特定组件，<p:autoComplete>那么您真的无法创建具有自己的系列和组件类型的自定义组件。您仍然可以扩展 PrimeFaces AutoComplete（及其渲染器）以节省一些样板代码。

在自定义组件中，您需要为这些属性提供 getter。您也可以指定设置器，这样您始终可以从视图侧覆盖默认值。这些 getter/setter 应该依次委托给StateHelper.

x-webkit-*属性只有一点问题。-是 Java 标识符中的非法字符。因此，您必须重命名 getter/setter 并稍微更改渲染器，因为标准渲染器依赖于组件属性名称与标签属性名称完全相同。更新：我知道x-webkit-speech应该按原样呈现（因此，不需要 getter/setter），这x-webkit-grammer实际上是一个错字，应该是x-webkit-grammar.

以下是SiteSearch组件的外观：

@FacesComponent(SiteSearch.COMPONENT_TYPE)
public class SiteSearch extends AutoComplete {

    public static final String COMPONENT_FAMILY = "com.example";
    public static final String COMPONENT_TYPE = "com.example.SiteSearch";

    private enum PropertyKeys {
        grammar, onspeechchange, placeholder
    }

    @Override
    public String getFamily() {
        return COMPONENT_FAMILY;
    }

    @Override
    public String getRendererType() {
        return SiteSearchRenderer.RENDERER_TYPE;
    }

    public String getGrammar() {
        return (String) getStateHelper().eval(PropertyKeys.grammar, "builtin:search");
    }

    public void setGrammar(String grammar) {
        getStateHelper().put(PropertyKeys.grammar, grammar);
    }

    public String getOnspeechchange() {
        return (String) getStateHelper().eval(PropertyKeys.onspeechchange, "submit()");
    }

    public void setOnspeechchange(String onspeechchange) {
        getStateHelper().put(PropertyKeys.onspeechchange, onspeechchange);
    }

    public String getPlaceholder() {
        return (String) getStateHelper().eval(PropertyKeys.placeholder, "Enter a Search Term");
    }

    public void setPlaceholder(String placeholder) {
        getStateHelper().put(PropertyKeys.placeholder, placeholder);
    }

}

请注意，getter 具有指定的所有默认值。如果eval()返回null，则将返回默认值。我还对属性名称进行了一定程度的中和，以便通过相应地修改渲染器，它可以被任何未来的非 webkit 浏览器重用。

以下是上述组件的SiteSearchRenderer渲染器外观：

@FacesRenderer(
    componentFamily=SiteSearch.COMPONENT_FAMILY,
    rendererType=SiteSearchRenderer.RENDERER_TYPE
)
public class SiteSearchRenderer extends AutoCompleteRenderer {

    public static final String RENDERER_TYPE = "com.example.SiteSearchRenderer";

    @Override
    protected void renderPassThruAttributes(FacesContext facesContext, UIComponent component, String[] attrs) throws IOException {
        ResponseWriter writer = facesContext.getResponseWriter();
        writer.writeAttribute("x-webkit-speech", "x-webkit-speech", null);
        writer.writeAttribute("x-webkit-grammar", component.getAttributes().get("grammar"), "grammar");
        writer.writeAttribute("onwebkitspeechchange", component.getAttributes().get("onspeechchange"), "onspeechchange");
        writer.writeAttribute("placeholder", component.getAttributes().get("placeholder"), "placeholder");
        super.renderPassThruAttributes(facesContext, component, attrs);
    }

}

要在视图中使用它，我们当然需要将其注册为标签。创建一个/WEB-INF/my.taglib.xml文件：

<?xml version="1.0" encoding="UTF-8"?>
<facelet-taglib
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facelettaglibrary_2_0.xsd"
    version="2.0"
>
    <namespace>http://example.com/ui</namespace>

    <tag>
        <tag-name>siteSearch</tag-name>
        <component>
            <component-type>com.example.SiteSearch</component-type>
            <renderer-type>com.example.SiteSearchRenderer</renderer-type>
        </component>
    </tag>
</facelet-taglib>

<renderer>请注意，您不再需要faces-config.xml此操作。@FacesRenderer注释可以在真正的自定义组件上完成它的工作。因此，删除您根据上一个问题创建的<renderer>条目。faces-config.xml

现在通过以下上下文参数告诉 JSF 你有一个自定义标记库web.xml：

<context-param>
    <param-name>javax.faces.FACELETS_LIBRARIES</param-name>
    <param-value>/WEB-INF/my.taglib.xml</param-value>
</context-param>

最后，您可以按如下方式使用它：

<html ... xmlns:my="http://example.com/ui">
...
<my:siteSearch />

您甚至可以指定其他属性，这些属性将覆盖组件中设置的默认值：

<my:siteSearch grammar="builtin:language" onspeechchange="alert('peek-a-boo')" placeholder="Search" />

对于属性的 IDE 自动完成，您<attribute>需要<tag>在my.taglib.xml.

于 2012-05-13T03:13:26.113 回答