tag 招聘内容列表

更新时间：2022-09-26 16:24:51 作者：米拓建站

## 概述：

当tag标签的action参数值为`job.list`时，可循环调用招聘模块内容在当前栏目（招聘模块）列表页展示。
 
【注意】
- 招聘模块内容可参考“[内容管理](https://doc.metinfo.cn/metinfo/recruit/ "内容管理")”进行设置；
- 其他页面可通过[“指定栏目的内容列表list标签”](https://doc.metinfo.cn/mb/mbtag/65.html "“指定栏目的内容列表list标签”")调用招聘模块的内容列表。

## 使用范围：
仅在模板文件`job.php`中调用，调取当前招聘栏目的数据。

## 类型：
数据标签，用于调用数据的标签。

## 语法：
```html
<tag action="job.list" num="$c['met_job_list']" cid="$data['classnow']"></tag>// 内容列表标签，先获取招聘内容列表，列表变量为$result
<ul class="met-pager-ajax">// 列表的父元素必须加上类名met-pager-ajax，这是与列表分页按钮功能相关的
	<list data="$result" name="$v">
		<a href="{$v.url}" position="{$v.position}" title="链接关键词">{$v._position}</a>//通过$v数组调用内容数据
		...列表代码
	</list>
</ul>
```
【说明】
- tag标签中对应的参数及选项值可参考下面的`参数说明`；
- tag标签中的数据内容，可通过$v数组及对应的字段获取，具体可参考下方的`$v数组`。

## 标签原理：

tag标签是数据的集合，数据类型类似js的数组，通过action参数传入值不同来获取不同的数据，当`action`传参为`job.list`时，便可获得招聘模块的内容列表。
   tag标签的语法和js中的for函数类似，在tag标签的内部书写待渲染的html标签，$v为每个循环变量的别名，包含了每条内容的数据。

**tag标签：**

```html
<tag action="job.list" num="$c['met_job_list']" cid="$data['classnow']"></tag>// 内容列表标签，先获取招聘内容列表，列表变量为$result
<ul class="met-pager-ajax">// 列表的父元素必须加上类名met-pager-ajax，这是与列表分页按钮功能相关的
	<list data="$result" name="$v">
		<a href="{$v.url}" position="{$v.position}" title="链接关键词">{$v._position}</a>//通过$v数组调用内容数据
		...列表代码
	</list>
</ul>
```

**for函数：**

for(i=0;i<list.length;i++){
    document.write(
    '<a href="'+list[i]['url]+'" title="'+list[i]['title]+'">'+list[i]['_title]+'</a>'
    );
    }
	
总结：tag标签是后台返回数据的集合，类似于数组，在传入指定参数后会返回内容数据，在内部编写html代码，并使用$v变量来获取每个内容的数据，这样我们就可以得到一段动态的包含内容的html代码了。

## 参数说明：
tag标签，可通过传入不同的参数值，来调用对应的内容，以下为招聘模块内容列表（`job.list`）标签对应的参数选项值：

|参数名|是否必填|默认值|参数值说明|
|:----    |:-------    |:---|:---|
|action|是 |null|指定调用的方法(`job.list`)|
|num|是|默认为父级栏目或者系统设置的显示条数，此处应手动传入$c['met_job_list']——该变量的值可在可视化网站后台【[当前页设置](https://doc.metinfo.cn/metinfo/style/style576.html "当前页设置")】中自定义设置【列表显示条数】|列表页每页大显示条数|
|cid|否|`$data['classnow']`（当前列表页栏目id）|列表页栏目id|

## $v数组：

tag标签是一个数据的集合，当`action="job.list"`调用招聘模块内容列表时，tag标签内部循环需指定$v数组为循环变量的别名，从而调用更多的内容数据。
 
### 调用语法：`{$v.字段名称}`
例如：

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

| 名称  | 含义  |
| ------------ | ------------ |
|  id | 内容ID  |
| position  | 招聘职位  |
| _position  | 带自定义样式的招聘职位  |
|count|招聘人数|
|place|招聘地点|
|deal|职位薪资|
|content|详情内容|
|addtime|发布时间|
|url|自定义详情页的链接地址（链接至）|
| sub  |  用于判断数组长度|
| _index  |  当前内容的下标，从0开始|
| _first  |  用于判断是否为第一个|
| _last  |  用于判断是否为后一个|

## 示例：
### 如何调用当前栏目（招聘模块）的内容列表和招聘表单：
**场景案例：**招聘模块列表页，按栏目调用对应的内容列表，显示招聘职位、招聘人数、招聘地点、职位薪资、详情内容、发布时间、详情链接、应聘按钮和招聘表单。

**模板代码：**

<tag action="job.list" num="$c['met_job_list']" cid="$data['classnow']"></tag>// 内容列表标签，先获取招聘内容列表，列表变量为$result
    <ul class="met-pager-ajax">// 列表的父元素必须加上类名met-pager-ajax，这是与列表分页按钮功能相关的
    <list data="$result" name="$v">//内容列表$result相当于一个数组，可通过<list></list>标签渲染，具体参考list标签文档
    // $v包含了每条内容的所有数据，相当于一个数组，可以通过{$v.字段名}的方式来渲染内容数据
        <li>
            <h4><a href="{$v.url}" position="{$v.position}" title="链接关键词">{$v._position}</a></h4>
            <p>
                <span>{$v.addtime}</span>
                <span>{$v.place}</span>
                <span>{$v.count}</span>
                <span>{$v.deal}</span>
            </p>
            <div class="met-editor">// 调用通过编辑器编辑的内容所对应的字段，都要在内容的父元素上添加类名met-editor
                {$v.content}
            </div>
            <hr>
        <div class="card-body-footer m-t-0">
            <a class="btn btn-outline btn-squared btn-primary met-job-cvbtn" href="javascript:;" data-toggle="modal" data-target="#met-job-cv{$v._index}" data-jobid="{$v.id}" data-cvurl="cv.php?lang=cn&selected" title="链接关键词">在线应聘</a>// 应聘按钮的html，一定要按照这个格式来，不要删改，只能增加html
    </div>
    // 招聘表单的html，一定要按照这个格式来，不要删改，只能增加html
        <div class="modal fade modal-primary" id="met-job-cv{$v._index}">
            <div class="modal-dialog">
                <div class="modal-content">
                    <div class="modal-header">
                        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
                            <span aria-hidden="true">×</span>
                        </button>
                        <h4 class="modal-title">在线应聘</h4>
                    </div>
                    <div class="modal-body">
                        <tag action='job.form' cid="$v['id']"></tag>// 调用招聘表单，参考招聘表单标签文档，$v['id']为列表内容id
                    </div>
                </div>
            </div>
    </div>
    </li>
    </list>
    </ul>
    // 列表分页代码：列表下面加上以下固定格式的代码，即可渲染pc端和手机端的分页按钮，实现列表翻页的功能
    // pc端分页按钮
    <div class='m-t-20 text-xs-center hidden-sm-down' m-type="nosysdata">
        <pager/>// 分页标签，参考pager 列表页分页标签文档
    </div>
    // 手机端分页按钮
    <div class="met-pager-ajax-link hidden-md-up" data-plugin="appear" data-animate="slide-bottom" data-repeat="false" m-type="nosysdata">
         <button type="button" class="btn btn-primary btn-block btn-squared ladda-button" id="met-pager-btn" data-plugin="ladda" data-style="slide-left" data-url="" data-page="1">
              <i class="icon wb-chevron-down m-r-5" aria-hidden="true"></i>
          </button>
    </div>

【注意】
- 需结合招聘表单([job.form ](https://doc.metinfo.cn/mb/mbtag/103.html "job.form "))标签使用；
- 列表页必须添加分页，电脑端与手机端分页功能实现方式不同；
- 实际编写时请去掉注释文字。

**前台页面输出HTML：**

<ul class="met-pager-ajax">
    <li>
        <h4><a href="../job/showjob.php?lang=cn&id=2" position="市场开拓主任" title="链接关键词"><span>市场开拓主任</span></a></h4>
        <p>
            <span>2018-01-11</span>
            <span>长沙</span>
            <span>1</span>
            <span>10K+</span>
        </p>
        <hr>
        <div class="met-editor">
            职位详情介绍
    </div>
        <hr>
        <div class="card-body-footer m-t-0">
            <a class="btn btn-outline btn-squared btn-primary met-job-cvbtn" href="javascript:;" data-toggle="modal" data-target="#met-job-cv0" data-jobid="2" data-cvurl="cv.php?lang=cn&selected" title="链接关键词">在线应聘</a>
        </div>
        <div class="modal fade modal-primary" id="met-job-cv0">
            <div class="modal-dialog">
                <div class="modal-content">
                    <div class="modal-header">
                        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
                            <span aria-hidden="true">×</span>
                        </button>
                        <h4 class="modal-title">在线应聘</h4>
                    </div>
                    <div class="modal-body">
                        <form method="POST" class="met-form" enctype="multipart/form-data" action="../job/save.php?id=43">
                        ...//表单各参数对应的html，此处不列举，具体请参考页面实际代码
                        </form>
                    </div>
                </div>
            </div>
        </div>
    </li>
    // 实际可能有多条，此处示例只列出一条内容
    </ul>
    <div class="m-t-20 text-xs-center hidden-sm-down" m-type="nosysdata">
        <div class="met_pager">
            <span class="PreSpan editable-click" met-id="17" met-table="language" met-field="value">上一页</span>
            <a href="../job/job.php?class1=3&pageset=1" class="Ahover" title="链接关键词">1</a>
            <a href="../job/index.php?class1=3&page=2&pageset=1" title="链接关键词">2</a>
            <a href="../job/index.php?class1=3&page=2&pageset=1" class="NextA" title="链接关键词">下一页</a>
            <span class="PageTextk">转至第</span>
            <input type="text" id="metPageT" data-pageurl="index.php?lang=cn&class1=3&page=|&pageset=1|2" value="1">
            <input type="button" id="metPageB" value="页">
        </div>
    </div>
    <div class="met-pager-ajax-link hidden-md-up" data-plugin="appear" data-animate="slide-bottom" data-repeat="false" m-type="nosysdata">
        <button type="button" class="btn btn-primary btn-block btn-squared ladda-button" id="met-pager-btn" data-plugin="ladda" data-style="slide-left" data-url="" data-page="1"> <i class="icon wb-chevron-down m-r-5" aria-hidden="true"></i>
        </button>
    </div>
    
### 招聘模块详情页如何调用招聘职位内容、招聘表单：
**场景案例：**在招聘模块详情页展示招聘职位内容、招聘表单。
详情页的招聘内容都在变量$data中，调用招聘内容时通过{$data.内容字段名}的方式调取，具体的字段名参考上面的$v数组。

**模板代码：**

<div>
        <h4>{$data.position}</h4>
        <p>
            <span>{$data.addtime}</span>
            <span>{$data.place}</span>
            <span>{$data.count}</span>
            <span>{$data.deal}</span>
        </p>
        <div class="met-editor">// 调用通过编辑器编辑的内容所对应的字段，都要在内容的父元素上添加类名met-editor
            {$data.content}
        </div>
        <hr>
        <div class="card-body-footer m-t-0">
            <a class="btn btn-outline btn-squared btn-primary met-job-cvbtn" href="javascript:;" data-toggle="modal" data-target="#met-job-cv1" data-jobid="{$data.id}" data-cvurl="cv.php?lang=cn&selected" title="链接关键词">在线应聘</a>// 应聘按钮的html，一定要按照这个格式来，不要删改，只能增加html
        </div>
        // 招聘表单的html，一定要按照这个格式来，不要删改，只能增加html
        <div class="modal fade modal-primary" id="met-job-cv1">
            <div class="modal-dialog">
                <div class="modal-content">
                    <div class="modal-header">
                        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
                            <span aria-hidden="true">×</span>
                        </button>
                        <h4 class="modal-title">在线应聘</h4>
                    </div>
                    <div class="modal-body">
                        <tag action='job.form' cid="$data['id']"></tag>// 调用招聘表单，参考招聘表单标签文档，$data['id']为当前页内容id
                    </div>
                </div>
            </div>
        </div>
    </div>

【注意】
- 需结合招聘表单([job.form ](https://doc.metinfo.cn/mb/mbtag/103.html "job.form "))标签使用；
- 实际编写时请去掉注释文字。

**前台页面输出HTML：**

<div>
        <h4>市场开拓主任</h4>
        <p>
            <span>2018-01-11</span>
            <span>长沙</span>
            <span>1</span>
            <span>10K+</span>
        </p>
        <hr>
        <div class="met-editor">
            职位详情介绍
    </div>
        <hr>
        <div class="card-body-footer m-t-0">
            <a class="btn btn-outline btn-squared btn-primary met-job-cvbtn" href="javascript:;" data-toggle="modal" data-target="#met-job-cv1" data-jobid="2" data-cvurl="cv.php?lang=cn&selected" title="链接关键词">在线应聘</a>
        </div>
        <div class="modal fade modal-primary" id="met-job-cv1">
            <div class="modal-dialog">
                <div class="modal-content">
                    <div class="modal-header">
                        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
                            <span aria-hidden="true">×</span>
                        </button>
                        <h4 class="modal-title">在线应聘</h4>
                    </div>
                    <div class="modal-body">
                        <form method="POST" class="met-form" enctype="multipart/form-data" action="../job/save.php?id=43">
                        ...//表单各参数对应的html，此处不列举，具体请参考页面实际代码
                        </form>
                    </div>
                </div>
            </div>
        </div>
    </div>
	
	
### 其他页面如何调用招聘模块列表的职位内容、招聘表单：
**场景案例：**首页调用指定栏目（招聘模块）的内容列表，显示内容标题、招聘参数。
调用指定栏目的内容列表，需先获取栏目id：可参考教程“[如何获取栏目ID？](https://doc.metinfo.cn/mb/faq/102.html "如何获取栏目ID？")”

**模板代码：**

<ul>// 信息列表用ul、li标签的格式，可根据自己需求修改
        <tag action="list" cid="43" >// 调用指定栏目的内容列表
        // 将获取到栏目id填入到cid参数中，cid参数的值可以是模板中自定义的变量（https://doc.metinfo.cn/mb/mb/28.html ），例如$lang[‘index_product_id’]
        // $v包含了每条信息的所有数据，相当于一个数组，可以通过{$v.字段名}的方式来渲染信息数据
        <li>
            <h4><a href="{$v.url}" position="{$v.position}" title="链接关键词">{$v._position}</a></h4>
            <p>
                <span>{$v.addtime}</span>
                <span>{$v.place}</span>
                <span>{$v.count}</span>
                <span>{$v.deal}</span>
            </p>
            <div class="met-editor">// 调用通过编辑器编辑的内容所对应的字段，都要在内容的父元素上添加类名met-editor
                {$v.content}
            </div>
            <hr>
            <div class="card-body-footer m-t-0">
                <a class="btn btn-outline btn-squared btn-primary met-job-cvbtn" href="javascript:;" data-toggle="modal" data-target="#met-job-cv{$v._index}" data-jobid="{$v.id}" data-cvurl="cv.php?lang=cn&selected" title="链接关键词">在线应聘</a>// 应聘按钮的html，一定要按照这个格式来，不要删改，只能增加html
        </div>
        // 招聘表单的html，一定要按照这个格式来，不要删改，只能增加html
            <div class="modal fade modal-primary" id="met-job-cv{$v._index}">
                <div class="modal-dialog">
                    <div class="modal-content">
                        <div class="modal-header">
                            <button type="button" class="close" data-dismiss="modal" aria-label="Close">
                                <span aria-hidden="true">×</span>
                            </button>
                            <h4 class="modal-title">在线应聘</h4>
                        </div>
                        <div class="modal-body">
                            <tag action='job.form' cid="$v['id']"></tag>// 调用招聘表单，参考招聘表单标签文档，$v['id']为列表内容id
                        </div>
                    </div>
                </div>
        </div>
        </li>
        </tag>
        </ul>

【注意】
- 需结合[指定栏目的内容列表list标签](https://doc.metinfo.cn/mb/mbtag/65.html  "指定栏目的内容列表list标签")使用；
- 需结合[招聘表单job.form标签](https://doc.metinfo.cn/mb/mbtag/103.html "招聘表单job.form标签")使用；
- 实际编写时请去掉注释文字。

**前台页面输出HTML：**

<ul>
    <li>
        <h4><a href="job/showjob.php?lang=cn&id=2" position="市场开拓主任" title="链接关键词"><span>市场开拓主任</span></a></h4>
        <p>
            <span>2018-01-11</span>
            <span>长沙</span>
            <span>1</span>
            <span>10K+</span>
        </p>
        <hr>
        <div class="met-editor">
            职位详情介绍
    </div>
        <hr>
        <div class="card-body-footer m-t-0">
            <a class="btn btn-outline btn-squared btn-primary met-job-cvbtn" href="javascript:;" data-toggle="modal" data-target="#met-job-cv0" data-jobid="2" data-cvurl="cv.php?lang=cn&selected" title="链接关键词">在线应聘</a>
        </div>
        <div class="modal fade modal-primary" id="met-job-cv0">
            <div class="modal-dialog">
                <div class="modal-content">
                    <div class="modal-header">
                        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
                            <span aria-hidden="true">×</span>
                        </button>
                        <h4 class="modal-title">在线应聘</h4>
                    </div>
                    <div class="modal-body">
                        <form method="POST" class="met-form" enctype="multipart/form-data" action="../job/save.php?id=43">
                        ...//表单各参数对应的html，此处不列举，具体请参考页面实际代码
                        </form>
                    </div>
                </div>
            </div>
        </div>
    </li>
    // 实际可能有多条，此处示例只列出一条内容
    </ul>