Param要素のlabel、grouptitle属性について


"ConQuery xml プラグイン"のParam要素にはlabel属性とgrouptitle属性を指定する事が出来る。この属性がどのような意味を持つかは、文で説明するより実例を見た方が速いが、簡単に説明すると、同じname属性を持つParam要素が複数ある時、コンボボックスが作られ、その項目にlabel属性の値が用いられる(もしlabel属性がなければvalue属性の値が代わりに使われる。)。さらにgrouptitle要素が指定されていれば、コンボボックスのタイトルとして表示される(もしgrouptitle要素がなければ、name属性の値が代わりに使われる。)。
以下おそらくもっとも需要があるであろうgoogle用検索プラグインの例。右図にこのプラグインで表示されるUIの画像を貼っておく。
cqGoogle.xml

<?xml version="1.0"  encoding="UTF-8"?>
<ConQueryPlugin xmlns="http://geek.net.ru/en/opensource/conquery/">
<ShortName>Google</ShortName>
<Description>Google Search</Description>
<InputEncoding>UTF-8</InputEncoding>
<Image width="16" height="16">
data:image/x-icon;base64,AAABAAEAEBAAAAAAAABoBQAAFgAAACgAAAAQAAAAIAAAAAEACAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAACAAAAAgIAAgAAAAIAAgACAgAAAwMDAAICAgAAAAP8AAP8AAAD//wD/AAAA/wD/AP//AAD///8A//3/AP39/wD6/f8A+P3/AP/8/wD9/P8A+vz/AP/7/wD/+v8A/vr/APz6/wD4+v8A+/n/APP5/wD/+P8A+vj/AO/4/wDm+P8A2fj/AP/3/wD/9v8A9vb/AP/1/wD69f8A9PT/AO30/wD/8/8A//L/APnx/wD28P8A///+APj//gD2//4A9P/+AOP//gD//f4A6f/9AP///AD2//wA8//8APf9/AD///sA/v/7AOD/+wD/+vsA9/X7APr/+gDv/voA///5AP/9+QD/+/kA+e35AP//+ADm//gA4f/4AP/9+AD0+/gA///3APv/9wDz//cA8f/3AO3/9wD/8fcA//32AP369gDr+vYA8f/1AOv/9QD/+/UA///0APP/9ADq//QA///zAP/18wD///IA/fzyAP//8QD///AA9//wAPjw8AD//+8A8//vAP//7gD9/+4A9v/uAP/u7gD//+0A9v/tAP7/6wD/+eoA///pAP//6AD2/+gA//nnAP/45wD38eYA/fblAP/25AD29uQA7N/hAPzm4AD/690AEhjdAAAa3AAaJdsA//LXAC8g1gANH9YA+dnTAP/n0gDh5dIADyjSABkk0gAdH9EABxDRAP/l0AAAJs4AGRTOAPPczQAAKs0AIi7MAA4UywD56soA8tPKANTSygD/18kA6NLHAAAjxwDj28QA/s7CAP/1wQDw3r8A/9e8APrSrwDCtqoAzamjANmPiQDQj4YA35mBAOmefgDHj3wA1qR6AO+sbwDpmm8A2IVlAKmEYgCvaFoAvHNXAEq2VgA5s1UAPbhQAFWtTwBStU0ARbNNAEGxTQA7tEwAObZIAEq5RwDKdEYAULhDANtuQgBEtTwA1ls3ALhgMQCxNzEA2FsvAEC3LQB0MCkAiyYoANZTJwDLWyYAtjMlALE6JACZNSMAuW4iANlgIgDoWCEAylwgAMUuIAD3Vh8A52gdALRCHQCxWhwAsEkcALU4HACMOBwA0V4bAMYyGgCPJRoA218ZAJM7FwC/PxYA0msVAM9jFQD2XBUAqioVAIAfFQDhYRQAujMTAMUxEwCgLBMAnxIPAMsqDgCkFgsA6GMHALE2BAC9JQAAliIAAFYTAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8AsbGxsbGxsbGxsbGxsbGxd7IrMg8PDw8PDw8PUBQeJXjQYE9PcKPM2NfP2sWhcg+BzTE7dLjbmG03YWaV4JYye8MPbsLZlEouKRRCg9SXMoW/U53enGRAFzCRtNO7mTiAyliw30gRTg9VbJCKfYs0j9VmuscfLTFbIy8SOhA0Inq5Y77GNBMYIxQUJzM2Vxx2wEmfyCYWMRldXCg5MU0aicRUms58SUVeRkwjPBRSNIfBMkSgvWkyPxVHFIaMSx1/0S9nkq7WdWo1a43Jt2UqgtJERGJ5m6K8y92znpNWIYS1UQ89Mmg5cXNaX0EkGyyI3KSsp6mvpaqosaatq7axsQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=
</Image>
<showiftarget>{url}</showiftarget>
<showif>https?://[\w\.-]+(/[^/\s]+)/</showif>
<Url type="application/x-suggestions+json" method="GET" template="http://suggestqueries.google.com/complete/search?output=firefox&amp;client=firefox&amp;hl=ja&amp;qu={searchTerms}">
</Url>
<Url type="text/html" method="GET" template="http://www.google.com/search">
  <Param name="as_q" value="{searchTerms}" label="すべてのキーワード"/>
  <Param name="as_epq" value="{text}" label="フレーズ"/>
  <Param name="as_oq" value="{text}" label="いずれかのキーワード"/>
  <Param name="as_eq" value="{text}" label="キーワードを含めない"/>

  <Param name="lr" value="" label="すべての言語" grouptitle="対象言語"/>
  <Param name="lr" value="lang_ja" label="日本語"/>

  <Param name="as_sitesearch" value="{text}" label="無効" grouptitle="サイト内検索"/>
  <Param name="as_sitesearch" value="{host}" label="ドメイン"/>
  <Param name="as_sitesearch" value="{host}{matched:1}" label="サブディレクトリ"/>

  <Param name="as_qdr" value="all" label="指定なし" grouptitle="最終更新日"/>
  <Param name="as_qdr" value="d" label="24時間以内"/>
  <Param name="as_qdr" value="w" label="一週間以内"/>
  <Param name="as_qdr" value="m" label="一月以内"/>
  <Param name="as_qdr" value="m2" label="2ヶ月以内"/>
  <Param name="as_qdr" value="m3" label="3ヶ月以内"/>
  <Param name="as_qdr" value="m6" label="6ヶ月以内"/>
  <Param name="as_qdr" value="y"  label="一年以内"/>
  
  <Param name="num" value="" label="既定" grouptitle="表示件数"/>
  <Param name="num" value="10" label="10件ずつ"/>
  <Param name="num" value="20" label="20件ずつ"/>
  <Param name="num" value="30" label="30件ずつ"/>
  <Param name="num" value="50" label="50件ずつ"/>
  <Param name="num" value="100" label="100件ずつ"/>

  <Param name="as_occt" value="any" label="ページ全体" grouptitle="検索の対象"/>
  <Param name="as_occt" value="title" label="タイトルのみ"/>
  <Param name="as_occt" value="body"  label="本文のみ"/>
  <Param name="as_occt" value="url"   label="URLのみ"/>
  <Param name="as_occt" value="links" label="リンク内"/>

  <Param name="restrict" value="" label="指定無し" grouptitle="地域・トピック"/>
  <Param name="restrict" value="countryJP" label="日本"/>
  <Param name="restrict" value="linux" label="Linux"/>
  <Param name="restrict" value="microsoft" label="Microsoft"/>
  <Param name="restrict" value="mac" label="Apple"/>
  <Param name="restrict" value="bsd" label="BSD"/>
 
  <Param name="hl" value="" label="既定" grouptitle="表示言語"/>
  <Param name="hl" value="ja" label="日本語"/>
  <Param name="hl" value="en" label="英語"/>
</Url>

</ConQueryPlugin>


2008/06/15追記
書き直した物をConQuery検索プラグイン置場で公開。