2025-12-04 14:41:20 +08:00

70 lines
2.0 KiB
Python

import re
from typing import TYPE_CHECKING, Any, Dict, Iterable
if TYPE_CHECKING:
from ..core import BaseRenderer, BlockState
from ..markdown import Markdown
__all__ = ["task_lists"]
TASK_LIST_ITEM = re.compile(r"^(\[[ xX]\])\s+")
def task_lists_hook(md: "Markdown", state: "BlockState") -> Iterable[Dict[str, Any]]:
return _rewrite_all_list_items(state.tokens)
def render_task_list_item(renderer: "BaseRenderer", text: str, checked: bool = False) -> str:
checkbox = '<input class="task-list-item-checkbox" type="checkbox" disabled'
if checked:
checkbox += " checked/>"
else:
checkbox += "/>"
if text.startswith("<p>"):
text = text.replace("<p>", "<p>" + checkbox, 1)
else:
text = checkbox + text
return '<li class="task-list-item">' + text + "</li>\n"
def task_lists(md: "Markdown") -> None:
"""A mistune plugin to support task lists. Spec defined by
GitHub flavored Markdown and commonly used by many parsers:
.. code-block:: text
- [ ] unchecked task
- [x] checked task
:param md: Markdown instance
"""
md.before_render_hooks.append(task_lists_hook)
if md.renderer and md.renderer.NAME == "html":
md.renderer.register("task_list_item", render_task_list_item)
def _rewrite_all_list_items(tokens: Iterable[Dict[str, Any]]) -> Iterable[Dict[str, Any]]:
for tok in tokens:
if tok["type"] == "list_item":
_rewrite_list_item(tok)
if "children" in tok:
_rewrite_all_list_items(tok["children"])
return tokens
def _rewrite_list_item(tok: Dict[str, Any]) -> None:
children = tok["children"]
if children:
first_child = children[0]
text = first_child.get("text", "")
m = TASK_LIST_ITEM.match(text)
if m:
mark = m.group(1)
first_child["text"] = text[m.end() :]
tok["type"] = "task_list_item"
tok["attrs"] = {"checked": mark != "[ ]"}