這篇整理了第 1 到 15 號實用小函式,都是日常開發會反覆遇到的需求:圖片等比縮放、文字輸入限制、視窗控制、收藏與首頁、Ajax 帳號檢查、Email 與帳號格式驗證、新聞滾動、數字輸入過濾與字串處理。
本篇目錄
1. 圖片等比縮放/裁切 2. 控制 textarea 字數 3. 開啟新視窗 4. input 隨內容伸縮 5. 加入收藏 6. 設為首頁 7. Ajax 判斷帳號是否存在 8. 檢核 email 格式 9. 綜合判斷帳號 10. 新聞滾動 11. 限制只能輸入正整數/正數 12. 字串轉數字 13. 取得副檔名 14. 截取字串 15. 分割字串
// 用法:<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。
/** 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 事件;若要限制「視覺行數」,需要另外計算。
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,既不必被攔截,也能自訂樣式。順帶一提:以「強制彈窗」為目的的寫法多半會被瀏覽器策略擋下,這其實是好事。
// <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);
}
}
以「全形算兩個字元」的方式估算視覺寬度,是個實用的折衷技巧。
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),並搭配圖示引導。
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/');
}
}
同樣地,出於安全與使用者選擇權,現代瀏覽器完全封鎖了「用程式碼改首頁」的能力。請改成引導式提示,讓使用者自行設定。
$("#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),避免每敲一個字就打一次後端。
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,}。
// 使用實例
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}$/。別忘了後端也要驗一次。
<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。
<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" 也無法阻擋貼上,所以後端驗證不可省)。
/* 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(); // 會丟出錯誤
// 用法: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),並重新編碼圖片,避免把惡意檔案存進伺服器。
// 簡單版 <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 則能處理視覺上的溢出。
<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,程式碼會短很多,也少掉不少邊界情況的坑。