ゼロと無限の間に

フリーでオープンソースなJavaScriptとかPHPとか。

ユーザ用ツール

サイト用ツール


javascript:yahho-calendar

文書の過去の版を表示しています。


YUIのJavaScriptカレンダーを日本語化&ポップアップ対応&祝日も表示 - Yahho Calendar

コメントと更新履歴の参照はゼロと無限の間のログ » Yahho Calendarでどうぞ。

Webのformで日付を入力する際に日付の選択をしやすくするためのポップアップカレンダー(Datepikcer)を表示するJavaScriptライブラリです。別Windowで開くのではなく、form上に表示します。(サンプルを見てもらうと分かりやすいと思います。)

カレンダーはYUI 2(Yahoo! UI Library version 2)のカレンダーを日本語を含む多国語化してポップアップ対応にしたものです。
また、これと合わせてGCalendar Holidaysを使うとカレンダー上に祝日の表示もできてます。

Yahoo!の日本版ということでヤッホーという名前にしました。(昔、Yahho!てサイトありましたね。)

サンプル

ライセンス

Yahho CalendarはMITライセンスで。
内部的に使っているYUIはBSDライセンスです。

YahhoCal.loadYUI()を使うと、デフォルトではGoogleによってホスティングされているYUIのファイルがロードされます。これを使う場合はGoogle Hosted Librariesもご確認ください。)

また、祝日を表示する場合はGoogle Calendar API Terms of Serviceもご確認ください。(参考:GCalendar Holidaysのライセンス

ダウンロード

yahho-calendar.js

YahhoCal.css バージョン0.3.0からCSSは不要(JavaScript内で設定)になりました。8-)

また、祝日を表示するにはGCalendar Holidaysも必要です。

※ダウンロードのリンク先が最新のBeta版の場合あり

Yahho Calendarの使い方の例

  1. まずは、Yahho CalendarのJavaScriptファイルを読み込みます。祝日も表示するなら一緒にGCalendar Holidaysも読み込んでください。(パスは環境に合わせて変えてください。)
    <script type="text/javascript" src="/path/to/your/yahho-calendar.js"></script>
    <script type="text/javascript" src="/path/to/your/gcalendar-holidays.js"></script>
  2. 次に、YUIのJavaScriptとCSSをロードします。
    <script type="text/javascript">
    YahhoCal.loadYUI(); //Googleのサーバから読み込む場合
     
    //YahhoCal.loadYUI("/path/to/your/yui/dir/"); //自分のサーバから読み込む場合。パスは環境に合わせて変更してください
    </script>
  3. あとは、onclickやonfocusなどのトリガーからYahhoCal.render()を呼べば、カレンダーを表示できます。パラメータとして、日付を入力する要素のid属性を渡してください。
    • 例1:日付をテキストボックス1つに入力する場合の例。(日付の表示形式は“yyyy/m/d”です。)
      <input type="text" id="inputId" name="inputDate" onclick="YahhoCal.render(this.id);" />
    • 例2:日付をテキストボックス3つ(年・月・日)に入力する場合の例。
      <input type="text" id="inputY" name="y" /><input type="text" id="inputM" name="m" /><input type="text" id="inputD" name="d" /><input type="button" value="カレンダーを表示する" onclick="YahhoCal.render('inputY', 'inputM', 'inputD');" />
    • 例3:日付を選択リスト3つ(年・月・日)で選択する場合の例。
      <select id="selY" name="y"><option>2006</option><option>2007</option><option>2008</option></select><select id="selM" name="m"><option>1</option> (中略) <option>12</option></select><select id="selD" name="d"><option>1</option> (中略) <option>31</option></select><input type="button" value="表示" onclick="YahhoCal.render('selY', 'selM', 'selD');" />

Yahho Calendar API リファレンス

YahhoCal.render(inputId, monthId, dateId, insertId)

  • 概要
    • カレンダーを表示する。
  • パラメータ
    • inputId, monthId, dateId :
      • 日付を1つのテキストボックスに入力する場合
        • inputIdにはテキストボックスのid属性を渡す。monthId・dateIdには何も渡さない。
      • 日付を年・月・日に分けて3つのテキストボックスまたは選択リストに入力する場合
        • それぞれのテキストボックスまたは選択リストに対応させて、inputIdには年のid属性、monthIdには月のid属性、dateIdには日のid属性を渡す
    • insertId : 省略可。カレンダーを表示する場所のid属性。これを指定しない場合、inputIdの場所にカレンダーを表示する
  • 戻り値
    • カレンダーを表示できたかどうか(true or false)

