我正在修复一个旧的WordPress语法荧光笔插件(插件所有者放弃了它),并且在修复PHP错误时很容易,而在修复它的同时,我也可能会改善可访问性。
我的问题是关于代码的HTML结构。我想在一侧显示数字,并在其旁边显示代码:
我认为HTML将是这样的:
<section> <!-- Maybe article? -->
<header>
<h1>Sample HTML</h1> <!-- Maybe <h3> would fit my blog posts best -->
<div role="toolbar">toolabar buttons here</div>
</header>
<ol>
<li><span class="sh-r "><div </span><span class="sh-e ">class</span>=<span class="sh-s ">"grid"</span><span class="sh-r ">></span>
...
</ol>
</section>
但是我不确定。代码应该在<ol>
还是在<table>
?更改颜色的范围可以吗?工具栏角色合适吗?我想念什么吗?如果有人有可访问的代码突出显示示例,我很乐意看到它。
现在的样子,它是一个表,其中所有数字都在一个表中,<td>
而所有代码都在另一个表中!
代码应该在
<ol>
还是在<table>
?
我会说<ol>
比这更合适<table>
。
在这里使用表格看起来仅是出于演示目的。我不会称其表的左侧为行号而右侧的代码行为数据表。
更改颜色的范围可以吗?
作为默认设置,因为无论如何您都无法在HTML中做得更好,所以我会说是的,这很好。
如果HTML具有更具体的元素来在语义上指示关键字,块,数字,字符串,变量等,那么强烈建议您使用它们而不是跨度。但是实际上除了<var
,<kbd>
和/或<samp>
;之外并没有这样的特定元素。但是它们的语义含义从未十分清楚。
但是,作为更高级别,您应该使用<code>
或<pre>
将整个代码括起来,以进行标记。问题是,如果您使用这两个元素,则不能再使用<ol>
或<table>
。
也许最可接受的折衷办法是<ol><li><code>One line of code</code></li>...</ol>
。
无论如何,对于诸如在代码行内标记关键字之类的特定事情,您没有比<span>
提供HTML更好的选择。
工具栏角色合适吗?
鉴于您尚未在div中提供代码,因此很难回答。
通常,工具栏应包含一组按钮或偶尔包含其他控件(如下拉菜单),原则上不包含其他按钮。
如果该div的内容与此简单定义相对应,是的,工具栏是合适的。否则,不会。
使用工具栏角色少于3个按钮不是很值得
正如我在这里可以想象的那样,该div仅包含一个按钮,可以将代码复制到剪贴板中。如果确实如此,那么按照上面的定义,它不是很合适。
本文收集自互联网,转载请注明来源。
如有侵权,请联系[email protected] 删除。
我来说两句