GitHubのコミットログを追ってjQueryプラグインの機能追加のタイミングを探してみた

投稿者: | 2015年6月11日

※この記事はフロントエンドをちょっと触りたいなと思っているデザイナーさん向けの記事です。

先日、同僚のデザイナーに「『Swipebox』っていうjQueryプラグイン使ったんだけど、スマホでモーダル表示するとタイトルが出なくて困る」という、最近のライトノベルのタイトルになりそうな相談をされました。

1年くらい前から僕が『Swipebox』がお気に入りになっていて、違うブロジェクトにもそれを使っていましたので、僕ならわかるだろうという算段だったようです。

まあ、ここ数ヶ月Swipeboxを触ってなかったので、スマホのモーダル表示でタイトルが出なくなってるだなんて知らなかったんですけどね┐(´-`)┌

これまで僕が使っていた旧バージョンと機能が若干違っているようなので、何か機能が追加されていないか探します。
公式ドキュメントを見てもタイトルの表示関連のオプションがあるというようなことは書いていなかったので、GitHubで公開されてるリポジトリのコミットログを追って変更点を見て行きましょう。

以下、相談を受けてから実際に記述を見つけるまでの過程を実際にやっていった順に説明していきます。

バージョンの違いを確認してみる

僕が最後に実装したSwipeboxのバージョンは「1.2.8」でした。
同僚が使いたいと言ってきた(この記事の投稿当時の)最新版のバージョンは「1.3.0.2」です。

swipebox_version_comparison
両者のバージョンでの実装の違い(モーダル表示)を見てみると…
なるほどvar.1.2.8ではタイトルが出ているのに1.3.0.2ではタイトルは出ていません。
さらに閉じる(✕)ボタンの位置も違います。

おそらくバージョンが上がる間にタイトルまわりの仕様が変更されたのでしょう。

ドキュメントには書いているのか

公式サイトを見てみてみる

公式サイト(http://brutaldesign.github.io/swipebox/)を見てみる。
optionsの項目には以下の記述。

特にスマートフォンに関する記述はない。

GitHubのReadme.mdを見てみる

https://github.com/brutaldesign/swipebox

optionsの項目は公式ページとほぼ同じものだった。

リリースのバージョンログを見てみる

順番にログを見てみる

github-swpbox-varsion-log
https://github.com/brutaldesign/swipebox/releases
どこで変更があったのかを確かめるために順番にログを見ていきます。

github-swpbox-release129
https://github.com/brutaldesign/swipebox/releases/tag/1.2.9
いきなりそれっぽいのを見つけました。

差分を見てみる

github-swipebox129-js-comparison
https://github.com/brutaldesign/swipebox/commit/793e645c596ff90449d60ae35ce7d0b7a2b52ea0
hideBarsOnMobileというオプションが追加されてデフォルトがtrueになっているようです。

ここで実際にhideBarsOnMobileをfalseにしてみたのですが、1.3.0.2では適用されませんでした。

コミットログを見てみる

どこかで置き換わってないか、また新たなオプションが追加されいないかを見てみます。

github-swipebox-commit-logs
またもやそれっぽいコメントを見つけました。

github-swipebox-commit-log-removal
どうやらremoveBarsOnMobileという記述に置き換わっているようです。

removeBarsOnMobileの値もデフォルトがtrueですので、falseにすればいいようです。

github-swipebox-latest-view-title-success
無事にタイトル表示ができました。

ちなみに、この技術者ブログでもSwipeboxを使っていますが、画像にタイトルをつけていないので、モーダルのタイトルは表示されませんので悪しからず。

ちょっと待て

( ^o^) <やった!これでスマホでもタイトル表示ができるようになったぞ!

( ˘⊖˘) 。o(待てよ…?これ普通に最新版のソース見ればよかったんじゃ…)

|非圧縮ソース| ┗(☋` )┓三

( ◠‿◠ )☛ 最初に最新版のソースを見ないとはなんとおろかな

▂▅▇█▓▒░(’ω’)░▒▓█▇▅▂うわあああああああ

まとめ的な何か(まとめとは言っていない)

  1. まずドキュメントやReadmeを見よう
  2. ドキュメントやReadmeを見てわからなければ非圧縮のソースを見よう
  3. ソースのどこを見たらわからないなら差分やコミットログを見てみよう

コミットログを見ながら、どういう変更がどのタイミングでを加えられているかを見るのは、けっこう楽しいですよ。

( ◠‿◠ )☛ だが、無駄な時間を使ったという事実は変わりないぞ

▂▅▇█▓▒░(’ω’)░▒▓█▇▅▂うわあああああああ

おしまい。

GitHubのコミットログを追ってjQueryプラグインの機能追加のタイミングを探してみた」への2件のフィードバック

  1. ピンバック: スマホサイトに最適なスワイプに対応したライトボックス「swipebox.js」 | Web模様

  2. コレが最後の残業タスク

    ありがとう神様。これで帰宅できます。

    返信

コメントを残す

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です