YahhoCal.loadYUI(yuiBase, callback)

  • 概要
    • Yahho Calendarで必要なYUIのファイル(JavaScriptとCSS)をGoogleのWebサーバから読み込む。
  • パラメータ
    • yuiBase : 省略可。省略すると、GoogleのサーバからYUIをロードする。自分のサーバからYUIをロードする場合、YUIへのURLのベースとなる部分を渡す
    • callback : 省略可。YUIロード後に実行するコールバック関数
  • 戻り値
    • 無し

YahhoCal.setMondayAs1st()

  • 概要
    • カレンダーの週の初めを月曜日にする。(デフォルトは日曜日。)
    • 週の初めを月曜日にしたい場合、カレンダーを表示する前にこのfunctionを実行する必要がある。
  • 戻り値
    • 無し

YahhoCal.setMinDate()

  • 概要
    • 指定した日より前の日付をカレンダーで選択できないようにする
  • パラメータ
    • y : 年(西暦4桁)
    • m : 月(1~12)
    • d : 日

YahhoCal.setMaxDate()

  • 概要
    • 指定した日より後の日付をカレンダーで選択できないようにする
  • パラメータ
    • y : 年(西暦4桁)
    • m : 月(1~12)
    • d : 日

YahhoCal.locale

  • 言語を指定するプロパティ
  • 下記の言語から選択できる
    • en (英語)
    • ja (日本語)
    • ko (韓国語)
    • zh (中国語。簡体字も繁体字も同じ)
    • es (スペイン語)
    • pt (ポルトガル語)

YahhoCal.format

  • 選択された日付をテキストボックスに貼り付ける場合の日付表記の形式を設定するプロパティ
  • 子プロパティとして下記のプロパティがある
    • delimiter : 年月日の区切り文字
    • padZero : 月や日が1桁の場合に左側にゼロ埋めをするかどうか(true or false)

YahhoCal.holidays

  • GCalendar Holidaysを使ってGoogleカレンダーの祝日(または他のスケジュール)を表示する場合の設定をするプロパティ
  • 子プロパティとして下記のプロパティがある
    • delimiter : 複数のスケジュールを表示する場合の区切り文字
    • prefixes : スケジュールの前に付ける文字列

YahhoCal.isPopup

  • カレンダーをポップアップとして表示するかどうかを設定するプロパティ(true or false)

ソースコード

/**
 *  Yahho Calendar - Japanized (and actually multilingual) Datepicker
 *  @see       http://0-oo.net/sbox/javascript/yahho-calendar
 *  @version   0.4.6
 *  @copyright 2008-2011 dgbadmin@gmail.com
 *  @license   http://0-oo.net/pryn/MIT_license.txt (The MIT license)
 *
 *  See also
 *  @see http://developer.yahoo.com/yui/calendar/
 *  @see http://developer.yahoo.com/yui/docs/YAHOO.widget.Calendar.html
 */
 
