HtmlAnnotationMarkup.php 2.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. <?php
  2. namespace App\Services;
  3. /**
  4. * 批注标记的 HTML 写法:阅读器(library、wikipali-mobile)的 CSS 与点击处理都认这套 class / data-*。
  5. *
  6. * {@see AnnotationLayout} 的默认策略;App\Services\Markup 的批注模板(anno-*)输出 html 时也用这里的方法,
  7. * 两条路径的 HTML 逐字节一致。
  8. */
  9. class HtmlAnnotationMarkup implements AnnotationMarkup
  10. {
  11. public function issueOpen(array $span): string
  12. {
  13. return self::issueOpenTag($span['ids'], $span['severity']);
  14. }
  15. public function issueClose(array $span): string
  16. {
  17. return '</span>';
  18. }
  19. public function issueMark(array $ids, ?string $severity): string
  20. {
  21. return '<span class="anno-issue-mark anno-issue-'.($severity ?? 'none').'"'
  22. .' data-discussion-ids="'.e(implode(',', $ids)).'"'
  23. .' data-severity="'.e($severity ?? '').'" role="button" tabindex="0">'
  24. .'<i class="ti ti-alert-triangle"></i></span>';
  25. }
  26. public function assessmentMark(string $id, int $score): string
  27. {
  28. $level = AnnotationLayout::assessmentLevel($score);
  29. return '<span class="anno-assessment-mark anno-assessment-'.$level.'"'
  30. .' data-discussion-ids="'.e($id).'"'
  31. .' data-score="'.$score.'" data-level="'.$level.'" role="button" tabindex="0">'
  32. .'<i class="ti ti-circle-check"></i></span>';
  33. }
  34. /**
  35. * 没有评估的句子:灰色对勾,不能点(没有 discussion id)。
  36. */
  37. public static function unassessedMark(): string
  38. {
  39. return '<span class="anno-assessment-mark anno-assessment-none" data-level="none" aria-hidden="true">'
  40. .'<i class="ti ti-circle-check"></i></span>';
  41. }
  42. /**
  43. * @param list<string> $ids
  44. */
  45. public static function issueOpenTag(array $ids, ?string $severity): string
  46. {
  47. return '<span class="anno-issue anno-issue-'.($severity ?? 'none').'"'
  48. .' data-discussion-ids="'.e(implode(',', $ids)).'"'
  49. .' data-severity="'.e($severity ?? '').'">';
  50. }
  51. }