模板:Var/doc

此页面是Template:Var的模板文档。 此页面可能包含了模板的使用说明、分类和其他内容。

重定向

• {{VAR}}
• {{variable}}

此模板文档被引用于约6,000个页面。 为了避免造成大规模的影响，所有对此模板文档的编辑应先于沙盒、测试样例或您的沙盒上测试。 测试后无误的版本可以一次性地加入此模板文档中，但是修改前请务必于讨论页发起讨论。 模板引用数量会自动更新。

使用

这个模板用于帮助使用 语义正确的（英语：Semantic HTML） <var>...</var> 标签显示变量名称（数学、计算机源代码、模板文档中的维基标记、元语法变量等），该标签习惯上还用于斜体显示变量。出于无障碍、呈现和内容的分离、语义网 和 维基数据的原因，此方法比简单斜体语法更受欢迎；在 XHTML 和 HTML 中，<var> 元素具有语义含义，而简单斜体则没有。该模板使用了微小的紧排空间（英语：kerning）显示，来补偿斜体字并增强可读性。

示例

示例:

使用中文乱序字符砥叽薄云作为示例。

{{var|砥叽薄云}}

输出的HTML：

<var>砥叽薄云</var>

显示为：

砥叽薄云

请注意，在屏幕上或打印出来时，这将呈现为简单的斜体，类似于使用一对撇号的 砥叽薄云 或使用HTML 的 砥叽薄云 ，然而它比这两种方法都具有更多的语义含义。

当您尝试显示单个字母变量时，有时可能希望使用衬线字体，尤其是在涉及到大写字母“I”和小写字母“l”等难以区分的情况下。在这种情况下，使用模板:VarSerif而不是模板:Var可以使它们更易于区分，例如以下衬线字体I, l.

更多示例

代码	效果
HTML代码: : {{tag|var|content=username}} 显示为: : {{var|username}}	HTML代码: <var>username</var> 显示为: username
命令行应该为: {{samp|%}} {{kbd|1=ssh {{var|hostname}}}}<br />(其中 {{var|hostname}} 是IP地址或...)<br />如果正确，请按{{键盘按钮|Enter}}。	命令行应该为: % ssh hostname (其中 hostname 是IP地址或...) 如果正确，请按↵ Enter。
在此等式中, 令{{var|x}}{{=}}1 并且 {{var|y}}{{=}}120 ...	在此等式中, 令 x=1 并且 y=120 ...
{{para|accessdate|{{var|todays_date}}}}	|accessdate=todays_date

模板数据

以下是该模板的模板数据，适用于可视化编辑器等工具。

Var模板数据

模板参数

参数		描述	类型	状态
文本	1	用于传递模板的主要内容或信息，例如文本、数据等。它是模板中位置参数的代号，用于定位并显示用户提供的具体值。	单行文本	必需
类	class	用于为 HTML 元素指定样式类，实现元素的样式定制和页面布局，提高网页美观性和灵活性。	字符串	可选
元素标识	id	用于为 HTML 元素定义唯一标识符，支持样式和脚本操作，确保页面结构和功能正确性。	字符串	可选
自定义样式	style	用于定义 HTML 元素的内联样式，包括颜色、字体大小等，实现个性化的外观设计，提升页面美观与用户体验。	字符串	可选
语言设置	lang 语言	用于定义 HTML 元素的语言设置，支持页面语义化和辅助技术，提高网页可访问性。 示例值 c++	字符串	可选
提示标题	title	`title` 参数用于定义 HTML 元素的提示标题，提供额外信息，鼠标悬停时显示，增强用户体验和页面可访问性。	字符串	可选

将文本标记为HTML变量

外部链接

• {{mvar}} 使参数变为斜体并采用数学格式
• {{math}} 将其参数格式化为数学
• {{bigmath}}, 与 {{math}} 相同，但是更大