From 0133b29392b1eb4b85f0124ba5f1e6c2f2fd6be6 Mon Sep 17 00:00:00 2001 From: jackSpanrrows <15811072719@163.com> Date: Fri, 10 May 2019 15:29:27 +0800 Subject: [PATCH 1/3] translate BaseHtml Completed --- framework/helpers/BaseHtml.php | 1646 ++++++++++++++++---------------- 1 file changed, 823 insertions(+), 823 deletions(-) diff --git a/framework/helpers/BaseHtml.php b/framework/helpers/BaseHtml.php index 5b0440b2918..2b516863d29 100644 --- a/framework/helpers/BaseHtml.php +++ b/framework/helpers/BaseHtml.php @@ -15,9 +15,9 @@ use yii\web\Request; /** - * BaseHtml provides concrete implementation for [[Html]]. + * BaseHtml [[Html]] 提供了具体的实现。 * - * Do not use BaseHtml. Use [[Html]] instead. + * 不要使用 BaseHtml 类。使用 [[Html]] 类来替代。 * * @author Qiang Xue * @since 2.0 @@ -25,12 +25,12 @@ class BaseHtml { /** - * @var string Regular expression used for attribute name validation. + * @var string 用于属性名称验证的正则表达式。 * @since 2.0.12 */ public static $attributeRegex = '/(^|.*\])([\w\.\+]+)(\[.*|$)/u'; /** - * @var array list of void elements (element name => 1) + * @var array 空元素列表(element name => 1) * @see http://www.w3.org/TR/html-markup/syntax.html#void-element */ public static $voidElements = [ @@ -52,8 +52,8 @@ class BaseHtml 'wbr' => 1, ]; /** - * @var array the preferred order of attributes in a tag. This mainly affects the order of the attributes - * that are rendered by [[renderTagAttributes()]]. + * @var array 标记中属性的首选顺序。这主要由 [[renderTagAttributes()]] + * 影响属性的顺序。 */ public static $attributeOrder = [ 'type', @@ -88,21 +88,21 @@ class BaseHtml 'media', ]; /** - * @var array list of tag attributes that should be specially handled when their values are of array type. - * In particular, if the value of the `data` attribute is `['name' => 'xyz', 'age' => 13]`, two attributes - * will be generated instead of one: `data-name="xyz" data-age="13"`. + * @var array 当其值为数组类型时应特别处理的标记属性列表。 + * 特别地,如果 `data` 属性的值为 `['name' => 'xyz', 'age' => 13]`, + * 将生成两个属性而不是一个:`data-name="xyz" data-age="13"`。 * @since 2.0.3 */ public static $dataAttributes = ['data', 'data-ng', 'ng']; /** - * Encodes special characters into HTML entities. - * The [[\yii\base\Application::charset|application charset]] will be used for encoding. - * @param string $content the content to be encoded - * @param bool $doubleEncode whether to encode HTML entities in `$content`. If false, - * HTML entities in `$content` will not be further encoded. - * @return string the encoded content + * 将特殊字符编码为 HTML 实体。 + * 这个 [[\yii\base\Application::charset|application charset]] 将用于编码。 + * @param string $content 编码内容 + * @param bool $doubleEncode 是否对 `$content` 中的 HTML 实体进行编码。如果是 false, + * `$content` 中的HTML实体将不会进一步编码。 + * @return string 编码内容 * @see decode() * @see http://www.php.net/manual/en/function.htmlspecialchars.php */ @@ -112,10 +112,10 @@ public static function encode($content, $doubleEncode = true) } /** - * Decodes special HTML entities back to the corresponding characters. - * This is the opposite of [[encode()]]. - * @param string $content the content to be decoded - * @return string the decoded content + * 将特殊的 HTML 实体解码回相应的字符。 + * 这与 [[encode()]] 相反。 + * @param string $content 要解码的内容 + * @return string 解码内容 * @see encode() * @see http://www.php.net/manual/en/function.htmlspecialchars-decode.php */ @@ -125,20 +125,20 @@ public static function decode($content) } /** - * Generates a complete HTML tag. - * @param string|bool|null $name the tag name. If $name is `null` or `false`, the corresponding content will be rendered without any tag. - * @param string $content the content to be enclosed between the start and end tags. It will not be HTML-encoded. - * If this is coming from end users, you should consider [[encode()]] it to prevent XSS attacks. - * @param array $options the HTML tag attributes (HTML options) in terms of name-value pairs. - * These will be rendered as the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]]. - * If a value is null, the corresponding attribute will not be rendered. + * 生成完整的 HTML 标记。 + * @param string|bool|null $name 标记名称。如果 $name 是 `null` 或者 `false`,相应的内容将在不带任何标记的情况下渲染。 + * @param string $content 要在开始和结束标记之间包含的内容。它将不会是 HTML 编码。 + * 如果来自最终用户,你应该考虑 [[encode()]] 它可以防止 XSS 攻击。 + * @param array $options HTML 标签属性(HTML 选项)就键值对而言。 + * 这些将作为结果标记的属性渲染。这些值将使用 [[encode()]] 进行 HTML 编码。 + * 如果这个值不存在,它将不渲染相应的属性。 * - * For example when using `['class' => 'my-class', 'target' => '_blank', 'value' => null]` it will result in the - * html attributes rendered like this: `class="my-class" target="_blank"`. + * 例如当使用 `['class' => 'my-class', 'target' => '_blank', 'value' => null]` + * 它将导致 html 属性渲染如下:`class="my-class" target="_blank"`。 * - * See [[renderTagAttributes()]] for details on how attributes are being rendered. + * 关于属性的渲染方式详情请参考 [[renderTagAttributes()]]。 * - * @return string the generated HTML tag + * @return string 生成 HTML 标记 * @see beginTag() * @see endTag() */ @@ -152,13 +152,13 @@ public static function tag($name, $content = '', $options = []) } /** - * Generates a start tag. - * @param string|bool|null $name the tag name. If $name is `null` or `false`, the corresponding content will be rendered without any tag. - * @param array $options the tag options in terms of name-value pairs. These will be rendered as - * the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]]. - * If a value is null, the corresponding attribute will not be rendered. - * See [[renderTagAttributes()]] for details on how attributes are being rendered. - * @return string the generated start tag + * 生成开始标记。 + * @param string|bool|null $name 标记名称。如果 $name 是 `null` 或者 `false`,相应的内容将在不带任何标记的情况下渲染。 + * @param array $options 以键值对表示的标记选项。 + * 这些将作为结果标记的属性渲染。这个值将使用 [[encode()]] 进行 HTML 编码。 + * 如果这个值不存在,它将不渲染相应的属性。 + * 关于属性是如何被渲染的细节请参考 [[renderTagAttributes()]]。 + * @return string 生成开始标记 * @see endTag() * @see tag() */ @@ -172,9 +172,9 @@ public static function beginTag($name, $options = []) } /** - * Generates an end tag. - * @param string|bool|null $name the tag name. If $name is `null` or `false`, the corresponding content will be rendered without any tag. - * @return string the generated end tag + * 生成结束标记。 + * @param string|bool|null $name 标记名称。如果 $name 是 `null` 或者 `false`,相应的内容将在不带任何标记的情况下渲染。 + * @return string 生成结束标记 * @see beginTag() * @see tag() */ @@ -188,13 +188,13 @@ public static function endTag($name) } /** - * Generates a style tag. - * @param string $content the style content - * @param array $options the tag options in terms of name-value pairs. These will be rendered as - * the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]]. - * If a value is null, the corresponding attribute will not be rendered. - * See [[renderTagAttributes()]] for details on how attributes are being rendered. - * @return string the generated style tag + * 生成样式标记。 + * @param string $content 样式内容 + * @param array $options 以键值对表示的标记选项。 + * 这些将作为结果标记的属性渲染。这些值将使用 [[encode()]] 进行 HTML 编码。 + * 如果值不存在,它将不渲染相应的属性。 + * 关于属性的渲染方式详情请参考 [[renderTagAttributes()]]。 + * @return string 生成样式标记 */ public static function style($content, $options = []) { @@ -202,13 +202,13 @@ public static function style($content, $options = []) } /** - * Generates a script tag. - * @param string $content the script content - * @param array $options the tag options in terms of name-value pairs. These will be rendered as - * the attributes of the resulting tag. The values will be HTML-encoded using [[encode()]]. - * If a value is null, the corresponding attribute will not be rendered. - * See [[renderTagAttributes()]] for details on how attributes are being rendered. - * @return string the generated script tag + * 生成脚本标记。 + * @param string $content 脚本内容 + * @param array $options 以键值对表示的标记选项。 + * 这些将作为结果标记的属性渲染。这些值将使用 [[encode()]] 进行 HTML 编码。 + * 如果值不存在,它将不渲染相应的属性。 + * 关于属性的渲染方式详情请参考 [[renderTagAttributes()]]。 + * @return string 生成脚本标记 */ public static function script($content, $options = []) { @@ -216,19 +216,19 @@ public static function script($content, $options = []) } /** - * Generates a link tag that refers to an external CSS file. - * @param array|string $url the URL of the external CSS file. This parameter will be processed by [[Url::to()]]. - * @param array $options the tag options in terms of name-value pairs. The following options are specially handled: + * 生成引用外部 CSS 文件的链接标记。 + * @param array|string $url 外部 CSS 文件的 URL。此参数将由 [[Url::to()]] 处理。 + * @param array $options 以键值对表示的标记选项。以下选项是专门处理的: * - * - condition: specifies the conditional comments for IE, e.g., `lt IE 9`. When this is specified, - * the generated `link` tag will be enclosed within the conditional comments. This is mainly useful - * for supporting old versions of IE browsers. - * - noscript: if set to true, `link` tag will be wrapped into `