jQuery 3.0 では API の整理やバグ修正のため、 互換性の無くなる変更が公式 API 、非公式 API を問わず多く行われています。 そのため、jQuery 1.x(2.x)から 3.x に更新して問題が出ないように 更新ガイドが公式から出ています。

そのjQuery Core 3.0 Upgrade Guide や jQuery Migrate 3.x の警告文集 を読んで jQuery 3.x への更新方法や その際の注意点を自分なりに(今さらですが)まとめました。

以下のリストの「○」が付いている項目は jQuery Migrate プラグインが 警告してくれる項目です。「△」が付いている項目は部分的に警告してくれる項目です。 「◎」が付いている項目は Migrate プラグインが警告だけでなく動作の変更も行う 項目です(jQuery Migrate 3.x の警告文集から判断)。

• ブラウザサポート
• jQuery Migrate プラグインと3.0への更新手順
• 重要な変更の概要
  • Ajax
    • ○Breaking change: jQuery.ajax からの Deferred の特殊なケース用メソッドを削除
    • Breaking change: クロスドメインのスクリプトをリクエストする時は宣言しなくてはならない
    • Breaking change: URL 内のハッシュはjQuery.ajax() を実行しても温存される
    • Feature: jQuery.get()とjQuery.post()に新しい用法
  • Attributes
    • ○Breaking change: .removeAttr() がプロパティに false をセットしなくなった
    • Breaking change: 全く選択されていない<select multiple>は空配列を返す
    • Feature: SVG 文書でも class の操作がサポートされる
    • ○Deprecated: 引数無しの .toggleClass() と .toggleClass( Boolean )
  • Callbacks
    • Feature: Callbacks のlock()が防ぐのは将来のリストの実行だけ
  • Core
    • Breaking change: jQuery 3.0 は Strict Mode で実行されます
    • Breaking change: document-ready ハンドラは常に非同期となった
    • ○Breaking change: jQuery.isNumeric() と 独自の.toString()
    • Breaking change: 廃止予定だった.context と.selectorプロパティが削除された
    • ○Breaking change: 廃止予定だった.size()が削除された
    • △Breaking change: 文書化されていない内部メソッドはもう外に晒しません
    • Breaking change: 空の集合時の返り値は undefined です
    • Feature: for...of ループが jQuery コレクションで使用可能に
    • Feature: jQuery.ready promise が公式にサポートされる
    • ○Deprecated: jQuery.unique() が jQuery.uniqueSort() に改名
    • ○Deprecated: jQuery.parseJSON()
    • Deprecated: jQuery(function)以外の document-ready ハンドラの登録
  • Data
    • △Breaking change: .data() のダッシュを含む名前について
  • Deferred
    • Breaking change 且つ Feature: jQuery.Deferred はもう Promises/A+ 互換です
      • Resolution
      • コールバックでのエラーについて
      • コールバックの起動について
      • 後方互換性
      • まとめ
    • Breaking change 且つ Feature: jQuery.when() の引数
    • Breaking change: jQuery.when() の progress 通知
  • Dimensions
    • Breaking change: .width(), .height(), .css("width"), .css("height") は数値でない値を返すことがあります
    • Breaking change: window の .outerWidth() や .outerHeight() はスクロールバーの幅/高さを含みます
  • Effects
    • Breaking change: .show(), .hide(), .toggle() はスタイルシートの変更により配慮するようになった
    • Feature: アニメーションで requestAnimationFrame を再び使うようになった
    • ○Deprecated: jQuery.fx.interval
    • ◎Deprecated: easing 関数の第2引数以降
  • Event
    • ○Breaking change: .load(), .unload(), .error() が削除された
    • ○Breaking change: .on("ready", fn)が削除された
    • Breaking change: event.pageXとevent.pageYの正規化が削除された
    • ○Breaking change: jQuery.event.propsとjQuery.event.fixHooksが削除された
    • Breaking change: 不正なセレクタでのイベントの delegate はすぐに throw する
    • ○Deprecated: .bind()と.delegate()
  • Manipulation
    • Breaking change: .wrapAll(function)はその関数を一回だけしか呼ばない
  • Offset
    • ○Breaking change: .offset()への不正な入力
  • Selector
    • Breaking change: :hiddenと:visibleの振る舞い
    • Breaking change: jQuery("#")と.find("#")は不正な構文
    • Feature: 新メソッドjQuery.escapeSelector()
    • ○Deprecated: jQuery.expr[":"]とjQuery.expr.filters
  • Serialize
    • Breaking change: jQuery.param() はもはや %20 をプラス記号に変換しない
  • Traversing
    • ○Breaking change: .andSelf()は削除された、.addBack()を使いましょう

続きを読む