var YahhoCal = {
    /**
     *  loadYUI()で読み込むYUIのURL
     *  @see http://developer.yahoo.com/yui/articles/hosting/
     *  @see http://code.google.com/intl/en/apis/libraries/devguide.html#yui
     */
    YUI_URL: {
        SERVER: location.protocol + "//ajax.googleapis.com/ajax/libs/yui/",
        VERSION: "2",   //2.x系の最新を使う
        DIR: "/build/"
    },
 
    /** カレンダーの見た目の設定 */
    CAL_STYLE: {
        //幅(IE6で縮まるのを防ぐ)
        "": "width: 13em",
        //日曜日
        "td.wd0 a": "background-color: #fcf",
        //土曜日
        "td.wd6 a": "background-color: #cff",
        //祝日(要 GCalendar Holidays)
        "td.holiday0 a": "background-color: #f9f",
        //今日(デフォルトではa要素の周り1pxに背景色が見えるので黒い枠線になる)
        "td.today": "",     //デフォルトは背景色:黒
        "td.today a": "",   //デフォルトは背景色:白(ただし土日祝日の背景色が優先)
        //選択された日
        "td.selected a": "background-color: #0f0",
        //選択可能な日付の範囲外の日(今日が黒くなるのを防ぐ)
        "td.previous": "background-color: #fff"
    },
 
    /** 地域(YUI_CAL_CONFIGのどれを使うかの指定) */
    locale: "ja",
 
    /** YUIカレンダー設定 */
    YUI_CAL_CONFIG: {
        //英語
        en: {},
        //日本語
        ja: {
            my_label_year_position: 1,
            my_label_year_suffix: "年 ",
            my_label_month_suffix: "月",
            months_long: ["1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"],
            weekdays_short: ["日", "月", "火", "水", "木", "金", "土"]
        },
        //韓国語
        ko: {
            my_label_year_position: 1,
            my_label_year_suffix: "&#xb144; ",
            my_label_month_suffix: "&#xc6d4;",
            months_long: ["1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"],
            weekdays_short: [
                "&#xc77c;", "&#xc6d4;", "&#xd654;", "&#xc218;", "&#xbaa9;",
                "&#xae08;", "&#xd1a0;"
            ]
        },
        //中国語(繁体字も簡体字も同じ)
        zh: {
            my_label_year_position: 1,
            my_label_year_suffix: "年 ",
            my_label_month_suffix: "月",
            months_long: ["1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"],
            weekdays_short: ["日", "一", "二", "三", "四", "五", "六"]
        },
        //スペイン語
        es: {
            months_long: [
                "enero", "febrero", "marzo", "abril", "mayo", "junio",
                "julio", "agosto", "septiembre", "octubre", "noviembre", "diciembre"
            ],
            weekdays_short: ["do", "lu", "ma", "mi", "ju", "vi", "sa"]
        },
        //ポルトガル語
        pt: {
            months_long: [
                "Janeiro", "Fevereiro", "Março", "Abril", "Maio", "Junho",
                "Julho", "Agosto", "Setembro", "Outubro", "Novembro", "Dezembro"
            ],
            weekdays_short: ["Do", "Se", "Te", "Qu", "Qu", "Se", "Sa"]
        }
    },
 
    //テキストボックスでの日付フォーマット
    format: {
        delimiter: "/", //区切り文字
        padZero: false  //ゼロ埋めするかどうか
    },
 
    //祝日(またはその他のGoogleカレンダー)のツールチップ表示
    holidays: {
        //同じ日に複数の祝日がある場合の区切り文字(改行可能なのはIEのみ)
        delimiter: ",\n",
        //祝日名の前に付ける文字列(カレンダーごとに設定可能)
        prefixes: [""]
    },
 
    //ポップアップ表示かどうか
    isPopup: true
};
/**
 *  カレンダーを表示する
 *  @param  String  inputId     入力要素のid or 年の入力要素のid
 *  @param  String  monthId     (optional) 月の入力要素のid
 *  @param  String  dateId      (optional) 日の入力要素のid
 *  @param  String  insertId    (optional) カレンダーを表示したい場所の要素のid
 *  @return Boolean カレンダーの表示ができたかどうか
 */
YahhoCal.render = function(inputId, monthId, dateId, insertId) {
    if (!window.YAHOO || !YAHOO.widget.Calendar) {  //YUIを読み込んでいない場合
        return false;
    }
 
    this._currentId = (insertId = (insertId || inputId));   //表示場所を特定するID
 
    //アダプタを取得
    this._adapters = (this._adapters || []);
 
    if (!this._adapters[insertId]) {
        this._adapters[insertId] = this._createAdapter(inputId, monthId, dateId);
    }
 
    var cal = this._cal;
 
    if (cal) {  //再表示の場合
        cal.hide();
        YAHOO.util.Dom.insertBefore(this._place, insertId);
        cal.show();
    } else {    //初めて表示する場合
        this._setStyle();
        cal = (this._cal = this._createCalendar(insertId));
    }
 
    this._place.focus();    //IEでテキストボックスのマウスカーソルが見えるのを回避
 
    //入力済みの日付を取得
    var val = this._adapters[insertId].getDate();
    var y = val[0], m = val[1], d = val[2];
    var shown = new Date(y, m - 1, d);
 
    var pagedate = "", selected = "";
 
    if ((shown.getFullYear() == y && shown.getMonth() + 1 == m && shown.getDate() == d)) {
        //日付として正しい場合
        pagedate = m + "/" + y;
        selected = m + "/" + d + "/" + y;
    } else {
        shown = new Date();
    }
 
    cal.cfg.setProperty("pagedate", pagedate);  //表示する年月
    cal.cfg.setProperty("selected", selected);  //選択状態の日付
 
    cal.render();
 
    this._showHolidays(shown);
 
    //カレンダーの表示が終わってからクリックイベントの捕捉を始める
    setTimeout(function() {
        YAHOO.util.Event.addListener(document, "click", YahhoCal.clickListener);
    }, 1);
 
    return true;
};
/**
 *  入力要素とカレンダーとのポリモフィズムなアダプタを生成する
 *  @param  String  inputId 入力要素のid or 年の入力要素のid
 *  @param  String  monthId 月の入力要素のid
 *  @param  String  dateId  日の入力要素のid
 *  @return Object  アダプタ
 */
