001// Copyright 2006, 2007, 2008, 2011 The Apache Software Foundation 002// 003// Licensed under the Apache License, Version 2.0 (the "License"); 004// you may not use this file except in compliance with the License. 005// You may obtain a copy of the License at 006// 007// http://www.apache.org/licenses/LICENSE-2.0 008// 009// Unless required by applicable law or agreed to in writing, software 010// distributed under the License is distributed on an "AS IS" BASIS, 011// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 012// See the License for the specific language governing permissions and 013// limitations under the License. 014 015package org.apache.tapestry5.corelib.components; 016 017import org.apache.tapestry5.MarkupWriter; 018import org.apache.tapestry5.corelib.base.AbstractTextField; 019 020/** 021 * TextArea component corresponds to a <textarea> element. The value parameter is almost always bound to a string, 022 * but this is not an absolute requirement. Since the component accepts informal parameters, the rows and cols attribute may 023 * be set that way (there is not a formal parameter). 024 * <p/> 025 * Includes the <code>cols</code> attribute, if a {@link org.apache.tapestry5.beaneditor.Width} annotation is present on 026 * the property bound to the value parameter. 027 * 028 * @see org.apache.tapestry5.corelib.components.TextOutput 029 * @tapestrydoc 030 * @see TextField 031 * @see Form 032 */ 033public class TextArea extends AbstractTextField 034{ 035 private String value; 036 037 @Override 038 protected final void writeFieldTag(MarkupWriter writer, String value) 039 { 040 writer.element("textarea", 041 042 "name", getControlName(), 043 044 "id", getClientId(), 045 046 "cols", getWidth()); 047 048 // Save until needed in after() 049 050 this.value = value; 051 } 052 053 final void afterRender(MarkupWriter writer) 054 { 055 // TextArea will not have a template. 056 057 if (value != null) 058 writer.write(value); 059 060 writer.end(); // textarea 061 } 062 063}