jQuery Migrate プラグイン 3.x の使い方と警告文を自分なりにまとめました。 記事作成時の jQuery Migrate プラグイン(以下 jQuery Migrate)の バージョンは 3.0.1 です。 jQuery Migrate 1.x と使い方は同じですが 用途や警告文が異なるので注意して下さい。 jQuery Migrate 1.x についてはこちらにまとめました。

• jQuery Migrate plugin について
• 開発版と製品版
• 使い方
• jQuery Migrate plugin のプロパティ
• 警告メッセージの種類
  • JQMIGRATE: Migrate is installed, version X
    JQMIGRATE: Migrate is installed with logging active, version X
  • JQMIGRATE: jQuery 3.0.0+ REQUIRED
  • JQMIGRATE: Migrate plugin loaded multiple times
  • JQMIGRATE: Attribute selector with '#' must be quoted
    JQMIGRATE: Attribute selector with '#' was not fixed
  • JQMIGRATE: jQuery is not compatible with Quirks Mode
  • JQMIGRATE: jQXHR.success is deprecated and removed
    JQMIGRATE: jQXHR.error is deprecated and removed
    JQMIGRATE: jQXHR.complete is deprecated and removed
  • JQMIGRATE: jQuery.fn.error() is deprecated
  • JQMIGRATE: jQuery.fn.load() is deprecated
    JQMIGRATE: jQuery.fn.unload() is deprecated
  • JQMIGRATE: deferred.pipe() is deprecated
  • JQMIGRATE: jQuery.fx.interval is deprecated
  • JQMIGRATE: jQuery.fn.andSelf() is deprecated and removed, use jQuery.fn.addBack()
  • JQMIGRATE: jQuery.fn.size() is deprecated and removed; use the .length property
  • JQMIGRATE: jQuery.data() always sets/gets camelCased names
  • JQMIGRATE: jQuery.fn.removeAttr no longer sets boolean properties
  • JQMIGRATE: jQuery.fn.offset() requires a valid DOM element
    JQMIGRATE: jQuery.fn.offset() requires an element connected to a document
  • JQMIGRATE: jQuery.param() no longer uses jQuery.ajaxSettings.traditional
  • JQMIGRATE: jQuery.swap() is undocumented and deprecated
  • JQMIGRATE: jQuery.fn.bind() is deprecated
    JQMIGRATE: jQuery.fn.unbind() is deprecated
    JQMIGRATE: jQuery.fn.delegate() is deprecated
    JQMIGRATE: jQuery.fn.undelegate() is deprecated
  • JQMIGRATE: 'ready' event is deprecated
  • JQMIGRATE: 'jQuery.easing.NAME' should use only one argument
  • JQMIGRATE: jQuery.parseJSON is deprecated; use JSON.parse
  • JQMIGRATE: jQuery.isNumeric() should not be called on constructed objects
  • JQMIGRATE: jQuery.unique is deprecated; use jQuery.uniqueSort
  • JQMIGRATE: jQuery.expr[':'] is deprecated; use jQuery.expr.pseudos
    JQMIGRATE: jQuery.expr.filters is deprecated; use jQuery.expr.pseudos
  • JQMIGRATE: jQuery.fn.toggleClass( [ boolean ] ) is deprecated
  • JQMIGRATE: jQuery.event.props are deprecated and removed
    JQMIGRATE: jQuery.event.props.concat() is deprecated and removed
    JQMIGRATE: jQuery.event.fixHooks are deprecated and removed
  • JQMIGRATE: jQuery(window).on('load'...) called after load event occurred
  • JQMIGRATE: jQuery.holdReady() is deprecated
  • JQMIGRATE: jQuery.fn.click() event shorthand is deprecated
  • JQMIGRATE: jQuery.fn.hover() is deprecated

続きを読む

jQuery Migrate プラグインの使い方は前にもまとめましたが、 少し追加修正がありますので再び投稿します。

