معرفی شرکت ها
django-typeahead-1.0.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Django app to add Typeahead.js based input elements.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-typeahead-1.0.1 |
| نام | django-typeahead |
| نسخه کتابخانه | 1.0.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Ronny Hendrawan |
| ایمیل نویسنده | ronny.hendrawan@gmail.com |
| آدرس صفحه اصلی | https://github.com/xvronny/django-typeahead/ |
| آدرس اینترنتی | https://pypi.org/project/django-typeahead/ |
| مجوز | MIT License |
=======================
Typeahead.js for Django
=======================
.. image:: https://travis-ci.org/xvronny/django-typeahead.svg?branch=master
:target: https://travis-ci.org/xvronny/django-typeahead
:alt: Continuous Integration
.. image:: https://coveralls.io/repos/github/xvronny/django-typeahead/badge.svg?branch=master
:target: https://coveralls.io/github/xvronny/django-typeahead?branch=master
:alt: Test Coverage
.. image:: https://img.shields.io/pypi/v/django-typeahead.svg
:target: https://pypi.python.org/pypi/django-typeahead
:alt: Latest PyPI version
Django thin wrapper for Twitter's `Typeahead.js <https://github.com/twitter/typeahead.js>`_ library.
Goal
----
The goal of this package is to seamlessly integrate Typeahead.js with Django and other django libraries.
Documentation
-------------
The full documentation is at https://django-typeahead.readthedocs.io/
Requirements
------------
* Python >= 3.4
* Django >= 2.0
* jquery >= 1.9
Installation
------------
1. Install using pip:
``pip install django-typeahead``
2. Add ``bootstrap_typeahead`` to the list of ``INSTALLED_APPS`` in your ``settings.py`` file:
.. code-block:: python
INSTALLED_APPS = [
# ...
'bootstrap_typeahead',
]
This installation instruction assumes you have jQuery already present in your page.
Example
-------
This sample section translates the `first example (basics) <https://twitter.github.io/typeahead.js/examples/#the-basics>`_ sample from Typeahead.js `examples page <https://twitter.github.io/typeahead.js/examples>`_.
forms.py
^^^^^^^^
The input widget ``TypeaheadInput`` would be used as a widget in Django forms.
.. code-block:: python
from django import forms
from bootstrap_typeahead.widgets import TypeaheadInput
class StateForm(forms.Form):
query = forms.CharField(
widget=TypeaheadInput(
options={
'hint': True,
'highlight': True,
'minLength': 1
},
datasets={
'name': 'states',
'source': 'substringMatcher(states)',
}
)
)
The ``options`` and ``datasets`` argument will be passed to the JavaScript typeahead instance,
and are documented and demonstrated here:
* `Typeahead Documentation <https://github.com/twitter/typeahead.js/blob/master/doc/jquery_typeahead.md>`_
* `Bloodhound Documentation <https://github.com/twitter/typeahead.js/blob/master/doc/bloodhound.md>`_
* `Interactive Demo <https://twitter.github.io/typeahead.js/examples/>`_
template.html
^^^^^^^^^^^^^
The initialization of suggestions list should be added to the page - in this case we are using snippet from `basic example <https://twitter.github.io/typeahead.js/examples/#the-basics>`_ from Typeahead.js demo page.
.. code:: Django
{% load bootstrap4 %}
{# Load CSS and JavaScript #}
{% bootstrap_css %}
{% block extra_css %}
{{ form.media.css }}
{% endblock %}
<form method="post" role="form">
{% csrf_token %}
{% bootstrap_form form %}
<div class="form-group">
<input type="submit" value="Submit" class="btn btn-primary" />
</div>
</form>
{% bootstrap_javascript jquery='full' %}
{% block extra_js %}
<script type="text/javascript">
var substringMatcher = function(strs) {
return function findMatches(q, cb) {
var matches, substringRegex;
// an array that will be populated with substring matches
matches = [];
// regex used to determine if a string contains the substring `q`
substrRegex = new RegExp(q, 'i');
// iterate through the pool of strings and for any string that
// contains the substring `q`, add it to the `matches` array
$.each(strs, function(i, str) {
if (substrRegex.test(str)) {
matches.push(str);
}
});
cb(matches);
};
};
var states = ['Alabama', 'Alaska', 'Arizona', 'Arkansas', 'California',
'Colorado', 'Connecticut', 'Delaware', 'Florida', 'Georgia', 'Hawaii',
'Idaho', 'Illinois', 'Indiana', 'Iowa', 'Kansas', 'Kentucky', 'Louisiana',
'Maine', 'Maryland', 'Massachusetts', 'Michigan', 'Minnesota',
'Mississippi', 'Missouri', 'Montana', 'Nebraska', 'Nevada', 'New Hampshire',
'New Jersey', 'New Mexico', 'New York', 'North Carolina', 'North Dakota',
'Ohio', 'Oklahoma', 'Oregon', 'Pennsylvania', 'Rhode Island',
'South Carolina', 'South Dakota', 'Tennessee', 'Texas', 'Utah', 'Vermont',
'Virginia', 'Washington', 'West Virginia', 'Wisconsin', 'Wyoming'
];
</script>
{{ form.media.js }}
{% endblock %}
Here we use `django-bootstrap4 <https://github.com/zostera/django-bootstrap4>`_ but you can create your HTML forms manually.
License
-------
You can use this under MIT License. See `LICENSE <https://github.com/xvronny/django-typeahead/blob/master/LICENSE>`_ file for details.
Bugs and Suggestions
--------------------
If you have found a bug or if you have a request for additional functionality, please use the issue tracker on GitHub.
https://github.com/xvronny/django-typeahead/issues
نحوه نصب
نصب پکیج whl django-typeahead-1.0.1:
pip install django-typeahead-1.0.1.whl
نصب پکیج tar.gz django-typeahead-1.0.1:
pip install django-typeahead-1.0.1.tar.gz