DIV CSS 佈局教程網

React 入門實戰:打造可展開的下拉導覽選單
編輯:JavaScript基礎知識     

React 是 Facebook 的工程師打造的前端框架,核心亮點是實作了一個虛擬 DOM——需要的元件加上去、不需要的移除,都由它高效處理。React 在 MVC 中扮演 V 的角色,若搭配 Flux 使用,還能讓 M 與 V 的同步變得輕鬆。

元件:可重複使用的介面磚塊

在 React 中,你可以建立具備特定功能的元件,這是純 HTML 做不到的——比如本文要做的下拉導覽。每個元件都有自己的作用域,因此定義一次便能反覆使用,彼此之間不需要互相干擾。

每個元件都有一個 render 方法,負責高效地回傳要渲染到瀏覽器上的 HTML。我們也可以在 render 中呼叫其他 React 元件,讓元件得以巢狀組合。

JSX 是什麼

JSX 允許我們在 JavaScript 中直接寫 HTML 標記,而不是反過來用 HTML 包住 JavaScript。它能加快開發速度,因為不必再為字串拼接與換行操心。

技術上你可以在瀏覽器中直接執行 JSX,但這麼做會拖慢頁面速度,不建議在正式環境使用。gulp 與 grunt 這類建置工具都提供了 JSX 轉譯器,我建議把它放進預處理流程。

基本的 render

每個元件的 render 會產生一個「視圖模型」——在把 HTML 回傳給元件之前,你可以先在此放入資料,讓畫面依模型動態變化(例如動態列表)。

var ExampleComponent = React.createClass({
  render: function () {
    return (
      <div className="navigation">
        Hello World!
      </div>
    );
  }
});

直接在瀏覽器執行這段程式碼只會得到語法錯誤,因為 JavaScript 中的 < 與 > 必須被視為運算子。經過 JSX 轉譯後,它會變成:

var ExampleComponent = React.createClass({
  render: function () {
    return (
      React.createElement('div', {className: 'navigation'}, 'Hello World!')
    );
  }
});

JSX 會把每個標籤翻譯成 React.createElement 呼叫,產生節點型別、屬性與內容。你当然可以不用 JSX,但那就得親手寫出每一層 createElement。

你一定好奇為什麼這裡用 className 而不是 class。因為 class 是 JavaScript 的保留字。JSX 轉譯時會把標籤屬性收攏成一個物件,而物件裡不能放保留字當 key。

把變數放進屬性

若想動態改變元件的樣式類(或任何屬性值),可以用變數,但要記得用一對大括號把它包起來,JSX 才知道那是外部變數:

var ExampleComponent = React.createClass({
  render: function () {
    var navigationClass = 'navigation';
    return (
      <div className={ navigationClass }>
        Hello World!
      </div>
    );
  }
});

第一次渲染

要渲染一個 React 元件,需告訴 React 渲染哪個元件、掛在哪個既有的 DOM 節點上,這由 React.render 負責:

var ExampleComponent = React.createClass({
  render: function () {
    return (
      <div className="navigation">
        Hello World!
      </div>
    );
  }
});

React.render(<ExampleContent />, document.body);

它會把元件渲染到 body 上。之後你就能像一般方式那樣呼叫其他元件;若想保留頁面其餘部分,也可以多次呼叫 render,只讓部分區域由 React 接管。

屬性與狀態

元件可以擁有自己的「狀態」,這讓我們能重複使用同一個元件,卻讓每個實例看起來完全不同,因為各自的狀態彼此獨立。

而從外部傳進元件的資料稱為「屬性」(props)。內容不限於 HTML 屬性——你想傳什麼都可以,並在元件內透過 this.props 存取。這讓我們能重用同一個元件,只是傳入不同的設定。

對下拉導覽來說,我們需要把導覽設定作為物件傳入:

var navigationConfig = [];

var Navigation = React.createClass({
  render: function () {
    return (
      <div className="navigation"></div>
    );
  }
});

React.render(<Navigation config={ navigationConfig } />, document.body);

此時若存取 this.props.config,會得到一個空陣列。

狀態則是元件自己維護的資料。使用時要先定義初始狀態,之後透過 this.setState 更新。每當狀態更新,元件都會再次呼叫 render,用新值取代或修改先前渲染的結果。這正是虛擬 DOM 的精髓——差異計算在 React 內部完成,我們不必依賴緩慢的 DOM 更新。React 會算出最小差異並產生一批指令(例如為 navigation__link 加上 active 類,或移除某個節點),再作用到 DOM 上。

我們用狀態來記錄目前展開的是哪一個下拉選單。加上 getInitialState 並回傳初始狀態:

var Navigation = React.createClass({
  getInitialState: function () {
    return { openDropdown: -1 };
  },
  render: function () {
    return (
      <div className="navigation"></div>
    );
  }
});

