lang 多语言列表

更新时间：2020-05-26 15:18:15 作者：米拓建站

## 概述：
通过`lang`标签，可循环调用系统中开启的多语言站点，一般在网站头部或底部显示，方便用户点击多语言列表进入对应的语言站点。
【注意】
- 添加的多语言站点需是开启状态，可参考[前台多语言](https://doc.metinfo.cn/metinfo/language/language_238_1.html "前台多语言")，添加并设置多语言站点；
- 系统多语言切换功能更需是开启状态，前台才能显示多语言站点列表，具体可参考[前台语言切换](https://doc.metinfo.cn/metinfo/language/language_240_1.html "前台语言切换")。

## 使用范围：
所有模板文件都可调用，常用于`head.php`或`foot.php`中。
## 类型：
数据标签，用于调用多语言站点列表的标签。
## 语法：

【说明】lang标签中的数据内容，可通过$v数组及对应的字段获取，具体可参考下方的`$v数组`。

## 标签原理：

lang标签是数据的集合，数据类型类似js的数组，获取到的数据就是多语言站点列表数据。
    lang标签的语法和js中的for函数类似，在lang标签的内部书写待渲染的html标签，$v为每个循环变量的别名，包含了每条内容的数据。
	
**lang标签：**

**for函数：**

for(i=0;i<list.length;i++){
    document.write(
    '<a href="'+list[i]['met_weburl']+'" title="'+list[i][name]+'">'+list[i][name]+'</a>'
    );
    }

总结：lang标签是后台返回数据的集合，类似于数组，在内部编写html代码，并使用$v变量来获取每个内容的数据，这样我们就可以得到一段动态的包含内容信息的html代码了。
## $v数组：
lang标签是一个数据的集合，调用多语言站点列表时，lang标签内部循环默认指定$v数组为循环变量的别名，从而调用更多的内容数据。
## 调用语法：`{$v.字段名称}`
例如：

<lang>
        <a href="{$v.met_weburl}" title="链接关键词">{$v.name}</a>//{$v.met_weburl}：多语言站点首页链接地址；{$v.name}：多语言站点语言名称
    </lang>

### $v数组中包含的字段：

|  字段名称 |  含义 |
| ------------ | ------------ |
| name  |  站点语言名称 |
| met_weburl  | 站点首页链接  |
| newwindows  |  站点首页链接打开方式（值为1时表示新窗口打开，值为0时表示当前窗口打开，默认为0） |
| mark  |  站点语言标识 |
| flag  |  站点语言对应国旗图片地址 |
|icon|菜单图标的类名|

## 示例：
### 头部导航如何调用语言栏切换列表
**场景案例：**在网站头部区块（head.php），根据网站开启的多语言站点个数来显示多语言切换按钮，要求如下：
1. 系统只开启一个语言站时，不显示多语言切换；
2. 开启两个语言站时，只显示另一个语言站点的链接；
3. 开启两个以上语言站点时，将除开当前语言站点之外的其他站点链接都列出来。

**模板代码：**

<lang></lang>//先获取语言栏列表数据，会输出列表内容条数的变量$sub
    <if value="$c['met_lang_mark'] && $sub gt 1">//通过if标签（if标签具体用法参考文档https://doc.metinfo.cn/mb/mbtag/85.html）判断$c['met_lang_mark']（系统会员注册开关，具体请参考文档https://doc.metinfo.cn/mb/mbtag/78.html）
    <div m-type="lang" m-id="lang">//m-type="lang" m-id="lang"：用于在可视化界面显示语言栏设置按钮，是必须要加的属性
        <if value="$sub eq 2">//通过if标签判断$sub（具体参考文档https://doc.metinfo.cn/mb/mbtag/109.html）系统开启的语言站点数是否为2，等于2则渲染以下代码
    <lang>//获取语言栏列表数据
    // $v包含了每条内容的所有数据，相当于一个数组，可以通过{$v.字段名}的方式来渲染内容数据
            <if value="$data['lang'] neq $v['mark']">//通过if标签判断$data['lang']（具体参考文档https://doc.metinfo.cn/mb/mbtag/76.html）当前站点语言标识不等于语言栏列表的语言标识时，就渲染该语言站点链接
            <a href="{$v.met_weburl}" title="{$v.name}" <if value="$v['newwindows']">target="_blank"</if>>//通过if标签判断$v['newwindows']该站点链接打开方式是否为1，是的话就渲染属性target="_blank",实现该语言站点新窗口打开的功能
                <img src="{$v.flag}" alt="{$v.name}" width="20" title="图片关键词">
                <span>{$v.name}</span>
            </a>
            </if>
        </lang>
        <elseif value="$sub gt 2"/>//通过elseif标签判断$sub（具体参考文档https://doc.metinfo.cn/mb/mbtag/109.html）系统开启的语言站点数是否为2，大于2则渲染以下代码
        <ul>
            <lang>//获取语言栏列表数据
        // $v包含了每条内容的所有数据，相当于一个数组，可以通过{$v.字段名}的方式来渲染内容数据
            <if value="$data['lang'] neq $v['mark']">//通过if标签判断$data['lang']（具体参考文档https://doc.metinfo.cn/mb/mbtag/76.html）当前站点语言标识不等于语言栏列表的语言标识时，就渲染该语言站点链接
            <a href="{$v.met_weburl}" title="{$v.name}" <if value="$v['newwindows'] eq 1">target="_blank"</if>>//通过if标签判断$v['newwindows']该站点链接打开方式是否为1，是的话就渲染属性target="_blank",实现该语言站点新窗口打开的功能
                <img src="{$v.flag}" alt="{$v.name}" width="20" title="图片关键词">
                {$v.name}
            </a>
            </if>
            </lang>
        </ul>
        </if>
    </div>
    </if>
    
【注意】实际编写时请去掉注释文字。

**前台页面输出HTML：**
假设系统开启了简体中文、English（设置了新窗口打开）站点，则前台输出代码如下：

<div m-type="lang" m-id="lang">
        <a href="index.php?lang=en" title="English" target="_blank">
            <img src="public/images/flag/en.gif" alt="English" width="20" title="图片关键词">
            <span>English</span>
        </a>
    </div>

假设系统开启了简体中文、English（设置了新窗口打开）、阿尔巴尼亚语三个站点，则前台输出代码如下：

<div m-type="lang" m-id="lang">
        <ul>
            <a href="index.php?lang=en" title="English" target="_blank">
                <img src="public/images/flag/en.gif" alt="English" width="20" title="图片关键词">
                <span>English</span>
            </a>
            <a href="index.php?lang=sq" title="阿尔巴尼亚语" target="_blank">
                <img src="public/images/flag/sq.gif" alt="阿尔巴尼亚语" width="20" title="图片关键词">
                <span>阿尔巴尼亚语</span>
            </a>
        </ul>
    </div>

文档中心

米拓学堂

帮助中心

在线交流

{"status":1,"html":"<style type=\"text\/css\">\r\n.onlinebox_three{border:2px solid;}\r\n.onlinebox_three .onlinebox_three_list{width: 160px;padding: 10px 0px;}\r\n.onlinebox_three .online-item{margin-bottom: 5px; padding: 0px 17px; position: relative;display: block;color: #666;}\r\n.onlinebox_three .online-item:last-child{margin-bottom: 0px;}\r\n.onlinebox_three .online-item:hover{background: #f8f8f8;}\r\n.onlinebox_three .online-item i{font-size: 16px;}\r\n.onlinebox_three .onlinebox-open{font-size: 22px;display:none;cursor: pointer;padding: 0 10px; font-size: 18px; line-height: 40px;}\r\n.onlinebox.min .onlinebox-open{display:block;padding:0 10px;background:#444;font-size:18px;line-height:40px;color:#fff}\r\n.onlinebox .onlinebox-min{position: relative;top:-4px;}\r\n@media (max-width: 767px){\r\n.onlinebox_three .online-item{font-size: 12px;padding-top: 6px;}\r\n.onlinebox_three .online-item i{font-size: 14px;}\r\n}\r\n<\/style>\r\n<div id='onlinebox'  class=\"onlinebox onlinebox_three hide\" m-type='online' m-id='online' style=\"border-color:#1baadb;\">\r\n    <div class=\"onlinebox-open\" style=\"background:#1baadb;\"><i class=\"fa fa-comments-o\"><\/i><\/div>\r\n    <div class=\"onlinebox-box\">\r\n        <div class=\"onlinebox-top\" style=\"background:#1baadb;\">\r\n            <div class=\"onlinebox-top-btn font-size-26\">\r\n                <a href=\"javascript:;\" class=\"onlinebox-close\" title=\"\">×<\/a>\r\n                <a href=\"javascript:;\" class=\"onlinebox-min\">-<\/a>\r\n            <\/div>\r\n            <h4>在线交流<\/h4>\r\n        <\/div>\r\n                                    <div class=\"met-editor onlinebox-bottom p-x-10 p-y-5\"><p style=\"text-align: center;\">\r\n    <img src=\"..\/upload\/202001\/1579417409303256.png\" data-width=\"120\" width=\"120\" data-height=\"120\" height=\"120\" title=\"\"\/>\r\n<\/p>\r\n<p style=\"text-align: center;\">\r\n    微信公众号\r\n<\/p>\r\n<p style=\"text-align:center;\">\r\n    <img src=\"..\/upload\/202001\/1579417452544806.png\" data-width=\"150\" width=\"150\" data-height=\"150\" height=\"150\" title=\"\"\/>\r\n<\/p>\r\n<p style=\"text-align: center;\">\r\n    QQ交流群\r\n<\/p><\/div>\r\n    <\/div>\r\n<\/div>","t":"4","x":"10","y":"130"}