001// *************************************************************************************************************************** 002// * Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file * 003// * distributed with this work for additional information regarding copyright ownership. The ASF licenses this file * 004// * to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance * 005// * with the License. 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 distributed under the License is distributed on an * 010// * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the * 011// * specific language governing permissions and limitations under the License. * 012// *************************************************************************************************************************** 013package org.apache.juneau.dto.html5; 014 015import java.net.*; 016import java.net.URI; 017 018import org.apache.juneau.*; 019import org.apache.juneau.annotation.*; 020 021/** 022 * DTO for an HTML <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#the-button-element"><button></a> 023 * element. 024 * 025 * <h5 class='section'>See Also:</h5> 026 * <ul class='doctree'> 027 * <li class='link'><a class='doclink' href='../../../../../overview-summary.html#juneau-dto.HTML5'>Overview > juneau-dto > HTML5</a> 028 * </ul> 029 */ 030@Bean(typeName="button") 031public class Button extends HtmlElementMixed { 032 033 /** 034 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-fe-autofocus">autofocus</a> attribute. 035 * 036 * <p> 037 * Automatically focus the form control when the page is loaded. 038 * 039 * @param autofocus 040 * The new value for this attribute. 041 * Typically a {@link Boolean} or {@link String}. 042 * @return This object (for method chaining). 043 */ 044 public final Button autofocus(Object autofocus) { 045 attr("autofocus", autofocus); 046 return this; 047 } 048 049 /** 050 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-fe-disabled">disabled</a> attribute. 051 * 052 * <p> 053 * Whether the form control is disabled. 054 * 055 * @param disabled 056 * The new value for this attribute. 057 * Typically a {@link Boolean} or {@link String}. 058 * @return This object (for method chaining). 059 */ 060 public final Button disabled(Object disabled) { 061 attr("disabled", disabled); 062 return this; 063 } 064 065 /** 066 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-fae-form">form</a> attribute. 067 * 068 * <p> 069 * Associates the control with a form element. 070 * 071 * @param form The new value for this attribute. 072 * @return This object (for method chaining). 073 */ 074 public final Button form(String form) { 075 attr("form", form); 076 return this; 077 } 078 079 /** 080 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-fs-formaction">formaction</a> attribute. 081 * 082 * <p> 083 * URL to use for form submission. 084 * 085 * <p> 086 * The value can be of any of the following types: {@link URI}, {@link URL}, {@link String}. 087 * Strings must be valid URIs. 088 * 089 * <p> 090 * URIs defined by {@link UriResolver} can be used for values. 091 * 092 * @param formaction The new value for this attribute. 093 * @return This object (for method chaining). 094 */ 095 public final Button formaction(String formaction) { 096 attrUri("formaction", formaction); 097 return this; 098 } 099 100 /** 101 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-fs-formenctype">formenctype</a> attribute. 102 * 103 * <p> 104 * Form data set encoding type to use for form submission. 105 * 106 * @param formenctype The new value for this attribute. 107 * @return This object (for method chaining). 108 */ 109 public final Button formenctype(String formenctype) { 110 attr("formenctype", formenctype); 111 return this; 112 } 113 114 /** 115 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-fs-formmethod">formmethod</a> attribute. 116 * 117 * <p> 118 * HTTP method to use for form submission. 119 * 120 * @param formmethod The new value for this attribute. 121 * @return This object (for method chaining). 122 */ 123 public final Button formmethod(String formmethod) { 124 attr("formmethod", formmethod); 125 return this; 126 } 127 128 /** 129 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-fs-formnovalidate">formnovalidate</a> 130 * attribute. 131 * 132 * <p> 133 * Bypass form control validation for form submission. 134 * 135 * @param formnovalidate The new value for this attribute. 136 * @return This object (for method chaining). 137 */ 138 public final Button formnovalidate(String formnovalidate) { 139 attr("formnovalidate", formnovalidate); 140 return this; 141 } 142 143 /** 144 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-fs-formtarget">formtarget</a> attribute. 145 * 146 * <p> 147 * Browsing context for form submission. 148 * 149 * @param formtarget The new value for this attribute. 150 * @return This object (for method chaining). 151 */ 152 public final Button formtarget(String formtarget) { 153 attr("formtarget", formtarget); 154 return this; 155 } 156 157 /** 158 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-fs-menu">menu</a> attribute. 159 * 160 * <p> 161 * Specifies the element's designated pop-up menu. 162 * 163 * @param menu The new value for this attribute. 164 * @return This object (for method chaining). 165 */ 166 public final Button menu(String menu) { 167 attr("menu", menu); 168 return this; 169 } 170 171 /** 172 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-fe-name">name</a> attribute. 173 * 174 * <p> 175 * Name of form control to use for form submission and in the form.elements API. 176 * 177 * @param name The new value for this attribute. 178 * @return This object (for method chaining). 179 */ 180 public final Button name(String name) { 181 attr("name", name); 182 return this; 183 } 184 185 /** 186 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-button-type">type</a> attribute. 187 * 188 * <p> 189 * Type of button. 190 * 191 * @param type The new value for this attribute. 192 * @return This object (for method chaining). 193 */ 194 public final Button type(String type) { 195 attr("type", type); 196 return this; 197 } 198 199 /** 200 * <a class="doclink" href="https://www.w3.org/TR/html5/forms.html#attr-button-value">value</a> attribute. 201 * 202 * <p> 203 * Value to be used for form submission. 204 * 205 * @param value 206 * The new value for this attribute. 207 * Typically a {@link Number} or {@link String}. 208 * @return This object (for method chaining). 209 */ 210 public final Button value(Object value) { 211 attr("value", value); 212 return this; 213 } 214 215 216 //-------------------------------------------------------------------------------- 217 // Overridden methods 218 //-------------------------------------------------------------------------------- 219 220 @Override /* HtmlElement */ 221 public final Button _class(String _class) { 222 super._class(_class); 223 return this; 224 } 225 226 @Override /* HtmlElement */ 227 public final Button id(String id) { 228 super.id(id); 229 return this; 230 } 231 232 @Override /* HtmlElement */ 233 public final Button style(String style) { 234 super.style(style); 235 return this; 236 } 237 238 @Override /* HtmlElementMixed */ 239 public Button children(Object...children) { 240 super.children(children); 241 return this; 242 } 243 244 @Override /* HtmlElementMixed */ 245 public Button child(Object child) { 246 super.child(child); 247 return this; 248 } 249}