YahhoCal._createAdapter = function(inputId, monthId, dateId) {
    var adapter = {};
 
    if (!monthId) {     //テキストボックス1つの場合
        var input = document.getElementById(inputId);
        var delimiter = YahhoCal.format.delimiter;
 
        adapter.getDate = function() {
            if (delimiter) {
                return input.value.split(delimiter);
            } else {
                var val = input.value;
                return [val.substr(0, 4), val.substr(4, 2), val.substr(6)];
            }
        };
 
        adapter.setDate = function(y, m, d) {
            if (YahhoCal.format.padZero) {
                m = ("0" + m).slice(-2);
                d = ("0" + d).slice(-2);
            }
 
            input.value = y + delimiter + m + delimiter + d;
        };
 
        return adapter;
    }
 
    //年・月・日が分かれている場合
    var ey = document.getElementById(inputId);
    var em = document.getElementById(monthId);
    var ed = document.getElementById(dateId);
 
    if (ey.tagName == "INPUT") {    //テキストボックスの場合
        adapter.getDate = function() { return [ey.value, em.value, ed.value]; };
        adapter.setDate = function(y, m, d) { ey.value = y; em.value = m; ed.value = d; };
 
        return adapter;
    }
 
    //選択リストの場合
    var getNumber = function(opt) { return (opt.value || opt.text).replace(/^0+/, ""); };
    var get = function(sel) { return getNumber(sel.options[sel.selectedIndex]); };
    var set = function(sel, value) {
        for (var i = 0, len = sel.length; i < len; i++) {
            if (getNumber(sel.options[i]) == value) {
                sel.options[i].selected = true;
                return;
            }
        }
    };
 
    adapter.getDate = function() { return [get(ey), get(em), get(ed)]; };
    adapter.setDate = function(y, m, d) { set(ey, y); set(em, m); set(ed, d); };
 
    return adapter;
};
/**
 *  styleを設定する
 */
YahhoCal._setStyle = function() {
    var css = "";
 
    for (var target in this.CAL_STYLE) {
        css += ".yui-skin-sam .yui-calcontainer .yui-calendar " + target;
        css += "{" + this.CAL_STYLE[target] + "} ";
    }
 
    var tmp = document.createElement("div");
    tmp.innerHTML = 'dummy<style type="text/css">' + css + "</style>";
 
    document.getElementsByTagName("head")[0].appendChild(tmp.lastChild);
};
/**
 *  カレンダーを生成する
 *  @param  String  insertId
 *  @return Calendar
 */
YahhoCal._createCalendar = function(insertId) {
    var yUtil = YAHOO.util, yDom = yUtil.Dom;   //ショートカット
 
    //YUI skinを適用
    yDom.addClass(document.body, "yui-skin-sam");
 
    //カレンダーの場所を作る
    var place = (this._place = document.createElement("div"));
 
    if (this.isPopup) {
        yDom.setStyle(place, "position", "absolute");
        yDom.setStyle(place, "z-index", 1);
    }
 
    yDom.insertBefore(place, insertId);
 
    //カレンダー設定
    var config = this.YUI_CAL_CONFIG[this.locale];
    config.close = this.isPopup;
    config.hide_blank_weeks = true;
 
    //カレンダー生成
    var cal = new YAHOO.widget.Calendar(place, config);
 
    //日付を選択された時のイベント
    cal.selectEvent.subscribe(function(eventName, selectedDate) {
        var date = selectedDate[0][0];
        YahhoCal._adapters[YahhoCal._currentId].setDate(date[0], date[1], date[2]);
 
        if (YahhoCal.isPopup) {
            cal.hide();
        }
    });
 
    //月を移動した時のイベント
    cal.changePageEvent.subscribe(function() {
        YahhoCal._showHolidays(cal.cfg.getProperty("pagedate"));
    });
 
    //閉じた時のイベント
    cal.hideEvent.subscribe(function() {
        yUtil.Event.removeListener(document, "click", YahhoCal.clickListener);
    });
 
    //Escキーでも閉じる
    (new yUtil.KeyListener(document, { keys: 27 }, function() { cal.hide(); })).enable();
 
    return cal;
};
/**
 *  祝日を表示する(要GCalendar Holidays)
 *  @param  Date    target  表示対象の年月
 *  @see    http://0-oo.net/sbox/javascript/google-calendar-holidays
 */
