jQuery事始め・コピペに頼らず、基礎知識を理解して実際に動かしてみる

Ads

Warning: Undefined array key "HTTP_USER_AGENT" in /home/youhei0828/kachibito.net/public_html/wp-content/themes/kachibito7_with_cocoon_child/functions-module/other/tiny-fixed.php on line 75

人気のJavaScriptライブラリ、jQueryもかなり
情報が増えました。僕の様に知識が無くても
簡単に動きのあるWebサイトや、更なるユー
ザビリティの向上を可能にしてくれましたが、
いつまでもコピペではいずれ困る事になります。
その前にそろそろ基礎から学んでみませんか。

という訳で、jQuery事始め。さほど知識が無い僕が書くのも微妙なんですが、一緒に学んでいきましょう、という事でご了承下さい。内容は基礎中の基礎です。

いつまでもコピペに頼っていては、何か問題が起こったときに対応できませんし、そもそもコピペするならjQueryである必要はありません。

でもjQueryはすごく便利なので、ちゃんと使いこなしたいところですよね。この記事が、誰かが勉強し始める切欠になれば幸いです。

jQueryを使うには

まず、jQueryを利用するには本体を読み込む必要があります。方法は2つあって、本家jQueryでダウンロードし、自分のサーバーにアップするか、Google AJAX Libraries APIを利用するかです。ここではGoogle AJAX Libraries APIを利用していきます。


<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.0/jquery.min.js" type="text/javascript" charset="UTF-8"></script>

これでjQuery本体の準備が整いました。これより下に実行したいjQueryを書いていきます。

準備する

jQueryのコードは基本的に以下のように書き出します。

<script type="text/javascript">
$(function(){
	ここに動作・実行させる為のコードを書く
})
</script>

この中身が実際にjQueryを使って動作させる部分になります。ここにいろいろ指定する訳ですね。

