web/WEB-INF/widgets.jsf.taglib.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!--
   3 Copyright (C) 2017 - 2020 Free Software Foundation
   4
   5 This program is free software: you can redistribute it and/or modify
   6 it under the terms of the GNU Affero General Public License as
   7 published by the Free Software Foundation, either version 3 of the
   8 License, or (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU Affero General Public License for more details.
  14
  15 You should have received a copy of the GNU Affero General Public License
  16 along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17 -->
  18 <facelet-taglib
  19         version="2.2"
  20         xmlns="http://xmlns.jcp.org/xml/ns/javaee"
  21         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  22         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facelettaglibrary_2_2.xsd"
  23 >
  24         <namespace>http://mxchange.org/jsf/core/widgets</namespace>
  25         <tag>
  26                 <tag-name>outputMessageBox</tag-name>
  27                 <description>This tag renders a style-able and customizable message for any kind of messages that the user should see.</description>
  28                 <source>resources/tags/messages/message_box.tpl</source>
  29                 <attribute>
  30                         <name>message</name>
  31                         <description>The message that should be place into the message box. You may also use EL code here that resolves to a message string.</description>
  32                         <required>true</required>
  33                         <type>java.lang.String</type>
  34                 </attribute>
  35                 <attribute>
  36                         <name>panelGroupId</name>
  37                         <description>Id of the panel group component.</description>
  38                         <required>true</required>
  39                         <type>java.lang.String</type>
  40                 </attribute>
  41                 <attribute>
  42                         <name>rendered</name>
  43                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
  44                         <required>false</required>
  45                         <type>java.lang.Boolean</type>
  46                 </attribute>
  47                 <attribute>
  48                         <name>boxStyleClass</name>
  49                         <description>The optional CSS style class to be forwarded to the container div of the whole message box. Default is ".message_box" .</description>
  50                         <required>false</required>
  51                         <type>java.lang.String</type>
  52                 </attribute>
  53                 <attribute>
  54                         <name>messageStyleClass</name>
  55                         <description>The optional CSS style class to be forwarded on the h:outputText's styleClass attribute of the message. The default is "okay" which normally renders as a green colored message.</description>
  56                         <required>false</required>
  57                         <type>java.lang.String</type>
  58                 </attribute>
  59         </tag>
  60         <tag>
  61                 <tag-name>outputContactDataGridColumns</tag-name>
  62                 <description>This tag renders columns for displaying contact data for administrative views.</description>
  63                 <source>resources/tags/admin/columns/admin_contact_data_columns.tpl</source>
  64         </tag>
  65         <tag>
  66                 <tag-name>outputPersonalTitleSelectionBox</tag-name>
  67                 <description>This tag renders a selection box for user contact's personal title (Mr./Mrs.).</description>
  68                 <source>resources/tags/input/selection_box/personal_title_selection_box.tpl</source>
  69                 <attribute>
  70                         <name>allowEmptyRequiredData</name>
  71                         <description>Whether allow the personal title to be left empty. This might be the case when you create a user and want to select a contact from a selection box. EL code resolving to a boolean may be allowed here.</description>
  72                         <required>false</required>
  73                         <type>java.lang.Boolean</type>
  74                 </attribute>
  75                 <attribute>
  76                         <name>rendered</name>
  77                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
  78                         <required>false</required>
  79                         <type>java.lang.Boolean</type>
  80                 </attribute>
  81                 <attribute>
  82                         <name>targetController</name>
  83                         <description>A target backing bean (EL code resolving into it) extending at least BaseFacesBean where to set the data in.</description>
  84                         <required>true</required>
  85                         <!-- @TODO Find an interface for BaseFacesBean and set it here instead -->
  86                         <type>org.mxchange.jcoreee.bean.faces.BaseFacesBean</type>
  87                 </attribute>
  88         </tag>
  89         <tag>
  90                 <tag-name>outputAdminContactDataFormFields</tag-name>
  91                 <description>This tag renders a fieldset for administrative purposes of contact data.</description>
  92                 <source>resources/tags/admin/form_data/contact/admin_form_contact_data.tpl</source>
  93                 <attribute>
  94                         <name>allowEmptyRequiredData</name>
  95                         <description>Whether allow the personal title to be left empty. This might be the case when you create a user and want to select a contact from a selection box. EL code resolving to a boolean may be allowed here.</description>
  96                         <required>false</required>
  97                         <type>java.lang.Boolean</type>
  98                 </attribute>
  99                 <attribute>
 100                         <name>rendered</name>
 101                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 102                         <required>false</required>
 103                         <type>java.lang.Boolean</type>
 104                 </attribute>
 105         </tag>
 106         <tag>
 107                 <tag-name>outputAdminFaxDataFormFields</tag-name>
 108                 <description>This tag renders a fieldset for administrative purposes of fax data.</description>
 109                 <source>resources/tags/admin/form_data/fax/admin_form_fax_data.tpl</source>
 110                 <attribute>
 111                         <name>faxNumber</name>
 112                         <description>The fax instance that provides the data for this tag.</description>
 113                         <required>true</required>
 114                         <type>org.mxchange.jphone.model.phonenumbers.fax.DialableFaxNumber</type>
 115                 </attribute>
 116                 <attribute>
 117                         <name>rendered</name>
 118                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 119                         <required>false</required>
 120                         <type>java.lang.Boolean</type>
 121                 </attribute>
 122         </tag>
 123         <tag>
 124                 <tag-name>outputAdminLandLineDataFormFields</tag-name>
 125                 <description>This tag renders a fieldset for administrative purposes of land-line data.</description>
 126                 <source>resources/tags/admin/form_data/landline/admin_form_landline_data.tpl</source>
 127                 <attribute>
 128                         <name>landLineNumber</name>
 129                         <description>The fax instance that provides the data for this tag.</description>
 130                         <required>true</required>
 131                         <type>org.mxchange.jphone.model.phonenumbers.landline.DialableLandLineNumber</type>
 132                 </attribute>
 133                 <attribute>
 134                         <name>rendered</name>
 135                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 136                         <required>false</required>
 137                         <type>java.lang.Boolean</type>
 138                 </attribute>
 139         </tag>
 140         <tag>
 141                 <tag-name>outputAdminMobileDataFormFields</tag-name>
 142                 <description>This tag renders a fieldset for administrative purposes of mobile data.</description>
 143                 <source>resources/tags/admin/form_data/mobile/admin_form_mobile_data.tpl</source>
 144                 <attribute>
 145                         <name>mobileNumber</name>
 146                         <description>The mobile instance that provides the data for this tag.</description>
 147                         <required>true</required>
 148                         <type>org.mxchange.jphone.model.phonenumbers.mobile.DialableMobileNumber</type>
 149                 </attribute>
 150                 <attribute>
 151                         <name>rendered</name>
 152                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 153                         <required>false</required>
 154                         <type>java.lang.Boolean</type>
 155                 </attribute>
 156         </tag>
 157         <tag>
 158                 <tag-name>outputAdminUserDataFormFields</tag-name>
 159                 <description>This tag renders a fieldset for administrative purposes of user data.</description>
 160                 <source>resources/tags/admin/form_data/user/admin_form_user_data.tpl</source>
 161                 <attribute>
 162                         <name>mode</name>
 163                         <description>Mode of the form, must be one of "add" or "edit".</description>
 164                         <required>true</required>
 165                         <type>java.lang.String</type>
 166                 </attribute>
 167         </tag>
 168         <tag>
 169                 <tag-name>outputAdminFaxPanelGrid</tag-name>
 170                 <description>This tag renders a full p:panelGrid for administrative purposes for fax data.</description>
 171                 <source>resources/tags/admin/panel_grids/fax/admin_fax_data.tpl</source>
 172                 <attribute>
 173                         <name>faxNumber</name>
 174                         <description>The fax instance that provides the data for this tag.</description>
 175                         <required>true</required>
 176                         <type>org.mxchange.jphone.model.phonenumbers.fax.DialableFaxNumber</type>
 177                 </attribute>
 178                 <attribute>
 179                         <name>contact</name>
 180                         <description>The contact instance that provides contact data for additional JSF links.</description>
 181                         <required>false</required>
 182                         <type>org.mxchange.jcontacts.model.contact.Contact</type>
 183                 </attribute>
 184                 <attribute>
 185                         <name>rendered</name>
 186                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 187                         <required>false</required>
 188                         <type>java.lang.Boolean</type>
 189                 </attribute>
 190                 <attribute>
 191                         <name>renderShowLink</name>
 192                         <description>Whether this tag is used to show fax data (default true).</description>
 193                         <required>false</required>
 194                         <type>java.lang.Boolean</type>
 195                 </attribute>
 196                 <attribute>
 197                         <name>showAdminDropdownMenu</name>
 198                         <description>Whether to show administrative links to other pages (default: true).</description>
 199                         <required>false</required>
 200                         <type>java.lang.Boolean</type>
 201                 </attribute>
 202         </tag>
 203         <tag>
 204                 <tag-name>outputAdminLandLinePanelGrid</tag-name>
 205                 <description>This tag renders a full p:panelGrid for administrative purposes for land-line data.</description>
 206                 <source>resources/tags/admin/panel_grids/landline/admin_landline_data.tpl</source>
 207                 <attribute>
 208                         <name>renderShowLink</name>
 209                         <description>Whether this tag is used to show land-line data (default true).</description>
 210                         <required>false</required>
 211                         <type>java.lang.Boolean</type>
 212                 </attribute>
 213                 <attribute>
 214                         <name>landLineNumber</name>
 215                         <description>The fax instance that provides the data for this tag.</description>
 216                         <required>true</required>
 217                         <type>org.mxchange.jphone.model.phonenumbers.landline.DialableLandLineNumber</type>
 218                 </attribute>
 219                 <attribute>
 220                         <name>contact</name>
 221                         <description>The contact instance that provides contact data for additional JSF links.</description>
 222                         <required>false</required>
 223                         <type>org.mxchange.jcontacts.model.contact.Contact</type>
 224                 </attribute>
 225                 <attribute>
 226                         <name>rendered</name>
 227                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 228                         <required>false</required>
 229                         <type>java.lang.Boolean</type>
 230                 </attribute>
 231                 <attribute>
 232                         <name>showAdminDropdownMenu</name>
 233                         <description>Whether to show administrative links to other pages (default: true).</description>
 234                         <required>false</required>
 235                         <type>java.lang.Boolean</type>
 236                 </attribute>
 237         </tag>
 238         <tag>
 239                 <tag-name>outputAdminMobilePanelGrid</tag-name>
 240                 <description>This tag renders a full p:panelGrid for administrative purposes for mobile data.</description>
 241                 <source>resources/tags/admin/panel_grids/mobile/admin_mobile_data.tpl</source>
 242                 <attribute>
 243                         <name>renderShowLink</name>
 244                         <description>Whether this tag is used to show mobile data (default true).</description>
 245                         <required>false</required>
 246                         <type>java.lang.Boolean</type>
 247                 </attribute>
 248                 <attribute>
 249                         <name>mobileNumber</name>
 250                         <description>The mobile instance that provides the data for this tag.</description>
 251                         <required>true</required>
 252                         <type>org.mxchange.jphone.model.phonenumbers.mobile.DialableMobileNumber</type>
 253                 </attribute>
 254                 <attribute>
 255                         <name>contact</name>
 256                         <description>The contact instance that provides contact data for additional JSF links.</description>
 257                         <required>false</required>
 258                         <type>org.mxchange.jcontacts.model.contact.Contact</type>
 259                 </attribute>
 260                 <attribute>
 261                         <name>rendered</name>
 262                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 263                         <required>false</required>
 264                         <type>java.lang.Boolean</type>
 265                 </attribute>
 266                 <attribute>
 267                         <name>showAdminDropdownMenu</name>
 268                         <description>Whether to show administrative links to other pages (default: true).</description>
 269                         <required>false</required>
 270                         <type>java.lang.Boolean</type>
 271                 </attribute>
 272         </tag>
 273         <tag>
 274                 <tag-name>outputFaxInputTableRow</tag-name>
 275                 <description>This tag renders a h:panelGroup with input fields for fax numbers.</description>
 276                 <source>resources/tags/table_rows/fax_input_table_row.tpl</source>
 277                 <attribute>
 278                         <name>targetController</name>
 279                         <description>A target backing bean (EL code resolving into it) extending at least BaseFacesBean where to set the data in.</description>
 280                         <required>true</required>
 281                         <!-- @TODO Find an interface for BaseFacesBean and set it here instead -->
 282                         <type>org.mxchange.jcoreee.bean.faces.BaseFacesBean</type>
 283                 </attribute>
 284                 <attribute>
 285                         <name>labelMessage</name>
 286                         <description>A localized message for the rendered label tag. You should use EL code here to add a label message from your bundle.</description>
 287                         <required>true</required>
 288                         <type>java.lang.String</type>
 289                 </attribute>
 290                 <attribute>
 291                         <name>rendered</name>
 292                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 293                         <required>false</required>
 294                         <type>java.lang.Boolean</type>
 295                 </attribute>
 296         </tag>
 297         <tag>
 298                 <tag-name>outputLandLineInputTableRow</tag-name>
 299                 <description>This tag renders a h:panelGroup with input fields for land-line numbers.</description>
 300                 <source>resources/tags/table_rows/landline_input_table_row.tpl</source>
 301                 <attribute>
 302                         <name>targetController</name>
 303                         <description>A target backing bean (EL code resolving into it) extending at least BaseFacesBean where to set the data in.</description>
 304                         <required>true</required>
 305                         <!-- @TODO Find an interface for BaseFacesBean and set it here instead -->
 306                         <type>org.mxchange.jcoreee.bean.faces.BaseFacesBean</type>
 307                 </attribute>
 308                 <attribute>
 309                         <name>labelMessage</name>
 310                         <description>A localized message for the rendered label tag. You should use EL code here to add a label message from your bundle.</description>
 311                         <required>true</required>
 312                         <type>java.lang.String</type>
 313                 </attribute>
 314                 <attribute>
 315                         <name>rendered</name>
 316                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 317                         <required>false</required>
 318                         <type>java.lang.Boolean</type>
 319                 </attribute>
 320         </tag>
 321         <tag>
 322                 <tag-name>outputCountrySelector</tag-name>
 323                 <description>This tag renders a selection box for all available countries.</description>
 324                 <source>resources/tags/country/form_data/form_country_selector.tpl</source>
 325                 <attribute>
 326                         <name>rendered</name>
 327                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 328                         <required>false</required>
 329                         <type>java.lang.Boolean</type>
 330                 </attribute>
 331                 <attribute>
 332                         <name>allowNone</name>
 333                         <description>Whether this tag allows NONE/null to be selected (default: true).</description>
 334                         <required>false</required>
 335                         <type>java.lang.Boolean</type>
 336                 </attribute>
 337                 <attribute>
 338                         <name>required</name>
 339                         <description>Whether this tag is required (default: false)</description>
 340                         <required>false</required>
 341                         <type>java.lang.Boolean</type>
 342                 </attribute>
 343                 <attribute>
 344                         <name>requiredMessage</name>
 345                         <description>Localizable message to be displayed when this field is required but not selected.</description>
 346                         <required>false</required>
 347                         <type>java.lang.String</type>
 348                 </attribute>
 349                 <attribute>
 350                         <name>id</name>
 351                         <description>Id of the JSF component.</description>
 352                         <required>true</required>
 353                         <type>java.lang.String</type>
 354                 </attribute>
 355                 <attribute>
 356                         <name>styleClass</name>
 357                         <description>CSS style class for this component, default: select.</description>
 358                         <required>false</required>
 359                         <type>java.lang.String</type>
 360                 </attribute>
 361                 <attribute>
 362                         <name>value</name>
 363                         <description>A target property to set the selected country in.</description>
 364                         <required>true</required>
 365                         <type>org.mxchange.jcountry.model.data.Country</type>
 366                 </attribute>
 367         </tag>
 368         <tag>
 369                 <tag-name>inputFaxNumberPanelGrid</tag-name>
 370                 <description>This tag renders input fields for creating a fax number.</description>
 371                 <source>resources/tags/input/panel_grid/fax_input_panel_grid.tpl</source>
 372                 <attribute>
 373                         <name>rendered</name>
 374                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 375                         <required>false</required>
 376                         <type>java.lang.Boolean</type>
 377                 </attribute>
 378                 <attribute>
 379                         <name>targetController</name>
 380                         <description>A target backing bean (EL code resolving into it) extending at least BaseFacesBean where to set the data in.</description>
 381                         <required>true</required>
 382                         <!-- @TODO Find an interface for BaseFacesBean and set it here instead -->
 383                         <type>org.mxchange.jcoreee.bean.faces.BaseFacesBean</type>
 384                 </attribute>
 385         </tag>
 386         <tag>
 387                 <tag-name>inputLandLineNumberPanelGrid</tag-name>
 388                 <description>This tag renders input fields for creating a land-line number.</description>
 389                 <source>resources/tags/input/panel_grid/landline_input_panel_grid.tpl</source>
 390                 <attribute>
 391                         <name>rendered</name>
 392                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 393                         <required>false</required>
 394                         <type>java.lang.Boolean</type>
 395                 </attribute>
 396                 <attribute>
 397                         <name>targetController</name>
 398                         <description>A target backing bean (EL code resolving into it) extending at least BaseFacesBean where to set the data in.</description>
 399                         <required>true</required>
 400                         <!-- @TODO Find an interface for BaseFacesBean and set it here instead -->
 401                         <type>org.mxchange.jcoreee.bean.faces.BaseFacesBean</type>
 402                 </attribute>
 403         </tag>
 404         <tag>
 405                 <tag-name>inputMobileNumberPanelGrid</tag-name>
 406                 <description>This tag renders input fields for creating a mobile number.</description>
 407                 <source>resources/tags/input/panel_grid/mobile_input_panel_grid.tpl</source>
 408                 <attribute>
 409                         <name>rendered</name>
 410                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 411                         <required>false</required>
 412                         <type>java.lang.Boolean</type>
 413                 </attribute>
 414                 <attribute>
 415                         <name>targetController</name>
 416                         <description>A target backing bean (EL code resolving into it) extending at least BaseFacesBean where to set the data in.</description>
 417                         <required>true</required>
 418                         <!-- @TODO Find an interface for BaseFacesBean and set it here instead -->
 419                         <type>org.mxchange.jcoreee.bean.faces.BaseFacesBean</type>
 420                 </attribute>
 421         </tag>
 422         <tag>
 423                 <tag-name>outputOpeningTimesDataTable</tag-name>
 424                 <description>This tag renders a full p:dataTable for opening times.</description>
 425                 <source>resources/tags/opening_times/opening_times_data_table.tpl</source>
 426                 <attribute>
 427                         <name>id</name>
 428                         <description>An id string for this tag.</description>
 429                         <required>true</required>
 430                         <type>java.lang.String</type>
 431                 </attribute>
 432                 <attribute>
 433                         <name>value</name>
 434                         <description>A list of OpeningTime objects.</description>
 435                         <required>true</required>
 436                         <type>java.util.List</type>
 437                 </attribute>
 438                 <attribute>
 439                         <name>widgetVar</name>
 440                         <description>Identifier for this widget (e.g. JavaScript).</description>
 441                         <required>true</required>
 442                         <type>java.lang.String</type>
 443                 </attribute>
 444                 <attribute>
 445                         <name>summary</name>
 446                         <description>A string or EL code for table attribute of same name.</description>
 447                         <required>true</required>
 448                         <type>java.lang.String</type>
 449                 </attribute>
 450                 <attribute>
 451                         <name>emptyMessage</name>
 452                         <description>A string or EL code for a message shown when no row was found.</description>
 453                         <required>true</required>
 454                         <type>java.lang.String</type>
 455                 </attribute>
 456                 <attribute>
 457                         <name>headerMessage</name>
 458                         <description>A string or EL code for a message shown above table rows.</description>
 459                         <required>true</required>
 460                         <type>java.lang.String</type>
 461                 </attribute>
 462                 <attribute>
 463                         <name>rows</name>
 464                         <description>Rows to show each page.</description>
 465                         <required>true</required>
 466                         <type>java.lang.Long</type>
 467                 </attribute>
 468                 <attribute>
 469                         <name>rendered</name>
 470                         <description>Whether this tag is being rendered by JSF engine (default: true).</description>
 471                         <required>false</required>
 472                         <type>java.lang.Boolean</type>
 473                 </attribute>
 474         </tag>
 475 </facelet-taglib>