Jqueryスキル(習得必須)_jquery

jQuery がロードされているかどうかを確認します

jQuery で何かを行う前に、jQuery がロードされていることを確認する必要があります。

if (typeof jQuery == 'undefined') {
console.log('jQuery hasn\'t loaded');
} else {
console.log('jQuery has loaded');
}

トップに戻るボタン

jQuery の animate メソッドとscrollTop メソッドを使用すると、プラグインを使わずに単純なスクロールアップ効果を作成できます。

// 返回顶部
$('a.top').click(function (e) {
e.preventDefault();
$(document.body).animate({scrollTop: 0}, 800);
});
<!-- 设置锚 -->
<a class="top" href="#">Back to top</a>

scrollTop の値を調整して、スクロールの着陸位置を変更します。実際に行っていることは、先頭にスクロールするまで 800 ミリ秒にわたってドキュメント本文の位置を設定し続けることです。

画像のプリロード

Web ページで、すぐには表示されない画像 (マウスオーバーによってトリガーされる画像など) を多数使用している場合は、これらの画像をプリロードすることが合理的です。

$.preloadImages = function () {
for (var i = 0; i < arguments.length; i++) {
$('<img>').attr('src', arguments[i]);
}
};

$.preloadImages('img/hover-on.png', 'img/hover-off.png');

画像がロードされているかどうかを判断します

場合によっては、スクリプトの実行を続行するために、イメージが完全にロードされているかどうかを確認する必要があります。

$('img').load(function () {
console.log('image load successful');
});

同様に、 タグに id または class 属性を指定して、特定の画像が読み込まれているかどうかを確認することもできます。

失敗した画像を自動的に修復します

Web サイト上で壊れた画像リンクを見つけた場合、それらを 1 つずつ置き換えるのは面倒です。この単純なコードにより、その苦痛が大幅に軽減されます。

$('img').on('error', function () {
if(!$(this).hasClass('broken-image')) {
$(this).prop('src', 'img/broken.png').addClass('broken-image');
}
});

まだリンク切れがなくても、このコードを追加しても失うものは何もありません。

マウスオーバースイッチクラス

ユーザーがクリック可能な要素の上にマウスを置いたときの視覚効果を変更したい場合は、マウスが置かれたときに要素にクラスを追加し、マウスが置かれなくなったら、次のクラスを除くクラスを移動します。

$('.btn').hover(function () {
$(this).addClass('hover');
}, function () {
$(this).removeClass('hover');
});

より簡単なルートを探している場合は、toggleClass メソッドを使用して、必要な CSS を追加するだけです。

$('.btn').hover(function () {
$(this).toggleClass('hover');
});

注: この場合、CSS を使用する方が高速な解決策になる可能性がありますが、この方法についても多少の知識を得る価値はあります。

入力フィールドを無効にする

場合によっては、ユーザーが特定のアクション (「規約を読みました」確認ボックスをチェックするなど) を完了するまで、フォームの送信ボタンを無効にしたり、入力フィールドの 1 つを無効にしたりすることが必要な場合があります。入力フィールドに無効な属性を追加し、必要に応じて有効にすることができます:

$('input[type="submit"]').prop('disabled', true);

入力フィールドで prop メソッドを再度実行するだけですが、今回は無効な値を false に変更します。

$('input[type="submit"]').prop('disabled', false);

リンクの読み込みをブロック

特定のページにリンクしたり、現在のページをリロードしたりしたくないが、他のスクリプトをトリガーするなど、別のことを実行させたい場合があります。これには、デフォルトのアクションをブロックするための作業が必要です:

$('a.no-link').click(function (e) {
e.preventDefault();
});

jQuery セレクターのキャッシュ

プロジェクト内で同じセレクターを何度も繰り返し書いているか考えてみてください。各 $('.element') は、DOM 全体が実行されたかどうかに関係なく、DOM 全体を 1 回クエリする必要があります。代わりに、セレクターを 1 回実行し、結果を変数に保存するだけです:

var blocks = $('#blocks').find('li');

これで、毎回 DOM をクエリしなくても、どこでも block 変数を使用できるようになります。

$('#hideBlocks').click(function () {
blocks.fadeOut();
});
$('#showBlocks').click(function () {
blocks.fadeIn();
});

jQuery セレクターをキャッシュすると、単純にパフォーマンスが向上します。

フェード/スライドを切り替えます

フェードとスライドはどちらも jQuery でよく使用されるエフェクトです。ユーザーが要素をクリックしたときにのみ要素を表示したい場合は、fadeIn メソッドと slideDown メソッドが最適です。ただし、初めてクリックしたときに要素を表示し、再度クリックしたときに要素を非表示にしたい場合は、次のコードが役立ちます:

// 淡出
$('.btn').click(function () {
$('.element').fadeToggle('slow');
});

// 切换
$('.btn').click(function () {
$('.element').slideToggle('slow');
});

シンプルなアコーディオンエフェクト

アコーディオン効果を素早く簡単に実現する方法は次のとおりです:

// 关闭所有面板
$('#accordion').find('.content').hide();

// 手风琴效果
$('#accordion').find('.accordion-header').click(function () {
var next = $(this).next();
next.slideToggle('fast');
$('.content').not(next).slideUp('fast');
return false;
});

このスクリプトを追加することで、実際に行っていることは、スクリプトが適切に機能するために必要な HTML 要素を提供することだけです。

2 つの div を同じ高さにします

それぞれにどのようなコンテンツが含まれているかに関係なく、2 つの div を常に同じ高さにしたい場合があります:

$('.div').css('min-height', $('.main-div').height());

这个例子设置了 min-height，意味着高度可以大于主 div 而不能小于它。然而，更灵活的方法是遍历一组元素，然后将高度设置为最高元素的高度：

var $columns = $('.column');
var height = 0;
$columns.each(function () {
if ($(this).height() > height) {
height = $(this).height();
}
});
$columns.height(height);

如果你希望所有列高度相同：

var $rows = $('.same-height-columns');
$rows.each(function () {
$(this).find('.column').height($(this).height());
});

在新标签页 / 新窗口打开外部链接

在一个新的浏览器标签页或窗口中打开外部链接，并确保相同来源的链接在同一个标签页或者窗口中打开：

$('a[href^="http"]').attr('target', '_blank');
$('a[href^="//"]').attr('target', '_blank');
$('a[href^="' + window.location.origin + '"]').attr('target', '_self');

注： window.location.origin 在 IE10 中不可用. 这个修复方案 正是关注于该问题。

通过文本查找元素

通过使用 jQuery 的 contains() 选择器，你能够查找元素内容中的文本。若文本不存在，该元素将被隐藏：

var search = $('#search').val();
$('div:not(:contains("' + search + '"))').hide();

在 visibility 属性变化时触发

当用户的焦点离开或者重新回到某个标签页时，触发 Javasrcipt：

$(document).on('visibilitychange', function (e) {
if (e.target.visibilityState === "visible") {
console.log('Tab is now in view!');
} else if (e.target.visibilityState === "hidden") {
console.log('Tab is now hidden!');
}
});

Ajax 调用错误处理

当一个 Ajax 调用返回 404 或 500 错误时，错误处理程序将被执行。若错误处理未被定义，其它 jQuery 代码可能不再有效。所以定义一个全局的 Ajax 错误处理：

$(document).ajaxError(function (e, xhr, settings, error) {
console.log(error);
});

链式插件调用

jQuery 允许通过“链式”插件调用的方法，来缓解反复查询 DOM 和创建多个 jQuery 对象的过程。例如，下面的代码代表着你的插件调用：

$('#elem').show();
$('#elem').html('bla');
$('#elem').otherStuff();

通过使用链式操作，有了显著的改善:

