本文へ移動

Kotoba言葉

必要な単語一覧だけを読み込み、重複する文字を正しく判定し、日替わりやシード付きの単語ゲームを遊べます。

「Kotoba」は「言葉」です。 名前について(英語)

目次

やり方

React・Vue・Svelte・Angular

React・Vue・Svelte・Angular でゲームの要素を使います。サーバーでの描画も壊れないインポートです。

<kotoba-game> は Web コンポーネントなので、どのフレームワークでも使えます。共通の注意が2つあります。

  1. タグを登録する入口を読み込みます(@johnmorrisdotca/kotoba/element/define)。サーバーで読み込んでも安全で、何も登録されません。ゲームはブラウザーで描かれます。
  2. そのタグがあることをフレームワークに伝えます。 React には型、Vue にはコンパイラーの設定、Angular にはスキーマが要ります。Svelte は何も要りません。

React

Game.tsx です。React 19 は属性をそのままカスタム要素に渡します。

import "@johnmorrisdotca/kotoba/element/define";

export function Game({ words = "en", letters = 5 }: { words?: string; letters?: number }) {
  return <kotoba-game words={words} letters={String(letters)} daily="today" />;
}

TypeScript では、React にタグがあることを伝えます(kotoba-game.d.ts のようなファイル)。

import type { DetailedHTMLProps, HTMLAttributes } from "react";

declare module "react" {
  namespace JSX {
    interface IntrinsicElements {
      "kotoba-game": DetailedHTMLProps<HTMLAttributes<HTMLElement>, HTMLElement> & { words?: string; letters?: string; daily?: string; easy?: boolean; seed?: string; lang?: string; size?: string; theme?: string };
    }
  }
}

いつもどおりに載せます。

import { createRoot } from "react-dom/client";
import { Game } from "./Game";

createRoot(document.getElementById("root")!).render(<Game />);

コンポーネントは、サーバーでも文字列に描けます(renderToString)。パッケージのテストが確かめています。HTML にタグが入り、ゲームはブラウザーで描かれます。

import { renderToString } from "react-dom/server";
import { Game } from "./Game";

console.log(renderToString(<Game />));

Vue

<script setup lang="ts">
import "@johnmorrisdotca/kotoba/element/define";

withDefaults(defineProps<{ words?: string; letters?: number }>(), { words: "en", letters: 5 });
</script>

<template>
  <kotoba-game :words="words" :letters="letters" daily="today"></kotoba-game>
</template>

kotoba-* のタグはカスタム要素だと、Vue のコンパイラーに伝えます(vite.config.mjs)。

import vue from "@vitejs/plugin-vue";

export default {
  plugins: [vue({ template: { compilerOptions: { isCustomElement: (tag) => tag.startsWith("kotoba-") } } })],
};

あとはいつもどおりに載せます。

import { createApp } from "vue";
import Game from "./Game.vue";

createApp(Game).mount("#app");

Svelte

<script lang="ts">
  import "@johnmorrisdotca/kotoba/element/define";

  let { words = "en", letters = 5 }: { words?: string; letters?: number } = $props();
</script>

<kotoba-game {words} {letters} daily="today"></kotoba-game>
import { mount } from "svelte";
import Game from "./Game.svelte";

mount(Game, { target: document.getElementById("app")! });

Angular

スタンドアロンで、CUSTOM_ELEMENTS_SCHEMA を付けて、テンプレートに未知のタグを置けるようにします。

import { Component, CUSTOM_ELEMENTS_SCHEMA } from "@angular/core";
import "@johnmorrisdotca/kotoba/element/define";

@Component({
  selector: "app-game",
  standalone: true,
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `<kotoba-game words="en" letters="5" daily="today"></kotoba-game>`,
})
export class GameComponent {}
import "@angular/compiler";
import { provideZonelessChangeDetection } from "@angular/core";
import { bootstrapApplication } from "@angular/platform-browser";
import { GameComponent } from "./game.component";

void bootstrapApplication(GameComponent, { providers: [provideZonelessChangeDetection()] });

Next.js・Nuxt・SvelteKit

これらはまずサーバーで描きます。上のインポートはサーバーでも安全なので、コンポーネントはそのまま動きます。Next.js の App Router では、コンポーネントのファイルの先頭に "use client" を書きます。

ソースを見るGitHub で編集@johnmorrisdotca/kotoba 1.11.0 のソースから作成しました。

この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。