• jQuery Migrate plugin について
• 開発版と製品版
• 使い方
• jQuery Migrate plugin のプロパティ
• 警告メッセージの種類
  • JQMIGRATE: Migrate is installed, version X
    JQMIGRATE: Migrate is installed with logging active, version X
  • JQMIGRATE: jQuery.attrFn is deprecated
  • JQMIGRATE: $(html) HTML strings must start with '<' character
  • JQMIGRATE: $(html) text after last tag is ignored
  • JQMIGRATE: Attribute selector with '#' must be quoted
    JQMIGRATE: Attribute selector with '#' was not fixed
  • JQMIGRATE: Can't change the 'type' of an input or button in IE 6/7/8
  • JQMIGRATE: jQuery is not compatible with Quirks Mode
  • JQMIGRATE: jQuery.boxModel is deprecated
    JQMIGRATE: jQuery.support.boxModel is deprecated
  • JQMIGRATE: jQuery.parseJSON requires a valid JSON string
  • JQMIGRATE: jQuery.browser is deprecated
  • JQMIGRATE: jQuery.sub() is deprecated
  • JQMIGRATE: 'hover' pseudo-event is deprecated, use 'mouseenter mouseleave'
  • JQMIGRATE: jQuery.fn.error() is deprecated
  • JQMIGRATE: jQuery.fn.load() is deprecated
    JQMIGRATE: jQuery.fn.unload() is deprecated
  • JQMIGRATE: jQuery.fn.toggle(handler, handler...) is deprecated
  • JQMIGRATE: jQuery.fn.live() is deprecated; jQuery.fn.die() is deprecated
  • JQMIGRATE: AJAX events should be attached to document
  • JQMIGRATE: Global events are undocumented and deprecated
  • JQMIGRATE: jQuery.event.handle is undocumented and deprecated
  • JQMIGRATE: jQuery.fn.attr('value') no longer gets properties
  • JQMIGRATE: jQuery.fn.attr('value', val) no longer sets properties
  • JQMIGRATE: jQuery.fn.attr('selected') might use property instead of attribute
  • JQMIGRATE: deferred.pipe() is deprecated
  • JQMIGRATE: deferred.isResolved() is deprecated
    JQMIGRATE: deferred.isRejected() is deprecated
  • JQMIGRATE: jQuery.clean() is deprecated
  • JQMIGRATE: Use of jQuery.fn.data('events') is deprecated
  • JQMIGRATE: HTML string cannot start with a '#' character
  • JQMIGRATE: jQuery.fn.andSelf() replaced by jQuery.fn.addBack()
  • JQMIGRATE: jQuery.fn.size() is deprecated; use the .length property
  • JQMIGRATE: jQuery.swap() is undocumented and deprecated
  • JQMIGRATE: 'ready' event is deprecated

続きを読む

Markdown のソースが実際にどんな HTML ソースになるのか https://pandoc.org/try/ (以下pandoc)と http://daringfireball.net/projects/markdown/dingus (以下df)で 色々試したことのまとめです。

Github などの追加要素のない strict バージョンの話です。 また、他の実装とは異なる場合があるかもしれません。 試した時のバージョンは pandoc 1.19.1 から 1.19.2 の間で、 コマンドは pandoc --from markdown_strict --to html5 です。 (daringfireball の方はメモするのを忘れてました)

長いので手っ取り早く Markdown を知りたい場合には向かないと思います

参考：http://daringfireball.net/projects/markdown/syntax.php

• Markdown について
• 段落と改行について
  • 段落について
  • 改行について
• MarkdownでHTMLタグをそのまま書くときの注意点
• 特殊文字の自動エスケープ
• 見出しについて
• 引用について
• リストについて
  • リストの入れ子
  • リストの終了判定(推測)
  • リストのお勧めの書き方
  • 順序付きリストの暴発
• コードブロックについて
• 水平の罫線について
• SPAN 系の要素
  • リンク
    • 自動リンク
    • インライン形式
    • 参照形式
  • 強調
  • インラインでのコード表示
  • 画像について
    • インライン形式
    • 参照形式
• その他
  • バックスラッシュでのエスケープ

続きを読む

jQuery.data()やjQuery.fn.data()を 使うと要素(やオブジェクト)ごとに Key-Value の形でデータを 保存することが出来ます。 また、jQuery.fn.data()では HTML 属性 data-* の値を取得することができます。 この属性 data-* まわりの処理のためか、 キーにダッシュ(-)が含まれている場合、 処理に一貫性が無くなり、1.x 系と 2.x 系で振る舞いが 異なる箇所も出てきます。

そのようなわけで、キーにダッシュが含まれている場合に どのような振る舞いになるのかを調べてみましたが、 キーにダッシュを含めなければいい話なので、 元々キーにダッシュを含めていない人は もうこれ以降読む必要が無いかもしれません。

主に jQuery 2.1.0 と 1.11.0 (あとおざなりに 2.0.3, 1.10.2, 1.9.1) を使って調べたので、他のバージョンでは 当てはまらないことがあるかもしれませんのでご注意下さい。

• jQuery.fn.data()での取り扱い
  • jQuery.fn.data( key, value )の場合
  • jQuery.fn.data( obj )の場合
  • jQuery.fn.data( key )の場合
• jQuery.data()での取り扱い
  • jQuery.data( elem, key, value )の場合
  • jQuery.data( elem, obj )の場合
  • jQuery.data( elem, key )の場合
• jQuery.removeData(), jQuery.fn.removeData()での取り扱い
  • 一つのキーを削除する場合(.removeData(key))
  • 複数のキーを削除する場合 (.removeData([key1, key2, ...]), .removeData("key1 key2 ..."))
• まとめ
• おまけ：データを空にしたときの注意点

続きを読む