# 動態模板變量 在這個頁面中： * [什么是模板變量](#什么是模板變量) * [聲明模板變量](#聲明模板變量) * [創建和編輯模板變量](#創建和編輯模板變量) * [預定義模板變量](#預定義模板變量) * [在模板變量中使用預定義方法](#在模板變量中使用預定義方法) ## <span id='什么是模板變量'>什么是模板變量</span> 在動態模板中**模板變量**允許用戶輸入。當一個模板展開后，模板出現在編輯器中作為**輸入字段**。 ## <span id='聲明模板變量'>聲明模板變量</span> 模板中的變量按以下格式聲明： ```VTL $<variable_name>$ ``` ## <span id='創建和編輯模板變量'>創建和編輯模板變量</span> 變量通過表達式定義，并且可以接受默認值。 表達式可能包含以下基礎類型結構： * 兩個引號中的字符串常量 * 動態模板中定義的另一個變量的名字 * 預定義函數及可能的參數 模板變量可以在[編輯模板變量對話框](/參考/設置參數對話框/編輯器/動態模板/編輯模板變量對話框.md)中編輯，這包含一個完整的可用函數列表。參見本頁下方的[預定義方法列表](#在模板變量中使用預定義方法) ## <span id='預定義模板變量'>預定義模板變量</span> PhpStorm提供兩個**預定義動態模板變量**：`$END$`和`$SELECTION$`。 你不能編輯預定義動態模板變量`$END$`和`$SELECTION$`。 * `$END`表明光標的位置在展開的模板之后。例如，模板`return $END$;`將展開到： ``` return ; ``` 光標位置在分號之前。 * `$SELECTION$`用在**環繞模板**中并且用來代表要被包圍的代碼片段。在模板展開之后，被選中的文本將在模板中被圍繞。 例如，如果你在代碼中選擇`EXAMPLE`并調用`"$SELECTION$"`模板(通過分配的縮寫或按下`Ctrl+Alt+T`并從列表中選擇目標的模板)，PhpStorm將用兩個引號包圍選中的部分，就像下面： ``` "EXAMPLE" ``` ## <span id='在模板變量中使用預定義方法'>在模板變量中使用預定義方法</span> |**Item**|**Description**| |---|---| |`camelCase(String)`|返回作為參數傳遞的字符串，轉換為駝峰式寫法。例如`my-text-file`/`my text file`/`my_text_file`將被轉換為`myTextFile`| |`capitalize(String)`|將作為參數傳遞的名字的首字母大寫| |`capitalizeAndUnderscore(sCamelCaseName)`|將作為參數傳來的駝峰式名字轉為首字母大寫，并在單詞重建插入下劃線。例如，如果傳來的參數是`FooBar`，那么函數返回`FOO_BAR`。| |`classNameComplete()`|這個表達式用來在變量位置替換[類名稱](/如何使用/常規指南/代碼補全/README.md)| |`clipboard()`|返回系統剪貼板的內容| |`snakeCase(String)`|從蛇形字符串返回駝峰式寫法的字符串。例如，如果傳來的參數字符串是`foo_bar`，函數將返回`fooBar`。| |`complete()`|這個表達式在變量位置代替行使代碼補全| |`completeSmart()`|這個表達式在變量位置代替行使只能類型補全| |`date(sDate)`|用指定格式返回當前系統日期。<br/>默認的，當前日期被返回為系統默認格式。然而，如果你用兩個引號指定日期格式，日期將被呈現為指定格式：<br/>| |`decapitalize(sName)`|用相應的小寫字母替換作為參數傳遞的名字的首字母。| |`enum(sCompletionString1,sCompletionString2,...)`|用逗號分隔的字符串建議作為模板調用時的完成列表| |`escapeString(sEscapeString)`|避開指定的字符串| |`expectedType()`|返回整個模板期望的類型。這是有道理的，如果模板在正確的位置展開，在返回之后，等等| |`fileName(sFileName)`|返回帶擴展名的文件名| |`fileNameWithoutExtension()`|返回文件名不要擴展名| |`firstWord(sFirstWord)`|返回作為參數傳遞的字符串的第一個單詞| |`lineNumber()`|返回當前行號| |`lowercaseAndDash(String)`|返回作為參數傳遞的字符串以用破折號分隔的小寫形式。例如，字符串`MyExampleName`轉換為`my-example-name`| |`snakeCase(sCamelCaseText)`|從駝峰式寫法的字符串返回蛇形字符串| |`spaceSeparated(String)`|傳遞來的駝峰式字符串轉換為空格分隔的單詞。例如，如果川里來的字符串參數是`fooBar`，那么返回值就是`foo bar`| |`time(sSystemTime)`|放回當前系統時間。| |`timestamp()`|這個參數沒有參數，返回的是1970-1-1到現在的毫秒時間。參考文章[Ubix time](https://en.wikipedia.org/wiki/Unix_time)| |`underscoresToCamelCase(sCamelCaseText)`|從下環線分隔的字符串轉換為駝峰式寫法，例如，如果傳來的參數是`foo_bar`，那么函數返回值就是`fooBar`| |`underscoresToSpaces(sParameterWithSpaces)`|從下環線分隔的字符串轉換為空格分隔式寫法| |`user()`|返回當前用戶名稱| |`JsArrayVariable`|返回當前JavaScript數組名稱| |`jsClassName()`|返回JavaScript類名稱| |`jsComponentType`|返回當前JavaScript組件類型| |`jsMethodName()`|返回當前JavaScript方法名稱| |`jsQualifiedClassName`|返回當前JavaScript類的完整名稱| |`jsSuggestIndexName`|返回索引的建議名稱| |`jsSuggestVariableName`|返回變量的建議名稱| # 另請參閱： 規程： * [創建和編輯模板變量](/如何使用/常規指南/動態模板/創建和編輯模板變量.md) 參考： * [編輯模板變量對話框](/參考/設置參數對話框/編輯器/動態模板/編輯模板變量對話框.md)