default、required、quote

ほとんどすべてのチャートで、3つの関数が登場します。フォールバックにはdefault、必須値には required、安全な文字列には quote を使います。

default関数は、値が空または存在しない場合にフォールバックを提供するため、テンプレートが空白を出力することを防げます。

関数として記述する場合は、fallbackが先で、値が後になります。パイプでは値が最後に渡されるため、自然な順序で読めます。

defaultでは、0、空文字列、空のリスト、nil が空とみなされます。これらのいずれかに該当すると、フォールバック値が使われます。

required関数は、値がない場合に指定したメッセージを表示してレンダリングを停止し、見過ごされがちなバグを明確なエラーに変えます。⛔

値が存在する場合、requiredはその値をそのまま返すため、必須フィールドが必要な場所にインラインで配置できます。

よいrequiredメッセージには、欠落しているキーと設定方法を記載します。そのため、ユーザーはチャートを読まなくても問題を解決できます。

quote関数は値を二重引用符で囲み、数値や真偽値、null に見える値から YAML を保護します。

quoteを使わないと、yes や 1.20 のような値が真偽値や数値として解析されることがあります。引用符で囲むと、予測可能な文字列として扱われます。

これらの関数は、1つのパイプラインでcomposeできます。デフォルト値を設定してから結果を quote する処理を、読みやすい1行で記述できます。

値が任意の場合はdefaultを、必須の場合は required を使います。文字列を文字列のまま保持する必要がある場合は、quote を使ってください。

値がない場合にレンダリングを失敗させる関数はどれですか。

フォールバックにはdefault、必須入力には required、安全な文字列には quote を使うことを学びました。これらを組み合わせると、値を堅牢に扱えます。🎉