readme.html 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230
  1. <!DOCTYPE html><html><head><meta charset="utf-8"><style>body {
  2. width: 45em;
  3. border: 1px solid #ddd;
  4. outline: 1300px solid #fff;
  5. margin: 16px auto;
  6. }
  7. body .markdown-body
  8. {
  9. padding: 30px;
  10. }
  11. @font-face {
  12. font-family: fontawesome-mini;
  13. src: url(data:font/woff;charset=utf-8;base64,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) format('woff');
  14. }
  15. @font-face {
  16. font-family: octicons-anchor;
  17. src: url(data:font/woff;charset=utf-8;base64,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) format('woff');
  18. }
  19. .markdown-body {
  20. font-family: sans-serif;
  21. -ms-text-size-adjust: 100%;
  22. -webkit-text-size-adjust: 100%;
  23. color: #333333;
  24. overflow: hidden;
  25. font-family: "Helvetica Neue", Helvetica, "Segoe UI", Arial, freesans, sans-serif;
  26. font-size: 16px;
  27. line-height: 1.6;
  28. word-wrap: break-word;
  29. }
  30. .markdown-body a {
  31. background: transparent;
  32. }
  33. .markdown-body a:active,
  34. .markdown-body a:hover {
  35. outline: 0;
  36. }
  37. .markdown-body b,
  38. .markdown-body strong {
  39. font-weight: bold;
  40. }
  41. .markdown-body mark {
  42. background: #ff0;
  43. color: #000;
  44. font-style: italic;
  45. font-weight: bold;
  46. }
  47. .markdown-body sub,
  48. .markdown-body sup {
  49. font-size: 75%;
  50. line-height: 0;
  51. position: relative;
  52. vertical-align: baseline;
  53. }
  54. .markdown-body sup {
  55. top: -0.5em;
  56. }
  57. .markdown-body sub {
  58. bottom: -0.25em;
  59. }
  60. .markdown-body h1 {
  61. font-size: 2em;
  62. margin: 0.67em 0;
  63. }
  64. .markdown-body img {
  65. border: 0;
  66. }
  67. .markdown-body hr {
  68. -moz-box-sizing: content-box;
  69. box-sizing: content-box;
  70. height: 0;
  71. }
  72. .markdown-body pre {
  73. overflow: auto;
  74. }
  75. .markdown-body code,
  76. .markdown-body kbd,
  77. .markdown-body pre,
  78. .markdown-body samp {
  79. font-family: monospace, monospace;
  80. font-size: 1em;
  81. }
  82. .markdown-body input {
  83. color: inherit;
  84. font: inherit;
  85. margin: 0;
  86. }
  87. .markdown-body html input[disabled] {
  88. cursor: default;
  89. }
  90. .markdown-body input {
  91. line-height: normal;
  92. }
  93. .markdown-body input[type="checkbox"] {
  94. box-sizing: border-box;
  95. padding: 0;
  96. }
  97. .markdown-body table {
  98. border-collapse: collapse;
  99. border-spacing: 0;
  100. }
  101. .markdown-body td,
  102. .markdown-body th {
  103. padding: 0;
  104. }
  105. .markdown-body .codehilitetable {
  106. border: 0;
  107. border-spacing: 0;
  108. }
  109. .markdown-body .codehilitetable tr {
  110. border: 0;
  111. }
  112. .markdown-body .codehilitetable pre,
  113. .markdown-body .codehilitetable div.codehilite {
  114. margin: 0;
  115. }
  116. .markdown-body .linenos,
  117. .markdown-body .code,
  118. .markdown-body .codehilitetable td {
  119. border: 0;
  120. padding: 0;
  121. }
  122. .markdown-body td:not(.linenos) .linenodiv {
  123. padding: 0 !important;
  124. }
  125. .markdown-body .code {
  126. width: 100%;
  127. }
  128. .markdown-body .linenos div pre,
  129. .markdown-body .linenodiv pre,
  130. .markdown-body .linenodiv {
  131. border: 0;
  132. -webkit-border-radius: 0;
  133. -moz-border-radius: 0;
  134. border-radius: 0;
  135. -webkit-border-top-left-radius: 3px;
  136. -webkit-border-bottom-left-radius: 3px;
  137. -moz-border-radius-topleft: 3px;
  138. -moz-border-radius-bottomleft: 3px;
  139. border-top-left-radius: 3px;
  140. border-bottom-left-radius: 3px;
  141. }
  142. .markdown-body .code div pre,
  143. .markdown-body .code div {
  144. border: 0;
  145. -webkit-border-radius: 0;
  146. -moz-border-radius: 0;
  147. border-radius: 0;
  148. -webkit-border-top-right-radius: 3px;
  149. -webkit-border-bottom-right-radius: 3px;
  150. -moz-border-radius-topright: 3px;
  151. -moz-border-radius-bottomright: 3px;
  152. border-top-right-radius: 3px;
  153. border-bottom-right-radius: 3px;
  154. }
  155. .markdown-body * {
  156. -moz-box-sizing: border-box;
  157. box-sizing: border-box;
  158. }
  159. .markdown-body input {
  160. font: 13px Helvetica, arial, freesans, clean, sans-serif, "Segoe UI Emoji", "Segoe UI Symbol";
  161. line-height: 1.4;
  162. }
  163. .markdown-body a {
  164. color: #4183c4;
  165. text-decoration: none;
  166. }
  167. .markdown-body a:hover,
  168. .markdown-body a:focus,
  169. .markdown-body a:active {
  170. text-decoration: underline;
  171. }
  172. .markdown-body hr {
  173. height: 0;
  174. margin: 15px 0;
  175. overflow: hidden;
  176. background: transparent;
  177. border: 0;
  178. border-bottom: 1px solid #ddd;
  179. }
  180. .markdown-body hr:before,
  181. .markdown-body hr:after {
  182. display: table;
  183. content: " ";
  184. }
  185. .markdown-body hr:after {
  186. clear: both;
  187. }
  188. .markdown-body h1,
  189. .markdown-body h2,
  190. .markdown-body h3,
  191. .markdown-body h4,
  192. .markdown-body h5,
  193. .markdown-body h6 {
  194. margin-top: 15px;
  195. margin-bottom: 15px;
  196. line-height: 1.1;
  197. }
  198. .markdown-body h1 {
  199. font-size: 30px;
  200. }
  201. .markdown-body h2 {
  202. font-size: 21px;
  203. }
  204. .markdown-body h3 {
  205. font-size: 16px;
  206. }
  207. .markdown-body h4 {
  208. font-size: 14px;
  209. }
  210. .markdown-body h5 {
  211. font-size: 12px;
  212. }
  213. .markdown-body h6 {
  214. font-size: 11px;
  215. }
  216. .markdown-body blockquote {
  217. margin: 0;
  218. }
  219. .markdown-body ul,
  220. .markdown-body ol {
  221. padding: 0;
  222. margin-top: 0;
  223. margin-bottom: 0;
  224. }
  225. .markdown-body ol ol,
  226. .markdown-body ul ol {
  227. list-style-type: lower-roman;
  228. }
  229. .markdown-body ul ul ol,
  230. .markdown-body ul ol ol,
  231. .markdown-body ol ul ol,
  232. .markdown-body ol ol ol {
  233. list-style-type: lower-alpha;
  234. }
  235. .markdown-body dd {
  236. margin-left: 0;
  237. }
  238. .markdown-body code,
  239. .markdown-body pre,
  240. .markdown-body samp {
  241. font-family: Consolas, "Liberation Mono", Menlo, Courier, monospace;
  242. font-size: 12px;
  243. }
  244. .markdown-body pre {
  245. margin-top: 0;
  246. margin-bottom: 0;
  247. }
  248. .markdown-body kbd {
  249. background-color: #e7e7e7;
  250. background-image: -moz-linear-gradient(#fefefe, #e7e7e7);
  251. background-image: -webkit-linear-gradient(#fefefe, #e7e7e7);
  252. background-image: linear-gradient(#fefefe, #e7e7e7);
  253. background-repeat: repeat-x;
  254. border-radius: 2px;
  255. border: 1px solid #cfcfcf;
  256. color: #000;
  257. padding: 3px 5px;
  258. line-height: 10px;
  259. font: 11px Consolas, "Liberation Mono", Menlo, Courier, monospace;
  260. display: inline-block;
  261. }
  262. .markdown-body>*:first-child {
  263. margin-top: 0 !important;
  264. }
  265. .markdown-body>*:last-child {
  266. margin-bottom: 0 !important;
  267. }
  268. .markdown-body .headeranchor-link {
  269. position: absolute;
  270. top: 0;
  271. bottom: 0;
  272. left: 0;
  273. display: block;
  274. padding-right: 6px;
  275. padding-left: 30px;
  276. margin-left: -30px;
  277. }
  278. .markdown-body .headeranchor-link:focus {
  279. outline: none;
  280. }
  281. .markdown-body h1,
  282. .markdown-body h2,
  283. .markdown-body h3,
  284. .markdown-body h4,
  285. .markdown-body h5,
  286. .markdown-body h6 {
  287. position: relative;
  288. margin-top: 1em;
  289. margin-bottom: 16px;
  290. font-weight: bold;
  291. line-height: 1.4;
  292. }
  293. .markdown-body h1 .headeranchor,
  294. .markdown-body h2 .headeranchor,
  295. .markdown-body h3 .headeranchor,
  296. .markdown-body h4 .headeranchor,
  297. .markdown-body h5 .headeranchor,
  298. .markdown-body h6 .headeranchor {
  299. display: none;
  300. color: #000;
  301. vertical-align: middle;
  302. }
  303. .markdown-body h1:hover .headeranchor-link,
  304. .markdown-body h2:hover .headeranchor-link,
  305. .markdown-body h3:hover .headeranchor-link,
  306. .markdown-body h4:hover .headeranchor-link,
  307. .markdown-body h5:hover .headeranchor-link,
  308. .markdown-body h6:hover .headeranchor-link {
  309. height: 1em;
  310. padding-left: 8px;
  311. margin-left: -30px;
  312. line-height: 1;
  313. text-decoration: none;
  314. }
  315. .markdown-body h1:hover .headeranchor-link .headeranchor,
  316. .markdown-body h2:hover .headeranchor-link .headeranchor,
  317. .markdown-body h3:hover .headeranchor-link .headeranchor,
  318. .markdown-body h4:hover .headeranchor-link .headeranchor,
  319. .markdown-body h5:hover .headeranchor-link .headeranchor,
  320. .markdown-body h6:hover .headeranchor-link .headeranchor {
  321. display: inline-block;
  322. }
  323. .markdown-body h1 {
  324. padding-bottom: 0.3em;
  325. font-size: 2.25em;
  326. line-height: 1.2;
  327. border-bottom: 1px solid #eee;
  328. }
  329. .markdown-body h2 {
  330. padding-bottom: 0.3em;
  331. font-size: 1.75em;
  332. line-height: 1.225;
  333. border-bottom: 1px solid #eee;
  334. }
  335. .markdown-body h3 {
  336. font-size: 1.5em;
  337. line-height: 1.43;
  338. }
  339. .markdown-body h4 {
  340. font-size: 1.25em;
  341. }
  342. .markdown-body h5 {
  343. font-size: 1em;
  344. }
  345. .markdown-body h6 {
  346. font-size: 1em;
  347. color: #777;
  348. }
  349. .markdown-body p,
  350. .markdown-body blockquote,
  351. .markdown-body ul,
  352. .markdown-body ol,
  353. .markdown-body dl,
  354. .markdown-body table,
  355. .markdown-body pre,
  356. .markdown-body .admonition {
  357. margin-top: 0;
  358. margin-bottom: 16px;
  359. }
  360. .markdown-body hr {
  361. height: 4px;
  362. padding: 0;
  363. margin: 16px 0;
  364. background-color: #e7e7e7;
  365. border: 0 none;
  366. }
  367. .markdown-body ul,
  368. .markdown-body ol {
  369. padding-left: 2em;
  370. }
  371. .markdown-body ul ul,
  372. .markdown-body ul ol,
  373. .markdown-body ol ol,
  374. .markdown-body ol ul {
  375. margin-top: 0;
  376. margin-bottom: 0;
  377. }
  378. .markdown-body li>p {
  379. margin-top: 16px;
  380. }
  381. .markdown-body dl {
  382. padding: 0;
  383. }
  384. .markdown-body dl dt {
  385. padding: 0;
  386. margin-top: 16px;
  387. font-size: 1em;
  388. font-style: italic;
  389. font-weight: bold;
  390. }
  391. .markdown-body dl dd {
  392. padding: 0 16px;
  393. margin-bottom: 16px;
  394. }
  395. .markdown-body blockquote {
  396. padding: 0 15px;
  397. color: #777;
  398. border-left: 4px solid #ddd;
  399. }
  400. .markdown-body blockquote>:first-child {
  401. margin-top: 0;
  402. }
  403. .markdown-body blockquote>:last-child {
  404. margin-bottom: 0;
  405. }
  406. .markdown-body table {
  407. display: block;
  408. width: 100%;
  409. overflow: auto;
  410. word-break: normal;
  411. word-break: keep-all;
  412. }
  413. .markdown-body table th {
  414. font-weight: bold;
  415. }
  416. .markdown-body table th,
  417. .markdown-body table td {
  418. padding: 6px 13px;
  419. border: 1px solid #ddd;
  420. }
  421. .markdown-body table tr {
  422. background-color: #fff;
  423. border-top: 1px solid #ccc;
  424. }
  425. .markdown-body table tr:nth-child(2n) {
  426. background-color: #f8f8f8;
  427. }
  428. .markdown-body img {
  429. max-width: 100%;
  430. -moz-box-sizing: border-box;
  431. box-sizing: border-box;
  432. }
  433. .markdown-body code,
  434. .markdown-body samp {
  435. padding: 0;
  436. padding-top: 0.2em;
  437. padding-bottom: 0.2em;
  438. margin: 0;
  439. font-size: 85%;
  440. background-color: rgba(0,0,0,0.04);
  441. border-radius: 3px;
  442. }
  443. .markdown-body code:before,
  444. .markdown-body code:after {
  445. letter-spacing: -0.2em;
  446. content: "\00a0";
  447. }
  448. .markdown-body pre>code {
  449. padding: 0;
  450. margin: 0;
  451. font-size: 100%;
  452. word-break: normal;
  453. white-space: pre;
  454. background: transparent;
  455. border: 0;
  456. }
  457. .markdown-body .codehilite {
  458. margin-bottom: 16px;
  459. }
  460. .markdown-body .codehilite pre,
  461. .markdown-body pre {
  462. padding: 16px;
  463. overflow: auto;
  464. font-size: 85%;
  465. line-height: 1.45;
  466. background-color: #f7f7f7;
  467. border-radius: 3px;
  468. }
  469. .markdown-body .codehilite pre {
  470. margin-bottom: 0;
  471. word-break: normal;
  472. }
  473. .markdown-body pre {
  474. word-wrap: normal;
  475. }
  476. .markdown-body pre code {
  477. display: inline;
  478. max-width: initial;
  479. padding: 0;
  480. margin: 0;
  481. overflow: initial;
  482. line-height: inherit;
  483. word-wrap: normal;
  484. background-color: transparent;
  485. border: 0;
  486. }
  487. .markdown-body pre code:before,
  488. .markdown-body pre code:after {
  489. content: normal;
  490. }
  491. /* Admonition */
  492. .markdown-body .admonition {
  493. -webkit-border-radius: 3px;
  494. -moz-border-radius: 3px;
  495. position: relative;
  496. border-radius: 3px;
  497. border: 1px solid #e0e0e0;
  498. border-left: 6px solid #333;
  499. padding: 10px 10px 10px 30px;
  500. }
  501. .markdown-body .admonition table {
  502. color: #333;
  503. }
  504. .markdown-body .admonition p {
  505. padding: 0;
  506. }
  507. .markdown-body .admonition-title {
  508. font-weight: bold;
  509. margin: 0;
  510. }
  511. .markdown-body .admonition>.admonition-title {
  512. color: #333;
  513. }
  514. .markdown-body .attention>.admonition-title {
  515. color: #a6d796;
  516. }
  517. .markdown-body .caution>.admonition-title {
  518. color: #d7a796;
  519. }
  520. .markdown-body .hint>.admonition-title {
  521. color: #96c6d7;
  522. }
  523. .markdown-body .danger>.admonition-title {
  524. color: #c25f77;
  525. }
  526. .markdown-body .question>.admonition-title {
  527. color: #96a6d7;
  528. }
  529. .markdown-body .note>.admonition-title {
  530. color: #d7c896;
  531. }
  532. .markdown-body .admonition:before,
  533. .markdown-body .attention:before,
  534. .markdown-body .caution:before,
  535. .markdown-body .hint:before,
  536. .markdown-body .danger:before,
  537. .markdown-body .question:before,
  538. .markdown-body .note:before {
  539. font: normal normal 16px fontawesome-mini;
  540. -moz-osx-font-smoothing: grayscale;
  541. -webkit-user-select: none;
  542. -moz-user-select: none;
  543. -ms-user-select: none;
  544. user-select: none;
  545. line-height: 1.5;
  546. color: #333;
  547. position: absolute;
  548. left: 0;
  549. top: 0;
  550. padding-top: 10px;
  551. padding-left: 10px;
  552. }
  553. .markdown-body .admonition:before {
  554. content: "\f056\00a0";
  555. color: 333;
  556. }
  557. .markdown-body .attention:before {
  558. content: "\f058\00a0";
  559. color: #a6d796;
  560. }
  561. .markdown-body .caution:before {
  562. content: "\f06a\00a0";
  563. color: #d7a796;
  564. }
  565. .markdown-body .hint:before {
  566. content: "\f05a\00a0";
  567. color: #96c6d7;
  568. }
  569. .markdown-body .danger:before {
  570. content: "\f057\00a0";
  571. color: #c25f77;
  572. }
  573. .markdown-body .question:before {
  574. content: "\f059\00a0";
  575. color: #96a6d7;
  576. }
  577. .markdown-body .note:before {
  578. content: "\f040\00a0";
  579. color: #d7c896;
  580. }
  581. .markdown-body .admonition::after {
  582. content: normal;
  583. }
  584. .markdown-body .attention {
  585. border-left: 6px solid #a6d796;
  586. }
  587. .markdown-body .caution {
  588. border-left: 6px solid #d7a796;
  589. }
  590. .markdown-body .hint {
  591. border-left: 6px solid #96c6d7;
  592. }
  593. .markdown-body .danger {
  594. border-left: 6px solid #c25f77;
  595. }
  596. .markdown-body .question {
  597. border-left: 6px solid #96a6d7;
  598. }
  599. .markdown-body .note {
  600. border-left: 6px solid #d7c896;
  601. }
  602. .markdown-body .admonition>*:first-child {
  603. margin-top: 0 !important;
  604. }
  605. .markdown-body .admonition>*:last-child {
  606. margin-bottom: 0 !important;
  607. }
  608. /* progress bar*/
  609. .markdown-body .progress {
  610. display: block;
  611. width: 300px;
  612. margin: 10px 0;
  613. height: 24px;
  614. -webkit-border-radius: 3px;
  615. -moz-border-radius: 3px;
  616. border-radius: 3px;
  617. background-color: #ededed;
  618. position: relative;
  619. box-shadow: inset -1px 1px 3px rgba(0, 0, 0, .1);
  620. }
  621. .markdown-body .progress-label {
  622. position: absolute;
  623. text-align: center;
  624. font-weight: bold;
  625. width: 100%; margin: 0;
  626. line-height: 24px;
  627. color: #333;
  628. text-shadow: 1px 1px 0 #fefefe, -1px -1px 0 #fefefe, -1px 1px 0 #fefefe, 1px -1px 0 #fefefe, 0 1px 0 #fefefe, 0 -1px 0 #fefefe, 1px 0 0 #fefefe, -1px 0 0 #fefefe, 1px 1px 2px #000;
  629. -webkit-font-smoothing: antialiased !important;
  630. white-space: nowrap;
  631. overflow: hidden;
  632. }
  633. .markdown-body .progress-bar {
  634. height: 24px;
  635. float: left;
  636. -webkit-border-radius: 3px;
  637. -moz-border-radius: 3px;
  638. border-radius: 3px;
  639. background-color: #96c6d7;
  640. box-shadow: inset 0 1px 0 rgba(255, 255, 255, .5), inset 0 -1px 0 rgba(0, 0, 0, .1);
  641. background-size: 30px 30px;
  642. background-image: -webkit-linear-gradient(
  643. 135deg, rgba(255, 255, 255, .4) 27%,
  644. transparent 27%,
  645. transparent 52%, rgba(255, 255, 255, .4) 52%,
  646. rgba(255, 255, 255, .4) 77%,
  647. transparent 77%, transparent
  648. );
  649. background-image: -moz-linear-gradient(
  650. 135deg,
  651. rgba(255, 255, 255, .4) 27%, transparent 27%,
  652. transparent 52%, rgba(255, 255, 255, .4) 52%,
  653. rgba(255, 255, 255, .4) 77%, transparent 77%,
  654. transparent
  655. );
  656. background-image: -ms-linear-gradient(
  657. 135deg,
  658. rgba(255, 255, 255, .4) 27%, transparent 27%,
  659. transparent 52%, rgba(255, 255, 255, .4) 52%,
  660. rgba(255, 255, 255, .4) 77%, transparent 77%,
  661. transparent
  662. );
  663. background-image: -o-linear-gradient(
  664. 135deg,
  665. rgba(255, 255, 255, .4) 27%, transparent 27%,
  666. transparent 52%, rgba(255, 255, 255, .4) 52%,
  667. rgba(255, 255, 255, .4) 77%, transparent 77%,
  668. transparent
  669. );
  670. background-image: linear-gradient(
  671. 135deg,
  672. rgba(255, 255, 255, .4) 27%, transparent 27%,
  673. transparent 52%, rgba(255, 255, 255, .4) 52%,
  674. rgba(255, 255, 255, .4) 77%, transparent 77%,
  675. transparent
  676. );
  677. }
  678. .markdown-body .progress-100plus .progress-bar {
  679. background-color: #a6d796;
  680. }
  681. .markdown-body .progress-80plus .progress-bar {
  682. background-color: #c6d796;
  683. }
  684. .markdown-body .progress-60plus .progress-bar {
  685. background-color: #d7c896;
  686. }
  687. .markdown-body .progress-40plus .progress-bar {
  688. background-color: #d7a796;
  689. }
  690. .markdown-body .progress-20plus .progress-bar {
  691. background-color: #d796a6;
  692. }
  693. .markdown-body .progress-0plus .progress-bar {
  694. background-color: #c25f77;
  695. }
  696. .markdown-body .candystripe-animate .progress-bar{
  697. -webkit-animation: animate-stripes 3s linear infinite;
  698. -moz-animation: animate-stripes 3s linear infinite;
  699. animation: animate-stripes 3s linear infinite;
  700. }
  701. @-webkit-keyframes animate-stripes {
  702. 0% {
  703. background-position: 0 0;
  704. }
  705. 100% {
  706. background-position: 60px 0;
  707. }
  708. }
  709. @-moz-keyframes animate-stripes {
  710. 0% {
  711. background-position: 0 0;
  712. }
  713. 100% {
  714. background-position: 60px 0;
  715. }
  716. }
  717. @keyframes animate-stripes {
  718. 0% {
  719. background-position: 0 0;
  720. }
  721. 100% {
  722. background-position: 60px 0;
  723. }
  724. }
  725. .markdown-body .gloss .progress-bar {
  726. box-shadow:
  727. inset 0 4px 12px rgba(255, 255, 255, .7),
  728. inset 0 -12px 0 rgba(0, 0, 0, .05);
  729. }
  730. /* Multimarkdown Critic Blocks */
  731. .markdown-body .critic_mark {
  732. background: #ff0;
  733. }
  734. .markdown-body .critic_delete {
  735. color: #c82829;
  736. text-decoration: line-through;
  737. }
  738. .markdown-body .critic_insert {
  739. color: #718c00 ;
  740. text-decoration: underline;
  741. }
  742. .markdown-body .critic_comment {
  743. color: #8e908c;
  744. font-style: italic;
  745. }
  746. .markdown-body .headeranchor {
  747. font: normal normal 16px octicons-anchor;
  748. line-height: 1;
  749. display: inline-block;
  750. text-decoration: none;
  751. -webkit-font-smoothing: antialiased;
  752. -moz-osx-font-smoothing: grayscale;
  753. -webkit-user-select: none;
  754. -moz-user-select: none;
  755. -ms-user-select: none;
  756. user-select: none;
  757. }
  758. .headeranchor:before {
  759. content: '\f05c';
  760. }
  761. .markdown-body .task-list-item {
  762. list-style-type: none;
  763. }
  764. .markdown-body .task-list-item+.task-list-item {
  765. margin-top: 3px;
  766. }
  767. .markdown-body .task-list-item input {
  768. margin: 0 4px 0.25em -20px;
  769. vertical-align: middle;
  770. }
  771. /* Media */
  772. @media only screen and (min-width: 480px) {
  773. .markdown-body {
  774. font-size:14px;
  775. }
  776. }
  777. @media only screen and (min-width: 768px) {
  778. .markdown-body {
  779. font-size:16px;
  780. }
  781. }
  782. @media print {
  783. .markdown-body * {
  784. background: transparent !important;
  785. color: black !important;
  786. filter:none !important;
  787. -ms-filter: none !important;
  788. }
  789. .markdown-body {
  790. font-size:12pt;
  791. max-width:100%;
  792. outline:none;
  793. border: 0;
  794. }
  795. .markdown-body a,
  796. .markdown-body a:visited {
  797. text-decoration: underline;
  798. }
  799. .markdown-body .headeranchor-link {
  800. display: none;
  801. }
  802. .markdown-body a[href]:after {
  803. content: " (" attr(href) ")";
  804. }
  805. .markdown-body abbr[title]:after {
  806. content: " (" attr(title) ")";
  807. }
  808. .markdown-body .ir a:after,
  809. .markdown-body a[href^="javascript:"]:after,
  810. .markdown-body a[href^="#"]:after {
  811. content: "";
  812. }
  813. .markdown-body pre {
  814. white-space: pre;
  815. white-space: pre-wrap;
  816. word-wrap: break-word;
  817. }
  818. .markdown-body pre,
  819. .markdown-body blockquote {
  820. border: 1px solid #999;
  821. padding-right: 1em;
  822. page-break-inside: avoid;
  823. }
  824. .markdown-body .progress,
  825. .markdown-body .progress-bar {
  826. -moz-box-shadow: none;
  827. -webkit-box-shadow: none;
  828. box-shadow: none;
  829. }
  830. .markdown-body .progress {
  831. border: 1px solid #ddd;
  832. }
  833. .markdown-body .progress-bar {
  834. height: 22px;
  835. border-right: 1px solid #ddd;
  836. }
  837. .markdown-body tr,
  838. .markdown-body img {
  839. page-break-inside: avoid;
  840. }
  841. .markdown-body img {
  842. max-width: 100% !important;
  843. }
  844. .markdown-body p,
  845. .markdown-body h2,
  846. .markdown-body h3 {
  847. orphans: 3;
  848. widows: 3;
  849. }
  850. .markdown-body h2,
  851. .markdown-body h3 {
  852. page-break-after: avoid;
  853. }
  854. }
  855. </style><title>readme</title></head><body><article class="markdown-body"><h2 id="vue-mvvm"><a name="user-content-vue-mvvm" href="#vue-mvvm" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>剖析Vue实现原理 - 如何实现双向绑定mvvm</h2>
  856. <blockquote>
  857. <p>本文能帮你做什么?<br />
  858. 1、了解vue的双向数据绑定原理以及核心代码模块<br />
  859. 2、缓解好奇心的同时了解如何实现双向绑定<br />
  860. 为了便于说明原理与实现,本文相关代码主要摘自<a href="https://github.com/vuejs/vue">vue源码</a>, 并进行了简化改造,相对较简陋,并未考虑到数组的处理、数据的循环依赖等,也难免存在一些问题,欢迎大家指正。不过这些并不会影响大家的阅读和理解,相信看完本文后对大家在阅读vue源码的时候会更有帮助<br />
  861. 本文所有相关代码均在github上面可找到 <a href="https://github.com/DMQ/mvvm"><a href="https://github.com/DMQ/mvvm"><a href="https://github.com/DMQ/mvvm">https://github.com/DMQ/mvvm</a></a></a></p>
  862. </blockquote>
  863. <h5 id="mvvmvue"><a name="user-content-mvvmvue" href="#mvvmvue" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>相信大家对mvvm双向绑定应该都不陌生了,一言不合上代码(可怜的代码),下面先看一个本文最终实现的效果吧,和vue一样的语法,如果还不了解双向绑定,猛戳<a href="">这里</a></h5>
  864. <pre><code>&lt;div id=&quot;mvvm-app&quot;&gt;
  865. &lt;input type=&quot;text&quot; v-model=&quot;word&quot;&gt;
  866. &lt;p&gt;{{word}}&lt;/p&gt;
  867. &lt;button v-on:click=&quot;sayHi&quot;&gt;change model&lt;/button&gt;
  868. &lt;/div&gt;
  869. &lt;script src=&quot;./js/observer.js&quot;&gt;&lt;/script&gt;
  870. &lt;script src=&quot;./js/watcher.js&quot;&gt;&lt;/script&gt;
  871. &lt;script src=&quot;./js/compile.js&quot;&gt;&lt;/script&gt;
  872. &lt;script src=&quot;./js/mvvm.js&quot;&gt;&lt;/script&gt;
  873. &lt;script&gt;
  874. var vm = new MVVM({
  875. el: '#mvvm-app',
  876. data: {
  877. word: 'Hello World!'
  878. },
  879. methods: {
  880. sayHi: function() {
  881. this.word = 'Hi, everybody!';
  882. }
  883. }
  884. });
  885. &lt;/script&gt;
  886. </code></pre>
  887. <p>效果:<br />
  888. <img alt="img1" src="///F://git/mvvm/img/1.gif" /></p>
  889. <h3 id="_1"><a name="user-content-_1" href="#_1" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>几种实现双向绑定的做法</h3>
  890. <p>目前几种主流的mvc(vm)框架都实现了单向数据绑定,而我所理解的双向数据绑定无非就是在单向绑定的基础上给可输入元素(input、textare等)添加了change(input)事件,来动态修改model和 view,并没有多高深。所以无需太过介怀是实现的单向或双向绑定。</p>
  891. <p>实现数据绑定的做法有大致如下几种:</p>
  892. <blockquote>
  893. <p>发布者-订阅者模式(backbone.js)</p>
  894. <p>脏值检查(angular.js) </p>
  895. <p>数据劫持(vue.js) </p>
  896. </blockquote>
  897. <p><strong>发布者-订阅者模式:</strong> 一般通过sub, pub的方式实现数据和视图的绑定监听,更新数据方式通常做法是 <code>vm.set('property', value)</code>,这里有篇文章讲的比较详细,有兴趣可点<a href="http://www.html-js.com/article/Study-of-twoway-data-binding-JavaScript-talk-about-JavaScript-every-day">这里</a></p>
  898. <p>这种方式现在毕竟太low了,我们更希望通过 <code>vm.property = value</code>这种方式更新数据,同时自动更新视图,于是有了下面两种方式</p>
  899. <p><strong>脏值检查:</strong> angular.js 是通过脏值检测的方式比对数据是否有变更,来决定是否更新视图,最简单的方式就是通过 <code>setInterval()</code> 定时轮询检测数据变动,当然Google不会这么low,angular只有在指定的事件触发时进入脏值检测,大致如下:</p>
  900. <ul>
  901. <li>DOM事件,譬如用户输入文本,点击按钮等。( ng-click ) </li>
  902. <li>XHR响应事件 ( $http ) </li>
  903. <li>浏览器Location变更事件 ( $location ) </li>
  904. <li>Timer事件( $timeout , $interval ) </li>
  905. <li>执行 $digest() 或 $apply()</li>
  906. </ul>
  907. <p><strong>数据劫持:</strong> vue.js 则是采用数据劫持结合发布者-订阅者模式的方式,通过<code>Object.defineProperty()</code>来劫持各个属性的<code>setter</code>,<code>getter</code>,在数据变动时发布消息给订阅者,触发相应的监听回调。</p>
  908. <h3 id="_2"><a name="user-content-_2" href="#_2" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>思路整理</h3>
  909. <p>已经了解到vue是通过数据劫持的方式来做数据绑定的,其中最核心的方法便是通过<code>Object.defineProperty()</code>来实现对属性的劫持,达到监听数据变动的目的,无疑这个方法是本文中最重要、最基础的内容之一,如果不熟悉defineProperty,猛戳<a href="https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty">这里</a><br />
  910. 整理了一下,要实现mvvm的双向绑定,就必须要实现以下几点:<br />
  911. 1、实现一个数据监听器Observer,能够对数据对象的所有属性进行监听,如有变动可拿到最新值并通知订阅者<br />
  912. 2、实现一个指令解析器Compile,对每个元素节点的指令进行扫描和解析,根据指令替换数据,以及绑定相应的更新函数<br />
  913. 3、实现一个Watcher,作为连接Observer和Compile的桥梁,能够订阅并收到每个属性变动的通知,执行指令绑定的相应回调函数,从而更新视图<br />
  914. 4、mvvm入口函数,整合以上三者</p>
  915. <p>上述流程如图所示:<br />
  916. <img alt="img2" src="///F://git/mvvm/img/2.png" /></p>
  917. <h3 id="1observer"><a name="user-content-1observer" href="#1observer" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>1、实现Observer</h3>
  918. <p>ok, 思路已经整理完毕,也已经比较明确相关逻辑和模块功能了,let&rsquo;s do it<br />
  919. 我们知道可以利用<code>Obeject.defineProperty()</code>来监听属性变动<br />
  920. 那么将需要observe的数据对象进行递归遍历,包括子属性的属性,都加上 <code>set</code>和<code>get</code><br />
  921. 这样的话,给这个对象的某个值赋值,就会触发<code>set</code>,那么就能监听到了数据变化。。相关代码可以是这样:<br />
  922. <pre><code>var data = {name: 'kindeng'};
  923. observe(data);
  924. data.name = 'dmq'; // 哈哈哈,监听到值变化了 kindeng --&gt; dmq
  925. function observe(data) {
  926. if (!data || typeof data !== 'object') {
  927. return;
  928. }
  929. Object.keys(data).forEach(function(key) {
  930. defineReactive(data, key, data[key]);
  931. });
  932. };
  933. function defineReactive(data, key, val) {
  934. observe(val); // 监听子属性
  935. Object.defineProperty(data, key, {
  936. enumerable: true, // 可枚举
  937. configurable: false, // 不能再define
  938. get: function() {
  939. return val;
  940. },
  941. set: function(newVal) {
  942. console.log('哈哈哈,监听到值变化了 ', val, ' --&gt; ', newVal);
  943. val = newVal;
  944. }
  945. });
  946. }
  947. </code></pre><br />
  948. 这样我们已经可以监听每个数据的变化了,那么监听到变化之后就是怎么通知订阅者了,所以接下来我们需要实现一个消息订阅器,很简单,维护一个数组,用来收集订阅者,数据变动触发notify,再调用订阅者的update方法,代码改一下之后是这样:<br />
  949. <pre><code>// ... 省略
  950. function defineReactive(data, key, val) {
  951. var dep = new Dep();
  952. observe(val); // 监听子属性
  953. Object.defineProperty(data, key, {
  954. // ... 省略
  955. set: function(newVal) {
  956. if (val === newVal) return;
  957. console.log('哈哈哈,监听到值变化了 ', val, ' --&gt; ', newVal);
  958. val = newVal;
  959. dep.notify(); // 通知所有订阅者
  960. }
  961. });
  962. }
  963. function Dep() {
  964. this.subs = [];
  965. }
  966. Dep.prototype = {
  967. addSub: function(sub) {
  968. this.subs.push(sub);
  969. },
  970. notify: function() {
  971. this.subs.forEach(function(sub) {
  972. sub.update();
  973. });
  974. }
  975. };
  976. </code></pre><br />
  977. 那么问题来了,谁是订阅者?没错,上面的思路整理中我们已经知道订阅者应该是Watcher, 而且<code>var dep = new Dep();</code>是在 defineReactive 方法内部定义的,所以想通过dep添加订阅者,就必须要在闭包内操作,所以我们可以在 <code>get</code>里面动手脚,<br />
  978. <pre><code>// Observer.js
  979. // ...省略
  980. Object.defineProperty(data, key, {
  981. get: function() {
  982. // dep.addDep(watcher);
  983. // 由于需要在闭包内添加watcher,所以可以在Dep定义一个全局target属性,暂存watcher, 添加完移除
  984. Dep.target &amp;&amp; dep.addDep(Dep.target);
  985. return val
  986. }
  987. // ... 省略
  988. });
  989. // Wacher.js
  990. // ...省略
  991. get: function(key) {
  992. Dep.target = this;
  993. this.value = data.key;
  994. }
  995. </code></pre><br />
  996. 先记住这个思路,Dep.target在什么时候赋值对应的watcher后面会讲到</p>
  997. <p>这里已经实现了一个Observer了,已经具备了应有的功能,vue源码在<a href="https://github.com/vuejs/vue/blob/dev/src/observer/index.js">这里</a>。那么接下来就是实现Compile了</p>
  998. <h3 id="2watcher"><a name="user-content-2watcher" href="#2watcher" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>2、实现Watcher</h3>
  999. <p>从前面知道,<code>var dep = new Dep();</code>是在 defineReactive 方法内部定义的,所以想通过dep添加订阅者,就必须要在闭包内操作,所以我们可以在 <code>get</code>里面动手脚<br />
  1000. <pre><code>// ... 省略
  1001. var dep = new Dep();
  1002. Object.defineProperty(data, key, {
  1003. enumerable: true, // 可枚举
  1004. configurable: false, // 不能再define
  1005. get: function() {
  1006. dep.add
  1007. return val;
  1008. },
  1009. set: function(newVal) {
  1010. if (val === newVal) return;
  1011. console.log('哈哈哈,监听到值变化了 ', val, ' --&gt; ', newVal);
  1012. val = newVal;
  1013. dep.notify(); // 通知所有订阅者
  1014. }
  1015. });
  1016. </code></pre></p>
  1017. <h4 id="4vue-github"><a name="user-content-4vue-github" href="#4vue-github" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>4、Vue的生命周期 (<a href="https://github.com/vuejs/vue/">Github</a>)</h4>
  1018. <p><img src="https://vuejs.org.cn/images/lifecycle.png" width="640px"></p>
  1019. <h4 id="5"><a name="user-content-5" href="#5" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>5、我们要实现的关键点:</h4>
  1020. <ul>
  1021. <li>数据监听 Observer.js 和消息订阅器 Dep.js</li>
  1022. <li>订阅者 Watcher.js</li>
  1023. <li>指令编译器 Compile.js</li>
  1024. <li>入口 mvvm</li>
  1025. </ul>
  1026. <h4 id="6objectdefineproperty"><a name="user-content-6objectdefineproperty" href="#6objectdefineproperty" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>6、一切基于此Object.defineProperty()</h4>
  1027. <p><em>IE8+</em></p>
  1028. <p><strong>code:</strong><br />
  1029. <pre><code>function defineReative(data) {
  1030. var val;
  1031. Object.defineProperty(data, 'name', {
  1032. enumerable: true, // 可枚举
  1033. configurable: true, // 不能再define
  1034. get: function() {
  1035. return val;
  1036. },
  1037. set: function(newVal) {
  1038. console.log('你变了:', val, ' ==&gt; ', newVal);
  1039. val = newVal;
  1040. }
  1041. });
  1042. }
  1043. var data = {};
  1044. defineReative(data);
  1045. </code></pre></p>
  1046. <h4 id="7observerjs"><a name="user-content-7observerjs" href="#7observerjs" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>7、实现Observer.js</h4>
  1047. <p>负责监听源数据所有属性,一旦发生变化,通知订阅者更新视图</p>
  1048. <p><a href="///F://git/mvvm/js/observer.js">code</a></p>
  1049. <h4 id="8compilejs"><a name="user-content-8compilejs" href="#8compilejs" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>8、实现Compile.js</h4>
  1050. <p>负责解析模板指令,不同的指令绑定不同的处理回调及视图更新方法</p>
  1051. <p><a href="///F://git/mvvm/js/compile.js">code</a></p>
  1052. <h4 id="9observe-compile-watcherjs"><a name="user-content-9observe-compile-watcherjs" href="#9observe-compile-watcherjs" class="headeranchor-link" aria-hidden="true"><span class="headeranchor"></span></a>9、如何连接observe 和 compile &ndash;&gt; watcher.js(桥梁)</h4>
  1053. <p>充当数据更新的订阅者,每一个属性的变化都会通知它,在compile阶段实例化并注入回调函数</p>
  1054. <p>每一个属性都有一个watcher</p>
  1055. <p><a href="///F://git/mvvm/js/watcher.js">code</a></p></article></body></html>