パラメータリファレンス¶

パラメータとは¶

パラメータは、サジェスト設定タグに設定し、サジェストの動作をカスタマイズします。

指定が必要なパラメータと任意で設定するパラメータがあります。

パラメータの指定方法¶

パラメータは次の形式で指定します。

var poplink3 = {
  パラメータ名1: パラメータ値1,
  パラメータ名2: パラメータ値2,
  :
  パラメータ名n: パラメータ値n
};

パラメータの指定は、var poplink3 = { ... }; の中に配置してください。
パラメータ指定とパラメータ指定の間にはカンマを置いてください。
下記に例を示します。

// サジェスト設定タグ
var poplink3 = {
  uid: "[UID]",
  target: "#q",
  deviceType: "pc011"
};

パラメータ名¶

パラメータの名前を指定します。指定可能な全てのパラメータは、「パラメータ一覧」を参照してください。

パラメータ値¶

パラメータに与える値の種類は次のいずれかです。

値の種類	説明	値の例
数値	数値を表します。半角の数字、正負の符号、小数点で表します。引用符や二重引用符で囲まないでください	1234
真偽値	真または偽を表す値です。英小文字で true または false と指定してください。引用符や二重引用符で囲まないでください	true false
文字列	引用符または二重引用符で囲んだ文字列。HTML タグなどを含めないでください	"abc" 'abc'
関数	JavaScriptの関数オブジェクトを指定します	(省略)

パラメータ一覧¶

activateHook¶


データ型	関数オブジェクト
デフォルト	なし
説明	検索ボックスがフォーカスを得て、アクティブ状態にされたときに任意のプログラムを実行することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フックリファレンス」を参照してください。
用途	たとえば、スマートフォンでキーボードに隠れないようにするために、サジェストの起動時に、検索ボックスを画面上部にスクロールさせる等の用途が考えられます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

closeImage¶


データ型	文字列
デフォルト	"//poplink-f.probo.biz/pl3/images/close.png"
説明	sphs,spia など、スマートフォン用のデバイスタイプで使われる、サジェストを閉じるボタンの画像を URL で指定します。
用途	閉じるボタンの画像を、サジェスト標準のものではなく、ユーザー側で用意した画像を使用する場合に指定します。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

deviceNameHook¶


データ型	関数オブジェクト
デフォルト	なし
説明	デバイスの種類を決定します。deviceType パラメータに(文字列ではなく)オブジェクトを指定した場合にこのフックが呼び出されます。このパラメータの詳細は、「フックリファレンス」を参照してください。
用途	レスポンシブウェブデザインを採用したページにおいて、デバイスの判別ロジックがサジェストのものと異なるときに、このフックを使ってデバイスの種類を判別します。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

deviceType¶


データ型	文字列(またはオブジェクト)
デフォルト	"pc011"
説明	デバイスタイプを指定します。レスポンシブウェブデザインに基づいたページに設置する場合にはオブジェクトで指定します。詳しくは、「レスポンシブウェブデザインを用いたページへの導入」を参照してください。

displayItemAny1¶


データ型	真偽値
デフォルト	true (注意: デバイスタイプによっては、これ以外の値を持つものがあります)
説明	商品検索結果にユーザー定義データ1に設定されたデータを表示します。false を指定した場合、ユーザー定義1のデータは表示されません。

displayItemAny2¶


データ型	真偽値
デフォルト	true (注意: デバイスタイプによっては、これ以外の値を持つものがあります)
説明	商品検索結果にユーザー定義データ2に設定されたデータを表示します。false を指定した場合、ユーザー定義データ2のデータは表示されません。

displayItemAny3¶


データ型	真偽値
デフォルト	true (注意: デバイスタイプによっては、これ以外の値を持つものがあります)
説明	商品検索結果にユーザー定義データ3に設定されたデータを表示します。false を指定した場合、ユーザー定義データ3のデータは表示されません。

displayItemImage¶


データ型	真偽値
デフォルト	true (注意: デバイスタイプによっては、これ以外の値を持つものがあります)
説明	商品検索結果に商品画像を表示します。false を指定した場合、画像を表示しません。
用途	商品検索結果の商品画像を表示させない場合に使用します。

displayItemSummary¶


データ型	真偽値
デフォルト	true (注意: デバイスタイプによっては、これ以外の値を持つものがあります)
説明	商品検索結果に商品説明を表示します。false を指定した場合、商品説明を表示しません。
用途	商品検索結果の商品説明を表示させない場合に使用します。

displayItemTitle¶


データ型	真偽値
デフォルト	true (注意: デバイスタイプによっては、これ以外の値を持つものがあります)
説明	商品検索結果に商品名を表示します。false を指定した場合、商品名を表示しません。
用途	商品検索結果の商品名を表示させない場合に使用します。

displaySearchHeader¶


データ型	真偽値
デフォルト	true (注意: デバイスタイプによっては、これ以外の値を持つものがあります)
説明	商品検索結果に、商品表示の見出しを表示します。見出しは、SearchHeaderTextパラメータで指定されている文字列が使用されます。false を指定した場合、商品表示の見出しを表示しません。
用途	商品表示の見出しを表示させない場合に使用します。

displayTarget¶


データ型	文字列
デフォルト	なし
説明	サジェストの要素の親となる要素を、CSSセレクタで指定します。指定しなかった場合には、targetパラメータで指定した検索ボックスの直後に挿入されます。
用途	デザイン上の都合で、検索ボックスとは離れた場所にサジェストを表示したい場合に使用します。

gaType¶


データ型	文字列
デフォルト	なし
説明	Googleアナリティクスの種類を指定します。 "ga4", "ga4_gtm", "gtag" (グローバルサイトタグ), "universal" (ユニバーサルアナリティクス) のいずれかを指定します。詳しくは「Googleアナリティクスを用いた計測」を参照してください。
用途	Googleアナリティクスを用いてアクセス解析を行うときに使用します。
注意事項	GA4, ユニバーサルアナリティクス、グローバルサイトタグ以外の機能には対応していません。

id¶


データ型	文字列
デフォルト	なし
説明	サジェストの最上位の DOM 要素 (class="poplink" を持つ div 要素) に指定された文字列を値に持つ id 属性を設定します。
用途	複数のサジェストを 1 つのページに設置する場合に (必要に応じて) 使用します。この id 属性を CSS セレクタとして利用し、個々のサジェストに個別のスタイルを設定するのに利用できます。

inactivateHook¶


データ型	関数オブジェクト
デフォルト	なし
説明	サジェストが非表示にされたときに任意のプログラムを実行することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フックリファレンス」を参照してください。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります

loadCompleteHook¶


データ型	関数オブジェクト
デフォルト	なし
説明	サジェストがロードされ、利用可能状態になったときに任意のプログラムを実行することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フックリファレンス」を参照してください。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります

useSearch¶


データ型	真偽値
デフォルト	true (注意: デバイスタイプによっては、これ以外の値を持つものがあります)
説明	商品検索結果を表示します。false を指定した場合、商品検索結果を表示しません。
用途	商品検索結果を表示させないときに使用します。

searchAnchorFilter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品ページの URL の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
用途	遷移先の URL を変更する場合に使用します。たとえば、遷移先 URL にパラメータを付加してアクセス解析に用いたり、遷移先を動的に変更したりする場合などに使用できます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchAny1Filter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品検索結果のユーザー定義データ1の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
用途	ユーザー定義データ1の文字列を、データベースに格納されているものとは異なる表現で表示する場合に使用します。たとえば、数字のみで書かれた価格情報に、通貨等の情報を加えることができます。たとえば、「1250」という文字列を、「1,250円(税別)」のように変更して表示することができます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchAny1HTMLFilter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品検索結果のユーザー定義データ1の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。searchAny1Filter が文字列として編集するのに対して、searchAny1HTMLFilter は、HTML として編集します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
用途	ユーザー定義データ1の文字列を、HTML を使って装飾・表現する場合に使用します。たとえば、「1250」という文字列を、「定価:`<em>1,250</em>円`」のように HTML を用いて強調することができます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchAny2Filter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品検索結果のユーザー定義データ2の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
用途	ユーザー定義データ2の文字列を、データベースに格納されているものとは異なる表現で表示する場合に使用します。たとえば、数字のみで書かれた価格情報に、通貨等の情報を加えることができます。たとえば、「1250」という文字列を、「1,250円(税別)」のように変更して表示することができます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchAny2HTMLFilter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品検索結果のユーザー定義データ2の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。searchAny2Filter が文字列として編集するのに対して、searchAny2HTMLFilter は、HTML として編集します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
用途	ユーザー定義データ2の文字列を、HTML を使って装飾・表現する場合に使用します。たとえば、「1250」という文字列を、「定価:`<em>1,250</em>円`」のように HTML を用いて強調することができます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchAny3Filter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品検索結果のユーザー定義データ3の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
用途	ユーザー定義データ3の文字列を、データベースに格納されているものとは異なる表現で表示する場合に使用します。たとえば、数字のみで書かれた価格情報に、通貨等の情報を加えることができます。たとえば、「1250」という文字列を、「1,250円(税別)」のように変更して表示することができます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchAny3HTMLFilter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品検索結果のユーザー定義データ3の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。searchAny3Filter が文字列として編集するのに対して、searchAny3HTMLFilter は、HTML として編集します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
用途	ユーザー定義データ3の文字列を、HTML を使って装飾・表現する場合に使用します。たとえば、「1250」という文字列を、「定価:`<em>1,250</em>円`」のように HTML を用いて強調することができます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchAutoDisplay¶


データ型	真偽値
デフォルト	true (注意: デバイスタイプによっては、これ以外の値を持つものがあります)
説明	表示された1番目(最上段)の候補語を元に商品データを検索し、その結果を自動的に表示します。false を指定した場合は、エンドユーザーが候補語にフォーカスするまで商品検索結果を表示しません。
用途	商品検索結果が自動的に表示されるのを防ぐのに使用します。

searchClickHook¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品検索結果がクリックされたときに任意のプログラムを実行することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フックリファレンス」を参照してください。
用途	たとえば、クリックされた商品のデータをアクセス解析ツールへ送信するような用途が考えられます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchCount¶


データ型	数値
デフォルト	3(注意:デバイスタイプによっては、これ以外の値を持つものがあります)
説明	商品検索結果を表示する最大数を指定します。数値は 1 から 10 までの値を指定できます。
用途	表示する商品検索結果の数を変更するときに使用します。

searchHeaderText¶


データ型	文字列
デフォルト	"商品検索"
説明	商品表示の見出しに表示される文字列を指定します。文字列が 1 行に収まらない場合、改行して表示されます。SearchHeaderに false が指定されている場合は、商品表示の見出しを表示しません。
用途	商品表示の見出しを「商品検索」以外にする場合に使用します。

searchImageFilter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品画像の URL の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
用途	商品画像の URL を編集する場合に使用します。たとえば、商品画像 URL のスキームを変更・補完したり、アクセス解析のための識別子を付加したりする場合などに使用します。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchSummaryFilter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品説明の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchSummaryHTMLFilter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品説明の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。searchSummaryFilter が文字列として編集するのに対して、searchSummaryHTMLFilter は、HTML として編集します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchTitleFilter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品名の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
用途	商品名の表示を変更する場合に使用します。たとえば、商品名の前に語句や記号を追加する場合などに使用できます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchTitleHTMLFilter¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品名の文字列を任意のフィルタプログラムで編集することができます。パラメータに関数オブジェクトを指定します。searchTitleFilter が文字列として編集するのに対して、searchTitleHTMLFilter は、HTML として編集します。このパラメータの詳細は、「フィルタリファレンス」を参照してください。
用途	商品名の表示に HTML を用いて変更する場合に使用します。たとえば、商品名の前に HTML タグを含む語句や記号を追加する場合などに使用できます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

searchUpdateHook¶


データ型	関数オブジェクト
デフォルト	なし
説明	商品検索結果が更新されたときに任意のプログラムを実行することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フックリファレンス」を参照してください。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

suggestAutoDisplay¶


データ型	真偽値
デフォルト	false
説明	true を指定した場合、エンドユーザーが検索ボックスにフォーカスした際にデフォルト表示キーワードを表示します。このキーワードは、過去の利用統計やデータ作成者による表示キーワード登録ファイルから自動生成されます
用途	デフォルト表示キーワード機能を利用する際に使用します。

suggestAutoSubmit¶


データ型	真偽値
デフォルト	false
説明	true を指定した場合、候補語をクリックした場合、候補語を検索ボックスに転送したのち、検索ボックスが属するフォームをsubmitします。検索ボックスがFORM要素に属していない場合には何も起こりません。ページの構造によっては、suggestAutoSubmitではsubmitできない場合があります。その場合には、ページに合った方法でsubmitするフックスクリプトを作成し、suggestClickHookに設定してください。
用途	候補語をクリックすると同時に検索を実行する検索ボックスを作る際に使用します。この機能を用いると、Enterキーや「検索」ボタンを押す手間を省くことができます。この機能は主に、入力アシストのみを利用するデバイスタイプ (pcia および spia) とともに用いられます。

suggestClickHook¶


データ型	関数オブジェクト
デフォルト	なし
説明	候補語がクリックされたときに任意のプログラムを実行することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フックリファレンス」を参照してください。
用途	たとえば、クリックされた候補語のデータをアクセス解析ツールへ送信するような用途が考えられます。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

suggestCount¶


