github/datasette
1
0
Fork 0
mirror of https://github.com/simonw/datasette.git synced 2025-12-10 16:51:24 +01:00
Code Issues Projects Releases Packages Wiki Activity

Fixed bug with metadata config of array/date facets, closes #1552

Browse source 
Thanks @davidbgk for spotting the fix for the bug.
This commit is contained in:
Simon Willison 2021-12-16 10:47:22 -08:00
commit 20a2ed6bec
3 changed files with 43 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

20
docs/facets.rst
View file

@ -16,7 +16,9 @@ To turn on faceting for specific columns on a Datasette table view, add one or m
/dbname/tablename?_facet=state&_facet=city_id
This works for both the HTML interface and the ``.json`` view. When enabled, facets will cause a ``facet_results`` block to be added to the JSON output, looking something like this::
This works for both the HTML interface and the ``.json`` view. When enabled, facets will cause a ``facet_results`` block to be added to the JSON output, looking something like this:
.. code-block:: json
{
"state": {
@ -93,7 +95,9 @@ Facets in metadata.json
You can turn facets on by default for specific tables by adding them to a ``"facets"`` key in a Datasette :ref:`metadata` file.
Here's an example that turns on faceting by default for the ``qLegalStatus`` column in the ``Street_Tree_List`` table in the ``sf-trees`` database::
Here's an example that turns on faceting by default for the ``qLegalStatus`` column in the ``Street_Tree_List`` table in the ``sf-trees`` database:
.. code-block:: json
{
"databases": {
@ -109,6 +113,18 @@ Here's an example that turns on faceting by default for the ``qLegalStatus`` col
Facets defined in this way will always be shown in the interface and returned in the API, regardless of the ``_facet`` arguments passed to the view.
You can specify :ref:`array <facet_by_json_array>` or :ref:`date <facet_by_date>` facets in metadata using JSON objects with a single key of ``array`` or ``date`` and a value specifying the column, like this:
.. code-block:: json
{
"facets": [
{"array": "tags"},
{"date": "created"}
]
}
Suggested facets
----------------