Theadfix (jQuery Plugin)

テーブルのthead要素を固定してくれるjQueryプラグインです。 jsを書かなくてもデータ属性を指定するだけで機能します。


使い方

thead要素をウィンドウに対してfixedで固定したい場合にはdata-theadfix="window"を、親要素に対してabsoluteで固定したい場合にはdata-theadfix="parent"をそれぞれ指定します。 デフォルトはwindowになっているので、data-theadfixと省略して指定する事も可能です。

id name kana
0 北海道 ホッカイドウ
1 青森県 アオモリケン
2 岩手県 イワテケン
3 宮城県 ミヤギケン
4 秋田県 アキタケン
5 山形県 ヤマガタケン
6 福島県 フクシマケン
7 茨城県 イバラキケン
8 栃木県 トチギケン
9 群馬県 グンマケン
10 埼玉県 サイタマケン
11 千葉県 チバケン
12 東京都 トウキョウト
13 神奈川県 カナガワケン
14 新潟県 ニイガタケン
15 富山県 トヤマケン
16 石川県 イシカワケン
17 福井県 フクイケン
18 山梨県 ヤマナシケン
19 長野県 ナガノケン
20 岐阜県 ギフケン
21 静岡県 シズオカケン
22 愛知県 アイチケン
23 三重県 ミエケン
24 滋賀県 シガケン
25 京都府 キョウトフ
26 大阪府 オオサカフ
27 兵庫県 ヒョウゴケン
28 奈良県 ナラケン
29 和歌山県 ワカヤマケン
30 鳥取県 トットリケン
31 島根県 シマネケン
32 岡山県 オカヤマケン
33 広島県 ヒロシマケン
34 山口県 ヤマグチケン
35 徳島県 トクシマケン
36 香川県 カガワケン
37 愛媛県 エヒメケン
38 高知県 コウチケン
39 福岡県 フクオカケン
40 佐賀県 サガケン
41 長崎県 ナガサキケン
42 熊本県 クマモトケン
43 大分県 オオイタケン
44 宮崎県 ミヤザキケン
45 鹿児島県 カゴシマケン
46 沖縄県 オキナワケン
id name kana
0 北海道 ホッカイドウ
1 青森県 アオモリケン
2 岩手県 イワテケン
3 宮城県 ミヤギケン
4 秋田県 アキタケン
5 山形県 ヤマガタケン
6 福島県 フクシマケン
7 茨城県 イバラキケン
8 栃木県 トチギケン
9 群馬県 グンマケン
10 埼玉県 サイタマケン
11 千葉県 チバケン
12 東京都 トウキョウト
13 神奈川県 カナガワケン
14 新潟県 ニイガタケン
15 富山県 トヤマケン
16 石川県 イシカワケン
17 福井県 フクイケン
18 山梨県 ヤマナシケン
19 長野県 ナガノケン
20 岐阜県 ギフケン
21 静岡県 シズオカケン
22 愛知県 アイチケン
23 三重県 ミエケン
24 滋賀県 シガケン
25 京都府 キョウトフ
26 大阪府 オオサカフ
27 兵庫県 ヒョウゴケン
28 奈良県 ナラケン
29 和歌山県 ワカヤマケン
30 鳥取県 トットリケン
31 島根県 シマネケン
32 岡山県 オカヤマケン
33 広島県 ヒロシマケン
34 山口県 ヤマグチケン
35 徳島県 トクシマケン
36 香川県 カガワケン
37 愛媛県 エヒメケン
38 高知県 コウチケン
39 福岡県 フクオカケン
40 佐賀県 サガケン
41 長崎県 ナガサキケン
42 熊本県 クマモトケン
43 大分県 オオイタケン
44 宮崎県 ミヤザキケン
45 鹿児島県 カゴシマケン
46 沖縄県 オキナワケン

<table data-theadfix>
  <thead>...</thead>
  <tbody>...</tbody>
</table>

<table data-theadfix="parent">
  <thead>...</thead>
  <tbody>...</tbody>
</table>

メソッド

デフォルトではロード時にdata-theadfix属性が設定されている要素を対象に初期化していますが、 $().theadfix(options)を使用する事で個別に要素を初期化する事が可能です。

$('[data-theadfix]').theadfix(options);
$().theadfix(options)初期化

オプション

初期化時にオプションで値を渡すと一部の設定を変更する事が可能です。 htmlにデータ属性を指定して初期化する場合にはdata-*を追加する事でも設定が変更できます。

theadfixwindowtheadをウィンドウに対して固定するか親要素に対して固定するかの指定。デフォルトはwindowになっていて、ウィンドウ上部にfixedで固定されます。 親要素をターゲットにabsoluteで固定したい場合にはparentを指定します。
wait100スクロールイベントを間引く時間。ms単位で指定する事ができ、その時間内は同じスクロールイベントが発生しないようになっています。

イベント

theadの挙動が変わる際のイベントを取得する事も可能です。

fix.theadfixtheadが固定されたタイミングで発生するイベントです
release.theadfixtheadが固定を解除されたタイミングで発生するイベントです
$('#target').on('fix.theadfix', function (event) {
  console.log('fix.theadfix: ', event.target);
});
$('#target').on('release.theadfix', function (event) {
  console.log('release.theadfix: ', event.target);
});