「ver4/関数リファレンス/title」を編集中

## 説明
メタタグのtitleを出力する。<br>
ページタイトルとして文字列のみ出力したい場合は、<a href="http://wiki.basercms.net/ver4/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/contentsTitle">contentsTitle()</a>を使用する。


## 使い方
<syntaxhighlight lang="php">
<?php $this->BcBaser->title( [$separator] , [$options] ); ?>
</syntaxhighlight>

## パラメーター
(string) $separator
: 階層の区切り文字を指定する。
: - 初期値 = '｜'

(array) $options
:`categoryTitleOn` : カテゴリを表示するかを boolean で指定。falseで表示しない。（初期値 = null）
:`tag` : タグが記述されていた場合、どのように扱うかを boolean で指定。trueでエンコードして出力、falseで除去する。（初期値 = true）
:`allowableTags` : tagがfalseだった場合、**除去しないタグ**をPHPの[strip_tags](http://php.net/manual/ja/function.strip-tags.php)の書式で指定。（初期値 = （空））

以下、ソースより引用

> version 3.0.10 より第2引数 $categoryTitleOn は、 $options にまとめられました。  
> 後方互換のために第2引数に配列型以外を指定された場合は、 $categoryTitleOn として取り扱います。

## 用例

### 基本
タイトルタグを出力する。

####コード
<syntaxhighlight lang="php">
<?php $this->BcBaser->title() ?>
</syntaxhighlight>

####出力
<syntaxhighlight lang="html5">
<title>コンテンツタイトル  | カテゴリ| サイト名</title>
</syntaxhighlight>

### 応用
階層を：区切りで表示、カテゴリーを表示しない、タグを除去（&lt;srtong&gt;は除去しない）でタイトルタグを出力する。<br>
例）タイトルが**&lt;em&gt;サービス&lt;/em&gt;&lt;strong&gt;１&lt;/strong&gt;**、カテゴリーが**サービス**、サイト名が**baserCMS inc.**だった場合

####コード
<syntaxhighlight lang="php">
<?php
    $args = array(
        'categoryTitleOn' => false,
        'tag' => false,
        'allowableTags' => '<strong>'
    );
    $this->BcBaser->title(' : ', $args);
?>
</syntaxhighlight>

####出力

<syntaxhighlight lang="html5">
<title>サービス<strong>１</strong> : baserCMS inc.</title>
</syntaxhighlight>

## 注

## 変更履歴

### 2018-06-04

- version 3.0.10以降の第二引数の解説を追加

## ソースファイル

https://github.com/baserproject/basercms/blob/master/lib/Baser/View/Helper/BcBaserHelper.php

## 関連資料

##類似の関数
- [getContentsTitle](/ver4/関数リファレンス/getContentsTitle) - コンテンツタイトルを取得する
- [contentsTitle](/ver4/関数リファレンス/contentsTitle) - コンテンツのタイトルを出力する
- [getTitle](/ver4/関数リファレンス/getTitle) - タイトルタグを取得する

[[Category:関数リファレンス]]