Skip to main content

jQuery Option Tree widget for deform

Project description

This package makes jQuery Option Tree available as a deform form library widget. jQuery Option Tree converts a JSON option tree into dynamically created <select> elements allowing you to choose one nested option from the tree.

Currently only one feature for a very specific use case is implemented, hierarchical browsing from a data structure like this:

key     value
---     -----
1       Option 1
11      Suboption 1.1
111     Subsubption 1.1.1
112     Subsubption 1.1.2
12      Suboption 1.2
2       Option 2
21      Suboption 2.1
22      Suboption 2.2
3       Option 3

This is suitable for hierarchical selections from standards like ISCO08 or NACE Rev. 2

The implementation currently requires the data to be exposed by a REST service with 2 endpoints that are reachable via a common base URL (the json_url option of the widget):

  • json_url has to return the top level key/value pairs

  • json_url with the GET parameter ìd has to return the child elements for the given id.

  • json_url + ‘/<id>/lineage’ has to return the lineage of IDs from root to leaf for the given <id>.

Examples:

json_url = '/api/classifications/nace_rev2'

# GET call to '/api/classifications/nace_rev2'
# has to return a structure like this:
{
    A: "LAND- UND FORSTWIRTSCHAFT, FISCHEREI",
    B: "BERGBAU UND GEWINNUNG VON STEINEN UND ERDEN",
    C: "VERARBEITENDES GEWERBE/HERSTELLUNG VON WAREN"
}

# GET call to '/api/classifications/nace_rev2?id=A'
# has to return a structure like this:
{
    A01: "Landwirtschaft, Jagd und damit verbundene Tätigkeiten",
    A02: "Forstwirtschaft und Holzeinschlag",
    A03: "Fischerei und Aquakultur"
}

# GET call to '/api/classifications/nace_rev2/Q8690/lineage'
# has to return a structure like this:
["Q", "Q86", "Q869", "Q8690"]

See the included demo application for details.

Contributions

Contributions are welcome, especially if you want to add support for more generic data structures and/or configurable options for the plugin.

Changes

0.2.1

  • Fix JS error when initializing empty field.

0.2

  • Change Javascript to allow better configuration

  • Move the fanstatic need() call to the serialize method.

0.1

  • Initial release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deform_widget_jquery_option_tree-0.2.1.tar.gz (89.6 kB view details)

Uploaded Source

File details

Details for the file deform_widget_jquery_option_tree-0.2.1.tar.gz.

File metadata

File hashes

Hashes for deform_widget_jquery_option_tree-0.2.1.tar.gz
Algorithm Hash digest
SHA256 4a6ffca1de617c9ff2a31846c6296e266961362451f355be50404184ed816ffa
MD5 731a522183a297888e5e9d32aa8322e2
BLAKE2b-256 1508f0ac4b69af6f32c7d337909e98bc96ac61724a815f9a82a2d359c756f567

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page