DIV CSS 佈局教程網

JavaScript 常用函數精選(上):圖片縮放、輸入限制、表單驗證與滾動
編輯:關於JavaScript     

這篇整理了第 1 到 15 號實用小函式,都是日常開發會反覆遇到的需求:圖片等比縮放、文字輸入限制、視窗控制、收藏與首頁、Ajax 帳號檢查、Email 與帳號格式驗證、新聞滾動、數字輸入過濾與字串處理。

本篇目錄

1. 圖片等比縮放/裁切 2. 控制 textarea 字數 3. 開啟新視窗 4. input 隨內容伸縮 5. 加入收藏 6. 設為首頁 7. Ajax 判斷帳號是否存在 8. 檢核 email 格式 9. 綜合判斷帳號 10. 新聞滾動 11. 限制只能輸入正整數/正數 12. 字串轉數字 13. 取得副檔名 14. 截取字串 15. 分割字串

1. 圖片等比縮放與裁切

 // 用法:<img src="this_image_path.jpg" onload="DrawImage(this,450,450);" />
 function DrawImage(ImgD, FitWidth, FitHeight){
  var image = new Image();
  image.src = ImgD.src;

  if(image.width > 0 && image.height > 0){
   if(image.width/image.height >= FitWidth/FitHeight){
    if(image.width > FitWidth){
     ImgD.width = FitWidth;
     ImgD.height = (image.height * FitWidth) / image.width;
    }else{
     ImgD.width = image.width;
     ImgD.height = image.height;
    }
   }else{
    if(image.height > FitHeight){
     ImgD.height = FitHeight;
     ImgD.width = (image.width * FitHeight) / image.height;
    }else{
     ImgD.width = image.width;
     ImgD.height = image.height;
    }
   }
  }
}

透過 overflow:hidden 做置中裁切:

 function clipImage(o, w, h){
  var img = new Image();
  img.src = o.src;

  if(img.width > 0 && img.height > 0) {
   if(img.width/img.height >= w/h) {
    if(img.width > w) {
     o.width  = (img.width * h) / img.height;
     o.height = h;
     // 用負 margin 把超出部分推到左右兩側之外
     $(o).css("margin-left", "-" + ((o.width - w) / 2).toString() + "px");
    } else {
     o.width  = img.width;
     o.height = img.height;
    }
   } else {
    if(img.height > h) {
     o.height = (img.height * w) / img.width;
     o.width  = w;
     $(o).css("margin-top", "-" + ((o.height - h) / 2).toString() + "px");
    } else {
     o.width  = img.width;
     o.height = img.height;
    }
   }
  }
}

實例:

 <style type="text/css">
 ul{ list-style:none; }
 ul li{ float:left; padding:1px; border:#ccc 1px solid;
  width:120px; height:120px; overflow:hidden; text-align:center; }
</style>

<ul>
 <li><img src="1.jpg" onload="DrawImage(this,120,120);" /></li>
 <li><img src="2.jpg" onload="clipImage(this,120,120);" /></li>
</ul>

現代的替代方案是 CSS:object-fit: cover 就能完成等比裁切,object-fit: contain 則是等比縮放,完全不需要 JS。

2. 控制 textarea 剩餘字數

 /** jQuery 版 */
 function charsRemain(textarea, maxLength, div) {
  var currentLength = $(textarea).val().length;
  var charsLeft = maxLength - currentLength;
  if (charsLeft < 0) { charsLeft = 0; }

  $("#" + div + "_charsRemain").html(charsLeft);

  if (currentLength > maxLength) {
   $(textarea).val($(textarea).val().substring(0, maxLength));
  }
 }

 /** 原生 JS 版 */
 function charsRemain(textarea, maxLength, div) {
  var currentLength = textarea.value.length;
  var charsLeft = maxLength - currentLength;
  if (charsLeft < 0) { charsLeft = 0; }

  document.getElementById(div + "_charsRemain").innerHTML = charsLeft;

  if (currentLength > maxLength) {
   textarea.value = textarea.value.substring(0, maxLength);
  }
 }
 <textarea rows="5" cols="15" onkeyup="charsRemain(this, 250, 'textarea');"></textarea>
<span id="textarea_charsRemain">250</span> characters remaining

提醒:以字元長度限制並不等於使用者看到的位置。中文在 textarea 中不會自動換行,建議改用 maxlength 屬性並搭配 input 事件;若要限制「視覺行數」,需要另外計算。

