私はまだJavascriptに慣れていないので、エディターがJavascriptを強調表示すると、興味をそそられます。それは正確に何をしますか?
例:/// things go after here
私はまだJavascriptに慣れていないので、エディターがJavascriptを強調表示すると、興味をそそられます。それは正確に何をしますか?
例:/// things go after here
一部のドキュメントジェネレータは、3つのスラッシュ///をJavaScriptにドキュメントコメントを導入するものと見なします。
見る
http://msdn.microsoft.com/en-us/library/bb514138(v=vs.110).aspx
したがって、JavaScriptに関する限り、3つのスラッシュは2つのスラッシュと同じように機能します(これは行末へのコメントです)が、3つのスラッシュは、ドキュメントジェネレーターによってドキュメントセクションを示すために解釈できます。
例:
function getArea(radius)
{
/// <summary>Determines the area of a circle that has the specified radius parameter.</summary>
/// <param name="radius" type="Number">The radius of the circle.</param>
/// <returns type="Number">The area.</returns>
var areaVal;
areaVal = Math.PI * radius * radius;
return areaVal;
}
最初の2つのスラッシュはコメントを開始します。3番目のスラッシュは何もしません。
JSでコメントする2つの主な方法:
/* This way
Can go multi-line */
// This way is one line only
I believe it is a way to define a "higher level" single line comment in some editors/documentation programs:
E.g. In macrabbit's espresso editor it highlights these single line comments in the navigation pane
ドキュメントのコメントには、JavaScript(およびC#などの他の言語)の3つのスラッシュが使用されます。これらはXMLドキュメントを生成するために使用され、関数などの前に特定の形式で実行され、関数とそのパラメーターおよびパラメータータイプの説明を指定します。
http://msdn.microsoft.com/en-us/library/bb514138(v=vs.110).aspx