PageRenderTime 26ms CodeModel.GetById 24ms RepoModel.GetById 0ms app.codeStats 1ms

/docs/todos.html

http://github.com/documentcloud/backbone
HTML | 791 lines | 518 code | 273 blank | 0 comment | 0 complexity | 371c7627dd68216e14be2f884660ad1d MD5 | raw file
    

  1. <!DOCTYPE html>
    2. 

  2. 

  3. <html>
    4. 

  4. <head>
    5. 

  5.   <title>todos.js</title>
    6. 

  6.   <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    7. 

  7.   <meta name="viewport" content="width=device-width, target-densitydpi=160dpi, initial-scale=1.0; maximum-scale=1.0; user-scalable=0;">
    8. 

  8.   <link rel="stylesheet" media="all" href="docco.css" />
    9. 

  9. </head>
    10. 

  10. <body>
    11. 

  11.   <div id="container">
    12. 

  12.     <div id="background"></div>
    13. 

  13.     
    14. 

  14.       <ul id="jump_to">
    15. 

  15.         <li>
    16. 

  16.           <a class="large" href="javascript:void(0);">Jump To &hellip;</a>
    17. 

  17.           <a class="small" href="javascript:void(0);">+</a>
    18. 

  18.           <div id="jump_wrapper">
    19. 

  19.           <div id="jump_page_wrapper">
    20. 

  20.             <div id="jump_page">
    21. 

  21.               
    22. 

  22.                 
    23. 

  23.                 <a class="source" href="backbone.localStorage.html">
    24. 

  24.                   backbone.localStorage.js
    25. 

  25.                 </a>
    26. 

  26.               
    27. 

  27.                 
    28. 

  28.                 <a class="source" href="todos.html">
    29. 

  29.                   todos.js
    30. 

  30.                 </a>
    31. 

  31.               
    32. 

  32.             </div>
    33. 

  33.           </div>
    34. 

  34.         </li>
    35. 

  35.       </ul>
    36. 

  36.     
    37. 

  37.     <ul class="sections">
    38. 

  38.         
    39. 

  39.           <li id="title">
    40. 

  40.               <div class="annotation">
    41. 

  41.                   <h1>todos.js</h1>
    42. 

  42.               </div>
    43. 

  43.           </li>
    44. 

  44.         
    45. 

  45.         
    46. 

  46.         
    47. 

  47.         <li id="section-1">
    48. 

  48.             <div class="annotation">
    49. 

  49.               
    50. 

  50.               <div class="pilwrap ">
    51. 

  51.                 <a class="pilcrow" href="#section-1">&#182;</a>
    52. 

  52.               </div>
    53. 

  53.               <p>An example Backbone application contributed by
    54. 

  54. <a href="http://jgn.me/">Jérôme Gravel-Niquet</a>. This demo uses a simple
    55. 

  55. <a href="backbone.localStorage.html">LocalStorage adapter</a>
    56. 

  56. to persist Backbone models within your browser.</p>
    57. 

  57. 

  58.             </div>
    59. 

  59.             
    60. 

  60.         </li>
    61. 

  61.         
    62. 

  62.         
    63. 

  63.         <li id="section-2">
    64. 

  64.             <div class="annotation">
    65. 

  65.               
    66. 

  66.               <div class="pilwrap ">
    67. 

  67.                 <a class="pilcrow" href="#section-2">&#182;</a>
    68. 

  68.               </div>
    69. 

  69.               <p>Load the application once the DOM is ready, using <code>jQuery.ready</code>:</p>
    70. 

  70. 

  71.             </div>
    72. 

  72.             
    73. 

  73.             <div class="content"><div class='highlight'><pre>$(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>)</span>{</pre></div></div>
    74. 

  74.             
    75. 

  75.         </li>
    76. 

  76.         
    77. 

  77.         
    78. 

  78.         <li id="section-3">
    79. 

  79.             <div class="annotation">
    80. 

  80.               
    81. 

  81.               <div class="pilwrap ">
    82. 

  82.                 <a class="pilcrow" href="#section-3">&#182;</a>
    83. 

  83.               </div>
    84. 

  84.               <h2 id="todo-model">Todo Model</h2>
    85. 

  85. 

  86.             </div>
    87. 

  87.             
    88. 

  88.         </li>
    89. 

  89.         
    90. 

  90.         
    91. 

  91.         <li id="section-4">
    92. 

  92.             <div class="annotation">
    93. 

  93.               
    94. 

  94.               <div class="pilwrap ">
    95. 

  95.                 <a class="pilcrow" href="#section-4">&#182;</a>
    96. 

  96.               </div>
    97. 

  97.               
    98. 

  98.             </div>
    99. 

  99.             
    100. 

  100.         </li>
    101. 

  101.         
    102. 

  102.         
    103. 

  103.         <li id="section-5">
    104. 

  104.             <div class="annotation">
    105. 

  105.               
    106. 

  106.               <div class="pilwrap ">
    107. 

  107.                 <a class="pilcrow" href="#section-5">&#182;</a>
    108. 

  108.               </div>
    109. 

  109.               <p>Our basic <strong>Todo</strong> model has <code>title</code>, <code>order</code>, and <code>done</code> attributes.</p>
    110. 

  110. 

  111.             </div>
    112. 

  112.             
    113. 

  113.             <div class="content"><div class='highlight'><pre>  <span class="hljs-keyword">var</span> Todo = Backbone.Model.extend({</pre></div></div>
    114. 

  114.             
    115. 

  115.         </li>
    116. 

  116.         
    117. 

  117.         
    118. 

  118.         <li id="section-6">
    119. 

  119.             <div class="annotation">
    120. 

  120.               
    121. 

  121.               <div class="pilwrap ">
    122. 

  122.                 <a class="pilcrow" href="#section-6">&#182;</a>
    123. 

  123.               </div>
    124. 

  124.               <p>Default attributes for the todo item.</p>
    125. 

  125. 

  126.             </div>
    127. 

  127.             
    128. 

  128.             <div class="content"><div class='highlight'><pre>    defaults: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    129. 

  129.       <span class="hljs-keyword">return</span> {
    130. 

  130.         title: <span class="hljs-string">"empty todo..."</span>,
    131. 

  131.         order: Todos.nextOrder(),
    132. 

  132.         done: <span class="hljs-literal">false</span>
    133. 

  133.       };
    134. 

  134.     },</pre></div></div>
    135. 

  135.             
    136. 

  136.         </li>
    137. 

  137.         
    138. 

  138.         
    139. 

  139.         <li id="section-7">
    140. 

  140.             <div class="annotation">
    141. 

  141.               
    142. 

  142.               <div class="pilwrap ">
    143. 

  143.                 <a class="pilcrow" href="#section-7">&#182;</a>
    144. 

  144.               </div>
    145. 

  145.               <p>Toggle the <code>done</code> state of this todo item.</p>
    146. 

  146. 

  147.             </div>
    148. 

  148.             
    149. 

  149.             <div class="content"><div class='highlight'><pre>    toggle: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    150. 

  150.       <span class="hljs-keyword">this</span>.save({done: !<span class="hljs-keyword">this</span>.get(<span class="hljs-string">"done"</span>)});
    151. 

  151.     }
    152. 

  152. 

  153.   });</pre></div></div>
    154. 

  154.             
    155. 

  155.         </li>
    156. 

  156.         
    157. 

  157.         
    158. 

  158.         <li id="section-8">
    159. 

  159.             <div class="annotation">
    160. 

  160.               
    161. 

  161.               <div class="pilwrap ">
    162. 

  162.                 <a class="pilcrow" href="#section-8">&#182;</a>
    163. 

  163.               </div>
    164. 

  164.               <h2 id="todo-collection">Todo Collection</h2>
    165. 

  165. 

  166.             </div>
    167. 

  167.             
    168. 

  168.         </li>
    169. 

  169.         
    170. 

  170.         
    171. 

  171.         <li id="section-9">
    172. 

  172.             <div class="annotation">
    173. 

  173.               
    174. 

  174.               <div class="pilwrap ">
    175. 

  175.                 <a class="pilcrow" href="#section-9">&#182;</a>
    176. 

  176.               </div>
    177. 

  177.               
    178. 

  178.             </div>
    179. 

  179.             
    180. 

  180.         </li>
    181. 

  181.         
    182. 

  182.         
    183. 

  183.         <li id="section-10">
    184. 

  184.             <div class="annotation">
    185. 

  185.               
    186. 

  186.               <div class="pilwrap ">
    187. 

  187.                 <a class="pilcrow" href="#section-10">&#182;</a>
    188. 

  188.               </div>
    189. 

  189.               <p>The collection of todos is backed by <em>localStorage</em> instead of a remote
    190. 

  190. server.</p>
    191. 

  191. 

  192.             </div>
    193. 

  193.             
    194. 

  194.             <div class="content"><div class='highlight'><pre>  <span class="hljs-keyword">var</span> TodoList = Backbone.Collection.extend({</pre></div></div>
    195. 

  195.             
    196. 

  196.         </li>
    197. 

  197.         
    198. 

  198.         
    199. 

  199.         <li id="section-11">
    200. 

  200.             <div class="annotation">
    201. 

  201.               
    202. 

  202.               <div class="pilwrap ">
    203. 

  203.                 <a class="pilcrow" href="#section-11">&#182;</a>
    204. 

  204.               </div>
    205. 

  205.               <p>Reference to this collection’s model.</p>
    206. 

  206. 

  207.             </div>
    208. 

  208.             
    209. 

  209.             <div class="content"><div class='highlight'><pre>    model: Todo,</pre></div></div>
    210. 

  210.             
    211. 

  211.         </li>
    212. 

  212.         
    213. 

  213.         
    214. 

  214.         <li id="section-12">
    215. 

  215.             <div class="annotation">
    216. 

  216.               
    217. 

  217.               <div class="pilwrap ">
    218. 

  218.                 <a class="pilcrow" href="#section-12">&#182;</a>
    219. 

  219.               </div>
    220. 

  220.               <p>Save all of the todo items under the <code>&quot;todos-backbone&quot;</code> namespace.</p>
    221. 

  221. 

  222.             </div>
    223. 

  223.             
    224. 

  224.             <div class="content"><div class='highlight'><pre>    localStorage: <span class="hljs-keyword">new</span> Backbone.LocalStorage(<span class="hljs-string">"todos-backbone"</span>),</pre></div></div>
    225. 

  225.             
    226. 

  226.         </li>
    227. 

  227.         
    228. 

  228.         
    229. 

  229.         <li id="section-13">
    230. 

  230.             <div class="annotation">
    231. 

  231.               
    232. 

  232.               <div class="pilwrap ">
    233. 

  233.                 <a class="pilcrow" href="#section-13">&#182;</a>
    234. 

  234.               </div>
    235. 

  235.               <p>Filter down the list of all todo items that are finished.</p>
    236. 

  236. 

  237.             </div>
    238. 

  238.             
    239. 

  239.             <div class="content"><div class='highlight'><pre>    done: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    240. 

  240.       <span class="hljs-keyword">return</span> <span class="hljs-keyword">this</span>.where({done: <span class="hljs-literal">true</span>});
    241. 

  241.     },</pre></div></div>
    242. 

  242.             
    243. 

  243.         </li>
    244. 

  244.         
    245. 

  245.         
    246. 

  246.         <li id="section-14">
    247. 

  247.             <div class="annotation">
    248. 

  248.               
    249. 

  249.               <div class="pilwrap ">
    250. 

  250.                 <a class="pilcrow" href="#section-14">&#182;</a>
    251. 

  251.               </div>
    252. 

  252.               <p>Filter down the list to only todo items that are still not finished.</p>
    253. 

  253. 

  254.             </div>
    255. 

  255.             
    256. 

  256.             <div class="content"><div class='highlight'><pre>    remaining: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    257. 

  257.       <span class="hljs-keyword">return</span> <span class="hljs-keyword">this</span>.where({done: <span class="hljs-literal">false</span>});
    258. 

  258.     },</pre></div></div>
    259. 

  259.             
    260. 

  260.         </li>
    261. 

  261.         
    262. 

  262.         
    263. 

  263.         <li id="section-15">
    264. 

  264.             <div class="annotation">
    265. 

  265.               
    266. 

  266.               <div class="pilwrap ">
    267. 

  267.                 <a class="pilcrow" href="#section-15">&#182;</a>
    268. 

  268.               </div>
    269. 

  269.               <p>We keep the Todos in sequential order, despite being saved by unordered
    270. 

  270. GUID in the database. This generates the next order number for new items.</p>
    271. 

  271. 

  272.             </div>
    273. 

  273.             
    274. 

  274.             <div class="content"><div class='highlight'><pre>    nextOrder: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    275. 

  275.       <span class="hljs-keyword">if</span> (!<span class="hljs-keyword">this</span>.length) <span class="hljs-keyword">return</span> <span class="hljs-number">1</span>;
    276. 

  276.       <span class="hljs-keyword">return</span> <span class="hljs-keyword">this</span>.last().get(<span class="hljs-string">'order'</span>) + <span class="hljs-number">1</span>;
    277. 

  277.     },</pre></div></div>
    278. 

  278.             
    279. 

  279.         </li>
    280. 

  280.         
    281. 

  281.         
    282. 

  282.         <li id="section-16">
    283. 

  283.             <div class="annotation">
    284. 

  284.               
    285. 

  285.               <div class="pilwrap ">
    286. 

  286.                 <a class="pilcrow" href="#section-16">&#182;</a>
    287. 

  287.               </div>
    288. 

  288.               <p>Todos are sorted by their original insertion order.</p>
    289. 

  289. 

  290.             </div>
    291. 

  291.             
    292. 

  292.             <div class="content"><div class='highlight'><pre>    comparator: <span class="hljs-string">'order'</span>
    293. 

  293. 

  294.   });</pre></div></div>
    295. 

  295.             
    296. 

  296.         </li>
    297. 

  297.         
    298. 

  298.         
    299. 

  299.         <li id="section-17">
    300. 

  300.             <div class="annotation">
    301. 

  301.               
    302. 

  302.               <div class="pilwrap ">
    303. 

  303.                 <a class="pilcrow" href="#section-17">&#182;</a>
    304. 

  304.               </div>
    305. 

  305.               <p>Create our global collection of <strong>Todos</strong>.</p>
    306. 

  306. 

  307.             </div>
    308. 

  308.             
    309. 

  309.             <div class="content"><div class='highlight'><pre>  <span class="hljs-keyword">var</span> Todos = <span class="hljs-keyword">new</span> TodoList;</pre></div></div>
    310. 

  310.             
    311. 

  311.         </li>
    312. 

  312.         
    313. 

  313.         
    314. 

  314.         <li id="section-18">
    315. 

  315.             <div class="annotation">
    316. 

  316.               
    317. 

  317.               <div class="pilwrap ">
    318. 

  318.                 <a class="pilcrow" href="#section-18">&#182;</a>
    319. 

  319.               </div>
    320. 

  320.               <h2 id="todo-item-view">Todo Item View</h2>
    321. 

  321. 

  322.             </div>
    323. 

  323.             
    324. 

  324.         </li>
    325. 

  325.         
    326. 

  326.         
    327. 

  327.         <li id="section-19">
    328. 

  328.             <div class="annotation">
    329. 

  329.               
    330. 

  330.               <div class="pilwrap ">
    331. 

  331.                 <a class="pilcrow" href="#section-19">&#182;</a>
    332. 

  332.               </div>
    333. 

  333.               
    334. 

  334.             </div>
    335. 

  335.             
    336. 

  336.         </li>
    337. 

  337.         
    338. 

  338.         
    339. 

  339.         <li id="section-20">
    340. 

  340.             <div class="annotation">
    341. 

  341.               
    342. 

  342.               <div class="pilwrap ">
    343. 

  343.                 <a class="pilcrow" href="#section-20">&#182;</a>
    344. 

  344.               </div>
    345. 

  345.               <p>The DOM element for a todo item…</p>
    346. 

  346. 

  347.             </div>
    348. 

  348.             
    349. 

  349.             <div class="content"><div class='highlight'><pre>  <span class="hljs-keyword">var</span> TodoView = Backbone.View.extend({</pre></div></div>
    350. 

  350.             
    351. 

  351.         </li>
    352. 

  352.         
    353. 

  353.         
    354. 

  354.         <li id="section-21">
    355. 

  355.             <div class="annotation">
    356. 

  356.               
    357. 

  357.               <div class="pilwrap ">
    358. 

  358.                 <a class="pilcrow" href="#section-21">&#182;</a>
    359. 

  359.               </div>
    360. 

  360.               <p>… is a list tag.</p>
    361. 

  361. 

  362.             </div>
    363. 

  363.             
    364. 

  364.             <div class="content"><div class='highlight'><pre>    tagName:  <span class="hljs-string">"li"</span>,</pre></div></div>
    365. 

  365.             
    366. 

  366.         </li>
    367. 

  367.         
    368. 

  368.         
    369. 

  369.         <li id="section-22">
    370. 

  370.             <div class="annotation">
    371. 

  371.               
    372. 

  372.               <div class="pilwrap ">
    373. 

  373.                 <a class="pilcrow" href="#section-22">&#182;</a>
    374. 

  374.               </div>
    375. 

  375.               <p>Cache the template function for a single item.</p>
    376. 

  376. 

  377.             </div>
    378. 

  378.             
    379. 

  379.             <div class="content"><div class='highlight'><pre>    template: _.template($(<span class="hljs-string">'#item-template'</span>).html()),</pre></div></div>
    380. 

  380.             
    381. 

  381.         </li>
    382. 

  382.         
    383. 

  383.         
    384. 

  384.         <li id="section-23">
    385. 

  385.             <div class="annotation">
    386. 

  386.               
    387. 

  387.               <div class="pilwrap ">
    388. 

  388.                 <a class="pilcrow" href="#section-23">&#182;</a>
    389. 

  389.               </div>
    390. 

  390.               <p>The DOM events specific to an item.</p>
    391. 

  391. 

  392.             </div>
    393. 

  393.             
    394. 

  394.             <div class="content"><div class='highlight'><pre>    events: {
    395. 

  395.       <span class="hljs-string">"click .toggle"</span>   : <span class="hljs-string">"toggleDone"</span>,
    396. 

  396.       <span class="hljs-string">"dblclick .view"</span>  : <span class="hljs-string">"edit"</span>,
    397. 

  397.       <span class="hljs-string">"click a.destroy"</span> : <span class="hljs-string">"clear"</span>,
    398. 

  398.       <span class="hljs-string">"keypress .edit"</span>  : <span class="hljs-string">"updateOnEnter"</span>,
    399. 

  399.       <span class="hljs-string">"blur .edit"</span>      : <span class="hljs-string">"close"</span>
    400. 

  400.     },</pre></div></div>
    401. 

  401.             
    402. 

  402.         </li>
    403. 

  403.         
    404. 

  404.         
    405. 

  405.         <li id="section-24">
    406. 

  406.             <div class="annotation">
    407. 

  407.               
    408. 

  408.               <div class="pilwrap ">
    409. 

  409.                 <a class="pilcrow" href="#section-24">&#182;</a>
    410. 

  410.               </div>
    411. 

  411.               <p>The TodoView listens for changes to its model, re-rendering. Since there’s
    412. 

  412. a one-to-one correspondence between a <strong>Todo</strong> and a <strong>TodoView</strong> in this
    413. 

  413. app, we set a direct reference on the model for convenience.</p>
    414. 

  414. 

  415.             </div>
    416. 

  416.             
    417. 

  417.             <div class="content"><div class='highlight'><pre>    initialize: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    418. 

  418.       <span class="hljs-keyword">this</span>.listenTo(<span class="hljs-keyword">this</span>.model, <span class="hljs-string">'change'</span>, <span class="hljs-keyword">this</span>.render);
    419. 

  419.       <span class="hljs-keyword">this</span>.listenTo(<span class="hljs-keyword">this</span>.model, <span class="hljs-string">'destroy'</span>, <span class="hljs-keyword">this</span>.remove);
    420. 

  420.     },</pre></div></div>
    421. 

  421.             
    422. 

  422.         </li>
    423. 

  423.         
    424. 

  424.         
    425. 

  425.         <li id="section-25">
    426. 

  426.             <div class="annotation">
    427. 

  427.               
    428. 

  428.               <div class="pilwrap ">
    429. 

  429.                 <a class="pilcrow" href="#section-25">&#182;</a>
    430. 

  430.               </div>
    431. 

  431.               <p>Re-render the titles of the todo item.</p>
    432. 

  432. 

  433.             </div>
    434. 

  434.             
    435. 

  435.             <div class="content"><div class='highlight'><pre>    render: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    436. 

  436.       <span class="hljs-keyword">this</span>.$el.html(<span class="hljs-keyword">this</span>.template(<span class="hljs-keyword">this</span>.model.toJSON()));
    437. 

  437.       <span class="hljs-keyword">this</span>.$el.toggleClass(<span class="hljs-string">'done'</span>, <span class="hljs-keyword">this</span>.model.get(<span class="hljs-string">'done'</span>));
    438. 

  438.       <span class="hljs-keyword">this</span>.input = <span class="hljs-keyword">this</span>.$(<span class="hljs-string">'.edit'</span>);
    439. 

  439.       <span class="hljs-keyword">return</span> <span class="hljs-keyword">this</span>;
    440. 

  440.     },</pre></div></div>
    441. 

  441.             
    442. 

  442.         </li>
    443. 

  443.         
    444. 

  444.         
    445. 

  445.         <li id="section-26">
    446. 

  446.             <div class="annotation">
    447. 

  447.               
    448. 

  448.               <div class="pilwrap ">
    449. 

  449.                 <a class="pilcrow" href="#section-26">&#182;</a>
    450. 

  450.               </div>
    451. 

  451.               <p>Toggle the <code>&quot;done&quot;</code> state of the model.</p>
    452. 

  452. 

  453.             </div>
    454. 

  454.             
    455. 

  455.             <div class="content"><div class='highlight'><pre>    toggleDone: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    456. 

  456.       <span class="hljs-keyword">this</span>.model.toggle();
    457. 

  457.     },</pre></div></div>
    458. 

  458.             
    459. 

  459.         </li>
    460. 

  460.         
    461. 

  461.         
    462. 

  462.         <li id="section-27">
    463. 

  463.             <div class="annotation">
    464. 

  464.               
    465. 

  465.               <div class="pilwrap ">
    466. 

  466.                 <a class="pilcrow" href="#section-27">&#182;</a>
    467. 

  467.               </div>
    468. 

  468.               <p>Switch this view into <code>&quot;editing&quot;</code> mode, displaying the input field.</p>
    469. 

  469. 

  470.             </div>
    471. 

  471.             
    472. 

  472.             <div class="content"><div class='highlight'><pre>    edit: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    473. 

  473.       <span class="hljs-keyword">this</span>.$el.addClass(<span class="hljs-string">"editing"</span>);
    474. 

  474.       <span class="hljs-keyword">this</span>.input.focus();
    475. 

  475.     },</pre></div></div>
    476. 

  476.             
    477. 

  477.         </li>
    478. 

  478.         
    479. 

  479.         
    480. 

  480.         <li id="section-28">
    481. 

  481.             <div class="annotation">
    482. 

  482.               
    483. 

  483.               <div class="pilwrap ">
    484. 

  484.                 <a class="pilcrow" href="#section-28">&#182;</a>
    485. 

  485.               </div>
    486. 

  486.               <p>Close the <code>&quot;editing&quot;</code> mode, saving changes to the todo.</p>
    487. 

  487. 

  488.             </div>
    489. 

  489.             
    490. 

  490.             <div class="content"><div class='highlight'><pre>    close: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    491. 

  491.       <span class="hljs-keyword">var</span> value = <span class="hljs-keyword">this</span>.input.val();
    492. 

  492.       <span class="hljs-keyword">if</span> (!value) {
    493. 

  493.         <span class="hljs-keyword">this</span>.clear();
    494. 

  494.       } <span class="hljs-keyword">else</span> {
    495. 

  495.         <span class="hljs-keyword">this</span>.model.save({title: value});
    496. 

  496.         <span class="hljs-keyword">this</span>.$el.removeClass(<span class="hljs-string">"editing"</span>);
    497. 

  497.       }
    498. 

  498.     },</pre></div></div>
    499. 

  499.             
    500. 

  500.         </li>
    501. 

  501.         
    502. 

  502.         
    503. 

  503.         <li id="section-29">
    504. 

  504.             <div class="annotation">
    505. 

  505.               
    506. 

  506.               <div class="pilwrap ">
    507. 

  507.                 <a class="pilcrow" href="#section-29">&#182;</a>
    508. 

  508.               </div>
    509. 

  509.               <p>If you hit <code>enter</code>, we’re through editing the item.</p>
    510. 

  510. 

  511.             </div>
    512. 

  512.             
    513. 

  513.             <div class="content"><div class='highlight'><pre>    updateOnEnter: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">e</span>) </span>{
    514. 

  514.       <span class="hljs-keyword">if</span> (e.keyCode == <span class="hljs-number">13</span>) <span class="hljs-keyword">this</span>.close();
    515. 

  515.     },</pre></div></div>
    516. 

  516.             
    517. 

  517.         </li>
    518. 

  518.         
    519. 

  519.         
    520. 

  520.         <li id="section-30">
    521. 

  521.             <div class="annotation">
    522. 

  522.               
    523. 

  523.               <div class="pilwrap ">
    524. 

  524.                 <a class="pilcrow" href="#section-30">&#182;</a>
    525. 

  525.               </div>
    526. 

  526.               <p>Remove the item, destroy the model.</p>
    527. 

  527. 

  528.             </div>
    529. 

  529.             
    530. 

  530.             <div class="content"><div class='highlight'><pre>    clear: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    531. 

  531.       <span class="hljs-keyword">this</span>.model.destroy();
    532. 

  532.     }
    533. 

  533. 

  534.   });</pre></div></div>
    535. 

  535.             
    536. 

  536.         </li>
    537. 

  537.         
    538. 

  538.         
    539. 

  539.         <li id="section-31">
    540. 

  540.             <div class="annotation">
    541. 

  541.               
    542. 

  542.               <div class="pilwrap ">
    543. 

  543.                 <a class="pilcrow" href="#section-31">&#182;</a>
    544. 

  544.               </div>
    545. 

  545.               <h2 id="the-application">The Application</h2>
    546. 

  546. 

  547.             </div>
    548. 

  548.             
    549. 

  549.         </li>
    550. 

  550.         
    551. 

  551.         
    552. 

  552.         <li id="section-32">
    553. 

  553.             <div class="annotation">
    554. 

  554.               
    555. 

  555.               <div class="pilwrap ">
    556. 

  556.                 <a class="pilcrow" href="#section-32">&#182;</a>
    557. 

  557.               </div>
    558. 

  558.               
    559. 

  559.             </div>
    560. 

  560.             
    561. 

  561.         </li>
    562. 

  562.         
    563. 

  563.         
    564. 

  564.         <li id="section-33">
    565. 

  565.             <div class="annotation">
    566. 

  566.               
    567. 

  567.               <div class="pilwrap ">
    568. 

  568.                 <a class="pilcrow" href="#section-33">&#182;</a>
    569. 

  569.               </div>
    570. 

  570.               <p>Our overall <strong>AppView</strong> is the top-level piece of UI.</p>
    571. 

  571. 

  572.             </div>
    573. 

  573.             
    574. 

  574.             <div class="content"><div class='highlight'><pre>  <span class="hljs-keyword">var</span> AppView = Backbone.View.extend({</pre></div></div>
    575. 

  575.             
    576. 

  576.         </li>
    577. 

  577.         
    578. 

  578.         
    579. 

  579.         <li id="section-34">
    580. 

  580.             <div class="annotation">
    581. 

  581.               
    582. 

  582.               <div class="pilwrap ">
    583. 

  583.                 <a class="pilcrow" href="#section-34">&#182;</a>
    584. 

  584.               </div>
    585. 

  585.               <p>Instead of generating a new element, bind to the existing skeleton of
    586. 

  586. the App already present in the HTML.</p>
    587. 

  587. 

  588.             </div>
    589. 

  589.             
    590. 

  590.             <div class="content"><div class='highlight'><pre>    el: $(<span class="hljs-string">"#todoapp"</span>),</pre></div></div>
    591. 

  591.             
    592. 

  592.         </li>
    593. 

  593.         
    594. 

  594.         
    595. 

  595.         <li id="section-35">
    596. 

  596.             <div class="annotation">
    597. 

  597.               
    598. 

  598.               <div class="pilwrap ">
    599. 

  599.                 <a class="pilcrow" href="#section-35">&#182;</a>
    600. 

  600.               </div>
    601. 

  601.               <p>Our template for the line of statistics at the bottom of the app.</p>
    602. 

  602. 

  603.             </div>
    604. 

  604.             
    605. 

  605.             <div class="content"><div class='highlight'><pre>    statsTemplate: _.template($(<span class="hljs-string">'#stats-template'</span>).html()),</pre></div></div>
    606. 

  606.             
    607. 

  607.         </li>
    608. 

  608.         
    609. 

  609.         
    610. 

  610.         <li id="section-36">
    611. 

  611.             <div class="annotation">
    612. 

  612.               
    613. 

  613.               <div class="pilwrap ">
    614. 

  614.                 <a class="pilcrow" href="#section-36">&#182;</a>
    615. 

  615.               </div>
    616. 

  616.               <p>Delegated events for creating new items, and clearing completed ones.</p>
    617. 

  617. 

  618.             </div>
    619. 

  619.             
    620. 

  620.             <div class="content"><div class='highlight'><pre>    events: {
    621. 

  621.       <span class="hljs-string">"keypress #new-todo"</span>:  <span class="hljs-string">"createOnEnter"</span>,
    622. 

  622.       <span class="hljs-string">"click #clear-completed"</span>: <span class="hljs-string">"clearCompleted"</span>,
    623. 

  623.       <span class="hljs-string">"click #toggle-all"</span>: <span class="hljs-string">"toggleAllComplete"</span>
    624. 

  624.     },</pre></div></div>
    625. 

  625.             
    626. 

  626.         </li>
    627. 

  627.         
    628. 

  628.         
    629. 

  629.         <li id="section-37">
    630. 

  630.             <div class="annotation">
    631. 

  631.               
    632. 

  632.               <div class="pilwrap ">
    633. 

  633.                 <a class="pilcrow" href="#section-37">&#182;</a>
    634. 

  634.               </div>
    635. 

  635.               <p>At initialization we bind to the relevant events on the <code>Todos</code>
    636. 

  636. collection, when items are added or changed. Kick things off by
    637. 

  637. loading any preexisting todos that might be saved in <em>localStorage</em>.</p>
    638. 

  638. 

  639.             </div>
    640. 

  640.             
    641. 

  641.             <div class="content"><div class='highlight'><pre>    initialize: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    642. 

  642. 

  643.       <span class="hljs-keyword">this</span>.input = <span class="hljs-keyword">this</span>.$(<span class="hljs-string">"#new-todo"</span>);
    644. 

  644.       <span class="hljs-keyword">this</span>.allCheckbox = <span class="hljs-keyword">this</span>.$(<span class="hljs-string">"#toggle-all"</span>)[<span class="hljs-number">0</span>];
    645. 

  645. 

  646.       <span class="hljs-keyword">this</span>.listenTo(Todos, <span class="hljs-string">'add'</span>, <span class="hljs-keyword">this</span>.addOne);
    647. 

  647.       <span class="hljs-keyword">this</span>.listenTo(Todos, <span class="hljs-string">'reset'</span>, <span class="hljs-keyword">this</span>.addAll);
    648. 

  648.       <span class="hljs-keyword">this</span>.listenTo(Todos, <span class="hljs-string">'all'</span>, <span class="hljs-keyword">this</span>.render);
    649. 

  649. 

  650.       <span class="hljs-keyword">this</span>.footer = <span class="hljs-keyword">this</span>.$(<span class="hljs-string">'footer'</span>);
    651. 

  651.       <span class="hljs-keyword">this</span>.main = $(<span class="hljs-string">'#main'</span>);
    652. 

  652. 

  653.       Todos.fetch();
    654. 

  654.     },</pre></div></div>
    655. 

  655.             
    656. 

  656.         </li>
    657. 

  657.         
    658. 

  658.         
    659. 

  659.         <li id="section-38">
    660. 

  660.             <div class="annotation">
    661. 

  661.               
    662. 

  662.               <div class="pilwrap ">
    663. 

  663.                 <a class="pilcrow" href="#section-38">&#182;</a>
    664. 

  664.               </div>
    665. 

  665.               <p>Re-rendering the App just means refreshing the statistics – the rest
    666. 

  666. of the app doesn’t change.</p>
    667. 

  667. 

  668.             </div>
    669. 

  669.             
    670. 

  670.             <div class="content"><div class='highlight'><pre>    render: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    671. 

  671.       <span class="hljs-keyword">var</span> done = Todos.done().length;
    672. 

  672.       <span class="hljs-keyword">var</span> remaining = Todos.remaining().length;
    673. 

  673. 

  674.       <span class="hljs-keyword">if</span> (Todos.length) {
    675. 

  675.         <span class="hljs-keyword">this</span>.main.show();
    676. 

  676.         <span class="hljs-keyword">this</span>.footer.show();
    677. 

  677.         <span class="hljs-keyword">this</span>.footer.html(<span class="hljs-keyword">this</span>.statsTemplate({done: done, remaining: remaining}));
    678. 

  678.       } <span class="hljs-keyword">else</span> {
    679. 

  679.         <span class="hljs-keyword">this</span>.main.hide();
    680. 

  680.         <span class="hljs-keyword">this</span>.footer.hide();
    681. 

  681.       }
    682. 

  682. 

  683.       <span class="hljs-keyword">this</span>.allCheckbox.checked = !remaining;
    684. 

  684.     },</pre></div></div>
    685. 

  685.             
    686. 

  686.         </li>
    687. 

  687.         
    688. 

  688.         
    689. 

  689.         <li id="section-39">
    690. 

  690.             <div class="annotation">
    691. 

  691.               
    692. 

  692.               <div class="pilwrap ">
    693. 

  693.                 <a class="pilcrow" href="#section-39">&#182;</a>
    694. 

  694.               </div>
    695. 

  695.               <p>Add a single todo item to the list by creating a view for it, and
    696. 

  696. appending its element to the <code>&lt;ul&gt;</code>.</p>
    697. 

  697. 

  698.             </div>
    699. 

  699.             
    700. 

  700.             <div class="content"><div class='highlight'><pre>    addOne: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">todo</span>) </span>{
    701. 

  701.       <span class="hljs-keyword">var</span> view = <span class="hljs-keyword">new</span> TodoView({model: todo});
    702. 

  702.       <span class="hljs-keyword">this</span>.$(<span class="hljs-string">"#todo-list"</span>).append(view.render().el);
    703. 

  703.     },</pre></div></div>
    704. 

  704.             
    705. 

  705.         </li>
    706. 

  706.         
    707. 

  707.         
    708. 

  708.         <li id="section-40">
    709. 

  709.             <div class="annotation">
    710. 

  710.               
    711. 

  711.               <div class="pilwrap ">
    712. 

  712.                 <a class="pilcrow" href="#section-40">&#182;</a>
    713. 

  713.               </div>
    714. 

  714.               <p>Add all items in the <strong>Todos</strong> collection at once.</p>
    715. 

  715. 

  716.             </div>
    717. 

  717.             
    718. 

  718.             <div class="content"><div class='highlight'><pre>    addAll: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    719. 

  719.       Todos.each(<span class="hljs-keyword">this</span>.addOne, <span class="hljs-keyword">this</span>);
    720. 

  720.     },</pre></div></div>
    721. 

  721.             
    722. 

  722.         </li>
    723. 

  723.         
    724. 

  724.         
    725. 

  725.         <li id="section-41">
    726. 

  726.             <div class="annotation">
    727. 

  727.               
    728. 

  728.               <div class="pilwrap ">
    729. 

  729.                 <a class="pilcrow" href="#section-41">&#182;</a>
    730. 

  730.               </div>
    731. 

  731.               <p>If you hit return in the main input field, create new <strong>Todo</strong> model,
    732. 

  732. persisting it to <em>localStorage</em>.</p>
    733. 

  733. 

  734.             </div>
    735. 

  735.             
    736. 

  736.             <div class="content"><div class='highlight'><pre>    createOnEnter: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">e</span>) </span>{
    737. 

  737.       <span class="hljs-keyword">if</span> (e.keyCode != <span class="hljs-number">13</span>) <span class="hljs-keyword">return</span>;
    738. 

  738.       <span class="hljs-keyword">if</span> (!<span class="hljs-keyword">this</span>.input.val()) <span class="hljs-keyword">return</span>;
    739. 

  739. 

  740.       Todos.create({title: <span class="hljs-keyword">this</span>.input.val()});
    741. 

  741.       <span class="hljs-keyword">this</span>.input.val(<span class="hljs-string">''</span>);
    742. 

  742.     },</pre></div></div>
    743. 

  743.             
    744. 

  744.         </li>
    745. 

  745.         
    746. 

  746.         
    747. 

  747.         <li id="section-42">
    748. 

  748.             <div class="annotation">
    749. 

  749.               
    750. 

  750.               <div class="pilwrap ">
    751. 

  751.                 <a class="pilcrow" href="#section-42">&#182;</a>
    752. 

  752.               </div>
    753. 

  753.               <p>Clear all done todo items, destroying their models.</p>
    754. 

  754. 

  755.             </div>
    756. 

  756.             
    757. 

  757.             <div class="content"><div class='highlight'><pre>    clearCompleted: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params"></span>) </span>{
    758. 

  758.       _.invoke(Todos.done(), <span class="hljs-string">'destroy'</span>);
    759. 

  759.       <span class="hljs-keyword">return</span> <span class="hljs-literal">false</span>;
    760. 

  760.     },
    761. 

  761. 

  762.     toggleAllComplete: <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params"></span>) </span>{
    763. 

  763.       <span class="hljs-keyword">var</span> done = <span class="hljs-keyword">this</span>.allCheckbox.checked;
    764. 

  764.       Todos.each(<span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">todo</span>) </span>{ todo.save({<span class="hljs-string">'done'</span>: done}); });
    765. 

  765.     }
    766. 

  766. 

  767.   });</pre></div></div>
    768. 

  768.             
    769. 

  769.         </li>
    770. 

  770.         
    771. 

  771.         
    772. 

  772.         <li id="section-43">
    773. 

  773.             <div class="annotation">
    774. 

  774.               
    775. 

  775.               <div class="pilwrap ">
    776. 

  776.                 <a class="pilcrow" href="#section-43">&#182;</a>
    777. 

  777.               </div>
    778. 

  778.               <p>Finally, we kick things off by creating the <strong>App</strong>.</p>
    779. 

  779. 

  780.             </div>
    781. 

  781.             
    782. 

  782.             <div class="content"><div class='highlight'><pre>  <span class="hljs-keyword">var</span> App = <span class="hljs-keyword">new</span> AppView;
    783. 

  783. 

  784. });</pre></div></div>
    785. 

  785.             
    786. 

  786.         </li>
    787. 

  787.         
    788. 

  788.     </ul>
    789. 

  789.   </div>
    790. 

  790. </body>
    791. 

  791. </html>
    792. 

  792.