zudolab jqAutoHideGuideText

概要

zudolab jqAutoHideGuideTextは、
input[@type=text]、textareaにガイドテキスト機能を実装します。
jQueryプラグインとして動作します。

著者

高津戸壮 (Takazudo) [website] [mail]

使用方法

基本セットアップ例

  1. jQuery、"jqAutoHideGuideText.js" を読み込みます。
  2. 下記例のように、input要素(もしくはtextarea要素)と、ガイドテキストを指定します。

    new AutoHideGuideText({
        input: "#query",
        guideText: "search word"
    });
    <input type="text" size="30" id="query" />

    input要素に何も入力されておらず、フォーカスが当たっていない状態の間(以降、ガイドモードと呼びます)のみ、valueにガイドテキストが指定されます。
    この時、class "guideMode"がその要素に付加されます。
    フォーカスが外れると、このclass指定は取り除かれます。

空サブミット回避機能

フォーム要素の指定を追加することで、
ガイドモードになっているときの空サブミットを防止できます。

new AutoHideGuideText({
    input: "#query",
    form: "#searchForm",
    guideText: "search word"
});
<form method="get" action="http://example.com/" id="searchForm">
    <input type="text" size="30" name="query" id="query" />
    <input type="submit" value="search" />
</form>

例えば、ガイドテキストに"search word"と指定した場合、
何も入力されていない状態でフォームがサブミットされると、
"search word"というクエリが送信されてしまいます。
上記例だと、http://example.com は、query="search word"を受け取るはずです。
フォーム要素の指定を追加すると、このようなサブミットを防止できます。

対象ブラウザ

このスクリプトは、以下のブラウザで動作します。

  • Internet Explorer 6+
  • Firefox 2+
  • Safari 2.0.4+
  • Opera 9.6+

このスクリプトが動作しないブラウザを見つけたら、ご報告していただけると幸いです。
(古いブラウザをサポートすることはできませんが)

依存スクリプト

このスクリプトは、jQuery1.2.6を利用して作られています。
新しいバージョンのjQueryで動かないなどありましたら、ご報告していただけると幸いです。

ライセンス

このスクリプトは、MITライセンスの元に配布します。
著作者のクレジットを明記する場合に限り、商用、非商用問わず、自己責任で自由にご利用いただけます。

更新ログ

date version notes
2009/1/5 1 初版リリース

FAQ

何か不明な点があればお問い合わせください。 takazudo@gmail.com