DIV CSS 佈局教程網

jQuery 標籤輸入外掛 Tag it 使用指南
編輯:JavaScript綜合知識     

標籤(tag)輸入是現代表單中很常見的互動模式:使用者輸入關鍵詞後按 Enter 或 Tab,該詞就變成一個可獨立刪除的標籤區塊。本文介紹的 Tag it 就是實現這個效果的外掛。

功能與價值

坦白說,若只看「收集關鍵詞」這個目的,一個普通的 text input 加上逗號分隔就能取代它。Tag it 真正的價值在兩點:

  1. 輸入提示(autocomplete)——已存在的標籤會即時提示,避免同義詞重複
  2. 視覺化的整體感——每個關鍵詞成為一個實體方塊,方便瀏覽與單獨刪除

依賴關係

Tag it 是 jQuery UI 的擴充,因此除了 jQuery 本體,還必須引入 jQuery UI 及其樣式表。這也是為什麼它的樣式預設長得像 jQuery UI——因為它就是沿用那套 theme roller 的 class。

好處是:jQuery UI 官方與社群有提供大量現成主題,可以直接套用換色換風格。

支援的事件

Tag it 在標籤的生命週期各階段都有對應事件:新增前、新增後、刪除前、刪除後。这让「新增標籤時順便送出 Ajax 請求」或「刪除前先確認」這類需求都能實現。

使用步驟

1. 引入檔案

<script src="jquery.js" type="text/javascript"></script>
<script src="jquery-ui.js" type="text/javascript"></script>
<script src="tag-it.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="jquery-ui.css">
<link href="jquery.tagit.css" rel="stylesheet" type="text/css">

2. 自訂樣式

#container { width: 400px; }
input[type=submit] { padding: 8px; }

/* 外框邊界 */
#singleFieldTags {
  border: 1px solid #b1c9dc;
  background: #e7e3ca;
}

/* 輸入中的文字 */
#singleFieldTags input {
  background: #e7e3ca;
  color: blue;
}

/* 標籤本身的樣式 */
#singleFieldTags li {
  background: #e7e3ca;
  border: 1px solid #930;
  color: red;
}

/* 最外層的 new-tag 容器要去除邊框,才不會出現多餘線條 */
#singleFieldTags .tagit-new { border: none; }

3. 初始化 JavaScript

$(function(){

  var sampleTags = ['c++', 'java', 'php', 'coldfusion', 'javascript',
                    'asp', 'ruby', 'python', 'c', 'scala', 'groovy',
                    'haskell', 'perl', 'erlang', 'apl', 'cobol', 'go', 'lua'];

  // 用法一:最簡單,值存進隱藏欄位
  $('#myTags').tagit({
    singleField: true,
    singleFieldNode: $('#myTagsValues')
  });

  // 用法二:加上自動提示、允許空格
  $('#singleFieldTags').tagit({
    availableTags: sampleTags,       // 輸入提示的候選清單
    singleField: true,
    allowSpaces: true,               // 標籤中允許空白
    singleFieldNode: $('#mySingleField')
  });

  $('#submit1').click(function(){
    alert($('#myTagsValues').val());
  });

  $('#submit2').click(function(){
    alert($('#mySingleField').val());
  });
});

4. HTML 結構

<div id="container">

  <p><b>測試用例一</b></p>
  <ul id="myTags"></ul>
  <input type="hidden" id="myTagsValues" />
  <input type="submit" value="獲取輸入資訊" id="submit1" />

  <p><b>測試用例二:綁定預設關鍵詞,允許空格</b></p>
  <ul id="singleFieldTags"></ul>
  <input name="tags" id="mySingleField" value="CSharp, jQuery" disabled="true" />
  <br />
  <input type="submit" value="獲取輸入資訊" id="submit2" />

</div>

幾個實務提醒

  • singleField 是送出資料的關鍵。開啟後所有標籤會以逗號串接存進指定的 hidden input,後端就照一般表單欄位處理即可,不必在前端拼字串。
  • 那個 disabled 的 input 別誤刪。它只是用來「承接」外掛寫入的值,畫面上不顯示,但表單提交時需要它。
  • allowSpaces 要小心使用。允許空格後,「網頁 設計」會被視為一個標籤,若你的資料模型是以單字為單位,反而會製造髒資料。
  • 標籤數量應該限制。不加上限的話,使用者可以貼進一千個標籤,版面直接爆掉。用 maxTags 設定合理上限。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved