↓

ソフトウェア説明書 / swasd.cat-1.0a

名称

カレンダー (swasdCat - Calendar Around Today)

概要

本日を起点とし、指定範囲の過去・未来を整形出力する

機能

注意

インストール

使用法

生成するカレンダー（tableエレメント）構成の概略
captionセル
年月見出しセル日曜セル月曜セル火曜セル水曜セル木曜セル金曜セル土曜セル年月見出しセル
:::::::::
年月見出しセル日曜セル月曜セル火曜セル水曜セル木曜セル金曜セル土曜セル年月見出しセル
表示デザイン設定用スタイルシート・クラス
生成するカレンダー(HTMLソース)に設定するクラス名一覧
クラス名摘要
swasd-cat-tableカレンダー全体（tableエレメント）に設定
swasd-cat-captioncaptionセルに設定
swasd-cat-head曜日見出しセルに設定
swasd-cat-year-month年月見出しセルに設定
swasd-cat-sunday日曜日セルに設定
swasd-cat-saturday土曜日セルに設定
swasd-cat-weekday平日セルに設定
swasd-cat-past過去セルに設定
swasd-cat-today本日セルに設定
swasd-cat-bound-top第一週セルに設定
swasd-cat-bound-right月末と月初に接する接する月末（晦日）セルに設定
swasd-cat-bound-bottom月末から遡った一週間のセルに設定
swasd-cat-bound-left月末と月初に接する接する月初（一日）セルに設定
swasd-cat-commentcommentエレメントに設定
任意クラス名commentエレメントに付加
  • caltabスタイル指定配列（「個別指定オブジェクトのプロパティ」参照）で定義するクラス名（セル・スタイル／コメント・スタイル）
  • caltabで定義した個別日付（ex.営業日／休業日など）に対するデザインを、このクラス名を媒介としてスタイルシートで定義する
内部生成したHTMLソース（カレンダー）の実例

2010-01-11の実例

<table class="swasd-cat-table" cellspacing="0" summary="A calendar around today"
    ><tr
        ><td colspan="9" class="swasd-cat-caption">Sample Calendar #1</td></tr
    ><tr
        ><td class="swasd-cat-year-month swasd-cat-head">&nbsp;</td
        ><td class="swasd-cat-sunday swasd-cat-head">日</td
        ><td class="swasd-cat-weekday swasd-cat-head">月</td
        ><td class="swasd-cat-weekday swasd-cat-head">火</td
        ><td class="swasd-cat-weekday swasd-cat-head">水</td
        ><td class="swasd-cat-weekday swasd-cat-head">木</td
        ><td class="swasd-cat-weekday swasd-cat-head">金</td
        ><td class="swasd-cat-saturday swasd-cat-head">土</td
        ><td class="swasd-cat-year-month swasd-cat-head">&nbsp;</td></tr
    ><tr
        ><td class="swasd-cat-bound-bottom swasd-cat-year-month">2009年12月</td
        ><td class="swasd-cat-past swasd-cat-bound-bottom swasd-cat-sunday ">27</td
        ><td class="swasd-cat-past swasd-cat-bound-bottom swasd-cat-weekday ">28</td
        ><td class="swasd-cat-past swasd-cat-bound-bottom swasd-cat-weekday ">29</td
        ><td class="swasd-cat-past swasd-cat-bound-bottom swasd-cat-weekday ">30</td
        ><td class="swasd-cat-past swasd-cat-bound-right swasd-cat-bound-bottom swasd-cat-weekday ">31</td
        ><td class="swasd-cat-past swasd-cat-bound-top swasd-cat-bound-left swasd-cat-weekday swasd-cat-holiday ">1<div class="swasd-cat-comment">元旦</div></td
        ><td class="swasd-cat-past swasd-cat-bound-top swasd-cat-saturday ">2</td
        ><td class="swasd-cat-bound-top swasd-cat-year-month">2010年1月</td></tr
    ><tr
        ><td class="swasd-cat-bound-top swasd-cat-year-month">&nbsp;</td
        ><td class="swasd-cat-past swasd-cat-bound-top swasd-cat-sunday ">3</td
        ><td class="swasd-cat-past swasd-cat-bound-top swasd-cat-weekday ">4</td
        ><td class="swasd-cat-past swasd-cat-bound-top swasd-cat-weekday ">5<div class="swasd-cat-comment swasd-cat-scenery-24sekki">小寒</div></td
        ><td class="swasd-cat-past swasd-cat-bound-top swasd-cat-weekday ">6</td
        ><td class="swasd-cat-past swasd-cat-bound-top swasd-cat-weekday ">7</td
        ><td class="swasd-cat-past swasd-cat-weekday ">8</td
        ><td class="swasd-cat-past swasd-cat-saturday ">9</td
        ><td class="swasd-cat-year-month">&nbsp;</td></tr
    ><tr
        ><td class="swasd-cat-year-month">&nbsp;</td
        ><td class="swasd-cat-past swasd-cat-sunday ">10</td
        ><td class="swasd-cat-weekday swasd-cat-today swasd-cat-holiday ">11<div class="swasd-cat-comment">成人の日</div></td
        ><td class="swasd-cat-weekday ">12</td
        ><td class="swasd-cat-weekday ">13</td
        ><td class="swasd-cat-weekday ">14</td
        ><td class="swasd-cat-weekday ">15</td
        ><td class="swasd-cat-saturday ">16</td
        ><td class="swasd-cat-year-month">&nbsp;</td></tr
    ><tr
        ><td class="swasd-cat-year-month">&nbsp;</td
        ><td class="swasd-cat-sunday ">17<div class="swasd-cat-comment swasd-cat-scenery-zassetsu">土用</div></td
        ><td class="swasd-cat-weekday ">18</td
        ><td class="swasd-cat-weekday ">19</td
        ><td class="swasd-cat-weekday ">20<div class="swasd-cat-comment swasd-cat-scenery-24sekki">大寒</div></td
        ><td class="swasd-cat-weekday ">21</td
        ><td class="swasd-cat-weekday ">22</td
        ><td class="swasd-cat-saturday ">23</td
        ><td class="swasd-cat-year-month">&nbsp;</td></tr
    ><tr
        ><td class="swasd-cat-year-month">&nbsp;</td
        ><td class="swasd-cat-sunday ">24</td
        ><td class="swasd-cat-bound-bottom swasd-cat-weekday ">25</td
        ><td class="swasd-cat-bound-bottom swasd-cat-weekday ">26</td
        ><td class="swasd-cat-bound-bottom swasd-cat-weekday ">27</td
        ><td class="swasd-cat-bound-bottom swasd-cat-weekday ">28</td
        ><td class="swasd-cat-bound-bottom swasd-cat-weekday ">29</td
        ><td class="swasd-cat-bound-bottom swasd-cat-saturday ">30</td
        ><td class="swasd-cat-bound-bottom swasd-cat-year-month">&nbsp;</td></tr
    ><tr
        ><td class="swasd-cat-bound-bottom swasd-cat-year-month">&nbsp;</td
        ><td class="swasd-cat-bound-right swasd-cat-bound-bottom swasd-cat-sunday ">31</td
        ><td class="swasd-cat-bound-top swasd-cat-bound-left swasd-cat-weekday ">1</td
        ><td class="swasd-cat-bound-top swasd-cat-weekday ">2</td
        ><td class="swasd-cat-bound-top swasd-cat-weekday ">3<div class="swasd-cat-comment swasd-cat-scenery-zassetsu">節分</div></td
        ><td class="swasd-cat-bound-top swasd-cat-weekday ">4<div class="swasd-cat-comment swasd-cat-scenery-24sekki">立春</div></td
        ><td class="swasd-cat-bound-top swasd-cat-weekday ">5</td
        ><td class="swasd-cat-bound-top swasd-cat-saturday ">6</td
        ><td class="swasd-cat-bound-top swasd-cat-year-month">2010年2月</td></tr
    ><tr
        ><td class="swasd-cat-bound-top swasd-cat-year-month">&nbsp;</td
        ><td class="swasd-cat-bound-top swasd-cat-sunday ">7</td
        ><td class="swasd-cat-weekday ">8</td
        ><td class="swasd-cat-weekday ">9</td
        ><td class="swasd-cat-weekday ">10</td
        ><td class="swasd-cat-weekday swasd-cat-holiday ">11<div class="swasd-cat-comment">建国記念の日</div></td
        ><td class="swasd-cat-weekday ">12</td
        ><td class="swasd-cat-saturday ">13</td
        ><td class="swasd-cat-year-month">&nbsp;</td></tr></table>
