Palt Typesetting

Typesetting Library for Proportional Spacing

Palt Typesetting は、美しいテキスト表示を実現するための JavaScript ライブラリです。和欧混植、およびツメ組み (font-feature-settings: 'palt') の版面設計において、最大限の力を発揮します。

四分アキの自動挿入、カーニングルールの適用、英語のような単語区切りでの改行など、洗練された組版機能を提供します。

Demo

Getting Started

Install from NPM

npm でパッケージをインストールする場合

npm install palt-typesetting

import Typesetter from 'palt-typesetting'
import 'palt-typesetting/dist/typesetter.css'

// Typesetter のインスタンスを作成
const typesetter = new Typesetter()

// セレクターにマッチする要素に対して組版を適用
typesetter.renderToSelector('.my-class')

Use from CDN

WordPress や jQuery などの環境で使用する場合

<head>
  <!-- head タグ内でスタイルの読み込み -->
  <link rel="stylesheet" type="text/css" href="https://unpkg.com/palt-typesetting@0.7.1/bundle/typesetter.min.css" />
</head>

<body>
  <!-- body 閉じタグの前でスクリプトの読み込み -->
  <script src="https://unpkg.com/palt-typesetting@0.7.1/bundle/typesetter.min.js"></script>
</body>

<script>
  // Typesetter のインスタンスを作成
  const typesetter = new Typesetter()

  // セレクターにマッチする要素に対して組版を適用
  typesetter.renderToSelector('.my-class')
</script>

Apply Custom CSS

生成された組版用 HTML にカスタム CSS を適用

/**
 * 共通のスタイリング（例）
 */
.typesetting-wrapper {
  /* プロポーショナルメトリクス（ツメ組み）の設定 */
  font-feature-settings: 'palt';

  /* 行間 */
  line-height: 1.8;

  /* 文字間 */
  letter-spacing: 0.1em;

  /**
   * Safari のフォントレンダリング対策。
   * 英数（.typesetting-latin）で -webkit-text-stroke を使う場合は必須。
   * text-stroke-weight > 0, text-stroke-color: transparent
   */
  -webkit-text-stroke: 0.01em transparent;
}

/**
 * 英数のみのスタイリング（例）
 */
.typesetting-latin {
  /* フォントの拡大・縮小 */
  font-size: 105%;

  /* ベースラインの調整 */
  vertical-align: 0.02em;

  /**
   * 行間の調整。親要素 .typesetting-wrapper の行間と視覚的に合わせます。
   * [.typesetting-wrapper の line-height] ÷ [フォントの拡大率] - [ベースラインの調整値の絶対値] × 2 
   */
  line-height: calc(1.8 / 1.05 - 0.02 * 2);

  /* 文字間の調整 */
  letter-spacing: 0.05em;

  /* 文字の細らせ・太らせ */
  -webkit-text-stroke: 0.01em #000;
}

Typesetter Class

Palt Typesetting では、Typesetter クラスを使用して HTML 文字列に組版を適用します。
ライブラリの機能はオプションを通じてカスタマイズできます。

サンプルコード

/**
 * options: TypesettingOptions
 * オプションの設定
 */
const options = {
  // 単語や助詞など、単語区切りでの改行を行います。
  useWordBreak: true,

  // 英数を `.typesetting-latin` でラップします。
  wrapLatin: true,

  // 罫線などの分離禁則文字を `.typesetting-no-breaks` でラップし、文字間を 0 に設定します。
  noSpaceBetweenNoBreaks: true,

  // 四分アキスペースを自動で挿入します。
  insertThinSpaces: true,

  // 四分アキスペースの幅を設定します。
  thinSpaceWidth: '0.2em',

  // 特定の文字間のカーニングルールを設定します。
  kerningRules: [
    {
      between: ['し', 'ま'],
      value: '60',
    },
    {
      between: ['す', '。'],
      value: '-80',
    },
  ],
}

/**
 * Typesetter(options?: TypesettingOptions)
 * インスタンスの作成
 */
const typesetter = new Typesetter(options)

/**
 * renderToSelector(selector: string): void
 * セレクターにマッチする要素に対して組版を適用
 */
typesetter.renderToSelector('div')
typesetter.renderToSelector('.my-class')
typesetter.renderToSelector('#my-id')

/**
 * renderToElements(elements: string): void
 * HTML 文字列に組版を適用
 */
const elements = document.querySelectorAll('.my-class')
typesetter.renderToElements(elements)

/**
 * render(srcHtml: string): string
 * 組版を適用した HTML 文字列の取得
 */
const srcHtml = '「日本語」とEnglish'
console.log('output: ' + typesetter.render(srcHtml))
// output: <span class="typeset typesetting-wrapper typesetting-word-break">「日本語」<span class="typesetting-thin-space" style="letter-spacing: 0.2em;" data-content=" "></span>と<span class="typesetting-thin-space" style="letter-spacing: 0.2em;" data-content=" "></span><span class="typesetting-latin">English </span></span>

コンストラクタ

コンストラクタ	説明	引数の型
`Typesetter(options?)`	Typesetter インスタンスを作成します。オプションを指定することでカスタムの組版設定を適用できます。	`options?: TypesettingOptions`

メソッド

メソッド名	説明	引数の型	戻り値の型
`render(srcHtml)`	スタイルを適用した HTML 文字列を返します。	`string`	`string`
`renderToElements(elements)`	指定された Element または Element の配列にスタイルを適用します。	`Element \| Element[]`	`void`
`renderToSelector(selector)`	指定された CSS セレクタに一致するすべての要素にスタイルを適用します。	`string`	`void`

オプション