3. 點擊開啟置中彈窗

 function g_OpenWindow(pageURL, innerWidth, innerHeight) {
  var ScreenWidth  = screen.availWidth;
  var ScreenHeight = screen.availHeight;
  var StartX = (ScreenWidth - innerWidth) / 2;
  var StartY = (ScreenHeight - innerHeight) / 2;

  var wins = window.open(pageURL, 'OpenWin',
   'left=' + StartX + ', top=' + StartY +
   ', Width=' + innerWidth + ', height=' + innerHeight +
   ', resizable=yes, scrollbars=yes, status=no, toolbar=no, menubar=no, location=no');
  wins.focus();
 }

自動彈窗寫法:

 <script language="JavaScript">
 var whatsNew = open('', '_blank',
  'top=50,left=50,width=200,height=300,' +
  'menubar=no,toolbar=no,directories=no,location=no,' +
  'status=no,resizable=no,scrollbars=yes');
 whatsNew.document.write('<center><b>news</b></center>');
 whatsNew.document.write('<p>this is a test');
 whatsNew.document.close();
 </script>

不幸的是,多數瀏覽器會攔截彈出視窗。若確實需要繞過,做法是建立一個 target="_blank" 的表單再送出:

 <script language="javascript">
 function ForceWindow (){
  this.r = document.documentElement;
  this.f = document.createElement("FORM");
  this.f.target = "_blank";
  this.f.method = "post";
  this.r.insertBefore(this.f, this.r.childNodes[0]);
 }

 ForceWindow.prototype.pop = function (sUrl){
  this.f.action = sUrl;
  this.f.submit();
 }

 window.force = new ForceWindow();
 </script>

<body onLoad="window.force.pop('https://deographics.com/')">
 <div>this is a test</div>
</body>

更好的選擇是

元素:

 <script>
 function openWin(){
  document.getElementById('myDialog').showModal();
 }
 </script>

用原生 dialog 取代 window.showModalDialog,既不必被攔截,也能自訂樣式。順帶一提:以「強制彈窗」為目的的寫法多半會被瀏覽器策略擋下,這其實是好事。

4. input 隨內容自動伸縮

 // <input name="words" size="2" maxlength="100" onkeyup="checkLength(this)"/><span id="char">0</span>
 function checkLength(which) {
  var maxchar = 100;
  iCount = which.value.replace(/[^\u0000-\u00ff]/g, "aa").length;  // 全形字元算兩個

  if(iCount <= maxchar){
   which.style.border = '1px dotted #FF0000';
   which.size = iCount + 2;
  }else{
   alert('Please input letter less than ' + maxchar);
  }
 }

以「全形算兩個字元」的方式估算視覺寬度,是個實用的折衷技巧。

5. 加入收藏

 function addfavorite(){
 if (document.all){
  window.external.addFavorite('https://deographics.com/','deographics');
 }else if (window.sidebar){
  window.sidebar.addPanel('deographics', 'https://deographics.com/', "");
 }
}

基於安全理由,現代瀏覽器已不允許網頁以程式碼強制把網站加入書籤。合理做法是提示使用者按 Ctrl+D(Windows)或 Cmd+D(macOS),並搭配圖示引導。

6. 設為首頁

 function setHomepage(){
 if(document.all){
  document.body.style.behavior = 'url(#default#homepage)';
  document.body.setHomePage('https://deographics.com/');
 }else if(window.sidebar){
  if(window.netscape){
   try{
    netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
   }catch(e){
    alert("瀏覽器拒絕了此操作。若要啟用,請在網址列輸入 about:config,"
     + "並將 signed.applets.codebase_principal_support 設為 true");
   }
  }
  var prefs = Components.classes['@mozilla.org/preferences-service;1']
   .getService(Components.interfaces.nsIPrefBranch);
  prefs.setCharPref('browser.startup.homepage','https://deographics.com/');
 }
}

同樣地,出於安全與使用者選擇權,現代瀏覽器完全封鎖了「用程式碼改首頁」的能力。請改成引導式提示,讓使用者自行設定。

7. 用 Ajax 判斷帳號是否存在

 $("#username").blur(function(){
 var name  = $(this).val();
 var table = $(this).attr('title');

 if(name != ''){
  var dataString = 'username=' + name + '&table=' + table;
  $.post("operate.php", dataString, function(data){
   if(data == 0){
    alert('This username already exist !');
    $(this).val('').focus();
    return false;
   }
  });
 }
});

或完整的 $.ajax 寫法:

 var datastring = 'id=' + $id + '&pos=' + $pos;

 $.ajax({
  type: "POST",
  url: url,
  data: datastring,
  beforeSend: function(){},
  error: function(){ alert('Send Error !'); },
  success: function(data) {
   // do something
  }
 });