標準個別指定オブジェクト生成メソッド（日本語）
名称
specificStandardJa
呼び出し形態
コンストラクタ関数
書式
new _._specificStandardJa(caltab,cap,dno,yml,tro,cls)
引数
「個別指定オブジェクト」の各プロパティに対応。標準値を変更する必要のある引数のみ指定。
復帰値
個別指定オブジェクト。標準値と引数とをマージした結果のオブジェクト。
注記
当メソッド記述のencodingはUTF-8である。内容の詳細は、ソースコード: swasd.cat/specificStandardJa.jsを参照。
標準個別指定オブジェクト生成メソッド（英語）
名称
specificStandardEn
呼び出し形態
コンストラクタ関数
書式
new _._specificStandardEn(caltab,cap,dno,yml,tro,cls)
引数
「個別指定オブジェクト」の各プロパティに対応。標準値を変更する必要のある引数のみ指定。
復帰値
個別指定オブジェクト。標準値と引数とをマージした結果のオブジェクト。
注記
当メソッド記述のencodingはUTF-8である（caltab内の日本語表記から英語表記への変換を含む為）。内容の詳細は、ソースコード: swasd.cat/specificStandardEn.jsを参照。

当ソフトウェアは カレンダー作成メソッド の wrapper として実装したものである。

サンプル

↑
↓
↑
↓
↑
↓

参考

カレンダー作成メソッドの仕様

名称
createCalendar
呼び出し形態
コンストラクタ関数
書式
_.createCalendar(container, containerStyleInit, containerStyleStarted, specific)
引数
containerカレンダー格納用エレメントのid
containerStyleInit同エレメントの初期処理中スタイル（動的スタイル指定）
containerStyleStarted同エレメントのカレンダー表示開始時スタイル（動的スタイル指定）
specific個別指定オブジェクト
パラメタ（_のプロパティ）
名称値備考
timeValueNumber1970年1月1日0時0分0秒を起点としたミリ秒で当日指定。当該項目 undefined で下記有効。あらかじめ _.timeValue = 値 または、_.iso8601Date = 値 または、_.uaClock = [true|false] で与える
iso8601DateStringISO8601形式の文字列(ex. 2010-01-11)
uaClockBooleantrue: ブラウザー・クロック / false: サーバ・クロック
_catWeeksBeforeNumber当日を含む週以前の表示週数
_catWeeksAfterNumber当日を含む週以降の表示週数
復帰値
カレンダーオブジェクト
個別指定オブジェクトのプロパティ
名称値備考
caltabcaltab（外部ファイル）を表すストリング
sumtableエレメントのsummary属性に与えるストリング
cap同captionセルのストリング
dno曜日名オブジェクト(day name object)タイトル編集用オブジェクト
yml年月ラベル編集メソッド
trocaltab comment 変換オブジェクト(translate object)多言語対応で実装（ひとつのcaltabのcommentを複数表現する為）
clscaltab スタイル指定配列を各要素とする配列
caltab
曜日名オブジェクト(day name object)のプロパティ
名称値備考
sun日曜日に相当するストリングexp.'日' or 'Sun'
mon月曜日に相当するストリングexp.'月' or 'Mon'
tue火曜日に相当するストリングexp.'火' or 'Tue'
wed水曜日に相当するストリングexp.'水' or 'Wed'
thu木曜日に相当するストリングexp.'木' or 'Thu'
fri金曜日に相当するストリングexp.'金' or 'Fri'
sat土曜日に相当するストリングexp.'土' or 'Sat'
年月ラベル編集メソッド
関数呼び出し
function (year,month) { return yearとmonthで編集; }
caltab comment 変換オブジェクト(translate object)のプロパティ
名称値備考
caltabのcommentフィールド値対応する変換値
caltab スタイル指定配列
No.値(type)備考
1主クラス(String)主クラス＋副クラスでユニークとなるcaltabエントリへ下記を適用。注：ここでいうクラスとはcaltab内分類の意味でHTML表現上のクラスとは別
2副クラス(String)
3セル・スタイル(String)日付セルに付与するクラス名（スタイルシートでスタイル定義）
4コメント・スタイル(String)日付セル内コメント部に付与するクラス名（スタイルシートでスタイル定義）
5title有無(Boolean)日付セルへのtitle属性付加の有／無
6comment不要・有無(Boolean)日付セル内へcomment挿入なしの有／無（注：false時は有となる）
カレンダーオブジェクトの主なプロパティ
名称値備考
build構築メソッド
_edit整形メソッド

構築メソッドの仕様

名称
build
呼び出し形態
コンストラクタ関数
書式
build(timeValue)
引数
timeValue表示するカレンダーの本日を表す。1970年1月1日0時0分0秒を起点としたミリ秒。
復帰値
内部生成したコンテイナー・エレメント
注記
カレンダー表示環境を整え、整形メソッドを呼び出す

整形メソッドの仕様

名称
_edit
呼び出し形態
コンストラクタ関数
書式
_edit()
引数
なし
復帰値
内部生成したHTMLソース（カレンダー）
注記
↑