| | 30 | For the configuration, a widget instance is created like: |
| | 31 | |
| | 32 | {{{ |
| | 33 | instance = S3FilterWidget(field=None, **attr) |
| | 34 | }}} |
| | 35 | |
| | 36 | - '''field''' is the field selector (list of field selectors) for the field(s) to filter by (required) |
| | 37 | - '''attr''' are keyword attributes for the widget, where those starting with an underscore are the HTML attributes, while all others are widget options (see the particular widget for details) |
| | 38 | |
| | 39 | The widget is then rendered by calling it: |
| | 40 | |
| | 41 | {{{ |
| | 42 | widget = instance(resource, get_vars=None, alias=None) |
| | 43 | }}} |
| | 44 | |
| | 45 | - '''resource''' is the resource to filter (required) |
| | 46 | - '''get_vars''' is the dict of GET vars from the previous request (used to populate the widget, required but can be empty) |
| | 47 | - '''alias''' is the component alias to use for the URL query (optional, needed if ''resource'' is not the master resource of the request) |