YahhoCal._showHolidays = function(target) {
    if (!window.GCalHolidays) {     //GCalendar Holidaysを読み込んでいない場合
        return;
    }
 
    //CallbackでsetHolidays()が呼ばれる
    GCalHolidays.get(this.setHolidays, target.getFullYear(), target.getMonth() + 1);
};
/**
 *  祝日表示を設定する
 *  @param  Array   holidays    祝日情報
 *  @param  Number  calIdIndex  GCalHolidays.userIds内の何番目かを示す数
 */
YahhoCal.setHolidays = function(holidays, calIdIndex) {
    if (holidays.length === 0) {
        return;
    }
 
    var getEBCN = YAHOO.util.Dom.getElementsByClassName;    //ショートカット
 
    //取得した年月をまだ表示しているかチェック
    var first = holidays[0];
    var table = getEBCN("y" + first.year, "table", this._place)[0];
    var tbody = getEBCN("m" + first.month, "tbody", table)[0];
 
    if (!table || !tbody) {
        return;
    }
 
    //祝日をツールチップで表示
    var prefix = (YahhoCal.holidays.prefixes[calIdIndex] || "");
 
    for (var i = 0, len = holidays.length; i < len; i++) {
        var td = getEBCN("d" + holidays[i].date, "td", tbody)[0];
        YAHOO.util.Dom.addClass(td, "holiday" + calIdIndex);
 
        if (td.title) {
            td.title += YahhoCal.holidays.delimiter;
        }
 
        td.title += prefix + holidays[i].title;
    }
};
/**
 *  カレンダーの外をクリックされたらカレンダーを閉じる
 *  @param  Object  clickedPoint    クリックされた位置
 */
YahhoCal.clickListener = function(clickedPoint) {
    if (!YahhoCal.isPopup) {
        return;
    }
 
    var xy = YAHOO.util.Event.getXY(clickedPoint);
    var x = xy[0], y = xy[1];
    var r = YAHOO.util.Dom.getRegion(YahhoCal._cal.containerId);
 
    if (x < r.left || x > r.right || y < r.top || y > r.bottom) {
        YahhoCal._cal.hide();
    }
};
/**
 *  必要なYUIのJavaScriptとCSSを読み込む
 *  @param  String      yuiBase     (optional) YUIのベースとなるURL
 *  @param  Function    callback    (optional) 読み込み完了時に実行する関数
 *  @see http://developer.yahoo.com/yui/yuiloader/
 */
YahhoCal.loadYUI = function(yuiBase, callback) {
    yuiBase = yuiBase || this.YUI_URL.SERVER + this.YUI_URL.VERSION + this.YUI_URL.DIR;
 
    //YUI Loaderをload
    var script = document.createElement("script");
    script.type = "text/javascript";
    script.src = yuiBase + "yuiloader-dom-event/yuiloader-dom-event.js";
    document.getElementsByTagName("head")[0].appendChild(script);
 
    var limit = 5000, interval = 50, time = 0;
 
    var intervalId = setInterval(function() {
        if (window.YAHOO) { //YUI Loaderがloadされたら
            clearInterval(intervalId);
 
            (new YAHOO.util.YUILoader({ //YUI Calendarをload
                base: yuiBase,
                require: ["calendar"],
                onSuccess: callback || null
            })).insert();
        } else if ((time += interval) > limit) {    //タイムアウト
            clearInterval(intervalId);
        }
    }, interval);
};
/**
 *  週の初めを月曜日にする
 */
YahhoCal.setMondayAs1st = function() {
    this.YUI_CAL_CONFIG[this.locale].start_weekday = 1;
};
/**
 *  選択可能な最初の日を指定する
 *  @param  Number  y   西暦4桁
 *  @param  Number  m   1~12月
 *  @param  Number  d
 */
YahhoCal.setMinDate = function(y, m, d) {
    var date = m + "/" + d + "/" + y;
 
    if (this._cal) {
        this._cal.configMinDate(null, [date]);
    } else {
        this.YUI_CAL_CONFIG[this.locale].mindate = date;
    }
};
/**
 *  選択可能な最後の日を指定する
 *  @param  Number  y   西暦4桁
 *  @param  Number  m   1~12月
 *  @param  Number  d
 */
YahhoCal.setMaxDate = function(y, m, d) {
    var date = m + "/" + d + "/" + y;
 
    if (this._cal) {
        this._cal.configMaxDate(null, [date]);
    } else {
        this.YUI_CAL_CONFIG[this.locale].maxdate = date;
    }
};
javascript/yahho-calendar.1442898544.txt.gz · 最終更新: 2015/09/22 14:09 (外部編集)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki