創建和編輯模板變量 · phpstorm手冊

# 創建和編輯模板變量在這個頁面中： * [基礎](#基礎) * [在模板中配置和使用變量](#在模板中配置和使用變量) * [在動態模板變量中使用的預定義變量](#在動態模板變量中使用的預定義變量) ## 基礎 在一個[模板](/如何使用/常規指南/動態模板/README.md)展開之后，它的變量編輯器中呈現為輸入區域。這些區域的值可以被用戶編輯或者被PhpStorm計算填充。要讓它自動完成，每個變量你需要指定下面： * 表達式，與變量相關的表達式來被計算 * 默認值，如果計算失敗那么輸入區域要被寫入的默認值 PhpStorm中展開表達式之后輸入區域的處理順序，取決于列表中變量的順序。 **在模板中配置和使用變量** 1. [打開模板設置](/如何使用/常規指南/動態模板/創建和編輯動態模板.md)，然后在[模板文本](/參考/設置參數對話框/編輯器/動態模板/README.md#模板編輯區域)區域點擊**Edit Variables**按鈕。 **Edit Variables**按鈕僅在模板主體中包含至少一個用戶定義變量時可用，也就是說，和`$END$`或`$SELECTION$`不同的變量。 [編輯模板變量對話框](/參考/設置參數對話框/編輯器/動態模板/編輯模板變量對話框.md)打開了，在這你可以定義當模板使用時變量將被如何處理。 2. 在**Name**文本框，指定要在模板主體中使用的變量名。 3. 在**Expression**下拉列表中，指定要被PhpStorm計算的表達式當模板展開后。執行以下操作之一： * 輸入一個在兩個引號中的字符串常量 * 輸入一個預定義函數及可能的參數或者從下拉列表中選擇一個一個函數的參數可能是一個常量或者另一個預定義函數。參見頁面下方的[預定義函數列表](#在動態模板變量中使用的預定義變量)。 4. 要啟用PhpStorm來處理下一個輸入區域，如果一個輸入區域關聯的當前變量已經定義，選擇**Skip if defined**復選框 5. 要安排PhpStorm切換變量相應的輸入框的順序，使用**Move Up**或**Move Down**按鈕。 ## 在動態模板變量中使用的預定義變量 |**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)`|用指定格式返回當前系統日期。 默認的，當前日期被返回為系統默認格式。然而，如果你用兩個引號指定日期格式，日期將被呈現為指定格式： ![指定日期格式](http://image.jellychen.cn/uploads/2016/11/date_format.png)| |`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) 參考： * [動態模板](/參考/設置參數對話框/編輯器/動態模板/README.md) * [編輯模板變量對話框](/參考/設置參數對話框/編輯器/動態模板/編輯模板變量對話框.md) 概念： * [動態模板](/如何使用/常規指南/動態模板/README.md)