實務建議:帳號是否存在屬於個資,容易被拿來枚舉會員。請加上速率限制,並在欄位失去焦點後延遲送出(debounce),避免每敲一個字就打一次後端。

8. 檢核 email 格式

 function chekemail(temail){
 var pattern = /^[\w]{1}[\w\.\-_]*@[\w]{1}[\w\-_\.]*\.[\w]{2,4}$/i;
 if(pattern.test(temail)){ return true; }else{ return false; }
}

正則表達式只能做到「看起來像信箱」。真正要確認存在與否,必須寄一封信並等待使用者點擊驗證連結。此外,把頂級域名硬限制在 2–4 字元已經過時(現在有 .technology、.photography 等長尾域名),建議放寬為 {2,}。

9. 綜合判斷帳號格式

 // 使用實例
var username = $('#username');
var backValue = VerifyInput('username');

if(backValue == 'length'){
 alert("Username is make up of 3 - 15 characters!");
 username.focus();
 return false;
}else if(backValue == 'first'){
 alert("the First character must be letter or number !");
 username.focus();
 return false;
}else if(backValue == 'back'){
 alert("Username only contains letter number or '_' ");
 username.focus();
 return false;
}

// 判斷函式
function VerifyInput(user){
 var strUserID = $('#' + user).val();

 if (strUserID.length < 3 || strUserID.length > 15){
  return 'length';
 }else{
  for (var nIndex = 0; nIndex < strUserID.length; nIndex++){
   var cCheck = strUserID.charAt(nIndex);
   if ( nIndex == 0 && ( cCheck == '-' || cCheck == '_') ){
    return 'first';
   }
   if (!(IsDigit(cCheck) || IsAlpha(cCheck) || cCheck == '-' || cCheck == '_')){
    return 'back';
   }
  }
 }
}

function IsDigit(cCheck) { return (('0' <= cCheck) && (cCheck <= '9')); }
function IsAlpha(cCheck) { return ((('a' <= cCheck) && (cCheck <= 'z')) || (('A' <= cCheck) && (cCheck <= 'Z'))); }

用正則表達式可以寫得更短:/^[A-Za-z0-9][A-Za-z0-9_-]{2,14}$/。別忘了後端也要驗一次。