データ型	数値
デフォルト	5(注意:デバイスタイプによっては、これ以外の値を持つものがあります)
説明	候補語を表示する最大数を指定します。数値は 1 から 20 までの範囲で指定できます。
用途	表示される候補語の数を変えるときに使用します。

suggestUpdateHook¶


データ型	関数オブジェクト
デフォルト	なし
説明	候補語リストが更新されたときに任意のプログラムを実行することができます。パラメータに関数オブジェクトを指定します。このパラメータの詳細は、「フックリファレンス」を参照してください。
注意事項	このパラメータを使用した場合は、弊社からのサポートが提供されない場合があります。

target¶


データ型	文字列
デフォルト	なし
説明	検索ボックスの要素を CSS セレクタの書式で指定します。たとえば、`<inputid="q" type="text"/>` という要素を指定するには、target パラメータに #q と指定します。(先頭の # は、ID を指定することを示します。)
注意事項	このパラメータは、必ず指定しなければなりません。

uid¶


データ型	文字列
デフォルト	なし
説明	サービスの識別コード (UID) を指定します。UID は弊社よりお知らせいたします。
用途	このパラメータは、必ず指定しなければなりません。

useGATracking¶

非推奨


データ型	真偽値
デフォルト	false
説明	Google アナリティクスにサジェストのイベントを送信します。詳しくは、「Googleアナリティクスを用いた計測」を参照してください。
用途	Google アナリティクスを用いてアクセス解析を行うときに使用します。
注意事項	このパラメータは、gaTypeによって置き換えられました。引き続き利用可能ですが、今後は gaType を利用することを推奨します。ユニバーサルアナリティクス以外の機能には対応していません。

userStyleSheet¶


データ型	文字列
デフォルト	なし
説明	追加で読み込むスタイルシートの URL を指定します。サジェストの標準のスタイルシートを置き換えるのではなく、追加で読み込むことに注意してください。
用途	サジェストのスタイルを変更するときに使用します。

displayHistoryTrigger¶


データ型	文字列 ('' または 'empty' または 'always')
デフォルト	''
説明	入力履歴表示機能の表示モードを制御できます。 '': 入力履歴を表示しません。 'empty': 検索ボックスが空の時のみ表示します。 'always': 常に表示します。
用途	入力履歴の表示タイミングを変更したい場合に使用します。

inputHistoryCount¶


データ型	数値
デフォルト	5
説明	入力履歴表示機能で表示する入力履歴の個数を制御できます。
用途	入力履歴の表示個数を変更したい場合に使用します。

inputHistoryCookieName¶


データ型	文字列
デフォルト	'bst.ih.0'
説明	入力履歴を保存する Cookie の名前を指定できます。
用途	入力履歴を保存する Cookie の名前を変更したい場合に使用します。

inputHistoryLifetime¶


データ型	数値
デフォルト	2592000
説明	入力履歴を保存する Cookie の有効期限を指定できます。デフォルトは 30 日です。
用途	入力履歴を保存する Cookie の有効期限を変更したい場合に使用します。

deleteHistoryImage¶


データ型	文字列
デフォルト	'close.png'
説明	入力履歴の削除ボタンに使用する画像を指定できます。public な URL も指定可能です。
用途	入力履歴の削除ボタンに使用する画像を変更したい場合に使用します。

inputHistoryHeaderText¶


データ型	文字列
デフォルト	null
説明	入力履歴のヘッダーに表示するテキストを指定できます。null の場合、表示されません。
用途	入力履歴のヘッダーに表示するテキストを変更したい場合に使用します。

useCustomSuggestN¶


データ型	真偽値
デフォルト	false
説明	カスタムサジェスト機能を有効にします。
用途	カスタムサジェスト機能を有効にしたい場合に使用します。

customSuggestNCount¶


データ型	数値
デフォルト	5
説明	カスタムサジェスト機能で表示するサジェストの個数を指定できます。Nには 1 ~ 3 を指定できます。
用途	カスタムサジェスト機能で表示するサジェストの個数を変更したい場合に使用します。

customSuggestNHeaderText¶


データ型	文字列
デフォルト	null
説明	カスタムサジェスト機能で表示するヘッダーのテキストを指定できます。null の場合、表示されません。Nには 1 ~ 3 を指定できます。
用途	カスタムサジェスト機能で表示するヘッダーのテキストを変更したい場合に使用します。

suggestSkipSelect¶


データ型	真偽値
デフォルト	false
説明	true の場合、候補語が 1 度目のクリックで検索ボックスに反映されるようになります。このパラメータは sp 系デバイスタイプで使用できます。
用途	候補語が 1 度目のクリックで検索ボックスに反映されるようにしたい場合に使用します。