Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Sign up for free
Menu
Search
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Pricing
Search
Sign in
Sign up for free
Content Mapper APIの応用例~CSS Modules、言語ファイル~
Search
Sponsored
·
Your Podcast. Everywhere. Effortlessly.
Share. Educate. Inspire. Entertain. You do you. We'll handle the rest.
→
uhyo
November 01, 2026
Technology
700
2
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
Content Mapper APIの応用例~CSS Modules、言語ファイル~
2026-11-01 TSKaigi Sendai 2026
uhyo
November 01, 2026
Transcript
37 slides
Content Mapper APIの応用例 ~CSS Modules、言語ファイル~ 2026-11-01 TSKaigi Sendai 2026
発表者紹介 uhyo 株式会社カオナビ フロントエンドエキスパート TypeScriptとReactにとても詳しい。 宣伝 → 2
TypeScript 7.1 今月リリース予定! (順調にいけば11月24日) APIやアンビエントモジュール宣言における Import Attributesのサポートなども気になるが、 7.1 Betaのリリース以降、Content Mapper
API に注目が集まっている。 3
Content Mapper API 任意の拡張子のファイルを、TypeScriptファイル のように扱うことができる夢のような機能。 4
Content Mapperでできること 5
従来方式との比較 6
Content Mapperの通信内容 7
マッピングの例 8
マッピングの活用 型エラーの表示や各種エディタ機能に。 9
Content Mapperまとめ 任意のファイルに変換をかませてTypeScript プロジェクトに組み込むことができる。 マッピングを通じて各種エディタ機能も使用可。 (Go to Definitionなど) 10
応用例① CSS Modules 11
CSS Modulesとは フロントエンドアプリ向けにCSSを書く方法の ひとつ。 ViteやNext.jsなどに初期設定で組み込まれており、 デファクトスタンダードな方法。 生のCSS構文を使える点がメリット。 12
CSS Modulesとは 13
CSS Modulesの型サポート: 従来手法 事前に型定義を生成する。 14
CSS Modulesの型サポート: 従来手法 型定義だけだと足りない開発体験を Language Service Pluginで補う。 例: css-modules-kit https://github.com/mizdra/css-modules-kit
15
従来方式との比較(再掲) 16
Content MapperによるCSS Modulesサポート 事前のファイル生成が不要に。 TypeScript組み込みのエディタ機能も利用可能。 17
Content MapperによるCSS Modulesサポート 先ほど紹介したcss-modules-kitが Content Mapperサポートを追加するようなので 応援しよう! (みんなContent Mapperの応用でCSS Modulesを思いつく
から多分既に10個くらい類似OSSが公開されている) 18
応用例② 言語ファイル 19
言語ファイル カオナビでは、最近言語ファイルの新しい仕組み を導入した。 言語ファイル: 多言語をサポートするアプリで、言語ごとに 異なる文言を定義するファイル。 20
言語ファイルの使いかた Viteプラグインで*.lang.jsoncファイルがフックを エクスポートするように変換。 21
言語ファイルシステムの特徴 コロケーション: 細かな粒度の言語ファイルを 使うコードの近くに配置する。既存の設計技術を 文言管理にも持ち込む。 翻訳に有利: 文脈を参照でき、適切な翻訳をしや すい。全言語が同じファイルにあり、翻訳し忘れ が起きない。 22
言語ファイルシステムの裏側 言語ファイルごとに別の名前空間として i18nextに文言を登録している。 1つのJSONが各言語ごとに別々のバーチャル モジュールに分割され、ランタイムでは必要な 言語のみ読み込まれる。 23
言語ファイルにContent Mapperを適用 ※ 単純化した生成例です。 24
Content Mapperの恩恵 keyを間違っ たら型エラー になる。 従来手法より 圧倒的に簡単。 25
応用例: 言語ファイル自体のチェック 26
注意 場合によっては、TypeScriptにチェックさせる より別のlinterでチェックしたほうが効率がいい。 型情報が必要なチェックや、.vueなどTypeScript コードを含む特殊ファイルのチェックに適してい る。 (一応任意のdiagnosticsをTSに送れる機能もある) 27
おまけ: nitrogql v2.1 28
おまけ: nitrogql v2.1 ずっと「.nitrogqlファイルを直接インポートする」 設計を提唱してきたが、Contenet Mapperにより ついに主流の方法に返り咲く!(かも) 29
Content Mapper時代の フレームワーク論 30
Content Mapperがもたらす変化 独自のファイル形式をプロジェクトに組み込みや すくなった。 31
オレオレファイル形式の時代へ ViteプラグインとContent Mapperの両輪で、 独自形式の実装がこれまで以上に簡単になり、 優れた開発者体験を実現しやすくなった。 • 事前の型定義生成など面倒なステップが無い • エディタ機能や型システムの統合までTSが 担ってくれる
32
言語ファイルシステムの狙い AIが開発する時代に適合する独自方式。 • 細かく分割してコンテキスト管理 • コロケーションで発見性向上 • 全言語をコンテキストに投入することで、 文言修正時の翻訳更新漏れを防ぐ 33
独自方式のすすめ 独自方式の実装は簡単になり、メンテナンスも AIで容易にできるようになった。 少し独自実装するくらいは、今の時代、 もはやオーバーエンジニアリングではない。 プロジェクトに合わせてカスタマイズすることの 合理性がとても増した。 34
まとめ Content Mapper APIにより、型や開発者体験を 良好に保ったままTS以外のファイル形式を プロジェクトに組み込めるようになった。 自分たちに合った仕組みを作り込もう。 35
おまけ: Content Mapper以外のAPI 7.1で一部のAPIが安定化予定。 型情報やASTを取得できるJS版に近いAPIが 利用可能になる。 36
37
More Decks by uhyo
See All by uhyo
AIフレンドリーなGenerative UIをJSXで
uhyo
2
110
Reactの設計論
uhyo
26
18k
型があると何が嬉しいか
uhyo
3
180
Baseline対応のDOMの型定義を作った
uhyo
3
1.1k
AIのReact習熟度を測る
uhyo
2
1.1k
React、まだ楽しくて草
uhyo
7
5.3k
TypeScript 7.0の現在地と備え方
uhyo
6
4k
React 19時代のコンポーネント設計ベストプラクティス
uhyo
20
11k
型定義でAIと会話する:型を通じてAIに意図を伝えるテクニック
uhyo
1
140
Other Decks in Technology
See All in Technology
さようならSSH鍵、こんにちはゼロトラスト ― AIフレンドリーで快適な自宅鯖SSH
atalie2m
14
7.5k
認知負荷の減らし方 ~開発にも日常業務にも活かせるノウハウ~
minorun365
PRO
17
10k
データから見る AI時代のエンジニア転職と採用
junya_okura
4
1.3k
NutanixへのSSHアクセスの今後について
shadowhat
0
170
【Oracle AI SPOTLIGHT ウェビナー】AI時代、狙われるデータと止められない業務をどう守るか?
oracle4engineer
PRO
1
140
Taking back control of your AI development
inesmontani
PRO
0
310
Well, that’s weird…
csswizardry
1
200
閉域網でのAPI公開の選択肢全部比較!
takano0131
5
700
Dark Web - Como o Cibercrime Opera na Internet
nicholsjasper
0
110
OCI Artifact による自動運転タクシーに向けた OTA 基盤の構築
biwashi
1
300
AWS re:Invent 2026 FSI Pre-Event Networking Night
junjikoide
0
190
OWASP AI Agentic Top10に準拠するクラウドネイティブなガードレールの実践(CNDW 2026)
keitah
1
440
Featured
See All Featured
DBのスキルで生き残る技術 - AI時代におけるテーブル設計の勘所
soudai
PRO
68
61k
SEO Brein meetup: CTRL+C is not how to scale international SEO
lindahogenes
2
3k
Information Architects: The Missing Link in Design Systems
soysaucechin
1
1.3k
Side Projects
sachag
456
43k
We Are The Robots
honzajavorek
0
460
Game over? The fight for quality and originality in the time of robots
wayneb77
1
340
Writing Fast Ruby
sferik
630
63k
Introduction to Domain-Driven Design and Collaborative software design
baasie
1
1.1k
Done Done
chrislema
187
17k
Beyond borders and beyond the search box: How to win the global "messy middle" with AI-driven SEO
davidcarrasco
3
310
Fireside Chat
paigeccino
43
4.1k
How to Talk to Developers About Accessibility
jct
2
630