[note]尚、$(function()は$(document).ready(function()を省略した形になります。どちらでも動作します。[/note]

動作させる

実行したいコードがあって、そのコードをどの部分に指定するか、を決めなければなりません。例えば、買い物を頼まれても買う場所が分からないと買えませんよね。買い物をして欲しいなら買う場所を指示する必要あがあります。

同様に、jQueryにもどの部分で動作させるか、という指示をしなくてはなりません。

その指示書としてセレクタを使います。

STEP.1 / セレクタを知る

$(“div.example”)

よく見かけますね、これ。これがセレクタです。

$(“.example”)

css同様に、上記でも基本的に問題ありません。

STEP.2 / 動作を決める

では、次に「動作」を決めてみます。

.hide();

hideは表示状態の要素を非表示にする命令文です。

これらをつなげると

$(“div.example”).hide();

となります。これで「div.example要素を隠す」という命令文が一つ出来上がりました。

では、この流れの続きで開閉パネルを作ってみます。

STEP.3 / 命令文を付け足す

$(“div.trigger”).click(function(){
$(this).toggleClass(“active”).next().slideToggle(“fast”);
});

1行目:div.triggerというHTML要素をクリックすると、その後に命令されているコードが実行されます。
2行目:toggleClassは指定したcssのclassが要素に無ければ追加、あれば削除させるコードです。slideToggleは要素をスライドアップ/ダウンさせます。fastはアニメーションのスピードの指示内容です

STEP.4 / つなげる

全部つなげると

$(“div.example”).hide();
$(“div.trigger”).click(function(){
$(this).toggleClass(“active”).next().slideToggle(“fast”);
});

という形になりました。これが命令文全体になります。これを

<script type="text/javascript">
$(function(){
	ここに実行したいコード
})
</script>

の中に入れます。

コード完成

<script type="text/javascript">
$(function(){
	$("div.example").hide();
	$("div.trigger").click(function(){
		$(this).toggleClass("active").next().slideToggle("fast");
	});
})
</script>

コードが完成しました。せっかくtoggleClass(“active”)でcssに変化を加えていますので、パネルが開いている際のスタイルを変更してみます。

書いたコードに合わせてcssを書いてみる

div class=”trigger”の部分は、クリックされることでclassにactiveを追加します。

<style type="text/css">
div.active{
background: #0f81ff ;
}
</style>

このようにすると、パネルが開いている時は、背景色が出ることになります。

では実際に動かしてみます。

動作デモ

div.exampleで隠していた(hide)部分が、div.triggerがクリックされたことで、activeが追加され、アニメーションで開きました(slideToggle)。

大まかな手順は

  1. jQuery本体を読み込む
  2. セレクタで動作させる場所を指定する
  3. 動作を決める
  4. $(function(){***})で動作させるコードを囲う
  5. 動作テスト

となります。

[note]誤解をしやすいのですが、上記サンプルでアニメーション動作そのものにactiveは不要です。これは開いている状態の時にcssでスタイルを変更できるように加えたものになります。

この場合、div.triggerはdiv.activeとなりますので開いている状態のスタイルはdiv.active{background: #0f81ff ;}といった形で指定します。
サンプルコードには含めましたが、無くてもアニメーションそのものに影響はありません。[/note]

使用したコードとマークアップ

<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.0/jquery.min.js" type="text/javascript" charset="UTF-8"></script>
<script type="text/javascript">
$(function(){
	$("div.example").hide();
	$("div.trigger").click(function(){
		$(this).toggleClass("active").next().slideToggle("fast");
	});
})
</script>
<style type="text/css">div.active{background: #0f81ff ;}div.example{overflow: hidden;}</style>

<div class="trigger"><a href="#ex">クリックでパネルを開閉出来ます</a></div>

<div class="example"> 
		<div class="block"> 
			 
			div.exampleで隠していた(hide)部分が、div.triggerがクリックされたことで、activeが追加され、アニメーションで開きました(slideToggle)。

大まかな手順は
<ol>
	<li>jQuery本体を読み込む</li>

<li>セレクタで動作させる場所を指定する</li>
<li>動作を決める</li>
<li>$(function(){***})で動作させるコードを囲う</li>
<li>動作テスト</li></ol>
となります。
		</div> 

	</div> 

※追記:「IE6でhideしない」と言われたのでdiv.example{overflow: hidden;}を追加しました。コピペしてほしくない記事なので全ブラウザで動くのが本当は嫌だったんですが、誤解も招いたので補足。

Chrome以外で確認していませんが、多分大丈夫じゃないかと思います。基本はこんな感じになります。命令文は沢山ありますので、まずはどんな命令を出せるかを知ると学ぶ楽しみが増えるのではないでしょうか。

どこで命令文を覚えるの?

色々学べるサイトはありますが、最初はリファレンスサイトや書籍以外は見ないほうがいいかも知れません。応用が書かれているとかえって混乱します。

jQuery日本語リファレンス

以下は尊敬するTo-Rさんと5509さんの書籍です。お勧め。

jQueryにもバージョンがあって、最新は1.51.7になります。

プラグインは使わせてもらおう

コピペに頼らない、と言っても、全て自分で書いたほうがいい、という意味ではありません。配布されている便利なプラグインは使わせてもらうべきです。時間も短縮できますしね。

ただ、基本を理解すれば、そのプラグインを改造したり、バグを直すこともできるし、応用的に使うことも出来るわけです(ライセンスにもよりますけどw)。この差はいずれ大きくなるかと思います。

ご注意

この記事は、JavaScriptを知らない方でもjQueryの基本を理解できるように、言葉やコードの書き方をある程度選んで書いています事をご理解いただきますようお願い致します。また、僕もあまり把握出来ていないので、間違いがあればご指摘頂けると幸いです。

勘のいい方はaタグがいらないことに気がつかれたかと思います。

version 3.0.83 (Wed, 16 Apr 2014 03:56:09 GMT)
http://alexgorbatchev.com/SyntaxHighlighter
JavaScript code syntax highlighter.
Copyright 2004-2013 Alex Gorbatchev.
If you like this script, please donate to
keep development active!

'}},vars:{discoveredBrushes:null,highlighters:{}},brushes:{},regexLib:{multiLineCComments:XRegExp("/\\*.*?\\*/","gs"),singleLineCComments:/\/\/.*$/gm,singleLinePerlComments:/#.*$/gm,doubleQuotedString:/"([^\\"\n]|\\.)*"/g,singleQuotedString:/'([^\\'\n]|\\.)*'/g,multiLineDoubleQuotedString:XRegExp('"([^\\\\"]|\\\\.)*"',"gs"),multiLineSingleQuotedString:XRegExp("'([^\\\\']|\\\\.)*'","gs"),xmlComments:XRegExp("(<|<)!--.*?--(>|>)","gs"),url:/https?:\/\/[\w-.\/?%&=:@;#]*/g,phpScriptTags:{left:/(<|<)\?(?:=|php)?/g,right:/\?(>|>)/g,eof:!0},aspScriptTags:{left:/(<|<)%=?/g,right:/%(>|>)/g},scriptScriptTags:{left:/(<|<)\s*script.*?(>|>)/gi,right:/(<|<)\/\s*script\s*(>|>)/gi}},toolbar:{getHtml:function(e){function t(e,t){return B.toolbar.getButtonHtml(e,t,B.config.strings[t])}for(var n='

',r=B.toolbar.items,i=r.list,a=0,l=i.length;l>a;a++)n+=(r[i[a]].getHtml||t)(e,i[a]);return n+="

"},getButtonHtml:function(t,n,r){return n=e(n),''+e(r)+""},handler:function(e){function t(e){var t=RegExp(e+"_(\\w+)"),n=t.exec(r);return n?n[1]:null}var n=e.target,r=n.className||"",i=s(g(n,".syntaxhighlighter").id),a=t("command");i&&a&&B.toolbar.items[a].execute(i),e.preventDefault()},items:{list:["expandSource","help"],expandSource:{getHtml:function(e){if(1!=e.getParam("collapse"))return"";var t=e.getParam("title");return B.toolbar.getButtonHtml(e,"expandSource",t?t:B.config.strings.expandSource)},execute:function(e){var t=o(e.id);r(t,"collapsed")}},help:{execute:function(){var e=x("","_blank",500,250,"scrollbars=0"),t=e.document;t.write(B.config.strings.aboutDialog),t.close(),e.focus()}}}},findElements:function(e,t){var n=t?[t]:i(document.getElementsByTagName(B.config.tagName)),r=B.config,a=[];if(r.useScriptTags&&(n=n.concat(A())),0===n.length)return a;for(var l=0,s=n.length;s>l;l++){var o={target:n[l],params:p(e,E(n[l].className))};null!=o.params.brush&&a.push(o)}return a},highlight:function(e,t){var n=this.findElements(e,t),r="innerHTML",i=null,a=B.config;if(0!==n.length)for(var l=0,s=n.length;s>l;l++){var o,t=n[l],u=t.target,c=t.params,g=c.brush;if(null!=g){if("true"==c["html-script"]||1==B.defaults["html-script"])i=new B.HtmlScript(g),g="htmlscript";else{var h=b(g);if(!h)continue;i=new h}o=u[r],a.useScriptTags&&(o=M(o)),""!=(u.title||"")&&(c.title=u.title),c.brush=g,i.init(c),t=i.getDiv(o),""!=(u.id||"")&&(t.id=u.id),u.parentNode.replaceChild(t,u)}}},all:function(e){m(window,"load",function(){B.highlight(e)})}};return B.Match=function(e,t,n){this.value=e,this.index=t,this.length=e.length,this.css=n,this.brushName=null},B.Match.prototype.toString=function(){return this.value},B.HtmlScript=function(e){function t(e,t){for(var n=0,r=e.length;r>n;n++)e[n].index+=t}function n(e){for(var n,a=e.code,l=[],s=r.regexList,o=e.index+e.left.length,u=r.htmlScript,c=0,g=s.length;g>c;c++)n=L(a,s[c]),t(n,o),l=l.concat(n);null!=u.left&&null!=e.left&&(n=L(e.left,u.left),t(n,e.index),l=l.concat(n)),null!=u.right&&null!=e.right&&(n=L(e.right,u.right),t(n,e.index+e[0].lastIndexOf(e.right)),l=l.concat(n));for(var h=0,g=l.length;g>h;h++)l[h].brushName=i.brushName;return l}var r,i=b(e),a=new B.brushes.Xml,l=this,s="getDiv getHtml init".split(" ");if(null!=i){r=new i;for(var o=0,u=s.length;u>o;o++)(function(){var e=s[o];l[e]=function(){return a[e].apply(a,arguments)}})();return null==r.htmlScript?(v(B.config.strings.brushNotHtmlScript+e),void 0):(a.regexList.push({regex:r.htmlScript.code,func:n}),void 0)}},B.Highlighter=function(){},B.Highlighter.prototype={getParam:function(e,t){var n=this.params[e];return d(null==n?t:n)},create:function(e){return document.createElement(e)},findMatches:function(e,t){var n=[];if(null!=e)for(var r=0,i=e.length;i>r;r++)"object"==typeof e[r]&&(n=n.concat(L(t,e[r])));return this.removeNestedMatches(n.sort(k))},removeNestedMatches:function(e){for(var t=0,n=e.length;n>t;t++)if(null!==e[t])for(var r=e[t],i=r.index+r.length,a=t+1,n=e.length;n>a&&null!==e[t];a++){var l=e[a];if(null!==l){if(l.index>i)break;l.index==r.index&&l.length>r.length?e[t]=null:l.index>=r.index&&i>l.index&&(e[a]=null)}}return e},figureOutLineNumbers:function(e){var t=[],n=parseInt(this.getParam("first-line"));return y(e,function(e,r){t.push(r+n)}),t},isLineHighlighted:function(e){var t=this.getParam("highlight",[]);return"object"!=typeof t&&null==t.push&&(t=[t]),-1!=h(t,""+e)},getLineHtml:function(e,t,n){var r=["line","number"+t,"index"+e,"alt"+(""+(0==t%2?1:2))];return this.isLineHighlighted(t)&&r.push("highlighted"),0==t&&r.push("break"),'

'+n+"

"},getLineNumbersHtml:function(e,t){var n="",r=a(e).length,i=parseInt(this.getParam("first-line")),l=this.getParam("pad-line-numbers");1==l?l=(""+(i+r-1)).length:1==isNaN(l)&&(l=0);for(var s=0;r>s;s++){var o=t?t[s]:i+s,e=0==o?B.config.space:S(o,l);n+=this.getLineHtml(s,o,e)}return n},getCodeLinesHtml:function(e,t){e=C(e);for(var n=a(e),r=(this.getParam("pad-line-numbers"),parseInt(this.getParam("first-line"))),e="",i=this.getParam("brush"),l=0,s=n.length;s>l;l++){var o=n[l],u=/^( |\s)+/.exec(o),c=null,g=t?t[l]:r+l;null!=u&&(c=""+u[0],o=o.substr(c.length),c=c.replace(" ",B.config.space)),o=C(o),0==o.length&&(o=B.config.space),e+=this.getLineHtml(l,g,(null!=c?''+c+"":"")+o)}return e},getTitleHtml:function(t){return t?"

"+e(t)+"

":""},getMatchesHtml:function(e,t){function n(e){var t=e?e.brushName||a:a;return t?t+" ":""}for(var r=0,i="",a=this.getParam("brush",""),l=0,s=t.length;s>l;l++){var o,u=t[l];null!==u&&0!==u.length&&(o=n(u),i+=N(e.substr(r,u.index-r),o+"plain")+N(u.value,o+u.css),r=u.index+u.length+(u.offset||0))}return i+=N(e.substr(r),n()+"plain")},getHtml:function(t){var n,r,i,a="",s=["syntaxhighlighter"];return 1==this.getParam("light")&&(this.params.toolbar=this.params.gutter=!1),className="syntaxhighlighter",1==this.getParam("collapse")&&s.push("collapsed"),0==(gutter=this.getParam("gutter"))&&s.push("nogutter"),s.push(this.getParam("class-name")),s.push(this.getParam("brush")),t=w(t).replace(/\r/g," "),n=this.getParam("tab-size"),t=1==this.getParam("smart-tabs")?R(t,n):H(t,n),this.getParam("unindent")&&(t=P(t)),gutter&&(i=this.figureOutLineNumbers(t)),r=this.findMatches(this.regexList,t),a=this.getMatchesHtml(t,r),a=this.getCodeLinesHtml(a,i),this.getParam("auto-links")&&(a=I(a)),"undefined"!=typeof navigator&&navigator.userAgent&&navigator.userAgent.match(/MSIE/)&&s.push("ie"),a='

'+(this.getParam("toolbar")?B.toolbar.getHtml(this):"")+''+this.getTitleHtml(this.getParam("title"))+""+""+(gutter?'":"")+'"+""+""+"
'+this.getLineNumbersHtml(t)+"'+'
'+a+"
"+"
"+"

"},getDiv:function(e){null===e&&(e=""),this.code=e;var t=this.create("div");return t.innerHTML=this.getHtml(e),this.getParam("toolbar")&&m(c(t,".toolbar"),"click",B.toolbar.handler),this.getParam("quick-code")&&m(c(t,".code"),"dblclick",X),t},init:function(e){this.id=f(),u(this),this.params=p(B.defaults,e||{}),1==this.getParam("light")&&(this.params.toolbar=this.params.gutter=!1)},getKeywords:function(e){return e=e.replace(/^\s+|\s+$/g,"").replace(/\s+/g,"|"),"\\b(?:"+e+")\\b"},forHtmlScript:function(e){var t={end:e.right.source};e.eof&&(t.end="(?:(?:"+t.end+")|$)"),this.htmlScript={left:{regex:e.left,css:"script"},right:{regex:e.right,css:"script"},code:XRegExp("(?"+e.left.source+")"+"(?.*?)"+"(?"+t.end+")","sgi")}}},B}();"undefined"!=typeof exports?exports.SyntaxHighlighter=SyntaxHighlighter:null