這裡設為 -1 是因為我們稍後會用狀態裡的索引指向設定陣列中的某一項,而陣列索引從 0 開始,因此 -1 代表「目前沒有展開任何一項」。存取時用 this.state.openDropdown 即可。

元件生命週期

每個元件都有「生命週期」——一系列你可以在元件設定中定義的函數,會在元件生命的不同階段被呼叫。前面看過的 getInitialState 就是其中之一,它只在元件掛載時被呼叫一次。

componentWillMount

在元件即將掛載時呼叫。由於 render 在元件生命週期中會被呼叫多次,我們通常把只需執行一次的程式放在這裡,例如 XHR 請求。

var ExampleComponent = React.createClass({
  componentWillMount: function () {
    // 在此發出 XHR 請求取得資料
  },
  render: function () {
    // 這個方法在元件生命週期中會被呼叫很多次
    return (
      <div>Hello World!</div>
    );
  }
});

componentDidMount

當 render 執行完、元件已實際渲染進 DOM 之後呼叫。任何需要操作 DOM 的工作都放在這裡,例如繪製圖表。可透過 this.getDOMNode() 取得 DOM 節點。

var ExampleComponent = React.createClass({
  componentDidMount: function () {
    var node = this.getDOMNode();
    // 在該節點上渲染圖表
  },
  render: function () {
    return (
      <div>Hello World!</div>
    );
  }
});

componentWillUnmount

在元件即將從 DOM 移除時呼叫。這讓我們能做善後清理,例如移除已綁定的事件監聽器。若沒清理,當某個事件被觸發而元件已不存在時,React 就會拋出錯誤。

var ExampleComponent = React.createClass({
  componentWillUnmount: function () {
    // 解除此元件專屬的事件監聽器
  },
  render: function () {
    return (
      <div>Hello World!</div>
    );
  }
});

元件方法:getDefaultProps 與 propTypes

getDefaultProps 讓我們為屬性定義預設值。如此一來,呼叫元件時即使沒給值,元件仍有一份合理的預設「設定」,不必在程式碼裡處處檢查屬性是否存在。

這些預設屬性會被快取,因此對每個元件實例都相同且不可變動。對導覽元件,我們把設定指定為空陣列,這樣即使沒傳入設定,render 內也不會出錯。

var Navigation = React.createClass({
  getInitialState: function () {
    return { openDropdown: -1 };
  },
  getDefaultProps: function () {
    return { config: [] };
  },
  render: function () {
    return (
      <div className="navigation"></div>
    );
  }
});

propTypes 則可為每個屬性指定型別,這在檢查意外的賦值時很有用。以下指定只有陣列才能放進設定:

var Navigation = React.createClass({
  getInitialState: function () {
    return { openDropdown: -1 };
  },
  getDefaultProps: function () {
    return { config: [] };
  },
  propTypes: {
    config: React.PropTypes.array
  },
  render: function () {
    return (
      <div className="navigation"></div>
    );
  }
});

mixins:共用邏輯

我們也能在元件中加入 mixins。它是一個獨立於 React 的設定物件,讓我們在多個元件間共享邏輯(例如初始狀態相同、或需要綁定同一批事件)。

var ExampleMixin = {
  componentDidMount: function () {
    // 在此綁定事件監聽器
  },
  componentWillUnmount: function () {
    // 在此解除綁定
  }
};

var ExampleComponent = React.createClass({
  mixins: [ExampleMixin],
  render: function () {
    return (<div>Hello World!</div>);
  }
});

var AnotherComponent = React.createClass({
  mixins: [ExampleMixin],
  render: function () {
    return (<div>Hello World!</div>);
  }
});

如此一來,兩個元件都具備相同的 componentDidMount 與 componentWillUnmount,省下重複撰寫。但要留意:mixin 中已設定的方法無法在元件內覆蓋。

用 map 遍歷陣列

當我們有一個物件陣列,該如何遍歷並把每一項渲染成列表項?由於 JSX 本質上就是 JavaScript,我們可以直接 map 這個陣列並回傳 JSX:

var navigationConfig = [
  { href: 'https://example.com', text: 'My Website' }
];

var Navigation = React.createClass({
  getInitialState: function () {
    return { openDropdown: -1 };
  },
  getDefaultProps: function () {
    return { config: [] };
  },
  propTypes: {
    config: React.PropTypes.array
  },
  render: function () {
    var config = this.props.config;
    var items = config.map(function (item) {
      return (
        <li className="navigation__item">
          <a className="navigation__link" href={ item.href }>
            { item.text }
          </a>
        </li>
      );
    });

    return (
      <div className="navigation">
        { items }
      </div>
    );
  }
});

React.render(<Navigation config={ navigationConfig } />, document.body);