$('#elem')
.show()
.html('bla')
.otherStuff();

另一种方法是在变量（以 $ 为前缀）中，对元素进行缓存：

var $elem = $('#elem');
$elem.hide();
$elem.html('bla');
$elem.otherStuff();

无论是链式操作，还是缓存元素，都是 jQuery 中用以简化和优化代码的最佳实践。

这里收集了一些简单的窍门，助你玩转 jQuery。

检查 jQuery 是否加载

在使用 jQuery 进行任何操作之前，你需要先确认它已经加载：

if (typeof jQuery == 'undefined') {
console.log('jQuery hasn\'t loaded');
} else {
console.log('jQuery has loaded');
}

返回顶部按钮

利用 jQuery 中的 animate 和 scrollTop 方法，你无需插件就可以创建简单的 scroll up 效果:

// 返回顶部
$('a.top').click(function (e) {
e.preventDefault();
$(document.body).animate({scrollTop: 0}, 800);
});
<!-- 设置锚 -->
<a class="top" href="#">Back to top</a>

调整 scrollTop 的值即可改变滚动着陆位置。你实际所做的是在 800 毫秒内不断设置文档主体的位置，直到它滚动到顶部。

预加载图片

如果你的网页使用了大量并非立即可见的图片（例如悬停鼠标触发的图片），那么预加载这些图片就显得很有意义了:

$.preloadImages = function () {
for (var i = 0; i < arguments.length; i++) {
$('<img>').attr('src', arguments[i]);
}
};
$.preloadImages('img/hover-on.png', 'img/hover-off.png');

判断图片是否加载完成

在有些情况下，为了继续执行脚本，你需要检查图片是否已经完全加载:

$('img').load(function () {
console.log('image load successful');
});

同样，换用一个带有 id 或者 class 属性的 标签，你也可以检查特定图片是否加载完成。

自动修复失效图片

如果你在你的网站上发现了失效的图片链接，逐个去替换它们将会是个苦差。这段简单的代码可以很大程度地减轻痛苦：

$('img').on('error', function () {
if(!$(this).hasClass('broken-image')) {
$(this).prop('src', 'img/broken.png').addClass('broken-image');
}
});

即使你暂无任何失效的链接，添加这段代码也不会有任何损失。

鼠标悬停切换 class

如果你希望在用户将鼠标悬停在某个可点击元素上时改变它的视觉效果，你可以在该元素被悬停时给它添加一个 class，当鼠标不再悬停时，移除这个 class：

$('.btn').hover(function () {
$(this).addClass('hover');
}, function () {
$(this).removeClass('hover');
});

如果你还寻求更简单的途径，可以使用 toggleClass 方法，仅需添加必要的 CSS：

$('.btn').hover(function () {
$(this).toggleClass('hover');
});

注：在这种情况下，使用 CSS 或许是一个更快速的解决方案，但这种方法仍然值得稍作了解。

禁用输入字段

有时，你可能希望在用户完成特定操作（例如，勾选“我已阅读条例”的确认框）前禁用表单的提交按钮或禁用其中某个输入框。你可以在你的输入字段上添加disabled 属性，而后你能在需要时启用它：

$('input[type="submit"]').prop('disabled', true);

你只需在输入字段上再次运行 prop 方法, 但是这一次把 disabled 值改为 false：

$('input[type="submit"]').prop('disabled', false);

阻止链接加载

有时你不希望链接到指定页面或者重载当前页面，而是想让它们干些别的，例如触发其它脚本。这需要在阻止默认动作上做些文章：

$('a.no-link').click(function (e) {
e.preventDefault();
});

缓存 jQuery 选择器

想想你在项目中一次又一次地写了多少相同的选择器吧。每个 $('.element') 都必须查询一次整个 DOM,不管它是否曾这样执行过。作为代替，我们只运行一次选择器，并把结果储存在一个变量中：

var blocks = $('#blocks').find('li');

