README

作者： TheCelavi 版本：1.0 稳定性：稳定
日期：2013年6月24日由 Run Open Code 提供
许可：免费

dmDateTimePicker for Diem Extended 是 Diem Extended（可能也适用于基础 Diem）的日期选择器、时间选择器和日期时间选择器控件。

它是 sfWidgetFormDate、sfWidgetFormTime 和 sfWidgetFormDateTime 小部件与 jQuery 日期选择器控件集成的结果，借助时间选择器插件（见 https://github.com/trentrichardson/jQuery-Timepicker-Addon）。提供了三个新小部件：

sfWidgetFormDmDatePicker
sfWidgetFormDmTimePicker
sfWidgetFormDmDateTimePicker

它可以在任何地方使用 - 前端、管理界面以及管理前端。

如果您在管理界面中使用它，在您的 schema.yml 中，为您的列添加 extra: datepicker 或 extra: timepicker 或 extra: datetimepicker - 需要什么就添加什么。

选项

所有选项均通过 sfWidgetFormDate、sfWidgetFormTime 和 sfWidgetFormDateTime 继承，同时添加了 ui 选项。

日期选择器

ui_date_format：日期格式，请参阅：https://jqueryui-api.jqueryjs.cn/datepicker/#utility-formatDate，默认为当前文化的日期格式。
ui_number_of_months：显示的月份数量，默认为 1。
ui_show_button_panel：是否显示“今天”和“完成”按钮，默认为 true。
ui_change_month：是否显示月份下拉框，默认为 true。
ui_change_year：是否显示年份下拉框，默认为 true。
ui_constrain_input：仅允许输入日期格式中定义的字符，默认为 true。

时间选择器

ui_time_format：时间格式，请参阅：http://trentrichardson.com/examples/timepicker/#tp-formatting
ui_control_type：如何显示时间控件，使用 'slider' 或 'select'，默认为 slider。
ui_show_button_panel：是否显示“现在”和“完成”按钮 - 这非常实用，默认为 true。
ui_step_hour：滑动控制中小时的步长，默认为 1。
ui_step_minute：滑动控制中分钟的步长，默认为 1。
ui_step_second：滑动控制中秒的步长，默认为 1。
ui_hour_grid：小时的滑动器网格，默认为 0 - 无网格。如果使用网格，则会在滑动器下方显示标签。输入用于计算的整数标签值。
ui_minute_grid：分钟的滑动器网格，默认为 0 - 无网格。如果使用网格，则会在滑动器下方显示标签。输入用于计算的整数标签值。
ui_second_grid：秒的滑动器网格，默认为 0 - 无网格。如果使用网格，则会在滑动器下方显示标签。输入用于计算的整数标签值。

日期时间选择器

如上所述，日期时间选择器是前两个功能的组合。

所有三个功能的选项

theme：从配置中的主题中选择哪些CSS样式，或者使用配置中设置的默认主题。您可以将其设置为null以不加载任何CSS。如果您添加任何内容，它还将加载任何默认配置。
ui_button_open：打开选择器按钮的HTML代码，如果您想有这个按钮
ui_button_clear：清除值按钮的HTML代码，如果您想有这个按钮

主题支持

在整个网站上保持相同的选择器是很重要的。因此，它们在config.yml中定义。

default:
  dmDateTimePickerPlugin:
    default_theme: admin
    themes:
      admin:
        defaults:
          ui_button_open: ~
          ui_button_clear: ~
          ui_show_button_panel: ~
####  IMPORTANT NOTES ####
# All other settings for #
# datetime picker are    #
# taken from respective  #
# date and time picker   #
# theme settings         #
##########################


  dmDatePickerPlugin:
    default_theme: admin
    themes:
      admin:
        wrapper_class: dm
        css_files:
          - lib.ui
          - lib.ui-datepicker
          - dmDateTimePickerPlugin.basic
        defaults:
          ui_date_format:
            default: ~
            en: ~
          ui_number_of_months: ~
          ui_show_button_panel: ~
          ui_change_month: ~
          ui_change_year: ~
          ui_constrain_input: ~
          ui_button_open: ~
          ui_button_clear: ~

  dmTimePickerPlugin:
    default_theme: admin
    themes:
      admin:
        wrapper_class: dm
        css_files:
          - lib.ui
          - lib.ui-datepicker
          - lib.ui-slider
          - dmDateTimePickerPlugin.basic
          - dmDateTimePickerPlugin.tp-add-on
        defaults:
          ui_time_format:
            default: ~
            en: ~
          ui_control_type: ~
          ui_show_button_panel: ~
          ui_step_hour: ~
          ui_step_minute: ~
          ui_step_second: ~
          ui_hour_grid: ~
          ui_minute_grid: ~
          ui_second_grid: ~
          ui_button_open: ~
          ui_button_clear: ~

这是默认配置，您可以拥有尽可能多的它们。有了定义的包装类，您可以根据需要在同一页面上拥有尽可能多的选择器样式。

对于每个主题，您可以设置要加载哪些CSS文件，如何包装控件以及如何使用该CSS文件定位目标 - 或者您可以将其设置为null ~ 并手动在页面上加载CSS。

对于每个主题，您可以设置默认配置 - 在这种情况下，您可以实现所有选择器的相同外观和感觉。

国际化

现在完全支持，每个选择器都加载适当的翻译文件。翻译在JavaScript文件中。

重要提示：为了使此控件正常工作，需要为每种文化提供适当的JavaScript文件，其中包含日期选择器和时间选择器的翻译。

对于每种文化，将使用默认的时间和日期格式 - 您可以使用config.yml或控件的初始化来覆盖此设置。

config.yml

请注意，不建议修改原始config.yml - 使用它作为起点，但您的配置应在root/config/dm/config.yml中。

runopencode/dm-date-time-picker-plugin

维护者

详细信息