15 users Sign-in to change your status

provides you with widgets and validators to use the new HTML5 input types for forms and filters Widget Forms Applications Backend

• Repository
• Report a bug
• Download package
• Browse source

sfHtml5Form plugin

The sfHtml5FormPlugin provides you with widgets and validators to use the new HTML5 input types for forms and filters.

It also has a demonstration module for you to evaluate quickly how your browser supports the new fields.

Developers

Name	Status	Email
Christian Zenker	lead	ed.aidem995 <<ta>> reknez.naitsirhc

License

Copyright (c) Christian Zenker

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Releases for sf 1.4

Releases for sf 1.3

Join this plugin team

Other releases

Release 0.4.9 - 05/03/2010

sfHtml5Form plugin

The sfHtml5FormPlugin provides you with widgets and validators to use the new HTML5 input types for forms and filters.

It also has a demonstration module for you to evaluate quickly how your browser supports the new fields.

Where to use / Where not to use

HTML5 is cutting-edge technology, so only modern browsers support it. But browsers not knowing the new input-types will fall back to rendering an input-text - though you should be aware that they miss the comfort of the new input-types, such as a calendar. So, your forms will be accessible anyways. And if you utilize sfValidatorOr you will be able to allow machine- (e.g 2007-02-19T12:34:56Z) and human-submitted (e.g. 19.2.2007 12:34:56) values likewise.

Scenarios, I see these widgets in good use:

• use in backend

• use in an intranet if you have controll on the browsers the users use

• private pages

Scenarios, I see these widgets in not so good use:

• commercial pages (at least for now)

Installation

• Install the plugin (via a package)

  symfony plugin:install sfHtml5FormPlugin
  

• Activate the plugin in the config/ProjectConfiguration.class.php

  class ProjectConfiguration extends sfProjectConfiguration
  {
    public function setup()
    {
      // ...
      $this->enablePlugins(array("sfHtml5FormPlugin"));
      // ...
    }
  }

• Optional: Enable the demo module in the backend/config/settings.yml

  # we'll just enable the module for the dev environment
  dev:
    .settings:
      # ...
      enabled_modules: [sfHtml5FormDemo]
      # ...

  And create a route to the module in the backend/config/routing.yml

  html5form_demo:
    url: /demo
    param: { module: sfHtml5FormDemo, action: index }

  The module is available at [BASEURL]/backend_dev.php/demo now.

Documentation

All classes are documented inline.

Classes

The plugin adds the following Validators:

• sfValidator5Color
• sfValidator5Date
• sfValidator5DateTimeLocal
• sfValidator5DateTime
• sfValidator5Email
• sfValidator5Month
• sfValidator5Time

The plugin adds the following Widgets:

• sfWidgetFormInputColor
• sfWidgetFormInputDate
• sfWidgetFormInputDateTimeLocal
• sfWidgetFormInputDateTime
• sfWidgetFormInputEmail
• sfWidgetFormInputMonth
• sfWidgetFormInputNumber
• sfWidgetFormInputRange
• sfWidgetFormInputSearch
• sfWidgetFormInputTel
• sfWidgetFormInputTime
• sfWidgetFormInputUrl
• sfWidgetFormInputWeek
• sfWidgetFormKeygen

using sfWidgetFormInputDateTime for Filters

class YourFormFilter extends BaseYourFormFilter
{
  public function configure()
  {
    $this->widgetSchema['created_at']->setOption(
      'from_date', new sfWidgetFormInputDateTime()
    );
    $this->widgetSchema['created_at']->setOption(
      'to_date', new sfWidgetFormInputDateTime()
    );
  }
}

Known issues

• Missing a validator for sfWidgetFormInputWeek

• Missing a validator for sfWidgetFormKeygen

Contribution & Bugs

If you'd like to contribute or found any bugs, you are welcome to report them.