10. 新聞列表滾動

 <style type="text/css">
 ul,li{margin:0;padding:0;font-size:12px;color:#999;}
 ul{height:100px;overflow:hidden;}
 ul li{line-height:20px;height:20px;}
</style>

<ul id="news">
 <li>New York web design Inc.1</li>
 <li>Your site will be structured 2</li>
 <li>hat will communicate the 3</li>
 <li>New York web design Inc. 14</li>
</ul>
 // 參數:操作物件、停留時間、相對速度(越小越快)、每次滾動量(最好等於 line-height)
 scroll('news', 3000, 1, 20);

 function scroll(element, delay, speed, lineHeight) {
  var numpergroup = 5;
  var slideBox = (typeof element == 'string') ? document.getElementById(element) : element;
  var delay = delay || 1000;
  var speed = speed || 20;
  var lineHeight = lineHeight || 20;
  var tid = null, pause = false;

  var liLength = slideBox.getElementsByTagName('li').length;
  var lack = numpergroup - liLength % numpergroup;
  for(i=0; i<lack; i++){
   slideBox.appendChild(document.createElement("li"));
  }

  var start = function() { tid = setInterval(slide, speed); };

  var slide = function() {
   if (pause) return;
   slideBox.scrollTop += 2;

   if ( slideBox.scrollTop % lineHeight == 0 ) {
    clearInterval(tid);
    for(i=0; i<numpergroup; i++){
     slideBox.appendChild(slideBox.getElementsByTagName('li')[0]);
    }
    slideBox.scrollTop = 0;
    setTimeout(start, delay);
   }
  };

  slideBox.onmouseover = function(){ pause = true; };
  slideBox.onmouseout  = function(){ pause = false; };

  setTimeout(start, delay);
 }

滑鼠移入暫停是必備設計,能大幅改善可讀性。若無障礙是重點,請加上 aria-live 並尊重 prefers-reduced-motion。

11. 限制只能輸入正整數或正數

 <script language="JavaScript" type="text/javascript">
 function checkNum(obj){
  var re = /^[1-9]\d*$/;
  if (!re.test(obj.value)){
   alert("只允許正整數!");
   obj.value = '';
   obj.focus();
   return false;
  }
 }
 </script>

<input name="rate" type="text" onkeyup="checkNum(this)" />

若要允許小數:

 <script language="JavaScript" type="text/javascript">
 function clearNoNum(obj) {
  // 先把非數字和小數點的內容都移除
  obj.value = obj.value.replace(/[^\d.]/g, "");
  // 開頭不能是小數點
  obj.value = obj.value.replace(/^\./g, "");
  // 只能有一個小數點
  obj.value = obj.value.replace(/\.{2,}/g, ".");
  obj.value = obj.value.replace(".", "$#$").replace(/\./g, "").replace("$#$", ".");
 }
 </script>

只能輸入數字與小數點的欄位:

 <input id="input1" onkeyup="clearNoNum(this)">

用 type="number" 搭配 min、max、step 屬性,瀏覽器會直接提供驗證與鍵盤輔助,比自行攔 keyup 可靠得多(注意:type="number" 也無法阻擋貼上,所以後端驗證不可省)。

12. 字串轉數字

 /* parseInt() 與 parseFloat() 只有在對 String 呼叫時才會正確運作,
    其他型別會回傳 NaN。 */
 parseInt("1234blue");   // 1234
 parseInt("0xA");        // 10
 parseInt("22.5");       // 22
 parseInt("blue");       // NaN

 parseFloat("1234blue"); // 1234
 parseFloat("0xA");      // NaN
 parseFloat("22.5");     // 22.5
 parseFloat("22.34.5");  // 22.34
 parseFloat("0908");     // 908
 parseFloat("blue");     // NaN

 /* 強制型別轉換 */
 Boolean("");            // false,空字串
 Boolean("hi");          // true
 Boolean(100);           // true
 Boolean(null);          // false
 Boolean(0);             // false
 Boolean(new Object());  // true

 Number(false);          // 0
 Number(true);           // 1
 Number(undefined);      // NaN
 Number(null);           // 0
 Number("5.5 ");         // 5.5
 Number("56 ");          // 56
 Number("5.6.7 ");       // NaN
 Number(new Object());   // NaN
 Number(100);            // 100

 var s1 = String(null);       // "null"
 var oNull = null;
 var s2 = oNull.toString();   // 會丟出錯誤

13. 取得副檔名並驗證格式

 // 用法:get_ext(this, 'img');
 function get_ext(name){
  var pos = name.lastIndexOf('.');
  var extname = name.substring(pos, name.length);
  var lastname = extname.toLowerCase();

  if (lastname != '.jpg' && lastname != '.gif' && lastname != '.png' && lastname != '.bmp'){
   return lastname;
  }else{
   return name;
  }
 }

安全提醒:副檔名完全由使用者提供,可以任意偽造。上傳檔案務必在伺服器端以 MIME 內容實際判定(例如檢查 file signature),並重新編碼圖片,避免把惡意檔案存進伺服器。

14. 截取字串(含中文)

 // 簡單版
 <script type="text/javascript">
 var str = "Hello world!";
 document.write(str.substr(3, 7));   // lo worl
 </script>

中英文混排的版本,以全形字元佔兩個寬度計算:

 <script>
 // 截取字串(含中文處理)
 // 參數:字串、長度、是否加省略號
 function subString(str, len, hasDot) {
  var newLength = 0;
  var newStr = "";
  var chineseRegex = /[^\x00-\xff]/g;
  var singleChar = "";
  var strLength = str.replace(chineseRegex, "**").length;

  for(var i = 0; i < strLength; i++) {
   singleChar = str.charAt(i).toString();
   if(singleChar.match(chineseRegex) != null) {
    newLength += 2;
   } else {
    newLength++;
   }
   if(newLength > len) { break; }
   newStr += singleChar;
  }

  if(hasDot && strLength > len) { newStr += "..."; }
  return newStr;
 }

 document.write(subString("你好,this is a test!", 10, 1));
 </script>

實務上更穩妥的做法是用 Array.from(str) 或 [...str] 切成字元陣列再 slice,能正確處理 emoji 等 surrogate pair;CSS 的 text-overflow: ellipsis 則能處理視覺上的溢出。

15. 分割字串

 <script type="text/javascript">
 var str = 'this_is_a_test_!';
 var arr = str.split('_');
 document.write(arr + "<br />");    // 列出全部
 document.write(arr[0] + "<br />"); // 取單項
 </script>

以上是第 1 到 15 號常用函式整理。這些寫法多成於十年前,我保留了原始思路並標註了現代替代方案——理解原理很重要,但新專案請優先使用標準 API,程式碼會短很多,也少掉不少邊界情況的坑。

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