{"id": "plugin_hooks:plugin-hook-render-cell", "page": "plugin_hooks", "ref": "plugin-hook-render-cell", "title": "render_cell(row, value, column, table, database, datasette, request)", "content": "Lets you customize the display of values within table cells in the HTML table view. \n             \n                 \n                     row  -  sqlite.Row \n                     \n                         The SQLite row object that the value being rendered is part of \n                     \n                 \n                 \n                     value  - string, integer, float, bytes or None \n                     \n                         The value that was loaded from the database \n                     \n                 \n                 \n                     column  - string \n                     \n                         The name of the column being rendered \n                     \n                 \n                 \n                     table  - string or None \n                     \n                         The name of the table - or  None  if this is a custom SQL query \n                     \n                 \n                 \n                     database  - string \n                     \n                         The name of the database \n                     \n                 \n                 \n                     datasette  -  Datasette class \n                     \n                         You can use this to access plugin configuration options via  datasette.plugin_config(your_plugin_name) , or to execute SQL queries. \n                     \n                 \n                 \n                     request  -  Request object \n                     \n                         The current request object \n                     \n                 \n             \n             If your hook returns  None , it will be ignored. Use this to indicate that your hook is not able to custom render this particular value. \n             If the hook returns a string, that string will be rendered in the table cell. \n             If you want to return HTML markup you can do so by returning a  jinja2.Markup  object. \n             You can also return an awaitable function which returns a value. \n             Datasette will loop through all available  render_cell  hooks and display the value returned by the first one that does not return  None . \n             Here is an example of a custom  render_cell()  plugin which looks for values that are a JSON string matching the following format: \n             {\"href\": \"https://www.example.com/\", \"label\": \"Name\"} \n             If the value matches that pattern, the plugin returns an HTML link element: \n             from datasette import hookimpl\nimport markupsafe\nimport json\n\n\n@hookimpl\ndef render_cell(value):\n    # Render {\"href\": \"...\", \"label\": \"...\"} as link\n    if not isinstance(value, str):\n        return None\n    stripped = value.strip()\n    if not (\n        stripped.startswith(\"{\") and stripped.endswith(\"}\")\n    ):\n        return None\n    try:\n        data = json.loads(value)\n    except ValueError:\n        return None\n    if not isinstance(data, dict):\n        return None\n    if set(data.keys()) != {\"href\", \"label\"}:\n        return None\n    href = data[\"href\"]\n    if not (\n        href.startswith(\"/\")\n        or href.startswith(\"http://\")\n        or href.startswith(\"https://\")\n    ):\n        return None\n    return markupsafe.Markup(\n        '<a href=\"{href}\">{label}</a>'.format(\n            href=markupsafe.escape(data[\"href\"]),\n            label=markupsafe.escape(data[\"label\"] or \"\")\n            or \"&nbsp;\",\n        )\n    ) \n             Examples:  datasette-render-binary ,  datasette-render-markdown ,  datasette-json-html", "breadcrumbs": "[\"Plugin hooks\"]", "references": "[{\"href\": \"https://datasette.io/plugins/datasette-render-binary\", \"label\": \"datasette-render-binary\"}, {\"href\": \"https://datasette.io/plugins/datasette-render-markdown\", \"label\": \"datasette-render-markdown\"}, {\"href\": \"https://datasette.io/plugins/datasette-json-html\", \"label\": \"datasette-json-html\"}]"}