<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Harry Chiu on Medium]]></title>
        <description><![CDATA[Stories by Harry Chiu on Medium]]></description>
        <link>https://medium.com/@harrychiu1106?source=rss-a43a6b21677------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*e7wwSr0VwEbOeeMxUlx-LA@2x.jpeg</url>
            <title>Stories by Harry Chiu on Medium</title>
            <link>https://medium.com/@harrychiu1106?source=rss-a43a6b21677------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 18:38:36 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@harrychiu1106/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[如何將 TypeScript 導入現有 React 專案]]></title>
            <link>https://medium.com/asiayo-engineering/%E5%A6%82%E4%BD%95%E5%B0%87-typescript-%E5%B0%8E%E5%85%A5%E7%8F%BE%E6%9C%89-react-%E5%B0%88%E6%A1%88-a0253f9bc487?source=rss-a43a6b21677------2</link>
            <guid isPermaLink="false">https://medium.com/p/a0253f9bc487</guid>
            <category><![CDATA[frontend]]></category>
            <category><![CDATA[react]]></category>
            <category><![CDATA[typescript]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[web-development]]></category>
            <dc:creator><![CDATA[Harry Chiu]]></dc:creator>
            <pubDate>Wed, 04 Jan 2023 10:32:11 GMT</pubDate>
            <atom:updated>2023-01-05T06:56:25.999Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Fl18PXRfIGlqiXKIahbkjA.png" /></figure><h3>前言</h3><p><a href="https://www.typescriptlang.org/"><strong>TypeScript</strong></a> 是近幾年非常熱門的解決方案，除了具備 JavaScript 本身的所有功能以外，還提供了強大的型態系統（Type System），讓開發者在開發時提前預知可能發生的錯誤，大大減少 Bug 發生的機會<strong>。</strong>這也是為何有越來越多開發者願意將 TypeScript 導入到 JavaScript 專案的原因之一。</p><p>近期公司內部開發了一套共用元件庫，這麼做的好處是，設計團隊只需要設計一套共用元件，前端團隊就能應用在多個不同的專案上，大大降低了維護的成本。</p><blockquote>關於共用元件庫的開發過程，可以參考 — <a href="https://medium.com/asiayo-engineering/%E9%80%8F%E9%81%8E-babel-%E8%A3%BD%E4%BD%9C%E8%87%AA%E5%B7%B1%E7%9A%84%E7%AC%AC%E4%B8%89%E6%96%B9%E5%A5%97%E4%BB%B6-a19fc76c54b0">透過 babel 製作自己的第三方套件</a></blockquote><p>既然同時有多個專案使用同一個元件庫，元件庫的穩定性就重要許多，我們應該極力避免元件庫發生錯誤，才能確保每個專案都是相對穩定的。</p><p>因此，我們決定導入 TypeScript 到元件庫中，利用它嚴謹的型態系統，在編譯階段提前發現大部分錯誤，減少元件庫運行時發生錯誤的機會，從而提升元件庫及其他專案的穩定性。</p><p>接下來，這篇文章會分享如何將 TypeScript 和 Babel 這兩個強大的工具做整合，在擁有 Babel 優秀效能的同時，又能擁有 TypeScript 的型態檢查。</p><h3>為什麼要使用 TypeScript？</h3><p>導入 TypeScript 勢必會有一定的學習成本，是什麼樣的原因讓我們決定要採用這樣的解決方案呢？主要是考量了 TypeScript 以下的優點：</p><h4>減少運行時發生的錯誤</h4><p>在開發 JavaScript 的時候，我們應該對這樣的錯誤訊息都不陌生：</p><ul><li>TypeError: xxx is not a function</li><li>TypeError: Cannot read property &#39;xxx&#39; of undefined</li></ul><p>原因大致上都是沒有對變數做好處理，導致某些情境使用這些變數會發生錯誤。而 TypeScript 的型態檢查就能做到在開發時，就立刻告訴開發者，現在使用的寫法可能會發生錯誤，這讓開發者可以在運行前將錯誤修正。</p><p>舉例來說，在沒有 TypeScript 的情況下，我們如果在使用 Input 的時候，不小心輸入了錯的參數，或是不存在的參數，並不會看到任何提示：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/898/1*_IUe4-FQCjHN9CVRPIIrdA.png" /><figcaption>labels 並不是 Input 的參數，但 IDE 並沒有提示</figcaption></figure><p>現在我們將 Input.jsx 改寫成 TypeScript，並看看新的結果：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/878/1*5Zia1qctWCdMhmV1xay5nA.png" /><figcaption>IDE 會提示錯誤 compile 時找到的錯誤</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dNdNAEGatwkEkGSLNh9Z6A.png" /><figcaption>TypeScript 貼心的告知你使用了不存在的參數</figcaption></figure><p>現在 IDE 會告訴我們，labels 並不存在於 Input 的 props 中，也就是說，我們能在程式開跑之前就知道問題出在哪裡，完美的迴避了可能發生的錯誤。</p><h4>提升開發的便利性</h4><p>TypeScript 除了型態檢查的功能外，更誘人的是會讓我們的 IDE 能夠使用「自動補完」、「查看型態宣告文件」等功能，讓開發者有更快的開發速度和更高的便利性。</p><p>而元件庫這樣的專案，因為要提供給其他專案做使用，「自動補完」、「型態宣告文件」這樣的功能就非常適合它，開發者可以透過 IDE 提供的功能就瞭解元件庫的元件有什麼參數，而不用去看 source code 推導，我認為對開發者來說是非常便利的一件事。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/950/1*pUgc9a6BWZn0VfTYRfaQ2g.png" /><figcaption>TypeScript 在 IDE 普遍支援自動補完功能</figcaption></figure><h4>為何不使用 PropTypes 就好</h4><p>React 的開發者應該對 PropTypes 不陌生，它的存在類似於 TypeScript 的型態系統，都是讓使用者可以對元件的參數做型態定義，主要差別在於：</p><ul><li>TypeScript 在 compile 時找出錯誤，可以及時發現錯誤。</li><li>PropTypes 在 runtime 時找出錯誤，沒辦法及時發現錯誤。</li></ul><p>除此之外，TypeScript 也提供更多的型態類別讓我們做應用，與 PropTypes 相較起來更加靈活，易讀性也更高。因此，最終我們決定採用 TypeScript。</p><h3>Babel 和 TypeScript 的差異</h3><p>在開始整合之前，我們先來瞭解這兩個工具的主要差異。</p><blockquote>若想深入了解這兩個工具，可以前往 <a href="https://babeljs.io/">Babel</a> 和 <a href="https://www.typescriptlang.org/">TypeScript</a> 的官方網站。</blockquote><h4>Babel</h4><p>Babel 是一個強大的 JavaScript 編譯器，你可以用最新、最潮的語法進行開發，最後再透過 Babel 將程式碼轉換成瀏覽器能讀懂的舊語法。</p><p>主要功能：</p><ul><li>語法轉換（ES2015 以上的最新語法、JSX、React 等）</li><li>提供 <a href="https://developer.mozilla.org/en-US/docs/Glossary/Polyfill">Polyfill</a></li></ul><h4>TypeScript</h4><p>TypeScript 是一個基於 JavaScript 打造的強型態程式語言，讓你在使用 JavaScript 語法的同時，也能享受到強型態所帶來的滿滿安全感。</p><p>主要功能：</p><ul><li>型態系統</li><li>語法轉換（透過 TypeScript 提供的 tsc 編譯器）</li><li>型態宣告文件（讓 IDE 能提供自動、跳轉到宣告文件等功能）</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*49HAtFJrE0JUAfwX" /><figcaption>Photo by <a href="https://unsplash.com/@johnschno?utm_source=medium&amp;utm_medium=referral">John Schnobrich</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><h3>整合 Babel 和 TypeScript</h3><p>有了兩種工具的基本概念後，會發現 Babel 和 TypeScript 都擁有語法轉換的功能，我們有兩個選擇：</p><ul><li>捨棄 Babel，TypeScript 處理語法轉換、型態檢查和型態宣告文件</li><li>Babel 處理語法轉換，TypeScript 處理型態檢查和型態宣告文件</li></ul><p>由於 TypeScript 的 tsc 編譯器除了語法轉換外，還需要處理型態檢查、型態宣告文件的工作，導致編譯速度比 Babel 慢上許多。</p><p>因此，我們選擇第二個選項 — 「Babel 處理語法轉換，TypeScript 型態檢查和型態宣告文件」，同時這也是<a href="https://www.typescriptlang.org/docs/handbook/babel-with-typescript.html">官方推薦的整合方式</a>。</p><p>如此一來，我們既能擁有 Babel 超快的編譯速度，也可以擁有 TypeScript 所提供的型態相關的強大功能！</p><blockquote>如果你的需求是第一個選項，可以參考<a href="https://www.typescriptlang.org/docs/handbook/migrating-from-javascript.html">官方提供的教學</a>。</blockquote><h4>整合前的專案架構</h4><p>我們目前的專案架構如下表所示：</p><pre>- ui-library<br>  - lib             // Babel 輸出路徑<br>  - src             // 存放開發檔案<br>  - babel.config.js // Babel 設定<br>  - package.json    // 專案設定</pre><p>接下來會在 ui-library 底下新增 tsconfig.json 的 TypeScript 設定檔，但在那之前，我們先來安裝 Babel 需要的 TypeScript 插件。</p><h4>安裝 Babel 支援的 TypeScript 插件</h4><p>話不多說，馬上來安裝 Babel 提供的 @babel/preset-typescript，它讓 Babel 能在編譯時處理 TypeScript 的語法：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/6cf8eb989626459f32db69cfb8f06d49/href">https://medium.com/media/6cf8eb989626459f32db69cfb8f06d49/href</a></iframe><p>完成安裝後，在你的 babel.config.js 或 babelrc.json 中設定它：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8a4117dff65a7399bf9d1d5a9779e848/href">https://medium.com/media/8a4117dff65a7399bf9d1d5a9779e848/href</a></iframe><h4>安裝 TypeScript</h4><p>完成了 Babel 的設定後，我們要在專案裡安裝 TypeScript，它能讓我們使用 tsc 編譯器來進行型態檢查，及產生型態宣告文件：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8cad97acca2aeb0464c874512f5832e9/href">https://medium.com/media/8cad97acca2aeb0464c874512f5832e9/href</a></iframe><p>TypeScript 安裝完成後，就可以在 ui-library 新增一個 tsconfig.json 的設定檔，開始進行 tsc 的設定：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/fd650d22b4e42f902f437ec6057bd8f3/href">https://medium.com/media/fd650d22b4e42f902f437ec6057bd8f3/href</a></iframe><p>這個步驟最重要的是開啟 declaration 和 emitDeclarationOnly，確保 tsc 只輸出型態宣告文件，而不輸出 .js 的檔案（交由 Babel 處理），最後透過 outDir 指定將檔案輸出到 Babel 輸出的位置 lib。</p><blockquote>除了上述的設定以外，tsc 還提供了非常多的客製化設定，大家可以根據自己的專案調整適合的設定，詳細內容請參考 <a href="https://www.typescriptlang.org/tsconfig">tsconfig 官方文件</a>。</blockquote><h4>撰寫 script</h4><p>我們的專案已經完成了 Babel 和 TypeScript 的相關設定，現在已經能達到我們所預期的三個目的：</p><ul><li>使用 TypeScript 進行型態檢查（IDE，例如：<a href="https://code.visualstudio.com/">VS Code</a>）</li><li>使用 TypeScript 輸出型態宣告文件（tsc）</li><li>使用 Babel 編譯 .js 或 .ts 檔案</li></ul><p>因為 IDE 會自動幫我們進行型態檢查，所以我們只需要將「輸出型態宣告文件」和「Babel 編譯」整合在一起，以後我們就能下一個指令完成這兩件事了。接下來我們就透過 package.json 的 scripts 來完成它吧：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/93934c9714f75c10d8b5af31f7d7651f/href">https://medium.com/media/93934c9714f75c10d8b5af31f7d7651f/href</a></iframe><p>來講解一下這三行指令：</p><ul><li>build:types： 使用 tsc 進行編譯，將型態宣告文件輸出至 lib。</li><li>build:js：使用 babel 編譯 src 內的內容，將結果輸出至 lib，而後方的 --extensions是為了讓 @babel/cli 和 @babel/core 能處理 .js、.jsx、.ts 和 .tsx 的檔案。</li><li>build：為上述兩個指令的結合，先執行 build:types 後，再接著執行 build:js。</li></ul><p>到這邊，我們就完成了 Babel 和 TypeScript 的整合，現在只要執行 yarn build，TypeScript 就會輸出型態宣告文件，Babel 再把程式碼輸出成瀏覽器能看懂的 JavaScript，完美！</p><p>有些人可能會好奇，為什麼還需要編譯 .js 或是 .jsx 檔案，是因為我們希望採取漸進式的更新，而不是一口氣整個專案都翻成 TypeScript，這樣更新的成本會比較小。</p><h3>開始撰寫 TypeScript</h3><p>現在專案已經具備了 TypeScript 的功能，也能透過 Babel 編譯成瀏覽器看得懂的語法，我們就馬上來為元件庫裡面的 Input 換上 TypeScript 吧！</p><p>首先來看一下最原始的 Input.jsx 檔案：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/1a96057edd4acd978b7534c1ae7b112e/href">https://medium.com/media/1a96057edd4acd978b7534c1ae7b112e/href</a></iframe><p>現在我們把 Input.jsx 改造成 Input.tsx：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/25317725ed6a746e3cf2c35341c093ae/href">https://medium.com/media/25317725ed6a746e3cf2c35341c093ae/href</a></iframe><p>完成之後，執行我們的 yarn build來進行編譯：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b61da9bfd861b7037ac0380aa2293653/href">https://medium.com/media/b61da9bfd861b7037ac0380aa2293653/href</a></iframe><p>可以看到， .ts 已經被成功的編譯成 .js ，.d.ts 型態宣告文件也和 Input 放在一起，這樣就大功告成啦～</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/352/1*Gt5U36lp-POmXMfS2rQh3Q.png" /></figure><h4>總結</h4><p>利用 TypeScript 型態檢查的功能，我們能在開發元件庫的當下，就發現可能造成錯誤的根源，例如：參數輸入錯誤、忘記把某項參數傳進元件使用等，常見的人為錯誤都能被 TypeScript 檢查出來，並讓我們能夠提前修正。</p><p>以往使用 TypeScript 進行編譯時，容易遇到編譯速度較慢的問題，現在多虧了 Babel 和 TypeScript 共同合作推出的 @babel/preset-typescript 插件，讓我們能將使用 Babel 來編譯 TypeScript，同時又保有 TypeScript 的其他功能，真的是一大福音。</p><p>希望這篇文章能幫助到需要導入 TypeScript 到現有專案中的開發者們，若有任何問題和建議，歡迎在下方留言讓我知道。</p><p>Thanks for Watching🍻</p><h3>參考連結</h3><ul><li><a href="https://babeljs.io/">Babel</a></li><li><a href="https://www.typescriptlang.org/">JavaScript With Syntax For Types.</a></li><li><a href="https://iamturns.com/typescript-babel/">TypeScript With Babel: A Beautiful Marriage</a></li><li><a href="https://learntypescript.dev/12/l2-babel">Using Babel with TypeScript | Learn TypeScript</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a0253f9bc487" width="1" height="1" alt=""><hr><p><a href="https://medium.com/asiayo-engineering/%E5%A6%82%E4%BD%95%E5%B0%87-typescript-%E5%B0%8E%E5%85%A5%E7%8F%BE%E6%9C%89-react-%E5%B0%88%E6%A1%88-a0253f9bc487">如何將 TypeScript 導入現有 React 專案</a> was originally published in <a href="https://medium.com/asiayo-engineering">AsiaYo Engineering</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[JavaScript 筆記 — Scope (作用域)]]></title>
            <link>https://medium.com/@harrychiu1106/javascript-%E7%AD%86%E8%A8%98-scope-%E4%BD%9C%E7%94%A8%E5%9F%9F-7f4b844155bb?source=rss-a43a6b21677------2</link>
            <guid isPermaLink="false">https://medium.com/p/7f4b844155bb</guid>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[notes]]></category>
            <category><![CDATA[javascript]]></category>
            <dc:creator><![CDATA[Harry Chiu]]></dc:creator>
            <pubDate>Thu, 29 Dec 2022 04:13:42 GMT</pubDate>
            <atom:updated>2022-12-29T04:21:19.375Z</atom:updated>
            <content:encoded><![CDATA[<h3>JavaScript 筆記 — Scope 作用域</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*u_c2lFPCV1ciSofs" /><figcaption>Photo by <a href="https://unsplash.com/@michaelfousert?utm_source=medium&amp;utm_medium=referral">Michael Fousert</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><h3>什麼是 Scope 作用域？</h3><p>作用域是一套規則，用來規範 Variable (變數) 的存放位置，以及如何被查詢。而變數的查詢分為兩種類型：</p><h4>LHS (Left-Hand Side) 查詢</h4><p>為了<strong>向變數進行賦值</strong>而進行的查詢。例如：var a = 2 ，為了要將 2 這個值賦予給 a ，需要去查詢 a 的位置，因此 a 在這裏是一個 LHS 查詢。</p><h4>RHS (Right-Hand Side) 查詢</h4><p>為了<strong>取得變數的值</strong>而進行的查詢。例如： var b = a，為了要將 a 這個值給予 b ，需要去查詢 a 的值，因此 a 在這裏是一個 RHS 查詢。</p><p>另外像是 callSomeFunction(c) 、 console.log(d) 中的 c 和 d 同樣需要去查詢 c 和 d 的值，因此也屬於 RHS 的查詢！</p><blockquote>應該將 RHS 視為「LHS 以外的查詢方式」，而不是看作 Opeartor (操作符) 右方的變數查詢皆為 RHS。</blockquote><h3>嵌套的作用域</h3><p>撰寫的程式中可能同時包含多個作用域，這時候引擎會從當前所在的作用域開始查詢，找不到就查詢上一層的作用域，直到最外層的全域作用域，最後都找不到的話就會停止查詢並拋出 ReferenceError。</p><h4>往上查詢</h4><ul><li>命名相同、作用域不同時，因為已經在當前作用域查詢到 a 的值，因此不會繼續往上。</li></ul><pre>var a = 1;<br><br>function someFunction() {<br>  var a = 2;<br>  console.log(a);<br>}<br><br>someFunction(); // 2</pre><ul><li>當前作用域查詢不到，會往上一層查詢。</li></ul><pre>var a = 1;<br><br>function someFunction() {<br>  console.log(a);<br>}<br><br>someFunction(); // 1</pre><ul><li>當前作用域查詢不到，不斷往上一層查詢，並且在全域作用域也查詢不到時，拋出 ReferenceError 。</li></ul><pre>function someFunction() {<br>  console.log(a);<br>}<br><br>someFunction(); // ReferenceError: a is not defined</pre><h4>同階層無法互通</h4><p>假設今天有 funcA 和 funcB 兩個作用域，這兩個作用域裡的變數是沒辦法互通的：</p><pre>function funcA() {<br>  var a = 1;<br>}<br><br>function funcB() {<br>  console.log(a); // ReferenceError: a is not defined<br>}</pre><h3>塊作用域</h3><p>在習慣上，我們容易將 { 和 } 中間的內容看作一個區塊，但在 JavaScript 中，這個認知可能會誤導你。我們看看下方的例子：</p><pre>if (true) {<br>  var a = 1;<br>}<br><br>console.log(a); // 1</pre><pre>for (var i = 0; i &lt; 5; i++) {<br>  // ...<br>}<br><br>console.log(i); // 5</pre><p>不論是 if 還是 for 的例子都指出，這兩個區塊內的宣告會污染到外部。至於 for 迴圈的 i 為什麼會是 5 ，可以看這裡：</p><pre>var i = 0;<br>if (i &lt; 5) { i++ };<br><br>var i = 1;<br>if (i &lt; 5) { i++ };<br><br>...<br><br>var i = 5;<br>if (i &lt; 5) { i++ }; // 跳出迴圈</pre><h4>let 與 const</h4><p>為了解決這個問題，ES6 提供了兩個新的命名變數的方式 — let 與 const 。使用這兩個方式進行變數命名，就能夠建立出塊作用域：</p><pre>if (true) {<br>  let a = 1;<br>}<br><br>console.log(a); // ReferenceError: ais not defined</pre><pre>for (let i = 0; i &lt; 5; i++) {<br>  // ...<br>}<br><br>console.log(i); // ReferenceError: i is not defined</pre><h4>冷知識 try {} catch {}</h4><p>在 ES6 以前有辦法做到塊作用域嗎？有的，那就是使用 try {} catch {} ：</p><pre>try {<br>  throw 1<br>} catch (a) {<br>  // ...<br>}<br><br>console.log(a); // ReferenceError: a is not defined</pre><p>catch() 的 a 只在 catch() {} 的區塊內有用，catch 確實達到了塊作用域的效果，不過這種寫法確實讓人頭痛，既然已經有現代的解決方案，我們只需要知道有這個冷知識就足夠了。</p><h3>總結</h3><p>在開發過程的過程中，難免會根據經驗來推斷程式如何執行，但些 Bug 特別難解決，就是因為我們了解的不夠透徹。</p><p>透過理解作用域的定義與規則，能幫助我們釐清變數如何儲存、如何被查詢，進而推斷及預測程式會如何運行。當我們知道程式背後的運作原理，就能大大減少錯誤發生的機率。</p><h3>參考資料</h3><p><a href="https://github.com/getify/You-Dont-Know-JS">GitHub - getify/You-Dont-Know-JS: A book series (2 published editions) on the JS language.</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7f4b844155bb" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[React — 利用 Compound Component 提升開發體驗]]></title>
            <link>https://medium.com/@harrychiu1106/react-%E5%88%A9%E7%94%A8-compound-component-%E6%8F%90%E5%8D%87%E9%96%8B%E7%99%BC%E9%AB%94%E9%A9%97-f0328ffbb617?source=rss-a43a6b21677------2</link>
            <guid isPermaLink="false">https://medium.com/p/f0328ffbb617</guid>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[react]]></category>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[clean-code]]></category>
            <category><![CDATA[frontend]]></category>
            <dc:creator><![CDATA[Harry Chiu]]></dc:creator>
            <pubDate>Tue, 22 Nov 2022 03:25:45 GMT</pubDate>
            <atom:updated>2022-11-22T03:25:45.532Z</atom:updated>
            <content:encoded><![CDATA[<h3>React — 利用 Compound Component 提升開發體驗</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*kjC55A-baBlfdOaK" /><figcaption>Photo by <a href="https://unsplash.com/@aedrian?utm_source=medium&amp;utm_medium=referral">Aedrian</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><h3>前言</h3><p>開發元件是 React 工程師的日常，隨著專案日趨龐大，元件的數量也會隨之增長。我們喜歡將可重複使用的架構、樣式抽象成一個元件，讓它能夠在任何地方再次被使用，但專案中的元件真的「好用」嗎？</p><p>譬如你參考其他地方的 code 使用了一個元件，但這個元件卻沒有如你預期的運作，甚至是送你一個漂亮的白畫面，這時候你不得不去了解一下元件的原始碼。</p><p>這可能不是一個很好的開發體驗，因為元件使用者在使用元件之前，必須先了解元件的原始碼。最理想的情況應該是，元件使用者很直覺的傳入參數就能使用，而不需要看到元件的原始碼。</p><p>發生上述問題的主要原因，除了元件 API 的設計外，就是元件的資料流或是架構有「相依性」，也就是這個元件很可能必須與另一個元件「同時存在」，舉個大家熟悉的例子：</p><pre>&lt;select&gt;<br>  &lt;option value=&quot;a&quot;&gt;選項 A&lt;/option&gt;<br>  &lt;option value=&quot;b&quot;&gt;選項 B&lt;/option&gt;<br>  &lt;option value=&quot;c&quot;&gt;選項 C&lt;/option&gt;<br>&lt;/select&gt;</pre><p>你不會看到這 &lt;select&gt; 和 &lt;option&gt; 單獨存在，它們肯定是搭配在一起做使用，也因為我們知道它們之間的「關係」，所以在開發時我們可以很正確的去使用它們。</p><p>但客製化的元件這麼多，除了透過命名來表示元件間的關係以外，還有其他方法能讓元件使用者更簡單、直覺的去使用元件嗎？這個方法就是本篇文章要介紹的主題——Compound Component 複合元件。</p><h3>Compound Component 複合元件</h3><p>首先我們來了解一下，什麼是 Compound Component？</p><blockquote>由多個執行特定任務的元件組合而成的元件</blockquote><p>它和一般的元件又有什麼差別？</p><blockquote>元件自身無法獨立完成任務</blockquote><p>我們再次拿 &lt;select&gt; 和 &lt;option&gt; 來舉例，並寫下一些錯誤的用法：</p><pre>// 它們必須一起使用<br>&lt;select&gt;<br>  &lt;option value=&quot;a&quot;&gt;選項 A&lt;/option&gt;<br>  &lt;option value=&quot;b&quot;&gt;選項 B&lt;/option&gt;<br>  &lt;option value=&quot;c&quot;&gt;選項 C&lt;/option&gt;<br>&lt;/select&gt;</pre><pre>// 這麼做沒有意義<br>&lt;select&gt;<br>  &lt;div&gt;標題&lt;/div&gt;<br>&lt;/select&gt;</pre><pre>&lt;option&gt;選項 A&lt;/option&gt;<br>&lt;option&gt;選項 B&lt;/option&gt;</pre><p>透過範例，我們可以看到了幾個重點，而這些重點就是 Compound Component 的特性：</p><ul><li>通常有一個 Parent (&lt;select&gt;) 控制狀態，並分享給 Children(&lt;option&gt;)</li><li>每個元件有自己負責的任務，通常不會太複雜</li><li>資料的傳遞被隱藏起來，元件使用者不需要知道</li><li>元件獨自運作時沒有太大的意義</li></ul><p>現在我們已經了解 Compound Component 的基本概念和特性，接下來就是透過實作來實際體會一下，這麼做是否真的能讓開發體驗更好。</p><h3>實作 Tabs 元件</h3><p>今天我們需要做一個畫面切換的元件(TabSwitcher)，點擊畫面控制按鈕(Tab)時，下方的視窗(TabPanel)就要顯示對應的畫面——</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/852/1*6P-U-T2--6KiPKhFsZxWyw.png" /></figure><h4>設計元件</h4><p>在開發前，我們可以先對元件進行設計。還記得 Compound Component 的特性嗎，每個元件負責的任務切記不要太複雜！保持單一、簡單的任務是最理想的：</p><ul><li>TabSwitcher：管理狀態。</li><li>Tab：點擊後切換當前顯示的畫面。</li><li>TabPanel：顯示當前畫面。</li></ul><h4>狀態管理</h4><p>設計完成後可以思考一下，由於對元件的使用者來說，在意的只有如何「設定控制按鈕」以及「設定對應畫面」，元件內部如何實作其實不是那麼重要，因此我們可以將重心放在如何讓資料的傳遞「乾淨、直覺、好維護」。</p><p>理想的狀況是——我們可以將這些狀態統一放在 TabSwitcher 元件管理，並傳遞給下層的子原件做使用。我們可以透過 React.cloneElement 來傳遞狀態，但當底下的元件架構改變時就可能讓元件發生無法預期的錯誤：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/99d5d28287c93d9c30a9832823c404bf/href">https://medium.com/media/99d5d28287c93d9c30a9832823c404bf/href</a></iframe><p>上面的範例中可以看到，因為使用者在 TabSwitcher 中使用了一個 div 來包裝，導致 Tab 拿不到 TabSwitcher 傳遞下來的狀態，因此這邊若想要給予使用者更大的彈性，就很適合使用 React.Context 來傳遞狀態。</p><p>React.Context 可以將狀態傳遞到底下的所有子原件，因此我們不必擔心使用者沒有按照預期的架構去組裝元件，只要是在 TabSwitcher 底下， Tab 絕對可以拿到他想要的資料。</p><h4>開始實作</h4><p>元件設計完成後，就是快樂的實作時間了，讓我們看看完成的樣子：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2fc40c555b48f836dea113769bf8f090/href">https://medium.com/media/2fc40c555b48f836dea113769bf8f090/href</a></iframe><p>我們使用了上方提到的 React.Context 來傳遞狀態，不論 children 的層級怎麼改變， Tab 和 TabPanel 都還是能正常的取得 TabSwitcher 傳遞下來的狀態：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/ae6822e1d7dc6d118fc313bc5b8116d9/href">https://medium.com/media/ae6822e1d7dc6d118fc313bc5b8116d9/href</a></iframe><p>有了 Context 的協助，我們就能更自由的去控制這個元件的結構，同時不影響到元件間資料的傳遞！</p><p>再來是 Compound Component 很常看到的寫法，將 Tab 和 TabPanel 設定為 TabSwitcher 的 property：</p><pre>TabSwitcher.Tab = Tab;<br>TabSwitcher.TabPanel = TabPanel;</pre><p>這麼做的好處是，能讓元件使用者知道 Tab 和 TabPanel 是 TabSwitcher 的一份子，它們必須一起工作，另外你也只需要引入一個 TabSwitcher 元件就好，是不是很方便呢？</p><h4>優點</h4><p>以上就是使用 Compound Component 的概念所設計出來的 TabSwitcher 元件，和一般的元件相比可以發現它有以下的優點：</p><ul><li>元件間共享的狀態妥善地被放置在 Parent，這麼做能讓資料流向更清楚</li><li>元件間的關係更明確</li><li>搭配 Context 能讓元件有更多的客製化空間</li></ul><h4>範例</h4><p>完整範例放在這裡，有興趣可以去玩玩看哦！</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fcodesandbox.io%2Fembed%2Foptimistic-water-irhjty%3Ffile%3D%2Fsrc%2Fstyle.js&amp;display_name=CodeSandbox&amp;url=https%3A%2F%2Fcodesandbox.io%2Fs%2Foptimistic-water-irhjty%3Ffile%3D%2Fsrc%2Fstyle.js&amp;image=https%3A%2F%2Fcodesandbox.io%2Fapi%2Fv1%2Fsandboxes%2Firhjty%2Fscreenshot.png&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=codesandbox" width="1000" height="500" frameborder="0" scrolling="no"><a href="https://medium.com/media/f195e2f8d99ea79f1704549f3a2b36de/href">https://medium.com/media/f195e2f8d99ea79f1704549f3a2b36de/href</a></iframe><h3>總結</h3><p>透過 Compound Component 的設計，我們將資料流隱藏在元件內部，不讓外部有所感知；若畫面上需要客製化，也能夠有更多的彈性去做調整。</p><p>如此一來，我們就能更靈活地去運用這些元件，而不用一直重複打造非常類似、功能非常相近的元件，大大降低了維護的成本，也提升了開發的效率！</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f0328ffbb617" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[JavaScript — 4 招實用的 Clean Code 技巧！輕鬆寫出簡潔易懂、好維護的程式碼]]></title>
            <link>https://medium.com/@harrychiu1106/javascript-4-%E6%8B%9B%E5%AF%A6%E7%94%A8%E7%9A%84-clean-code-%E6%8A%80%E5%B7%A7-%E8%BC%95%E9%AC%86%E5%AF%AB%E5%87%BA%E7%B0%A1%E6%BD%94%E6%98%93%E6%87%82-%E5%A5%BD%E7%B6%AD%E8%AD%B7%E7%9A%84%E7%A8%8B%E5%BC%8F%E7%A2%BC-886c22ba6c32?source=rss-a43a6b21677------2</link>
            <guid isPermaLink="false">https://medium.com/p/886c22ba6c32</guid>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[code]]></category>
            <category><![CDATA[clean-code]]></category>
            <dc:creator><![CDATA[Harry Chiu]]></dc:creator>
            <pubDate>Mon, 21 Nov 2022 13:22:31 GMT</pubDate>
            <atom:updated>2022-11-21T13:22:31.334Z</atom:updated>
            <content:encoded><![CDATA[<h3>JavaScript — 4 招實用的 Clean Code 技巧！輕鬆寫出簡潔易懂、好維護的程式碼</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*rXPO8jXUCw8EzbX5" /><figcaption>Photo by <a href="https://unsplash.com/@jstrippa?utm_source=medium&amp;utm_medium=referral">James Harrison</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>在程式的世界裡，要達成一個目的，你可以有非常多的選擇，你可以寫出簡潔易懂、好維護的程式碼，也可以寫出效能很好，但需要花點時間來理解的程式碼。這些選擇沒有對與錯，但我們可以依照情境找到最適合的解決方案。</p><p>好比你和朋友約吃飯，從家裡到餐廳的路線有非常多種：</p><ul><li>彎彎曲曲的路線，不太好走，但速度最快（效能最好，但不易懂）</li><li>只走大路，能不轉彎就不轉彎，走起來沒難度，但速度可能不快（效能普通，但易懂）</li></ul><p>假設今天需要用最短時間到餐廳，那你可以選擇走速度最快的路線；假設今天時間很充裕，你可以選擇走簡單易懂的路線。</p><p>把上面的例子轉換到工作需求上 — — 我們偶爾會遇到需要解決效能問題的時候，這樣的情況下我們可以選擇使用效能最好的解法來改善問題。但大多時候，效能上的差異幾乎小到可以忽略，這時寫出簡潔易懂的程式碼，也就是透過 Clean Code 的技巧，讓其他協作的人在日後能用最快的速度理解這段程式碼，我認為是更好的選擇。</p><h3>1. 避免冗長的命名</h3><p>我們寫程式最常做的事，無非就是給變數或是函式做命名，一個好的命名規範可以讓程式碼看起來乾淨整潔；反之，則給程式帶來更多的混亂。</p><p>而其中我認為最簡單、最重要的準則，就是避免在命名時加上不必要的 Context（上下文）：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*o1AaFe4XdiONHKsX" /></figure><p>當今天 Object 本身已經有意義時，key 的命名就不需要再加上一些贅述了：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*akeQLPinWlZjYnjR" /></figure><h3>2. 除了 Switch Case，你還可以 …</h3><p>假設今天我們要製作一個水果價格對照表，香蕉 30 塊、蘋果 50 塊、櫻桃 70 塊⋯⋯，這時候很多人腦中已經浮現出這樣的寫法：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*DCO5OLQDoysMRycM" /></figure><p>這個寫法完全沒有問題，有標準的 key、value 的轉換，以及給予查無對應 key 的 default 值。但仔細想想，在 JavaScript 中，除了 Switch Case 以外，我們是不是有更簡單的做法可以做到這件事？</p><p>沒錯！就是我們超常用到的 Object，它本身就是 key、value 的結構，所以我們可以將很冗長的 Switch Case 寫法轉換成這樣：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*v7wb1g3I6IfWNI9d" /></figure><p>我們一樣能拿到水果對應的價格，也能給出預設值，功能完全一模一樣，但行數變的更少，看起來更簡潔易懂。在 Switch Case 中，每新增一個水果及價格，需要 2 行；Object 的結構只需要 1 行，當 key 的數量越龐大，兩者的行數差異就會越明顯！</p><h3>3. 原來 if else 可以這樣寫</h3><p>在我們學習 JavaScript 的過程中，一定有學過 if, else if, else 的判斷式，我們可以透過這樣的判斷式，確保程式只會進入其中一個入口，毫無例外。</p><p>舉個例子來說，假設我們要追蹤某個頁面的流量，找出這些流量來自於網站的哪個頁面：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*e05Uy5r4TSMeLLvR" /></figure><p>同樣，這樣的寫法並沒有問題，但是這個判斷式本身的結構不是那麼好讀，一眼看過去會有那麼一點雜亂的感覺。這時候我們可以改變想法，除了上方的判斷式以外，有沒有其他方法可以達到同樣的效果呢？</p><p>答案是有的，我們可以利用 if 搭配 return 來做到一次排除一個邏輯，馬上來看看效果吧：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*BV70JVZuMgh76XzL" /></figure><p>少了 if, else if, else 的巢狀結構，我們同樣能避免程式跑到不該進入的地方，也能更一目瞭然的看出這些判斷式各自處理的邏輯，提升簡潔度和可維護性。</p><h3>4. 善用解構賦值（Destructuring assignment）</h3><p>過去我們需要更改 Object 中某些值的時候，我們需要創建一個 Object 並跑迴圈來複製一份完整的 copy ，最後再去修改我們要更動的地方，非常的麻煩。</p><p>舉個簡單的例子，我們要幫 user 的年齡加一，取得一個新的 user：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*-z1_4b1W4F95W6SH.png" /></figure><p>一個簡單的需求要寫這麼長，令人頭痛對吧！在 ES6 之後，推出了一個很方便的語法——<strong>解構賦值（Destructuring assignment）</strong>，透過這個語法我們可以很快速的將 Object 的所有值覆蓋到新的 Object 上：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1023/0*TV2J7BOFCAjYLLGP" /></figure><p>很驚人對吧！短短一行就取代了好幾行程式碼所做的事情，為我們省下非常多的麻煩，現在程式碼看起來也更簡潔、更容易維護了。</p><h3>總結</h3><p>透過這 3 項 Clean Code 的技巧，我們學到如何用最簡單的方式，減少過於冗長的程式碼，以及提升程式碼的維護性。條條大路通羅馬，程式也是一樣，我們有非常多的方法可以達到相同的目的，但是如果可以簡單，誰會想要複雜呢？</p><p>在工作上、或是和其他工程師協作時，程式碼的簡潔、可讀性是非常重要且關鍵的，你肯定不會希望自己寫出來的程式，其他人需要花費大量時間去閱讀、理解，對吧？反之，如果你的程式碼能夠讓人一目瞭然，一眼就看出你想做的事和目的，那大家做事都是事半功倍，同事肯定會在心裡幫你大把大把的加分。</p><h3>參考資料</h3><ul><li><a href="https://developer.mozilla.org/zh-TW/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment">解構賦值（Destructuring assignment）</a></li><li><a href="https://javascript.plainenglish.io/javascript-clean-code-best-practices-461c24c53cae">JavaScript Clean Code — Quick Best Practices</a></li><li><a href="https://medium.com/arionkoder-engineering/5-javascript-clean-coding-patterns-to-enhance-your-code-cc205d8d1ab6">5 Javascript Clean Coding Patterns To Enhance your Code</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=886c22ba6c32" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[React.js 職場實戰！圖片 Infinite List]]></title>
            <link>https://medium.com/@harrychiu1106/react-js-%E8%81%B7%E5%A0%B4%E5%AF%A6%E6%88%B0-%E5%9C%96%E7%89%87-infinite-list-31829ed9575e?source=rss-a43a6b21677------2</link>
            <guid isPermaLink="false">https://medium.com/p/31829ed9575e</guid>
            <category><![CDATA[reactjs]]></category>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[react]]></category>
            <category><![CDATA[intersection-observer]]></category>
            <dc:creator><![CDATA[Harry Chiu]]></dc:creator>
            <pubDate>Wed, 25 Aug 2021 09:27:52 GMT</pubDate>
            <atom:updated>2021-08-25T09:27:52.445Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*UvSBlldigg9YatfO" /><figcaption>Photo by <a href="https://unsplash.com/@joelfilip?utm_source=medium&amp;utm_medium=referral">Joel Filipe</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><h3>一天的開始</h3><p>還記得嗎？你是負責 Imager 的前端工程師，上次做了 Lazy Loading 改善了資源浪費的問題，公司對你的表現非常的滿意。</p><p>但有幹勁的你決定想想看，有沒有其他方案也可以達到節約資源的效果，可以的話甚至可以和現在的 Lazy Loading 做結合！</p><h3>喝杯咖啡，逛逛文章</h3><p>一邊品嚐著香醇濃郁的咖啡，一邊滑著公司配給你的 MacBook Pro，一番尋尋覓覓之後，你找到了一個很酷的技術方案——</p><blockquote>Infinite List 無限加載列表</blockquote><p>你稍微把文章掃過一遍，歸納出幾個實作重點：</p><ul><li>使用 Intersection Observer API</li><li>一個觸發拿取新資料的 Element</li><li>將原本一次拿 100 張圖（全部）改成分次拿取</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*S1xFvDn7xUFD-QXG" /><figcaption>Photo by <a href="https://unsplash.com/@nickmorrison?utm_source=medium&amp;utm_medium=referral">Nick Morrison</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><h3>上工了！開始 Coding</h3><p>身為一名工程師，最快樂的時光就是動手寫程式的時候啦。如果你喜歡直接看 Code 來理解的話可以直接前往完成的範例觀看：</p><ul><li><a href="https://codesandbox.io/s/04-infinite-list-7g5v0?file=/src/hooks/useInfiniteList.js">CodeSandbox 範例</a></li></ul><blockquote>考量到 Lazy Loading 與 Infinite List 的結合較為複雜，這次會先實作只有 Infinite List 的版本，下一篇再將兩者結合！</blockquote><h4>&lt;InfiniteListTrigger /&gt;</h4><p>首先我們需要一個 Element 搭配 Intersection Observer 來觸發 Loading 的行為，也就是當這個 Element 出現在畫面上時，就觸發下載新的圖片資料。</p><p>我們就將這個 Element 命名為 &lt;InfiniteListTrigger /&gt; ，接著確保 Loading 狀態時不會顯示它，目的是避免重複觸發下載圖片列表。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a29612d1538d07c28c1736ac3951a893/href">https://medium.com/media/a29612d1538d07c28c1736ac3951a893/href</a></iframe><h4>fetchNewImages()</h4><p>接著我們來寫一個模擬打 API 的 function，他做的事情很單純，就是等一秒之後拿到新的圖片列表。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/59ca96f8c12f7aa1f7aca2dcad18102a/href">https://medium.com/media/59ca96f8c12f7aa1f7aca2dcad18102a/href</a></iframe><h4>useInifiteList()</h4><p>現在有了元件之後，我們需要一個 hook 將 &lt;InifiniteListTrigger /&gt; 交給 Intersection Observer 監聽。</p><p>這次要做的是相對簡單，我們需要 ref 和 onView 來完成無限加載的行為，我們看看它們對應的工作：</p><ul><li>ref — 要監聽的元件，也就是 &lt;InfiniteListTrigger /&gt; 。</li><li>onView — 當元件出現在畫面上時，觸發的 function。</li></ul><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/46f177bc3c585ea0b60fa1531973dc4d/href">https://medium.com/media/46f177bc3c585ea0b60fa1531973dc4d/href</a></iframe><h4>準備完工</h4><p>現在我們將上面的功能都組合在一起！</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b944a1c0308245dabff148fc51b4e855/href">https://medium.com/media/b944a1c0308245dabff148fc51b4e855/href</a></iframe><h3>成果發表</h3><p>你埋首在程式之中也經過了好一段時間，現在可以來看看最終成果了！</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fcodesandbox.io%2Fembed%2F7g5v0&amp;display_name=CodeSandbox&amp;url=https%3A%2F%2Fcodesandbox.io%2Fs%2F7g5v0&amp;image=https%3A%2F%2Fcodesandbox.io%2Fapi%2Fv1%2Fsandboxes%2F7g5v0%2Fscreenshot.png&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=codesandbox" width="1000" height="500" frameborder="0" scrolling="no"><a href="https://medium.com/media/b45382a055c5b5c16b7f88905503888a/href">https://medium.com/media/b45382a055c5b5c16b7f88905503888a/href</a></iframe><p>看起來運作的很順利，當頁面滑到最下方之後，我們才開始下載下面 10 筆的資料。看到這樣的成果，你不禁露出了驕傲的神情。</p><h3>咕嚕咕嚕…</h3><p>快樂的時光總是過得特別快，從肚子傳出的咕嚕聲將你的注意力拉回現實，居然已經是下班時間了！你緩緩的從座位站起身子，拿著錢包準備去吃晚餐啦！</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=31829ed9575e" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[React.js 職場實戰！圖片 Lazy Loading]]></title>
            <link>https://medium.com/@harrychiu1106/react-js-%E8%81%B7%E5%A0%B4%E5%AF%A6%E6%88%B0-%E5%9C%96%E7%89%87-lazy-loading-f079beddae34?source=rss-a43a6b21677------2</link>
            <guid isPermaLink="false">https://medium.com/p/f079beddae34</guid>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[reactjs]]></category>
            <category><![CDATA[react]]></category>
            <category><![CDATA[lazy-loading]]></category>
            <category><![CDATA[front-end-development]]></category>
            <dc:creator><![CDATA[Harry Chiu]]></dc:creator>
            <pubDate>Wed, 11 Aug 2021 04:11:31 GMT</pubDate>
            <atom:updated>2021-08-11T04:11:31.392Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*8Q8yPiG3HPXRFH-9" /><figcaption>Photo by <a href="https://unsplash.com/@timmossholder?utm_source=medium&amp;utm_medium=referral">Tim Mossholder</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><h3>一天的開始</h3><p>你是新創公司 Imager 底下的前端工程師，Imager 提供的服務非常簡單，就是能在網頁瀏覽各式各樣的圖片，網頁已經上線並正常的運作中，我們來看看他的模樣。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Krwe3hK5CdxcHUd2ywgrgw.png" /><figcaption>樸實無華的 UI 設計</figcaption></figure><p>看起來一切正常，但此時 PM 卻出現在你的身旁，告訴你：</p><blockquote>「網頁有點慢耶，可不可以幫忙優化一下⋯」</blockquote><h3>找出問題</h3><p>網頁慢的原因我們可以簡單的歸納一下：</p><ul><li>打包的檔案太大</li><li>網頁要下載的資源太多</li><li>網路太慢</li><li>手機太爛</li></ul><p>首先我們先剔除後面兩點，因為這兩個是我們無法控制的。所以原因肯定是出在前面兩者之間，而經過了初步的診斷，Imager 也就一個首頁和圖片列表而已，打包後的大小實在是沒什麼問題，那麼原因就是⋯</p><blockquote>「網頁要下載的資源太多」</blockquote><p>至於 Imager 網頁上需要下載的資源，只能是「<strong>圖片</strong>」了吧！檢查了一下發現，首頁的頁面上的列表直接把 100 張圖片都放上去了，這就代表著使用者一進頁面就會開始下載 100 張圖片！</p><p>其實從上方的圖片能看出來，畫面中能顯示的圖片數量是很有限的，頂多就那 6 張圖，如果使用者看完 6 張圖就離開了網站，那其他 94 張圖的資源就是被浪費掉了！</p><h3>怎麼解決</h3><p>基於上面的情境，我們知道現在要做的事情就是讓圖片「按需加載」，也就是出現在畫面上的圖片才去拿資源，這樣就能為使用者節省非常多的資源，也很直接地提升我們網頁的體驗。</p><p>這時你的腦中突然就閃過了「Lazy Loading」的字眼，沒錯，就決定是你了！</p><h3>快樂的 Coding 時光</h3><p>確定了實作的方向後，就剩下開始動工啦！首先我們可以開啟現在的 Imager 看看他最原始的模樣：</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fcodesandbox.io%2Fembed%2Fqwtvi&amp;display_name=CodeSandbox&amp;url=https%3A%2F%2Fcodesandbox.io%2Fs%2Fqwtvi&amp;image=https%3A%2F%2Fcodesandbox.io%2Fapi%2Fv1%2Fsandboxes%2Fqwtvi%2Fscreenshot.png&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=codesandbox" width="1000" height="500" frameborder="0" scrolling="no"><a href="https://medium.com/media/7701d8c4a60501503b802c7ec7965f06/href">https://medium.com/media/7701d8c4a60501503b802c7ec7965f06/href</a></iframe><p>為了證明加入「Lazy Loading」真的有解決問題，我在左上角加入一個計數器，當有 &lt;img /&gt; 下載資源就會讓數字加 1，簡單明瞭。</p><h3>實作重點</h3><p>通常決定了解決的方向後，我習慣會列出能想到的實作方法：</p><ul><li>原生 Intersection Observer API</li><li>第三方套件</li></ul><p>因為之前就有看過使用 Intersection Observer 實作 Lazy Loading 的文章，所以我已經掌握了相關的技巧以及知識，這時候我就會多一項選擇。</p><p>如果情況允許，也許使用套件也是個不錯的選擇，簡單、容易上手，但是否有人維護和是否有文檔也要列入考量，因為專案不一定之後由你維護，可不是每個人都懂這個套件怎麼使用啊！</p><p>經過一番折騰，我決定使用 Intersection Observer 自己實作，原因是用它來實現「Lazy Loading」真的很簡單，特別用套件來維護的話會讓專案的大小增加，不是很理想。</p><p>接著就來說明一下實作的部分吧！建議搭配已經準備好的範例一起服用。</p><p><a href="https://codesandbox.io/s/03-lazy-loading-ocuqh?file=/src/App.js:0-1225">CodeSandbox 完成版範例</a></p><h3>開始實作</h3><p>首先看到 &lt;Image /&gt;，我們將 src 拿掉，因為 src 會觸發瀏覽器下載圖片資源，取而代之 src 會暫存在 data-src 以利之後使用。</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5bc5e9e4b1aeae7d715eb5743df88a4f/href">https://medium.com/media/5bc5e9e4b1aeae7d715eb5743df88a4f/href</a></iframe><p>接著我們加入一個 useLazyLoading 的 hook，將有 lazy-image 標籤的 &lt;Image /&gt; 取出來並交給 Intersection Observer 做監聽：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/f361dd7b8d72cb8ce4572706d092bd2e/href">https://medium.com/media/f361dd7b8d72cb8ce4572706d092bd2e/href</a></iframe><p>最後將 useLazyLoading 加入到我們的 App.js 之中就大功告成：</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/9e660f3a83cd805bbdb43872e2f9dd66/href">https://medium.com/media/9e660f3a83cd805bbdb43872e2f9dd66/href</a></iframe><h3>成果</h3><p>我們來看看加入了「Lazy Loading」的網頁：</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fcodesandbox.io%2Fembed%2Focuqh&amp;display_name=CodeSandbox&amp;url=https%3A%2F%2Fcodesandbox.io%2Fs%2Focuqh&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=codesandbox" width="1000" height="500" frameborder="0" scrolling="no"><a href="https://medium.com/media/555aa4bb5e2f4bc457549a61c776e4bf/href">https://medium.com/media/555aa4bb5e2f4bc457549a61c776e4bf/href</a></iframe><p>現在畫面上能看到幾張圖片，下載資源的數量就是幾張，哎呀！這不是解決了嗎，恭喜你完成了一項驚人的創舉，現在我們可以拿著這些結果和比對的數據去交差了！</p><h3>準備下班</h3><p>完美的交付了任務之後，站起身子，伸伸懶腰，美好的一天即將結束！收拾收拾準備下班囉。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f079beddae34" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[React.js 職場實戰！最常見的需求與解法！ — 前言]]></title>
            <link>https://medium.com/@harrychiu1106/react-js-%E8%81%B7%E5%A0%B4%E5%AF%A6%E6%88%B0-%E6%9C%80%E5%B8%B8%E8%A6%8B%E7%9A%84%E9%9C%80%E6%B1%82%E8%88%87%E8%A7%A3%E6%B3%95-%E5%89%8D%E8%A8%80-b74163398b17?source=rss-a43a6b21677------2</link>
            <guid isPermaLink="false">https://medium.com/p/b74163398b17</guid>
            <category><![CDATA[react]]></category>
            <category><![CDATA[reactjs]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[frontend]]></category>
            <category><![CDATA[front-end-development]]></category>
            <dc:creator><![CDATA[Harry Chiu]]></dc:creator>
            <pubDate>Wed, 11 Aug 2021 04:09:57 GMT</pubDate>
            <atom:updated>2021-08-11T04:12:12.537Z</atom:updated>
            <content:encoded><![CDATA[<h3>React.js 職場實戰！最常見的需求與解法！ — 前言</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*DcJUHmuwH4sMqCfv" /><figcaption>Photo by <a href="https://unsplash.com/@octadan?utm_source=medium&amp;utm_medium=referral">Octavian Dan</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>哈囉！我是 Harry，這次想和大家分享的是前端工程師的「工作日常」，我們可能會接到什麼需求，又該如何完成需求，這些都是工程師再熟悉不過的日常生活。</p><p>如果你想嘗試前端，卻對前端職場感到陌生而卻步，也許這個系列可以幫助你找到自己的方向。</p><h3>系列內容</h3><p>本系列的主要內容，都會提供當下的場景以及收到的需求，並提供對應的解決方案，大致上可以將架構分為：</p><ul><li>場景描寫（我的產品是什麼）</li><li>需求描寫（遇到什麼問題）</li><li>需求分析（列出解決方案）</li><li>完成需求（執行解決方案）</li></ul><p>舉例來說 —</p><h4>場景描寫</h4><p>我們的產品是一個展示圖片的網頁，網頁已經完成並上線了，你正喝著咖啡欣賞著自己寫下的優美程式碼，此時 PM 的聲音將你拉回現實：</p><h4>需求描寫</h4><blockquote>「有用戶反應載入的速度很慢，圖片根本就跑不出來！可以幫忙看一下是什麼問題嗎？」</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ZsSWH--XXmTRDW6Z" /><figcaption>Photo by <a href="https://unsplash.com/@javaistan?utm_source=medium&amp;utm_medium=referral">Afif Kusuma</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>這時候，你的第一個反應可能是，「我的程式有問題⋯怎麼可能，失、失序了⋯」，這是很正常的反應，我們辛苦寫出來的程式碼居然被質疑有問題，這對工程師來說無疑是個沈重的打擊。</p><h4>需求分析</h4><p>但身為一個專業的前端工程師，我們必須拿出專業的態度來檢視並解決這個問題，所以首先我們要想一下自己的程式哪裡可能會有破綻 —</p><p><em>「圖片列表一次拿幾張圖？100 張？」</em></p><p><em>「</em><strong><em>畫面頂多顯示 10 張</em></strong><em>就極限了，是不是一次</em><strong><em>顯示 100 張太浪費資源了</em></strong><em>？」</em></p><p><em>「如果</em><strong><em>拿了 100 張但只需要顯示 10 張</em></strong><em>⋯該怎麼做呢？」</em></p><p>通常透過這樣的自問自答，就能夠發現問題的所在，沒錯！我們的確不需要一次顯示 100 張圖，因為「畫面上看不到的圖片下載下來就是浪費」，我們無法確保使用者真的會看完 100 張圖對吧？</p><p>所以我們重新整理思路，圖片出現在畫面上了再去拿圖片資源，這個行為的重點是什麼，他在技術上該怎麼稱呼？</p><blockquote>Lazy Loading、懶加載、按需加載</blockquote><p>現在我們已經列出了解決問題的方案，最後我們重新將 PM 提出的需求內化一次 —</p><p><strong><em>「透過對圖片加入 Lazy Loading 來優化網頁速度」</em></strong></p><p>完美。</p><h4>完成需求</h4><p>剩下的就是動手寫程式，把這個需求解決掉，繼續享受美好的放空時光。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*iOBL8t1Y3XyN8inZ" /><figcaption>Photo by <a href="https://unsplash.com/@nitram509?utm_source=medium&amp;utm_medium=referral">Martin W. Kirst</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><h3>結語</h3><p>這裏我簡單的舉例了這系列所進行的模式，不知道這樣的情境模擬有沒有讓各位看官有身歷其境的感覺呢？</p><p>之後的文章就會加入程式碼來讓整體體驗更加豐富，我預計會用 CodeSandbox 來做示範，如果對它不太熟悉的朋友們可以先去玩玩看！</p><p>這次的系列前言就到這裡結束，如果有想聽的題材也歡迎在底下留言讓我知道，我們下次見。</p><p>掰掰～</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b74163398b17" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Deploy React App to GitHub Pages]]></title>
            <link>https://medium.com/@harrychiu1106/deploy-react-app-to-github-pages-b626926e87f3?source=rss-a43a6b21677------2</link>
            <guid isPermaLink="false">https://medium.com/p/b626926e87f3</guid>
            <category><![CDATA[github]]></category>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[html]]></category>
            <category><![CDATA[react]]></category>
            <category><![CDATA[github-pages]]></category>
            <dc:creator><![CDATA[Harry Chiu]]></dc:creator>
            <pubDate>Tue, 03 Mar 2020 07:16:25 GMT</pubDate>
            <atom:updated>2020-03-31T02:51:53.075Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*o9kqy8p32Ge0A9hS" /><figcaption>Photo by <a href="https://unsplash.com/@adigold1?utm_source=medium&amp;utm_medium=referral">Adi Goldstein</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><h4>Step 1 — cd your React App folder</h4><pre>cd my-react-app</pre><h4>Step 2 — Install gh-pages</h4><pre>npm install gh-pages --save-dev</pre><h4>Step 3 — Edit package.json</h4><p>Add the “predeploy” and “deploy” inside scripts, like:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/320/1*Gg8nfyS_IH6t4NfmvV1_eQ.png" /></figure><p>and add the homepage, the pattern is like:</p><pre>https://<strong><em>YOUR_GITHUB_USERNAME</em></strong>.github.io/<strong><em>YOUR_GITHUB_REPOSITORY_NAME</em></strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/498/1*uj85K797vpZ-8ur0WLVyIQ.png" /></figure><p><strong><em>Don’t forget to replace the username and repository name!</em></strong></p><h4>Step 4 — Create your repository on GitHub</h4><p>Go to your github and create a new repository.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ewYIIa7sPOq9s-eTzQkr8Q.png" /></figure><h4>Step 5 — Push your repository to GitHub</h4><p>Go back your terminal and type:</p><pre>git remote add origin https://github.com/<strong><em>YOUR_NAME</em></strong>/<strong><em>YOUR_REPO</em></strong>.git<br>git push -u origin master</pre><p><strong><em>Remember to replace the username and repository name!</em></strong></p><h4>Step 6 — Deploy your webiste to GitHub!</h4><pre>npm run deploy</pre><h3>Step 7 — That’s all!!!</h3><p>After “npm run build” command completed, we need to wait a few seconds, and go to our github page to see the results!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1017/1*0qfAZ5ZXd7Gb3n4qNv6E-A.png" /></figure><p>If you have followed the above steps, you can successfully see that your website is displayed in the browser by entering the URL.</p><p>If not, you can leave your comment here, I will try to give you some help.</p><p>Cheers!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*5ELSQ0qFKEzpf-ZO" /><figcaption>Photo by <a href="https://unsplash.com/@wilstewart3?utm_source=medium&amp;utm_medium=referral">Wil Stewart</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b626926e87f3" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>