现在你能在任何地方使用 blocks 变量而无需每次查询 DOM 了:

$('#hideBlocks').click(function () {
blocks.fadeOut();
});
$('#showBlocks').click(function () {
blocks.fadeIn();
});

缓存 jQuery 的选择器是种简单的性能提升。

切换淡出 / 滑动

淡出和滑动都是我们在 jQuery 中大量使用的效果。你可能只想在用户点击后展现某个元素，此时用 fadeIn 和 slideDown 方法就很完美。但是如果你希望这个元素在首次点击时出现，再次点击时消失，这段代码就很有用了：

// 淡出
$('.btn').click(function () {
$('.element').fadeToggle('slow');
});

// 切换
$('.btn').click(function () {
$('.element').slideToggle('slow');
});

简单的手风琴效果

这是一个快速实现手风琴效果的简单方法:

// 关闭所有面板
$('#accordion').find('.content').hide();
// 手风琴效果
$('#accordion').find('.accordion-header').click(function () {
var next = $(this).next();
next.slideToggle('fast');
$('.content').not(next).slideUp('fast');
return false;
});

通过添加这段脚本，你实际要做的只是提供必要的 HTML 元素以便它正常运行。

使两个 div 等高

有时你希望无论两个 div 各自包含什么内容，它们总有相同的高度：

$('.div').css('min-height', $('.main-div').height());

这个例子设置了 min-height，意味着高度可以大于主 div 而不能小于它。然而，更灵活的方法是遍历一组元素，然后将高度设置为最高元素的高度：

var $columns = $('.column');
var height = 0;
$columns.each(function () {
if ($(this).height() > height) {
height = $(this).height();
}
});
$columns.height(height);

如果你希望所有列高度相同：

var $rows = $('.same-height-columns');
$rows.each(function () {
$(this).find('.column').height($(this).height());
});

在新标签页 / 新窗口打开外部链接

在一个新的浏览器标签页或窗口中打开外部链接，并确保相同来源的链接在同一个标签页或者窗口中打开：

$('a[href^="http"]').attr('target', '_blank');
$('a[href^="//"]').attr('target', '_blank');
$('a[href^="' + window.location.origin + '"]').attr('target', '_self');

注： window.location.origin 在 IE10 中不可用. 这个修复方案 正是关注于该问题。

通过文本查找元素

通过使用 jQuery 的 contains() 选择器，你能够查找元素内容中的文本。若文本不存在，该元素将被隐藏：

var search = $('#search').val();
$('div:not(:contains("' + search + '"))').hide();

在 visibility 属性变化时触发

当用户的焦点离开或者重新回到某个标签页时，触发 Javasrcipt：

$(document).on('visibilitychange', function (e) {
if (e.target.visibilityState === "visible") {
console.log('Tab is now in view!');
} else if (e.target.visibilityState === "hidden") {
console.log('Tab is now hidden!');
}
});

Ajax 调用错误处理

当一个 Ajax 调用返回 404 或 500 错误时，错误处理程序将被执行。若错误处理未被定义，其它 jQuery 代码可能不再有效。所以定义一个全局的 Ajax 错误处理：

$(document).ajaxError(function (e, xhr, settings, error) {
console.log(error);
});

链式插件调用

jQuery 允许通过“链式”插件调用的方法，来缓解反复查询 DOM 和创建多个 jQuery 对象的过程。例如，下面的代码代表着你的插件调用：

$('#elem').show();
$('#elem').html('bla');
$('#elem').otherStuff();

通过使用链式操作，有了显著的改善:

$('#elem')
.show()
.html('bla')
.otherStuff();

另一种方法是在变量（以 $ 为前缀）中，对元素进行缓存：

var $elem = $('#elem');
$elem.hide();
$elem.html('bla');
$elem.otherStuff();

无论是链式操作，还是缓存元素，都是 jQuery 中用以简化和优化代码的最佳实践。