AnnoIssueTemplate.php 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. <?php
  2. namespace App\Services\Markup\Templates\Internal;
  3. use App\Services\HtmlAnnotationMarkup;
  4. use App\Services\Markup\Format;
  5. use App\Services\Markup\Ir\Call;
  6. use App\Services\Markup\Ir\Document;
  7. use App\Services\Markup\Render\RenderContext;
  8. use App\Services\Markup\Templates\ParamSpec;
  9. use App\Services\Markup\Templates\Template;
  10. /**
  11. * 阅读页的 issue 高亮:包住锚定的那段正文,点击看 issue。由批注注入生成,正文里写不出来。
  12. *
  13. * tree:`{name: 'anno-issue', props: {ids, severity}, children}`;html 与阅读器 CSS 约定的 span 一致;
  14. * 纯文本 / markdown 只输出被包住的正文。
  15. */
  16. final class AnnoIssueTemplate extends Template
  17. {
  18. protected string $component = 'anno-issue';
  19. public function params(): array
  20. {
  21. return ['ids' => new ParamSpec, 'severity' => new ParamSpec];
  22. }
  23. /**
  24. * @return list<string>
  25. */
  26. public static function ids(Call $call): array
  27. {
  28. return array_values(array_filter(explode(',', (string) $call->param('ids'))));
  29. }
  30. public static function severity(Call $call): ?string
  31. {
  32. $severity = (string) $call->param('severity');
  33. return $severity === '' ? null : $severity;
  34. }
  35. /**
  36. * @return array<string, mixed>
  37. */
  38. public function props(Call $call, RenderContext $ctx): array
  39. {
  40. return ['ids' => self::ids($call), 'severity' => self::severity($call)];
  41. }
  42. public function children(Call $call, RenderContext $ctx): ?Document
  43. {
  44. return $call->slot('content');
  45. }
  46. private function inner(Call $call, RenderContext $ctx): string
  47. {
  48. $content = $call->slot('content');
  49. return $content === null ? '' : $ctx->renderString($content);
  50. }
  51. public function text(Call $call, RenderContext $ctx): string
  52. {
  53. return $this->inner($call, $ctx);
  54. }
  55. public function plain(Call $call, RenderContext $ctx, Format $format): string
  56. {
  57. return $this->inner($call, $ctx);
  58. }
  59. public function html(Call $call, RenderContext $ctx): string
  60. {
  61. return HtmlAnnotationMarkup::issueOpenTag(self::ids($call), self::severity($call)).$this->inner($call, $ctx).'</span>';
  62. }
  63. public function markdown(Call $call, RenderContext $ctx): string
  64. {
  65. return $this->inner($call, $ctx);
  66. }
  67. }