001/* 002 * Licensed to the Apache Software Foundation (ASF) under one or more 003 * contributor license agreements. See the NOTICE file distributed with 004 * this work for additional information regarding copyright ownership. 005 * The ASF licenses this file to You under the Apache License, Version 2.0 006 * (the "License"); you may not use this file except in compliance with 007 * the License. You may obtain a copy of the License at 008 * 009 * http://www.apache.org/licenses/LICENSE-2.0 010 * 011 * Unless required by applicable law or agreed to in writing, software 012 * distributed under the License is distributed on an "AS IS" BASIS, 013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 014 * See the License for the specific language governing permissions and 015 * limitations under the License. 016 */ 017package org.apache.juneau.bean.html5; 018 019import org.apache.juneau.annotation.*; 020import org.apache.juneau.internal.*; 021 022/** 023 * DTO for an HTML <a class="doclink" href="https://www.w3.org/TR/html5/sections.html#the-address-element"><address></a> 024 * element. 025 * 026 * <p> 027 * The address element represents the contact information for its nearest article or body element 028 * ancestor. It is used to provide contact details such as physical addresses, email addresses, 029 * phone numbers, or other contact information. The address element should not be used for arbitrary 030 * addresses, but specifically for contact information related to the document or article. 031 * 032 * <h5 class='section'>Examples:</h5> 033 * <p class='bcode w800'> 034 * <jk>import static</jk> org.apache.juneau.bean.html5.HtmlBuilder.*; 035 * 036 * <jc>// Simple contact address</jc> 037 * Address <jv>simple</jv> = <jsm>address</jsm>(<js>"123 Main Street, Anytown, ST 12345"</js>); 038 * 039 * <jc>// Contact information with multiple elements</jc> 040 * Address <jv>contact</jv> = <jsm>address</jsm>( 041 * <js>"John Doe"</js>, 042 * <jsm>br</jsm>(), 043 * <js>"123 Main Street"</js>, 044 * <jsm>br</jsm>(), 045 * <js>"Anytown, ST 12345"</js>, 046 * <jsm>br</jsm>(), 047 * <jsm>a</jsm>(<js>"mailto:john@example.com"</js>, <js>"john@example.com"</js>) 048 * ); 049 * 050 * <jc>// Company address</jc> 051 * Address <jv>company</jv> = <jsm>address</jsm>( 052 * <js>"Acme Corporation"</js>, 053 * <jsm>br</jsm>(), 054 * <js>"456 Business Ave"</js>, 055 * <jsm>br</jsm>(), 056 * <js>"Suite 100"</js>, 057 * <jsm>br</jsm>(), 058 * <js>"Business City, BC 67890"</js>, 059 * <jsm>br</jsm>(), 060 * <js>"Phone: (555) 123-4567"</js> 061 * ); 062 * 063 * <jc>// Styled address</jc> 064 * Address <jv>styled</jv> = <jsm>address</jsm>( 065 * <js>"Contact us at:"</js>, 066 * <jsm>br</jsm>(), 067 * <jsm>a</jsm>(<js>"mailto:info@company.com"</js>, <js>"info@company.com"</js>) 068 * )._class(<js>"contact-info"</js>); 069 * 070 * <jc>// Address with multiple contact methods</jc> 071 * Address <jv>multiple</jv> = <jsm>address</jsm>( 072 * <js>"Support Team"</js>, 073 * <jsm>br</jsm>(), 074 * <js>"Email: "</js>, 075 * <jsm>a</jsm>(<js>"mailto:support@example.com"</js>, <js>"support@example.com"</js>), 076 * <jsm>br</jsm>(), 077 * <js>"Phone: "</js>, 078 * <jsm>a</jsm>(<js>"tel:+1-555-123-4567"</js>, <js>"(555) 123-4567"</js>), 079 * <jsm>br</jsm>(), 080 * <js>"Address: 789 Support St, Help City, HC 54321"</js> 081 * ); 082 * </p> 083 * 084 * <p> 085 * The following convenience methods are provided for constructing instances of this bean: 086 * <ul class='javatree'> 087 * <li class='jc'>{@link HtmlBuilder} 088 * <ul class='javatree'> 089 * <li class='jm'>{@link HtmlBuilder#address() address()} 090 * <li class='jm'>{@link HtmlBuilder#address(Object, Object...) address(Object, Object...)} 091 * </ul> 092 * </ul> 093 * </p> 094 * 095 * <h5 class='section'>See Also:</h5><ul> 096 * <li class='link'><a class="doclink" href="https://juneau.apache.org/docs/topics/JuneauBeanHtml5">juneau-bean-html5</a> 097 * </ul> 098 */ 099@Bean(typeName="address") 100public class Address extends HtmlElementMixed { 101 102 /** 103 * Creates an empty {@link Address} element. 104 */ 105 public Address() {} 106 107 /** 108 * Creates an {@link Address} element with the specified child nodes. 109 * 110 * @param children The child nodes. 111 */ 112 public Address(Object...children) { 113 children(children); 114 } 115 116 //----------------------------------------------------------------------------------------------------------------- 117 // Overridden methods 118 //----------------------------------------------------------------------------------------------------------------- 119 @Override /* Overridden from HtmlElement */ 120 public Address _class(String value) { // NOSONAR - Intentional naming. 121 super._class(value); 122 return this; 123 } 124 125 @Override /* Overridden from HtmlElement */ 126 public Address accesskey(String value) { 127 super.accesskey(value); 128 return this; 129 } 130 131 @Override /* Overridden from HtmlElement */ 132 public Address contenteditable(Object value) { 133 super.contenteditable(value); 134 return this; 135 } 136 137 @Override /* Overridden from HtmlElement */ 138 public Address dir(String value) { 139 super.dir(value); 140 return this; 141 } 142 143 @Override /* Overridden from HtmlElement */ 144 public Address hidden(Object value) { 145 super.hidden(value); 146 return this; 147 } 148 149 @Override /* Overridden from HtmlElement */ 150 public Address id(String value) { 151 super.id(value); 152 return this; 153 } 154 155 @Override /* Overridden from HtmlElement */ 156 public Address lang(String value) { 157 super.lang(value); 158 return this; 159 } 160 161 @Override /* Overridden from HtmlElement */ 162 public Address onabort(String value) { 163 super.onabort(value); 164 return this; 165 } 166 167 @Override /* Overridden from HtmlElement */ 168 public Address onblur(String value) { 169 super.onblur(value); 170 return this; 171 } 172 173 @Override /* Overridden from HtmlElement */ 174 public Address oncancel(String value) { 175 super.oncancel(value); 176 return this; 177 } 178 179 @Override /* Overridden from HtmlElement */ 180 public Address oncanplay(String value) { 181 super.oncanplay(value); 182 return this; 183 } 184 185 @Override /* Overridden from HtmlElement */ 186 public Address oncanplaythrough(String value) { 187 super.oncanplaythrough(value); 188 return this; 189 } 190 191 @Override /* Overridden from HtmlElement */ 192 public Address onchange(String value) { 193 super.onchange(value); 194 return this; 195 } 196 197 @Override /* Overridden from HtmlElement */ 198 public Address onclick(String value) { 199 super.onclick(value); 200 return this; 201 } 202 203 @Override /* Overridden from HtmlElement */ 204 public Address oncuechange(String value) { 205 super.oncuechange(value); 206 return this; 207 } 208 209 @Override /* Overridden from HtmlElement */ 210 public Address ondblclick(String value) { 211 super.ondblclick(value); 212 return this; 213 } 214 215 @Override /* Overridden from HtmlElement */ 216 public Address ondurationchange(String value) { 217 super.ondurationchange(value); 218 return this; 219 } 220 221 @Override /* Overridden from HtmlElement */ 222 public Address onemptied(String value) { 223 super.onemptied(value); 224 return this; 225 } 226 227 @Override /* Overridden from HtmlElement */ 228 public Address onended(String value) { 229 super.onended(value); 230 return this; 231 } 232 233 @Override /* Overridden from HtmlElement */ 234 public Address onerror(String value) { 235 super.onerror(value); 236 return this; 237 } 238 239 @Override /* Overridden from HtmlElement */ 240 public Address onfocus(String value) { 241 super.onfocus(value); 242 return this; 243 } 244 245 @Override /* Overridden from HtmlElement */ 246 public Address oninput(String value) { 247 super.oninput(value); 248 return this; 249 } 250 251 @Override /* Overridden from HtmlElement */ 252 public Address oninvalid(String value) { 253 super.oninvalid(value); 254 return this; 255 } 256 257 @Override /* Overridden from HtmlElement */ 258 public Address onkeydown(String value) { 259 super.onkeydown(value); 260 return this; 261 } 262 263 @Override /* Overridden from HtmlElement */ 264 public Address onkeypress(String value) { 265 super.onkeypress(value); 266 return this; 267 } 268 269 @Override /* Overridden from HtmlElement */ 270 public Address onkeyup(String value) { 271 super.onkeyup(value); 272 return this; 273 } 274 275 @Override /* Overridden from HtmlElement */ 276 public Address onload(String value) { 277 super.onload(value); 278 return this; 279 } 280 281 @Override /* Overridden from HtmlElement */ 282 public Address onloadeddata(String value) { 283 super.onloadeddata(value); 284 return this; 285 } 286 287 @Override /* Overridden from HtmlElement */ 288 public Address onloadedmetadata(String value) { 289 super.onloadedmetadata(value); 290 return this; 291 } 292 293 @Override /* Overridden from HtmlElement */ 294 public Address onloadstart(String value) { 295 super.onloadstart(value); 296 return this; 297 } 298 299 @Override /* Overridden from HtmlElement */ 300 public Address onmousedown(String value) { 301 super.onmousedown(value); 302 return this; 303 } 304 305 @Override /* Overridden from HtmlElement */ 306 public Address onmouseenter(String value) { 307 super.onmouseenter(value); 308 return this; 309 } 310 311 @Override /* Overridden from HtmlElement */ 312 public Address onmouseleave(String value) { 313 super.onmouseleave(value); 314 return this; 315 } 316 317 @Override /* Overridden from HtmlElement */ 318 public Address onmousemove(String value) { 319 super.onmousemove(value); 320 return this; 321 } 322 323 @Override /* Overridden from HtmlElement */ 324 public Address onmouseout(String value) { 325 super.onmouseout(value); 326 return this; 327 } 328 329 @Override /* Overridden from HtmlElement */ 330 public Address onmouseover(String value) { 331 super.onmouseover(value); 332 return this; 333 } 334 335 @Override /* Overridden from HtmlElement */ 336 public Address onmouseup(String value) { 337 super.onmouseup(value); 338 return this; 339 } 340 341 @Override /* Overridden from HtmlElement */ 342 public Address onmousewheel(String value) { 343 super.onmousewheel(value); 344 return this; 345 } 346 347 @Override /* Overridden from HtmlElement */ 348 public Address onpause(String value) { 349 super.onpause(value); 350 return this; 351 } 352 353 @Override /* Overridden from HtmlElement */ 354 public Address onplay(String value) { 355 super.onplay(value); 356 return this; 357 } 358 359 @Override /* Overridden from HtmlElement */ 360 public Address onplaying(String value) { 361 super.onplaying(value); 362 return this; 363 } 364 365 @Override /* Overridden from HtmlElement */ 366 public Address onprogress(String value) { 367 super.onprogress(value); 368 return this; 369 } 370 371 @Override /* Overridden from HtmlElement */ 372 public Address onratechange(String value) { 373 super.onratechange(value); 374 return this; 375 } 376 377 @Override /* Overridden from HtmlElement */ 378 public Address onreset(String value) { 379 super.onreset(value); 380 return this; 381 } 382 383 @Override /* Overridden from HtmlElement */ 384 public Address onresize(String value) { 385 super.onresize(value); 386 return this; 387 } 388 389 @Override /* Overridden from HtmlElement */ 390 public Address onscroll(String value) { 391 super.onscroll(value); 392 return this; 393 } 394 395 @Override /* Overridden from HtmlElement */ 396 public Address onseeked(String value) { 397 super.onseeked(value); 398 return this; 399 } 400 401 @Override /* Overridden from HtmlElement */ 402 public Address onseeking(String value) { 403 super.onseeking(value); 404 return this; 405 } 406 407 @Override /* Overridden from HtmlElement */ 408 public Address onselect(String value) { 409 super.onselect(value); 410 return this; 411 } 412 413 @Override /* Overridden from HtmlElement */ 414 public Address onshow(String value) { 415 super.onshow(value); 416 return this; 417 } 418 419 @Override /* Overridden from HtmlElement */ 420 public Address onstalled(String value) { 421 super.onstalled(value); 422 return this; 423 } 424 425 @Override /* Overridden from HtmlElement */ 426 public Address onsubmit(String value) { 427 super.onsubmit(value); 428 return this; 429 } 430 431 @Override /* Overridden from HtmlElement */ 432 public Address onsuspend(String value) { 433 super.onsuspend(value); 434 return this; 435 } 436 437 @Override /* Overridden from HtmlElement */ 438 public Address ontimeupdate(String value) { 439 super.ontimeupdate(value); 440 return this; 441 } 442 443 @Override /* Overridden from HtmlElement */ 444 public Address ontoggle(String value) { 445 super.ontoggle(value); 446 return this; 447 } 448 449 @Override /* Overridden from HtmlElement */ 450 public Address onvolumechange(String value) { 451 super.onvolumechange(value); 452 return this; 453 } 454 455 @Override /* Overridden from HtmlElement */ 456 public Address onwaiting(String value) { 457 super.onwaiting(value); 458 return this; 459 } 460 461 @Override /* Overridden from HtmlElement */ 462 public Address spellcheck(Object value) { 463 super.spellcheck(value); 464 return this; 465 } 466 467 @Override /* Overridden from HtmlElement */ 468 public Address style(String value) { 469 super.style(value); 470 return this; 471 } 472 473 @Override /* Overridden from HtmlElement */ 474 public Address tabindex(Object value) { 475 super.tabindex(value); 476 return this; 477 } 478 479 @Override /* Overridden from HtmlElement */ 480 public Address title(String value) { 481 super.title(value); 482 return this; 483 } 484 485 @Override /* Overridden from HtmlElement */ 486 public Address translate(Object value) { 487 super.translate(value); 488 return this; 489 } 490 491 @Override /* Overridden from HtmlElementMixed */ 492 public Address child(Object value) { 493 super.child(value); 494 return this; 495 } 496 497 @Override /* Overridden from HtmlElementMixed */ 498 public Address children(Object...value) { 499 super.children(value); 500 return this; 501 } 502}