4.1 導言 · Ruby on Rails 教程

# 4.1 導言從前一章得知，即使完全不懂 Ruby 語言，我們也可以創建 Rails 應用的骨架，以及編寫測試。我們依賴于書中提供的測試代碼，得到錯誤信息，然后讓測試組件通過。但是我們不能總是這樣，所以這一章暫時不講網站開發，而要正視我們的短肋——Ruby 語言。前一章末尾我們修改了幾乎是靜態內容的頁面，讓它們使用 Rails 布局，去除視圖中的重復。我們使用的布局如[代碼清單 4.1](#listing-application-layout-redux) 所示（和[代碼清單 3.32](chapter3.html#listing-application-layout) 一樣）。 ##### 代碼清單 4.1：演示應用的網站布局 app/views/layouts/application.html.erb ``` <!DOCTYPE html> <html> <head> <title><%= yield(:title) %> | Ruby on Rails Tutorial Sample App</title> <%= stylesheet_link_tag 'application', media: 'all', 'data-turbolinks-track' => true %> <%= javascript_include_tag 'application', 'data-turbolinks-track' => true %> <%= csrf_meta_tags %> </head> <body> <%= yield %> </body> </html> ``` 我們把注意力集中在上述代碼中的這一行： ``` <%= stylesheet_link_tag "application", media: "all", "data-turbolinks-track" => true %> ``` 這行代碼使用 Rails 內置的方法 `stylesheet_link_tag`（詳細信息參見 [Rails API 文檔](http://api.rubyonrails.org/classes/ActionView/Helpers/AssetTagHelper.html#method-i-stylesheet_link_tag)），在所有[媒介類型](http://www.w3.org/TR/CSS2/media.html)中引入 `application.css`。對有經驗的 Rails 開發者來說，這行代碼看起來很簡單，但是其中至少有四個 Ruby 知識點可能會讓你困惑：內置的 Rails 方法，調用方法時不用括號，符號和哈希。這幾點本章都會介紹。 Rails 除了提供很多內置的方法供我們在視圖中使用之外，還允許我們自己定義。自己定義的方法叫輔助方法（helper）。為了說明如何自己定義輔助方法，我們來看看[代碼清單 4.1](#listing-application-layout-redux) 中標題那一行： ``` <%= yield(:title) %> | Ruby on Rails Tutorial Sample App ``` 這行代碼要求每個視圖都要使用 `provide` 方法定義標題，例如： ``` <% provide(:title, "Home") %> <h1>Sample App</h1> <p> This is the home page for the <a href="http://www.railstutorial.org/">Ruby on Rails Tutorial</a> sample application. </p> ``` 那么，如果我們不提供標題會怎樣呢？標題一般都包含一個公共部分，如果想更具體些，可以再加上變動的部分。我們在布局中用了個小技巧，基本上已經實現了這樣的標題。如果在視圖中不調用 `provide` 方法，也就是不提供變動的部分，那么得到的標題會變成： ``` | Ruby on Rails Tutorial Sample App ``` 標題中有公共部分，但前面還顯示了豎線。為了解決這個問題，我們要自定義一個輔助方法，命名為 `full_title`。如果視圖中沒有定義頁面的標題，`full_title` 返回標題的公共部分，即“Ruby on Rails Tutorial Sample App”；如果定義了，則在變動部分后面加上一個豎線，如[代碼清單 4.2](#listing-title-helper) 所示。[[1](#fn-1)] ##### 代碼清單 4.2：定義 `full_title` 輔助方法 app/helpers/application_helper.rb ``` module ApplicationHelper # 根據所在的頁面返回完整的標題 def full_title(page_title = '') base_title = "Ruby on Rails Tutorial Sample App" if page_title.empty? base_title else page_title + " | " + base_title end end end ``` 現在，這個輔助方法定義好了，我們可以用它來簡化布局。把下面這行： ``` <title><%= yield(:title) %> | Ruby on Rails Tutorial Sample App</title> ``` 改成： ``` <title><%= full_title(yield(:title)) %></title> ``` 如[代碼清單 4.3](#listing-application-layout-full-title) 所示。 ##### 代碼清單 4.3：使用 `full_title` 輔助方法的網站布局 GREEN app/views/layouts/application.html.erb ``` <!DOCTYPE html> <html> <head> <title><%= full_title(yield(:title)) %></title> <%= stylesheet_link_tag 'application', media: 'all', 'data-turbolinks-track' => true %> <%= javascript_include_tag 'application', 'data-turbolinks-track' => true %> <%= csrf_meta_tags %> </head> <body> <%= yield %> </body> </html> ``` 為了讓這個輔助方法起作用，我們要在首頁的視圖中把不必要的單詞“Home”刪掉，只保留標題的公共部分。首先，我們要修改測試代碼，如[代碼清單 4.4](#listing-home-base-title-spec) 所示，確認標題中沒有 `"Home"`。 ##### 代碼清單 4.4：修改首頁的標題測試 RED test/controllers/static_pages_controller_test.rb ``` require 'test_helper' class StaticPagesControllerTest < ActionController::TestCase test "should get home" do get :home assert_response :success assert_select "title", "Ruby on Rails Tutorial Sample App" end test "should get help" do get :help assert_response :success assert_select "title", "Help | Ruby on Rails Tutorial Sample App" end test "should get about" do get :about assert_response :success assert_select "title", "About | Ruby on Rails Tutorial Sample App" end end ``` 我們要運行測試組件，確認有一個測試失敗： ##### 代碼清單 4.5：**RED** ``` $ bundle exec rake test 3 tests, 6 assertions, 1 failures, 0 errors, 0 skips ``` 為了讓測試通過，我們要把首頁視圖中的 `provide` 那行刪除，如[代碼清單 4.6](#listing-home-page-base-title) 所示。 ##### 代碼清單 4.6：沒定義頁面標題的首頁視圖 GREEN app/views/static_pages/home.html.erb ``` <h1>Sample App</h1> <p> This is the home page for the <a href="http://www.railstutorial.org/">Ruby on Rails Tutorial</a> sample application. </p> ``` 現在測試應該可以通過了： ##### 代碼清單 4.7：**GREEN** ``` $ bundle exec rake test ``` （注意，之前運行 `rake test` 時都顯示了通過和失敗測試的數量，為了行文簡潔，從這以后都會省略這些數據。）和引入應用的樣式表那行代碼一樣，[代碼清單 4.2](#listing-title-helper) 的內容對有經驗的 Rails 開發者來說也很簡單，但其中很多重要的 Ruby 知識：模塊，方法定義，可選的方法參數，注釋，本地變量賦值，布爾值，流程控制，字符串拼接和返回值。本章會一一介紹這些知識。