オプション名	説明	オプションの型	デフォルト値
`useWordBreak`	単語や助詞など、単語区切りでの改行を行います。	`boolean`	`true`
`wrapLatin`	英数を `span.typesetting-latin` でラップします。	`boolean`	`true`
`noSpaceBetweenNoBreaks`	罫線などの分離禁則文字を `span.typesetting-no-breaks` でラップし、文字間を 0 に設定します。	`boolean`	`true`
`insertThinSpaces`	四分アキスペースを自動で挿入します。	`boolean`	`true`
`thinSpaceWidth`	四分アキスペースの幅を設定します。	`string`	`'0.2em'`
`kerningRules`	特定の文字間のカーニングルールを設定します。	`{between: [string, string], value: string \| number}[]`	`[]`

生成される CSS クラス

CSS クラス名	説明
`.typesetting-wrapper`	HTML 文字列中のテキストコンテンツをラップします。オプションの指定に関わらず、常に生成されます。
`.typesetting-word-break`	HTML 文字列中のテキストコンテンツをラップします。 `useWordBreak: true` のときに生成されます。
`.typesetting-latin`	テキストコンテンツ中の英数をラップします。 `wrapLatin: true` のときに生成されます。
`.typesetting-no-breaks`	テキストコンテンツ中の分離禁則文字をラップします。 `noSpaceBetweenNoBreaks: true` のときに生成されます。
`.typesetting-thin-space`	挿入される四分アキスペースエレメントの CSS クラスです。 `insertThinSpaces: true` のときに生成されます。
`.typesetting-kerning`	挿入されるカーニングエレメントの CSS クラスです。有効な `kerningRules` が存在するときに生成されます。

for Typescript

TypeScript の型定義を提供しています。完全な型定義はこちらをご参照ください。

サンプルコード

import Typesetter from 'palt-typesetting'
import type { TypesettingOptions, KerningRule } from 'palt-typesetting/types'
import 'palt-typesetting/dist/typesetter.css'

const kerning: KerningRule[] = [
  {
    between: ['し', 'ま'],
    value: '60',
  },
]

const options: TypesettingOptions = {
  thinSpaceWidth: '0.25em',
  kerningRules: kerning,
}

const typeset = new Typesetter(options)
typesetter.renderToSelector('.my-class')

for Frameworks

モダンな JavaScript フレームワーク用のサンプル集です。

Astro.js

Typesetting コンポーネントの作成

components/Typesetting.astro

---
import Typesetter from 'palt-typesetting'
import 'palt-typesetting/dist/typesetter.css'

const { content } = Astro.props
const slot = await Astro.slots.render('default')
const srcHtml = content || slot || ''

const typesetter = new Typesetter();
---

<!-- srcHtml が空でなければ組版を適用 -->
{srcHtml && <Fragment set:html={typesetter.render(srcHtml)} />}

<!-- 合成フォントのイメージでスタイルを設定 -->
<style is:global>
  /* 共通のスタイル */
  .typesetting-wrapper {
    font-feature-settings: 'palt';
    letter-spacing: 0.1em;
  }

  /* 英数のスタイル */
  .typesetting-latin {
    font-size: 105%;
    letter-spacing: 0.05em;
  }
</style>

Typesetting コンポーネントの読み込み

pages/index.astro

---
import Typeset from '../components/Typesetting.astro'
---

<div>
  <!-- props を使った書き方 -->
  <Typesetting content="「日本語」とEnglish、晴れ・28度。" />

  <!-- slot を使った書き方 -->
  <Typesetting>
    <a href="/work">作品ページ</a>
  </Typesetting>
</div>

<style>
 p {
  font-size: 1.8rem;
 }
</style>

Notes

環境要件

Palt Typesetting ライブラリは、テキストを言語固有のセグメントに分割する Intl.Segmenter という機能に一部依存しています。そのため、以下の環境要件があります。

SSG など、サーバーサイドで実行する場合

Node.js 16.0.0 以上

クライアントサイドで実行する場合

Intl.Segmenter をサポートしているブラウザ

クライアントサイドで実行する場合、この機能は一部のブラウザで利用できません。Palt Typesetting ライブラリは、Firefox などの Intl.Segmenter がサポートされていない環境¹ では、useWordBreak（単語区切りでの改行）と insertThinSpaces（四分アキの自動挿入）オプションがスキップされます。全てのモダンブラウザで同様の見え方を再現するには、サーバーサイドでの事前処理（Astro.js での SSG など）が必要となります。

Intl.Segmenter の対応状況については、Can I use... で確認できます。

注意事項

Palt Typesetting ライブラリは HTML 入力をサポートしていますが、入力された HTML をサニタイズする機能は含まれていません。入力を信頼できない場合は、適切なサニタイザライブラリと共に使用することを強く推奨します。

Author

飯塚大和 (Yamato Iizuka)

Firefox では、バージョン 125 から Intl.Segmenter のサポートが予定されています。 ↩

yamatoiizuka / palt-typesetting

Palt Typesetting

Typesetting Library for Proportional Spacing

Demo

Getting Started

Install from NPM

Use from CDN

Apply Custom CSS

Typesetter Class

サンプルコード

コンストラクタ

メソッド

オプション

生成される CSS クラス

for Typescript

サンプルコード

for Frameworks

Astro.js

Notes

環境要件

注意事項

Author

About

Languages

Palt Typesetting

Typesetting Library for Proportional Spacing

Demo

Getting Started

Install from NPM

Use from CDN

Apply Custom CSS

Typesetter Class

サンプルコード

コンストラクタ

メソッド

オプション

生成される CSS クラス

for Typescript

サンプルコード

for Frameworks

Astro.js

Notes

環境要件

注意事項

Author

Footnotes

About

Languages