小粋空間  -  a cheap joke and a play on words site

JavaScript で文字をトリミングする（改善版）

JavaScript を用いてエントリータイトル等の文字をトリミング（指定した文字数だけ表示する）するカスタマイズです。前回の「JavaScript で文字をトリミングする」は文字数だけでトリミングしたものですが、今回の改善版はバイト数で計算します。全角はそのまま1文字として数え、半角英数は2文字（2バイト）を1文字としてカウントします。

左のスクリーンショットが5文字でトリミングしたサンプルです。上は全角のみなので5文字でトリミングし、下は半角を含むので計7文字でトリミングしています。

さらにスクリプトを修正すれば、特定の半角文字（"M"とか"W"のような幅の広い文字）を全角として数えることも可能と思われます。完璧に横幅を揃えることはできませんが、かなり精度の良いトリミングができると思います。

今回も「id 属性名」と「要素名+ class 属性名」で指定したタグの中に記述された文字列をトリミングする、JavaScript を書いてみました。

Windows + IE6/Firefox 2 で実験した限りでは、全角・半角いずれも1文字で計算してトリミングしてくれるようですが、コードに不具合等ありましたらお知らせください。

１．スクリプトの追加

リスト 1.1 のリストを </head> の直前に追加します。外部ファイルでも構いません。

<script type="text/javascript">
var rest = '...';
function cutStringById(id, size) {
  var str = document.getElementById(id).innerHTML;
  if(str.length > size){
    document.getElementById(id).innerHTML = str.substring(0, size) + rest;
  }
}
 
function cutStringByTagNameAndClassName(tagName, className, size) {
  var elements = document.getElementsByTagName(tagName);
  for (i=0; i < elements.length; i++) {
    if (elements[i].getAttribute('class') == className ||
      elements[i].getAttribute('className') == className) {
      var str = elements[i].innerHTML;
      elements[i].innerHTML = trim(str,size);
    }
  }
}
 
function cutStringByIdAndTagName(id, tagName, size) {
  var element = document.getElementById(id);
  var elements = element.getElementsByTagName(tagName);
  for (i=0; i < elements.length; i++) {
    var str = elements[i].innerHTML;
    if(str.length > size){
      elements[i].innerHTML = trim(str,size);
    }
  }
}
 
function trim(str, size) {
  if(str.length > size){
    var cutstring = str.substring(0, size);
    var byte = countByte(cutstring);
    var tmp = "";
    if (byte < size*2) {
       for(k=0; k < (size*2-byte)*2; k++){
         tmp = str.substring(0,size + k);
         if (countByte(tmp) >= size*2) {
           break;
         }
       }
    }
    if(tmp){
      return tmp + rest;
    } else {
      return str.substring(0, size) + rest;
    }
  } else {
    return str;
  }
}
 
function countByte(str) {
  var byte = 0;
  for (j=0; j < str.length; j++) {
    str.charCodeAt(j) < 0x100 ? byte++ : byte += 2;
  }
  return byte;
}
</script>

リスト 1.1 トリミング用スクリプト

２．スクリプトを起動する

リスト 2.1 またはリスト 2.2 のいずれかを 、トリミングしたい文字列の直後、または </body> の直前に追加します。

要素名+ class 属性名で指定

<script type="text/javascript">
cutStringByTagNameAndClassName('[要素名]', '[class 属性名]', トリミングサイズ);
</script>

リスト 2.1 要素名+ class 属性名で指定

id 属性名で指定

<script type="text/javascript">
cutStringById('[id 属性名]', トリミングサイズ);
</script>

リスト 2.2 id 属性名で指定

id 属性名+ 要素名で指定

<script type="text/javascript">
cutStringByIdAndTagName('[id 属性名]', '[要素名]', トリミングサイズ);
</script>

リスト 2.3 id 属性名 + 要素名で指定

具体的な起動方法は３項をご覧ください。

３．サンプル

リスト 3.1 のようにHTMLマークアップされた文字列

<a href="http://domain.com/" class="hoge">文字をトリミングする</a>

リスト 3.1 サンプル1

の「文字をトリミングする」の文字を先頭から 5 文字だけ表示（「文字をトリ...」にする）する場合は、リスト 2.1 を利用し、その赤色部分を、

cutStringByTagNameAndClassName('a', 'hoge', 5);

リスト 3.2 サンプル2

とします。

リスト 3.3 のようにHTMLマークアップされた文字列

<p id="hoge">文字をトリミングする</p>

リスト 3.3 サンプル2

の「文字をトリミングする」の文字を先頭から 5 文字だけ表示（「文字をトリ...」にする）する場合は、リスト 2.2 を用い、その赤色部分を

cutStringById('hoge', 5);

リスト 3.4 サンプル2

とします。

４．トリミング後の追加文字列を変更する

リスト 1.1 の 2 行目（リスト 4.1 の赤色部分）を他の文字に変更してください。何も表示させたくない場合は赤色部分を削除してください。

var rest = '...';

リスト 4.1 トリミング後の文字列

５．特定の半角文字のバイト数を変更する

１項のスクリプトに青色のような行を追加します（間違ってたらすいません）。赤色部分は "0xXX" という、16進数を設定します。

function countByte(str) {
  var byte = 0;
  for (j=0; j < str.length; j++) {
    str.charCodeAt(j) < 0x100 ? byte++ : byte += 2;
    if(str.charCodeAt(j) == [該当文字の16進数]) byte++;
  }
  return byte;
}

リスト 5.1 特定の半角英数を全角文字と同じカウントにする

charCodeAt は指定した文字の Unicode を返却する関数です。JavaScript 1.2 と 1.3 で振る舞いが異なるようです。

2006.12.28 追記
id 属性名+要素名で検索できるコードを、リスト1.1 およびリスト2.3 に追加しました。

2007.02.15 追記
トリミング文字列が短い場合に正常に表示されない不具合を修正しました。

<script type="text/javascript">
<!--
cutStringByIdAndTagName('最新記事list', 'a', 17);
//-->
</script>