mirror of https://gitlab.federez.net/re2o/re2o
Chirac
8 years ago
12 changed files with 7857 additions and 21 deletions
@ -0,0 +1,21 @@ |
|||
# -*- mode: python; coding: utf-8 -*- |
|||
# Re2o est un logiciel d'administration développé initiallement au rezometz. Il |
|||
# se veut agnostique au réseau considéré, de manière à être installable en |
|||
# quelques clics. |
|||
# |
|||
# Copyright © 2017 Maël Kervella |
|||
# |
|||
# This program is free software; you can redistribute it and/or modify |
|||
# it under the terms of the GNU General Public License as published by |
|||
# the Free Software Foundation; either version 2 of the License, or |
|||
# (at your option) any later version. |
|||
# |
|||
# This program is distributed in the hope that it will be useful, |
|||
# but WITHOUT ANY WARRANTY; without even the implied warranty of |
|||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|||
# GNU General Public License for more details. |
|||
# |
|||
# You should have received a copy of the GNU General Public License along |
|||
# with this program; if not, write to the Free Software Foundation, Inc., |
|||
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. |
|||
|
|||
@ -0,0 +1,330 @@ |
|||
# -*- mode: python; coding: utf-8 -*- |
|||
# Re2o est un logiciel d'administration développé initiallement au rezometz. Il |
|||
# se veut agnostique au réseau considéré, de manière à être installable en |
|||
# quelques clics. |
|||
# |
|||
# Copyright © 2017 Maël Kervella |
|||
# |
|||
# This program is free software; you can redistribute it and/or modify |
|||
# it under the terms of the GNU General Public License as published by |
|||
# the Free Software Foundation; either version 2 of the License, or |
|||
# (at your option) any later version. |
|||
# |
|||
# This program is distributed in the hope that it will be useful, |
|||
# but WITHOUT ANY WARRANTY; without even the implied warranty of |
|||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|||
# GNU General Public License for more details. |
|||
# |
|||
# You should have received a copy of the GNU General Public License along |
|||
# with this program; if not, write to the Free Software Foundation, Inc., |
|||
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. |
|||
|
|||
from django import template |
|||
from django.utils.safestring import mark_safe |
|||
from django.forms import TextInput |
|||
from bootstrap3.templatetags.bootstrap3 import bootstrap_form |
|||
from bootstrap3.utils import render_tag |
|||
from bootstrap3.forms import render_field |
|||
|
|||
register = template.Library() |
|||
|
|||
@register.simple_tag |
|||
def bootstrap_form_typeahead(django_form, typeahead_fields, *args, **kwargs): |
|||
""" |
|||
Render a form where some specific fields are rendered using Typeahead. |
|||
Using Typeahead really improves the performance, the speed and UX when |
|||
dealing with very large datasets (select with 50k+ elts for instance). |
|||
For convenience, it accepts the same parameters as a standard bootstrap |
|||
can accept. |
|||
|
|||
**Tag name**:: |
|||
|
|||
bootstrap_form_typeahead |
|||
|
|||
**Parameters**: |
|||
|
|||
form |
|||
The form that is to be rendered |
|||
|
|||
typeahead_fields |
|||
A list of field names (comma separated) that should be rendered |
|||
with typeahead instead of the default bootstrap renderer. |
|||
|
|||
bft_param |
|||
A dict of parameters for the bootstrap_form_typeahead tag. The |
|||
possible parameters are the following. |
|||
|
|||
choices |
|||
A dict of strings representing the choices in JS. The keys of |
|||
the dict are the names of the concerned fields. The choices |
|||
must be an array of objects. Each of those objects must at |
|||
least have the fields 'key' (value to send) and 'value' (value |
|||
to display). Other fields can be added as desired. |
|||
For a more complex structure you should also consider |
|||
reimplementing the engine and the match_func. |
|||
If not specified, the key is the id of the object and the value |
|||
is its string representation as in a normal bootstrap form. |
|||
Example : |
|||
'choices' : { |
|||
'field_A':'[{key:0,value:"choice0",extra:"data0"},{...},...]', |
|||
'field_B':..., |
|||
... |
|||
} |
|||
|
|||
engine |
|||
A dict of strings representating the engine used for matching |
|||
queries and possible values with typeahead. The keys of the |
|||
dict are the names of the concerned fields. The string is valid |
|||
JS code. |
|||
If not specified, BloodHound with relevant basic properties is |
|||
used. |
|||
Example : |
|||
'engine' : {'field_A': 'new Bloodhound()', 'field_B': ..., ...} |
|||
|
|||
match_func |
|||
A dict of strings representing a valid JS function used in the |
|||
dataset to overload the matching engine. The keys of the dict |
|||
are the names of the concerned fields. This function is used |
|||
the source of the dataset. This function receives 2 parameters, |
|||
the query and the synchronize function as specified in |
|||
typeahead.js documentation. If needed, the local variables |
|||
'choices_<fieldname>' and 'engine_<fieldname>' contains |
|||
respectively the array of all possible values and the engine |
|||
to match queries with possible values. |
|||
If not specified, the function used display up to the 10 first |
|||
elements if the query is empty and else the matching results. |
|||
Example : |
|||
'match_func' : { |
|||
'field_A': 'function(q, sync) { engine.search(q, sync); }', |
|||
'field_B': ..., |
|||
... |
|||
} |
|||
|
|||
update_on |
|||
A dict of list of ids that the values depends on. The engine |
|||
and the typeahead properties are recalculated and reapplied. |
|||
Example : |
|||
'addition' : { |
|||
'field_A' : [ 'id0', 'id1', ... ] , |
|||
'field_B' : ... , |
|||
... |
|||
} |
|||
|
|||
See boostrap_form_ for other arguments |
|||
|
|||
**Usage**:: |
|||
|
|||
{% bootstrap_form_typeahead |
|||
form |
|||
[ '<field1>[,<field2>[,...]]' ] |
|||
[ { |
|||
[ 'choices': { |
|||
[ '<field1>': '<choices1>' |
|||
[, '<field2>': '<choices2>' |
|||
[, ... ] ] ] |
|||
} ] |
|||
[, 'engine': { |
|||
[ '<field1>': '<engine1>' |
|||
[, '<field2>': '<engine2>' |
|||
[, ... ] ] ] |
|||
} ] |
|||
[, 'match_func': { |
|||
[ '<field1>': '<match_func1>' |
|||
[, '<field2>': '<match_func2>' |
|||
[, ... ] ] ] |
|||
} ] |
|||
[, 'update_on': { |
|||
[ '<field1>': '<update_on1>' |
|||
[, '<field2>': '<update_on2>' |
|||
[, ... ] ] ] |
|||
} ] |
|||
} ] |
|||
[ <standard boostrap_form parameters> ] |
|||
%} |
|||
|
|||
**Example**: |
|||
|
|||
{% bootstrap_form_typeahead form 'ipv4' choices='[...]' %} |
|||
""" |
|||
|
|||
t_fields = typeahead_fields.split(',') |
|||
params = kwargs.get('bft_param', {}) |
|||
exclude = params.get('exclude', None) |
|||
exclude = exclude.split(',') if exclude else [] |
|||
t_choices = params.get('choices', {}) |
|||
t_engine = params.get('engine', {}) |
|||
t_match_func = params.get('match_func', {}) |
|||
t_update_on = params.get('update_on', {}) |
|||
hidden = [h.name for h in django_form.hidden_fields()] |
|||
|
|||
form = '' |
|||
for f_name, f_value in django_form.fields.items() : |
|||
if not f_name in exclude : |
|||
if f_name in t_fields and not f_name in hidden : |
|||
f_bound = f_value.get_bound_field( django_form, f_name ) |
|||
f_value.widget = TextInput( |
|||
attrs={ |
|||
'name': 'typeahead_'+f_name, |
|||
'placeholder': f_value.empty_label |
|||
} |
|||
) |
|||
form += render_field( |
|||
f_value.get_bound_field( django_form, f_name ), |
|||
*args, |
|||
**kwargs |
|||
) |
|||
form += render_tag( |
|||
'div', |
|||
content = hidden_tag( f_bound, f_name ) + |
|||
typeahead_js( |
|||
f_name, |
|||
f_value, |
|||
f_bound, |
|||
t_choices, |
|||
t_engine, |
|||
t_match_func, |
|||
t_update_on |
|||
) |
|||
) |
|||
else: |
|||
form += render_field( |
|||
f_value.get_bound_field(django_form, f_name), |
|||
*args, |
|||
**kwargs |
|||
) |
|||
|
|||
return mark_safe( form ) |
|||
|
|||
def input_id( f_name ) : |
|||
""" The id of the HTML input element """ |
|||
return 'id_'+f_name |
|||
|
|||
def hidden_id( f_name ): |
|||
""" The id of the HTML hidden input element """ |
|||
return 'typeahead_hidden_'+f_name |
|||
|
|||
def hidden_tag( f_bound, f_name ): |
|||
""" The HTML hidden input element """ |
|||
return render_tag( |
|||
'input', |
|||
attrs={ |
|||
'id': hidden_id(f_name), |
|||
'name': f_name, |
|||
'type': 'hidden', |
|||
'value': f_bound.value() or "" |
|||
} |
|||
) |
|||
|
|||
def typeahead_js( f_name, f_value, f_bound, |
|||
t_choices, t_engine, t_match_func, t_update_on ) : |
|||
""" The whole script to use """ |
|||
|
|||
choices = mark_safe(t_choices[f_name]) if f_name in t_choices.keys() \ |
|||
else default_choices( f_value ) |
|||
|
|||
engine = mark_safe(t_engine[f_name]) if f_name in t_engine.keys() \ |
|||
else default_engine ( f_name ) |
|||
|
|||
match_func = mark_safe(t_match_func[f_name]) \ |
|||
if f_name in t_match_func.keys() \ |
|||
else default_match_func( f_name ) |
|||
|
|||
update_on = t_update_on[f_name] if f_name in t_update_on.keys() else [] |
|||
|
|||
js_content = \ |
|||
'var choices_'+f_name+' = ' + choices + ';\n' + \ |
|||
'var setup_'+f_name+' = function() {\n' + \ |
|||
'var engine_'+f_name+' = ' + engine + ';\n' + \ |
|||
'$("#'+input_id(f_name) + '").typeahead("destroy");\n' + \ |
|||
'$("#'+input_id(f_name) + '").typeahead(\n' + \ |
|||
default_datasets( f_name, match_func ) + '\n' + \ |
|||
');\n' + \ |
|||
reset_input( f_name, f_bound ) + '\n' + \ |
|||
'};\n' + \ |
|||
'$("#'+input_id(f_name) + '").bind(\n' + \ |
|||
'"typeahead:select", ' + \ |
|||
typeahead_updater( f_name ) + '\n' + \ |
|||
').bind(\n' + \ |
|||
'"typeahead:change", ' + \ |
|||
typeahead_change( f_name ) + '\n' + \ |
|||
');\n' |
|||
for u_id in update_on : |
|||
js_content += '$("#'+u_id+'").change( setup_'+f_name+' );\n' |
|||
js_content += '$("#'+input_id(f_name)+'").ready( setup_'+f_name+' );\n' |
|||
|
|||
return render_tag( 'script', content=mark_safe( js_content ) ) |
|||
|
|||
def reset_input( f_name, f_bound ) : |
|||
""" The JS script to reset the fields values """ |
|||
return '$("#'+input_id(f_name)+'").typeahead(' \ |
|||
'"val", ' \ |
|||
'engine_'+f_name+'.get('+str(f_bound.value())+')[0].value' \ |
|||
');\n' \ |
|||
'$("#'+hidden_id(f_name)+'").val('+str(f_bound.value())+');' |
|||
|
|||
def default_choices( f_value ) : |
|||
""" The JS script creating the variable choices_<fieldname> """ |
|||
return '[' + \ |
|||
', '.join([ \ |
|||
'{key: ' + (str(choice[0]) if choice[0] != '' else '""') + \ |
|||
', value: "' + str(choice[1]) + '"}' \ |
|||
for choice in f_value.choices \ |
|||
]) + \ |
|||
']' |
|||
|
|||
def default_engine ( f_name ) : |
|||
""" The JS script creating the variable engine_<field_name> """ |
|||
return 'new Bloodhound({ ' \ |
|||
'datumTokenizer: Bloodhound.tokenizers.obj.whitespace("value"), ' \ |
|||
'queryTokenizer: Bloodhound.tokenizers.whitespace, ' \ |
|||
'local: choices_'+f_name+', ' \ |
|||
'identify: function(obj) { return obj.key; } ' \ |
|||
'})' |
|||
|
|||
def default_datasets( f_name, match_func ) : |
|||
""" The JS script creating the datasets to use with typeahead """ |
|||
return '{ ' \ |
|||
'hint: true, ' \ |
|||
'highlight: true, ' \ |
|||
'minLength: 0 ' \ |
|||
'}, ' \ |
|||
'{ ' \ |
|||
'display: "value", ' \ |
|||
'name: "'+f_name+'", ' \ |
|||
'source: '+match_func + \ |
|||
'}' |
|||
|
|||
def default_match_func ( f_name ) : |
|||
""" The JS script creating the matching function to use with typeahed """ |
|||
return 'function(q, sync) {' \ |
|||
'if (q === "") {' \ |
|||
'var nb = 10;' \ |
|||
'var first = [] ;' \ |
|||
'for ( var i=0 ; i<nb && i<choices_'+f_name+'.length; i++ ) {' \ |
|||
'first.push(choices_'+f_name+'[i].key);' \ |
|||
'}' \ |
|||
'sync(engine_'+f_name+'.get(first));' \ |
|||
'} else {' \ |
|||
'engine_'+f_name+'.search(q, sync);' \ |
|||
'}' \ |
|||
'}' |
|||
|
|||
def typeahead_updater( f_name ): |
|||
""" The JS script creating the function triggered when an item is |
|||
selected through typeahead """ |
|||
return 'function(evt, item) { ' \ |
|||
'$("#'+hidden_id(f_name)+'").val( item.key ); ' \ |
|||
'$("#'+hidden_id(f_name)+'").change();' \ |
|||
'return item; ' \ |
|||
'}' |
|||
|
|||
def typeahead_change( f_name ): |
|||
""" The JS script creating the function triggered when an item is changed |
|||
(i.e. looses focus and value has changed since the moment it gained focus |
|||
""" |
|||
return 'function(evt) { ' \ |
|||
'if ($("#'+input_id(f_name)+'").typeahead("val") === "") {' \ |
|||
'$("#'+hidden_id(f_name)+'").val(""); ' \ |
|||
'$("#'+hidden_id(f_name)+'").change();' \ |
|||
'}' \ |
|||
'}' |
|||
@ -0,0 +1,93 @@ |
|||
span.twitter-typeahead .tt-menu, |
|||
span.twitter-typeahead .tt-dropdown-menu { |
|||
position: absolute; |
|||
top: 100%; |
|||
left: 0; |
|||
z-index: 1000; |
|||
display: none; |
|||
float: left; |
|||
min-width: 160px; |
|||
padding: 5px 0; |
|||
margin: 2px 0 0; |
|||
list-style: none; |
|||
font-size: 14px; |
|||
text-align: left; |
|||
background-color: #ffffff; |
|||
border: 1px solid #cccccc; |
|||
border: 1px solid rgba(0, 0, 0, 0.15); |
|||
border-radius: 4px; |
|||
-webkit-box-shadow: 0 6px 12px rgba(0, 0, 0, 0.175); |
|||
box-shadow: 0 6px 12px rgba(0, 0, 0, 0.175); |
|||
background-clip: padding-box; |
|||
} |
|||
span.twitter-typeahead .tt-suggestion { |
|||
display: block; |
|||
padding: 3px 20px; |
|||
clear: both; |
|||
font-weight: normal; |
|||
line-height: 1.42857143; |
|||
color: #333333; |
|||
white-space: nowrap; |
|||
} |
|||
span.twitter-typeahead .tt-suggestion.tt-cursor, |
|||
span.twitter-typeahead .tt-suggestion:hover, |
|||
span.twitter-typeahead .tt-suggestion:focus { |
|||
color: #ffffff; |
|||
text-decoration: none; |
|||
outline: 0; |
|||
background-color: #337ab7; |
|||
} |
|||
.input-group.input-group-lg span.twitter-typeahead .form-control { |
|||
height: 46px; |
|||
padding: 10px 16px; |
|||
font-size: 18px; |
|||
line-height: 1.3333333; |
|||
border-radius: 6px; |
|||
} |
|||
.input-group.input-group-sm span.twitter-typeahead .form-control { |
|||
height: 30px; |
|||
padding: 5px 10px; |
|||
font-size: 12px; |
|||
line-height: 1.5; |
|||
border-radius: 3px; |
|||
} |
|||
span.twitter-typeahead { |
|||
width: 100%; |
|||
} |
|||
.input-group span.twitter-typeahead { |
|||
display: block !important; |
|||
height: 34px; |
|||
} |
|||
.input-group span.twitter-typeahead .tt-menu, |
|||
.input-group span.twitter-typeahead .tt-dropdown-menu { |
|||
top: 32px !important; |
|||
} |
|||
.input-group span.twitter-typeahead:not(:first-child):not(:last-child) .form-control { |
|||
border-radius: 0; |
|||
} |
|||
.input-group span.twitter-typeahead:first-child .form-control { |
|||
border-top-left-radius: 4px; |
|||
border-bottom-left-radius: 4px; |
|||
border-top-right-radius: 0; |
|||
border-bottom-right-radius: 0; |
|||
} |
|||
.input-group span.twitter-typeahead:last-child .form-control { |
|||
border-top-left-radius: 0; |
|||
border-bottom-left-radius: 0; |
|||
border-top-right-radius: 4px; |
|||
border-bottom-right-radius: 4px; |
|||
} |
|||
.input-group.input-group-sm span.twitter-typeahead { |
|||
height: 30px; |
|||
} |
|||
.input-group.input-group-sm span.twitter-typeahead .tt-menu, |
|||
.input-group.input-group-sm span.twitter-typeahead .tt-dropdown-menu { |
|||
top: 30px !important; |
|||
} |
|||
.input-group.input-group-lg span.twitter-typeahead { |
|||
height: 46px; |
|||
} |
|||
.input-group.input-group-lg span.twitter-typeahead .tt-menu, |
|||
.input-group.input-group-lg span.twitter-typeahead .tt-dropdown-menu { |
|||
top: 46px !important; |
|||
} |
|||
File diff suppressed because one or more lines are too long
File diff suppressed because it is too large
Loading…
Reference in new issue