https://github.com/mrf345/flask_datepicker

A Flask extension for Jquery-ui javascript date picker
https://github.com/mrf345/flask_datepicker

date datepicker extension flask jquery-ui

Last synced: about 2 months ago
JSON representation

A Flask extension for Jquery-ui javascript date picker

• Host: GitHub
• URL: https://github.com/mrf345/flask_datepicker
• Owner: mrf345
• License: mit
• Created: 2017-11-25T08:36:09.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2021-08-08T19:58:15.000Z (over 3 years ago)
• Last Synced: 2024-03-25T01:41:25.606Z (9 months ago)
• Topics: date, datepicker, extension, flask, jquery-ui
• Language: Python
• Size: 2.94 MB
• Stars: 14
• Watchers: 2
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
 Flask-Datepicker 





    





  





  













A Flask extension for jQueryUI DatePicker, it makes adding and customizing multiple date pickers simpler and less time consuming.


## Install:

#### - With pip

- `pip install Flask-Datepicker` 


#### - From the source:

- `git clone https://github.com/mrf345/flask_datepicker.git`


- `cd flask_datepicker` 


- `python setup.py install`

## Setup:

#### - Inside Flask app:

```python

from flask import Flask, render_template

from flask_bootstrap import Bootstrap

from flask_datepicker import Datepicker

app = Flask(__name__)

Bootstrap(app)

datepicker = Datepicker(app)

```

#### - Inside jinja template:

```jinja

{% extends 'bootstrap/base.html' %}

{% block scripts %}

  {{ super() }}

  {{ datepicker.loader() }} {# to load jQuery-ui #}

  {{ datepicker.picker(id=".dp") }}

{% endblock %}

{% block content %}

  

    

  

{% endblock %}

```

## Settings:

#### - Options:

the accepted arguments to be passed to the `datepicker.picker()`:

```python

def picker(id=".datepicker", # identifier will be passed to Jquery to select element

           dateFormat='yy-mm-dd', # can't be explained more !

           maxDate='2018-12-30', # maximum date to select from. Make sure to follow the same format yy-mm-dd

           minDate='2017-12-01', # minimum date

           btnsId='.btnId' # id assigned to instigating buttons if needed

): 

```

##### - Themes

`datepicker.loader()` allows you to select a specific theme of your choice via:

```python

datepicker.loader(theme="base")

```

_If there is not a theme selected, the extension will select a new random theme with each reload of the page to be used. To make it remember the random choice, pass :_

```python

datepicker.loader(random_remember=True)

```

_List of available themes :_ 


`

['base', 'black-tie', 'blitzer' 'cupertino','dark-hive', 'dot-luv', 'eggplant', 'excite-bike', 'flick', 'hot-sneaks', 'humanity', 'le-frog','mint-choc', 'overcast', 'pepper-grinder', 'redmond','smoothness', 'south-street', 'start', 'sunny','swanky-purse', 'trontastic', 'ui-darkness','ui-lightness', 'vader']

`

#### - Local source:

by default the extension will load jQueryUI plugin from [a remote CDN][25530337]. Although you can configure that to be locally through passing a list of two files .js and .css into the datepicker module like such:

```python

datepicker(app=app, local=['static/js/jquery-ui.js', 'static/css/jquery-ui.css'])

```

[25530337]: https://code.jquery.com/ui/ "Jquery-ui CDN"

## Credit:

> - [Datepicker][1311353e]: jQuery-ui date picker.

  [1311353e]: https://jqueryui.com/datepicker/ "jQuery-UI website"