設定由陣列與物件組成,每個物件有指向超連結的 href 與用於顯示的 text。map 時逐一取出物件並在 HTML 中使用其屬性;回傳的陣列交給 React 處理,它自然知道該如何渲染。

加入子選單

接著處理下拉項目。我們用 children 屬性來表示子項目,並在迴圈中把子元素渲染出來:

var navigationConfig = [
  {
    href: 'https://example.com',
    text: 'My Website',
    children: [
      { href: 'https://example.com/a', text: '子項目 A' },
      { href: 'https://example.com/b', text: 'React' }
    ]
  }
];

var Navigation = React.createClass({
  getInitialState: function () {
    return { openDropdown: -1 };
  },
  getDefaultProps: function () {
    return { config: [] };
  },
  propTypes: {
    config: React.PropTypes.array
  },
  render: function () {
    var config = this.props.config;
    var items = config.map(function (item) {
      var children, dropdown;

      if (item.children) {
        children = item.children.map(function (child) {
          return (
            <li className="navigation__dropdown__item">
              <a className="navigation__dropdown__link" href={ child.href }>
                { child.text }
              </a>
            </li>
          );
        });

        dropdown = (
          <ul className="navigation__dropdown">
            { children }
          </ul>
        );
      }

      return (
        <li className="navigation__item">
          <a className="navigation__link" href={ item.href }>
            { item.text }
          </a>
          { dropdown }
        </li>
      );
    });

    return (
      <div className="navigation">
        { items }
      </div>
    );
  }
});

此時子項目仍會全部顯示,因為 openDropdown 還是 -1,我們尚未把它與樣式連上。

用狀態控制展開與收合

透過 this.state 我們可以判斷哪一個下拉該展開,並動態加上對應的 CSS 類別:

var Navigation = React.createClass({
  getInitialState: function () {
    return { openDropdown: -1 };
  },
  getDefaultProps: function () {
    return { config: [] };
  },
  propTypes: {
    config: React.PropTypes.array
  },
  openDropdown: function (id) {
    this.setState({ openDropdown: id });
  },
  closeDropdown: function () {
    this.setState({ openDropdown: -1 });
  },
  render: function () {
    var config = this.props.config;

    var items = config.map(function (item, index) {
      var children, dropdown;

      if (item.children) {
        children = item.children.map(function (child) {
          return (
            <li className="navigation__dropdown__item">
              <a className="navigation__dropdown__link" href={ child.href }>
                { child.text }
              </a>
            </li>
          );
        });

        var dropdownClass = 'navigation__dropdown';
        if (this.state.openDropdown === index) {
          dropdownClass += ' navigation__dropdown--open';
        }

        dropdown = (
          <ul className={ dropdownClass }>
            { children }
          </ul>
        );
      }

      return (
        <li className="navigation__item"
            onMouseOut={ this.closeDropdown }
            onMouseOver={ this.openDropdown.bind(this, index) }>
          <a className="navigation__link" href={ item.href }>
            { item.text }
          </a>
          { dropdown }
        </li>
      );
    }, this);

    return (
      <div className="navigation">
        { items }
      </div>
    );
  }
});

React.render(<Navigation config={ navigationConfig } />, document.body);

滑鼠移入「My Website」時,對應的下拉便會展開。

這裡有兩個細節值得說明。第一,map 的第二個參數傳入了 this,因為在 map 的回呼函數中我們需要存取 this.state,若未綁定 this,它就會指向錯誤的物件。第二,onMouseOver 使用了 bind(this, index):滑鼠移出時我們只需關閉下拉,不需要知道是哪一項,所以 closeDropdown 可以直接傳;但移入時必須知道是哪個索引被展開,因此需要透過 bind 預先帶入參數。若直接呼叫函數,它會在渲染時立即執行,而非等到事件發生。

完成後,我們就能自由地往 navigationConfig 增加項目,也能為下拉效果補上 transition 之類的樣式細節。

關於這份範例的時代背景

需要說明的是,範例中的 React.createClass、React.PropTypes、mixins 與 this.getDOMNode() 都屬於 React 早期寫法。以今日的標準而言:

  • 元件應以函數元件搭配 Hooks(useState、useEffect)撰寫,mixins 已改由自訂 Hook 取代。
  • PropTypes 已獨立為 prop-types 套件,多數專案改用 TypeScript 在編譯期檢查型別。
  • 控制 hover 的下拉選單,通常直接用 CSS 的 :hover 與 :focus-within 就能完成,不必動用狀態;狀態留給需要點擊、鍵盤操作或點擊外部關閉的情境。

但這份範例想傳達的核心觀念依然適用:元件可組合、props 由外傳內、狀態由 setState 驅動重繪、生命週期函數負責不同階段的副作用。把這些想通,再用現代語法重寫一遍,你會發現整條學習路徑其實一以貫之。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved