More
Charm.js の使い方についてのQ&A
-
Q1どのブラウザでも動きますか?+
Chrome, Safari, Edge, Firefoxは動作確認済みです。
ただし、これらのブラウザでも設定次第では動作しないことがあります。 -
Q2スマホでもスクリプトは動きますか?+
全てのスマホで試したわけではありませんが、AndroidのChromeとiPhoneのSafariでは登録と表示ができることを確認しています。
端末の設定次第では動作しないこともあるかもしれません。 -
Q3カスタム機能の動きはどこから確認できますか?+
コピペ用カスタムコードのページから試せます。
コピペ用カスタムコードから任意のバージョンを選んで確認してください。 -
Q4解説に誤字脱字があるようですが、どこに連絡すればよいですか?+
解説の誤字脱字、Charm.jsのバグはContactへご一報ください。 -
Q5Charm.js v1.2 から Charm.js v3系 へ差し替えても問題ありませんか?+
サイトで紹介している使い方をしている限りは問題なく動くことを確認済みです。
Charm.js の変換は名前登録フォームのidと変換spanタグのclassに大きく依存するため、登録フォームのidとspanタグのclassが揃うようにしてください。
(例:inputタグのidがcharmname1ならspanタグのclassもcharmname1にする)
使い方によっては不具合が生じる可能性もありますので、差し替える前にバックアップをとることをおすすめします。 -
Q6一時登録機能って何ですか? 普通の登録と何が違うのですか?+
登録と一時登録はどちらもブラウザに保存する機能ですが、データの期限が違います。
技術者向けの言葉でいうと、登録ではLocalStorageに保存し、一時登録ではSessionStorageに保存しています。
「登録」は容量がある限りブラウザの履歴を削除したりアンインストールするまでデータが残りますが、「一時登録」はタブを閉じたときやページを閉じたときにクリアされます。
どちらにしても、Cookieのように保存内容がサーバへ送信されることはありません。 -
Q7一時保存時のメッセージ「(一時保存しました)」を変えるにはどうしたらいいですか?+
charm.js の「static sessionString = '(一時保存しました)';」の値を書きかえてください。
※v2.1以前の場合は「const sessionString = '(一時保存しました)';」の値を書き換えてください。
※charm.jsのJavaScript変更は基本的にサポートしていません。慎重に変更してください。 -
Q8自作のJavaScriptの処理の後、自分の好きなタイミングでCharm.jsを動作させることはできますか?+
Charm.jsは読み込まれた時点で自動的に一通りの処理をします。
この動きとは別に、任意のタイミングで一連の処理を再度呼び出すことが可能です。
charm.jsを読み込んだ後にお手元のJavaScriptの中で Charm.run(); と書くことで呼び出せます。
他の処理の内容によっては動かない等ありますので、プログラミングの知識がある方のみお使いください。 -
Q91つの項目につき50文字しか登録できないのですが、増やせますか?+
読み手さんの操作ミスで端末に負担をかけないよう、Charm.jsの初期設定は50文字までしか登録できないようになっています。
登録できる文字数を増減させるには、charm.jsの「static maxSize = 50;」の数値を書き換える必要があります。
例として、100文字まで登録できるようにするなら「static maxSize = 100;」と書きます。
※v2.1以前の場合は「const maxSize = 50;」の数値を書き換えてください。
※charm.jsのJavaScript変更は基本的にサポートしていません。慎重に変更してください。 -
Q10ブラウザの設定でLocalStorage、SessionStorageのどちらも無効になっていても使えますか?+
Charm.js v2.3以降は、ブラウザの設定でこれらが無効化されていても、登録フォームのあるページで「登録」操作をするとページ内で変換することができます。
これは一時的に表示を変えているだけなので他のページでは変換されず、登録フォームの「登録」をしたページも再読み込みで変換前の状態に戻ります。 -
Q11ブラウザの設定でLocalStorage、SessionStorageのどちらも無効になっていることを通知できますか?+
Charm.js v2.3以降は、charm.jsの特定の値を変更すると、ブラウザのアラートで「Web Storageが利用できません。ブラウザの設定を確認してください。」と表示することが可能です。
「static showStorageError = 0;」を「static showStorageError = 1;」に変更すると、無効時にアラートが表示されます。
※charm.jsのJavaScript変更は基本的にサポートしていません。慎重に変更してください。 -
Q12名前削除時にページを再読み込みしないようにするにはどうしたらいいですか?+
Charm.js v2.3以降は、charm.jsの特定の値を変更すると再読み込みしないように変更できます。
「static unsetReload = 1;」を「static unsetReload = 0;」に変更すると再読み込みしなくなります。
この設定になっている場合、再読み込みせずに元々の表示の名前を再表示するようになっていますが、サイトの設定や使用方法によっては再表示がうまくいかないことがありますのでご了承ください。
また、元々の表示内容を内部で保持する都合により動作が重くなる可能性があります。
※charm.jsのJavaScript変更は基本的にサポートしていません。慎重に変更してください。 -
Q13同じサイト(ドメインが同じサイト)の中で複数のCharm.jsを使うことはできますか?+
スクリプト本体の編集が必要ですが、同じサイトの中で複数のCharm.jsを使うことは可能です。
「static storageKeyName = 'charm';」のcharmという文字を別の文字に変更し、フォルダやファイル名を変えて別のファイルとして保存します。
必要に応じて呼び出すスクリプトを変更することで、別のデータとして登録することができます。
ただし、同一のページの中で複数のスクリプト本体を同時に使うことはできないので、それぞれ違うページで使ってください。
※charm.jsのJavaScript変更は基本的にサポートしていません。慎重に変更してください。 -
Q14jQueryやPHPのサイトでも動きますか?+
はい、動きます。
JavaScriptを実行できる環境であれば他のライブラリ、フレームワーク、サーバーサイドの環境に関わらず動きます。
jQuery等のライブラリやVue等のフレームワークを使用していたり、WordPress等のPHP環境でも基本的には動きます。
利用条件・その他のQ&A
-
Q1どんなサイトでも使用していいですか?+
ライセンスの条件を守った使い方であれば誰でもご自由にお使いいただけます。(ライセンス改訂:2024年1月14日) -
Q2無料で使えますか?+
はい、商用・非商用どちらの場合も使用料はいただいていません。 -
Q3同人サイトで使っていいですか?+
はい、同人サイトでもお使いいただけます。
ただし、創作内容や活動は自己責任でお願いします。 -
Q4成人向けコンテンツのあるサイトで使っていいですか?+
ライセンスの条件を守っていただければご自由にお使いいただけます。
ただし、創作内容や活動は自己責任でお願いします。 -
Q5ゲームのパッケージやWebサイトテンプレートに同梱して配布していいですか?+
はい、同梱で配布することは可能です。商用・非商用問わず、ご自身の独自のコンテンツがしっかりとあるものに同梱して配布することは問題ありません。 -
Q6ライセンスの「商用利用または再配布時は、重要な部分に著作者表示と公式の配布元を記載すること」の具体的な記載例を教えてください。+
Webサイトでしたら配布ページやabout等の紹介ページに、何らかの配布パッケージでしたらライセンス情報等をまとめた資料に、以下のように記載してください。
Charm.js Copyright (c) Mizuna Shima https://lanama.net/scripts/charm/
これは一例なので、日本語で書いてもOKです。 -
Q7ライセンスの「ファイル内のクレジットおよびライセンス文章を削除しないこと」とはどういう意味ですか?+
スクリプト本体ファイル「charm.js」の先頭にあるコメント(ライセンス文章)を削除しないでください、という意味です。
Charm.jsをご自身で改修して使う場合でも、この部分は削除や変更をしないでください。 -
Q8ライセンスの「本スクリプト、および本スクリプトが主体の製品を販売しないこと」とはどういう意味ですか?+
Charm.jsをゲームやテンプレートに含めて販売をすることは可能ですが、Charm.jsだけを販売することはできません。
(ご自身のコンテンツと同梱の場合はOKです)
以下についても同様に許可されません。
・Charm.jsをそのまま、またはわずかな変更を加えて販売すること
・このサイトにある解説とCharm.js関連ファイルをセットにして販売すること
・金銭が発生していなくても、何らかの対価としてCharm.jsを提供すること -
Q9ライセンスの「本スクリプトの保存データを用いて金銭の請求または物品の要求をしないこと」とはどういうことですか?+
Charm.jsで生成したテキストや、Charm.jsで登録したデータを請求や決済に使用することを禁止しています。
Charm.jsは請求書や領収書の宛先などに使用することはできません。
ご自身のサイト内で請求や要求を行う場合はCharm.jsを使わずに行ってください。 -
Q10リンクは必要ですか?+
商用利用と再配布でない場合は、リンクは任意です。 -
Q11利用報告は必要ですか?+
こっそり使ってもらってOKです。もちろん、利用報告を頂ければこっそり遊びに行って励みにします。 -
Q12有料でもいいので、登録内容を増やした登録フォームと、カスタムコードを提供してくれませんか?+
今のところは個別のご依頼は受けていませんが、需要が多ければ対応するかもしれません。 -
Q13Charm.jsを紹介してもいいですか?+
どうぞ! -
Q14Charm.jsって、日本語で何と読むのですか?+
日本語では「チャームジェイエス」または「チャームドットジェイエス」です。お好きな方で呼んでください。 -
Q15サンプルのHTMLファイルやCSSファイルを自分のサイトで使ってもいいですか?+
どうぞお使いください。ただし、多くの方に使っていただきたいと考えているため、自作発言はしないでください。
GitHub
Charm.jsはGitHubでも公開しています。https://github.com/mizuna-shima/charm
※URL変更になりました(2024年5月18日)